DeepSeek Harness 的理念是「一切皆插件」。在智能體開發或調試過程中，對話中經常出現 Markdown 代碼塊形式的 Mermaid 流程圖。如果僅以文本展示，難以直觀理解邏輯結構。dsh-mermaid 插件解決了這個問題，它將對話中的 Mermaid 代碼渲染爲 SVG 流程圖。
這是一個 DeepSeek Harness 的客戶端插件，由 GongYuanCaiJi 維護。其核心邏輯逐行移植自 pi-mermaid@0.3.0，將原本用於 TUI 的渲染邏輯適配到了 DSH 的 Web 客戶端中。
核心功能¶
- 自動渲染與校驗：對話中出現 mermaid 圍欄（無論用戶還是助手發送）時自動渲染爲 SVG。使用 Mermaid 官方 parser 做語法校驗，出錯時在圖下方顯示 warning 或 error。
- 類型支持：支持 graph / flowchart、sequenceDiagram、classDiagram、erDiagram、stateDiagram(-v2)。
- 性能與限制：代碼塊超過 400 行或 20000 字符時自動跳過並提示。按 (session, turn) 緩存渲染結果，避免重複計算。
- 交互功能：每張圖附帶可摺疊的源碼塊，支持
/mermaid命令手動重渲染最後一條助手消息。
安裝與啓用¶
插件尚未發佈到 npm，需通過 GitHub 源碼安裝。安裝時需要開啓 allowBuilds 以允許 prepare 腳本構建。
dsh plugin add github:GongYuanCaiJi/dsh-mermaid
安裝後，在 DeepSeek Harness 的 Web 客戶端中，對話中的 Mermaid 代碼將自動被渲染爲圖表。
典型用法¶
在對話中發送包含 Mermaid 圍欄的消息，系統會自動將其渲染爲 SVG 圖表。
```mermaid
graph TD
Start --> End
```
發送 /mermaid 命令可手動重渲染最後一條助手消息中的圖表。
注意事項¶
插件以當前 DSH 進程權限運行，安裝前請檢查源碼與許可證（MIT）。更多細節與源碼，請查看 GitHub 倉庫：https://github.com/GongYuanCaiJi/dsh-mermaid
