前言¶

DSH 的插件機制適合把模型工具、客戶端 UI 和本地處理鏈接進同一工作流。對需要在 DSH 中完成演示文稿的任務，dsh-ppt-maker 提供了一條本地鏈路：模型使用 ppt_* 工具操作 PPT 工程，用戶在右側欄工作臺查看和修改，本地 TS 引擎構建最終 .pptx。

這是什麼¶

dsh-ppt-maker 是 OMSociety 維護的 DSH 插件，採用 MIT 許可證。它用於創建、編輯、逆向、質檢和導出 PPT。

核心鏈路如下：

• 模型通過十一個 ppt_* 工具執行 PPT 操作。
• 中間契約爲 PPTD YAML DSL，目錄結構爲 deck.pptd + pages/*.page。
• 本地純 TS 引擎構建最終 .pptx，主鏈無 Python。
• 用戶在右側欄工作臺與模型共享同一份 PPTD 工程。

核心功能¶

工具與工程¶

• 通過十一個 ppt_* 工具執行創建、編輯、逆向、質檢、導出等 PPT 操作。
• 基於 PPTD YAML DSL（deck.pptd + pages/*.page）作爲中間契約。
• 支持把既有 .pptx 全量逆向爲 PPTD 工程。
• 支持對 .pptx 做外科手術式補丁。

工作臺¶

• 提供右側欄三欄工作臺：縮略圖條、畫布、屬性面板。
• 支持雙擊文字就地編輯。
• 支持拖拽頁序。
• 支持版本歷史快照和一鍵恢復。
• 支持 baseRevision 樂觀鎖和 409 衝突保護。

質檢與導出¶

• 提供規則質檢與按需 AI 視覺質檢。
• 質檢結果寫入 manifest.qaReport。
• 導出時自動嵌入實際用到的字體。
• 支持頁面轉場與元素動畫 preset。
• 本地純 TS 引擎構建最終 .pptx，主鏈無 Python。

安裝與啓用¶

安裝前停止正在運行的 DSH。由於插件會隨 DSH 客戶端加載並執行本地依賴，且以當前 DSH 進程權限運行，安裝前應檢查源碼與 MIT 許可證。

執行安裝命令：

dsh plugin --profile <profile> add "dsh-ppt-maker"

裝好後刷新瀏覽器頁面。

相關依賴與限制如下：

• 主鏈全 TS、無 Python。
• ppt_render 與質檢使用的 @deepseek-ai/libreoffice-kit@0.1.2 是硬依賴，約 183MB/平臺。
• skills/ppt-maker/scripts/ 下的 Python 腳本僅作逃生艙。
• peerDependencies 要求多個 @deepseek-ai/dsh-* 包版本範圍爲 >=0.2.0-rc.2 <0.3.0-0。

典型用法¶

下面是一條可復現的本地工作流。

1、在對話中說「幫我做一份 PPT」，或顯式 invoke ppt-maker 技能。

2、模型使用 ppt_create 新建工程，或使用 ppt_import 將現有 .pptx 逆向進工程。

3、在右側欄工作臺雙擊文字就地修改、拖拽頁序，並點擊「導出 .pptx」。

4、讓模型執行 ppt_check 質檢、ppt_render 逐頁查看 PNG。

5、在頁腳狀態條點擊「打開」，用系統關聯應用打開成品或選擇「顯示文件位置」。

適用場景與注意¶

dsh-ppt-maker 適合需要在 DSH 中完成 PPT 創建、修改、質檢和本地導出的場景，尤其是希望最終 .pptx 由本地 TS 引擎生成的工作流。

使用前需要注意以下限制：

• table / chart / icon / SmartArt 等元素暫不支持渲染，會顯示灰底佔位。
• 導出可被規則 blocker 攔截，需按 ppt_check 返回 issues 修復，或使用 skipCheck:true 強導（不推薦）。
• ppt_check ai:true 在路由模型不支持圖像輸入時，可能返回 ai.performed:false 和 PNG 路徑清單。
• @deepseek-ai/libreoffice-kit@0.1.2 是硬依賴，安裝體積約爲 183MB/平臺。

鏈接¶

dsh-ppt-maker 將 PPT 工程、模型工具、右側欄工作臺和本地 .pptx 生成放在同一 DSH 插件裏，適合用於本地化演示文稿工作流。

• 插件目錄頁：https://www.skillhub.cn/plugins/OMSociety/dsh-ppt-maker
• GitHub：https://github.com/OMSociety/dsh-ppt-maker