pulseaiclub/phi

解決的問題

phi 是一個高效能、精簡的終端編碼代理框架，旨在為重量級 AI 編碼助手提供快速、低開銷的替代方案。它解決了通常與基於 Electron 或 Python 的 AI 工具相關的高資源消耗（RAM/CPU）和啟動緩慢的問題，同時為 LLM 與本地程式碼庫互動提供了一個安全、可擴充的環境。

運作方式

phi 使用 Go 建構，作為一個 TUI（終端使用者介面）執行，連接到相容 OpenAI 或 Anthropic 的模型。它為 LLM 提供一組核心工具（read、write、edit、bash、grep、find、ls）來操作檔案和執行命令。為了保持效率和安全性，它採用了幾個關鍵機制：

• 雜湊行編輯：模型不會重寫整個檔案，而是使用錨點（標籤和雜湊）進行精確編輯，防止靜默損壞。
• 子代理：它可以產生具有特定角色（explore、review、worker）的隔離任務，而不會使父會話的上下文膨脹。
• 惰性 MCP 整合：它與模型上下文協定（MCP）伺服器整合，而不會將所有工具模式傾倒到提示中，使用元工具按需發現和呼叫工具。
• 權限閘控：可設定的策略（interactive、readonly、autopilot、headless-strict）確保破壞性工具在執行前得到使用者批准。
• PXB 協定：自訂二進位協定允許用 Go 或 Rust 編寫的原生擴充以最小延遲新增工具和命令。

適用對象

phi 適用於喜歡基於終端的工作流程，並且需要一個輕量級、快速啟動的 AI 代理，可以整合到現有 CLI 工具和專案結構中的開發人員。

亮點

• 極致效率：小型二進位檔案（約 15 MB）和非常低的閒置 RAM（約 21 MB），啟動幾乎即時（約 31 毫秒）。
• TUI 內差異審查：全螢幕 git 審查覆蓋層，用於在套用變更之前審查和記錄變更。
• 可擴充架構：透過 PXB 協定支援 Go 和 Rust 的原生擴充。
• 模型無關：適用於任何相容 OpenAI 或 Anthropic 的模型。
• 上下文感知技能：允許使用者在 Markdown 檔案（SKILL.md）中定義可重用的程序，以指導代理的行為。