前言¶
DeepSeek Harness (DSH) 旨在通過插件化擴展實現功能覆蓋。在生成可編輯的 PPTX 文檔場景中，通常需要處理複雜的模板渲染、校驗邏輯以及與外部 PPT 運行時的交互。dsh-workbuddy-ppt 作爲一個 DSH 插件，提供了一套自包含的解決方案，允許在本地生成可編輯的 PPTX 文件，並提供確定性的 PPTD 校驗能力。
插件簡介¶
dsh-workbuddy-ppt 是由 SuperstructureJH 維護的 DSH 工作流插件。其核心價值在於：
* Editable PPTX generation for DSH：在 DSH 中直接生成可編輯的 PPTX 文件。
* Bundled Kimi-compatible authoring Skill：內置了 Kimi 兼容的作者技能，無需額外配置即可使用。
* Deterministic PPTD v2 checks：提供確定性的 PPTD v2 校驗機制，確保生成內容的結構一致性。
* Local PowerPoint renderer：使用本地 PowerPoint 渲染器處理輸出，不依賴外部演示運行時。
* Shared workspace：支持共享工作區圖片、會話存儲、審批、審計和交付預覽。
* CLI tools：提供 dsh-pptd 命令行工具，用於轉換、檢查、渲染和截圖。
該插件採用 MIT 許可證開源。
核心功能¶
- 雙模式支持：
- PPT 模式：使用本地渲染器生成可編輯的 PPTX，包含內置的 Kimi 技能和 PPTD 校驗。
- Slides 模式：可選模式，使用騰訊 PPT 技能、SlideP 和騰訊文檔運行時 artifacts。
- CLI 工具集：提供完整的命令行工具，支持從 PPTX 轉換爲 PPTD 項目、自動校驗、代碼檢查、截圖預覽和渲染輸出。
- 共享基礎設施：兩種模式共享受治理的工作區圖片、會話存儲、審批流程、審計日誌和交付預覽功能。
安裝與啓用¶
安裝該插件需要滿足 Node.js 版本要求（^22.19.0 或 >=24.0.0）。使用以下命令進行安裝：
dsh plugin --profile web add dsh-workbuddy-ppt
安裝完成後，DSH 將自動加載包內自帶的 kimi-ppt Skill 和 PPTD 校驗邏輯。
CLI 工具使用¶
插件提供 dsh-pptd 命令行工具，用於處理本地 PPTD 項目。以下是常用命令：
# 轉換：將 PPTX 轉換爲可編輯的 PPTD v2 項目
dsh-pptd convert <input>.pptx --output <project-directory> --
# 檢查：檢查指定頁面，指定嚴重級別
dsh-pptd check <project> --page 1,3-5 --severity error,warning --level keep --
# 檢查自動：應用確定性修復（如類型轉換、刪除無效節點）
dsh-pptd check <project> --level auto --
# 檢查：列出所有問題
dsh-pptd inspect <project> --
# 截圖：生成項目內頁面的本地預覽
dsh-pptd screenshot <project> --page 1-3 --output <screenshots> --scale 2 --
# 渲染：將 PPTD 項目編譯爲可編輯的 PPTX
dsh-pptd render <project> --output <output>.pptx --
CLI 工具特性說明¶
- 診斷式轉換：
convert命令將 PPTX 轉換爲 PPTD，此過程爲診斷性而非無損轉換。如果源文件包含不支持的特徵或資源違規，CLI 會返回詳細的 JSON 收據。 - 原子發佈：文件發佈是原子的，若輸出文件已存在，通常需要使用
--force參數。 - 無外部依賴：CLI 不執行或依賴外部演示運行時，所有渲染邏輯在本地完成。
- 網絡限制：加載器在加載過程中禁用了網絡資源。
注意事項¶
- Node.js 版本：確保環境滿足 Node.js ^22.19.0 或 >=24.0.0。
- PPTD v2：生成的 PPTD v2 文件是渲染器的源文件，而非並行診斷導出。
- 安全與審計：由於插件涉及文件渲染和權限控制，建議在安裝前查閱源代碼和許可證。
- 適用場景：適合需要在 DSH 工作流中生成結構化、可編輯 PPTX 文檔，且需要嚴格控制渲染環境和輸出質量的技術團隊。
總結¶
dsh-workbuddy-ppt 通過提供內置的作者技能、確定性的校驗機制以及本地化的 CLI 工具，降低了在 DSH 環境中生成高質量 PPTX 文檔的門檻。其模塊化的設計（PPT 模式與 Slides 模式）也爲不同場景提供了靈活的選擇。更多細節可查閱 GitHub 倉庫。
