前言¶
DSH 的插件机制适合把模型工具、客户端 UI 和本地处理链接进同一工作流。对需要在 DSH 中完成演示文稿的任务，dsh-ppt-maker 提供了一条本地链路：模型使用 ppt_* 工具操作 PPT 工程，用户在右侧栏工作台查看和修改，本地 TS 引擎构建最终 .pptx。
这是什么¶
dsh-ppt-maker 是 OMSociety 维护的 DSH 插件，采用 MIT 许可证。它用于创建、编辑、逆向、质检和导出 PPT。
核心链路如下：
- 模型通过十一个
ppt_*工具执行 PPT 操作。 - 中间契约为 PPTD YAML DSL，目录结构为
deck.pptd+pages/*.page。 - 本地纯 TS 引擎构建最终
.pptx，主链无 Python。 - 用户在右侧栏工作台与模型共享同一份 PPTD 工程。
核心功能¶
工具与工程¶
- 通过十一个
ppt_*工具执行创建、编辑、逆向、质检、导出等 PPT 操作。 - 基于 PPTD YAML DSL（
deck.pptd+pages/*.page）作为中间契约。 - 支持把既有
.pptx全量逆向为 PPTD 工程。 - 支持对
.pptx做外科手术式补丁。
工作台¶
- 提供右侧栏三栏工作台：缩略图条、画布、属性面板。
- 支持双击文字就地编辑。
- 支持拖拽页序。
- 支持版本历史快照和一键恢复。
- 支持
baseRevision乐观锁和 409 冲突保护。
质检与导出¶
- 提供规则质检与按需 AI 视觉质检。
- 质检结果写入
manifest.qaReport。 - 导出时自动嵌入实际用到的字体。
- 支持页面转场与元素动画 preset。
- 本地纯 TS 引擎构建最终
.pptx，主链无 Python。
安装与启用¶
安装前停止正在运行的 DSH。由于插件会随 DSH 客户端加载并执行本地依赖，且以当前 DSH 进程权限运行，安装前应检查源码与 MIT 许可证。
执行安装命令：
dsh plugin --profile <profile> add "dsh-ppt-maker"
装好后刷新浏览器页面。
相关依赖与限制如下：
- 主链全 TS、无 Python。
ppt_render与质检使用的@deepseek-ai/libreoffice-kit@0.1.2是硬依赖，约 183MB/平台。skills/ppt-maker/scripts/下的 Python 脚本仅作逃生舱。peerDependencies要求多个@deepseek-ai/dsh-*包版本范围为>=0.2.0-rc.2 <0.3.0-0。
典型用法¶
下面是一条可复现的本地工作流。
1、在对话中说「帮我做一份 PPT」，或显式 invoke ppt-maker 技能。
2、模型使用 ppt_create 新建工程，或使用 ppt_import 将现有 .pptx 逆向进工程。
3、在右侧栏工作台双击文字就地修改、拖拽页序，并点击「导出 .pptx」。
4、让模型执行 ppt_check 质检、ppt_render 逐页查看 PNG。
5、在页脚状态条点击「打开」，用系统关联应用打开成品或选择「显示文件位置」。
适用场景与注意¶
dsh-ppt-maker 适合需要在 DSH 中完成 PPT 创建、修改、质检和本地导出的场景，尤其是希望最终 .pptx 由本地 TS 引擎生成的工作流。
使用前需要注意以下限制：
table/chart/icon/SmartArt等元素暂不支持渲染，会显示灰底占位。- 导出可被规则 blocker 拦截，需按
ppt_check返回issues修复，或使用skipCheck:true强导（不推荐）。 ppt_check ai:true在路由模型不支持图像输入时，可能返回ai.performed:false和 PNG 路径清单。@deepseek-ai/libreoffice-kit@0.1.2是硬依赖，安装体积约为 183MB/平台。
链接¶
dsh-ppt-maker 将 PPT 工程、模型工具、右侧栏工作台和本地 .pptx 生成放在同一 DSH 插件里，适合用于本地化演示文稿工作流。
- 插件目录页：https://www.skillhub.cn/plugins/OMSociety/dsh-ppt-maker
- GitHub：https://github.com/OMSociety/dsh-ppt-maker
