dsh-plugin-web-ppt
DeepSeek Harness 插件：让 agent 直接读懂并导出 .pptx / .ppt。
解析与渲染全部走 web-ppt，纯 JS——不装 PowerPoint、不起 LibreOffice、不转格式、不联网。
安装
dsh plugin --profile <你的 profile> add dsh-plugin-web-ppt
装完 dsh --profile <name> --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 固定走原生 <text> 而不是 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
