前言¶

在 DeepSeek Harness (DSH) 環境中，智能體（Agent）經常需要處理附件或 Markdown 文本，並將其轉化爲演示文稿。手動轉換不僅耗時，且難以保持格式一致性。dsh-ppt-studio 插件旨在解決這個問題，它允許智能體直接將 Markdown 或附件轉換爲自包含的 HTML 幻燈片、可編輯的 PPTX 文件以及 JSON 清單。

插件簡介¶

dsh-ppt-studio 是一個 DSH 插件，由開發者 Huauauaa 維護。其核心功能是利用 Markdown 內容生成演示文稿。該插件採用 MIT 許可證，不屬於 DeepSeek 官方組件。

核心功能¶

1. 多格式輸出：支持將 Markdown 或附件轉換爲 HTML 幻燈片、可編輯的 .pptx 文件以及 JSON 清單。
2. 內置主題：提供 data、swiss、velvet、soft、bold 五種內置主題供選擇。
3. 語言配置：支持配置默認語言（zh 或 en）。
4. 主控文件支持：允許使用主機本地的 PPTX 主控文件作爲模板。
5. 工具集：提供 ppt_create、ppt_themes、ppt_templates 等工具。

安裝與啓用¶

安裝前需確保 Node.js 版本不低於 22。

1. 在本地倉庫根目錄執行安裝命令：

    dsh plugin --profile web add ./

2. 驗證配置是否生效：

    dsh --profile web --dump-config

3. 本地測試（無需 Harness）：

    npm run smoke

配置說明¶

安裝後，需在 Web 界面的設置面板中進行配置。PPT Studio 位於 settings.section 頁面。

• 主題選擇：在 HTML 播放器和 PPTX 中選擇一種內置主題（如 swiss）。
• 語言設置：設置播放器界面的默認語言（zh 或 en）。
• 保存默認值：將上述設置寫入主機的設置文檔。
• 主控文件路徑：輸入主機文件系統中的 .pptx 文件絕對路徑或相對路徑。該路徑必須可被 dsh 進程讀取，瀏覽器無法直接上傳文件。

工具使用¶

插件提供三個主要工具：

1. ppt_create：核心工具，用於構建 HTML、PPTX 和 JSON。
   • 參數：
     • title：幻燈片標題。
     • content：Markdown 內容或結構化的 slides 數據。
     • theme：可選，覆蓋設置中的主題。
     • lang：可選，覆蓋設置中的語言。
     • outputDir：可選，輸出目錄。
     • fileName：可選，輸出文件名。
     • useMaster：可選，是否使用主控文件。
2. ppt_themes：列出所有可用的內置主題。
3. ppt_templates：報告當前默認主題和主控文件的狀態。

注意事項與限制¶

1. 插件衝突：該插件與社區現有的 dsh-ppt 插件工具名相同，不能同時安裝，兩者只能二選一。
2. 主控文件限制：
   • 主控文件僅用於近似映射主題顏色到 HTML，PPTX 生成會追加文本框到主控文件，但不支持映射佔位符、圖表、動畫或備註。
   • 無效的主控文件（路徑缺失、非 zip 或缺少必要 XML）會被拒絕。
   • 主控文件路徑必須是主機文件系統路徑，而非瀏覽器沙箱路徑。
3. 功能缺失：不支持 Slidev、圖表生成或自動翻譯。
4. 非官方：該插件不隸屬於 DeepSeek 官方。

總結¶

dsh-ppt-studio 通過提供 ppt_create 等工具，爲 DSH 中的智能體提供了自動生成演示文稿的能力。在需要從 Markdown 快速生成 PPTX 或 HTML 幻燈片時，該插件是一個實用的工具。

• GitHub 倉庫
• 插件目錄