Pi (Rust)：用 Rust 编写的高性能 AI 编码代理 CLI

pi_agent_rust 是一个用 Rust 语言从零编写的高性能 AI 编码代理命令行工具，它是 Mario Zechner 开发的 Pi Agent 的完整移植版（已获作者许可）。该项目旨在解决现有 AI 编码助手工具普遍存在的启动慢、内存占用高、流式输出不稳定以及扩展性差等问题。通过使用 Rust 语言，pi_agent_rust 实现了单个静态二进制文件、接近瞬时的启动速度以及稳定的流式处理能力。

该工具并非逐行翻译，而是基于两个专门构建的 Rust 库：asupersync 是一个提供结构化并发、内置 HTTP、TLS 和 SQLite 支持的异步运行时；rich_rust 则是 Will McGugan 的 Rich 库的 Rust 移植版，用于生成带有标记语法的美观终端输出。pi_agent_rust 支持三种运行模式：交互式模式（默认）提供完整 TUI，包括多行编辑器、滚动对话视图、模型选择、会话分支导航和实时令牌/成本跟踪；打印模式（-p）将单次响应输出到 stdout 后退出，适合脚本使用；RPC 模式（--mode rpc）通过行分隔 JSON 协议暴露编程控制接口，便于 IDE 集成。

在扩展性方面，pi_agent_rust 支持两种扩展运行时家族：JavaScript/TypeScript 扩展在嵌入式 QuickJS 运行时中运行，无需 Node 或 Bun；原生 Rust 描述符（*.native.json）在原生 Rust 描述符运行时中执行。扩展入口点自动检测，冷加载 P95 低于 100ms，热加载 P99 低于 1ms。扩展系统采用基于能力的沙箱安全模型，提供两阶段执行保护（能力策略 + 命令级中介）、信任生命周期管理（待定/确认/信任/杀死）以及主机调用紧急控制。此外，还包括可审计的运行时风险账本和经编辑的安全警报。

性能优化方面，pi_agent_rust 采用了多项技术：冷启动最小化（单静态二进制，无运行时引导或 JIT 预热）；热路径减少拷贝（Arc/Cow 消息流，零拷贝主机调用和工具负载处理）；确定性调度核心（类型化主机调用操作码，快车道/兼容车道路由，有界分片队列）；高效长期会话存储（SQLite 会话索引 + v2 sidecar 分段日志及偏移索引）；针对实际网络调整的流式解析器（跟踪扫描字节，处理 UTF-8 尾部，规范化块边界，内部化事件类型字符串）；以及 CI 级性能治理（场景矩阵，严格工件契约，故障关闭性能门）。基准测试方法严谨，包括匹配状态工作负载、真实端到端工作负载，规模从 10 万到 500 万令牌类会话状态，并与原始 TypeScript/Python 版本进行公平比较，结果显示在性能和资源使用上有数量级改进。

总之，pi_agent_rust 通过 Rust 的高性能和安全性，为 AI 编码辅助领域带来了一个快速、可靠且可扩展的终端工具，特别适合大型会话、多代理和扩展密集型工作负载。