pi-durable-subagents
在显式所有者和产卵者监督下异步协作的持久Pi代理。
功能
交互代理切换
运行 /agents 从业主或任何代理打开代理切换器。使用 /agents owner 在不打开切换器的情况下直接返回到确切安装的Workflow Owner演示：
选择一个子代理以进入其完整的Pi会话并直接与之交互——读取其记录、在其编辑器中输入或使用其命令和工具。在全屏模式下，单击编辑器上方的活动dock会打开相同的切换器。
协调与监督
- Owner-directed工作流: 当前Pi会话，在TUI或无头模式下，成为持久的工作流所有者。分叉或克隆到一个新的，独立的工作流。看到 老板工作流程.
- 持久子代理： 代理创建可配置的、上下文独立的子节点
agent_spawn． 看到 代理产卵. - 消息传递和请求：
agent_message发送消息和标题请求；agent_wait加入他们的答案。看到 代理信息. - 可见的义务:
agent_observe列出并检索未完成的请求。 - 人类的决策: 在TUI中，生成的Agent可以阻塞一个自由形式的Human Answer
ask_user． 看到 人类的请求. - 运行监督: 所有者和直接产卵者检查，中断，恢复，或中止精确运行
agent_observe和agent_control． 看到 运行监督. - 事件处理: 运行时提醒恢复被遗忘的答案；隔离的版主在策略范围内处理持久的停滞、死锁和失败。看到 操作事件缓和.
- 持久的复苏: 一个新的主机重建权威和来自Pi转录的待处理请求。看到 主机冷恢复.
- 模型的政策:
/agents models维护一个持久的拒绝列表，列出孩子不能使用的模型。看到 工作流策略. - 虚拟模型: 一次命名一个有序的模型后备列表并使用
virtual/<name>在模板和刷出；修复列表更新每个Agent。在/agents配置选项卡(c）. 看到 虚拟模型.
协调不会覆盖Pi的压缩、重试或传输设置。
持久的义务
请求创建一个应答义务，在提交应答或收到请求者的取消请求之前，应答者需要承担该义务。停止、恢复或失败Run，或者人为地在子进程中输入，都会使它保持打开状态，而普通的Message则不会创建任何状态。当有义务的代理停止时，主机会发送一个提醒（如果在人工输入时停止，则会发送一个免费提醒），然后启动一个Moderator，该Moderator可以进行干预或升级到Workflow Owner。看到 代理信息 和 操作事件缓和.
安装
从npm安装：
pi install npm:@xian0x5a/pi-durable-subagents
或者直接跟踪Git存储库：
pi install git:github.com/xian0x5a/pi-durable-subagents
附加终端支持使用 node-pty 本地插件。它为x64和arm64上的Linux、macOS和Windows提供了预构建的二进制文件，因此这些平台不需要在安装时构建。其他平台从源代码编译它，它需要一个c++工具链和npm权限来运行它的安装脚本。
使用
启动交互式Pi TUI：
pi
包采用当前会话作为工作流所有者；不需要单独的激活命令。
无头模式也承载所有者，没有人在循环中：
pi -p "Delegate the review to two agents and summarize their answers"
pi --mode json "..."
pi --mode rpc
在无头工作流中，代理不能使用 ask_user； 相反，他们会通过上级向上级投诉。当一个孩子的Run暂停时，它的主管会得到通知。代理选择器、代理视图和活动dock需要TUI。报表存储在会话中，因此以交互方式重新打开它(pi --session <file>)来阅读它们。看到 无头的工作流.
建议的代理模板
模板是创建预设：编辑只适用于未来的刷出。看到 代理模板 查看配置细节。
下面两个模板都使用了一个 虚拟模型因此，退役或禁用的模型被固定在一个地方。 thinking: preset 在自己的级别上运行每个条目。把它加入 /agents 配置选项卡(c)，或 ~/.pi/agent/config/pi-durable-subagents.json：
{
"virtualModels": {
"cheap": [
{ "id": "openai-codex/gpt-6-luna", "thinking": "high" },
{ "id": "deepseek/deepseek-v4-flash", "thinking": "high" }
]
}
}
cheap-delegate
对于有界实现、例程执行和有针对性的事实查找，这是一个经济高效的默认值。
另存为 ~/.agents/agents/cheap-delegate.md：
---
name: cheap-delegate
useWhen: >-
Use as a cost-efficient default delegate for tasks with clear goals and
verifiable outcomes, such as implementation with explicit requirements or
instructions and bounded scope, routine execution, or targeted fact-finding.
Do not use for thorough review, open-ended investigation, high-stakes security
or architecture work, or tasks requiring substantial ambiguity resolution.
If its results remain inadequate after several iterations and show no obvious
improvement, stop assigning that task to this template.
models:
- id: virtual/cheap
thinking: preset
---
moderator
自动用于事件处理；把它指向更便宜的型号。
另存为 ~/.agents/agents/moderator.md：
---
name: moderator
useWhen: Use for moderation and incident response.
models:
- id: virtual/cheap
thinking: preset
---
兼容性
Pi提供了包的Pi对等模块；根据正在运行的主机在结构上检查兼容性。需要Pi 0.99.0或更新版本，这是第一个带有本地虚拟模型的版本。看到 开发 负责一致性检验和监督测试运行。
信任与坚持
协调是基于信任的协议，而不是安全边界。所有者、刷出者、普通代理和版主是可信任的参与者，通过角色作用域工具进行操作。
Pi抄本是标识、消息、请求、交付和提交结果的持久权威。调度队列、保持、实时运行状态、UI关注和打开的代理视图附件是不稳定的：有序关闭会关闭它们，而突然的进程丢失可能会丢弃它们，而不会声明持久完成。
文档
- 老板工作流程 -激活，无头工作流和兼容性行为
- 业主堵塞诊断 -持久的准入失败状态和
/agents diagnostics - 转录修复设计 -建议的工作流程自有修理慢化剂和已验证的更换；没有实现
- 操作事件缓和 —触发检测、有界处理、Moderator权限、Resolution和恢复
- 主机冷恢复 -记录发现、隔离、休眠名册和剩余请求
- 工作流策略 -可重新加载执行，交付，审查限制
/agents models排除列表和虚拟模型 - 代理产卵 -子创建和接收语义
- 代理信息 —交付方式和Agent Requests
- 人类的请求 -转录原生问题，回答模式和承诺
- 代理选择器 —活动层次、休眠近因、关注和键盘导航
- 交互式代理视图接受 -完整模式渲染、输入、转换、隔离和生命周期证据
- 运行监督 —观察、中断、恢复、中止和代理视图保留
- 开发 -兼容性门，有监督的测试运行和截止日期