data-semantic
starsforks
How to install data-semantic?
kweaver-ai/kweaver-dip/data-semantic
$npx -y skills add kweaver-ai/kweaver-dip --skill data-semantic数据语义服务 API - 提供表单视图的语义理解功能。 用于: (1) 查询字段语义和业务对象识别结果 (2) 触发/批量理解表单视图 (3) 批量业务对象匹配
SKILL.md
| 1 | # 功能速览 |
| 2 | |
| 3 | | 操作 | 说明 | 关键参数 | |
| 4 | |------|------|----------| |
| 5 | | `list` | 查询逻辑视图列表 | `keyword`, `datasource_id` | |
| 6 | | `query` | 查询语义理解结果 | `form_view_id` | |
| 7 | | `understand` | 触发表单理解 | `form_view_id` 或 `datasource_id` | |
| 8 | | `batch` | 批量理解（≤100个） | `form_view_ids` | |
| 9 | | `match` | 批量对象匹配 | `kn_id`, `ot_id`, `entries` | |
| 10 | |
| 11 | # 输入参数 |
| 12 | |
| 13 | | 参数 | 必填 | 说明 | |
| 14 | |------|------|------| |
| 15 | | `operation` | ✅ | list/query/understand/batch/match | |
| 16 | | `auth_token` | ✅ | JWT Token | |
| 17 | | `form_view_id` | query/understand | 单视图 ID | |
| 18 | | `datasource_id` | 数据源理解 | 数据源 UUID | |
| 19 | | `keyword` | 可选 | 关键字搜索 | |
| 20 | |
| 21 | # 操作示例 |
| 22 | |
| 23 | ## 1. 查询视图列表 |
| 24 | ```bash |
| 25 | operation: list |
| 26 | keyword: 用户 |
| 27 | ``` |
| 28 | |
| 29 | ## 2. 查询语义结果（输出完整报告） |
| 30 | ```bash |
| 31 | operation: query |
| 32 | form_view_id: <uuid> |
| 33 | ``` |
| 34 | |
| 35 | > 输出：字段语义表格 + 业务对象表格 + 属性表格 |
| 36 | |
| 37 | ## 3. 单视图理解（输出完整报告） |
| 38 | ```bash |
| 39 | operation: understand |
| 40 | form_view_id: <uuid> |
| 41 | ``` |
| 42 | |
| 43 | > 输出：字段语义表格 + 业务对象表格 + 属性表格 |
| 44 | |
| 45 | ## 4. 批量理解（仅统计报告） |
| 46 | ```bash |
| 47 | operation: batch |
| 48 | form_view_ids: [<uuid1>, <uuid2>, ...] |
| 49 | ``` |
| 50 | |
| 51 | > 输出：仅统计报告，不输出详细语义 |
| 52 | |
| 53 | ## 5. 数据源批量理解 |
| 54 | ```bash |
| 55 | operation: understand |
| 56 | datasource_id: <uuid> |
| 57 | ``` |
| 58 | |
| 59 | > ≤50个视图直接执行，>50个调用Python脚本 |
| 60 | |
| 61 | ## 6. 批量对象匹配 |
| 62 | ```bash |
| 63 | operation: match |
| 64 | kn_id: <配置值> |
| 65 | ot_id: <配置值> |
| 66 | entries: [{"name": "客户信息"}] |
| 67 | ``` |
| 68 | |
| 69 | # 状态机 |
| 70 | |
| 71 | | 状态码 | 状态名称 | 处理动作 | |
| 72 | |--------|----------|----------| |
| 73 | | 0 | 未理解 | 触发生成 → 轮询等待 → 状态2后提交确认 → 重新生成 → 轮询 → 提交确认 → 完成 | |
| 74 | | 1 | 理解中 | 轮询等待 → 状态2/3/4 → 同状态2处理 | |
| 75 | | 2 | 待确认 | 提交确认 → 重新生成 → 轮询等待 → 状态2后提交确认 → 完成 | |
| 76 | | 3 | 已完成 | 触发重新生成 → 轮询等待 → 状态2后提交确认 → 完成 | |
| 77 | | 4 | 待确认(重新理解) | 触发重新生成 → 轮询等待 → 状态2后提交确认 → 完成 | |
| 78 | | 5 | 理解失败 | 输出失败原因，终止 | |
| 79 | |
| 80 | > ⚠️ 批量理解时，无论当前状态是已完成(3)还是待确认(4)，都会触发重新理解 |
| 81 | |
| 82 | # 大数据量处理 |
| 83 | |
| 84 | ## 保护机制 |
| 85 | |
| 86 | - **≤50 个** → 直接执行 |
| 87 | - **>50 个** → 建议使用 Python 脚本 |
| 88 | - **>1000 个** → 提醒非工作时间执行 |
| 89 | - **>5000 个** → 建议联系技术团队 |
| 90 | |
| 91 | ## Python 脚本 |
| 92 | |
| 93 | ```bash |
| 94 | # 数据源批量理解 |
| 95 | python scripts/data_semantic_batch.py --token <JWT> --datasource-id <UUID> |
| 96 | |
| 97 | # 批量视图理解 |
| 98 | python scripts/data_semantic_batch.py --token <JWT> --view-ids <id1,id2> |
| 99 | |
| 100 | # 断点续传 |
| 101 | python scripts/data_semantic_batch.py --token <JWT> --resume |
| 102 | ``` |
| 103 | |
| 104 | # 输出格式 |
| 105 | |
| 106 | ## 单视图输出（含业务对象表格） |
| 107 | |
| 108 | **📊 数据语义理解报告** |
| 109 | |
| 110 | | 项目 | 内容 | |
| 111 | |------|------| |
| 112 | | 视图技术名称 | `<tech_name>` | |
| 113 | | 视图业务名称 | `<biz_name>` | |
| 114 | | 理解状态 | `<status_name>` | |
| 115 | |
| 116 | **📈 识别统计** |
| 117 | |
| 118 | | 类别 | 统计 | |
| 119 | |------|------| |
| 120 | | 字段语义 | 总字段: `<total>`, 已补全: `<completed>` | |
| 121 | | 业务对象 | 对象: `<count>` 个, 属性: `<attr_count>` 个 | |
| 122 | |
| 123 | ## 📋 字段语义补全 |
| 124 | |
| 125 | ### 已补全字段 |
| 126 | |
| 127 | | 技术名称 | 业务名称 | 字段角色 | 字段描述 | |
| 128 | |----------|----------|----------|----------| |
| 129 | | user_id | 用户ID | 业务主键 | 用户唯一标识 | |
| 130 | | user_name | 用户名称 | 业务特征 | 用户姓名 | |
| 131 | | create_time | 创建时间 | 时间字段 | 记录创建时间 | |
| 132 | |
| 133 | ### 未补全字段 |
| 134 | |
| 135 | | 技术名称 | 字段类型 | 字段描述 | |
| 136 | |----------|----------|----------| |
| 137 | | ext_field1 | VARCHAR | 扩展字段 | |
| 138 | |
| 139 | ## 🏢 业务对象识别结果 |
| 140 | |
| 141 | ### 1️⃣ <业务对象名称> |
| 142 | |
| 143 | | 属性名称 | 字段技术名称 | 字段业务名称 | 字段角色 | 字段描述 | |
| 144 | |----------|--------------|--------------|----------|----------| |
| 145 | | 客户ID | customer_id | 客户编号 | 业务主键 | 客户唯一标识 | |
| 146 | | 客户名称 | customer_name | 客户名称 | 业务特征 | 客户姓名 | |
| 147 | |
| 148 | ## 批量输出（仅统计报告） |
| 149 | |
| 150 | **🧠 批量理解报告** |
| 151 | |
| 152 | | 项目 | 内容 | |
| 153 | |------|------| |
| 154 | | 总视图数 | `<total_count>` | |
| 155 | | 成功 | `<success_count>` | |
| 156 | | 失败 | `<fail_count>` | |
| 157 | |
| 158 | > 批量理解仅输出统计报告，如需详情请单独查询 |
| 159 | |
| 160 | # 注意事项 |
| 161 | |
| 162 | 1. **Token 必填** - 所有操作都需要有效 JWT |
| 163 | 2. **编码问题** - API 返回可能为 GBK，需用 latin1 解码 |
| 164 | 3. **中文乱码** - match 操作用 `echo | curl -d @-` |
| 165 | 4. **数据差异** - 字段语义和业务对象来自不同表 |
People who liked this also viewed
6 picksType
- azure-kustoQuery and analyze data in Azure Data Explorer (Kusto/ADX) using KQL for log analytics, telemetry, and time series analysis. WHEN: KQL queries, Kusto database queries, Azure Data Explorer, ADX clustersSkillsJul 2026
- lark-base飞书多维表格（Base）操作：建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、workflow、角色权限；遇到 Base/多维表格/bitable 或 /base/ 链接时使用。文件导入转 lark-drive，认证/授权转 lark-shared。SkillsJul 2026
- lark-calendar飞书日历：管理日历日程和会议室。查看/搜索日程、创建/更新日程、管理参会人、查询忙闲和推荐时段、预定会议室。当用户需要查看日程安排、创建/修改会议、查询/预定会议室时使用。不负责：查询过去的视频会议记录（走 lark-vc）、待办任务（走 lark-task）。SkillsJul 2026
- shadcnManages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI, including chat interfaces. Provides project context, component docs, and usage examples. AppliSkillsJul 2026
- xlsxUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.SkillsJul 2026
- firebase-data-connectAgent Skills for FirebaseSkillsJul 2026
