dsh-ppt-maker

docs已测通过npmMIT

PPT 制作插件：十一个 ppt_* 工具创建、编辑、逆向、质检与导出演示文稿，内置五族设计系统与主题模板，支持幻灯片动画、海报与信息图。

下载量 / Downloads

2,843

依赖体积 / node_modules

180.33 MB

测试时间 / Tested

2026-11-06

DSH 版本 / Version

0.2.2-rc.1

安装

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

沙箱测试结果

阶段	结果
1 安装	✓
2 列装	✓
3 挂载	✓
4 启动	—

四阶段在隔离沙箱里跑：安装（有网）→ 列装 → 挂载 → 启动（后三步断网）。

README

<p align="center"><strong>中文</strong> · <a href="README_en.md">English</a></p>

<h1>PPT 创客 dsh-ppt-maker</h1>

<p>创建 / 编辑 / 逆向 / 质检 / 导出 PPT 的 DeepSeek Harness 插件，本地纯 TS 引擎直出最终 .pptx。</p>

<p>模型用十一个 <code>ppt_*</code> 工具干活，你在右侧栏工作台里同看同改——双击文字就地编辑、拖拽调页序、导出后一键打开成品。</p>

<p>

</p>

<a href="#这是什么">这是什么</a> • <a href="#核心特性">核心特性</a> • <a href="#效果">效果</a> • <a href="#安装方式">安装方式</a> • <a href="#模型工具">模型工具</a> • <a href="#工作台">工作台</a> • <a href="#开发">开发</a> • <a href="#更新日志">更新日志</a> • <a href="#支持与致谢">支持与致谢</a> • <a href="#许可证与作者">许可证与作者</a>

</div>

这是什么

PPT 创客是一套长在 DeepSeek Harness 里的 PPT 工作链：模型通过十一个 ppt_* 工具创建、编辑、逆向、质检、导出演示文稿；人通过右侧栏工作台与模型接力——面板与模型读写同一份 PPTD 工程。

中间的格式是自主契约的 YAML DSL PPTD（deck.pptd + pages/*.page）：单页自包含、可视即所得，双方言（generate 生成 / reverse 逆向超集），完整规格见 [docs/pptd-spec.md](docs/pptd-spec.md)。

核心特性

特性 · 说明

十一个模型工具 · raw JSON-Schema 注册：创建 / 编辑 / 撤销 / 重做 / 渲染 / 质检 / 导出 / 逆向 / 打开 / 外科手术。引擎 @office-kit/pptx@0.24.0 本地纯 TS 构建最终 .pptx，主链无 Python

双向性 · ppt_import 把既有 .pptx 全量逆向进 PPTD 工程（图表 / SmartArt / OLE 落灰底占位并回插）；ppt_patch 对 .pptx 外科手术（改字 / 换图 / 调页序），不走 PPTD 往返，库级 L1 passthrough 保住未建模部件

PPTD 契约 · YAML DSL（deck.pptd + pages/*.page），单页自包含、可视即所得；generate / reverse 双方言，可手改也可机改

右侧栏工作台 · 自研三栏编辑器（缩略图 + 画布 + 属性面板）：双击文字就地改、拖拽调页序、图片一键替换、撤销 / 重做、版本历史直渲快照并一键恢复、409 冲突保护与「外部已修改」提示

质检分层 · 规则层（文字溢出 / 出界 / 重叠 / 对比度 / 结构 / 缺字体）阻断导出；AI 层按需（ppt_check ai:true）把成品页 PNG 送多模态模型审配色与版式，只出建议不阻断；结果落账 manifest.qaReport，随 revision 可追溯

字体嵌入 · 导出自动嵌入实际用到的字体（EOT 封装 fntdata + embeddedFontLst），未装字体的机器渲染不回落；子集 / 整字体 / 关闭三档（export.fontEmbed），逐字体 fsType 许可闸

转场与动画 · 页面级转场（fade 默认 / none / auto 策展轮换）与 95 种元素动画 preset，本地链路原生写出

修订与快照 · manifest 单一写者 + append-only 快照（游标模型，undo/redo 天然成立）+ baseRevision 乐观锁（409）

设计系统 · 学术 / 咨询 / 金融 / 促销 / 工作五族预设主题，选题后整套版式配色层级一致

本地渲染预览 · 面板画布与缩略图把 PPTD 页直接渲染成 DOM（矢量、秒出、与选择框同源同坐标系）；导出与质检的 PNG 预览走 @deepseek-ai/libreoffice-kit 光栅化最终 pptx，每页按 (page, revision) 磁盘缓存

效果

<table>

<tr>

</tr>

<tr>

<td align="center">工作台实机：左侧缩略图、中间画布、右侧属性面板；导出成功后页脚状态条给出「打开方式」菜单（系统关联应用 / 显示文件位置）</td>

<td align="center">还没有打开演示文稿时的空面板；模型 <code>ppt_open</code> / <code>ppt_import</code> 后面板自动聚焦到对应工程</td>

</tr>

</table>

安装方式

从 npm 安装

# 先停掉正在运行的 DSH（运行中的服务会锁住依赖，装完再起）
dsh plugin --profile <profile> add "dsh-ppt-maker"

提示：装好后刷新一下浏览器页面，从右侧栏打开「PPT 工作台」——只重启宿主不够，客户端产物是页面加载时取的。

依赖：主链全 TS、无 Python；ppt_render 与质检用的 @deepseek-ai/libreoffice-kit@0.1.2 是硬依赖（约 183MB/平台，随包安装）。skills/ppt-maker/scripts/ 下的 Python 脚本仅作逃生舱，见 SKILL.md「Python 逃生舱」。

装完怎么用

1. 对话里说「帮我做一份 PPT」（或显式 invoke ppt-maker 技能）→ 十一个 ppt_* 工具进场

2. 模型 ppt_create 新建工程，或 ppt_import 把现有 .pptx 逆向进工程 → 右侧栏自动弹出工作台

3. 面板里双击文字就地改、拖页序、点「导出 .pptx」→ 成品落在工程目录 export/（文件名带版本号）

4. 让模型 ppt_check 质检、ppt_render 逐页看 PNG；模型在别的会话改了同一工程，面板亮 409 冲突条，不覆盖你的手改

5. 页脚状态条点「打开」→ 用系统关联应用打开成品，或选「显示文件位置」

模型工具

工具 · 作用 · 关键参数

ppt_create · 新建 PPTD 工程 · dir · title · size · designSystem · theme

ppt_themes · 列设计系统与主题（五族预设） · designSystem（可省）

ppt_edit · 原子编辑：ops 数组批量增删改页面与元素，baseRevision 乐观锁 · dir · ops · baseRevision

ppt_undo / ppt_redo · 撤销 / 重做（游标移动，合并窗内连续编辑算一步） · dir · steps（1–20，默认 1）

ppt_render · 渲染每页 PNG 预览（最终 pptx 光栅化） · dir · pages · dpi（默认 96）

ppt_check · 规则质检（默认）+ AI 视觉质检（只出建议不阻断） · dir · pages · ai

ppt_export · 导出 .pptx（规则 blocker 拦截，skipCheck 绕过） · dir · out · skipCheck

ppt_import · .pptx → PPTD 全量逆向（dropped / degraded 两级报告 + 占位形状回插） · source · targetDir · mode（full / surgical）· open

ppt_open · 让右侧栏工作台打开指定工程 · dir

ppt_patch · 对 .pptx 外科手术：set_text / replace_image / move_page · source · ops · out

模型的标准动作顺序是 ppt_create（或 ppt_import）→ ppt_edit 迭代 → ppt_check → ppt_export；技能 ppt-maker（随插件注册）写明了设计系统选型与编辑纪律，模型需要时会自己读。轻改既有 .pptx（改字 / 换图 / 调页序）走 ppt_patch，不经 PPTD 往返。

提示：导出被规则 blocker 拦住时，按 ppt_check 返回的 issues 逐条修，或 skipCheck:true 强导（不推荐）。ppt_check ai:true 返回 ai.performed:false 加 PNG 路径清单时，说明当前路由模型不支持图像输入，主模型自行 read_image 复核即可。

工作台

右侧栏「PPT 工作台」是三栏编辑器：缩略图条 + 画布 + 属性面板。

底图即 DOM：画布与缩略图把 PPTD 页 AST 直接渲染成 DOM（client/components/PptdView.tsx），打开即出、无需等 libreoffice 冷启动；元素、选择框、就地编辑器同一坐标系，恒对齐。table / chart / icon / SmartArt 等暂不支持渲染的元素显示灰底占位。
左右栏可收缩：左栏页列表默认展开、可收起；右栏属性面板选中元素才展开。收起态只留边缘把手。
就地编辑：双击文字就地改 / 拖拽调页序 / 复制删除新增页 / 替换图片 / 「导出 .pptx」落到工程目录 export/ 下（文件名带版本号）。
版本历史：「历史」抽屉直渲任意快照的画

…(truncated)

以上内容来自 npm 上的 README，我们只做格式化，不改内容。

版本

npm 上共发布：3，最后更新 2026-11-01

链接

GitHub · Homepage · npm