生产架构、测试与发布

选择集成层

不要为了高级而下沉层级。越底层需要自己负责的会话、工具、安全、UI 和错误处理越多。

• 人类终端协作直接使用 Pi CLI。
• Node.js 同进程产品使用 Coding Agent SDK。
• 跨语言或进程隔离使用 RPC。
• 自定义模型层使用 pi-ai。
• 完全自定义代理循环使用 pi-agent-core。
• 自定义终端界面使用 pi-tui。

生产检查清单

• 固定 Pi、Package 和模型版本。
• 每个任务使用隔离工作目录与最小工具。
• 凭据按租户和环境隔离。
• 工具写入具备审批、幂等和回滚。
• 事件、成本、错误和延迟可观察。
• 用 faux Provider、单元测试和真实模型评测组合验证。
• 升级前回归关键任务，支持快速回退。
• 定期清理 Sessions、Packages 和过期凭据。

长期维护

Pi 更新速度快，官方包名、接口和 Provider 目录都可能变化。把配置、扩展、任务样例和评测集放入版本控制。

每次事故都应转化为测试、工具限制、容器策略或项目指令，而不是只增加一条模糊提示。