Jaxton07/percho

解決的問題

percho 為 Pi 編碼代理提供了一個高度可自訂的桌面圖形使用者介面（GUI）。它彌合了喜歡視覺化介面而非基於終端的（TUI）體驗的使用者與 Pi CLI 的引擎、設定和擴充功能完全相容之間的差距。

運作方式

該應用程式將官方 Pi SDK（@earendil-works/pi-coding-agent）嵌入到 Electron 主進程中。由於它使用與 CLI 相同的引擎，因此共用相同的設定目錄（~/.pi/agent/），允許使用者在終端和 GUI 之間無縫切換。它透過 API 金鑰或 OAuth 流程（包括 Claude、ChatGPT、Gemini 和 DeepSeek）支援各種 AI 提供者，並實作了工具核准和會話管理的視覺化層。

適用對象

使用 Pi 編碼代理但希望擁有視覺化工作區的開發人員，該工作區具有多會話標籤、影像預覽以及更直觀地管理代理工具呼叫和子會話等功能。

亮點

• 完全相容 Pi CLI：支援與 CLI 相同的 TypeScript 擴充功能、技能和提示範本。
• 視覺化工具管理：包括用於核准或拒絕工具呼叫的視覺化權限閘道以及每個工具規則引擎。
• 進階會話控制：具有可拖曳的多會話標籤、訊息分叉以及帶復原功能的後續佇列。
• 代理能力：內建對子代理、平行任務扇出以及用於內聯影像顯示的 show_image 工具的支援。
• 上下文最佳化：使用「上下文蒸發」將過時的工具輸出轉換為緊湊的存根以節省令牌預算。
• 自訂：支援 UI 外掛程式、自訂主題和背景影像。