三周 11 个版本：开源 dsh-paoding v0.3 把 dsh 多智能体编排做「顺」了

之前写了篇文章介绍我写的开源 dsh 多 agent 编排插件——dsh-paoding。根据插件的实际使用情况，我一直都在稳定更新插件版本。尤其是从 9 月 18 日的 v0.3.0 到 10 月 10 日的 v0.3.10，三周多的时间发了 11 个版本，目前已经是一个相当稳定的版本了。

1 每个工作区，各配一套班底

不同的项目常常需要不同的主/子 agent 组合，比如写代码的和写文章的就需要完全区分开，写代码的需要编排、设计、调研、编码等 agent，而写文章的需要编排、大纲、调研、写作等 agent，不同的 agent 需要调用不同的 mcp 或 skill。

从 v0.3 版本开始，插件UI 界面全面改版，支持按照 dsh 的工作区进行配置：面板里注册工作区、各自生成预设主子智能体（orchestrator-<目录名>），新建会话时选对应预设即可，全局默认不受影响。不再引用的工作区预设会自动回收，不留垃圾。

2 子 agent 可续会话：干砸了，接着修

这是 v0.3 最实用的能力之一。任一角色可配置 background_mode: continuable：子 agent 活干砸了，主 agent 直接在同一个子会话里发消息让它接着修——已经积累的上下文一点不丢。默认全员 one-shot，不开就一切照旧。

配套的还有一条编排规矩：send_message 的回执是「送达确认」而不是答案，已送达的消息等回音期间绝不重发，杜绝重复委派。

3 支持 fork 启动：让帮手「看过」你们的对话

从 v0.3.8 版本开始新增角色启动方式 fork：帮手以主 agent 已完成的对话轮次为初始内容开局。像「把这份大纲做成 PPT」这类离不开上下文的委派，以前得复制粘贴一堆背景，现在直接 fork 开局。快照一次性、不继承权限，面板角色卡上就能选。

4 任务列表一眼可辨：你定义的 agent 都有谁在干活

v0.3.10 给委派加上了机制级的角色标签：委派工具执行前，任务描述自动改写为「角色名 · 原任务」——任务管理页、会话子代理目录树、后台任务列表三处统一生效。不靠提示词自觉，零配置即可用（角色配了名字才有前缀）。比如我把负责写代码的子 agent 定义为“民工码农”，在执行编程任务的过程中，可以清楚看到「民工码农 · 任务」这样的形态。

5 紧跟 dsh 版本更新的破坏性变更：两代预设机制全兼容

DSH 在 9 月里连跳了几个版本： 0.1.5 → 0.1.7 → 0.2.0，预设机制重写了两轮。dsh-paoding 用「生成期适配 + 自愈标记」跟住了每一步：

•双轨预设（v0.3.4）：旧版宿主走目录扫描，新版走声明行挂载，插件自动探测、用户无感；

•升降级自愈（v0.3.5）：只升 DSH 不动插件，预设也不会再静默消失——自愈标记从「版本」升级为「版本 + 轨道」，宿主一换代自动补齐；

•worker 换代适配（v0.3.7）：0.2.0 宿主上预设「加载失败」的问题修复，支持矩阵扩到 0.1.5 – 0.2.0-rc.2。这个版本的更新来自开源社区 GitHub 的用户贡献，再次感谢 @WeiLinCool 的 PR。

6 安装收敛到官方通道，装完重启即用

v0.2 版本提供了脚本、npx 和 dsh plugin 三种安装方式，从 v0.3 版本开始收敛为唯一安装方式：

dsh plugin --profile web add dsh-paoding

装完重启 DSH 就能用，一条后续命令都不用跑。npx 入口还在，但只做转发，内部同样走官方通道。

更关键的是「首装自愈」：编排预设缺失、或升级后版本标记对不上，插件启动时自动重新生成。从机制上消除「升级完预设还是旧版」的这种漂移。

7 面板一键升级，国内网络也稳

面板会对比 npm 上的最新版，有新版就地提示，点「升级」原地完成、重启生效。版本检测做了三级兜底：npm registry 不通就走国内镜像，再不行 GitHub Release 兜底——官方源超时或被墙时，几秒内就能测出版本。检测失败也不再装哑巴，页面会明说「没测出来」，和「没有新版」区分开。

同时，项目也加入了 awesome-dsh-plugin 和 skillhub，确保各 dsh 插件商店都能搜索和更新。

8 其他值得一提的

•工具三组展示：面板里按「基础 / MCP / 插件」分组，不再混作一团；生成端改白名单语义，停用插件后不残留死名。

•插件管理页有脸了（v0.3.6）：中文界面显示「庖丁」+ 庖丁刀徽标，英文界面显示 "Paoding"。

•desktop profile 一键升级（v0.3.8）：Electron 守卫下的升级通道单独分流，也能面板直接升。

•质量账：测试套件在 0.3 系列里从 39 项长到 105 项全绿；中文文档做过两轮全量勘误（v0.3.1），还顺手钉死了 cordis 生命周期契约的回归测试（v0.3.9）。

9 和官方内置实验性智能体团队插件的区别

从 dsh v0.1.7-rc.2 版本开始，官方内置了实验性智能体团队插件 agent-team，提供@deepseek-ai/dsh-experimental-agent-team（服务）+ dsh-experimental-tool-agent-team（工具）两个包。

这个官方内置插件把一个会话变成小团队：会话 agent 当 Lead，运行时创建具名 teammate（如 reviewer），成员互发持久消息（mailbox），共享任务板（claim/完成/依赖 DAG/CAS 防覆盖）。roster、消息、任务挺过崩溃 reload，离线成员恢复后收排队消息。但是，需要配置 dsh-session-persistence-jsonl 才能激活。

和 dsh-paoding 插件的主要区别如下：

维度

官方 agent-team

庖丁

本质

协作机制：服务 + 工具插件

预设生成器，纯配置，零源码改动

团队形态

运行时动态建具名 teammate，peer 互发消息

配置期静态定角色：一指挥 + 四帮手，主从委派

持久状态

mailbox/任务板/roster 持久化，崩溃可恢复

无团队持久状态；子会话默认 one-shot 用完即弃

任务协调

共享任务板：依赖、claim、revision CAS

harness 原生委派 + todo，无任务板

Token 目标

不以省钱为目标；peer 消息全文进 target 历史

主打成本治理：主 agent 工具面约降三分之二，帮手工具按需加载，上下文只收摘要

角色定制

无角色概念，teammate 靠 prompt 描述职责

角色各自配工具/技能/专用模型/会话模式，GUI 可改

成熟度

实验性，无稳定性承诺，限制多（单进程共享 checkout、无 worktree、不自动释放 owner）

稳定发版 0.3.5，双代宿主兼容，卸载干净

两者并不冲突，官方插件管「会话间协作协议」，庖丁管「预设生成 + 工具面/成本治理」，理论上两者是可叠加的。dsh-paoding 插件的 agent fork + continuable 实际上也参考了官方插件的实现方式。

升级方法

前置要求 DSH ≥ 0.1.5、Node ≥ 18。

已装用户：面板点「升级」，或命令行 dsh plugin update dsh-paoding，重启 DSH 生效。

v0.2 版本的老用户注意三处不兼容：

•安装只保留官方通道（旧 npx 直装的残留目录可删）；

•配置键 main_agent_name 换成 main_agent_display_name；

•交互式向导已移除，可视化配置一律走「庖丁配置」面板。

欢迎 issue 与 PR：使用中发现问题、想要新的角色、或发现文档与实现不一致，都可以提。