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 插件、自定义主题和背景图像。