dsh-plugin-t-expert 0.4.26 → 0.4.36

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

@@ -0,0 +1,118 @@
+# 形状
+
+## 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": {}}
+
+```

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

@@ -0,0 +1,94 @@
+# 幻灯片
+
+## 1. wpp.read_slide
+
+#### 功能说明
+
+可用 action：
+- query_count：幻灯片总数
+- query_detail：单张幻灯片详情
+- query_list：幻灯片列表
+- slides_notes_query：查询幻灯片备注
+- slides_tags_query：查询幻灯片标签
+
+**幂等性**：是
+
+> 推荐传 `body` 对象承载完整请求体；未传时从顶层参数组装
+
+#### 调用示例
+
+示例调用：
+
+```json
+{
+  "file_id": "38b17a1f6216a9fe412583a400fb35dd",
+  "action": "query_count"
+}
+```
+
+#### 参数说明
+
+- `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，query_detail/notes/tags 时必填
+- `name` (string, 可选): 标签名，slides_tags_query 按名查询时传入
+- `body` (object, 可选): 完整请求体，优先使用
+
+#### 返回值说明
+
+```json
+{"code": 0, "message": "成功", "data": {}}
+
+```
+
+
+---
+
+## 2. wpp.write_slide
+
+#### 功能说明
+
+可用 action：
+- slides_items_insert：插入空白幻灯片
+- slides_items_delete：删除幻灯片
+- update_move：移动幻灯片位置
+- update_duplicate：复制幻灯片
+- slides_tags_update：更新幻灯片标签，body.action 为 ADD 或 DELETE
+
+**幂等性**：否 — 写操作非幂等，重试前请确认当前文档状态
+
+> 推荐传 `body` 对象承载完整请求体；未传时从顶层参数组装
+
+#### 调用示例
+
+示例调用：
+
+```json
+{
+  "file_id": "38b17a1f6216a9fe412583a400fb35dd",
+  "action": "update_move"
+}
+```
+
+#### 参数说明
+
+- `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
+- `index` (number, 可选): 插入位置索引（slides_items_insert）
+- `layout` (number, 可选): 版式索引（slides_items_insert）
+- `to_position` (number, 可选): 目标位置（update_move）
+- `name` (string, 可选): 标签名（slides_tags_update）
+- `value` (string, 可选): 标签值（slides_tags_update ADD 时）
+- `body` (object, 可选): 完整请求体，优先使用
+
+#### 返回值说明
+
+```json
+{"code": 0, "message": "成功", "data": {}}
+
+```

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

@@ -0,0 +1,178 @@
+# 下载与导出
+
+## 1. wpp.export_image
+
+#### 功能说明
+
+将幻灯片导出为 **PNG** 或 **JPEG** 图片（同步接口，直接返回下载地址或 key）。
+
+**适用于**：缩略图、逐页图片导出。
+
+**幂等性**：否 — 导出为异步任务，用 task_id 轮询结果而非重复提交
+
+#### 调用示例
+
+逐页、96 dpi、PNG、含水印：
+
+```json
+{
+  "link_id": "string",
+  "format": "png",
+  "dpi": 96,
+  "water_mark": true,
+  "from_page": 1,
+  "to_page": 100,
+  "combine_long_pic": false,
+  "use_xva": true,
+  "client_id": "",
+  "password": "",
+  "store_type": ""
+}
+```
+
+#### 参数说明
+
+- `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 三选一
+- `format` (string, 必填): 导出图片格式。可选值：`png` / `jpeg`
+- `dpi` (integer, 可选): 图片 DPI。可选值：`96` / `150` / `300`；默认值：`96`
+- `water_mark` (boolean, 可选): 是否含水印；默认值：`true`
+- `from_page` (integer, 可选): 起始页，从 0 开始；默认值：`1`
+- `to_page` (integer, 可选): 结束页；默认值：`9999`
+- `combine_long_pic` (boolean, 可选): 是否合并为长图；`false` 表示逐页
+- `use_xva` (boolean, 可选): 是否使用 XVA 渲染引擎
+- `client_id` (string, 可选): 客户端标识
+- `password` (string, 可选): 文档打开密码（若加密）
+- `store_type` (string, 可选): 存储类型，如 `ks3`、`cloud`
+
+#### 返回值说明
+
+```json
+{
+  "result": "ok",
+  "url": "string",
+  "key": "string",
+  "file_id": "string",
+  "without_attachment": false,
+  "size": 0
+}
+
+```
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `result` | string | 成功为 `ok` |
+| `url` | string | 图片下载地址（有时效） |
+| `key` | string | 导出文件标识 |
+| `file_id` | string | 关联文件 ID |
+| `size` | integer | 仅当请求要求返回大小时可能存在 |
+
+失败时可能返回 `result` 为 `error` 且带 `data.code` / `data.message`，以实际响应为准。
+
+
+---
+
+## 2. wpp.export_pdf
+
+#### 功能说明
+
+异步导出 PDF **步骤一**：**创建导出任务**（`POST .../async-export`），返回 `task_id`。本工具传入 `task_id` 时会调用查询接口进行轮询。
+
+**适用于**：需要可打印、可分享的 PDF 文件。
+
+**步骤二**：传入 `task_id` 查询导出进度，`status` 为 `running` 时需等待后重试，`finished` 时返回下载链接。
+
+**幂等性**：否 — 导出为异步任务，用 task_id 轮询结果而非重复提交
+
+#### 调用示例
+
+步骤一：创建导出任务：
+
+```json
+{
+  "file_id": "string",
+  "format": "pdf",
+  "multipage": 1,
+  "opt_frame": true,
+  "from_page": 1,
+  "to_page": 9999,
+  "client_id": "",
+  "store_type": "ks3",
+  "password": "",
+  "export_open_password": "",
+  "export_modify_password": ""
+}
+```
+
+步骤二：查询导出进度：
+
+```json
+{
+  "task_id": "string",
+  "task_type": "normal_export"
+}
+```
+
+#### 参数说明
+
+- `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 三选一
+- `format` (string, 必填): 固定 `pdf`
+- `task_id` (string, 可选): 任务 ID，步骤一返回，轮询时必填
+- `task_type` (string, 可选): 任务类型，固定 `normal_export`（轮询时必填）
+- `multipage` (integer, 可选): 是否多页合一类导出；`1` 表示是
+- `opt_frame` (boolean, 可选): 是否优化帧；默认值：`true`
+- `from_page` (integer, 可选): 起始页，从 0 开始；默认值：`1`
+- `to_page` (integer, 可选): 结束页；默认值：`9999`
+- `client_id` (string, 可选): 客户端标识
+- `store_type` (string, 可选): 存储类型，如 `ks3`、`cloud`
+- `password` (string, 可选): 源文件密码
+- `export_open_password` (string, 可选): 导出 PDF 打开密码
+- `export_modify_password` (string, 可选): 导出 PDF 修改密码
+
+#### 返回值说明
+
+```json
+步骤一返回：
+
+```json
+{
+  "task_id": "string",
+  "task_type": "normal_export"
+}
+```
+
+步骤二返回（进行中）：
+
+```json
+{
+  "status": "running",
+  "data": null
+}
+```
+
+步骤二返回（已完成）：
+
+```json
+{
+  "status": "finished",
+  "data": {
+    "file_id": "string",
+    "key": "string",
+    "result": "ok",
+    "url": "string",
+    "without_attachment": false
+  }
+}
+```
+
+```
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `task_id` | string | 异步任务 ID，后续查询必填 |
+| `task_type` | string | 固定为 `normal_export`（导出 PDF 场景） |
+| `status` | string | `running` / `finished` |
+| `data.url` | string | PDF 下载地址（`finished` 时，有时效） |

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

@@ -0,0 +1,131 @@
+# 插入形状
+
+所有形状插入命令共享相同的基础参数（`slideIndex`、`left`、`top`、`width`、`height`），区别在于形状类型不同。
+
+## 通用参数说明
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `slideIndex` | integer | 是 | 目标幻灯片序号，从 1 开始 |
+| `left` | number | 是 | 形状左上角 X 坐标（单位：磅） |
+| `top` | number | 是 | 形状左上角 Y 坐标（单位：磅） |
+| `width` | number | 是 | 形状宽度（单位：磅） |
+| `height` | number | 是 | 形状高度（单位：磅） |
+
+---
+
+## 插入矩形
+
+- **命令名**：`addRectangle`
+- **用途**：在指定幻灯片的指定位置插入一个矩形
+
+### 调用示例
+
+```json
+{
+  "file_id": "file_xxx",
+  "command": "addRectangle",
+  "param": {
+    "slideIndex": 1,
+    "left": 100,
+    "top": 100,
+    "width": 200,
+    "height": 200
+  }
+}
+```
+
+---
+
+## 插入圆形
+
+- **命令名**：`addOval`
+- **用途**：在指定幻灯片的指定位置插入一个椭圆
+
+### 调用示例
+
+```json
+{
+  "file_id": "file_xxx",
+  "command": "addOval",
+  "param": {
+    "slideIndex": 1,
+    "left": 200,
+    "top": 200,
+    "width": 150,
+    "height": 150
+  }
+}
+```
+
+---
+
+## 插入三角形
+
+- **命令名**：`addTriangle`
+- **用途**：在指定幻灯片的指定位置插入一个等腰三角形
+
+### 调用示例
+
+```json
+{
+  "file_id": "file_xxx",
+  "command": "addTriangle",
+  "param": {
+    "slideIndex": 1,
+    "left": 50,
+    "top": 50,
+    "width": 200,
+    "height": 180
+  }
+}
+```
+
+---
+
+## 插入圆角矩形
+
+- **命令名**：`addRoundedRectangle`
+- **用途**：在指定幻灯片的指定位置插入一个圆角矩形
+
+### 调用示例
+
+```json
+{
+  "file_id": "file_xxx",
+  "command": "addRoundedRectangle",
+  "param": {
+    "slideIndex": 1,
+    "left": 100,
+    "top": 300,
+    "width": 250,
+    "height": 100
+  }
+}
+```
+
+---
+
+## 通用形状类型枚举
+
+`AddShape` 通用签名：`Shapes.AddShape(shapeType, left, top, width, height)`
+
+更换 `shapeType` 即可插入不同类型的形状：
+
+| 常量名 | 说明 |
+|--------|------|
+| `msoShapeRectangle` | 矩形 |
+| `msoShapeOval` | 椭圆/圆形 |
+| `msoShapeIsoscelesTriangle` | 等腰三角形 |
+| `msoShapeRoundedRectangle` | 圆角矩形 |
+| `msoShapeDiamond` | 菱形 |
+| `msoShapeParallelogram` | 平行四边形 |
+| `msoShapeTrapezoid` | 梯形 |
+| `msoShapeHexagon` | 六边形 |
+| `msoShapeOctagon` | 八边形 |
+| `msoShapeCross` | 十字形 |
+| `msoShapeStar5` | 五角星 |
+| `msoShapeRightArrow` | 右箭头 |
+| `msoShapeLeftArrow` | 左箭头 |
+| `msoShapeUpArrow` | 上箭头 |
+| `msoShapeDownArrow` | 下箭头 |

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

@@ -0,0 +1,126 @@
+# 幻灯片操作
+
+## 添加指定版式幻灯片
+
+- **命令名**：`addLayoutSlide`
+- **用途**：在指定位置插入指定版式（文本/仅标题等）的幻灯片
+
+### 参数
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `slideIndex` | integer | 是 | 插入位置，从 1 开始（在第 N 张之前插入） |
+| `layout` | integer | 是 | 版式类型，枚举值见下表 |
+
+#### layout 版式枚举
+
+| 值 | 常量名 | 说明 |
+|----|--------|------|
+| 1 | `ppLayoutTitle` | 标题幻灯片 |
+| 2 | `ppLayoutText` | 标题和文本 |
+| 3 | `ppLayoutTwoColumnText` | 标题和两栏文本 |
+| 4 | `ppLayoutTable` | 标题和表格 |
+| 5 | `ppLayoutTextAndChart` | 标题、文本和图表 |
+| 6 | `ppLayoutChartAndText` | 标题、图表和文本 |
+| 7 | `ppLayoutOrgchart` | 标题和组织结构图 |
+| 8 | `ppLayoutChart` | 标题和图表 |
+| 9 | `ppLayoutTextAndClipart` | 标题、文本和剪贴画 |
+| 10 | `ppLayoutClipartAndText` | 标题、剪贴画和文本 |
+| 11 | `ppLayoutTitleOnly` | 仅标题 |
+| 12 | `ppLayoutBlank` | 空白 |
+
+### 调用示例
+
+```json
+{
+  "file_id": "file_xxx",
+  "command": "addLayoutSlide",
+  "param": {
+    "slideIndex": 2,
+    "layout": 2
+  }
+}
+```
+
+---
+
+## 删除幻灯片
+
+- **命令名**：`deleteSlide`
+- **用途**：删除指定位置的幻灯片
+
+### 参数
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `slideIndex` | integer | 是 | 要删除的幻灯片序号，从 1 开始 |
+
+### 调用示例
+
+```json
+{
+  "file_id": "file_xxx",
+  "command": "deleteSlide",
+  "param": {
+    "slideIndex": 2
+  }
+}
+```
+
+---
+
+## 复制粘贴幻灯片
+
+- **命令名**：`copyPasteSlide`
+- **用途**：复制指定幻灯片并粘贴到指定位置（未指定则粘贴到末尾）
+
+### 参数
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `slideIndex` | integer | 是 | 要复制的幻灯片序号，从 1 开始 |
+| `pasteIndex` | integer | 否 | 粘贴目标位置，从 1 开始（在第 N 张之前粘贴）。不传则粘贴到末尾 |
+
+### 调用示例
+
+```json
+{
+  "file_id": "file_xxx",
+  "command": "copyPasteSlide",
+  "param": {
+    "slideIndex": 1,
+    "pasteIndex": 3
+  }
+}
+```
+
+---
+
+## 获取幻灯片数量
+
+- **命令名**：`getSlidesCount`
+- **用途**：获取演示文稿中幻灯片的总数
+
+### 参数
+
+无需参数。
+
+### 返回值
+
+`data` 为数字类型，表示幻灯片总数。
+
+### 调用示例
+
+```json
+{
+  "file_id": "file_xxx",
+  "command": "getSlidesCount",
+  "param": {}
+}
+```
+
+返回示例：
+
+```json
+{"ok": true, "message": "success", "data": 5}
+```