Herdr 附加组件
Herdr 把编码代理放进窗格中,既可在你的机器上,也可在它通过 SSH 连接到的机器上。这个附加组件让 Deep Work Plan 把这些代理当作对等方来使用:计划可以把一项有边界的任务交给另一个窗格中的代理,接收恰好一条获授权的回复,并保留这次交互的记录。
它是 DWP v7(v7.0.0)的一个可选附加组件。没有它,方法论的运作方式完全相同:附加组件缺失或被禁用时,每项任务都在当前会话中运行,与以往完全一样。
它集成了什么
该附加组件是一个轻量的集成层。实际工作由 herdr-peers 完成,它是一个独立的 MIT 技能,固定在 v0.1.0,脱离 Deep Work Plan 也能使用。它定义了 Herdr 本身留白的部分:谁可以回答,答复如何跨机器返回,两个代理如何避免无休止地互相回答,以及“我提问、它回答”的记录存放在哪里。
| 项目 | 值 |
|---|---|
| 产品 | DailybotHQ/herdr-peers,标签 v0.1.0,协议 1 |
| 注册表键 | .dwp/config.json 中的 herdr |
| 传输方式 | 交互式:Herdr 窗格中的一个对等方 |
| 提供 | subagents、cancel_children |
| 要求 | 计划契约中的 agent_delegation 授权 |
安装
安装 herdr-peers 及其所依赖的 Herdr 官方技能。凡是其代理需要作答的机器,也都需要安装该技能。
npx --yes skills add https://github.com/DailybotHQ/herdr-peers/tree/v0.1.0 --skill herdr-peers -g -y
npx --yes skills add https://github.com/herdrdev/herdr/tree/v0.9.3 --skill herdr -g -y
要求:Herdr 0.9.1 或更新版本、bash,以及 python3 3.9 或更新版本(仅使用标准库)。接入流程会提供该附加组件,并把你的回答记录在附加组件注册表中;未经同意,它绝不会被启用。
它为计划添加了什么
- 委派给对等方。 在契约授予
agent_delegation的 v7 计划中,execute可以把一项parallel_safe任务或一个只读问题,交给另一个窗格中的代理,无论该代理在本机还是在另一台机器上。 - 一条获授权的回复。 请求带有一个戳记,只授权恰好一条答复。对等方通过辅助程序回复一次,回复本身也带有自己的戳记。
- 先记录,后依赖。 每次委派都会在回复被使用之前写入计划的
analysis_results/delegations.ndjson,并对应 v7 的delegation日志事件。 - 结果在核验前仍是声明。 对等方的答复在计划自身的门控运行器观察到它之前,都属于
asserted证据。它绝不会独自关闭一项任务。
安全模型
| 规则 | 含义 |
|---|---|
| 先有授权 | 仅当计划契约授予 agent_delegation 时才会进行委派。 |
| 深度上限 1 | 带有 depth=1 或 reply-to= 戳记的消息绝不会被回答,被委派者也绝不会再委派。 |
| 扇出上限 | 默认情况下,每个调用方最多四个对等方。 |
| 是数据,不是指令 | 回复绝不会授予接收方原本没有的权限。 |
| 每条路径一个写入者 | 会写入文件的对等方在自己的 git worktree 中工作。 |
herdr-peers 不对发送方进行身份验证:戳记中的 from= 字段只是一项声明。缓解措施是 HERDR_PEERS_SCOPE 允许列表,它限定了对等方所接受的工作区和机器。
Herdr 还是 agentkit
两个附加组件实现同一个委派接口——launch、observe、collect、cancel——但使用不同的传输方式。
| 情形 | 使用 |
|---|---|
一项有边界、声明了输出的 parallel_safe 任务 |
agentkit(在 worktree 中以无头方式运行 ak run) |
| 任务需要交互、运行时间长,或位于另一台机器上 | Herdr(窗格中的一个对等方) |
备注
可选且绝非必需。一个仓库在不带任何可选附加组件时即完全符合规范,也没有任何流程依赖这个附加组件。双窗格、跨机器的往返由针对模拟 Herdr 的测试覆盖;请为首次运行安排有人监督。