PI-Desktop
你的本地优先桌面工作空间，专为 AI 编程代理打造。自带模型。打开任意本地项目。让代理工作——而你始终掌控全局。无需 PI-Desktop 账户。无需强制中继。无编辑器锁定。
下载 PI-Desktop · 文档 · 截图 · 简体中文
一个独立的桌面工作空间，用于编程代理、项目、模型、工具和长时间运行的会话。
重要提示 PI-Desktop 目前处于早期预览阶段。项目正在积极开发中，已可用于真实的编程工作流，但 API、扩展接口以及部分桌面行为可能仍会持续演进。
为什么选择 PI-Desktop？
大多数编程代理存在于终端、编辑器扩展或托管服务中。PI-Desktop 为它们提供了专属的工作空间。
🖥️ 桌面优先
跨仓库和会话工作，无需将代理工作流绑定到某个编辑器或终端。项目、对话、审查、文件、预览、通知和扩展都集中在一个工作空间中。
✨ 自带模型
使用 OpenAI、Anthropic、本地模型、托管网关或任何 OpenAI 兼容 API。配置多个提供商和模型，然后按会话切换。
🔍 默认可审查
代理可以读取文件、编辑代码、运行命令——但特权操作会经过 PI-Desktop 的权限层。审查差异、检查命令输出，并决定每个会话获得多少自主权。
🧩 为扩展而生
添加 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 的设计不止于一次处理一个提示。你可以管理多个项目和会话、固定或归档对话、分支会话、在代理运行时排队提示、使用 @ 引用文件、使用斜杠命令，以及在整个应用程序中搜索。流式响应会进行检查点保存，因此中断的工作在应用程序重启或运行时故障后尽可能得以保留。
你的模型，你的选择
PI-Desktop 不会将代理运行时锁定到硬编码的模型列表。你可以使用：
- OpenAI 和 Anthropic
- OpenAI 兼容 API
- 托管模型网关
- 本地网关，如 Ollama 和 LM Studio
- 同一提供商下的多个模型
- 提供商 OAuth 账户（在支持的情况下）
模型配置可以包括上下文窗口、输出限制、推理控制、温度以及其他模型特定行为。直接从 Composer 切换模型，无需重建会话。
审查工作成果，而不只是答案
代理工作空间包含专为编程中重要事项设计的专属界面：
- 支持转录导航的长时间运行对话
- 按会话切换提供商、模型和推理级别
- 通过插件市场扩展工作空间
- 添加提供商并连接模型
探索所有截图 →
无需重建应用即可扩展
PI-Desktop 有多个扩展层，取决于你想对代理进行多深入的定制。
Skills
为代理提供可复用的指令和工作流。Skills 可以全局安装，也可以为单个项目激活。
MCP
通过 Model Context Protocol 服务器连接外部工具和服务，无需将它们内置到桌面应用程序中。PI-Desktop 也可以被外部 MCP Agent 控制。使用 PI_DESKTOP_MCP_CONTROL=1 启动应用；然后从 Electron 用户数据目录中的 mcp-control.json 读取回环端点和 bearer token。该端点支持项目/会话/Agent 工作流以及经过审查的桌面操作目录。它默认禁用，仅绑定回环地址，并授予调用的本地 Agent 与桌面相同的操作权限——confirm: true 不是用户提示。
Subagents
创建具有自己的指令、工具和模型选择的专用代理，然后从另一个代理向其委派工作。
pi 扩展
为 pi CLI 编写的扩展可以在 PI-Desktop 的代理中不加修改地运行：插件在 contributes.agentExtensions 下列出它们，而 插件 → “导入 pi 扩展” 会为你将现有的扩展文件或目录包装成插件。它们注册工具、斜杠命令和钩子。