dsh-paoding（庖丁解牛）

English · 中文

庖丁解牛，游刃有余 —— 把 DSH 调教成一支分工明确、按需加载的 agent 小团队。

dsh-paoding（中文品牌「庖丁」，典出《庄子》——庖丁顺纹理下刀，刀刃十九年若新发于硎）是 DSH（DeepSeek Harness agent 运行时）的预设生成器。DSH 原本是一个 agent 包揽约 60 个工具、每次请求全量加载；装上庖丁后变成「一个指挥 + 四个帮手」——主 agent 只带编排与内部搜索的精简工具，其余的活按角色委派给只带本行工具的子 agent。全部靠配置完成，零 DSH 源码改动。

功能特性

• 一支分工明确的小团队：主 agent 当指挥，拆解任务、分派验收；联网调研、UI 设计、写代码、全仓深搜四位专属帮手各司其职，随叫随到、干完即走。
• 高频小事不过手他人：找代码、查引用、读文件这类顺手的事，主 agent 自己直接办，不绕委派的圈子。
• 可招募专属帮手：内置四角色只是起点——给新角色配好工具和技能（比如装上 html-ppt 技能的 PPT 帮手），之后一句「把这份大纲做成 PPT」就有人接活。配置文件、图形界面两个入口都能建。
• 帮手还能指定专用模型：写代码的用强档、查资料的用轻快档，各配各的模型；不配就跟随主 agent 当前会话的模型。
• 帮手能继承对话开工：把某个角色的「启动方式」切成继承对话（fork），帮手带着主 agent 已完成的对话轮次直接开工，省得在委派时把上下文复述一遍；默认全员全新启动，不开启就一切照旧。
• 帮手能就地续修：把某个角色的「会话模式」切成可续（continuable），活干砸了或干得不满意，主 agent 用 send_message 在同一个子会话接着修，不用从头重派；默认全员一次性（one-shot）用完即弃，不开启就一切照旧。
• 省钱省上下文：帮手的工具只在被叫到时才加载，用一次付一次；主 agent 每次请求的工具开销约降三分之二，上下文只收摘要，不再被搜索结果和代码改动撑爆。
• 角色随改随用：删掉用不上的内置角色、给角色改显示名、给主 agent 配显示名，都是配置里一行的事；配了显示名的角色，派出的子代理标签自动带上角色名（「民工码农 · 修复标签显示」），任务管理页、子代理目录树、后台任务列表一眼可辨。改完在面板点一次「保存并应用」，预设即时重生成，重启 DSH / 新建会话后生效。
• 装了什么都能认出来：MCP 服务器、本地插件、已装技能，安装与配置时全程检测；默认只装 dsh 基础工具，检测到的 host 工具在「庖丁配置」里按需勾选；停用哪个，重新应用后相关工具自动剔除。
• 按工作区各有各的班底：不同项目可以配不同的主/子 agent——「庖丁配置」里选定工作区单独配置，每个工作区生成自己的预设（orchestrator-<目录名>），新建会话时选对应预设即可，全局默认不受影响。
• 图形界面配置：不习惯改配置文件的话，点开左侧栏底部动作条（设置行上方）的「庖丁配置」入口，整页点选即可，「保存并应用」即时重生成预设——与首装自动化同一条生成管线。
• 工具条目支持通配符：* 与 ? 在生成期展开成具体工具名——mcp__tavily__tavily_* 一行顶五行，MCP 工具族不必逐个点名；零匹配有提醒，产物与运行时行为不变。
• 保存前先体检：预览/应用时自动过一遍检查——配置了但未挂载的工具、零工具角色、查无此名的模型、预设落后于配置，分级提示一目了然；预览还顺带列出「本次变更」逐项明细与主 agent 工具面瘦身统计，改了什么、省了多少都在明面上。CLI 侧 dsh-paoding doctor 六项只读自检（配置可解析、安装轨道、声明行托管块、孤儿目录、版本标记、预设漂移），一条命令查全身；--fix 自动修孤儿目录与过期声明行两类安全项。
• 场景模板一键换班底：轻量（只留实现）、调研（只留检索）、全开（全员到齐、主 agent 带满检测库存）三档点一下就切，只动「谁在场 + 主 agent 额外带什么」，精调过的角色配置分毫不动。
• 配置可导出可导入，还有后悔药：面板「更多」菜单一键下载 dsh-paoding.config.yml，换机迁移、备份整份拷走；导入先验格式，覆盖整体配置（含工作区段）需二次确认。每次写盘前自动轮换备份三份，「恢复备份」二次确认即回退，误操作不用翻文件。
• HTTP 接口直连配置：预设的列举、新增、更新、删除走 /api/paoding/presets 四条接口，随 DSH Web 服务同进程挂载、本机回环直调；与面板「保存并应用」同一条生成管线、同一把写盘互斥闸——脚本和自动化工具改班底，不必开浏览器。
• 面板中英双语：界面文案 zh/en 全覆盖，语言自动识别（显式选择 → 中文信号优先：浏览器语言、宿主页面语言、中文时区），「更多」菜单一键切换并记住。
• 版本更新有提醒，面板一键升级：面板会对比 npm registry（npmmirror 镜像、GitHub release 依次兜底）上的最新版本，发现新版就地提示并附上发布页链接；点「升级」就地换上新版（profile 自动探测：普通 profile 走 dsh plugin update dsh-paoding；desktop profile 被 dsh CLI 的 Electron 专属守卫挡住，改在 profile 目录直跑 pnpm add dsh-paoding@<版本>，pnpm 找不到时自动回落 corepack pnpm），重启 DSH 后生效，编排预设会在重启时按新版自动重生成。开发检出的 link 形态无法就地升级，面板会提示切回 registry 版的办法；检测失败时页头留一行「版本检测失败 · 重试」（完整原因与代理排查提示在悬浮提示里），不弹窗打扰。
• 委派效果可量化：面板「委派效果」卡按角色统计调用数、平均耗时与失败数（近 30 天），数据读宿主会话存档本地聚合——哪个角色用得多、哪个常掉链子，一眼可见；缺省项目（宿主 cwd 换算）扫不到任何委派记录时自动回落为全项目聚合（卡片标注「全部项目」），冷读带日志 mtime 预过滤，窗口外的日志文件不再开读句柄。
• 来去自由：不改 DSH 一行源码；装完新会话即用，卸载即删目录。
• 两代宿主都兼容：DSH 0.1.5 – 0.2.1 全支持（0.1.5 / 0.1.6 / 0.1.7-rc.1 / 0.1.7-rc.2 / 0.2.0-rc.1 / 0.2.0-rc.2 / 0.2.1-rc.2+）——两代宿主发现预设的机制不同（目录扫描 vs patch 声明行），安装器自动检测宿主版本选对落点；编排组合里的 workflow worker 行也按宿主版本自动适配（0.1.5 用 workflow-worker-thread，0.1.6+ 换 workflow-ptc——旧包 0.1.6 起已删除，残留行正是 0.2.0 面板上「加载失败」的元凶）；DSH 0.2.1 起角色委派行同步换代（0.2.1 的 dsh-tool-subagent 拒绝内联 persona/toolFilter——人设与工具面改挂各角色的 AgentPreset，spawn 子代理按 agentPreset 选择子预设；0.2.0 及以下保持内联形状），宿主升级、降级后的首次保存/自愈自动迁移（工作区专属预设 orchestrator- 随同轮自愈一并换代），全程无感；0.2.1 的 prerelease 再细分——tool-subagent 守卫自 0.2.1-rc.2 落地，rc.0/rc.1 仍按内联形状生成。

插件截图

快速开始

前置：Node.js ≥ 18、pnpm 与一台已装好的 DSH host（@deepseek-ai/dsh 0.1.5 – 0.2.1 全支持，预设落点与角色委派行形态自动适配宿主版本）。

官方插件通道（唯一安装入口）——不用克隆仓库，一条命令，装完重启即用：

dsh plugin --profile web add dsh-paoding

等价捷径：npx dsh-paoding@latest（内部转成上面这条命令，默认 profile web，需本机已装 dsh）。npx 拉到哪版就装哪版：实际安装的是 dsh-paoding@<npx 拉取到的版本>。

dsh plugin 是 pnpm 的透明转发器：包被 pnpm 装进 profile，包内声明的 bundle patch 把「庖丁配置」面板挂进 DSH Web 左侧栏。**重启 DSH（dsh web）**即完成全部安装——插件启动时会自动检测，编排预设缺失或版本不符就自动生成一次（有 ~/.dsh/dsh-paoding.config.yml 按配置应用，没有则写基础模板），无需再点任何按钮。DSH 0.1.7 起宿主改用 patch 声明行发现预设，插件会自动改写登记方式，装法不变。新会话的预设选择器里选「编排模式 (Orchestrator)」即可；要设为默认，在 Settings → Agent Presets 里选。

开箱默认只带 DSH 自带的基础工具，检测到的 MCP/host 工具不会自动写入——装完点开左侧栏的**「庖丁配置」**按需勾选工具与角色，「保存并应用」即生效。不想要了，三条命令卸干净（按工作区配置生成的各工作区预设也一并删除）：

dsh plugin --profile web remove dsh-paoding
rm -rf "${DSH_HOME:-$HOME/.dsh}/.agent-presets/orchestrator"
rm -rf "${DSH_HOME:-$HOME/.dsh}/.agent-presets"/orchestrator-*

宿主是 DSH 0.1.7+ 时再补一步：删去 ~/.dsh/cordis.patch.yml 里的 dsh-paoding 托管块（带 auto-generated 起止标记），免得留下指向已删目录的声明行（详见安装文档第 7 节）。

开发检出自装——想改插件或预设源码时，用 link 形态直连仓库（改动经 HMR/重启生效）：

git clone https://github.com/lifangjin/dsh-paoding.git
dsh plugin --profile web add link:"$PWD/dsh-paoding"

升级走面板「升级」按钮（普通 profile 等价 dsh plugin update dsh-paoding；desktop profile 则在 profile 目录直跑 pnpm add 精确版本，无裸 pnpm 时自动用 corepack pnpm）。详细步骤、升级与排查见 安装文档。

怎么用

给主 agent 派活即可，它按分工自己路由：

• 找代码 / 查引用 / 读文件 → 主 agent 自己办，不委派；
• 联网查资料、做调研 → 联网调研帮手（search_external，只带联网工具、不改文件）；
• 出界面方案、设计稿 → 设计帮手（design，可加载设计技能，出 spec 不写最终代码）；
• 写代码 / 改代码 → 实现帮手（implement，改完自验再汇报）；
• 超大仓库全仓探索、大文件通读 → 全仓深搜帮手（search_internal_deep，只读、无网络，只回浓缩摘要）；
• 专属活（比如做 PPT）→ 先建自定义角色，之后随叫随到。

帮手干活期间，主 agent 可以随时追问、查看进度、叫停；结束后只把摘要收进上下文，不把帮手的完整过程倒进来。任务失败怎么恢复、怎么多轮迭代，见 编排文档。

配置

所有偏好都写在 ~/.dsh/dsh-paoding.config.yml：角色增删改、技能分配、专用模型、会话模式（one-shot / continuable）、启动方式（fresh / fork）、主 agent 的工具与技能……改完打开左侧栏底部的「庖丁配置」入口，点「保存并应用」即同步生效。预设每次由「静态源 + 配置」重新生成，不攒手工补丁。全部配置键说明见 配置文档；背后机制与成本账见 架构文档。

偏好走脚本的，还有一套 HTTP 接口：/api/paoding/presets 覆盖预设的列举 / 新增 / 更新 / 删除，随 DSH Web 服务同进程（端口即浏览器打开 DSH 的那个端口），本机回环直调即可：

curl http://127.0.0.1:19387/api/paoding/presets

写操作与面板「保存并应用」同一条生成管线与写盘互斥。方法、请求体与错误语义见 配置文档第 13 节。

文档

贡献

欢迎 issue 与 PR：使用中发现问题、想要新的角色、或发现文档与实现不一致，都可以提。动手前请先读 架构 与 配置；文档与实现冲突时，以 presets/orchestrator/ 与 tools/ 源码为准。

许可

以 MIT License 发布，完整条款见仓库根目录的 LICENSE 文件。