dsh-plugin-t-expert 0.4.26 → 0.4.36

package/data/experts/engineering/jinshuju-table-expert/skills/jinshuju-table/references/examples.md

@@ -0,0 +1,191 @@
+# 金数据表格 MCP 示例手册
+
+收录典型场景的 prompt 模板和预期结果，帮助用户快速上手数据表格操作。
+
+---
+
+## 一、建表
+
+### 1.1 客户跟进表
+
+**Prompt：**
+
+> 帮我建一张"客户跟进表"，列：
+> - 客户名称（文本）
+> - 联系电话（手机号）
+> - 跟进状态（单选：待跟进 / 跟进中 / 已成交 / 已流失）
+> - 下次跟进日期（日期）
+> - 备注（文本）
+
+**AI 调用**：`create_table`，`fields`：
+
+```json
+[
+  {"type": "TextArea", "label": "客户名称"},
+  {"type": "MobileField", "label": "联系电话"},
+  {"type": "RadioButton", "label": "跟进状态", "choices": [
+    {"value": "待跟进"}, {"value": "跟进中"}, {"value": "已成交"}, {"value": "已流失"}
+  ]},
+  {"type": "DateTimeField", "label": "下次跟进日期", "precision": "day"},
+  {"type": "TextArea", "label": "备注"}
+]
+```
+
+**预期输出**：返回表结构，含各列 `api_code`（如 `field_1`…）与「跟进状态」选项的 `choices[].api_code`。
+
+### 1.2 带公式列的项目管理表
+
+**Prompt：**
+
+> 建一张"项目预算表"，列：项目名称、预算金额（数字）、已用金额（数字），再加一列公式列「已用占比」= 已用金额 / 预算金额。
+
+**AI 调用**：`create_table`。公式列引用同一请求里新增的列时，给被引用列加 `cid`，公式用 `<gd-field data-cid="…">` 引用（此时新列还没有 `api_code`）：
+
+```json
+[
+  {"type": "TextArea", "label": "项目名称"},
+  {"type": "NumberField", "label": "预算金额", "cid": "c_budget"},
+  {"type": "NumberField", "label": "已用金额", "cid": "c_used"},
+  {"type": "FormulaField", "label": "已用占比",
+   "formula_display": "<gd-field data-cid=\"c_used\"></gd-field> / <gd-field data-cid=\"c_budget\"></gd-field>"}
+]
+```
+
+> ⚠️ 公式列只读，不能写入 entry；它的值随预算 / 已用列自动计算。
+
+---
+
+## 二、改列
+
+### 2.1 给已有表加列
+
+**Prompt：**
+
+> 给"项目预算表"加一列「负责人」（文本）和一列「是否验收」（勾选）。
+
+**AI 调用**：`get_table`（确认表 token 与现有列）→ `edit_table`：
+
+```json
+{
+  "table_token": "<表 token>",
+  "fields": {
+    "add": [
+      {"type": "TextArea", "label": "负责人"},
+      {"type": "BooleanField", "label": "是否验收"}
+    ]
+  }
+}
+```
+
+### 2.2 改选项文案（保留 api_code）
+
+**Prompt：**
+
+> 把"客户跟进表"里跟进状态的「已流失」改名成「暂缓」。
+
+**AI 调用**：`get_table` 拿「跟进状态」列及「已流失」选项的 `api_code` → `edit_table` 用 `fields.update_choices` 的 update（**保留 api_code**）改名，而不是 remove+add。
+
+> ⚠️ 用 remove+add 会换 api_code，历史行里引用旧选项的数据会失联。
+
+### 2.3 删列（先确认数据）
+
+**Prompt：**
+
+> 把"客户跟进表"的备注列删掉。
+
+**AI 流程**：`get_table` 拿「备注」列 `api_code` → 告知用户"删除该列会永久清除已有行里这一列的数据，不可恢复" → 用户确认后 `edit_table`，`fields.remove: ["<备注 api_code>"]`。
+
+---
+
+## 三、行数据
+
+### 3.1 条件查询 + 投影
+
+**Prompt：**
+
+> 把"客户跟进表"里跟进状态=待跟进、且下次跟进日期在本周的行列出来，只要客户名称、联系电话、下次跟进日期。
+
+**AI 调用**：
+1. `get_table`：记下「跟进状态」列 `api_code`（如 `field_status`）、"待跟进"选项 `api_code`（如 `status_pending`）、「下次跟进日期」列 `api_code`（如 `field_next`）
+2. `list_entries`（`form_token` 填表 token）用 filters 下推：
+   ```
+   filters=[
+     {"field": "field_status", "operator": "eq", "value": "status_pending"},
+     {"field": "field_next", "operator": "between", "value": ["<本周一 ISO>", "<本周日 ISO>"]}
+   ]
+   ```
+   `next` 翻页拿全部命中
+3. 对话侧投影三列，手机号脱敏，Markdown 表格展示 + 总数
+
+> ⚠️ 选项列 value 传**选项 api_code** 不是 label；`list_entries` 不支持任意列排序，倒序 / 取前 N 在对话侧做。
+
+### 3.2 补录一行
+
+**Prompt：**
+
+> 在"客户跟进表"加一行：客户名称 A 科技、电话 13900008888、状态 跟进中、下次跟进 2026-08-01。
+
+**AI 调用**：`get_table` 拿列 api_code 和"跟进中"选项 api_code → `create_entry`：
+
+```json
+{
+  "form_token": "<表 token>",
+  "entry": {
+    "field_name": "A 科技",
+    "field_mobile": "13900008888",
+    "field_status": "status_following",
+    "field_next": "2026-08-01"
+  }
+}
+```
+
+> ⚠️ entry 的键是列 `api_code`；选项列 value 是选项 `api_code`；手机号要真实号段，测试号段（13800138000）会被拒。
+
+### 3.3 批量导入行
+
+**Prompt：**
+
+> 把这 50 个客户导入"客户跟进表"（贴了一份名单）。
+
+**AI 流程**：`get_table` 拿列 api_code → 把每行整理成 `{api_code: value}` → `create_entries`（一次 ≤200）→ 读 `created_count` + `errors`，向用户汇总成功 / 失败（按 `errors` 下标只补失败行，不整批重发）。
+
+### 3.4 批量更新行
+
+**Prompt：**
+
+> 把"客户跟进表"里下次跟进日期已经过期、状态还是「跟进中」的行，状态都改成「待跟进」。
+
+**AI 流程**：
+1. `get_table` 拿「跟进状态」「下次跟进日期」列 api_code 和目标选项 api_code
+2. `list_entries` + filters 拉命中集：
+   ```
+   filters=[
+     {"field": "field_status", "operator": "eq", "value": "status_following"},
+     {"field": "field_next", "operator": "lt", "value": "<今天 ISO>"}
+   ]
+   ```
+3. 展示前 10 行 + 总数，向用户确认
+4. 确认后 `patch_entries` 一次提交（每行 `{serial_number, entry: {field_status: "status_pending"}}`，每批 ≤200）
+5. 读 `updated_count` + `failed_rows`，汇总成功 / 失败
+
+### 3.5 批量删除行（高风险）
+
+**Prompt：**
+
+> 删掉"客户跟进表"里状态是「已流失」的所有行。
+
+**AI 流程**：`get_table` → `list_entries` + filters 命中，拿全部 `serial_number` → **必须**得到用户显式"确认删除" → 逐行循环 `delete_entry`（无批量版）→ 每 20 行汇报进度、结束汇总。
+
+---
+
+## 四、Prompt 模板速查
+
+| 场景 | 模板 |
+| --- | --- |
+| 建数据表 | `帮我建一张"<表名>"，列：<列列表>` |
+| 加列 | `给"<表名>"加一列"<列名>"（<类型>）` |
+| 改选项 | `把"<表名>"里 <列> 的"<旧选项>"改名成"<新选项>"` |
+| 查行 | `查"<表名>"里 <条件> 的行，只要<列>` |
+| 改行 | `把"<表名>"里 <条件> 的行，<列>都改成"<值>"` |
+| 导入行 | `把这些数据导入"<表名>"` |
+| 删行 | `删掉"<表名>"里 <条件> 的行` |

package/data/experts/engineering/jinshuju-table-expert/skills/jinshuju-table/references/guide.md

@@ -0,0 +1,125 @@
+# 金数据表格 MCP 使用指南
+
+> 一句话介绍：让 AI 助手直接读写你的金数据数据表——"建表、加改列、查行、批改行"都能用一句中文搞定，不用登录后台。
+
+---
+
+## 一、适用场景
+
+| 角色 | 典型场景 |
+| --- | --- |
+| 🛒 销售 / 客服 | 客户跟进表、线索登记、批量更新跟进状态 |
+| 👥 HR / 行政 | 员工信息表、资产台账、培训记录 |
+| 📊 运营 / 数据 | 项目管理表、内容排期表、带公式列的指标看板 |
+| 🧾 财务 / 采购 | 预算表、报销台账、供应商清单 |
+
+共同特征：**数据是结构化的「列 + 行」，需要长期维护、批量增改，而不是一次性对外收集**。要对外收集报名 / 问卷，请用金数据「表单」产品。
+
+> ⚠️ **前置条件**：数据表格需账户开通「新版表格」。未开通时工具会报错，按提示在金数据后台开通。
+
+---
+
+## 二、分步安装配置
+
+### 前置条件
+
+- 已注册**金数据**账号（[jinshuju.net](https://jinshuju.net)）并开通「新版表格」
+- 已安装并登录**支持 MCP 的 AI 客户端**（Claude Desktop、Cursor、WorkBuddy 等）
+
+金数据 MCP 支持两种认证方式，任选其一，MCP 地址相同：**`https://jinshuju.net/mcp`**（表单与表格共用端点）。
+
+### 方式 A · API Key/Secret（推荐）
+
+1. 登录金数据后台 →「个人设置 → API / 开发者」，创建并复制 **API Key / API Secret**
+2. 生成 Basic 凭证：`echo -n "YOUR_API_KEY:YOUR_API_SECRET" | base64`
+3. 在客户端 MCP 配置里粘贴：
+
+```json
+{
+  "mcpServers": {
+    "jinshuju-table": {
+      "url": "https://jinshuju.net/mcp",
+      "headers": { "Authorization": "Basic BASE64_ENCODED_CREDENTIALS" }
+    }
+  }
+}
+```
+
+### 方式 B · OAuth 2.0
+
+1. 客户端「添加连接器」→ Name = `金数据表格`，URL = `https://jinshuju.net/mcp`
+2. 弹出金数据登录页，登录并点「允许」，连接器变 ✅ 即完成（token 过期自动刷新）
+
+### 首次验证
+
+在对话框发送：**「列一下我金数据里最近 5 张数据表」**。能返回表列表说明打通。🎉
+
+---
+
+## 三、效果展示
+
+### 案例 1｜一句话建表
+
+**输入：**
+
+> 建一张"客户跟进表"，列：客户名称、联系电话、跟进状态（待跟进/跟进中/已成交/已流失）、下次跟进日期、备注。
+
+| | 手工搭建 | MCP 一句话 |
+| --- | --- | --- |
+| 步骤 | 登录 → 新建表 → 逐列添加 → 设类型 / 选项 | 发一句话 |
+| 耗时 | 5–10 分钟 | 10 秒 |
+
+### 案例 2｜条件查询
+
+**输入：**
+
+> 查"客户跟进表"里状态=待跟进、下次跟进在本周的行，只要客户名称、电话、下次跟进日期。
+
+**输出（脱敏）**：Markdown 表格 + 总匹配数，结果可被 AI 接续（写跟进话术、生成 CSV）。
+
+### 案例 3｜批量改状态
+
+**输入：**
+
+> 把"客户跟进表"里下次跟进已过期、状态还是「跟进中」的行，状态都改成「待跟进」。
+
+**效果**：先列命中行让你确认 → 确认后 `patch_entries` 批量更新 → 汇总成功 / 失败行数。
+
+---
+
+## 四、常见误区 & Tips
+
+### ⚠️ 常见误区
+
+1. **表格 = 表单** —— 不是。数据表格是「列 + 行」的结构化数据表（多维表格 / 在线数据库），对外收集用「表单」产品。
+2. **"用户说中文列名 AI 就能直接写进去"** —— 不行。entry payload 的键是列 `api_code`（如 `field_1`），不是中文列名。AI 每次会先 `get_table` 拿映射再写，你说中文就行。
+3. **"改错了没法恢复"** —— 批量 / 删列前 AI 会让你确认；但删有数据的列会永久清除该列数据，务必确认。
+4. **"公式列可以直接填值"** —— 不行。公式列（FormulaField）只读，值由公式自动算。
+5. **"数据量大也能一次拉回来"** —— `list_entries` 单次上限 50 行，分页靠游标；用 `filters` 把条件下推到数据库先收窄命中集，比拉全量快得多。
+
+### 💡 使用 Tips
+
+- **✨ 先「看一眼」再动手**：批量操作前让 AI 先 `get_table` 确认列，准确率更高
+- **✨ 带时间 + 数量**：加"最近 7 天""前 50 行"更稳
+- **✨ 主动要求脱敏**：「手机号打星」AI 会自动处理
+- **✨ 公式列建表时一次带上**：用 `cid` + `<gd-field data-cid>` 引用同批新增列
+- **✨ 改选项用改名不用删建**：保留 api_code，历史行不失联
+
+### 🆘 遇到问题
+
+| 现象 | 解决办法 |
+| --- | --- |
+| 提示未开通新版表格 | 到金数据后台开通「新版表格」后重试 |
+| 一直转圈连不上 | 刷新重试；仍失败 → 删除连接器重新添加 |
+| 列类型建不出来 | 表格仅支持白名单列类型（见 tools.md）；不在其中的类型会被拒 |
+| 提示"Resource is not a table" | 目标是普通表单不是数据表，用表单产品操作 |
+| 操作被拒绝 | 该表是协作表且你无编辑权限，联系所有者 |
+
+---
+
+## 五、安全与权限
+
+- MCP 所有操作都按当前凭证所属账号的权限执行——看不到你无权访问的数据
+- 重要操作（批量删除、删列）AI 会要求显式确认
+- **Basic 方式**：凭证以 Base64 存在客户端配置；若泄露，到「个人设置 → API / 开发者」重置 Secret，旧凭证立即失效；本地 `mcp.json` 勿提交到公共仓库
+- **OAuth 方式**：凭证由客户端托管，可随时在金数据「设置 → 授权管理」撤销

package/data/experts/engineering/jinshuju-table-expert/skills/jinshuju-table/references/tools.md

@@ -0,0 +1,157 @@
+# 金数据表格 MCP 工具参考
+
+金数据表格 MCP 端点：`https://jinshuju.net/mcp`（与表单共用端点）。表格结构工具需账户开通「新版表格」。以下按 `数据表结构` → `行数据 Entries` → `上传` → `账户与团队` 分组。
+
+> 通用约定：
+> - 表结构工具用**表 token / id** 定位；行数据工具的 `form_token` 参数直接填**表 token**。
+> - 行数据读写一律用**列 `api_code`**，选项列用 `choices[].api_code`，不是中文列名 / label。
+> - 分页统一走响应里的 `next` 游标；`limit` 越界自动截断。
+> - 报 `Insufficient scope: <name> required` 说明缺对应 OAuth scope；报未开通新版表格说明账户需在后台开通。
+
+---
+
+## 一、数据表结构（scope: forms，需开通新版表格）
+
+### list_tables — 列出数据表
+
+列出当前用户可访问的数据表，支持关键字过滤与游标分页。
+
+**输入**
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `name` | string | 否 | 表名关键字过滤（不区分大小写） |
+| `next` | string | 否 | 翻页游标 |
+| `limit` | integer | 否 | 每页条数，默认 / 上限 50 |
+
+**输出**：`{ total, count, data: [表摘要…], next }`。用 `next` 翻下一页；`next` 为空表示到底。
+
+### get_table — 查看数据表详情
+
+取一张数据表的完整结构：列（`api_code`、类型、label、选项 `choices[].api_code`）等。
+
+**输入**
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `token` | string | 是 | 表 token 或 id |
+
+**输出**：数据表序列化结构。写 / 改 / 过滤行数据前，先用它拿列 `api_code`。若目标资源不是数据表（是普通表单），会报 `Resource is not a table`。
+
+### create_table — 创建数据表
+
+**输入**
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `name` | string | 是 | 表名 |
+| `fields` | array | 是 | 列定义数组（见下）|
+| `folder_token` | string | 否 | 放入指定文件夹 |
+
+**列定义（`fields[]` item）**
+
+| 键 | 类型 | 说明 |
+|----|------|------|
+| `type` | string | 列类型，见「支持的列类型」；必填 |
+| `label` | string | 列名；必填 |
+| `cid` | string | 客户端临时 id，用于同一请求内被公式列引用（`<gd-field data-cid="…">`）|
+| `choices` | array | 仅 `RadioButton` / `CheckBox`：`[{ value: "选项文字" }]` |
+| `precision` | integer/string | 仅 `DateTimeField`：month / day / minute / second |
+| `formula_display` | string | 仅 `FormulaField`：公式结果展示方式 |
+| 数字格式相关 | — | 数字/公式列的显示格式（如 `displayPrecision`）；不可设存储 `precision` |
+
+**支持的列类型**：`TextArea` `RadioButton` `CheckBox` `BooleanField` `MobileField` `NumberField` `DateTimeField` `EmailField` `LinkField` `AttachmentField` `FormulaField`。
+
+**输出**：新表序列化结构（含各列 `api_code`）。常见报错：`Field type not supported for tables`（列类型不在白名单）、`Attachment upload limits are fixed for table columns`（附件列传了上传限制）、`Storage precision is not supported…`（数字/公式列传了 `precision`）。
+
+### edit_table — 编辑数据表（改名 + 增删改列，原子）
+
+一次请求内对列做增 / 删 / 改 / 选项操作，原子生效。
+
+**输入**
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `table_token` | string | 是 | 表 token 或 id |
+| `name` | string | 否 | 新表名 |
+| `fields` | object | 否 | 列级操作，见下 |
+
+**`fields` 操作**
+
+| 键 | 说明 |
+|----|------|
+| `add` | 新增列数组，item 同 create_table 的列定义 |
+| `remove` | 要删列的 `api_code` 字符串数组（删有数据的列会永久清除该列数据）|
+| `update` | 改列属性数组，每项**必须带 `api_code`** 保持 identity（可改 `label`、`precision`、`formula_display`、数字格式）|
+| `update_choices` | 选项增删改；改名用 update 保留 `api_code`，避免历史数据引用失效 |
+
+**输出**：更新后的数据表结构。约束报错同 create_table；非数据表会报 `Resource is not a table`。
+
+---
+
+## 二、行数据 Entries（scope: read_entries / write_entries）
+
+数据表的行与表单数据共用同一批 entries 工具，`form_token` 参数填**表 token**。行用 `serial_number`（整数）定位。
+
+### list_entries — 列出行
+
+**输入**：`form_token`(表 token) ✅、`filters`（`[{field, operator, value}]` 下推过滤，多条件 AND）、`next`（游标）、`limit`（≤50）。
+**输出**：`{ data: [行…], next, … }`。列值键是列 `api_code`。不支持任意列排序 / group by，排序、聚合在对话侧做。
+
+**filters operator 速查**
+
+| operator | 适用列 | value |
+|----------|--------|-------|
+| `eq` / `ne` | 所有 | 标量 |
+| `gt` / `gte` / `lt` / `lte` | 数字、日期 | 标量 |
+| `between` | 数字、日期 | `[min, max]` |
+| `any_in` / `none_in` | 文本、选项 | 数组 |
+| `like` / `not_like` | 文本、选项 | 子串（**不带 %**）|
+| `null` / `not_null` | 所有 | 省略 |
+
+> 特殊字段：`created_at`（创建时间）；`creator_id`（创建者 id，只支持 `eq`）。
+
+### get_entry — 查看单行
+
+**输入**：`form_token`(表 token) ✅、`entry_id`(serial_number) ✅。**输出**：单行完整详情。
+
+### create_entry — 新建单行
+
+**输入**：`form_token`(表 token) ✅、`entry`（`{列 api_code: 值}`）✅。**输出**：含 `serial_number`。值格式见 SKILL.md「关键格式规范」。
+
+### create_entries — 批量新建行
+
+**输入**：`form_token`(表 token) ✅、`entries`（`[{列 api_code: 值}, …]`，一次 ≤200）✅。
+**输出**：`{ created_count, errors: [{index, message}] }`。不幂等，重复提交产生重复行；失败按 `errors` 下标只补失败行。
+
+### update_entry — 更新单行
+
+**输入**：`form_token`(表 token) ✅、`entry_id`(serial_number) ✅、`entry`（要改的列）、`is_put`（默认 `false`=PATCH）。
+> ⚠️ `is_put=true` 会清空未提供列，仅"整行替换"时用且需二次确认。
+
+### patch_entries — 批量更新行（PATCH）
+
+**输入**：`form_token`(表 token) ✅、`entries`（`[{ serial_number, entry }, …]`，一次 ≤200）。
+**输出**：`{ updated_count, failed_rows: [{serial_number, reason}] }`。PATCH 只改提供列。
+
+### delete_entry — 删除单行
+
+**输入**：`form_token`(表 token) ✅、`entry_id`(serial_number) ✅。无批量版，逐行循环；不可逆，先确认。
+
+---
+
+## 三、上传（scope: write_entries）
+
+### prepare_entry_attachment_upload — 附件列上传凭证
+
+为附件列（`AttachmentField`）换取上传凭证，上传本地文件后把返回引用写入该列。
+
+---
+
+## 四、账户与团队
+
+| 工具 | scope | 用途 |
+|------|-------|------|
+| `get_current_user` | `user` | 当前用户信息 |
+| `get_current_billing_account` | `billing_account` | 企业套餐与用量（确认是否开通新版表格）|
+| `list_account_users` | `billing_account` | 团队成员列表 |

package/data/experts/engineering/jinshuju-table-expert/skills/jinshuju-table/scripts/setup.py

@@ -0,0 +1,142 @@
+#!/usr/bin/env python3
+"""
+金数据表格 MCP Skill 安装辅助脚本
+
+这是一个 MCP 类型的 Skill —— 实际能力由远端 MCP Server 提供，
+无需在本地安装任何 Python / Node 依赖。表格工具需账户开通「新版表格」。
+
+脚本作用：
+1. 把 API Key / Secret 编码成 Basic 凭证
+2. 打印 / 生成 MCP 连接配置片段，方便粘贴到 AI 客户端
+
+用法：
+    python3 setup.py                               # 打印配置说明
+    python3 setup.py --encode KEY SECRET           # 把 Key/Secret 编成 Basic 凭证
+    python3 setup.py --print-json KEY SECRET       # 输出含 Authorization 头的 mcp.json
+"""
+
+from __future__ import annotations
+
+import argparse
+import base64
+import json
+import sys
+
+MCP_NAME = "jinshuju-table"
+MCP_URL = "https://jinshuju.net/mcp"
+
+
+def encode_basic(api_key: str, api_secret: str) -> str:
+    """把 API Key + Secret 拼成 `key:secret` 并 Base64 编码。"""
+    raw = f"{api_key}:{api_secret}".encode("utf-8")
+    return base64.b64encode(raw).decode("ascii")
+
+
+def build_snippet(credentials: str = "BASE64_ENCODED_CREDENTIALS") -> dict:
+    return {
+        "mcpServers": {
+            MCP_NAME: {
+                "url": MCP_URL,
+                "headers": {
+                    "Authorization": f"Basic {credentials}",
+                },
+            }
+        }
+    }
+
+
+def print_banner() -> None:
+    print("=" * 60)
+    print("  金数据表格 MCP Skill · 安装辅助")
+    print("=" * 60)
+
+
+def print_setup_instructions() -> None:
+    print_banner()
+    print()
+    print(f"MCP 地址：{MCP_URL}")
+    print("（表单与表格共用同一端点；表格工具需账户开通「新版表格」）")
+    print()
+    print("金数据 MCP 支持两种认证方式，由用户自行选择：")
+    print()
+    print("─" * 60)
+    print(" 方式 A · HTTP Basic（API Key/Secret）")
+    print("─" * 60)
+    print()
+    print("第 1 步：登录金数据后台 →「个人设置 → API / 开发者」，")
+    print("         创建并复制 API Key / API Secret。")
+    print()
+    print("第 2 步：生成 Basic 凭证：")
+    print('         echo -n "YOUR_API_KEY:YOUR_API_SECRET" | base64')
+    print("         （或运行 `python3 setup.py --encode KEY SECRET`）")
+    print()
+    print("第 3 步：在 AI 客户端（Claude Desktop / Cursor / WorkBuddy 等）中添加 MCP 连接器。")
+    print()
+    print(f"  名称       ：{MCP_NAME}")
+    print(f"  地址 (URL) ：{MCP_URL}")
+    print(f"  请求头     ：Authorization: Basic BASE64_ENCODED_CREDENTIALS")
+    print()
+    print("或把以下片段粘贴到客户端的 MCP 配置：")
+    print()
+    print(json.dumps(build_snippet(), indent=2, ensure_ascii=False))
+    print()
+    print("─" * 60)
+    print(" 方式 B · OAuth 2.0")
+    print("─" * 60)
+    print()
+    print("  1. 打开 AI 客户端的连接器 / Connectors 管理入口")
+    print("  2. 选择「添加连接器 (Add custom connector)」")
+    print(f"  3. Name = {MCP_NAME}，URL = {MCP_URL}")
+    print("  4. 点击 Add，弹出金数据登录页，登录并点「允许」")
+    print("  5. 连接器状态变成 ✅ 即完成，无需手动生成凭证")
+    print()
+    print("─" * 60)
+    print()
+    print("添加完成后，在对话里发送 '列一下我金数据里的数据表' 即可验证。")
+    print()
+    print("其它命令：")
+    print("  python3 setup.py --encode KEY SECRET       # 生成 Basic 凭证")
+    print("  python3 setup.py --print-json KEY SECRET   # 生成可直接粘贴的 mcp.json")
+
+
+def cmd_encode(api_key: str, api_secret: str) -> int:
+    credentials = encode_basic(api_key, api_secret)
+    print(credentials)
+    return 0
+
+
+def cmd_print_json(api_key: str | None, api_secret: str | None) -> int:
+    if api_key and api_secret:
+        credentials = encode_basic(api_key, api_secret)
+    else:
+        credentials = "BASE64_ENCODED_CREDENTIALS"
+    print(json.dumps(build_snippet(credentials), indent=2, ensure_ascii=False))
+    return 0
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="金数据表格 MCP Skill 安装辅助")
+    parser.add_argument("--encode", nargs=2, metavar=("KEY", "SECRET"),
+                        help="把 API Key / Secret 编码成 Basic 凭证并输出")
+    parser.add_argument("--print-json", nargs="*", metavar=("KEY", "SECRET"),
+                        help="输出含 Authorization 头的 mcp.json 片段；"
+                             "不带参数则保留占位符")
+    args = parser.parse_args()
+
+    if args.encode:
+        return cmd_encode(args.encode[0], args.encode[1])
+
+    if args.print_json is not None:
+        if len(args.print_json) == 2:
+            return cmd_print_json(args.print_json[0], args.print_json[1])
+        if len(args.print_json) == 0:
+            return cmd_print_json(None, None)
+        print("--print-json 需要 0 个或 2 个参数（KEY SECRET）", file=sys.stderr)
+        return 2
+
+    print_setup_instructions()
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/data/experts/engineering/kdocs-data-table/.codebuddy-plugin/plugin.json

@@ -0,0 +1,71 @@
+{
+  "name": "kdocs-data-table",
+  "version": "2.6.4",
+  "description": "数据建表专家：接龙转表格、智能表单创建、表格美化。",
+  "author": {
+    "name": "Kingsoft Office",
+    "email": "kdocs@wps.com"
+  },
+  "expertType": "agent",
+  "agentName": "kdocs-data-table",
+  "agents": [
+    "./agents/kdocs-data-table.md"
+  ],
+  "skills": [
+    "./skills/jielong-table",
+    "./skills/form-collection",
+    "./skills/table-beautify"
+  ],
+  "displayName": {
+    "en": "KDocs Smart Table Assistant",
+    "zh": "金山文档智能建表助手"
+  },
+  "profession": {
+    "en": "Data Table Expert",
+    "zh": "数据建表专家"
+  },
+  "displayDescription": {
+    "en": "By Kingsoft Docs Turn group-chat jielong into structured tables, create shareable WPS smart forms, and beautify spreadsheets with rule enforcement (conditional formatting, data validation dropdowns, and range protection). Excels at jielong parsing, form design, format normalization and deduplication.",
+    "zh": "金山文档出品，专注接龙转表与智能表单，支持条件格式、数据校验和区域保护，省心好用。"
+  },
+  "avatar": "avatars/expert.png",
+  "categoryId": "04-DataAI",
+  "defaultInitPrompt": {
+    "zh": "帮我把这段接龙整理成表格：\n1. 张三 2份牛肉\n2. 李四 1份鸡排 3份牛肉\n3. 王五 5份鸡排",
+    "en": "Turn this jielong into a table: 1. Zhang San 2x beef 2. Li Si 1x chicken 3x beef 3. Wang Wu 5x chicken"
+  },
+  "tags": [
+    {
+      "en": "Jielong to Table",
+      "zh": "接龙转表格"
+    },
+    {
+      "en": "Smart Form",
+      "zh": "智能表单"
+    },
+    {
+      "en": "Smart Sheet",
+      "zh": "智能表格"
+    }
+  ],
+  "quickPrompts": [
+    {
+      "en": "Turn this jielong into a table: 1. Zhang San 2x beef 2. Li Si 1x chicken 3x beef 3. Wang Wu 5x chicken",
+      "zh": "帮我把这段接龙整理成表格：\n1. 张三 2份牛肉\n2. 李四 1份鸡排 3份牛肉\n3. 王五 5份鸡排"
+    },
+    {
+      "en": "Create a class outing sign-up form collecting name, phone, bus needed, and lunch preference",
+      "zh": "帮我做一个班级春游报名表，收集姓名、联系电话、是否需要租车、午餐偏好"
+    },
+    {
+      "en": "Clean up this customer info sheet — some phone formats are inconsistent and some rows are duplicates",
+      "zh": "帮我优化一下这个客户信息表，有些手机号格式不统一，有些行是重复的"
+    }
+  ],
+  "plugin": "kdocs-data-table",
+  "dependencies": {
+    "connectors": [
+      "kdocs"
+    ]
+  }
+}