Selenium39/dsh-bpmn ↗★ 1

dsh-bpmn

DeepSeek Harness bundle plugin: BPMN 2.0 visual modeler (bpmn-js) with a full workbench panel and read-only side preview.

套件
dsh-bpmn
相容性
待驗證
Harness 依賴範圍
>=0.1.1-rc.2
Cordis 依賴範圍
^4.0.1
版本
0.2.0
授權
MIT
最近更新
2026年11月9日

安裝

$npx -p @deepseek-ai/dsh dsh plugin --profile web add dsh-bpmn

dsh-bpmn

DeepSeek Harness(DSH)的 BPMN 2.0 可视化建模器插件——把 bpmn.io 的 web 建模体验带进 DSH 的 Web GUI,对标 VSCode 的 vs-code-bpmn-io 扩展。

⚠️ 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 仓库源码为准。

功能形态(双面板设计)

工作台(建模模式)侧边预览(查看模式)
场景专心画流程图边和 agent 聊天边看它生成的 BPMN
引擎bpmn-js Modelerbpmn-js NavigatedViewer(只读)
载体贴边面板 + 全屏会话上浮层卡片(Esc / 遮罩关闭)
状态✅ v0.1 已发布✅ v0.2 已发布
flowchart TD
    subgraph client["浏览器端 src/client"]
        toggle["sidebar.footer.action
入口按钮"]
        bench["BpmnWorkbench
工作台面板 shell.overlay"]
        modeler["BpmnModeler
bpmn-js 画布"]
        store["BpmnStore
文件列表/打开标签/dirty"]
    end
    subgraph host["主机端 src/index.ts (Node)"]
        rpc["/bpmn-modeler RPC channel
authority: loopback"]
        fs["工作区 .bpmn 扫描/读写
原子写 + 路径穿越防护"]
    end
    toggle -->|"openPanel"| bench
    bench --> modeler
    bench  store
    modeler |"importXML / saveXML"| store
    bench |"files/list · file/read · file/write · file/create"| rpc
    rpc --> fs

安装

dsh plugin --profile web add dsh-bpmn
# 或本地开发安装
dsh plugin --profile web add /path/to/dsh-bpmn

然后重启 dsh web,侧边栏底部会出现 BPMN 入口按钮。

开发

pnpm install
pnpm run typecheck
pnpm run build      # tsc -b 编译到 lib/ 后 tsdown 打包出 lib/client.js
pnpm run test
pnpm run lint

免安装调试

# --patch 叠加层优先级最高,适合快速迭代(注意:name 需绝对路径指向入口或包名)
dsh web --patch ./dev.cordis.yml
# 验证插件是否真的挂载(没有 row 就是组合问题,有 row 无效果才是代码问题)
dsh --profile web --dump-config

DSH rc 版没有热重载(web profile 的 HMR 被上游禁用):改代码后需要重启 dsh web;开发期把改动集中在少数文件、一切注册走 ctx,避免重启后泄漏重复注册。

路线图

  • v0.1 工作台闭环:bpmn-js Modeler 画布 + 工作区 .bpmn 新建/打开/保存(Ctrl+S)+ dirty 状态 + 属性面板
  • v0.2 侧边预览:只读 Viewer + 会话内 .bpmn 文件链接拦截点击预览 + 一键"在建模器中打开"
  • v0.3+ bpmnlint 校验、属性面板汉化、DMN(dmn-js)、agent 按图执行联动

交接与实现细节见 docs/HANDOFF.md(含 DSH 插件机制速查、待确认 API 清单和参考链接)。

License

MIT