dsh-plugin-t-expert 0.4.48 → 0.4.53

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

@@ -1,94 +0,0 @@
-# 幻灯片
-
-## 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

@@ -1,178 +0,0 @@
-# 下载与导出
-
-## 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

@@ -1,131 +0,0 @@
-# 插入形状
-
-所有形状插入命令共享相同的基础参数（`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

@@ -1,126 +0,0 @@
-# 幻灯片操作
-
-## 添加指定版式幻灯片
-
-- **命令名**：`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}
-```

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

@@ -1,139 +0,0 @@
-# 演示文稿与页面
-
-## 1. wpp.insert_slide
-
-#### 功能说明
-
-在**已有**在线演示文稿中插入一页空白幻灯片。
-
-**适用于**：已存在、可编辑的 WPP 演示（`file_id` 对应在线演示文档）。
-
-**幂等性**：否 — 重复调用会插入多页幻灯片，先确认是否已成功
-
-#### 调用示例
-
-在第 1 页后插入空白页：
-
-```json
-{
-  "file_id": "string",
-  "slide_idx": 1,
-  "layout_id": 134217788
-}
-```
-
-#### 参数说明
-
-- `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 三选一
-- `slide_idx` (integer, 必填): 插入位置的幻灯片序号，**从 0 开始**
-- `layout_id` (integer, 可选): 指定模板版式 ID，从对应版式新建幻灯片（如结束页、标题页、内容页等）。版式 ID 与演示文稿模板中定义的版式一一对应，不同模板的可用 ID 不同
-
-#### 返回值说明
-
-```json
-{
-  "result": "ok",
-  "detail": {
-    "res": [
-      {
-        "cmdName": "slideInsert",
-        "code": 0,
-        "errName": "S_OK",
-        "msg": "execute result",
-        "token": "string"
-      }
-    ]
-  }
-}
-
-```
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `result` | string | 请求成功为 `ok` |
-| `detail.res[].cmdName` | string | 命令名，如 `slideInsert` |
-| `detail.res[].code` | integer | `0` 表示该条执行成功 |
-| `detail.res[].errName` | string | 如 `S_OK` |
-| `detail.res[].token` | string | 可选，会话/追踪用 |
-
-
----
-
-## 2. wpp.import_slides
-
-#### 功能说明
-
-从外部 PPTX 文件（通过 URL 获取）中选取指定幻灯片，导入到已有在线演示文稿的指定位置。
-
-**适用于**：将其他 PPTX 文件中的页面合并到已有在线演示文档中。
-
-**幂等性**：否 — 重复调用会再次导入同一组页面，重试前先确认目标文稿中是否已导入成功
-
-> object_url 域名需在服务端白名单内，否则返回 `validate_object_url` 错误
-
-#### 调用示例
-
-导入源 PPTX 第 1 页到目标文稿第 1 页位置：
-
-```json
-{
-  "link_id": "cupf4t47i6Fx",
-  "object_url": "https://example.com/slides/demo.pptx",
-  "slide_idx": 0,
-  "source_idxs": [
-    0
-  ]
-}
-```
-
-导入源 PPTX 第 1、3、5 页到目标文稿第 2 页位置（原第 2 页及之后后移）：
-
-```json
-{
-  "link_id": "cupf4t47i6Fx",
-  "object_url": "https://example.com/slides/demo.pptx",
-  "slide_idx": 1,
-  "source_idxs": [
-    0,
-    2,
-    4
-  ]
-}
-```
-
-#### 参数说明
-
-- `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 三选一
-- `object_url` (string, 必填): 源 PPTX 文件的下载 URL
-- `slide_idx` (integer, 必填): 插入位置，目标文稿中的幻灯片索引，**从 0 开始**。导入的页面占据该索引位置，原位置及之后的页面顺序后移。用户说"插入到第 n 页"时传 n-1。超出范围时自动尾插
-- `source_idxs` (array, 必填): 要导入的源文件幻灯片索引数组，**从 0 开始**
-
-#### 返回值说明
-
-```json
-{
-  "result": "ok",
-  "detail": {
-    "res": [
-      {
-        "cmdName": "docTemplate",
-        "code": 0,
-        "errName": "S_OK",
-        "msg": "execute result"
-      }
-    ]
-  }
-}
-
-```
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `result` | string | 请求成功为 `ok` |
-| `detail.res[].cmdName` | string | 命令名，如 `docTemplate` |
-| `detail.res[].code` | integer | `0` 表示该条执行成功 |
-| `detail.res[].errName` | string | 如 `S_OK` |