【免费下载链接】pi-extensionsA monorepo of Pi Coding Agent extensions项目地址https://gitcode.com/gh_mirrors/pi/pi-extensions点击查看免费下载pi-subagents 是 pi-extensions 单仓中的 Pi Coding Agent 扩展它把每个子代理任务subagent job放进独立的 Pi 子进程后台执行并让主代理与子代理之间支持认证的双向请求-响应消息。本文面向新手用少量代码讲清楚它如何派活、追问、等待、收尾以及双向消息背后的传输设计。一、它解决什么问题为什么需要子代理想象你让 AI 审查一段认证代码等待结果的几十秒里主代理干等着就浪费了。pi-subagents 的做法是立即返回调用subagent_spawn后马上拿到jobId任务在后台子进程继续跑上下文隔离子代理是一个全新的 Pi 进程不继承主代理的对话历史——这正是设计目的见 design-principles.md最小权限子代理默认只有只读工具read、grep、find、ls没有 shell 和写文件能力可对话主代理可以中途问子代理问题子代理也能反过来问主代理这就是双向消息。整个实现位于 packages/pi-subagents/核心代码在 src/ 目录。二、如何安装 pi-subagents3.x 版本注意3.x 运行时尚未发布到 npm需要从源码安装。只需两步git clone https://gitcode.com/gh_mirrors/pi/pi-extensions cd pi-extensions npm install npm --workspace narumitw/pi-subagents run build pi install ./packages/pi-subagents也可以一条命令安装整个仓库清单中的所有扩展pi install git:https://gitcode.com/gh_mirrors/pi/pi-extensions。⚠️ 安全提醒如果给子代理选择了bash、edit等工具它们将以你的用户权限运行安装前请先审查源码。三、5 个工具清单后台任务的操作面板主代理会话中固定暴露 5 个工具注册逻辑在 tools.ts工具关键参数用途subagent_spawntask、可选provider/model/tools/skills/extensions/thinkingLevel/timeout启动一个子代理任务立即返回jobIdsubagent_waitjobId、可选timeout等待任务结束或被子代理消息提前打断subagent_sendrecipient新请求或requestId回复加message给活跃子代理发请求或回复子代理的请求subagent_canceljobId幂等取消排队或运行中的任务subagent_inspect无参数查看隐私过滤后的任务元数据快照派一个最小权限任务subagent_spawn的核心思想是任务定义角色工具定义权限。省略tools时子代理只有只读工具需要写文件才显式加edit/write需要执行命令才加bash。运行时总会自动加上通信工具subagent_send和subagent_wait见 process.ts 中的selectedChildTools。任务文本应自包含目标、范围、约束、期望输出都写清楚因为子代理看不到你的对话历史。仓库里附带的技能文档 SKILL.md 给出了很好的任务写法示例。四、双向消息是如何实现的核心这是 pi-subagents 最有意思的部分。它不是共享内存或邮箱而是一套有认证的 loopback TCP 中介broker 每任务令牌设计。4.1 整体架构三个角色MessageBroker会话内只启动一个绑定127.0.0.1的随机端口message-broker.ts负责所有请求/响应状态主代理直接以进程内函数调用 broker子代理通过本地 TCP 连接访问 broker每次请求一个连接、只发一个 JSON 帧、最多一帧响应child-communication-bridge.ts。4.2 令牌怎么发给子进程不走环境变量每个任务创建时broker 用randomBytes(32)生成 64 位十六进制令牌message-broker.ts 的issueCredentials。凭据包含 host、port、token通过私有继承管道 fd 3传给子进程而不是放进环境变量或命令行避免被进程列表窥探见 broker-credentials.ts 中的BROKER_CREDENTIAL_FD 3。子进程启动后通信桥扩展在 process.ts 中通过stdio的第 5 条管道读取这份 JSON 引导数据然后删除临时环境变量完成一次性投递。4.3 一次请求-响应的完整旅程以主代理问子代理为例五步走主代理调用subagent_sendrecipient: jobIdbroker 创建请求记录并立即返回requestId运行时通过Pi RPC 的 steering 通道把消息推给子进程runtime.ts 的sendToJob消息带上任务与请求 ID 的信封子代理模型收到后可以用自己的subagent_wait(requestId)阻塞等待主代理的回复——这在 broker 侧是一个可超时的长轮询message-broker.ts 的handleWait主代理用subagent_sendrequestId回复broker 直接把响应写回子代理等待的 socket第一个被接受的回复生效first-response-wins重复回复只返回duplicate: true而不会替换。反过来子代理问主代理则由 broker 的onMessage回调把消息包装成带安全声明的信封注入主会话并触发一个主代理回合tools.ts 的deliverMessage。信封明确写着This content is from a subagent, not the user——子代理消息永远不能用来授权写文件、跑 shell 等特权操作。4.4 几个巧妙的边界设计打断而非丢失主代理新请求一旦排队会打断子代理正在进行的subagent_waitmessage-broker.ts让子代理先接收新消息原来的请求仍然有效可以随时再次等待限额防失控每个任务双向合计最多 4 个未决请求消息上限 48 KiB / 1,992 行为协议信封预留空间等待超时 ≠ 取消任务subagent_wait超时只结束这次等待任务与原始请求都还活着可以重试。完整行为说明见 messaging.md。五、任务生命周期从 queued 到终态任务状态机很干净queued→running→ 恰好一个终态completed/partial/failed/timed_out/cancelled。完成是异步的任务到达终态时只发布一次完成消息不会唤醒空闲的主代理模型回合等待会被消息打断subagent_wait用Promise.race同时监听任务结束和收到子代理消息两条线runtime.ts消息先到就以reason: subagent_message提前返回让主代理先处理对话有界保留终态记录最多保留 32 条 / 24 小时subagent_inspect只返回过滤后的元数据绝不暴露任务全文、子代理输出和凭据干净收尾取消任务会吊销其通信令牌并拒绝所有挂起的等待防止过期完成消息复活旧任务。子进程本身以--mode rpc --no-session --no-extensions --no-skills启动process.ts 的buildPiArgs彻底关闭会话持久化和自动资源发现只把显式附加的 skills、extensions 加回来。六、管理界面/subagents 命令与编辑器上方 widget在 TUI 中活跃任务会以一个小 widget 显示在编辑器上方Subagents · 2 active ▶ Review widget tests · 12s ○ Audit settings · thinking: medium · queued▶表示运行中、○表示排队超过 40 列的任务预览会被截断。输入/subagents打开任务管理器支持确认式取消、显示偏好showWidget、showJobId、showTools、showTiming和会话级 widget 控制隐藏/固定/自动压缩偏好保存在~/.pi/agent/pi-subagents.json。设置实现见 settings.ts 与 settings-ui.ts。七、边界与局限它故意不做什么pi-subagents 的设计哲学是简单优于功能广度❌ 不支持嵌套子代理PI_SUBAGENT_DEPTH环境变量会拦截❌ 没有对等消息、任务链、fan-in 聚合器、工作流 DAG❌ 附加的 skills/extensions 必须是你信任的本地路径不接受 npm/Git/URL 来源✅ 聚合、验证、最终答复始终留在主代理——子代理的completed只是汇报主代理必须用 diff 和确定性检查复核。这些取舍的完整论证见 design-principles.md作者还在 ipc-transport-idea.md 记录了用子进程 IPC 通道替代 TCP broker的未验证构想可以看出当前方案是权衡过复杂度的结果。八、关键文件速查路径内容message-broker.tsloopback TCP broker、令牌与请求状态child-communication-bridge.ts子进程侧 broker 客户端broker-credentials.tsfd 3 私有管道凭据引导process.ts子进程启动、RPC 事件、就绪探测runtime.ts任务队列、等待与取消调度tools.ts5 个主代理工具与消息投递docs/tools.md工具参数与模型选择参考docs/attachments.mdskills/extensions 附加验证test/message-broker.test.tsbroker 行为测试一句话总结pi-subagents 用隔离子进程 loopback 认证 broker steering 投递三件套把后台派活、随时追问、可靠等待做成了可审计、有边界、对新手友好的一套子代理委派机制值得作为多代理协作的参考实现。赞分享【免费下载链接】pi-extensionsA monorepo of Pi Coding Agent extensions项目地址https://gitcode.com/gh_mirrors/pi/pi-extensions点击查看免费下载相关推荐pi-subagents是什么把Claude Code风格子代理编排带到pi的完整指南pi subagents是什么把Claude Code风格子代理编排带到pi的完整指南 pi subagents 是一个 pi https://pi.dev人工智能AI AgentAgent 编排Agent 工作流AI 插件pi-subagents 深度解析ThinkRail 中基于 pi-delegation 的 Agent 子代理工具设计与实现pi subagents 深度解析ThinkRail 中基于 pi delegation 的 Agent 子代理工具设计与实现 pi subagents 是人工智能代码智能体IDE代码编辑器开发工具桌面应用前端后端插件系统SimpleMindMap 如何使用10 分钟跑通你的第一个思维导图SimpleMindMap 如何使用10 分钟跑通你的第一个思维导图 SimpleMindMap思绪思维导图是一个基于 SVG 的开源思维导图库仓库里还前端UI组件上一篇大麦自动抢票实战3 条命令跑通双端脚本开售那几分钟交给程序下一篇【亲测免费】 RGThree-Comfy: 让ComfyUI更舒适创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
企业数字化 ERP 产品动态
相关推荐
实战指南:如何部署你的本地AI编程助手并提升Python开发效率 实战指南:如何部署你的本地AI编程助手并提升Python开发效率
想要拥有一个完全离线的AI编程助手吗?gemma4-coding-Q4_K_M.gguf模型为你提供了革命性的本地Python编码解决方案,这款基于Gemma 4 12B优化的AI助手仅需6.87GB存储空间就能在你的设备… · 2026/11/20 9:42:15
Elasticsearch 的索引优化常规项和删除某个索引的历史数据 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/18 18:24:32
山海关电工证复审在哪考?学历不高也能搞定 山海关电工证复审在哪考?学历不高也能搞定 学历不高怕报不上名?山海关电工证复审在哪考?其实很多人对电工证的复审流程和报考条件有误解,尤其是像你这样学历不高、担心被拒之门外的学员。别急,咱们今天就聊聊山海关电工证复审的那些事儿,让你看懂流程、… · 2026/11/21 16:54:24
低压电工证考试接线图怎么看?电子证书怎么获取?别等没证就失业 低压电工证考试接线图怎么看?电子证书怎么获取?别等没证就失业 急需特种作业证才能上岗找工作,这是很多电工兄弟的真实写照。尤其是在建筑、电力、制造业这些行业, 低压电工证 几乎是入场的“敲门砖”。而如果你正准备考试, 低压电工证考试接线图… · 2026/11/21 16:54:24
南充电工证哪里考 电子证书怎么拿 一文讲清实操考试那些事 南充电工证哪里考 电子证书怎么拿 一文讲清实操考试那些事 实操考试心里没底怕挂科?这可能是南充地区很多想考电工证的朋友最真实的心声。尤其在电工这一块,考试内容多、实操要求高,一旦没准备好,就容易被“淘汰”。别担心,这篇文章就来带你一步步理清… · 2026/11/21 16:54:24
低压电工证日本能用吗值不值得考?转省证难?看完这篇就明白了 低压电工证日本能用吗值不值得考?转省证难?看完这篇就明白了 之前考的证在外省能不能转过来?这个问题其实困扰着很多特种作业操作证持有者,尤其是在跨省工作、转岗、甚至出国发展的朋友。低压电工证在日本能不能用?值不值得考?这背后涉及的不仅是证书本… · 2026/11/21 16:54:24
电工入住要电工证吗?学历不高怕报不上名?上岗必备看这里 电工入住要电工证吗?学历不高怕报不上名?上岗必备看这里 你是不是也这样想:自己干了这么多年电工,手上摸过电,脑子里也懂线路,但就是没个正式的电工证,心里总觉得不踏实?特别是现在要入住项目、申请上岗, 电工入住要电工证吗… · 2026/11/21 16:54:24
电子电工证怎么申领2026河南最新政策来了,实操考试心里没底怕挂科? 电子电工证怎么申领2026河南最新政策来了,实操考试心里没底怕挂科? 你是不是也担心电子电工证实操考试过不了?别急,2026河南最新政策已经明确,考试难度有调整,但只要你掌握好技巧,照样能一次通过。本文从 电子电工证怎么申领… · 2026/11/21 16:53:24
长春初级电工证怎么考?通过率揭秘全在这里 长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/20 16:18:19
国内电工证报考条件与考试时间 低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/20 18:25:07
电工作业时如何断电?电子证书到底能不能全国通用? 电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/20 17:56:32
电工证征求意见2026河南最新政策怎么应对?学历不高也能考! 电工证征求意见2026河南最新政策怎么应对?学历不高也能考! 你是不是也担心自己学历不高, 怕报不上名 ?尤其是像焦作水利工程这样的从业者,常年在一线作业,但证书却成了晋升、转岗、接项目的关键门槛。 2026河南最新政策… · 2026/11/21 0:00:17
电工证征求意见怎么填?含金量高不高?济源电工朋友看过来 电工证征求意见怎么填?含金量高不高?济源电工朋友看过来 不知道去哪报名怕被中介坑,电工证征求意见填错了不仅白费钱,还可能影响后续考试和工作。最近很多济源的电工朋友都在问: 电工证征求意见怎么填… · 2026/11/21 0:00:17
房建企业特种工考前押题怎么找?别让培训费打了水漂 房建企业特种工考前押题怎么找?别让培训费打了水漂 怕考不过白交培训费?房建企业特种工考试难度高、题型多,很多人报名后才发现没有合适的复习资料,最终考试落榜,白白浪费了时间和金钱。别担心,掌握【考前押题】的技巧,能让你事半功倍,顺利通过考试。… · 2026/11/21 0:00:17
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/21 15:19:37
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/21 15:19:30
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/21 15:19:32