PI-Desktop
独立桌面工作区，把 AI 编码 agent 从终端和编辑器插件里解放出来，支持打开本地任意项目，用 Agent/Plan/Goal 三种模式干活，特权操作都经过权限审核层。亮点是真正做到 local-first：无强制账户和中继，对话与配置全存本地，模型自带（OpenAI、Anthropic、Ollama 等 OpenAI 兼容 API 均可），还支持 MCP、Subagents、Skills 及可安装插件扩展。目前处于 Early Preview，API 和桌面行为可能继续调整。
README
PI-Desktop
您的本地优先桌面工作区，专为 AI 编码代理打造
自带模型。打开任意本地项目。让代理工作——而您始终掌握控制权。
无需 PI-Desktop 账户，无强制中继，不被绑定在某款编辑器上。
下载 PI-Desktop · 文档 · 截图 · 英文版 或 简体中文（当前版本为中文）
一个独立桌面工作区，用于编码代理、项目、模型、工具和长时间运行的会话。
[!IMPORTANT] PI-Desktop 目前处于早期预览阶段。
本项目正在积极开发中，已经可以用于真实的编码工作流，但 API、扩展接口以及部分桌面行为可能会持续演进。
为什么选择 PI-Desktop？
大多数编码代理都局限在终端、编辑器扩展或托管服务中。
PI-Desktop 为它们提供了一个属于自己的工作区。
🖥️ 桌面优先跨越仓库和会话开展工作，无需将代理工作流绑定在某个编辑器或终端上。 项目、对话、审查、文件、预览、通知和扩展都集中在一个工作区中。 |
✨ 自带模型使用 OpenAI，Anthropic，本地模型，托管网关，或任何 OpenAI 兼容 API。 配置多个服务商与模型，并可在每个会话中灵活切换。 |
🔍 默认可检查代理可以读取文件、编辑代码、执行命令——但特权操作必须经过 PI-Desktop 的权限层。 审查差异（diff）、检查命令输出，自行决定每个会话拥有多少自主权。 |
🧩 易于扩展添加 Skills、MCP 服务器、Subagents 以及可安装的 Plugins。 插件可以贡献工具、命令、面板、主题、服务、技能以及全新的工作区体验。 |
从提示词到补丁
开始使用只需几个步骤：
连接模型 打开 设置 → 模型配置，选择服务商或兼容 API，并添加您的凭据。
打开项目 从侧边栏添加任意本地仓库或项目目录。
选择 Agent、Plan 或 Goal Agent 会立即开始工作。Plan 会等您批准一份冻结的实施计划后再行动。Goal 会等您批准最终成果，然后由代理选择实现路径。
审查结果 在审查面板中检查编辑内容，查看命令输出，预览应用程序，全程无需离开 PI-Desktop 即可继续对话。
不仅仅是聊天窗口
Agent、Plan 与 Goal
同一个代理。三道闸门。每种模式下，特权工具仍需经过权限层。
| Agent | Plan | Goal | |
|---|---|---|---|
| 您来批准 | 无需额外批准 | 实施计划 | 最终成果与验收标准 |
| 代理负责 | 读取、编辑、运行命令、测试、迭代 | 研究仓库、编写冻结计划、然后等待 | 自行选择路径并持续工作直至达成目标 |
| 适用场景 | 您希望它直接完成工作 | 变更较大或有风险，希望先确认方案 | 您只关心结果，不关心路径 |
Agent 是默认循环：检查代码树、修改文件、运行命令，持续前进。
Plan 是批准边界。代理先做研究，产出不可变的实施计划。在您签字确认之前，不会开始执行。
Goal 是结果优先。您锁定目标与验收标准；代理自行决定如何达成。
将任务委托给 Subagents
大型任务很少适合塞进单个上下文窗口。
PI-Desktop 可以将独立工作委派给后台 Subagents，例如：
- 代码库探索
- 多文件实现
- 研究与调查
- 测试分析
- 对抗性审查
每个 Subagent 在自己的上下文中运行，并将结果报告给父代理。
为长会话而生的工作区
PI-Desktop 的设计不止于单次提示。
您可以管理多个项目和会话，固定或归档对话，派生会话分支，在代理运行期间排队提示词，使用 @ 引用文件，使用斜杠命令，并在整个应用中搜索。
流式响应带有检查点（checkpoint），因此中断的工作能够尽可能在应用重启或运行时故障后恢复。
您的模型，您来选
PI-Desktop 不会将代理运行时绑定到固定的模型列表。
可用的选择：
- OpenAI 与 Anthropic
- OpenAI 兼容 API
- 托管模型网关
- 本地网关，如 Ollama 与 LM Studio
- 同一服务商下的多个模型
- 支持的服务商 OAuth 账户
模型配置可包括上下文窗口、输出限制、推理控制、温度以及其他模型特定行为。
您可以直接在 Composer 中切换模型，而无需重建会话。
审查工作，而不只看答案
代理工作区为编码过程中的关键事项提供了专属界面：
 支持转写导航的长对话 |
 在每次会话中切换服务商、模型和推理级别 |
 通过插件市场扩展工作区 |
 添加服务商并连接模型 |
无需重建应用即可扩展
PI-Desktop 提供多个扩展层，具体取决于您希望以多深的程度定制代理。
Skills（技能）
为代理提供可复用的指令与工作流。
Skills 可以全局安装，也可以针对单个项目启用。
MCP（模型上下文协议）
通过 Model Context Protocol（MCP）服务器连接外部工具与服务，而无需将其内置到桌面应用中。
PI-Desktop 也可以被外部的 MCP Agent 控制。使用以下方式启动应用：
PI_DESKTOP_MCP_CONTROL=1；然后从 Electron 用户数据目录中的 mcp-control.json 读取回环端点与 bearer token。该端点支持项目 / 会话 / Agent 工作流，并提供经过审核的桌面操作目录。该功能默认关闭，仅绑定回环地址，并授予调用方本地 Agent 等同于桌面的操作权限——confirm: true 不代表会弹出用户确认。
Subagents（子代理）
创建具有独立指令、工具和模型选择的专用代理，然后从另一个代理向其委派工作。
Plugins（插件）
插件可以通过以下能力扩展 PI-Desktop 本身：
- 代理工具
- 命令
- 工作区面板
- 工作面板视图
- Skills
- MCP 服务器
- Subagents
- 主题
- 常驻服务
- 插件间消息
插件可以通过 .piplug 包工作流在本地安装，或通过市场安装。
[!NOTE] 插件进程受权限门控并与渲染进程隔离，但插件仍属于用户信任的代码，而非完整的操作系统沙箱。请只安装您信任的插件。
本地优先，精确如此
PI-Desktop 是本地优先，但并非“完全不联网”。
| 数据 | 行为 |
|---|---|
| 对话 | 本地存储为 JSONL 文件，并使用 SQLite 索引 |
| 设置 | 存储在您的机器上 |
| API 凭据 | 存储在操作系统密钥链中 |
| 日志 | 本地保存 |
| PI-Desktop 遥测 | 无 |
| 模型请求 | 直接发送至您配置的服务商或端点 |
无需 PI-Desktop 账户，也不存在由 PI 托管的、介于您机器与模型服务商之间的强制中继。
如果您使用远程模型服务商，该模型请求所需的上下文会按照该服务商的隐私政策自然发送至相应服务商。
下载
从 GitHub Releases 下载最新版本。
| 平台 | 架构 | 安装包 |
|---|---|---|
| macOS | Apple Silicon | .dmg / .zip |
| macOS | Intel | .dmg / .zip |
| Windows | x64 | NSIS 安装程序 / 便携版 exe |
| Linux | x64 | .AppImage / .deb / .rpm / .asar |
打包版本可以检查 GitHub Releases 的更新，并在应用内提示新版本。Windows NSIS 和 Linux AppImage 支持在应用内下载并安装；macOS、Linux deb/rpm 以及 Windows 便携版 exe 会打开 Releases 页面。Linux .asar 文件可用于配合系统 Electron 重新打包；请在目标发行版所需的原生 host 与打包资源就绪后，使用 electron PI-Desktop-<version>-linux-x64.asar 启动。
Linux
Linux x64 包需要 glibc 2.35 或更高版本。以下系统自带的正是该版本库：
- Ubuntu 22.04 或更高版本
- Debian 12 或更高版本
- Fedora 36 或更高版本
Ubuntu 20.04、Debian 11、Fedora 35 及更早版本无法加载内置 host。可通过 ldd --version 检查。
macOS
默认情况下，带 tag 的发布工作流会发布未签名的 macOS 产物。如需安装未签名版本，请将 PI-Desktop.app 移到“应用程序”文件夹；如果 macOS 提示应用已损坏，请双击运行 PI-Desktop-macOS-open.command。若手动触发一次 sign_macos: true 的发布，macOS 产物会在发布前使用 Developer ID 凭据进行签名、公证并打上 stapler 标记；签名版本无需使用该辅助脚本。
导入您已有的会话
已经在使用其他编码代理？
PI-Desktop 可以从以下受支持的工具导入本地会话：
- Claude Code
- Codex
- OpenCode
- Pi
打开 设置 → 导入 即可将现有工作带入桌面工作区。
架构
PI-Desktop 有意将用户界面与特权主机能力、代理循环进行分离。
flowchart TB
UI["React Renderer<br/>Chat · Projects · Reviews · Settings"]
Electron["Electron Main<br/>Desktop orchestration"]
Rust["Rust Host Core<br/>Permissions · Filesystem · SQLite · Secrets"]
Agent["pi Agent Sidecar<br/>Agent loop · Models · Streaming"]
Provider["Model Provider<br/>Cloud or Local"]
UI --> Electron
Electron --> Rust
Electron --> Agent
Agent <--> Rust
Agent --> Provider
渲染进程没有 Node.js 集成能力。
Rust Host Core 负责特权工作区操作、权限、持久化与密钥。pi Agent Sidecar 负责模型交互与代理循环。Electron 负责协调桌面生命周期，同时保持这些职责相互分离。
项目状态
PI-Desktop 是处于积极开发中的早期预览版本。
当前 0.14.x 系列包含：桌面外壳、流式代理运行时、Agent / Plan / Goal 工作流、权限感知工作区工具、项目与会话、会话导入、本地 MCP 控制、MCP / Skills / Subagents、后台委派、多服务商模型配置、插件与市场支持、上下文检查点、通知、发布说明以及跨平台打包。
当前优先事项包括：
- macOS 带 tag 的发布流程验证
- 安装程序升级与回滚验证
- 持续强化运行时与会话恢复能力
- 更强的插件沙箱与发布者验证
- 更广泛的 UI 驱动端到端测试覆盖
开发
环境要求
- Node.js
>=22.19 - pnpm
>=10 - 稳定的 Rust 工具链
仓库当前锁定 pnpm 11，而 CI 与发布构建使用 Node 24。
本地运行
git clone https://github.com/vastsa/PI-Desktop.git
cd PI-Desktop
pnpm install
cargo build -p host-core
pnpm build:js
pnpm dev
验证改动
pnpm typecheck
pnpm lint
pnpm test
更多协议、Plan、监督、Subagent 与 Electron E2E 测试套件见仓库规范文档。
文档
pnpm docs:dev
pnpm docs:check
实用参考：
参与贡献
欢迎提交 Issue、Bug 报告、功能建议、文档改进与 Pull Request。
对于较大的改动，先提交 Issue 将有助于实现与现有架构及产品契约保持一致。
在仓库中开始工作前，请先阅读 AGENTS.md 与规范索引。
基于开源构建
PI-Desktop 建立在开源生态系统的卓越工作之上。
代理运行时使用来自 pi-mono 的 pi-ai 与 pi-agent-core。
桌面应用基于包括 Electron、React、TypeScript、Rust、SQLite、Vite、Tailwind CSS、Shiki、Mermaid、KaTeX、TypeBox 与 i18next 在内的技术构建。
感谢每一个让 PI-Desktop 变为现实的工程项目与贡献者。
模型鸣谢
本项目由以下模型创建——并非出自某位孤独的天才，而是由一个 token 驱动的施工队完成。
| 服务商 | 模型 | Tokens |
|---|---|---|
| OpenAI | gpt-5.6-luna |
5,304,019,817 |
| OpenAI | gpt-5.6-sol |
4,825,458,273 |
| OpenAI | gpt-5.4 |
4,213,269,324 |
| Anthropic | claude-opus-5 |
3,909,952,653 |
| OpenAI | gpt-5.5 |
3,800,382,171 |
| xAI | grok-4.5 |
1,947,736,115 |
| xAI | grok-4.6 |
797,233,571 |
| DeepSeek | deepseek-v4-flash |
329,790,234 |
| OpenAI | gpt-5.2-codex |
320,983,170 |
| Xiaomi | mimo-v2.5-pro |
304,822,052 |
| Anthropic | claude-fable-5-1 |
302,580,552 |
| OpenAI | gpt-5.6-terra |
274,107,085 |
| OpenAI | gpt-5.3-codex |
255,366,945 |
| OpenAI | gpt-5.1-codex-max |
220,947,212 |
| OpenAI | gpt-5.1 |
142,533,699 |
| — | Unknown model |
69,801,632 |
| Anthropic | claude-opus-4.6 |
55,223,768 |
| Zhipu | stealth/ox-alpha |
22,954,876 |
| Anthropic | claude-fable-5 |
16,116,907 |
| OpenAI | gpt-5.1-codex-mini |
12,895,478 |
| Xiaohongshu | dots-3-note-prev |
10,166,895 |
| OpenAI | gpt-5.1-codex |
3,916,509 |
| Xiaomi | mimo-v2.5 |
3,785,071 |
上述模型合计： 27,144,044,009 tokens。
社区链接
- Linux.Do — 一个分享与讨论技术的社区。
许可证
PI-Desktop 采用 GNU Lesser General Public License v3.0 许可证。
详情请参阅 LICENSE。
用您想要的模型来构建，保留属于您自己的工作流。
macOS · Windows · Linux