PPT 解析导出 unStone/dsh-plugin-web-ppt

dsh-plugin-web-ppt

DeepSeek Harness 插件：让 agent 直接读懂并导出 .pptx / .ppt。

解析与渲染全部走 web-ppt，纯 JS——不装 PowerPoint、不起 LibreOffice、不转格式、不联网。

安装

dsh plugin --profile add dsh-plugin-web-ppt

装完 dsh --profile --dump-config 里会多出一层 # == dsh-plugin-web-ppt，启动即生效。

工具

| 工具 | 干什么 | 关键参数 |
| ppt_read | 逐页返回标题 / 正文 / 演讲者备注，agent 认识一份 PPT 的入口 | path、pages、password、include_hidden |
| ppt_render_svg | 每页导出一个自包含 SVG（图片内联为 data URI） | path、out_dir、pages |
| ppt_export_html | 整份导出成一份可打印 HTML，浏览器「打印为 PDF」即得 PDF | path、out_file、animation_steps |

pages 一律是 1 基选择串，形如 1-3,7；不传表示全部。隐藏页默认不参与，与 PowerPoint 放映一致。

文件读写全部经 Harness 的 fs 服务，因此 workspace 归属、沙箱策略与写入审批都照常生效。

配置

在 profile 的 cordis.patch.yml 里按 id 覆盖（注意 patch 会整体替换 config，要把键写全）：

- id: web-ppt
name: dsh-plugin-web-ppt
config:
maxFileBytes: 134217728
maxTextChars: 40000
includeHidden: false

| 键 | 默认 | 说明 |
| maxFileBytes | 67108864（64 MB） | 单文件读取上限，超出直接失败 |
| maxTextChars | 20000 | ppt_read 的文本预算，超出截断并置 truncated |
| includeHidden | false | 是否默认把隐藏页算进来 |

边界

| 能 | 不能 |
| .pptx（Zip+OOXML）与 .ppt（CFB+Escher） | 导出 PNG——需要 canvas，Node 里没有 |
| 加密文件（传 password） | 写入 / 编辑 PPT，本插件只读 |
| 图表、SmartArt、公式、EMF/WMF 图元 | 播放动画，只能按终态或按点击批次展开成多页 |

导出的 SVG 固定走原生 而不是 foreignObject：后者只有浏览器认，Inkscape / librsvg / 设计工具打开会整块丢失文本。文件是要交出去的，必须自包含。

开发

npm install && npm test

改完代码跑 npm run check && npm test，两条都绿才算完成。

本地挂进 DSH 验证：

dsh plugin --profile dev add /path/to/dsh-plugin-web-ppt

发布

版本号改完打 tag 即可，release.yml 走 npm Trusted Publishing（OIDC），Secrets 里不存凭据：

git tag -a v0.1.0 -m "v0.1.0" && git push origin v0.1.0

⚠️ 第一版走不了 OIDC：npm 要求包已存在才能配置 Trusted Publishing，而包要先发布才会存在。首发先在本地 npm publish 一次，再去 npm 包设置里配好 trusted publisher。

License

MIT