@capyclaw/ppt-skill-editing 0.0.0-stage → 2.2.1

package/contract/ppt-contract.json

@@ -0,0 +1,1529 @@
+{
+  "contractVersion": "2.4.0",
+  "packageVersion": "2.4.2",
+  "toolCount": 27,
+  "tools": [
+    {
+      "name": "ppt_capabilities",
+      "kind": "read",
+      "since": "2.0.0",
+      "capability": "contract",
+      "description": "返回工作台契约版本、工具清单、能力清单、能力标签与编辑器地址。skill 加载后先调用一次；工具缺失或 major 版本不一致时停止并提示升级。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_get_deck",
+      "kind": "read",
+      "since": "1.0.0",
+      "capability": "deck",
+      "description": "读当前演示文稿：标题、每页背景/元素。需要精确定位（页号/元素 id）时调用；改背景/加页/改首个文本不要先读。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "detailed": {
+            "type": "boolean",
+            "description": "元素几何/颜色等细节（缺省只给摘要）"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_audit",
+      "kind": "read",
+      "since": "2.1.0",
+      "capability": "audit",
+      "description": "确定性审计当前 deck：文字越界/溢出/重叠、同文案重复、文字隐形/被遮挡、有效背景对比度、重复版式、配色漂移、重复图片、页面密度。返回 pass/blocking；交付前或截图前调用，pass=false 不得说审计通过。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_task",
+      "kind": "read",
+      "since": "2.2.0",
+      "capability": "task",
+      "description": "任务恢复：status 查当前进度/待处理批次/最近 checkpoint；list 列 checkpoint；checkpoint 保存命名快照；restore 恢复快照。长任务每阶段保存一次。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "type": "string",
+            "enum": [
+              "status",
+              "list",
+              "checkpoint",
+              "restore"
+            ]
+          },
+          "name": {
+            "type": "string",
+            "maxLength": 64,
+            "description": "checkpoint 名称（字母/数字/._-）"
+          },
+          "meta": {
+            "type": "object",
+            "description": "checkpoint 附带的 goal/plan/next 等元数据"
+          }
+        },
+        "required": [
+          "action"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_text",
+      "kind": "write",
+      "since": "1.0.0",
+      "capability": "text",
+      "description": "改文字：某页或某几页（缺省全部页）的首个文本，或指定 element_id 的文本；可同时改字号/颜色/加粗/对齐。首个文本优先取 text 元素，纯图形文字页回退到带文字的 shape。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "text": {
+            "type": "string",
+            "maxLength": 2000
+          },
+          "slide": {
+            "type": "integer",
+            "description": "0 起页号"
+          },
+          "slides": {
+            "type": "array",
+            "maxItems": 100,
+            "items": {
+              "type": "integer"
+            },
+            "description": "0 起页号数组（缺省=全部）"
+          },
+          "element_id": {
+            "type": "string",
+            "description": "元素 id（缺省=首个文本）"
+          },
+          "font_size": {
+            "type": "integer"
+          },
+          "color": {
+            "type": "string",
+            "description": "CSS 颜色或中文色名"
+          },
+          "bold": {
+            "type": "boolean"
+          },
+          "align": {
+            "type": "string",
+            "enum": [
+              "left",
+              "center",
+              "right",
+              "justify"
+            ]
+          }
+        },
+        "required": [
+          "text"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_fill",
+      "kind": "write",
+      "since": "1.0.0",
+      "capability": "text",
+      "description": "填充文字槽位：把某页的第 slot 个文字载体（0 起，含带文字的 shape）改成 text，可带字号/颜色/加粗/对齐。保留原版式。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "slide": {
+            "type": "integer",
+            "description": "0 起页号"
+          },
+          "slot": {
+            "type": "integer",
+            "description": "该页第几个文字载体（0 起，含图形内文字）"
+          },
+          "text": {
+            "type": "string"
+          },
+          "font_size": {
+            "type": "integer"
+          },
+          "color": {
+            "type": "string"
+          },
+          "bold": {
+            "type": "boolean"
+          },
+          "align": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "slide",
+          "slot",
+          "text"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_style",
+      "kind": "write",
+      "since": "1.0.0",
+      "capability": "style",
+      "description": "整体样式：背景色（可指定页），文字颜色，字体名，主题色数组。浅底会自动配深字、深底配白字。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "background": {
+            "type": "string",
+            "description": "背景色（CSS 或中文色名）"
+          },
+          "slides": {
+            "type": "array",
+            "items": {
+              "type": "integer"
+            },
+            "description": "只改这些页的背景；缺省全部"
+          },
+          "contrast": {
+            "type": "boolean",
+            "description": "自动对比度，缺省 true"
+          },
+          "text_color": {
+            "type": "string",
+            "description": "全局正文颜色"
+          },
+          "font_name": {
+            "type": "string"
+          },
+          "theme_colors": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "主题色数组"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_element",
+      "kind": "write",
+      "since": "1.0.0",
+      "capability": "element",
+      "description": "元素级编辑：add 加文本/形状/图片，update 改位置/尺寸/旋转/填充/文字样式，remove 删除。插入图片走 ppt_image 的同一实现。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "type": "string",
+            "enum": [
+              "add",
+              "update",
+              "remove"
+            ]
+          },
+          "slide": {
+            "type": "integer",
+            "description": "0 起页号"
+          },
+          "element_id": {
+            "type": "string"
+          },
+          "element": {
+            "type": "object",
+            "description": "add 用：{type:'text'|'shape'|'image', text?/content?, src?(image), fill?, left?, top?, width?, height?, fontSize?, color?}"
+          },
+          "props": {
+            "type": "object",
+            "description": "update 用：{left?,top?,width?,height?,rotate?,opacity?,fill?,src?,text?,fontSize?,color?,bold?,align?}"
+          }
+        },
+        "required": [
+          "action",
+          "slide"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_slide",
+      "kind": "write",
+      "since": "1.0.0",
+      "capability": "slide",
+      "description": "页管理：add（标题+要点）/remove/move/duplicate/select。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "type": "string",
+            "enum": [
+              "add",
+              "remove",
+              "move",
+              "duplicate",
+              "select"
+            ]
+          },
+          "index": {
+            "type": "integer",
+            "description": "目标页号（0 起）；add 时为插入位置，缺省末尾"
+          },
+          "to": {
+            "type": "integer",
+            "description": "move 的目标位置"
+          },
+          "title": {
+            "type": "string",
+            "maxLength": 40,
+            "description": "add 的标题"
+          },
+          "bullets": {
+            "type": "array",
+            "maxItems": 8,
+            "items": {
+              "type": "string",
+              "maxLength": 80
+            }
+          },
+          "background": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "action"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_apply",
+      "kind": "write",
+      "since": "1.0.0",
+      "capability": "apply",
+      "description": "通用逃生口：一次提交任意底层指令数组（load / update-slide / add-element / set-background / theme / …），复杂组合动作用。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "ops": {
+            "type": "array",
+            "maxItems": 100,
+            "items": {
+              "type": "object"
+            },
+            "description": "底层 op 数组（≤100）"
+          },
+          "title": {
+            "type": "string",
+            "maxLength": 120,
+            "description": "deck 标题（可选）"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_deck",
+      "kind": "write",
+      "since": "1.0.0",
+      "capability": "compose",
+      "description": "从大纲一次成稿：按版式（cover/section/bullets/two/stat/quote/end）+ 设计预设（clean/business/warm/tech）生成整套专业排版 deck，替换当前内容。默认简洁成稿首选（preset: clean）。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "title": {
+            "type": "string",
+            "maxLength": 40
+          },
+          "preset": {
+            "type": "string",
+            "enum": [
+              "clean",
+              "business",
+              "warm",
+              "tech"
+            ]
+          },
+          "slides": {
+            "type": "array",
+            "maxItems": 30,
+            "items": {
+              "type": "object",
+              "properties": {
+                "layout": {
+                  "type": "string",
+                  "enum": [
+                    "cover",
+                    "section",
+                    "bullets",
+                    "two",
+                    "stat",
+                    "quote",
+                    "end"
+                  ]
+                },
+                "title": {
+                  "type": "string",
+                  "maxLength": 40
+                },
+                "subtitle": {
+                  "type": "string",
+                  "maxLength": 80
+                },
+                "kicker": {
+                  "type": "string",
+                  "maxLength": 40
+                },
+                "index": {
+                  "type": "integer"
+                },
+                "bullets": {
+                  "type": "array",
+                  "maxItems": 8
+                },
+                "left": {
+                  "type": "object"
+                },
+                "right": {
+                  "type": "object"
+                },
+                "stats": {
+                  "type": "array",
+                  "maxItems": 4
+                },
+                "quote": {
+                  "type": "string",
+                  "maxLength": 300
+                },
+                "author": {
+                  "type": "string",
+                  "maxLength": 60
+                },
+                "note": {
+                  "type": "string",
+                  "maxLength": 300
+                },
+                "foot": {
+                  "type": "string",
+                  "maxLength": 100
+                }
+              },
+              "required": [
+                "layout"
+              ]
+            }
+          }
+        },
+        "required": [
+          "slides"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_page",
+      "kind": "write",
+      "since": "2.3.0",
+      "capability": "compose",
+      "description": "逐页成稿：一次只追加/替换当前一页（同一套 clean 版式），适合长 deck 分批落盘；首屏用 replace:true，后续逐页追加。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "layout": {
+            "type": "string",
+            "enum": [
+              "cover",
+              "section",
+              "bullets",
+              "two",
+              "stat",
+              "quote",
+              "end"
+            ]
+          },
+          "preset": {
+            "type": "string",
+            "enum": [
+              "clean",
+              "business",
+              "warm",
+              "tech"
+            ]
+          },
+          "deck_title": {
+            "type": "string",
+            "maxLength": 40
+          },
+          "position": {
+            "type": "integer",
+            "description": "插入位置（0 起，缺省末尾）"
+          },
+          "replace": {
+            "type": "boolean",
+            "description": "true 时用这一页替换整个 deck（首屏用）"
+          },
+          "title": {
+            "type": "string",
+            "maxLength": 40
+          },
+          "subtitle": {
+            "type": "string",
+            "maxLength": 80
+          },
+          "kicker": {
+            "type": "string",
+            "maxLength": 40
+          },
+          "section_index": {
+            "type": "integer",
+            "description": "section 版式的章节序号"
+          },
+          "bullets": {
+            "type": "array",
+            "maxItems": 8
+          },
+          "left": {
+            "type": "object"
+          },
+          "right": {
+            "type": "object"
+          },
+          "stats": {
+            "type": "array",
+            "maxItems": 4
+          },
+          "quote": {
+            "type": "string",
+            "maxLength": 300
+          },
+          "author": {
+            "type": "string",
+            "maxLength": 60
+          },
+          "note": {
+            "type": "string",
+            "maxLength": 300
+          },
+          "foot": {
+            "type": "string",
+            "maxLength": 100
+          }
+        },
+        "required": [
+          "layout"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_recolor",
+      "kind": "write",
+      "since": "1.0.0",
+      "capability": "recolor",
+      "description": "一键整体换色（一次调用完成）：背景 + 全部文字对比色 + 装饰形状（线条/圆点/色条）统一色。改整体背景/配色时优先用它，禁止逐页 ppt_element 改色。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "background": {
+            "type": "string",
+            "description": "新背景色（CSS 颜色或中文色名）"
+          },
+          "text": {
+            "type": "string",
+            "description": "文字颜色；缺省按背景自动对比（浅底深字/深底白字）"
+          },
+          "shapes": {
+            "type": "string",
+            "description": "装饰形状填充色；缺省跟随文字色（传 null 表示不改装饰）"
+          },
+          "slides": {
+            "type": "array",
+            "items": {
+              "type": "integer"
+            },
+            "description": "只改这些页；缺省全部"
+          }
+        },
+        "required": [
+          "background"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_image",
+      "kind": "write",
+      "since": "1.0.0",
+      "capability": "image",
+      "description": "插入图片（一次完成，图片先写入对象仓库，deck 只存 /assets/<sha256> 引用）：attachment_id 取聊天图片附件的 sha256 id；也支持 path/src。src 走远程下载时带浏览器头、25s 超时、自动重试一次，上限 6MB。失败会返回 [错误码]：HOST_BLOCKED / HTTP_403 / TIMEOUT / TOO_LARGE 等——永久性失败不要重试同一链接或域名，改换来源或先用本地 path 下载。不要用 shell 找图，不要截图验证。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "slide": {
+            "type": "integer",
+            "description": "0 起页号，缺省 0（封面）"
+          },
+          "attachment_id": {
+            "type": "string",
+            "description": "聊天图片附件的 attachmentId（sha256:…）"
+          },
+          "attachmentId": {
+            "type": "string",
+            "description": "attachment_id 的兼容别名"
+          },
+          "path": {
+            "type": "string",
+            "description": "本机图片路径（兼容旧用法）"
+          },
+          "src": {
+            "type": "string",
+            "description": "http(s) 或 data URL"
+          },
+          "left": {
+            "type": "number"
+          },
+          "top": {
+            "type": "number"
+          },
+          "width": {
+            "type": "number"
+          },
+          "height": {
+            "type": "number"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_images",
+      "kind": "read",
+      "since": "2.3.0",
+      "capability": "imagesearch",
+      "description": "图片搜索：返回已预检可下载的候选直链（不下载正文，整轮 12s 内）。选中后直接用 ppt_image { src: url, slide } 插入；返回的候选基本不会 403/超限，若仍失败说明网络波动，换下一个候选即可。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "string",
+            "maxLength": 120,
+            "description": "中文或英文图片搜索词"
+          },
+          "count": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 12,
+            "description": "需要的候选数量，缺省 6"
+          },
+          "min_width": {
+            "type": "integer",
+            "description": "最小宽度像素，缺省 480"
+          }
+        },
+        "required": [
+          "query"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_screenshot",
+      "kind": "read",
+      "since": "1.0.0",
+      "capability": "screenshot",
+      "description": "取右侧编辑器实时画面（全部页拼图）。确认视觉效果时调用。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_present",
+      "kind": "control",
+      "since": "1.0.0",
+      "capability": "present",
+      "description": "放映控制：start（可指定起始页）/ exit。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "type": "string",
+            "enum": [
+              "start",
+              "exit"
+            ]
+          },
+          "slide": {
+            "type": "integer",
+            "description": "start 的起始页（0 起）"
+          }
+        },
+        "required": [
+          "action"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_history",
+      "kind": "control",
+      "since": "1.0.0",
+      "capability": "history",
+      "description": "撤销/重做。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "type": "string",
+            "enum": [
+              "undo",
+              "redo"
+            ]
+          }
+        },
+        "required": [
+          "action"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_chart",
+      "kind": "write",
+      "since": "2.2.0",
+      "capability": "chart",
+      "description": "插入或更新图表（PPTist 原生 echarts 图表）。给定数据即可生成柱/条/折线/面积/饼/环/雷达/散点图，支持多种数据格式（labels+series、表格 rows、键值对 items）。带 element_id 时为更新已有图表。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "slide": {
+            "type": "integer",
+            "description": "0 起页号，默认 0"
+          },
+          "chart_type": {
+            "type": "string",
+            "enum": [
+              "bar",
+              "column",
+              "line",
+              "area",
+              "pie",
+              "ring",
+              "radar",
+              "scatter"
+            ],
+            "description": "图表类型，新增必填"
+          },
+          "data": {
+            "type": "object",
+            "description": "数据，支持多种格式：{labels:[...], series:[[...]]} / {labels:[...], values:[...]} 单系列 / {headers:[...], rows:[[...]]} 表格式（首列类目，其余列系列） / {items:[[name,value]...]} 饼图式"
+          },
+          "element_id": {
+            "type": "string",
+            "description": "更新模式：要更新的图表元素 id"
+          },
+          "options": {
+            "type": "object",
+            "description": "渲染选项 {lineSmooth?:折线平滑, stack?:堆叠}",
+            "properties": {
+              "lineSmooth": {
+                "type": "boolean"
+              },
+              "stack": {
+                "type": "boolean"
+              }
+            },
+            "additionalProperties": false
+          },
+          "colors": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "系列配色（缺省用幻灯片主题色）"
+          },
+          "text_color": {
+            "type": "string",
+            "description": "图表文字颜色"
+          },
+          "left": {
+            "type": "number"
+          },
+          "top": {
+            "type": "number"
+          },
+          "width": {
+            "type": "number"
+          },
+          "height": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "slide"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_table",
+      "kind": "write",
+      "since": "2.2.0",
+      "capability": "table",
+      "description": "插入或整体更新表格（PPTist 原生表格）。rows 为二维数组，字符串/数字直接作单元格；header: true 时首行渲染为加粗底色表头。带 element_id 时整体替换该表格数据。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "slide": {
+            "type": "integer",
+            "description": "0 起页号，默认 0"
+          },
+          "rows": {
+            "type": "array",
+            "description": "二维数组，如 [[\"区域\",\"目标\"],[\"华东\",70],[\"华南\",66]]；单元格也可用对象 {text, bold, color, backcolor, align, fontsize}",
+            "items": {
+              "type": "array"
+            }
+          },
+          "header": {
+            "type": "boolean",
+            "description": "首行作为表头（加粗 + 主题色浅底）"
+          },
+          "theme_color": {
+            "type": "string",
+            "description": "表格主题色（表头底色由此淡化生成），默认 #5b9bd5"
+          },
+          "element_id": {
+            "type": "string",
+            "description": "更新模式：整体替换该表格的数据/列宽"
+          },
+          "col_widths": {
+            "type": "array",
+            "items": {
+              "type": "number"
+            },
+            "description": "列宽比例或像素（自动归一）"
+          },
+          "cell_min_height": {
+            "type": "number",
+            "description": "单元格最小高度，默认 36"
+          },
+          "left": {
+            "type": "number"
+          },
+          "top": {
+            "type": "number"
+          },
+          "width": {
+            "type": "number"
+          },
+          "height": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "slide",
+          "rows"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_table_cells",
+      "kind": "write",
+      "since": "2.2.0",
+      "capability": "table",
+      "description": "精修已有表格的单元格：改文字 / 加粗 / 颜色 / 底色 / 对齐 / 字号，也可换表格主题色。行号列号从 0 起，元素 id 可用 ppt_get_deck 查询。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "slide": {
+            "type": "integer",
+            "description": "0 起页号，默认 0"
+          },
+          "element_id": {
+            "type": "string",
+            "description": "表格元素 id"
+          },
+          "cells": {
+            "type": "array",
+            "description": "单元格补丁列表",
+            "items": {
+              "type": "object",
+              "properties": {
+                "row": {
+                  "type": "integer",
+                  "description": "0 起行号"
+                },
+                "col": {
+                  "type": "integer",
+                  "description": "0 起列号"
+                },
+                "text": {
+                  "type": "string"
+                },
+                "bold": {
+                  "type": "boolean"
+                },
+                "color": {
+                  "type": "string",
+                  "description": "文字颜色"
+                },
+                "backcolor": {
+                  "type": "string",
+                  "description": "单元格底色"
+                },
+                "align": {
+                  "type": "string",
+                  "enum": [
+                    "left",
+                    "center",
+                    "right"
+                  ]
+                },
+                "fontsize": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "row",
+                "col"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "theme_color": {
+            "type": "string",
+            "description": "顺带更换表格主题色"
+          }
+        },
+        "required": [
+          "slide",
+          "element_id",
+          "cells"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_notes",
+      "kind": "write",
+      "since": "2.2.0",
+      "capability": "notes",
+      "description": "设置指定页的演讲者备注（显示在编辑器备注面板，导出 PPTX 一并保留）。传空字符串清空。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "slide": {
+            "type": "integer",
+            "description": "0 起页号"
+          },
+          "notes": {
+            "type": "string",
+            "maxLength": 2000,
+            "description": "备注内容；空字符串清空"
+          }
+        },
+        "required": [
+          "slide",
+          "notes"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_shape",
+      "kind": "write",
+      "since": "2.2.0",
+      "capability": "shape",
+      "description": "插入形状。shape 从内置库选（rect / round-rect / circle / triangle / triangle-down / diamond / pentagon / hexagon / star-5 / arrow-right / arrow-left / arrow-up / arrow-down / double-arrow / bubble / heart / cloud / bolt / cross / pie-quarter / cylinder / round-frame），也可传自定义 SVG path + viewBox。装饰、流程节点、强调块都走这里。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "slide": {
+            "type": "integer",
+            "description": "0 起页号，默认 0"
+          },
+          "shape": {
+            "type": "string",
+            "description": "内置形状 key，如 circle / arrow-right / star-5 / round-rect"
+          },
+          "path": {
+            "type": "string",
+            "description": "自定义 SVG path（与 shape 二选一，优先生效）"
+          },
+          "viewBox": {
+            "type": "array",
+            "items": {
+              "type": "number"
+            },
+            "description": "自定义 path 的 viewBox [w, h]，默认 [200, 200]"
+          },
+          "fill": {
+            "type": "string",
+            "description": "填充色，默认 #5b9bd5"
+          },
+          "left": {
+            "type": "number"
+          },
+          "top": {
+            "type": "number"
+          },
+          "width": {
+            "type": "number",
+            "description": "默认 200"
+          },
+          "height": {
+            "type": "number",
+            "description": "默认 200"
+          },
+          "rotate": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "slide"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_line",
+      "kind": "write",
+      "since": "2.2.0",
+      "capability": "line",
+      "description": "画一条线（直线 / 虚线 / 折线）。给起点终点画布坐标即可，包围盒自动计算；端点箭头可选 arrow / triangle / dot / square；broken 给拐点画布坐标可画折线。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "slide": {
+            "type": "integer",
+            "description": "0 起页号，默认 0"
+          },
+          "x1": {
+            "type": "number",
+            "description": "起点 x（画布坐标）"
+          },
+          "y1": {
+            "type": "number",
+            "description": "起点 y"
+          },
+          "x2": {
+            "type": "number",
+            "description": "终点 x"
+          },
+          "y2": {
+            "type": "number",
+            "description": "终点 y"
+          },
+          "color": {
+            "type": "string",
+            "description": "线色，默认 #5b9bd5"
+          },
+          "style": {
+            "type": "string",
+            "enum": [
+              "solid",
+              "dashed"
+            ],
+            "description": "默认 solid"
+          },
+          "width": {
+            "type": "number",
+            "description": "线宽，默认 2"
+          },
+          "start_point": {
+            "type": "string",
+            "enum": [
+              "none",
+              "arrow",
+              "triangle",
+              "dot",
+              "square"
+            ],
+            "description": "起点箭头，默认 none"
+          },
+          "end_point": {
+            "type": "string",
+            "enum": [
+              "none",
+              "arrow",
+              "triangle",
+              "dot",
+              "square"
+            ],
+            "description": "终点箭头，默认 none"
+          },
+          "broken": {
+            "type": "array",
+            "items": {
+              "type": "number"
+            },
+            "description": "折线拐点 [x, y]（画布坐标，产生 ┳ 型连接）"
+          }
+        },
+        "required": [
+          "slide",
+          "x1",
+          "y1",
+          "x2",
+          "y2"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_formula",
+      "kind": "write",
+      "since": "2.2.0",
+      "capability": "formula",
+      "description": "插入或更新数学公式（TeX 语法，PPTist 原生 latex 元素，手写风描边渲染）。支持分式 \\frac{}{}、上下标 ^ _、根号 \\sqrt、求和积分 \\sum \\int、希腊字母、矩阵等；渲染由内置 hfmath 引擎完成。带 element_id 时为更新（重新渲染并替换）。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "slide": {
+            "type": "integer",
+            "description": "0 起页号，默认 0"
+          },
+          "latex": {
+            "type": "string",
+            "description": "TeX 公式，如 E=mc^2 / \\frac{a}{b} / \\int_0^1 x^2 dx"
+          },
+          "element_id": {
+            "type": "string",
+            "description": "更新模式：要更新的公式元素 id"
+          },
+          "color": {
+            "type": "string",
+            "description": "笔画颜色，默认 #333333"
+          },
+          "stroke_width": {
+            "type": "number",
+            "description": "笔画宽度，默认 2"
+          },
+          "left": {
+            "type": "number"
+          },
+          "top": {
+            "type": "number"
+          },
+          "width": {
+            "type": "number",
+            "description": "默认按渲染原始尺寸"
+          },
+          "height": {
+            "type": "number",
+            "description": "默认按渲染原始尺寸（fixedRatio 锁比例）"
+          }
+        },
+        "required": [
+          "slide",
+          "latex"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_import_pptx",
+      "kind": "write",
+      "since": "2.4.0",
+      "capability": "import",
+      "description": "打开本机 .pptx：上传给右侧 PPTist 编辑器，用其原生导入器转换成可编辑 deck。导入后返回标题/页数/每页元素摘要；动画、母版、SmartArt、复杂图表等可能丢失。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string",
+            "description": "本机 .pptx 文件路径（绝对路径，或相对 MCP 进程 cwd）"
+          },
+          "data": {
+            "type": "string",
+            "description": "可选：PPTX 的 base64 内容（无法访问 path 时使用）"
+          },
+          "name": {
+            "type": "string",
+            "maxLength": 200,
+            "description": "显示文件名；缺省取 path 的 basename"
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "replace",
+              "append"
+            ],
+            "description": "replace（默认）用导入内容替换当前 deck；append 追加到现有页之后"
+          },
+          "wait_ms": {
+            "type": "integer",
+            "minimum": 1000,
+            "maximum": 300000,
+            "description": "等待编辑器完成导入的毫秒数（默认 180000）"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "ppt_export_pptx",
+      "kind": "write",
+      "since": "2.4.0",
+      "capability": "export",
+      "description": "把当前 deck 导出为本机 .pptx 文件（pptxgenjs）。支持文字/形状/图片/线条/表格/图表/背景/备注；自定义 SVG 路径用矩形近似，LaTeX/音视频跳过。返回文件绝对路径与降级项。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string",
+            "description": "输出 .pptx 路径，或已存在的目录；缺省写到系统临时目录 ppt-exports/"
+          },
+          "file_name": {
+            "type": "string",
+            "maxLength": 160,
+            "description": "文件名（可省略 .pptx）；path 为目录/缺省时使用"
+          },
+          "slide_indices": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "maxItems": 200,
+            "description": "只导出指定页（0 基）；缺省导出全部"
+          },
+          "include_notes": {
+            "type": "boolean",
+            "description": "是否写入演讲者备注（默认 true）"
+          },
+          "overwrite": {
+            "type": "boolean",
+            "description": "目标已存在时是否覆盖；保存回原文件必须显式 true"
+          },
+          "backup": {
+            "type": "boolean",
+            "description": "覆盖前是否备份为 <name>.bak-<时间>.pptx（默认 true）"
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  ],
+  "features": [
+    "deck.contract",
+    "deck.read",
+    "deck.audit",
+    "deck.task",
+    "deck.write",
+    "deck.compose",
+    "deck.recolor",
+    "deck.image",
+    "media.search",
+    "deck.screenshot",
+    "deck.present",
+    "deck.undo",
+    "deck.chart",
+    "deck.table",
+    "deck.notes",
+    "deck.shape",
+    "deck.line",
+    "deck.formula",
+    "deck.import",
+    "deck.export"
+  ],
+  "capabilities": [
+    {
+      "id": "contract",
+      "title": "契约探测",
+      "description": "",
+      "tags": [
+        "meta"
+      ],
+      "tools": [
+        "ppt_capabilities"
+      ]
+    },
+    {
+      "id": "deck",
+      "title": "读取演示文稿",
+      "description": "",
+      "tags": [
+        "read"
+      ],
+      "tools": [
+        "ppt_get_deck"
+      ]
+    },
+    {
+      "id": "audit",
+      "title": "确定性审计",
+      "description": "",
+      "tags": [
+        "read",
+        "quality"
+      ],
+      "tools": [
+        "ppt_audit"
+      ]
+    },
+    {
+      "id": "task",
+      "title": "任务恢复",
+      "description": "",
+      "tags": [
+        "state"
+      ],
+      "tools": [
+        "ppt_task"
+      ]
+    },
+    {
+      "id": "text",
+      "title": "文字与槽位",
+      "description": "",
+      "tags": [
+        "write",
+        "content"
+      ],
+      "tools": [
+        "ppt_text",
+        "ppt_fill"
+      ]
+    },
+    {
+      "id": "style",
+      "title": "主题与背景",
+      "description": "",
+      "tags": [
+        "write",
+        "style"
+      ],
+      "tools": [
+        "ppt_style"
+      ]
+    },
+    {
+      "id": "element",
+      "title": "元素编辑",
+      "description": "",
+      "tags": [
+        "write",
+        "layout"
+      ],
+      "tools": [
+        "ppt_element"
+      ]
+    },
+    {
+      "id": "slide",
+      "title": "页面管理",
+      "description": "",
+      "tags": [
+        "write",
+        "structure"
+      ],
+      "tools": [
+        "ppt_slide"
+      ]
+    },
+    {
+      "id": "apply",
+      "title": "底层指令",
+      "description": "",
+      "tags": [
+        "advanced"
+      ],
+      "tools": [
+        "ppt_apply"
+      ]
+    },
+    {
+      "id": "compose",
+      "title": "成稿编排",
+      "description": "",
+      "tags": [
+        "recipe",
+        "layout"
+      ],
+      "tools": [
+        "ppt_deck",
+        "ppt_page"
+      ]
+    },
+    {
+      "id": "recolor",
+      "title": "整体换色",
+      "description": "",
+      "tags": [
+        "recipe",
+        "style"
+      ],
+      "tools": [
+        "ppt_recolor"
+      ]
+    },
+    {
+      "id": "image",
+      "title": "图片",
+      "description": "",
+      "tags": [
+        "write",
+        "media"
+      ],
+      "tools": [
+        "ppt_image"
+      ]
+    },
+    {
+      "id": "imagesearch",
+      "title": "图片检索",
+      "description": "",
+      "tags": [
+        "read"
+      ],
+      "tools": [
+        "ppt_images"
+      ]
+    },
+    {
+      "id": "screenshot",
+      "title": "实时画面",
+      "description": "",
+      "tags": [
+        "read",
+        "visual"
+      ],
+      "tools": [
+        "ppt_screenshot"
+      ]
+    },
+    {
+      "id": "present",
+      "title": "放映",
+      "description": "",
+      "tags": [
+        "control"
+      ],
+      "tools": [
+        "ppt_present"
+      ]
+    },
+    {
+      "id": "history",
+      "title": "撤销重做",
+      "description": "",
+      "tags": [
+        "control"
+      ],
+      "tools": [
+        "ppt_history"
+      ]
+    },
+    {
+      "id": "chart",
+      "title": "图表",
+      "description": "",
+      "tags": [
+        "write",
+        "data"
+      ],
+      "tools": [
+        "ppt_chart"
+      ]
+    },
+    {
+      "id": "table",
+      "title": "表格",
+      "description": "",
+      "tags": [
+        "write",
+        "data"
+      ],
+      "tools": [
+        "ppt_table",
+        "ppt_table_cells"
+      ]
+    },
+    {
+      "id": "notes",
+      "title": "演讲备注",
+      "description": "",
+      "tags": [
+        "write",
+        "content"
+      ],
+      "tools": [
+        "ppt_notes"
+      ]
+    },
+    {
+      "id": "shape",
+      "title": "形状库",
+      "description": "",
+      "tags": [
+        "write",
+        "layout"
+      ],
+      "tools": [
+        "ppt_shape"
+      ]
+    },
+    {
+      "id": "line",
+      "title": "线条",
+      "description": "",
+      "tags": [
+        "write",
+        "layout"
+      ],
+      "tools": [
+        "ppt_line"
+      ]
+    },
+    {
+      "id": "formula",
+      "title": "数学公式",
+      "description": "",
+      "tags": [
+        "write",
+        "content"
+      ],
+      "tools": [
+        "ppt_formula"
+      ]
+    },
+    {
+      "id": "import",
+      "title": "导入 PPTX",
+      "description": "",
+      "tags": [
+        "write",
+        "file"
+      ],
+      "tools": [
+        "ppt_import_pptx"
+      ]
+    },
+    {
+      "id": "export",
+      "title": "导出 PPTX",
+      "description": "",
+      "tags": [
+        "write",
+        "file"
+      ],
+      "tools": [
+        "ppt_export_pptx"
+      ]
+    }
+  ]
+}