多智能体编排atesahmet0/dh-workspace

dh-multiagents

面向 DeepSeek Harness（dsh）的多智能体编排。一支由角色绑定的智能体组成的团队——plan、build、explore、researcher、coder、scribe、reviewer——其工具由运行时能力矩阵强制执行。

为什么选择 dh-multiagents？

- 计划优先——只读编排器负责委派，绝不自己编写代码。
- 强制执行，而非建议——每个预设的工具允许列表通过 tools.restrict 应用，因此 plan 智能体在物理上无法运行 bash。
- 可审计的委派——每次 delegate 调用都会持久化一个 id（例如 daring-pearl-elk），并在磁盘上生成结果文件。
- 零配置安装——一条命令，预设 + 技能自动接好。

安装

需要 Node ≥ 22.19 以及一个 dsh 安装（@deepseek-ai/dsh@0.1.0-rc.6）。

dsh plugin --profile  init
dsh plugin --profile  add @dh-multiagents/bundle

预设会在每次启动时自动镜像（插件会将它们复制到
$DSH_HOME/.agent-presets/），因此没有安装时的步骤。

全新的 dsh CLI（npm 11）： npm 11 默认阻止依赖安装脚本——
harness 自身的原生依赖（node-pty、dsh-subprocess-local、
koffi、protobufjs）也被拦截。在无头模式能够启动之前，
请对它们运行 npm install-scripts approve。

快速开始

[!IMPORTANT]
在会话开始时选择 Plan 或 Build：
在 Web 或 TUI 界面中，在会话开始时于预设选择器中选择 plan 或 build 预设：
- plan：在开始任务时用于研究代码库并编写实现计划（委派给 explore 和 researcher）。
- build：用于执行已批准的计划（通过工作树委派给 coder、scribe 和 reviewer）。

只有 plan 和 build 充当编排器。子智能体预设（explore、researcher、coder、scribe、reviewer）通过 delegate 自动生成，不应被选为顶层会话。

headless mode needs the headless bundle (add once)
dsh plugin --profile  add @deepseek-ai/dsh-headless

DEEPSEEK_API_KEY=... dsh --profile  headless \
"Use plan_save to save a plan titled '# P' for project 'demo'. Then delegate '1+1?' to the researcher and report its answer."

对于完整的编排（delegate/build），请使用 tui 或 web 配置文件——无头会话在设计上就是无预设的，因此 delegate 在那里会被拒绝（只有 plan/build 预设可以委派）。

你将获得

| 预设 | 角色 | 值得注意的工具 |
|---|---|---|
| plan | 只读编排器 | plan_save/read, delegate → explore/researcher |
| build | 只读编排器 | delegate → coder/scribe/reviewer, worktrees |
| explore | 代码库探索者 | read, glob, grep |
| researcher | 网络研究员 | web_search, read |
| coder | 实现者 | bash, edit, write, worktrees |
| scribe | 文档撰写者 | edit, write, read |
| reviewer | 只读审查者 | read, glob, grep |
另外 5 项哲学技能（code-philosophy、code-review、plan-review、plan-protocol、frontend-philosophy）会加载到每个会话中。

运行时行为

- 委派会持久化为 $DSH_HOME/workspace//delegations/.md + .result.txt —— 事后可审计。
- 只有 plan/build 可以委派；plan → explore/researcher，build → +coder/scribe/reviewer。子代理内部不允许委派（防递归）。
- 子代理继承父代理的模型选择。

开发

pnpm install && pnpm -r build

- 命名约定： 标识符锁定在 DESIGN.md 中 —— 先在那里修改，绝不要只改代码。
- 预设/技能： 添加 presets// + 一条 CAPABILITY_MATRIX 条目（dh-common），或 skills//SKILL.md（dh-philosophy）。
- 发布： 提升版本号，然后 pnpm pack 并发布 tarball —— 直接 npm publish 会导致 workspace:* 未被解析（0.1.0 就是这样搞坏的）。

许可证

MIT