前言¶
DeepSeek Harness（DSH）把智能體、工作區與 Web 界面收進同一套「一切皆插件」的運行時。流程或業務編排若落在磁盤上的 .bpmn 文件，常見做法是離開 DSH 用獨立編輯器改圖，再回會話裏對照文本；與 agent 協作時也不方便在聊天流裏直接看圖。下面介紹社區插件 dsh-bpmn（維護者 Selenium39，分類：工作流），把 bpmn.io 的 web 建模體驗嵌進 DSH Web GUI，並對標 VS Code 的 vs-code-bpmn-io 擴展思路：在工作區內掃描、打開、編輯 .bpmn，經 loopback RPC 做原子保存。
需知：DSH 仍處於 0.1.x-rc 開發者預覽階段，slot / manifest API 可能在候選版本間變動。插件基於 dsh 0.1.1-rc.2 類型對照開發（2026-11-09），在 dsh 0.1.0-rc.6 運行時完成文件列表、打開、編輯、Ctrl+S 保存、重開、新建、屬性面板等全鏈路實測。API 漂移時以當天 deepseek-harness 倉庫源碼爲準。
這是什麼¶
dsh-bpmn 是 DSH 的 BPMN 2.0 可視化建模器插件：瀏覽器端由 bpmn-js 驅動畫布與預覽，主機端 Node 模塊通過 /bpmn-modeler RPC 通道（authority: loopback）對工作區 .bpmn 做掃描與讀寫，並帶原子寫與路徑穿越防護。當前包版本 0.2.0，許可證 MIT。插件在 SkillHub 目錄 與 GitHub：Selenium39/dsh-bpmn 可查；目錄與 DeepSeek / 幻方無官方從屬關係，屬社區生態條目。
雙面板能力（v0.1 / v0.2）¶
插件按場景拆成兩種界面，共用同一套文件與 RPC 鏈路：
| 工作臺（建模模式） | 側邊預覽（查看模式） | |
|---|---|---|
| 場景 | 專心畫流程圖 | 邊和 agent 聊天邊看其生成的 BPMN |
| 引擎 | bpmn-js Modeler |
bpmn-js NavigatedViewer（只讀） |
| 載體 | 貼邊面板 + 全屏 | 會話上浮層卡片（Esc / 遮罩關閉） |
| 狀態 | v0.1 已發佈 | v0.2 已發佈 |
v0.1 工作臺閉環（路線圖已勾選）：bpmn-js Modeler 畫布、工作區 .bpmn 新建/打開/保存（Ctrl+S）、dirty 狀態、屬性面板。
v0.2 側邊預覽（路線圖已勾選）：只讀 Viewer；會話內 .bpmn 文件鏈接點擊可預覽；支持一鍵「在建模器中打開」。
客戶端大致數據流：側邊欄底部入口 → BpmnWorkbench 面板 → BpmnModeler 與 BpmnStore（文件列表、打開標籤、dirty）；經 files/list、file/read、file/write、file/create 與主機端 RPC 對接工作區文件系統。
安裝與啓用¶
在已安裝 DSH 且使用 web profile 的機器上，按 README 原文執行：
dsh plugin --profile web add dsh-bpmn
本地開發或直接指向源碼目錄時：
dsh plugin --profile web add /path/to/dsh-bpmn
安裝後重啓 dsh web，側邊欄底部會出現 BPMN 入口按鈕。
package.json 中聲明的運行時要求包括：node 爲 ^22.19 || >=24，dsh 爲 >=0.1.1-rc.2。插件以當前 dsh 進程權限 讀寫工作區；安裝前宜自行查看倉庫源碼與 MIT 許可證。
典型用法¶
- 執行上述安裝命令並重啓 Web 界面。
- 點擊側邊欄底部 BPMN 入口，在工作臺中瀏覽工作區
.bpmn列表，新建或打開文件，在 Modeler 中編輯。 - 使用 Ctrl+S 保存； dirty 狀態由前端 store 管理，保存經 loopback RPC 原子寫入。
- 在會話裏點擊
.bpmn鏈接時，可用 v0.2 只讀預覽浮層查看；需要改圖時用「在建模器中打開」回到工作臺。
免安裝疊加調試（改插件代碼時用）：
dsh web --patch ./dev.cordis.yml
dsh --profile web --dump-config
README 說明：--patch 疊加層優先級最高；無對應 row 多爲組合問題，有 row 無效果再查插件邏輯。DSH rc 版 沒有熱重載（web profile 的 HMR 被上游禁用），改代碼後需重啓 dsh web。
開發與路線圖¶
克隆或下載源碼後，常用腳本爲：
pnpm install
pnpm run typecheck
pnpm run build
pnpm run test
pnpm run lint
build 爲 tsc -b 編譯到 lib/ 後由 tsdown 打出 lib/client.js。交接與 DSH 插件機制細節見倉庫內 docs/HANDOFF.md。
尚未交付的路線圖項包括：bpmnlint 校驗、屬性面板漢化、DMN（dmn-js）、agent 按圖執行聯動（v0.3+）。
結尾¶
dsh-bpmn 把 BPMN 2.0 的可視化編輯與只讀預覽放進 DSH Web GUI，並與工作區 .bpmn 文件和 loopback RPC 保存閉環對齊，適合需要在 Harness 工作區內直接維護流程圖、並在會話旁查看 agent 產出 BPMN 的開發者。更多信息見 SkillHub 目錄頁 與 GitHub 倉庫。
