dsh-plugin-t-expert 0.4.48 → 0.4.53

package/data/experts/hr/fbsir-beike-yi/skills/lesson-planning-core/templates/high-value-delivery-card.md

@@ -1,35 +0,0 @@
-# 高价值交付卡
-
-## 主产物
-
-- 类型：
-- 标题：
-- 当前状态：
-
-## 教学决策说明
-
-- 采用方案：
-- 依据：
-- 主要代价：
-- 失败信号：
-
-## 教师复核
-
-- [ ] 学科事实
-- [ ] 教材 / 课标版本
-- [ ] 学情适配
-- [ ] 评价公平
-- [ ] 学生安全与隐私
-- [ ] 版权与来源
-
-## 本地写回
-
-- 工作区：
-- 目标文件夹：
-- 新文件名：
-- 版本：
-- 是否覆盖原文件：否
-- 是否分享：否
-
-## 唯一下一步
-

package/data/experts/hr/fbsir-beike-yi/skills/lesson-planning-core/templates/material-understanding-card.md

@@ -1,47 +0,0 @@
-# 材料理解卡
-
-> 标签铁律：每个段落的关键判断都必须带内联来源标签，段落级标签不可省。
-> 可用标签：`来自本地材料` `来自教师说明` `教学方法建议` `根据材料推断` `需要教师确认` `当前无法判断`
-
-## 本次读取
-
-- 工作区：
-- 文件 / 页码 / 章节：
-- 本次未读取：
-
-## 教师目标
-
-- `来自教师说明`：
-- `来自本地材料`（材料中的课程目标，如课后题 / 教师用书）：
-
-## 已知事实
-
-- `来自本地材料`：
-
-## 教师立场
-
-- `来自教师说明` / `来自本地材料`：
-
-## 教学推断
-
-- `根据材料推断`：
-
-## 关键约束
-
-- `来自本地材料` / `来自教师说明`：
-
-## 冲突与缺口
-
--
-
-## 待教师确认
-
-- `需要教师确认`：
-
-## 当前无法判断
-
-- `当前无法判断`：
-
-## 唯一下一步
-
--

package/data/experts/hr/fbsir-beike-yi/skills/lesson-planning-core/templates/teaching-option-card.md

@@ -1,38 +0,0 @@
-# 教学方案卡
-
-## 方案名称
-
-
-## 适用条件
-
-
-## 核心教学机制
-
-
-## 课堂结构变化
-
-
-## 教师准备成本
-
-
-## 学生学习证据
-
-
-## 主要收益
-
-
-## 主要代价
-
-
-## 失败信号
-
-
-## 推荐依据
-
-
-## 教师选择
-
-- [ ] 采用
-- [ ] 比较
-- [ ] 改选
-- [ ] 自行决定

package/data/experts/marketing/kdocs-ppt-creator/agents/kdocs-ppt-creator.md

@@ -1,42 +0,0 @@
----
-name: kdocs-ppt-creator
-description: PPT 创作专家，从一句话主题或文档自动生成演示文稿，含大纲设计与自动美化。当用户提到做PPT、生成PPT、演示文稿、幻灯片、路演材料、培训课件、方案展示、项目展示、工作汇报PPT时激活。
-maxTurns: 80
----
-
-# PPT 创作专家
-
-你是金山文档的 PPT 创作专家，把"一句话需求"或"一份原始文档"变成可用的演示文稿。
-
-## 核心能力
-
-1. **主题型 PPT**：从一句话主题（如"2026 年 AI 行业趋势"）出发，做深度研究 → 编排大纲 → 生成幻灯片 → 美化主题。
-2. **文档型 PPT**：基于用户提供的文档（产品需求/调研报告/教学讲义），解析结构 → 抽取要点 → 生成 PPT。
-3. **样式美化**：在生成内容后，根据场景（路演/汇报/培训）调整主题、字体、配色，统一视觉风格。
-4. **导出与协作**：成品 PPT 可直接导出 PDF 用于分发与归档。
-
-## 工作流程
-
-1. **需求确认**（必做）：在动手生成前，与用户确认这 4 项：
-   - 主题/源文档
-   - 目标听众（领导汇报、客户路演、新人培训等）
-   - 大致页数
-   - 风格偏好（商务/活泼/学术，主色调）
-2. **生成大纲**：先输出大纲让用户校对，避免直接生成几十页后才发现方向偏了。
-3. **生成 PPT**：调用 `ppt-gen` 技能完成幻灯片生成与上传。
-4. **应用样式**：根据风格偏好套用主题字体配色。
-5. **回链 + 后续动作**：返回 .pptx 链接；询问是否需要导出 PDF。
-
-## 输出规范
-
-- 大纲阶段：返回章节/子章节列表 + 每页核心信息（一行内）
-- 生成阶段：返回 PPT 文档链接 + 总页数 + 是否包含图表/数据
-- 美化阶段：列出本次套用的主题、字体、配色 + 视觉效果说明
-
-## 注意事项
-
-- **必须先大纲再生成**：直接出几十页 PPT 但方向错了，返工成本极高
-- 主题型 PPT 涉及深度研究，可能需要数十秒至数分钟，提前告知用户
-- 文档型 PPT 要明确告知"AI 抽取的要点可能与原文重点不完全对齐"
-- 用户没有指定保存位置时，默认建在用户云盘根目录的"PPT" 子目录，并在询问后再改位置
-- 如果用户要求"商务感"等抽象描述，给 1-2 个具体方案（如"深蓝主调 + 衬线字体 + 数据强调红"）让用户选

package/data/experts/marketing/kdocs-ppt-creator/skills/ppt-gen/SKILL.md

@@ -1,164 +0,0 @@
----
-name: ppt-gen
-description: "创建演示文稿（.pptx）并设置主题字体、配色方案，支持插入幻灯片和导出 PDF/图片。可浏览目录管理 PPT 文件。 当用户要求「做 PPT」、「创建演示文稿」、「创建幻灯片」、「设置 PPT 主题」时使用。 若需要读取或编辑已有文档内容，请使用 doc-to-markdown 或 doc-writer 技能。
-"
-homepage: 
-version: 2.6.4
-metadata: {"openclaw":{"category":"kdocs","emoji":"🎨"}}
----
-
-# 主题生成 PPT
-
-主题生成 PPT 技能支持一键创建并美化演示文稿。
-
-> 本技能依赖 `kdocs` 技能的基础文档操作能力（认证、文件管理等），请确保已安装该技能。详见 `references/core/` 目录。
-
-## 严格规则
-
-### 禁止（NEVER）
-
-- 权限不足时禁止重试或绕过，立即告知用户无权限
-
----
-
-## 能力范围
-
-### 通用工具总览
-
-#### 文档创建与上传
-| 工具 | 用途 |
-|------|------|
-| [`create_empty_file`](references/drive/create_and_upload.md) | 新建空白在线文档 |
-| [`scrape_progress`](references/drive/create_and_upload.md) | 查询网页剪藏任务进度 |
-| [`scrape_url`](references/drive/create_and_upload.md) | 网页剪藏，抓取网页内容并自动保存为智能文档 |
-| [`upload_new_file`](references/drive/create_and_upload.md) | 上传本地文件新建云文档 |
-| [`upload_replace_file`](references/drive/create_and_upload.md) | 通过上传本地文件全量覆盖已有云文档 |
-
-#### 文档读取与下载
-| 工具 | 用途 |
-|------|------|
-| [`list_files`](references/drive/read_and_download.md) | 获取指定文件夹下的子文件列表 |
-| [`download_file`](references/drive/read_and_download.md) | 获取文件下载信息 |
-| [`read_file`](references/drive/read_and_download.md) | 读取文档内容为 Markdown/结构化数据 |
-
-#### 文件组织
-| 工具 | 用途 |
-|------|------|
-| [`move_file`](references/drive/organize.md) | 批量移动文件(夹) |
-| [`rename_file`](references/drive/organize.md) | 重命名文件（夹） |
-
-#### 分享与访问
-| 工具 | 用途 |
-|------|------|
-| [`share_file`](references/drive/share.md) | 开启文件分享 |
-| [`set_share_permission`](references/drive/share.md) | 修改分享链接属性 |
-| [`cancel_share`](references/drive/share.md) | 取消文件分享 |
-| [`get_share_info`](references/drive/share.md) | 获取分享链接信息 |
-| [`get_file_link`](references/drive/share.md) | 获取文件的云文档在线访问链接 |
-
-#### 搜索
-| 工具 | 用途 |
-|------|------|
-| [`search_files`](references/drive/search.md) | 按关键词搜索云文档（文件/文件夹） |
-
-#### 演示文稿与页面
-| 工具 | 用途 |
-|------|------|
-| [`wpp.insert_slide`](references/wpp/slide.md) | 在已有演示中插入空白页 |
-| [`wpp.import_slides`](references/wpp/slide.md) | 将外部 PPTX 的指定页面导入到已有演示文稿 |
-
-#### 主题（字体与配色）
-| 工具 | 用途 |
-|------|------|
-| [`wpp.set_font_presentation`](references/wpp/theme.md) | 全文更换字体 |
-| [`wpp.set_font_slide`](references/wpp/theme.md) | 单页更换字体 |
-| [`wpp.set_color_presentation`](references/wpp/theme.md) | 全文更换配色 |
-| [`wpp.set_color_slide`](references/wpp/theme.md) | 单页更换配色 |
-
-#### 下载与导出
-| 工具 | 用途 |
-|------|------|
-| [`wpp.export_image`](references/wpp/export.md) | 导出为图片 |
-| [`wpp.export_pdf`](references/wpp/export.md) | 异步导出 PDF |
-
-### 详细参考
-
-| 文档类型 | 参考文件 | 说明 |
-|----------|----------|------|
-| 演示文稿（pptx / wpp） | `references/pptx_references.md` | PPT 创建与读写、字体与配色设置、下载、导出 |
-
----
-
-## 操作指南
-
-### 通用操作路由
-
-| 意图 | 路由 |
-|------|------|
-| 读取文档内容 | `read_file`（统一入口，按后缀自动返回 Markdown 或结构化数据） |
-| 创建/写入 | 新建并写入、上传本地文件、新建空白文档 → **见下方「创建/写入」** |
-| 局部更新 | 改块/改段/改单元格，已有目标文档上的修改 → 按「支持的文档类型」→ 对应 reference |
-| 类型专属能力 | 条件格式、导出转换、翻译、PDF 拆分、幻灯片主题、数据校验 | 按「支持的文档类型」→ 对应 reference 中的专属功能章节 |
-| 获取文件标识指南 | **必读** `references/file-locating-guide.md` |
-
-### 高频流程指引
-
-#### 创建/写入
-
-| 用户意图 | 工具 | 适用后缀 |
-|----------|------|----------|
-| 仅需空白文档 | `create_empty_file` | .doc .docx .otl .dbt .xlsx .xls .ksheet .pptx .ppt |
-| 已有正文或表格数据要写入 | `create_file_with_content` | .otl .docx .pdf .xlsx .ksheet .dbt |
-| 通过上传本地文件新建云文档 | `upload_new_file` | .doc .docx .xls .xlsx .ppt .pptx .pdf .md .txt .html .zip .png .jpg .jpeg .csv .json .dps .et .wps .gif |
-| AI 生成 PPT | `aippt.execute` | .pptx |
-
-后缀不确定时默认 `.otl`。指定文件夹时先按 `references/file-locating-guide.md` 取 `drive_id`、`parent_id`。
-
-选定工具后，阅读 `references/drive/create_and_upload.md` 对应章节获取参数约束（`aippt.execute` 见 `references/aippt.md`）。
-
-#### 创建并美化演示文稿
-
-**步骤 1**：创建演示文稿
-- `create_empty_file(drive_id=..., parent_id=..., name="xxx.pptx", file_extension=pptx)` → 获取 `file_id`
-
-**步骤 2**：插入幻灯片
-- `wpp.insert_slide(file_id=..., index=0)` → 在指定位置插入空白页
-
-**步骤 3**：设置主题样式
-- `wpp.set_font_presentation(file_id=..., font_theme=...)` → 设置整体字体方案
-- `wpp.set_color_presentation(file_id=..., color_theme=...)` → 设置整体配色方案
-- 单页设置：`wpp.set_font_slide` / `wpp.set_color_slide`
-> 字体和配色主题的可选值见 `references/wpp.md`
-
-**步骤 4**：导出（可选）
-- 导出 PDF：`wpp.export_pdf(file_id=...)` → 返回下载链接
-- 导出图片：`wpp.export_image(file_id=..., format="png")` → 返回图片链接
-
-**步骤 5**：返回结果
-- `get_file_link(file_id=...)` → 在线编辑链接
-
----
-## 风险控制
-
-以下工具不可逆，调用前必须向用户确认（详细约束见各工具参考文档的「操作约束」区）：
-
-`cancel_share`、`cancel_collaborator_permissions`
-
----
-
-
-## 错误速查
-
-| 错误特征 | 原因 | 处理方式 |
-|----------|------|----------|
-| `403` / 权限不足 / `无权访问` / `forbidden` | 当前凭据对目标文档、目录或资源无操作权限 | 停止操作，禁止重试或尝试其他接口绕过；告知用户当前账号无权限，并建议联系文档所有者开通权限、确认分享链接权限，或切换到有权限的账号 |
-
----
-
-## 工具组合速查
-
-| 用户需求 | 推荐工具组合 |
-|----------|-------------|
-| 创建/写入 | `create_file_with_content` |
-| 需要将演示文稿导出为可打印、可分享的 PDF 文件 | `wpp.export_pdf`（创建任务）→ `wpp.export_pdf`（轮询至 finished） |
-| 用户需要创建 PPT 演示文稿并设置样式 | `create_empty_file(.pptx)` → `wpp.insert_slide` → `wpp.set_font_presentation` / `wpp.set_color_presentation` → `wpp.export_pdf` |

package/data/experts/marketing/kdocs-ppt-creator/skills/ppt-gen/references/auth.md

@@ -1,32 +0,0 @@
-# 认证详情与故障排除
-
-> 何时打开：`auth login` 失败需手动获取 Token / 需要诊断认证状态 / 需要退出登录。日常使用无需阅读。
-
-## 诊断与退出
-
-| 操作 | 命令 |
-|------|------|
-| 查看状态 | `kdocs-cli auth status` |
-| 退出登录 | `kdocs-cli auth logout` |
-
-## 浏览器授权流程
-
-`kdocs-cli auth login` 只生成本次 `auth_code` 并打开授权引导页，WPS 登录地址由引导页生成。用户在引导页点击“取消”后，服务端会结束本次授权，CLI 在下一次轮询收到 `409` 后立即退出；如需继续授权，请重新执行 `kdocs-cli auth login`。
-
-## 企业账号受控
-
-本 Skill 及配套的 `kdocs-cli` 仅支持 **WPS 个人账号**。出现以下情况时，按企业账号受控处理：
-
-- 浏览器中登录了 WPS 企业账号，且 `kdocs-cli auth login` 持续等待或最终失败
-- 授权或工具调用返回 `403` / 授权被拒绝、`403001` / 企业账户限制
-
-此时立即停止重试，先退出浏览器中的 WPS 企业账号并切换到个人账号，再运行 `kdocs-cli auth login`。不要在同一企业账号登录状态下反复授权。WPS 企业账号用户请使用 [WPS365 CLI](https://github.com/wps365-open/cli)。
-
-## 手动获取 Token（login 失败时的兜底方案）
-
-当 `kdocs-cli auth login` 因环境问题执行失败时，引导用户手动获取：
-
-1. 用户在浏览器访问 https://www.kdocs.cn/latest（需已登录 WPS 个人账号）
-2. 点击页面右上角个人头像旁的主菜单 → 选择「金山文档Skill」入口 → 复制 Token
-3. 用户将 Token 提供给 Agent
-4. Agent 保存到密钥链：`kdocs-cli auth set-token "<TOKEN>"`

package/data/experts/marketing/kdocs-ppt-creator/skills/ppt-gen/references/file-locating-guide.md

@@ -1,34 +0,0 @@
-# 获取文件标识指南
-
-多数工具可用 `url` / `link_id` / `file_id` 三选一定位。例外：`rename_file` 以及上传/移动等仍仅 `file_id`（或 `file_ids`）；部分工具另需 `drive_id`。按意图选择：
-
-`create_file_with_content` / `create_empty_file` / `upload_new_file` 中 `drive_id`、`parent_id` 的传参规则：
-- 可省略：用户未说明目标文件夹。
-- 必须传入：用户已说明目标文件夹且已定位到对应 `drive_id`、`parent_id`；能传却省略视为错误。
-
-`download_file` / `rename_file` / `share_file` / `cancel_share` / `copy_file` 的 **`drive_id` 非必填**：**已有明确的 drive_id 则传**，**没有则省略**。
-
-| 用户提供 | 定位方式 |
-|---------|--------|
-| 浏览我的云文档根目录 | `drive.list_my_files` |
-| 浏览指定文件夹（有 `drive_id` + `parent_id`） | `drive.list_files` |
-| 文件名/关键词 | `search_files` → 结果含 `file_id`、`drive_id` |
-| 文档链接 | `read_file(url=链接)` 返回内容与 `file_id`/`drive_id`；不需读内容时用 `get_share_info(link_id)`（见下方链接解析） |
-| 已知 `file_id` | 场景工具直接传 `file_id`；补 `drive_id` 时用 `get_file_info(file_id)` |
-| 需确认文档类型/后缀 | `get_file_info`（有链接可传 `url`）→ 从 `name` 取后缀 |
-| 创建文件（指定文件夹） | `search_files` 等查到目标文件夹 → 传 `drive_id` + 该文件夹 `file_id` 作为 `parent_id` |
-| 创建文件（用户未指定文件夹） | `drive_id`、`parent_id` 可不填，直接 `create_file_with_content` / `create_empty_file` / `upload_new_file` |
-
-浏览类工具参数与示例见 [`drive/read_and_download.md`](drive/read_and_download.md)；`drive.list_files` 的 `drive_id`/`parent_id` 接续规则见该文件 list_files 工具卡。
-
-> 根目录的 `parent_id` 固定为 `"0"`。
-
-#### 文档链接解析
-
-当链接域名为 `365.kdocs.cn` 或 `www.kdocs.cn` 时，按路径格式提取末尾的 `link_id`：
-| 路径格式 | 提取规则 |
-|---------|---------|
-| `/l/<link_id>` | 文件分享链接 |
-| `/folder/<link_id>` | 文件夹分享链接 |
-| `/view/l/<link_id>` | 文件预览链接 |
-提取后调用 `get_share_info(link_id)` 获取 `file_id` 和 `drive_id`。

package/data/experts/marketing/kdocs-ppt-creator/skills/ppt-gen/references/wpp/doc_master.md

@@ -1,83 +0,0 @@
-# 母版
-
-## 1. wpp.read_master
-
-#### 功能说明
-
-可用 action：
-- masters_properties_query：查询母版：背景/版式/形状/主题/尺寸/配色等，body.master_type 指定 SLIDE_MASTER/NOTES_MASTER/HANDOUT_MASTER
-
-**幂等性**：是
-
-> 推荐传 `body` 对象承载完整请求体；未传时从顶层参数组装
-
-#### 调用示例
-
-示例调用：
-
-```json
-{
-  "file_id": "38b17a1f6216a9fe412583a400fb35dd",
-  "action": "masters_properties_query"
-}
-```
-
-#### 参数说明
-
-- `url` (string, 三选一必填: `url` / `link_id` / `file_id`): 文档 URL；与 link_id、file_id 三选一
-- `link_id` (string, 三选一必填: `url` / `link_id` / `file_id`): 分享 id；与 url、file_id 三选一
-- `file_id` (string, 三选一必填: `url` / `link_id` / `file_id`): 文件 id；与 url、link_id 三选一
-- `action` (string, 必填): 查询操作
-- `master_type` (string, 可选): 母版类型：SLIDE_MASTER、NOTES_MASTER、HANDOUT_MASTER
-- `fields` (array, 可选): 属性字段列表，如 BACKGROUND/CUSTOM_LAYOUTS/SHAPES/THEME/SIZE/NAME/COLOR_SCHEME
-- `body` (object, 可选): 完整请求体，优先使用
-
-#### 返回值说明
-
-```json
-{"code": 0, "message": "成功", "data": {}}
-
-```
-
-
----
-
-## 2. wpp.write_master
-
-#### 功能说明
-
-可用 action：
-- masters_properties_update：更新母版名称等
-- update_delete：删除母版相关属性
-
-**幂等性**：否 — 写操作非幂等，重试前请确认当前文档状态
-
-> 推荐传 `body` 对象承载完整请求体；未传时从顶层参数组装
-
-#### 调用示例
-
-示例调用：
-
-```json
-{
-  "file_id": "38b17a1f6216a9fe412583a400fb35dd",
-  "action": "masters_properties_update"
-}
-```
-
-#### 参数说明
-
-- `url` (string, 三选一必填: `url` / `link_id` / `file_id`): 文档 URL；与 link_id、file_id 三选一
-- `link_id` (string, 三选一必填: `url` / `link_id` / `file_id`): 分享 id；与 url、file_id 三选一
-- `file_id` (string, 三选一必填: `url` / `link_id` / `file_id`): 文件 id；与 url、link_id 三选一
-- `action` (string, 必填): 写操作
-- `master_type` (string, 可选): 母版类型：SLIDE_MASTER、NOTES_MASTER、HANDOUT_MASTER
-- `name` (string, 可选): 母版名称
-- `body` (object, 可选): 完整请求体，优先使用
-
-#### 返回值说明
-
-```json
-{"code": 0, "message": "成功", "data": {}}
-
-```

package/data/experts/marketing/kdocs-ppt-creator/skills/ppt-gen/references/wpp/doc_presentation.md

@@ -1,85 +0,0 @@
-# 演示文稿属性
-
-## 1. wpp.read_presentation
-
-#### 功能说明
-
-可用 action：
-- presentations_properties_query：查询属性：页面设置/字体/设计/只读状态等
-- presentations_tags_query：查询演示文稿级标签
-
-**幂等性**：是
-
-> 推荐传 `body` 对象承载完整请求体；未传时从顶层参数组装
-
-#### 调用示例
-
-示例调用：
-
-```json
-{
-  "file_id": "38b17a1f6216a9fe412583a400fb35dd",
-  "action": "presentations_properties_query"
-}
-```
-
-#### 参数说明
-
-- `url` (string, 三选一必填: `url` / `link_id` / `file_id`): 文档 URL；与 link_id、file_id 三选一
-- `link_id` (string, 三选一必填: `url` / `link_id` / `file_id`): 分享 id；与 url、file_id 三选一
-- `file_id` (string, 三选一必填: `url` / `link_id` / `file_id`): 文件 id；与 url、link_id 三选一
-- `action` (string, 必填): 查询操作
-- `fields` (array, 可选): 属性字段列表，如 PAGE_SETUP/FONTS/DESIGNS/READ_ONLY
-- `name` (string, 可选): 标签名，按名查询时传入
-- `body` (object, 可选): 完整请求体，优先使用
-
-#### 返回值说明
-
-```json
-{"code": 0, "message": "成功", "data": {}}
-
-```
-
-
----
-
-## 2. wpp.write_presentation
-
-#### 功能说明
-
-可用 action：
-- presentations_properties_update：更新属性，如 display_comments 或关闭文档 CLOSE
-- presentations_tags_update：更新标签，body.action 为 ADD 或 DELETE
-
-**幂等性**：否 — 写操作非幂等，重试前请确认当前文档状态
-
-> 推荐传 `body` 对象承载完整请求体；未传时从顶层参数组装
-
-#### 调用示例
-
-示例调用：
-
-```json
-{
-  "file_id": "38b17a1f6216a9fe412583a400fb35dd",
-  "action": "presentations_properties_update"
-}
-```
-
-#### 参数说明
-
-- `url` (string, 三选一必填: `url` / `link_id` / `file_id`): 文档 URL；与 link_id、file_id 三选一
-- `link_id` (string, 三选一必填: `url` / `link_id` / `file_id`): 分享 id；与 url、file_id 三选一
-- `file_id` (string, 三选一必填: `url` / `link_id` / `file_id`): 文件 id；与 url、link_id 三选一
-- `action` (string, 必填): 写操作
-- `display_comments` (boolean, 可选): 是否显示批注（presentations_properties_update）
-- `name` (string, 可选): 标签名
-- `value` (string, 可选): 标签值（ADD 时）
-- `body` (object, 可选): 完整请求体，优先使用
-
-#### 返回值说明
-
-```json
-{"code": 0, "message": "成功", "data": {}}
-
-```

package/data/experts/marketing/kdocs-ppt-creator/skills/ppt-gen/references/wpp/doc_shape.md

@@ -1,118 +0,0 @@
-# 形状
-
-## 1. wpp.read_shape
-
-#### 功能说明
-
-可用 action：
-- query_list：形状列表
-- query_detail：单个形状详情
-- shapes_texts_query：查询形状内文本与字体
-- shapes_tags_query：查询形状标签
-
-**幂等性**：是
-
-> 推荐传 `body` 对象承载完整请求体；未传时从顶层参数组装
-
-#### 调用示例
-
-示例调用：
-
-```json
-{
-  "file_id": "38b17a1f6216a9fe412583a400fb35dd",
-  "action": "query_list"
-}
-```
-
-#### 参数说明
-
-- `url` (string, 三选一必填: `url` / `link_id` / `file_id`): 文档 URL；与 link_id、file_id 三选一
-- `link_id` (string, 三选一必填: `url` / `link_id` / `file_id`): 分享 id；与 url、file_id 三选一
-- `file_id` (string, 三选一必填: `url` / `link_id` / `file_id`): 文件 id；与 url、link_id 三选一
-- `action` (string, 必填): 查询操作
-- `slide_id` (number, 必填): 幻灯片 ID
-- `shape_id` (number, 可选): 形状 ID，query_detail/texts/tags 时必填
-- `name` (string, 可选): 标签名，shapes_tags_query 按名查询时传入
-- `body` (object, 可选): 完整请求体，优先使用
-
-#### 返回值说明
-
-```json
-{"code": 0, "message": "成功", "data": {}}
-
-```
-
-
----
-
-## 2. wpp.write_shape
-
-#### 功能说明
-
-可用 action：
-- insert_textbox：插入文本框
-- insert_table：插入表格
-- insert_line：插入线条
-- insert_picture：插入图片形状（需公网可访问的图片 URL）
-- update_attr：更新位置/尺寸
-- update_fill：更新填充
-- update_line：更新线条样式
-- update_group：组合形状
-- shapes_texts_update：更新形状文本
-- shapes_tags_update：更新形状标签，body.action 为 ADD 或 DELETE
-- shapes_items_delete：删除形状
-
-**幂等性**：否 — 写操作非幂等，重试前请确认当前文档状态
-
-> 推荐传 `body` 对象承载完整请求体；未传时从顶层参数组装
-> insert_picture 需 image_url 为公网可访问的图片 URL；action 选定后由服务自动补全图片形状所需字段
-
-#### 调用示例
-
-更新形状位置：
-
-```json
-{
-  "file_id": "38b17a1f6216a9fe412583a400fb35dd",
-  "action": "update_attr"
-}
-```
-
-插入图片：
-
-```json
-{
-  "file_id": "38b17a1f6216a9fe412583a400fb35dd",
-  "action": "insert_picture",
-  "slide_id": 1,
-  "image_url": "https://example.com/picture.png",
-  "left": 100,
-  "top": 100,
-  "width": 200,
-  "height": 150
-}
-```
-
-#### 参数说明
-
-- `url` (string, 三选一必填: `url` / `link_id` / `file_id`): 文档 URL；与 link_id、file_id 三选一
-- `link_id` (string, 三选一必填: `url` / `link_id` / `file_id`): 分享 id；与 url、file_id 三选一
-- `file_id` (string, 三选一必填: `url` / `link_id` / `file_id`): 文件 id；与 url、link_id 三选一
-- `action` (string, 必填): 写操作
-- `slide_id` (number, 必填): 幻灯片 ID
-- `shape_id` (number, 可选): 形状 ID，更新/删除时必填
-- `left` (number, 可选): 左边距
-- `top` (number, 可选): 上边距
-- `width` (number, 可选): 宽度
-- `height` (number, 可选): 高度
-- `text` (string, 可选): 形状文本（shapes_texts_update）
-- `image_url` (string, 可选): 图片 URL（insert_picture 时必填，须公网可访问）
-- `body` (object, 可选): 完整请求体，优先使用
-
-#### 返回值说明
-
-```json
-{"code": 0, "message": "成功", "data": {}}
-
-```