pi Desktop – pi 编码代理的图形界面

是什么 – pi Desktop 是一个跨平台桌面应用（Windows、macOS、Linux），让您能够与 pi 编码代理交互——即您可以通过 pi CLI 在终端中运行的同一 AI 助手。它不提供新的模型；它只是在后台工作进程中运行现有的 pi SDK，并为您提供一个可视化界面，用于查看会话、Git 差异、文件浏览以及您已在 CLI 中使用的扩展功能。

---

核心理念

特性	您将获得
共享会话存储	CLI 和桌面应用均读写 ~/.pi/agent（会话、模型登录、settings.json、扩展）。打开一个文件夹，您将立即看到在终端中启动的相同会话。
时间线视图	每个代理的回合（思考、工具调用、文件读取/编辑）都以一个可折叠的简洁摘要步骤显示。编辑会显示 +N −M 行变更，并且“已更改文件”卡片可打开差异对比。
审查面板	选择范围（单个回合、整个会话或完整 Git 树），查看 Git 风格的差异。您可以暂存/取消暂存代码块，并将行注释发送回对话中。
文件面板	与聊天并排浏览项目。点击某行可将 path:line 引用到编辑器中，预览文件，或拖拽文件到聊天中。
编辑器快捷键	@ 搜索项目文件（通过 fd 尊重 .gitignore），/ 列出 pi 命令和扩展注册的命令，Enter 发送，Alt+Enter 队列后续问题，Shift+Enter 插入换行。
并行会话	每个会话在独立的 Electron 工作进程中运行，因此您可以在第一个会话仍在处理时启动第二个回合。
面板	树（会话作为树结构）、运行（模型/思考层级和令牌拆分）、上下文（带令牌估算的消息）。
主题与外观	暗/亮预设、自定义 CSS、五种图标集、密度缩放，以及从 pi-theme-v1 / codex-theme-v1 字符串导入。
扩展	所有终端安装的 pi 扩展均原样加载。其 UI 对话框、工具卡片和 /commands 通过声明式适配器（36 个内置）映射到原生面板。您可以通过 JSON 文件添加/覆盖适配器。
语音输入	内置语音识别，使用 ChatGPT 的端点（无需 API 密钥）或自定义 codex-asr 服务。
WSL 运行时（Windows）	工作进程可在选定的 WSL 发行版中运行，保持 Git 和文件预览在 Linux 侧。

---

谁会使用它？

• 已经使用 pi CLI 的开发者，希望获得更丰富的 UI 来审查代码变更、导航会话树、在不离开应用的情况下暂存 Git 块。
• 共享同一 ~/.pi/agent 目录的团队——桌面和终端保持同步，同事可以接续您启动的会话。
• 偏好视觉反馈（时间线、差异、文件预览）而非纯终端输出的人。

---

快速入门（来自 README）

1. 下载 – 从 Releases 页面下载适用于您操作系统的安装程序（Windows: .exe/便携版，macOS: .dmg/.zip，Linux: .AppImage 或 .deb）。
2. 打开一个文件夹 – 它将成为代理的工作目录。点击 Conversations 旁边的 + 按钮，可创建一个临时聊天。
3. 选择一个会话 – 现有的终端会话将显示出来；点击 + 可启动新会话。
4. 发送提示 – Enter 发送，Shift+Enter 换行。当代理运行时，Enter 控制当前回合，Alt+Enter 将后续问题加入队列。
5. 探索 UI – 审查、运行、上下文、树和文件面板位于右侧侧边栏；可拖动调整大小。

---

技术概览（开发者用）

• 技术栈：Electron 43，React 18，TypeScript，Tailwind，Zustand，i18next，@earendil-works/pi-coding-agent。
• 架构：主进程处理 IPC 并为每个会话启动一个 worker；每个 worker 运行 pi SDK（本地或在 WSL 内）。渲染进程不直接与 SDK 通信。
• 构建：npm install → npm run dev（开发），npm run build（生产打包），npm run package（通过 electron-builder 生成安装包）。
• 测试：提供单元测试、脚本、类型检查和 linting 脚本。

---

许可与支持

• 许可证：MIT。
• 支持：LinuxDo 社区、GitHub Issues、赞助二维码。

---

总结 – pi Desktop 是对现有 pi 编码代理的完整功能 GUI 包装，提供时间线可视化、Git 风格审查、文件浏览、并行会话和扩展支持，同时与 CLI 工作流完全兼容。