kitterfast/dsh-ppt-maker

dsh-ppt-maker

DSH（DeepSeek Harness）Web 插件：在输入框左下角的「+」菜单里加一个「PPT 制作」入口，一次点击就把整套 PPT 全流程提示词跑起来。

- 只加一个菜单项、只发一条消息 —— 不改会话权限、不开宿主接口、不往聊天里灌文档
- 提示词随插件自带（58 KB 自包含文档），工作目录是空的也能跑
- 全流程只需要一次确认（就是下面那条 /permission），之后不再逐条打断
- 两套自动化校验 + GitHub Actions，改动不留暗坑

它是什么

这个插件本身不做 PPT。它是一个触发器：把一份「自包含的 PPT 全流程编排提示词」交给当前会话里的 agent，让 agent 按文档走完
准备环境 → 问需求 → 出 5 个风格方向 → 初稿 → 程序化图形 / AI 生图 → 图表动效 → 导出 PPTX。

那份文档是插件的全部载荷：prompts/PPT全流程_一键编排提示词.md。
想改成自己的工作流，直接改这一个文件（改完跑 npm run verify 会检查它还在、没被截断）。

前置要求

| | |
|---|---|
| DSH | 桌面端或 web profile（需要 @deepseek-ai/dsh-client-ui-commands 与 -ui-conversation） |
| Node | ≥ 20（只在开发/校验时需要，插件运行时不依赖 npm 包） |

安装

仓库地址（可以直接交给 agent）：https://github.com/kitterfast/dsh-ppt-maker
DSH / pnpm 规格：github:kitterfast/dsh-ppt-maker

方式 A：一句话给 agent（推荐）

把下面这句原样交给你的 DSH agent（连仓库地址一起给，它就能自己装）：

让Agent执行命令：「帮我装 DSH 插件 github:kitterfast/dsh-ppt-maker（profile 用 web），装完重启桌面端」，安装插件后在对话框左下方的加号处可以找到「PPT 制作」
插件地址：https://github.com/kitterfast/dsh-ppt-maker · v1.4.2

装完就什么都不用管了。 第一次点「PPT 制作 → A. 使用 AI 生图」时，插件投送的第一条消息里就有第 2 步硬指令：
让 agent 自己跑 scripts\check-env.ps1（缺 arkcli／缺插件／缺浏览器／没登录，它都自己补）。只有在"专属浏览器从未登录过火山"这一种情况下，才会需要你本人用手机验证码或扫码登录一次。

或者它自己执行：

dsh plugin --profile web add github:kitterfast/dsh-ppt-maker          # 跟随 main（永远最新）
dsh plugin --profile web add github:kitterfast/dsh-ppt-maker#v1.4.2   # 固定 v1.4.2（可复现）

dsh plugin add 会把参数转发给 profile 目录下的 pnpm。仓库里已经声明了 dsh.bundle.patch 与 dsh.client，
所以装上即挂载，不需要手改 bundles。

方式 B：手动挂载（不想用 pnpm / 想改源码时）

1) 克隆到固定位置
git clone https://github.com/kitterfast/dsh-ppt-maker "$env:USERPROFILE\.dsh\local-plugins\dsh-ppt-maker"

2) 挂进 web profile：编辑 "$env:USERPROFILE\.dsh\profiles\web\package.json"
a. dependencies 里加一行：
"dsh-ppt-maker": "link:../../local-plugins/dsh-ppt-maker"
b. dsh.profile.bundles 数组末尾加一行：
"dsh-ppt-maker"

3) 建目录联接，让 profile 能解析到这个包
New-Item -ItemType Junction
-Path   "$env:USERPROFILE\.dsh\profiles\web\node_modules\dsh-ppt-maker"
-Target "$env:USERPROFILE\.dsh\local-plugins\dsh-ppt-maker"

4) 重启 DeepSeek Harness Desktop

装好后校验一下（可选，但很快）：

node "$env:USERPROFILE\.dsh\local-plugins\dsh-ppt-maker\_verify\verify-package.mjs"

使用

1. 点输入框左下角 + → 菜单里出现 PPT制作（敲 / 也能看到）
2. 弹出第二步，选一个：
- A. 使用 AI 生图 —— 走【七】Seedream（需火山方舟账号/授权，约 0.3 元/张）
- B. 不使用 AI 生图 —— 走【七B】程序化图形/SVG（零成本、断网可用）
3. 插件往当前会话发一条 kickoff 消息：让 agent 读文档、并替你预答检查点 0
4. 之后只剩 检查点 ①（要需求）/ ②（选风格）/ ③（转不转 PPTX） 会停下等你选 —— 这三个是文档本身设计的打断点

全流程只确认一次

跑完整流程要用到无头浏览器（做渲染验收）和写工作区外的临时目录（arkcli 暂存、npm 缓存），
在受限沙箱下这些操作每一步都会弹权限确认。所以 kickoff 的第 1 条就是：

/permission danger-full-access

你发这一句，之后全程不再逐条打断。不想放开也行 —— agent 会按文档 A0 改走【七B】，那条路径零工作区外写入。

插件不会替你改会话权限：这是一次安全边界的决定，只能由你按下。

HTML → PPTX：自带的确定性管线（v2.0.0 新增）
为什么有它：2026-09-14 的真实跑批里，转换是“agent 每次现场写一个转换器”。结果是
1 小时 44 分、48 个一次性脚本，交出来的 PPTX 一页动画都没有、把浏览器翻页按钮烤进了每一页、文字错版。

现在这件事是插件自带的代码（scripts/deck/），不是每次重新发明：

node scripts\deck\deck-render.mjs build\deck.config.json    # ① 一次无头浏览器 + 真 alpha 图层 + 增量
node scripts\deck\deck-to-pptx.mjs build\deck.config.json   # ② 按名字定位形状 id + 写原生时间轴
node scripts\deck\deck-verify.mjs build\deck.config.json    # ③ 结构 + PowerPoint 真机 + 逐页像素

20 页实测：渲染 41 秒、生成 3 秒、验收 ~12 秒；三道闸门全过
（逐页像素 mean 0.02–0.96 / 255，19 页 0 个坏像素）。详见
scripts/deck/README.md。

代价说清楚：版式与文字一起栅格化（跨引擎搬运坐标必然错版，这是上一轮的病根），
所以 PPT 里的文字不能直接改；文字已写进备注页与图片替换文字。
无限循环动效（CSS infinite）无法用 PowerPoint 时间轴表达，管线会检测并警告具体是哪几页哪几层。

目录结构

.
├─ package.json                 dsh.bundle.patch + dsh.client{inject,platform} + npm scripts
├─ cordis.patch.yml             插入一行 id: ppt-maker / name: dsh-ppt-maker
├─ lib/index.js                 node 半边：空功能 + 启动自检自带提示词是否在，写一行日志
├─ lib/client.js                客户端半边：菜单项 + 二级选择 + 发一条 kickoff
├─ prompts/PPT全流程_一键编排提示词.md   ← 插件的全部载荷（唯一来源，不要复制第二份）
├─ scripts/deck/                HTML→PPTX 确定性管线（渲染 / 生成 / 验收 + 工具）
├─ scripts/check-env.ps1        环境自检（Node / arkcli / CDP 浏览器 / 登录态）
├─ scripts/cdp/                 零依赖 CDP 客户端（0 手动登录用）
├─ docs/已删除的机制说明.md       设计边界与“为什么不做那些事”的留档
├─ _verify/verify-package.mjs    源完整性 / 可发布性 / 提示词载荷 / 安装一致性
├─ _verify/verify-client-bundle.mjs  客户端 bundle 的真实行为（含全部降级分支）
└─ .github/workflows/verify.yml  CI：Node 20 / 22 各跑一遍

开发

npm run verify          # 两套校验一起跑（与 CI 完全一致）
npm run verify:package  # 只跑源完整性 / 打包元数据 / 安装一致性
npm run verify:client   # 只跑客户端行为

- 改 lib/client.js → DSH 里刷新页面即可（客户端 HMR 会重建 bundle）
- 改 lib/index.js 或 prompts/ → 需要重启 DSH
- 改了插件本体，记得同步到安装目录（verify:package 会比对并报出不一致的文件）

设计边界（有意不做）

| 不做 | 原因 |
|---|---|
| 不改会话权限 | 安全边界只能由用户按；插件最多提醒你发哪一句 |
| 不开宿主 HTTP 路由 | 插件不该在用户客户端上加未认证端点 |
| 不往聊天里塞提示词全文 | 一大坨字，而且会让文档版本管理失效（改成读文件） |
| 不发 composer 通知 | 消息发没发出去，看聊天框就知道 |

这些机制曾经实现过又被删除，精确 API 与取舍记在 docs/已删除的机制说明.md。

License

MIT

English

dsh-ppt-maker 是一个 DSH (DeepSeek Harness) Web 插件，它在 composer 的 + 菜单中添加一个 PPT 制作 入口。
选择它会发送一条简短的 kickoff 消息，把捆绑的、自包含的 PPT 编排提示词
（prompts/PPT全流程_一键编排提示词.md）交给当前会话，并预先回答该文档的第一个检查点。

设计规则：不更改会话权限、不添加宿主路由、不把文档倾倒进聊天、不添加额外通知。
整个运行过程只需要一次用户确认——当 kickoff 要求时，发送一次 /permission danger-full-access。

dsh plugin --profile web add github:kitterfast/dsh-ppt-maker
or manually: git clone https://github.com/kitterfast/dsh-ppt-maker "$env:USERPROFILE\.dsh\local-plugins\dsh-ppt-maker"
然后将 "dsh-ppt-maker" 添加到 %USERPROFILE%\.dsh\profiles\web\package.json 中的 dsh.profile.bundles，并重启 DSH。
npm run verify   # 包 + 客户端行为检查（也会在 CI 中运行）

MIT 许可。