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 編碼輔助領域帶來了一個快速、可靠且可擴展的終端工具，特別適合大型會話、多代理和擴展密集型工作負載。