前言¶

DSH（DeepSeek Harness）採用“一切皆插件”的理念，構建了一個可擴展的技能與工具生態。在開發與演示場景中，手動製作 PPT 或網頁演示往往耗時且繁瑣。dsh-ppt 插件直接解決這一痛點：它允許用戶通過一句話、一段文字或 Markdown 文檔，直接生成可直接放映的 HTML 網頁與可編輯的 PPTX 文件。

該插件由 STARDUSTLC666 維護，採用 MIT 協議。它利用純 Node.js 實現，零運行時依賴，確保了跨平臺（Windows / macOS / Linux）的兼容性。插件不僅提供 DSH 技能註冊，還支持裸 SKILL.md 跨 harness 使用。

核心能力¶

該插件提供以下核心功能：

• 雙格式輸出：生成 HTML 網頁放映文件與 PPTX 演示文稿文件。
• 工具集：
  • ppt_create：根據輸入內容生成演示文稿。
  • ppt_themes：列出內置主題。
• 頁型支持：內置 7 種頁型，包括封面、章節、要點、核心觀點、金句、表格、結束頁。
• 演講者備註：支持 Markdown 中的備註註釋（<!-- 備註: ... -->）。在 HTML 模式下按 S 鍵呼出，在 PPTX 模式下生成原生備註頁。
• 動效支持：支持頁間轉場與要點入場動畫，默認開啓，可通過配置關閉。
• Markdown 識別：自動識別表格、引用塊、備註註釋，並映射爲對應頁型。

安裝與啓用¶

在 DSH 環境中安裝插件：

dsh plugin --profile web add dsh-ppt

安裝完成後，重啓 Web 服務即可使用 ppt_create 和 ppt_themes 工具。

使用方法¶

DSH 技能內使用¶

1. 查看內置主題：

    ppt_themes

2. 創建演示文稿：

    ppt_create {
      title: "把會議減半",
      content: "# 問題\n- 週會太多\n\n# 方案\n- 異步決策",
      theme: "data",
      lang: "zh"
    }

裸 CLI 構建（跨 Harness）¶

將 skills/dsh-ppt/ 複製到任意 Agent Skills 目錄，使用以下命令構建：

node <skill-dir>/scripts/build-deck.mjs \
  --title "產品發佈" \
  --content deck.md \
  --theme data \
  --lang zh \
  --out dist/deck

輸出說明¶

執行命令後，會生成“三件套”文件：

文件命名規則：如果同名文件已存在，新文件會追加 -1、-2 後綴。只有顯式傳遞 overwrite: true（CLI 爲 --overwrite）纔會覆蓋。

內置主題¶

插件複用 hyperframes 視覺風格庫，內置 5 套主題：

• data：數據漂移（默認，未來/沉浸）
• swiss：瑞士脈衝（精準/理性）
• velvet：天鵝絨標準（高級/剋制）
• soft：柔和信號（溫暖/人本）
• bold：極繁大字（大聲/動能）

技術限制與兼容性¶

• Node 版本要求：需要 Node.js 22.19.0 及以上的 22.x，或 24 及以上。
• 兼容性驗證：已在官方 @deepseek-ai/dsh@0.1.5-rc.1 上驗證通過。
• PPTX 生成機制：PPTX 採用空白版式 + 文本框實現，暫不生成智能母版佔位符。在 PowerPoint / WPS 中可正常編輯文字。
• 內容限制：暫不支持圖表與圖片。bilingual 模式僅雙語化播放器界面，不自動翻譯內容。
• 一句話輸入：如果輸入僅有一句話，會自動生成“封面 → 核心觀點 → 結束頁”的三頁最小結構。

總結¶

dsh-ppt 提供了一條從文本到演示文稿的快速流水線。對於需要頻繁製作演示文稿的開發者或產品經理，該插件通過純 Node 實現、無外部依賴的特性，降低了工具鏈的複雜度，同時通過雙格式輸出（HTML 與 PPTX）兼顧了在線放映與線下編輯的需求。

GitHub 倉庫