justhil/pi-app

解决的问题

pi Desktop 为 pi 编码代理提供了一个图形用户界面（GUI），无需再通过终端与代理进行交互。它通过添加可视化差异视图、可点击的会话树以导航聊天历史记录，以及在代理仍在处理时排队消息的能力，解决了常见的基于终端的限制。

如何工作

该应用作为现有 pi SDK 的桌面外壳运行。它与 CLI 版本共享相同的配置文件、模型登录信息和扩展设置，均位于 ~/.pi/agent 目录中。为了支持扩展，它使用兼容性层和“适配器”（JSON 描述），将基于终端的用户界面（TUI）映射为原生桌面窗口和时间线卡片，而无需对原始 npm 包进行任何修改。

适用人群

使用 pi 编码代理且更倾向于使用可视化工作区而非终端界面的开发者，或希望以更直观方式管理会话和审查代码变更的开发者。

主要亮点

• 流式时间线：显示 Markdown、代码块和行级差异，支持折叠工具步骤。
• 会话树：可点击的界面，用于分支和回溯对话，支持通过 git 选择性恢复文件。
• 作曲家：支持内联文件附件、图片粘贴和拖拽文件集成。
• 工作区预览：多标签文件预览，带有行边距源视图和可扩展的聊天栏。
• 扩展兼容性：通过适配器将 TUI 元素转换为原生 UI，完全支持 pi 包生态系统。
• 语音输入：使用捆绑的 codex-asr 二进制文件进行本地语音命令转录。