dsh-kimi-ppt：DeepSeek Harness 的本地 PPT 技能插件

前言¶

DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。在智能體開發中，讓大模型生成 PPT 是常見需求。現有的做法往往依賴瀏覽器截圖或不可靠的雲端服務。dsh-kimi-ppt 插件通過內置的 kimi-ppt 技能，解決了這個問題。

是什麼¶

dsh-kimi-ppt 是一個客戶端插件，由 OMSociety 維護。它集成了 kimi-ppt 技能，允許用戶在 DSH 環境中創建、編輯、復刻和導出 PPT 文件。其核心價值在於純本地導出，不依賴瀏覽器或外部網絡，保證穩定性和可控性。

核心特性¶

• PPTD DSL：基於 Moonshot .pptd（YAML）抽象 OOXML，單頁自包含、可視即所得。
• 雙素材導出：默認產出「可編輯 PPTD 項目 + 本地生成的 .pptx」。
• 設計系統：內置學術 / 諮詢 / 金融 / 促銷 / 工作等場景預設主題。
• DSH 本地導出：使用 python-pptx 本地生成 .pptx，Pillow 本地渲染預覽圖；離線穩定。
• 插件即技能：通過 dsh plugin add 安裝，宿主自動註冊 skills/kimi-ppt 技能根。

安裝與啓用¶

1. 停止正在運行的 DSH（運行中的服務會鎖住依賴，裝完再起）。
2. 執行安裝命令：

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

3. 重啓 DSH，技能目錄自動發現。

注意：桌面版（desktop profile）由應用獨佔管理，CLI 無法代管安裝；請在桌面應用內操作。

典型用法¶

技能腳本隨插件包安裝，位於 profile 的 node_modules/dsh-kimi-ppt/skills/kimi-ppt/scripts/ 目錄。

• 本地生成 PPTX（不依賴瀏覽器）：

    python scripts/pptd_to_pptx.py <deck.pptd> -o <deck.pptx>

• 本地渲染預覽圖：

    python scripts/pptd_to_png.py <deck.pptd> -o <.preview>

• 檢查本機字體：

    python scripts/check_fonts.py <deck.pptd>

若需桌面增強導出（包含字體嵌入與淡入淡出轉場），請使用：

python scripts/export_pptx.py <deck.pptd> -o <deck.pptx>
python scripts/export_images.py <deck.pptd> --output <.qa-images>

設計系統與字體¶

插件內置了多套設計系統，位於 reference/design_system/：
* academic：學術
* consulting：諮詢
* finance：金融
* promotion：促銷
* work：工作

字體方面，reference/local-fonts.md 規範了場景與推薦字體的映射。生成前建議運行 check_fonts.py 驗證，缺失字體系統會自動提示並給出本地替代方案（如 MiSans、Century Gothic 等）。

依賴與注意事項¶

• 本地導出依賴：python-pptx、Pillow、PyYAML。
• 桌面增強依賴：Node.js 18+、agent-browser、Chrome 或 Edge。桌面增強導出需要可訪問 www.kimi.com 與 statics.moonshot.cn。
• 功能限制：字體嵌入與淡入淡出轉場僅在桌面增強導出中提供，本地導出不支持。
• 項目性質：kimi-ppt 爲非官方項目，僅供學習與研究。

結尾¶

dsh-kimi-ppt 解決了智能體在 DSH 環境下本地化、可控化生成 PPT 的需求。通過 PPTD DSL 和本地腳本，它爲開發者提供了一套從設計到導出的完整工作流。

• 目錄頁：https://www.skillhub.cn/plugins/OMSociety/kimi-ppt-skill
• 源碼：https://github.com/OMSociety/dsh-kimi-ppt