前言¶
在 DeepSeek Harness（DSH）里做演示文稿，常见做法是依赖通用对话能力临时拼大纲，再手工进 PowerPoint 排版；可编辑性、结构一致性和逐页质检往往要额外脚本或人工兜底。ppt-assistant 把「需求分析 → 大纲 → 生成与修改 .pptx → 结构质检 → 可选联网配图与渲染审查」收成独立 agent 预设和 Python 引擎，安装时只插入 PPT 助手 预设，不改动标准模式、模型路由、权限或已有会话。下面介绍它是什么、能做什么，以及如何安装与在命令行侧复用引擎。
这是什么¶
ppt-assistant（npm 包名 @rx01334/ppt-assistant，当前版本 1.0.0）是面向 DSH 的 PPT 助手 agent 预设，并附带可编辑 PowerPoint 的生成与检查工具链。维护者为 YujpVc；在 SkillHub 社区目录中归类为 工作流。简介原文为：PPT assistant agent preset and editable PowerPoint generation tools for DeepSeek Harness。
插件通过 GitHub Release 分发（尚未发布到 npm）；社区市场收录申请见 awesome-dsh-plugin PR #10056，审核合并前无法在市场目录搜索到。引擎与预设提取自本机 DeepSeek Harness PPT 助手，保留 MIT 许可及上游署名。
核心功能¶
依据仓库 README，已核实能力包括：
- 会话侧：独立 PPT 助手 预设，覆盖需求分析、大纲、可编辑 PowerPoint 的生成与修改、结构质检；可选联网配图与渲染审查（依赖环境与密钥，见下文）。
- 引擎侧：内置 Python 生成引擎与通用主题资源；默认生成器支持原生可编辑文本、表格与图表。模板与 Logo 由使用者显式提供，包内提供通用默认模板。
- 隔离性：不复制用户配置、API 密钥、机构模板、机构 Logo、历史会话或已生成文件；不自动安装 dsh-office、mindmap 等补充插件。
- 提示词与引擎发现：沿用原规则，可在
deepseek-harness/ppt-assistant、~/ppt-assistant或安装后的node_modules/@rx01334/ppt-assistant中解析。
未运行视觉检查时，不应声称文稿已通过视觉质检；生成质量取决于输入素材与逐页检查。
安装与启用¶
DSH 需要 0.2.1-rc.3 或兼容的 0.2.x；维护者在 Linux Desktop 0.2.1-rc.3 的插件管理入口验证过安装，其他环境以发行说明为准。
图形界面：在 DSH 插件管理页面添加 Release 包地址，新建会话并选择 PPT 助手。
命令行（资料原文）：
dsh plugin --profile web add https://github.com/YujpVc/ppt-assistant/releases/download/v1.0.0/ppt-assistant-1.0.0.tgz
安装只插入 ppt-assistant 预设；插件不包含模型服务或账号，行为遵循当前会话已有权限。安装前应自行查看源码与 MIT 许可证；插件以当前 dsh 进程权限运行。
运行环境与依赖¶
Python 依赖不会在插件安装时自动安装。在引擎目录执行：
python3 -m pip install -r requirements.txt
要求 Python 3.10+。
| 能力 | 依赖 |
|---|---|
| 渲染 | LibreOffice、pdftoppm |
| 扫描文档 OCR | Tesseract |
| 联网取图 | 环境变量 PEXELS_API_KEY |
| 视觉审查 | DEEPSEEK_API_KEY 及可用的视觉模型权限 |
run_pptfast.sh 可选用已安装的 @liustack/pptfast@0.20.0；缺少时使用内置 build_deck.py。本包不自动下载 pptfast。
典型用法¶
在引擎目录，README 给出的可复现示例如下。
从规格 JSON 生成 deck 并做结构质检：
python3 build_deck.py spec.json output.pptx
python3 quality_check.py output.pptx
基于用户模板生成并带模板约束质检：
python3 build_deck.py template-spec.json output.pptx --template template.pptx
python3 quality_check.py output.pptx --template template.pptx
旧版 generate_ppt.py 仍可用 --template 指定用户模板，不包含本机机构素材。包内还提供 example.json 等文件供对照规格格式。
适用场景与注意¶
适合：在 DSH 内希望固定走「PPT 助手」工作流、同时需要在宿主机上用同一套 Python 引擎批量或脚本化生成、修改、质检 .pptx 的开发者或团队。
注意：
- 市场目录（如 SkillHub 插件页）为社区独立站点，与 DeepSeek / 幻方无官方从属关系；星标与收录状态以 GitHub 与目录页为准（当前 GitHub 星标为 0）。
- 密钥、机构模板与历史文件均需自行管理；安装插件不会替你写入或同步这些资源。
- peer 依赖为
@deepseek-ai/dsh-agent-preset>=0.2.1-rc.3 <0.3.0，升级 DSH 大版本前需核对兼容性。
结尾¶
ppt-assistant 把 DSH 上的 PPT 助手预设与可编辑 PowerPoint 工具链打成可安装的 Release 包：会话里选 PPT 助手 即可走分析、大纲、生成与质检流程；命令行侧则用 build_deck.py 与 quality_check.py 等与同一引擎对齐。进一步了解实现与文件清单见 GitHub 仓库，目录介绍见 SkillHub：ppt-assistant。
