القائمة
数据语义服务 API - 提供表单视图的语义理解功能。 用于: (1) 查询字段语义和业务对象识别结果 (2) 触发/批量理解表单视图 (3) 批量业务对象匹配
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
数据权限管理技能：支持资源权限查询与权限申请。 先判定“查询权限”还是“申请权限”，再按资源类型执行对应接口。 当用户提出“申请权限”、“查是否有权限”、“给某资源授权”时使用。
Guides creation of BKN (Business Knowledge Network) definition files following v2.0.1 spec. Covers network, object_type, relation_type, action_type, concept_group. Use when creating knowledge networks, BKN files, object types, relation types, action types, concept groups, or when user asks to model business knowledge in BKN format. When kweaver-core is also loaded, use it to run kweaver CLI (auth, bkn push) after files exist.
数据分析员工（Data Analyst Agent）的唯一总入口：凡与数据资产、取数、指标、表/视图、 治理职责、知识网络等相关的问题，必须先经本 skill 做编排与路由，再进入找表或问数等子流程。 当用户提出数据类问题、需要知识网络选择、或需要在找表与问数之间切换时使用。
向飞书指定用户（通过 user_id）推送消息。 支持文本、卡片、图片、文件等多种消息类型。当用户需要给飞书用户发送推送消息时自动使用。
全局归档协议。只要任务需要写入任何文件（含 PLAN.md、报告、JSON 等归档物），必须按本技能执行 Session→ARCHIVE_ID、TIMESTAMP、双轨路径（根段须为 archives/）、回读校验与状态回执；WebUI 的 archive_grid 必须用 Markdown 中语言标识为 json 的围栏代码块输出。
KWeaver CLI 操作层 — 内化自 kweaver-core。 覆盖认证、平台业务域（config）、知识网络管理与查询、Agent CRUD 与对话、 数据源管理、数据视图、Skill 注册、Vega 可观测、context-loader 语义搜索、通用 API 调用。 仅由 bkn-creator pipeline 内部读取，不独立注册到宿主 skill 系统。
| name | data-semantic |
| description | 数据语义服务 API - 提供表单视图的语义理解功能。 用于: (1) 查询字段语义和业务对象识别结果 (2) 触发/批量理解表单视图 (3) 批量业务对象匹配 |
| version | 1.2.0 |
| user-invocable | true |
| metadata | {"openclaw":{"skillKey":"data_semantic","emoji":"🧠"}} |
| config | {"kn_id":"d6ptuq46vfkhfektuntg","ot_id":"d6rmtl46vfkhfektuoe0","base_url":"https://dip.aishu.cn/api/data-semantic/v1","logic_view_base_url":"https://dip.aishu.cn/api/data-view/v1"} |
| 操作 | 说明 | 关键参数 |
|---|---|---|
list | 查询逻辑视图列表 | keyword, datasource_id |
query | 查询语义理解结果 | form_view_id |
understand | 触发表单理解 | form_view_id 或 datasource_id |
batch | 批量理解（≤100个） | form_view_ids |
match | 批量对象匹配 | kn_id, ot_id, entries |
| 参数 | 必填 | 说明 |
|---|---|---|
operation | ✅ | list/query/understand/batch/match |
auth_token | ✅ | JWT Token |
form_view_id | query/understand | 单视图 ID |
datasource_id | 数据源理解 | 数据源 UUID |
keyword | 可选 | 关键字搜索 |
operation: list
keyword: 用户
operation: query
form_view_id: <uuid>
输出：字段语义表格 + 业务对象表格 + 属性表格
operation: understand
form_view_id: <uuid>
输出：字段语义表格 + 业务对象表格 + 属性表格
operation: batch
form_view_ids: [<uuid1>, <uuid2>, ...]
输出：仅统计报告，不输出详细语义
operation: understand
datasource_id: <uuid>
≤50个视图直接执行，>50个调用Python脚本
operation: match
kn_id: <配置值>
ot_id: <配置值>
entries: [{"name": "客户信息"}]
| 状态码 | 状态名称 | 处理动作 |
|---|---|---|
| 0 | 未理解 | 触发生成 → 轮询等待 → 状态2后提交确认 → 重新生成 → 轮询 → 提交确认 → 完成 |
| 1 | 理解中 | 轮询等待 → 状态2/3/4 → 同状态2处理 |
| 2 | 待确认 | 提交确认 → 重新生成 → 轮询等待 → 状态2后提交确认 → 完成 |
| 3 | 已完成 | 触发重新生成 → 轮询等待 → 状态2后提交确认 → 完成 |
| 4 | 待确认(重新理解) | 触发重新生成 → 轮询等待 → 状态2后提交确认 → 完成 |
| 5 | 理解失败 | 输出失败原因，终止 |
⚠️ 批量理解时，无论当前状态是已完成(3)还是待确认(4)，都会触发重新理解
# 数据源批量理解
python scripts/data_semantic_batch.py --token <JWT> --datasource-id <UUID>
# 批量视图理解
python scripts/data_semantic_batch.py --token <JWT> --view-ids <id1,id2>
# 断点续传
python scripts/data_semantic_batch.py --token <JWT> --resume
📊 数据语义理解报告
| 项目 | 内容 |
|---|---|
| 视图技术名称 | <tech_name> |
| 视图业务名称 | <biz_name> |
| 理解状态 | <status_name> |
📈 识别统计
| 类别 | 统计 |
|---|---|
| 字段语义 | 总字段: <total>, 已补全: <completed> |
| 业务对象 | 对象: <count> 个, 属性: <attr_count> 个 |
| 技术名称 | 业务名称 | 字段角色 | 字段描述 |
|---|---|---|---|
| user_id | 用户ID | 业务主键 | 用户唯一标识 |
| user_name | 用户名称 | 业务特征 | 用户姓名 |
| create_time | 创建时间 | 时间字段 | 记录创建时间 |
| 技术名称 | 字段类型 | 字段描述 |
|---|---|---|
| ext_field1 | VARCHAR | 扩展字段 |
| 属性名称 | 字段技术名称 | 字段业务名称 | 字段角色 | 字段描述 |
|---|---|---|---|---|
| 客户ID | customer_id | 客户编号 | 业务主键 | 客户唯一标识 |
| 客户名称 | customer_name | 客户名称 | 业务特征 | 客户姓名 |
🧠 批量理解报告
| 项目 | 内容 |
|---|---|
| 总视图数 | <total_count> |
| 成功 | <success_count> |
| 失败 | <fail_count> |
批量理解仅输出统计报告，如需详情请单独查询
echo | curl -d @-