前言¶
在 DeepSeek Harness（DSH）里让模型「做一份 PPT」，常见结果是：文字被塞进固定模板、每页版式雷同、配图像贴纸，导出后大量页面变成不可编辑的图片。对需要在对话里迭代版式、又要交付原生 .pptx 的开发者来说，更理想的路径是先有一份可审阅的设计稿，再用确定性代码组装，并能在交付前做几何与视觉检查。
下面介绍社区插件 PTT-Studio（包名 dsh-pptx-studio，DSH 插件页显示为 PPT 工作室）。它由维护者 ColdMagicchess 发布，分类为客户端插件，在 DSH 中走「问需求 → 写 deck → 生成素材 → 组装 → 检查」的完整流程。
这是什么¶
PTT-Studio 是 DeepSeek Harness 的第三方插件：以设计稿为先，生成可编辑、版式完整、配图相对统一的 PowerPoint。核心思路与「把文字塞进模板」不同——先产出可审阅的 deck.json（版式、网格、层级、配色、图片位置），再通过 pptxgenjs 按百分比坐标组装，文字、形状、图表、表格、图标均为原生可编辑元素。
- 目录页：https://www.skillhub.cn/plugins/ColdMagicchess/PTT-Studio
- 源码与文档：https://github.com/ColdMagicchess/PTT-Studio
- 当前包版本（
package.json）：0.4.1 - 许可证：MIT
- 兼容 DSH Desktop：0.2.1-rc.2 及以上 0.2.x（
engines.dsh: >=0.2.1-rc.2 <0.3.0，0.3 尚未适配）
核心功能¶
设计系统¶
插件内置多档风格与版式组合，生成前可参考仓库内 assets/pptx-studio/references/styles.md：
- 11 套风格（扁平插画、科技深色、国风水墨、瑞士国际主义等）
- 5 档复杂程度、3 档文字量
- 17 种版式（封面、章节、要点、对比、时间线、数据、图表等）
- 统一网格、字号阶梯、留白与安全区规则
README 中强调「满版构图」：内置覆盖率检查，避免「上半页内容 + 下半页空白」。
素材与图片后端¶
- 风格板：
pptx_style_board一次生成 2–3 张候选封面构图，用户选定后作为插画风格参考 - 背景、插画、装饰件分开生成；插画默认 cutout 去底；支持本地图片
path并记录来源与许可 - 真实素材优先：名画、文物、地标等尽量用公有领域/授权原图，AI 补缺口
- 默认图片后端 Agnes，可选 ModelScope（Qwen-Image）；支持缓存、重试、限流；也可在设置页配置 OpenAI 兼容图片接口
pptx_generate_assets支持run_in_background，图片多时可先返回 job id，再用job_output收结果
组装与质检¶
| 工具 | 作用 |
|---|---|
pptx_style_board |
生成候选风格样张 |
pptx_generate_assets |
生成背景、插画、装饰件 |
pptx_build |
按 deck.json 组装 .pptx，内置几何检查与媒体去重 |
pptx_check |
溢出、重叠、安全区、密度、对比度、覆盖率、装饰压字等 |
pptx_review |
独立视觉模型逐页评审渲染图，返回结构化问题 |
pptx_render |
LibreOffice Kit 逐页渲染 PNG，供视觉复查 |
pptx_build 默认生成逐页缩略图与总览预览图；README 示例中成片体积多在约 1–4 MB（含 800px 级图片压缩与同图不重复嵌入）。
插件注册 pptx-studio skill，Web 对话里六个 pptx_* 工具有专用聊天卡片（组装卡带总览、页数、体积与问题等）。
工作区产物¶
典型流程如下，每一步产出落在工作区文件中，可随时改 deck.json 再组装：
主题
│
├─ ask_user_question → brief.json
├─ 逐页设计稿 → deck.json
├─ pptx_style_board → style/board-N.png
├─ pptx_generate_assets → assets/ decor/
├─ pptx_build → builds/deck.vN.pptx
├─ pptx_check / pptx_render
└─ present → 交付 .pptx
安装与启用¶
环境要求¶
- DeepSeek Harness Desktop 0.2.1-rc.2 或更新的 0.2.x
- 图片生成需要 Agnes 或 ModelScope 的 API Key（或自定义 OpenAI 兼容图片后端）
- 仅从源码构建时需要 Node.js ≥ 22.19
从插件市场安装（README 推荐）¶
- 打开 插件 → 实验性插件 旁的 更多 → 自定义插件市场
- 在 发现 → 添加索引源 填入：
https://raw.githubusercontent.com/ColdMagicchess/PTT-Studio/main/market/index.json
- 搜索 “PPT”，点 安装
从 GitHub 安装¶
仓库已提交 lib/ 构建产物，安装时无需构建：
dsh plugin --profile desktop add github:ColdMagicchess/PTT-Studio
生产环境可锁定 commit：
dsh plugin --profile desktop add github:ColdMagicchess/PTT-Studio#<commit>
安装后重启 Desktop，在「插件」页看到 PPT 工作室 即成功。
配置 API Key¶
打开「插件 → PPT 工作室」设置页，在 API Key 分区填入 AGNES_API_KEY、MODELSCOPE_API_KEY（可选），或按自定义模型的 apiKeyRef 填写。Key 写入 DSH 凭据库，也可设置同名环境变量后重启 Desktop。
设置页还可调整文字/视觉/图片模型路由、imageBackend、imageMaxPx（默认 800）、maxImagesPerCall（默认 24）等；完整字段见 README「配置」一节与 src/config.ts。
典型用法¶
安装后在对话中直接描述主题与风格，模型会加载 pptx-studio skill。README 示例：
做一份关于「青少年编程夏令营」的招生 PPT，风格活泼一点，文字少一些。
做一份「旧办公楼更新提案」，现代极简、商务建筑风，7 页左右。
过程中可继续用自然语言约束，例如指定瑞士国际主义风格、要求补满空白版面、调整某一页字号等。若 visionModelMode 为 route 或 custom，检查阶段会走 pptx_review；默认 session 时仍可用渲染图配合对话复查。
适用场景与注意¶
适合谁： 需要在 DSH 对话里从主题生成多页、可编辑 .pptx，且在意版式覆盖率、质检与素材分工（背景/插画/装饰）的团队或个人。
权限与安全： 插件以当前 DSH 进程权限运行，可读写工作区、调用配置的模型与图片 API。安装前应在 GitHub 查看源码与 MIT 许可证，自行评估是否引入第三方图片服务 Key。
生态说明： DSH 社区插件目录（如 SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系；本插件通过上述市场索引或 dsh plugin add github:... 安装，并非「官方应用商店」内置应用。
结尾¶
PTT-Studio 把 PPT 生成拆成可审阅的 deck.json、确定性 pptx_build 与多层 pptx_check / pptx_review，适合在 Harness 里做设计优先的幻灯片交付。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库。
