前言¶
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 仓库。
