子代理

把目标清楚、范围独立的子任务交给不同角色，主代理负责派发、判断和汇总。有独立工作就继续做；没有时结束当前轮，等待子代理通知，不要反复查询或用等待命令占住流程。

它是怎么工作的

助手用 agent 指定角色、任务说明和简短标题，启动一个独立子会话。不会自动复制主会话的完整聊天，派发时应说明目标、范围、已有结论和需要返回什么。

子代理拥有独立对话，但仍使用同一个项目目录，不是文件沙箱。派发时划清文件和职责范围，避免多个代理修改重叠内容。

按任务选择角色

• dev：修改代码或文件，返回改动与验证结果。
• explore：快速、只读地探索现有代码，为开发提供线索；核心逻辑由主代理复核，不代替开发后的代码审查。
• research：检索外部资料与源码，返回研究结论和证据，不承担开发实现。

以上是公开内置角色，实际可用名单以你的角色配置和当前能力模式为准。

从派发到拿回结论

先安装插件 @jetcrab/pi-desk-subagent，按提示加载；已有会话需要更新工具时，在空闲后执行“更多 → 重载 Pi 配置”。

在对话中说明要交给子代理的独立任务。例如调查假项目“轻舟”的 CSV 导出入口，只读并返回关键文件；主代理同时整理验收清单。下面的文件、消息和结果均为示意，不执行真实调查。

1. 查看任务摘要：输入框上方显示执行中的任务，点击进入“任务中心”。
2. 查看子任务过程：选中执行记录，右侧显示子代理的对话与工具过程，而不是主会话的整段聊天。
3. 回到主会话：完成后结果会主动返回并唤醒主代理。展开“返回结果”查看结论，主代理再复核和继续。

配置角色

打开 设置 → 插件设置 → 子代理。勾选启用角色，选择模型；选定模型后才可单独调整思考等级，再点“保存设置”。

这是全局默认配置，受信任项目的设置优先。保存后下次启动或恢复生效，不改正在执行的任务。选择“角色默认模型”沿用角色定义，角色未指定模型时使用主会话模型；“角色默认”思考等级也沿用角色定义。

补充、恢复与停止

• 运行中补充：让助手用 agent_steer 追加要求，不重建子会话。
• 结束后继续：用 agent_resume 追加任务，沿用原对话；仅限当前父会话分支的记录，原会话文件必须还在，角色仍须可用。
• 不再需要：在详情点“打断 → 确认打断”，或用 agent_stop。返回只表示已请求中断，实际中断后显示“已中断”，以结束通知为准；关闭父会话或分支导航也会中断任务，不会自动恢复。
• 权限不额外放开：工具受角色清单与当前能力模式限制，项目可信状态沿用父会话，不因派发就获得无限权限。