dsh-slides：爲 DeepSeek Harness Agent 生成自包含 HTML 幻燈片

在 DeepSeek Harness (DSH) 的開發場景中，讓智能體直接產出演示文稿是一項常見需求。傳統做法通常涉及手動將 Markdown 或文本複製到 PowerPoint，過程繁瑣且容易出錯。dsh-slides 插件通過一個工具接口，讓 Agent 直接生成自包含的 HTML 幻燈片文件，支持離線演示、打印 PDF 以及導出 PPTX。

功能概覽¶

該插件爲 DSH Agent 提供了以下能力：

生成自包含 HTML 幻燈片：生成的文件不依賴任何網絡資源（無 CDN、無字體、無圖牀），確保在無網絡環境下也能正常演示。
演示與打印：支持全屏演示，演講者備註（Speaker Notes）僅在按下 S 鍵時顯示，不會出現在屏幕上。支持通過 Ctrl+P 打印爲 PDF。
導出 PPTX：支持導出可編輯的 PowerPoint 文件。
預置主題：提供五種完成的主題，無需手動配置樣式：plain（默認）、ink、midnight、slate、sunrise。

安裝與啓用¶

在 DSH 環境中安裝該插件：

dsh plugin --profile web add dsh-slides
dsh web

安裝後，Agent 會獲得一個 make_slides 工具，用於將結構化數據轉化爲幻燈片。

使用方式¶

Agent 接收結構化數據作爲輸入，支持多種佈局類型：

title：包含標題、副標題和演講者信息。
section：作爲演講章節的分隔符。
bullets：包含標題和要點列表，支持粗體、斜體和代碼格式。
image：包含圖注的圖片。
quote：帶引用來源的引用塊。

在對話中，可以直接請求 Agent 生成演示文稿，例如：

“turn these results into a 10-minute talk”

若需要同時生成 HTML 和 PPTX 文件，可指定格式：

“formats: [“html”, “pptx”]”

配置¶

插件默認插入 id: slides 配置項。如需自定義，可在 DSH 的配置文件（如 cordis.patch.yml）中覆蓋：

- id: slides
  config:
    outputDir: slides/       # 幻燈片輸出目錄
    defaultTheme: plain      # 主題選擇：plain | ink | midnight | slate | sunrise
    promptGuidance: true     # 註冊提示詞引導
    promptOrder: 150

已知限制¶

不支持增量展示：幻燈片內容會一次性呈現，不支持逐條展開動畫。
PPTX 限制：導出的 PPTX 是乾淨的大綱，不包含動畫或母版設計，僅保留內容和基本格式。

許可證¶

該插件採用 MIT 許可證。