# PI-Desktop ### 本地优先的 AI 编程智能体桌面工作区。 **自带模型。打开任意本地项目。让智能体干活——控制权始终在你手里。** 无需 PI-Desktop 账号。没有强制中转。也不绑定某一款编辑器。
[![Release](https://img.shields.io/github/v/release/vastsa/PI-Desktop?label=release)](https://github.com/vastsa/PI-Desktop/releases/latest) [![Downloads](https://img.shields.io/github/downloads/vastsa/PI-Desktop/total?label=downloads)](https://github.com/vastsa/PI-Desktop/releases) [![Stars](https://img.shields.io/github/stars/vastsa/PI-Desktop?style=flat\&label=stars)](https://github.com/vastsa/PI-Desktop/stargazers) [![CI](https://github.com/vastsa/PI-Desktop/actions/workflows/ci.yml/badge.svg)](https://github.com/vastsa/PI-Desktop/actions/workflows/ci.yml) [![License](https://img.shields.io/github/license/vastsa/PI-Desktop)](LICENSE) ![Platforms](https://img.shields.io/badge/platform-macOS%20%C2%B7%20Windows%20%C2%B7%20Linux-4c8dd8)

**[下载 PI-Desktop](https://github.com/vastsa/PI-Desktop/releases/latest)** · [文档](https://pi-docs.aiuo.net/) · [界面截图](docs/zh-CN/guide/screenshots.md) · [English](README.md)
PI-Desktop AI 编程工作区

PI-Desktop AI 编程工作区

_{独立的桌面工作区，覆盖编程智能体、项目、模型、工具和长会话。}

--- > [!IMPORTANT] > **PI-Desktop 目前处于早期预览阶段。** > > 项目仍在积极开发，已经可以用于真实的编程工作流，但 API、扩展接口和部分桌面行为还会继续演进。 ## 为什么是 PI-Desktop？大多数编程智能体待在终端、编辑器插件或托管服务里。 PI-Desktop 给它们一个属于自己的工作区。

### 🖥️ 桌面优先跨仓库、跨会话工作，不必把智能体流程绑在某一款编辑器或终端上。项目、对话、审阅、文件、预览、通知和扩展都在同一个工作区里。	### ✨ 自带模型可用 OpenAI、Anthropic、本地模型、托管网关，或任何兼容 OpenAI 的 API。配置多个服务商和模型，再按会话切换。
### 🔍 默认可审查智能体可以读文件、改代码、跑命令——但特权操作都要经过 PI-Desktop 的权限层。核对 diff、查看命令输出，并决定每个会话能有多大自主权。	### 🧩 为扩展而生可添加 Skills、MCP 服务器、子智能体，以及可安装的插件。插件可以贡献工具、命令、面板、主题、服务、技能，以及新的工作区体验。

--- ## 从一句话到一处补丁上手只需几步： 1. **接入模型** 打开 **设置 → 模型配置**，选择服务商或兼容 API，并填入凭证。 2. **打开项目** 从侧边栏添加任意本地仓库或项目目录。 3. **选智能体、规划或目标** **智能体** 直接开干。**规划** 先出一份不能改的实施方案，你批了才执行。**目标** 你先批结果，路径由智能体自己选。 4. **审阅结果** 在审阅面板里检查改动，查看命令输出，预览应用，然后继续对话——全程不必离开 PI-Desktop。 --- ## 不只是聊天窗口 ### 智能体、规划与目标同一个智能体，三道闸。三种模式都还走权限层。 | | **智能体** | **规划** | **目标** | | --- | --- | --- | --- | | 你批准什么 | 不用额外批 | 实施方案 | 结果和验收标准 | | 智能体做什么 | 读代码、改文件、跑命令、测、接着改 | 先研究仓库，写出一份冻结的方案，然后等你 | 自己选路，一直干到目标达成 | | 什么时候用 | 小改动，想让它直接干 | 改动面大或有风险，想先看做法 | 你只关心结果，不关心路径 | **智能体** 就是默认循环：看代码、改文件、跑命令、继续迭代。 **规划** 是审批边界。智能体先调研，产出一份不能改的实施方案。你点头之前不会动手改仓库。 **目标** 只锁结果。你先确认目标和验收标准，路径交给智能体。 --- ### 把工作委派给子智能体大任务很少适合塞进同一个上下文窗口。 PI-Desktop 可以把相对独立的工作交给后台子智能体，例如： * 代码库探索 * 多文件实现 * 调研与排查 * 测试分析 * 对抗式审查每个子智能体在自己的上下文中运行，并把结果回报给父智能体。 --- ### 为长会话准备的工作区 PI-Desktop 的设计不只是一次提问。你可以管理多个项目和会话，置顶或归档对话，给会话开分支，在智能体运行时排队下一条提示，用 `@` 引用文件，使用斜杠命令，并在应用内搜索。流式回复会写入检查点，因此中断的工作在应用重启或运行时故障后，仍有机会继续。 --- ## 模型由你选 PI-Desktop 不会把智能体运行时锁死在一份硬编码模型名单上。可用： * OpenAI 和 Anthropic * 兼容 OpenAI 的 API * 托管模型网关 * Ollama、LM Studio 这类本地网关 * 同一服务商下的多个模型 * 支持 OAuth 的厂商账号模型配置可包含上下文窗口、输出上限、推理控制、温度，以及其他按模型定制的行为。直接在输入区切换模型，不必重建会话。 --- ## 审阅的是工作，而不只是答案智能体工作区为编程过程中真正重要的内容提供了专门界面：

_{带转录导航的长会话}	_{按会话切换服务商、模型和推理级别}
_{通过插件市场扩展工作区}	_{添加服务商并接入模型}

查看全部界面 →

--- ## 不用重建应用也能扩展按你想把智能体定制到多深，PI-Desktop 提供了多层扩展能力。 ### Skills 给智能体可复用的指令和工作流。 Skills 可以全局安装，也可以按项目启用。 ### MCP 通过 Model Context Protocol 服务器接入外部工具和服务，不必把它们写进桌面应用。 PI-Desktop 也可以被外部 MCP Agent 控制。使用 `PI_DESKTOP_MCP_CONTROL=1` 启动应用，然后从 Electron 用户数据目录中的 `mcp-control.json` 读取本地端点和 bearer token。端点支持项目、会话、Agent 工作流，以及经过审查的桌面操作目录。该功能默认关闭，只绑定本机回环地址，并且对已暴露的操作授予与桌面相同的本机用户权限——`confirm: true` 不是用户确认框。 ### 子智能体创建带有独立指令、工具和模型选择的专用智能体，再从另一个智能体把工作委派给它们。 ### 插件插件可以扩展 PI-Desktop 本身，例如： * 智能体工具 * 命令 * 工作区面板 * 工作面板视图 * Skills * MCP 服务器 * 子智能体 * 主题 * 常驻服务 * 插件间消息插件可通过本地安装或市场安装，使用 `.piplug` 包工作流。 > [!NOTE] > 插件进程受权限控制，并与渲染进程隔离，但插件仍是用户信任代码，而不是完整的操作系统沙箱。请只安装你信任的插件。 [从零开发第一个插件 →](docs/zh-CN/plugin-development.md) --- ## 本地优先，说清楚 PI-Desktop 是 **本地优先**，不是“永远不碰网络”。 | 数据 | 行为 | | -------------------- | ------------------------------------------------------- | | 对话 | 以 JSONL 本地存储，并配 SQLite 索引 | | 设置 | 保存在你的电脑上 | | API 凭证 | 存入操作系统钥匙串 | | 日志 | 仅本地 | | PI-Desktop 遥测 | 无 | | 模型请求 | 直接发往你配置的服务商或接口 | 不需要 PI-Desktop 账号，你的电脑和模型服务商之间也没有强制的 PI 托管中转。如果你使用远程模型服务商，该次请求所需的上下文会按该服务商自己的隐私政策发送过去。 --- ## 下载从 **[GitHub Releases](https://github.com/vastsa/PI-Desktop/releases/latest)** 下载最新构建。 | 平台 | 架构 | 安装包 | | -------- | ------------- | -------------------- | | macOS | Apple Silicon | `.dmg` / `.zip` | | macOS | Intel | `.dmg` / `.zip` | | Windows | x64 | NSIS 安装程序 / 免安装便携版 | | Linux | x64 | `.AppImage` / `.deb` / `.rpm` / `.asar` | 打包版本会检查 GitHub Releases 上的更新，并在应用内提示新版本。Windows NSIS 和 Linux AppImage 可以在应用内下载并安装；macOS、Linux deb/rpm 和 Windows 免安装便携版会打开发布页。Linux `.asar` 文件用于配合系统 Electron 重新打包；补齐目标发行版所需的原生 host 和资源后，可运行 `electron PI-Desktop--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` 查看本机 glibc。 ### macOS 带标签发布工作流程默认发布未签名的 macOS 工件。对于可信的未签名安装，将 `PI-Desktop.app` 移动到 Applications；如果 macOS 提示应用已损坏，双击 `PI-Desktop-macOS-open.command` 即可。手动运行并设置 `sign_macos: true` 时，工作流会在发布前使用 Developer ID 凭据完成 macOS 工件的签名、公证和装订；已签名版本无需使用该助手。 --- ## 导入已有会话已经在用其他编程智能体？ PI-Desktop 可以从受支持的工具导入本机会话，包括： * Claude Code * Codex * OpenCode * Pi 打开 **设置 → 导入**，把已有工作带进桌面工作区。 --- ## 架构 PI-Desktop 有意把用户界面、特权宿主能力和智能体循环分开。 ```mermaid flowchart TB UI["React 渲染进程
对话 · 项目 · 审阅 · 设置"] Electron["Electron 主进程
桌面编排"] Rust["Rust 宿主核心
权限 · 文件系统 · SQLite · 密钥"] Agent["pi 智能体 sidecar
智能体循环 · 模型 · 流式输出"] Provider["模型服务商
云端或本地"] UI --> Electron Electron --> Rust Electron --> Agent Agent <--> Rust Agent --> Provider ``` 渲染进程没有 Node 集成。 **Rust 宿主核心** 负责特权工作区操作、权限、持久化和密钥。**pi 智能体 sidecar** 负责模型交互和智能体循环。Electron 协调桌面生命周期，同时保持这些职责分离。 [阅读架构规格 →](docs/zh-CN/spec/02-architecture/01-architecture.md) --- ## 项目状态 PI-Desktop 处于积极开发中的早期预览阶段。当前 **0.14.x** 版本线包含：桌面外壳、流式智能体运行时、智能体 / 规划 / 目标工作流、带权限的工作区工具、项目与会话、会话导入、本地 MCP 控制、MCP / Skills / 子智能体、后台委派、多服务商模型配置、插件与市场、上下文检查点、通知、更新日志，以及跨平台打包。当前优先事项包括： * macOS 带标签发布的资格验证 * 安装升级与回滚资格验证 * 持续加固运行时和会话恢复 * 更强的插件沙箱与发布者校验 * 更广的 UI 驱动端到端覆盖可通过[项目看板](docs/project/BOARD.md)和[里程碑](docs/zh-CN/spec/06-delivery/01-mvp-milestones.md)跟进开发进展。 --- ## 参与开发 ### 环境要求 * Node.js `>=22.19` * pnpm `>=10` * stable Rust 工具链仓库当前锁定 pnpm 11，CI 与发布构建使用 Node 24。 ### 本地运行 ```bash git clone https://github.com/vastsa/PI-Desktop.git cd PI-Desktop pnpm install cargo build -p host-core pnpm build:js pnpm dev ``` ### 校验改动 ```bash pnpm typecheck pnpm lint pnpm test ``` 更多协议、规划、监管、子智能体和 Electron E2E 套件见仓库规格。 ### 文档 ```bash pnpm docs:dev pnpm docs:check ``` 常用参考： * [文档](https://pi-docs.aiuo.net/) * [规格索引](docs/zh-CN/spec/README.md) * [架构](docs/zh-CN/spec/02-architecture/01-architecture.md) * [产品范围](docs/zh-CN/spec/01-product/01-product-scope.md) * [插件开发](docs/zh-CN/plugin-development.md) * [E2E 测试计划](docs/zh-CN/spec/06-delivery/04-e2e-test-plan.md) * [发布操作手册](docs/zh-CN/spec/06-delivery/06-release-runbook.md) * [仓库智能体指南](AGENTS.md) --- ## 贡献欢迎提交 issue、缺陷报告、功能建议、文档改进和 pull request。较大的改动建议先开 issue，便于与现有架构和产品约定对齐。在仓库中工作时，请从 [AGENTS.md](AGENTS.md) 和[规格索引](docs/zh-CN/spec/README.md)开始。 [报告问题](https://github.com/vastsa/PI-Desktop/issues/new/choose) · [查看未关闭的 issue](https://github.com/vastsa/PI-Desktop/issues) --- ## 建立在开源之上 PI-Desktop 建立在优秀的开源生态之上。智能体运行时使用 **pi-mono** 中的 [`pi-ai`](https://github.com/badlogic/pi-mono) 和 `pi-agent-core`。桌面应用使用的技术包括 Electron、React、TypeScript、Rust、SQLite、Vite、Tailwind CSS、Shiki、Mermaid、KaTeX、TypeBox 和 i18next。感谢每一个让 PI-Desktop 成为可能的项目和贡献者。 --- ## 模型致谢这个项目是由下面这些模型共同创造的——没有唯一的天才，只有一支由 token 驱动的施工队。 | 厂商 | 模型 | Token 总量 | | --- | --- | ---: | | 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 | | 智谱 | `stealth/ox-alpha` | 22,954,876 | | Anthropic | `claude-fable-5` | 16,116,907 | | OpenAI | `gpt-5.1-codex-mini` | 12,895,478 | | 小红书 | `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](https://linux.do/) — 技术交流与分享社区。 ## 许可证 PI-Desktop 采用 **GNU Lesser General Public License v3.0** 授权。详见 [LICENSE](LICENSE)。 ---

### 用你想要的模型构建。把工作流留在自己手里。 **[下载 PI-Desktop](https://github.com/vastsa/PI-Desktop/releases/latest)** _{macOS · Windows · Linux}