前言¶

在 DeepSeek Harness（DSH）裏做智能體任務時，經常需要把一段 Markdown 內容直接展示出來，例如研究報告、會議記錄或課程大綱。已有做法往往是人工排版，或者引入額外前端工程。如果只想要一個結果：一個可以直接在瀏覽器裏打開的單文件 HTML 演示文稿，就需要一個足夠輕量的工具插件。

下面介紹 dsh-deck-builder。它由 Blaczz 維護，採用 MIT 許可，是一個 DSH 工具插件：註冊 deck_build 工具，把 Markdown 轉換爲自包含的 HTML 演示文稿，支持主題和鍵盤導航，不引入依賴，也不修改 DSH 核心。

這是什麼¶

dsh-deck-builder 的定位是一個 DSH 工具插件：輸入 Markdown，輸出單文件 HTML 演示文稿。

它通過 ctx.tools.register 註冊 deck_build 工具。生成結果自包含：內聯 CSS/JS，無外部資源，不訪問網絡。

該插件是獨立社區插件，不與 DeepSeek Harness 官方從屬。

核心功能¶

deck_build 工具接收 Markdown，返回輸出路徑、幻燈片數量和字節數。

支持三個主題：

• deepseek
• light
• dark

拆分邏輯如下：

1. 優先按 ---、***、___ 分隔。
2. 如果沒有這些分隔符，回退到 H1/H2 標題拆分。

Markdown 渲染覆蓋：

• 標題
• 段落
• 有序列表
• 無序列表
• 代碼塊
• 引用
• 粗體/斜體
• 行內代碼
• 鏈接
• 圖片

實現路徑是零依賴、零核心修改：使用純函數生成，通過 ctx.tools.register 註冊，不使用客戶端 bundle，不訪問網絡，不引入外部資源。

生成邏輯有單元測試覆蓋：splitting、rendering、escaping、self-containment。

安裝與啓用¶

前置條件：

• DSH 可用，且 dsh web 可運行
• Node ≥ 22.19
• pnpm

從 GitHub 安裝時執行：

dsh plugin --profile web add "github:Blaczz/dsh-deck-builder#main"

這一步會把插件添加到 web profile。安裝後重啓 dsh web。

可選 peerDependencies：

@deepseek-ai/cordis >=4.0.1-rc.1 <5.0.0
@deepseek-ai/dsh-tools >=0.1.0-rc.3 <0.2.0

典型用法¶

在 DSH 對話中，直接讓智能體構建演示文稿，例如：

Turn this research report into slides using the deepseek theme:
<markdown content>

智能體會調用 deck_build，生成 deck-<title>.html。打開文件後，可以使用：

• ← / → 或空格鍵切換幻燈片
• f 進入全屏
• 瀏覽器打印或導出 PDF，每頁一張幻燈片

手動調用工具¶

也可以直接調用 deck_build。示例字段如下：

{
  "markdown": "# Title\nbody\n\n---\n\n# Slide 2\nmore",
  "title": "My Deck",
  "theme": "deepseek",
  "outputPath": "slides/my-deck.html"
}

其中：

• markdown：演示文稿內容
• title：演示文稿標題
• theme：主題
• outputPath：輸出路徑

工具返回輸出路徑、幻燈片數量和字節數。

適用場景與注意¶

適合以下情況：

• 在 DSH web 場景中使用
• 需要把 Markdown 報告、會議記錄、課程大綱轉成可分發的單文件 HTML 幻燈片
• 希望輸出離線可用、無外部資源
• 希望不修改 DSH 核心，只增加一個工具

注意：

• 插件以當前 DSH 進程權限運行。安裝前應檢查源碼、許可證和依賴範圍。
• 該插件由 Blaczz 維護，許可爲 MIT © 2026。
• 它是獨立社區插件，不與 DeepSeek Harness 官方從屬。
• 安裝後需要重啓 dsh web。

鏈接¶

GitHub 倉庫：https://github.com/Blaczz/dsh-deck-builder

插件目錄線索：https://www.skillhub.cn/plugins/Blaczz/dsh-deck-builder