dsh-paoding
庖丁 — DSH (DeepSeek Harness) 编排模式安装器：host 感知的角色工具过滤 + Web 设置页可视化配置器
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-paoding@0.3.2
Paoding 以 dsh-paoding 发布，当前版本为 0.3.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English · 中文
庖丁解牛，游刃有余 —— 把 DSH 调教成一支分工明确、按需加载的 agent 小团队。
dsh-paoding（中文品牌「庖丁」，典出《庄子》——庖丁顺纹理下刀，刀刃十九年若新发于硎）是 DSH（DeepSeek Harness agent 运行时）的预设生成器。DSH 原本是一个 agent 包揽约 60 个工具、每次请求全量加载；装上庖丁后变成「一个指挥 + 四个帮手」——主 agent 只带编排与内部搜索的精简工具，其余的活按角色委派给只带本行工具的子 agent。全部靠配置完成，零 DSH 源码改动。
html-ppt 技能的 PPT 帮手），之后一句「把这份大纲做成 PPT」就有人接活。配置文件、图形界面两个入口都能建。send_message 在同一个子会话接着修，不用从头重派；默认全员一次性（one-shot）用完即弃，不开启就一切照旧。orchestrator-<目录名>），新建会话时选对应预设即可，全局默认不受影响。dsh plugin update dsh-paoding（profile 自动探测）换上新版，重启 DSH 后生效，编排预设会在重启时按新版自动重生成。开发检出的 link 形态无法就地升级，面板会提示切回 registry 版的办法；检测失败（比如断网）就静默跳过，不影响任何使用。前置：Node.js ≥ 18、pnpm 与一台已装好的 DSH host（@deepseek-ai/dsh ≥ 0.1.5，最低支持版本）。
官方插件通道（唯一安装入口）——不用克隆仓库，一条命令，装完重启即用：
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 按配置应用，没有则写基础模板），无需再点任何按钮。新会话的预设选择器里选「编排模式 (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-*
开发检出自装——想改插件或预设源码时，用 link 形态直连仓库（改动经 HMR/重启生效）：
git clone https://github.com/lifangjin/dsh-paoding.git
dsh plugin --profile web add link:"$PWD/dsh-paoding"
升级走面板「升级」按钮（等价 dsh plugin update dsh-paoding）。详细步骤、升级与排查见 安装文档。
给主 agent 派活即可，它按分工自己路由：
search_external，只带联网工具、不改文件）；design，可加载设计技能，出 spec 不写最终代码）；implement，改完自验再汇报）；search_internal_deep，只读、无网络，只回浓缩摘要）；帮手干活期间，主 agent 可以随时追问、查看进度、叫停；结束后只把摘要收进上下文，不把帮手的完整过程倒进来。任务失败怎么恢复、怎么多轮迭代，见 编排文档。
所有偏好都写在 ~/.dsh/dsh-paoding.config.yml：角色增删改、技能分配、专用模型、会话模式（one-shot / continuable）、主 agent 的工具与技能……改完打开左侧栏底部的「庖丁配置」入口，点「保存并应用」即同步生效。预设每次由「静态源 + 配置」重新生成，不攒手工补丁。全部配置键说明见 配置文档；背后机制与成本账见 架构文档。
| 文档 | 内容 |
|---|---|
| 架构 | 为什么这样设计——概述、成本账、角色与工具、对应 DSH 原生机制、Token 治理、已知边界。 |
| 安装 | 官方插件通道一条命令安装、首装自动化与版本标记、升级、开发检出自装、host patch 检测机制、庖丁配置面板、卸载、排查。 |
| 编排 | 编排总览、失败如何呈现与三层处理、one-shot vs continuable、上下文隔离。 |
| 配置 | 配置键全参考、内置角色微调、主 agent 工具与技能、自定义角色、按角色分模型、角色会话模式。 |
欢迎 issue 与 PR：使用中发现问题、想要新的角色、或发现文档与实现不一致，都可以提。动手前请先读 架构 与 配置；文档与实现冲突时，以 presets/orchestrator/ 与 tools/ 源码为准。
以 MIT License 发布，完整条款见仓库根目录的 LICENSE 文件。