AI 编程工具不能一直待在终端里，PI-Desktop 桌面工作台解析

开发者现在经常碰到的情况是：AI 编程 Agent 越来越强，但它们大多还是被"塞"在终端、编辑器插件或者云服务里。项目一多、对话一长，再要反复核对文件改动和命令输出，来回切窗口的成本就上去了。

PI-Desktop 要做的事很直接：给 Agent 一个独立工作台。项目、对话、审查、文件、预览、通知，还有各种扩展能力，全部收进同一个应用里。目前它仍处于早期预览阶段，部分接口和桌面操作还在持续调整，不过已经能上手参与真实开发流程了。

它解决的不是"再做一个聊天框"

PI-Desktop 可以接入 OpenAI、Anthropic、OpenAI 兼容型 API、Ollama、LM Studio 等本地网关，最方便的一点是：在同一个会话里就能切换不同 Provider 和模型，不用重建上下文。

它还把 Agent 的工作拆成三种模式：

• Agent：直接检查项目、修改文件、执行命令、测试并不断迭代。
• Plan：先研究仓库，制定一份"冻结"的实施方案，得到用户批准后再执行。
• Goal：目标和验收标准由用户确定，具体实现方式由 Agent 自行决定。

三种模式都绕不开权限层。文件编辑、命令执行这些操作都能被审批，Review 面板里还能看到具体改动和命令运行结果。自动化和可控性在这里并不冲突。

真正重要的就是"工作区化"

PI-Desktop 能同时管理多个项目和会话。对话可以固定或归档、可以开分支、还能排队发提示；@ 引用文件、斜杠命令、应用内搜索也都支持。流式响应会被记录下来，程序重启或因故障中断后，会尽量帮你恢复被打断的工作进程。

它支持把 Claude Code、Codex、OpenCode 和 Pi 的本地会话导入桌面工作区。对于手头已经攒了一堆 Agent 会话记录的人来说，迁移成本并不是从零起步。

扩展层也很齐全

Skills 存可复用的命令和工作流；MCP 负责把外部工具与服务接进来；Subagents 用独立的指令、工具和模型来分担子任务；Plugins 则能提供工具、命令、面板、主题、服务、Skills、MCP 服务器乃至 Subagents。

对 pi CLI 扩展也有兼容：导入后，原有扩展照样能注册工具、斜杠命令和钩子。不过有一点必须注意——插件虽有权限控制，也和 Renderer 做了隔离，但它仍然属于"受用户信任的代码"，不是操作系统级别的沙箱。所以，只安装自己信得过的插件。

本地优先，并不等同于完全脱机

项目对话以 JSONL 形式存储并加索引；设置和日志保存在本机；API 密钥放进操作系统密钥库。README 也写得很清楚：PI-Desktop 不收集数据，不强制注册 PI-Desktop 账号，也不强迫使用 PI-hosted 中继服务。

不过只要用远程模型，必要上下文就得发给你指定的 Provider，自然要受对方隐私政策约束。相比"数据永不出网"这种说法，PI-Desktop 的边界描述更实在。正式部署前，还是值得把相关隐私政策读一遍。

架构上，权限和模型回路是分开的

React Renderer 负责聊天、项目、Review 和设置；Electron Main 负责桌面编排。

Rust Host Core 处理权限、文件系统、SQLite 和密钥；pi Agent Sidecar 负责 Agent 循环、模型交互和流式响应。Renderer 里没有 Node 集成，所有特权操作都收敛在 Rust Host Core 里。

这种分层的好处很明显：UI、桌面生命周期、特权能力和模型运行时边界清晰。在需要长时间运行、可审核、可回溯的代码工作中，架构边界比多一个按钮重要得多。

怎么开始

普通用户直接到 GitHub Releases 页面下载即可。官方提供 macOS Apple Silicon/Intel、Windows x64 和 Linux x64 安装包；Linux 构建需要 glibc 2.35 及以上版本。

本地开发需要满足：Node.js >= 22.19、pnpm >= 10、稳定的 Rust 工具链。

git clone https://github.com/vastsa/PI-Desktop.git
cd PI-Desktop
pnpm install
cargo build -p host-core
pnpm build:js

第一次上手：先在设置里完成模型配置，把模型连上，再添加本地项目。接着选择 Agent、Plan 或 Goal 模式，完事之后去审核面板看一眼有没有需要确认的改动，没问题就继续推进。

写在最后：把"会写代码"变成"能一起工作"

AI 编程下一阶段的竞争，不再只是看模型答得快不快，而是看它能不能真正进入真实项目，在约束下稳定运行，并在长时间工作后仍能把任务收尾。

PI-Desktop 目前还是早期预览版，插件沙箱、安装升级、运行时恢复和跨平台体验都在持续打磨。它的目标很清晰：把 Agent 从一个命令行程序，变成一个能查看、能操作、能协作的本地桌面工作区。

https://github.com/vastsa/PI-Desktop