前言¶
在 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。
