前言¶
在 DeepSeek Harness（DSH）的開發流程中，Agent 產出的內容通常是 Markdown 或 JSON 格式。直接展示這些原始文本往往缺乏可讀性，且難以作爲交付物分享。dsh-artifacts 插件解決了這個問題，它提供了一套「Claude Artifacts」式的渲染方案，將 Agent 的原始輸出轉化爲自包含的 HTML 文檔。
什麼是 dsh-artifacts¶
dsh-artifacts 是一個社區維護的 DSH 插件（作者：zoahdev），旨在通過零運行時依賴的方式，將 Markdown 和 JSON 數據轉換爲美觀的 HTML 靜態頁面。它不依賴外部框架，生成的 HTML 文件可以直接在本地打開、發送郵件或在任何靜態託管服務上發佈。
核心能力¶
插件提供了以下核心功能：
- 多格式輸入：支持 Markdown 文本和 JSON 數據的渲染。
- 零運行時依賴：僅依賴 Node.js 環境，生成的 HTML CSS 內聯，不依賴外部字體或 JS 庫。
- 模板系統：提供四種內置模板，分別用於文檔、卡片、儀表盤和圖庫。
- Vault 導出：支持對整個 Markdown 庫（如 Obsidian 或 VS Code 筆記）進行批量導出。
- 雙端工具：提供命令行工具（CLI）供開發者直接使用，也提供
artifact_render工具供 Agent 在 Harness 中調用。
安裝與啓用¶
安裝前請確保你的 Node.js 版本大於等於 18。
在 DSH 環境中啓用該插件：
dsh plugin --profile web add dsh-artifacts
典型用法¶
下面通過具體命令展示如何使用該插件。
1. 渲染 Markdown 爲 HTML¶
將本地 Markdown 文件渲染爲 HTML 並指定主題：
dsh-artifacts notes.md --title "Release notes" --theme dark --out notes.html
2. 本地預覽¶
開啓本地服務進行實時預覽：
dsh-artifacts notes.md --serve 8080
3. 渲染儀表盤¶
從 JSON 數據渲染儀表盤頁面：
dsh-artifacts --data metrics. --template dashboard --theme brand --out dashboard.html
4. 導出整個知識庫¶
將整個文件夾（如 Obsidian Vault）批量導出爲靜態站點：
dsh-artifacts vault ./my-notes --theme paper --out site
執行後，會在 site 目錄下生成 index.html 和對應的筆記 HTML 文件。
注意事項與限制¶
在接入該插件前，請注意以下事實：
- 環境要求：需要 Node.js >= 18。
- 依賴版本：該插件依賴
@deepseek-ai/dsh-tools版本爲^0.1.0-rc.6或更高。如果 Harness 版本過低，插件可能無法加載或運行。 - Markdown 兼容性：Markdown 渲染器覆蓋了常見子集（標題、列表、引用、代碼、表格、鏈接、圖片），並非完整的 CommonMark 實現。
- 儀表盤機制：儀表盤是純靜態 HTML/CSS，不包含 JavaScript 運行時，不支持實時數據綁定（
--serve模式除外）。 - 插件性質：這是一個社區插件，非 DeepSeek 官方產品，請自行審查源碼與許可證。
總結¶
dsh-artifacts 適合需要在 Harness 中生成可分享、可離線瀏覽的靜態報告或文檔的場景。它通過簡單的命令行接口，解決了 Agent 輸出結果展示不佳的問題，且由於零依賴特性，維護成本較低。
- 插件目錄：zoahdev/dsh-artifacts
- 源碼倉庫：GitHub
