{"id":"0c69c9a9-9cee-4441-9f0e-b79fe6dbf6f6","shortId":"MA5Q7M","kind":"skill","title":"data-semantic","tagline":"数据语义服务 API - 提供表单视图的语义理解功能。\n用于: (1) 查询字段语义和业务对象识别结果 (2) 触发/批量理解表单视图 (3) 批量业务对象匹配","description":"# 功能速览\n\n| 操作 | 说明 | 关键参数 |\n|------|------|----------|\n| `list` | 查询逻辑视图列表 | `keyword`, `datasource_id` |\n| `query` | 查询语义理解结果 | `form_view_id` |\n| `understand` | 触发表单理解 | `form_view_id` 或 `datasource_id` |\n| `batch` | 批量理解（≤100个） | `form_view_ids` |\n| `match` | 批量对象匹配 | `kn_id`, `ot_id`, `entries` |\n\n# 输入参数\n\n| 参数 | 必填 | 说明 |\n|------|------|------|\n| `operation` | ✅ | list/query/understand/batch/match |\n| `auth_token` | ✅ | JWT Token |\n| `form_view_id` | query/understand | 单视图 ID |\n| `datasource_id` | 数据源理解 | 数据源 UUID |\n| `keyword` | 可选 | 关键字搜索 |\n\n# 操作示例\n\n## 1. 查询视图列表\n```bash\noperation: list\nkeyword: 用户\n```\n\n## 2. 查询语义结果（输出完整报告）\n```bash\noperation: query\nform_view_id: <uuid>\n```\n\n> 输出：字段语义表格 + 业务对象表格 + 属性表格\n\n## 3. 单视图理解（输出完整报告）\n```bash\noperation: understand\nform_view_id: <uuid>\n```\n\n> 输出：字段语义表格 + 业务对象表格 + 属性表格\n\n## 4. 批量理解（仅统计报告）\n```bash\noperation: batch\nform_view_ids: [<uuid1>, <uuid2>, ...]\n```\n\n> 输出：仅统计报告，不输出详细语义\n\n## 5. 数据源批量理解\n```bash\noperation: understand\ndatasource_id: <uuid>\n```\n\n> ≤50个视图直接执行，>50个调用Python脚本\n\n## 6. 批量对象匹配\n```bash\noperation: match\nkn_id: <配置值>\not_id: <配置值>\nentries: [{\"name\": \"客户信息\"}]\n```\n\n# 状态机\n\n| 状态码 | 状态名称 | 处理动作 |\n|--------|----------|----------|\n| 0 | 未理解 | 触发生成 → 轮询等待 → 状态2后提交确认 → 重新生成 → 轮询 → 提交确认 → 完成 |\n| 1 | 理解中 | 轮询等待 → 状态2/3/4 → 同状态2处理 |\n| 2 | 待确认 | 提交确认 → 重新生成 → 轮询等待 → 状态2后提交确认 → 完成 |\n| 3 | 已完成 | 触发重新生成 → 轮询等待 → 状态2后提交确认 → 完成 |\n| 4 | 待确认(重新理解) | 触发重新生成 → 轮询等待 → 状态2后提交确认 → 完成 |\n| 5 | 理解失败 | 输出失败原因，终止 |\n\n> ⚠️ 批量理解时，无论当前状态是已完成(3)还是待确认(4)，都会触发重新理解\n\n# 大数据量处理\n\n## 保护机制\n\n- **≤50 个** → 直接执行\n- **>50 个** → 建议使用 Python 脚本\n- **>1000 个** → 提醒非工作时间执行\n- **>5000 个** → 建议联系技术团队\n\n## Python 脚本\n\n```bash\n# 数据源批量理解\npython scripts/data_semantic_batch.py --token <JWT> --datasource-id <UUID>\n\n# 批量视图理解\npython scripts/data_semantic_batch.py --token <JWT> --view-ids <id1,id2>\n\n# 断点续传\npython scripts/data_semantic_batch.py --token <JWT> --resume\n```\n\n# 输出格式\n\n## 单视图输出（含业务对象表格）\n\n**📊 数据语义理解报告**\n\n| 项目 | 内容 |\n|------|------|\n| 视图技术名称 | `<tech_name>` |\n| 视图业务名称 | `<biz_name>` |\n| 理解状态 | `<status_name>` |\n\n**📈 识别统计**\n\n| 类别 | 统计 |\n|------|------|\n| 字段语义 | 总字段: `<total>`, 已补全: `<completed>` |\n| 业务对象 | 对象: `<count>` 个, 属性: `<attr_count>` 个 |\n\n## 📋 字段语义补全\n\n### 已补全字段\n\n| 技术名称 | 业务名称 | 字段角色 | 字段描述 |\n|----------|----------|----------|----------|\n| user_id | 用户ID | 业务主键 | 用户唯一标识 |\n| user_name | 用户名称 | 业务特征 | 用户姓名 |\n| create_time | 创建时间 | 时间字段 | 记录创建时间 |\n\n### 未补全字段\n\n| 技术名称 | 字段类型 | 字段描述 |\n|----------|----------|----------|\n| ext_field1 | VARCHAR | 扩展字段 |\n\n## 🏢 业务对象识别结果\n\n### 1️⃣ <业务对象名称>\n\n| 属性名称 | 字段技术名称 | 字段业务名称 | 字段角色 | 字段描述 |\n|----------|--------------|--------------|----------|----------|\n| 客户ID | customer_id | 客户编号 | 业务主键 | 客户唯一标识 |\n| 客户名称 | customer_name | 客户名称 | 业务特征 | 客户姓名 |\n\n## 批量输出（仅统计报告）\n\n**🧠 批量理解报告**\n\n| 项目 | 内容 |\n|------|------|\n| 总视图数 | `<total_count>` |\n| 成功 | `<success_count>` |\n| 失败 | `<fail_count>` |\n\n> 批量理解仅输出统计报告，如需详情请单独查询\n\n# 注意事项\n\n1. **Token 必填** - 所有操作都需要有效 JWT\n2. **编码问题** - API 返回可能为 GBK，需用 latin1 解码\n3. **中文乱码** - match 操作用 `echo | curl -d @-`\n4. **数据差异** - 字段语义和业务对象来自不同表","tags":["data","semantic","kweaver","dip","kweaver-ai","agent-skills","agents","digital-worker","ontology","openclaw"],"capabilities":["skill","source-kweaver-ai","skill-data-semantic","topic-agent-skills","topic-agents","topic-digital-worker","topic-ontology","topic-openclaw"],"categories":["kweaver-dip"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/kweaver-ai/kweaver-dip/data-semantic","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add kweaver-ai/kweaver-dip","source_repo":"https://github.com/kweaver-ai/kweaver-dip","install_from":"skills.sh"}},"qualityScore":"0.508","qualityRationale":"deterministic score 0.51 from registry signals: · indexed on github topic:agent-skills · 117 github stars · SKILL.md body (3,033 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-02T06:55:20.069Z","embedding":null,"createdAt":"2026-04-18T22:14:45.926Z","updatedAt":"2026-05-02T06:55:20.069Z","lastSeenAt":"2026-05-02T06:55:20.069Z","tsv":"'0':147 '1':8,75,156,311 '1000':201 '100个':39 '1️⃣':281 '2':10,82,161,316 '3':13,95,168,187,324 '4':108,174,189,331 '5':120,181 '50':193,196 '5000':204 '50个视图直接执行':127 '50个调用python脚本':128 '6':129 'api':5,318 'auth':56 'bash':77,85,98,111,122,131,209 'batch':37,113 'creat':267 'curl':329 'custom':289,295 'd':330 'data':2 'data-semant':1 'datasourc':22,35,66,125,215 'datasource-id':214 'echo':328 'entri':49,140 'ext':276 'field1':277 'form':26,31,40,60,88,101,114 'gbk':320 'id':23,28,33,36,42,46,48,62,65,67,90,103,116,126,135,138,216,223,258,290 'id1':224 'id2':225 'jwt':58,315 'keyword':21,71,80 'kn':45,134 'latin1':322 'list':19,79 'list/query/understand/batch/match':55 'match':43,133,326 'name':141,263,296 'oper':54,78,86,99,112,123,132 'ot':47,137 'python':199,207,211,218,227 'queri':24,87 'query/understand':63 'resum':230 'scripts/data_semantic_batch.py':212,219,228 'semant':3 'skill' 'skill-data-semantic' 'source-kweaver-ai' 'time':268 'token':57,59,213,220,229,312 'topic-agent-skills' 'topic-agents' 'topic-digital-worker' 'topic-ontology' 'topic-openclaw' 'understand':29,100,124 'user':257,262 'uuid':70 'varchar':278 'view':27,32,41,61,89,102,115,222 'view-id':221 '不输出详细语义':119 '业务主键':260,292 '业务名称':254 '业务对象':246 '业务对象名称':282 '业务对象表格':93,106 '业务对象识别结果':280 '业务特征':265,298 '个':194,197,202,205,248,250 '中文乱码':325 '仅统计报告':110,118,301 '保护机制':192 '关键参数':18 '关键字搜索':73 '内容':236,304 '创建时间':269 '功能速览':15 '单视图':64 '单视图理解':96 '单视图输出':232 '参数':51 '可选':72 '同状态2处理':160 '含业务对象表格':233 '处理动作':146 '大数据量处理':191 '失败':307 '如需详情请单独查询':309 '字段业务名称':285 '字段技术名称':284 '字段描述':256,275,287 '字段类型':274 '字段角色':255,286 '字段语义':243 '字段语义和业务对象来自不同表':333 '字段语义补全':251 '字段语义表格':92,105 '完成':155,167,173,180 '客户id':288 '客户信息':142 '客户名称':294,297 '客户唯一标识':293 '客户姓名':299 '客户编号':291 '对象':247 '属性':249 '属性名称':283 '属性表格':94,107 '已完成':169 '已补全':245 '已补全字段':252 '建议使用':198 '建议联系技术团队':206 '待确认':162,175 '必填':52,313 '总字段':244 '总视图数':305 '成功':306 '或':34 '所有操作都需要有效':314 '扩展字段':279 '批量业务对象匹配':14 '批量对象匹配':44,130 '批量理解':38,109 '批量理解仅输出统计报告':308 '批量理解报告':302 '批量理解时':185 '批量理解表单视图':12 '批量视图理解':217 '批量输出':300 '技术名称':253,273 '提交确认':154,163 '提供表单视图的语义理解功能':6 '提醒非工作时间执行':203 '操作':16 '操作用':327 '操作示例':74 '数据差异':332 '数据源':69 '数据源批量理解':121,210 '数据源理解':68 '数据语义服务':4 '数据语义理解报告':234 '断点续传':226 '无论当前状态是已完成':186 '时间字段':270 '未理解':148 '未补全字段':272 '查询字段语义和业务对象识别结果':9 '查询视图列表':76 '查询语义理解结果':25 '查询语义结果':83 '查询逻辑视图列表':20 '注意事项':310 '状态2/3/4':159 '状态2后提交确认':151,166,172,179 '状态名称':145 '状态机':143 '状态码':144 '理解中':157 '理解失败':182 '理解状态':239 '用于':7 '用户':81 '用户id':259 '用户名称':264 '用户唯一标识':261 '用户姓名':266 '直接执行':195 '类别':241 '终止':184 '统计':242 '编码问题':317 '脚本':200,208 '视图业务名称':238 '视图技术名称':237 '解码':323 '触发':11 '触发生成':149 '触发表单理解':30 '触发重新生成':170,177 '记录创建时间':271 '识别统计':240 '说明':17,53 '轮询':153 '轮询等待':150,158,165,171,178 '输入参数':50 '输出':91,104,117 '输出失败原因':183 '输出完整报告':84,97 '输出格式':231 '返回可能为':319 '还是待确认':188 '都会触发重新理解':190 '配置值':136,139 '重新理解':176 '重新生成':152,164 '需用':321 '项目':235,303","prices":[{"id":"742ae226-1589-4b03-ad11-c7ae3686e35b","listingId":"0c69c9a9-9cee-4441-9f0e-b79fe6dbf6f6","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"kweaver-ai","category":"kweaver-dip","install_from":"skills.sh"},"createdAt":"2026-04-18T22:14:45.926Z"}],"sources":[{"listingId":"0c69c9a9-9cee-4441-9f0e-b79fe6dbf6f6","source":"github","sourceId":"kweaver-ai/kweaver-dip/data-semantic","sourceUrl":"https://github.com/kweaver-ai/kweaver-dip/tree/main/skills/data-semantic","isPrimary":false,"firstSeenAt":"2026-04-18T22:14:45.926Z","lastSeenAt":"2026-05-02T06:55:20.069Z"}],"details":{"listingId":"0c69c9a9-9cee-4441-9f0e-b79fe6dbf6f6","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"kweaver-ai","slug":"data-semantic","github":{"repo":"kweaver-ai/kweaver-dip","stars":117,"topics":["agent-skills","agents","ai","business-knowledge-network","digital-worker","ontology","openclaw"],"license":"apache-2.0","html_url":"https://github.com/kweaver-ai/kweaver-dip","pushed_at":"2026-05-01T05:38:33Z","description":"KWeaver DIP is an enterprise-level digital employee platform, built on KWeaver Core. It provides an AI-native environment for developing and managing digital employees on business knowledge networks—for enterprise intelligence that is understandable, executable, and governable.","skill_md_sha":"089f4ee39ee54513e57bcde0eb64ed9ad76b458e","skill_md_path":"skills/data-semantic/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/kweaver-ai/kweaver-dip/tree/main/skills/data-semantic"},"layout":"multi","source":"github","category":"kweaver-dip","frontmatter":{"name":"data-semantic","description":"数据语义服务 API - 提供表单视图的语义理解功能。\n用于: (1) 查询字段语义和业务对象识别结果 (2) 触发/批量理解表单视图 (3) 批量业务对象匹配"},"skills_sh_url":"https://skills.sh/kweaver-ai/kweaver-dip/data-semantic"},"updatedAt":"2026-05-02T06:55:20.069Z"}}