前言¶
在 DeepSeek Harness（DSH）裏寫流程圖、時序圖時，習慣用 Markdown 的 ```mermaid 圍欄。默認情況下，會話裏只會顯示源碼：flowchart TD、節點和箭頭都要自己在腦子裏還原，區域又窄，複雜圖很難看清；要把源碼拷出去，也只能手動框選。
dsh-mermaid 是社區維護的客戶端（Web）插件，裝好後會把會話裏的 mermaid 代碼塊畫成圖，並在工具條裏提供源碼切換、全屏與複製。下面介紹它做什麼、怎麼裝、用起來長什麼樣。
這是什麼¶
- 名稱：dsh-mermaid（npm 包名
@dsh-external/dsh-mermaid，當前資料版本0.1.0） - 維護者：zach-bworld
- 分類：DSH 客戶端插件（
dsh.client.platform爲web） - 許可證：MIT
- 目錄頁：skillhub.cn/plugins/zach-bworld/dsh-mermaid
- 源碼：github.com/zach-bworld/dsh-mermaid
一句話：把會話內 Markdown 裏 ```mermaid 圍欄直接渲染成圖，源碼仍一鍵可看、可拷。
DSH 生態強調「一切皆插件」；SkillHub 等目錄是社區站點，與 DeepSeek / 幻方無官方從屬關係，安裝前建議自行查看倉庫源碼與許可證。
核心功能¶
以下能力均來自項目 README 說明：
- 自動渲染：進入會話即可看到流程圖等圖示，無需額外點擊「渲染」按鈕。
- 圖 ↔ 源碼切換：工具條提供「查看源碼」「查看圖示」，在同一代碼塊上切換。
- 放大全屏：工具條「放大」，支持滾輪縮放、拖動平移，便於看細節。
- 複製源碼：工具條「複製源碼」，一鍵複製 mermaid 原文。
實現原理、調試與已知限制見倉庫內 docs/implementation.md。
安裝與啓用¶
插件以當前 DSH 進程權限運行；安裝前請確認你信任該倉庫與 MIT 許可條款。
桌面端 App（推薦）¶
桌面端的 profile 由 Electron 應用獨佔管理，不要在 PowerShell 裏對 desktop profile 執行 dsh plugin add，否則會報 profile "desktop" is managed exclusively by the Electron application。
- 打開左側欄最下方的 插件。
- 點 安裝，粘貼安裝地址（這是地址，不是 shell 命令）：
https://github.com/zach-bworld/dsh-mermaid
以下寫法效果相同：github:zach-bworld/dsh-mermaid、git@github.com:zach-bworld/dsh-mermaid.git，或本地 clone 後的目錄絕對路徑。
- 在列表中 啓用 插件。
- 刷新頁面（Ctrl+R）或重開窗口；客戶端 bundle 需刷新後纔會加載。
命令行 / Web 端¶
將 web 換成你實際使用的 profile 名（常見爲 web、tui、headless）：
dsh plugin --profile web add github:zach-bworld/dsh-mermaid
裝完後刷新頁面。
指定版本示例：
dsh plugin --profile web add github:zach-bworld/dsh-mermaid#v1.0.0
卸載（命令行）：
dsh plugin --profile web remove @…/dsh-mermaid
桌面端也可在 App 插件頁直接移除。
裝不上時的對照¶
| 現象 | 處理 |
|---|---|
命令行報 managed exclusively |
改用 App 內插件頁安裝 |
| 裝完沒反應 | 刷新頁面或重開窗口 |
| 提示找不到包 | 檢查拼寫：github:zach-bworld/dsh-mermaid（冒號、斜槓均不可少） |
典型用法¶
無需單獨配置項：在 DSH 會話的 Markdown 裏照常寫 mermaid 圍欄即可。例如：
```mermaid
flowchart TD
A[開始] --> B{判斷}
B -->|是| C[結束]
B -->|否| A
```
啓用插件並刷新客戶端後，該塊會顯示爲圖；需要改語法時用工具條切回源碼，改完仍可再看圖示。複雜圖用「放大」在全屏裏縮放、平移查看。
適用場景與注意¶
適合誰：經常在 DSH 裏讓模型輸出或自己粘貼 Mermaid 流程圖、序列圖、類圖等，希望會話內即看即改的開發者或智能體使用者。
注意：
- 插件類型爲 Web 客戶端，行爲與會話 UI 綁定；非服務端邏輯插件。
- 資料中未列出額外配置文件字段，主要依賴 Cordis patch 注入客戶端；細節見 implementation 文檔。
- 社區目錄星標等統計會變動，以 GitHub 與目錄頁爲準。
結尾¶
dsh-mermaid 解決的是 DSH 會話裏 Mermaid 只顯示源碼、難放大、難複製的問題：裝上並刷新後，圍欄自動成圖，工具條負責源碼、全屏與複製。
- 目錄頁：https://www.skillhub.cn/plugins/zach-bworld/dsh-mermaid
- GitHub：https://github.com/zach-bworld/dsh-mermaid
