$ cat ~/map/pi-flows.md

pi-flows

把工作委托给隔离的、有预算约束的 pi 子 agent——侦察、评审、任务分解——并提供成本上限、OpenInference 追踪和契约校验。

extensions✓ 10月16日

事实速查

安装

pi install npm:pi-flows

## 速览

为 pi 增加 flow 工具的扩展——把工作委派给独立、有预算上限的 pi 子进程：九个内置代理、十五种委派模式，覆盖侦察、并行调查、带门禁的实现与大型任务分解。

$flow 工具运行独立、一次性的 pi 子进程并回传精炼结论，父会话只关注决策，不必陪着子进程翻遍每个文件。
$agents/ 内置九个代理（recon、strategist、overwatch、operator、analyst、redteam、controller、commander、debrief），presets/ 另有三个工作流预设（scout、map-codebase、code-review）。
$单一接口背后是十五种委派模式：从 single/parallel/chain 到 evaluate、vote、route、orchestrate、graph、loop、search、workflow、worktree、debate、dossier 和 monitor。
$前置条件：Node.js >=24、npm >=11、PATH 上有 pi CLI >=0.82.0；装好后用 /flows version 验证，flow list 应列出全部九个代理。
$任意模式都能叠加预算与追踪：maxCostUsd、maxTokens、maxGeneratedTokens 三类上限、OpenInference 形态的 JSONL 追踪和 /flows report，所有上限在开工前即披露。
$自定义代理和预设无需写代码——各是一个 markdown 文件，可用户级或项目级；项目文件受信任门控，遮蔽冲突会给出可见诊断。
$安全模型：只读代理（recon、analyst）不带 shell，bash-ro 在子进程内部强制只读白名单，返回内容默认脱敏，子进程间交接会扫描注入指令。

Q 怎么确认扩展装好了？

pi install npm:pi-flows 后用 /reload 重载，再跑 /flows version 或 flow list——list 输出必须包含从 recon 到 debrief 的全部九个内置代理。

Q 没配模型凭据能用吗？

无模型调用照常可用：/flows help、/flows status，以及带 list:true 或 showConfig:true 的 flow 调用，既不派生子进程也不请求模型。

Q 项目级代理安全吗？

它们是仓库可控的提示词，交互式会话使用前会先询问，headless 运行则默认拒绝——审阅文件后传 confirmProjectAgents:false 才会放行。