PI-Desktop

可拆卸的 AI Agent 桌面工作台

把项目、Agent、模型、插件和工作流，装进一个长期可用的桌面环境。

本地优先 · 模型自由 · 插件驱动 · macOS / Windows / Linux

立即下载 · 使用文档 · 插件开发 · 界面预览 · English

你的项目留在本地 · 你的模型由你选择 · 你的工作台由你组装

为什么是 PI-Desktop？

终端 Agent 擅长执行，IDE Agent 擅长嵌入编辑器。

PI-Desktop 想做得更进一步：

给 AI Agent 一个独立、长期、可扩展的桌面工作空间。

[!NOTE] PI-Desktop 目前仍处于 Early Preview。 已可用于真实开发工作流，部分 API、插件接口与桌面能力仍在持续演进。

当前发布线：0.21.x（Early Preview）。

插件不是附加功能，而是工作台的一部分

PI-Desktop 的 Core 负责提供稳定底座。

真正属于你的工作流，由插件组合出来。

插件不必只是“给 Agent 多加一个 Tool”。

它可以是一整个产品：

Voice Agent
├── Floating Widget
├── Speech Service
├── Agent Tool
└── Commands

GitHub Workspace
├── Work Panel
├── MCP Server
├── Agent Tools
└── Background Service

Session Analytics
├── Dashboard
├── Commands
└── Workspace View

插件能做什么？

插件可以通过 .piplug 分发，也可以从插件市场安装。

一个底座，组装不同的工作流

                         PI-Desktop
                             │
          ┌──────────────────┼──────────────────┐
          │                  │                  │
        Agent            Workspace           Platform
          │                  │                  │
     Agent Tools           Panels              MCP
       Skills             Widgets            Services
     Subagents             Views            Message Bus
   pi Extensions          Themes
          │                  │                  │
          └──────────────────┼──────────────────┘
                             │
                       Your Workflow

PI-Desktop 可以只是一个 Coding Agent。

也可以被组装成：

AI 开发工作台 · Voice Agent · DevOps Console · GitHub Workspace · 数据分析助手 · 多 Agent 调度中心 · 自动化平台

Core 提供底座，插件决定它最终长什么样。

三种工作方式

高权限操作始终经过 PI-Desktop 的 Permission Layer。

一个 Agent 不够，就拆开做

复杂任务不应该全部挤在一个 Context 里。

PI-Desktop 提供两层任务拆分能力。

Subagents

把独立工作交给后台 Agent：

代码调查 · 独立实现 · 测试分析 · Research · Review

每个 Subagent 拥有独立 Context，完成后将结果返回主 Agent。

Session Orchestrator

需要更完整、更长期的并行任务时，可以继续拆成多个 Worker Session。

Main Session
│
├── Worker A
│   └── Frontend
│
├── Worker B
│   └── Backend
│
├── Worker C
│   └── Tests
│
└── Worker D
    └── Review

Worker 是完整的 PI-Desktop Session：

独立 Context · 独立运行 · 可直接查看 · 可持续接受任务 · 保留完整 Transcript

一个 Session 编排多个 Worker

每个 Worker 都是完整、可查看的 Session

为持续工作而设计

PI-Desktop 围绕：

而不是围绕一次性聊天窗口设计。

支持：

• 多 Project / 多 Session
• Pin / Archive / Branch / Search
• Agent 运行时继续 Queue Prompt
• 使用 @ 引用项目文件
• Slash Commands
• Diff Review
• Command Output
• Work Panel
• Streaming Checkpoint
• 异常后尽可能恢复任务现场

Session 可以跨多次启动持续工作。

看见 Agent 在做什么

长期 Session，而不是一次性对话	在 Session 中直接切换模型与推理等级
插件市场：扩展 Agent，也扩展整个桌面	连接 Provider、Gateway 或本地模型

模型可以换，工作流不用换

PI-Desktop 不把 Agent 工作流绑定到某一家模型厂商。

支持：

OpenAI · Anthropic · OpenAI Compatible API · 自建 Gateway · Ollama · LM Studio · Local Model

每个模型都可以独立配置：

Provider · Model ID · Context Window · 最大输出 · Reasoning / Thinking · Temperature · OAuth · API Key · Endpoint

不同 Session 可以使用不同模型。

同一个 Session 也可以随时切换。

Planning     → Model A
Coding       → Model B
Review       → Model C
Private Task → Local Model

模型是可以替换的组件，而不是工作流本身。

已经在用其他 Coding Agent？

已有工作不需要从零开始。

PI-Desktop 可以导入本地 Session：

Claude Code · Codex · OpenCode · Pi

Local-first

PI-Desktop 不要求你把开发环境搬到我们的云端。

无需 PI-Desktop 账号。

无需经过 PI-Desktop 云端 Relay。

使用远程模型时，请求所需 Context 会直接发送给对应 Provider。

权限属于你

Agent 可以读取文件、修改代码、运行命令、调用 Tool、使用扩展和委派任务。

高权限操作仍然经过 Permission Layer：

Agent
  ↓
Tool Request
  ↓
Permission Layer
  ↓
Allow / Ask / Deny
  ↓
Execution

你决定每个 Session 拥有多少自主权。

开始使用

安装包

macOS Release 使用 Developer ID 签名并经过 Apple Notarization。

ldd --version

Built on Pi

PI-Desktop 构建在 pi 生态之上。

Agent Runtime 使用：

• pi-ai
• pi-agent-core
• pi-coding-agent

Pi 提供 Agent Engine，PI-Desktop 在其上构建 Desktop Workspace、Session、权限、插件与 Agent 编排。

开发者

PI-Desktop 也可以作为开发者构建 Agent 产品的宿主平台。

你可以开发：

Plugin · MCP Server · Skill · Agent Tool · pi Extension · Theme · Panel · Floating Widget · Background Service

插件快速开始

内置模板：

• panel-basic
• agent-tool-basic
• skill-pack
• full-demo

创建完成后即可作为 Development Plugin 加载。

Plugin Development Guide →

从源码运行

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

文档

Documentation · Architecture · Specification · Plugin Development · E2E Test Plan · Release Runbook · AGENTS.md

Contributing

欢迎：

Issues · Pull Requests · Plugins · Skills · MCP Integrations · Documentation · Translations

对于相对独立的新能力，优先考虑一个问题：

它是否更适合作为一个 Plugin？

让 Core 保持克制，让生态持续生长。

提交 Issue · 查看 Issues · 开发插件

项目趋势

友情链接

Linux.Do — 新的理想型社区

Model Acknowledgements

Not by a lone genius, but by a token-powered construction crew.

PI-Desktop 的开发过程中使用了来自多个 Provider 的模型。

累计模型使用量已超过 27 Billion Tokens。

感谢参与构建 PI-Desktop 的每一位贡献者，以及陪我们一起写下这些代码的模型。

License

PI-Desktop 使用 GNU Lesser General Public License v3.0。

详见 LICENSE。

PI-Desktop

Build your own Agent workspace.

你的模型 · 你的 Agent · 你的插件 · 你的工作台

立即下载 · Documentation · Build a Plugin

_{Local-first · Model-agnostic · Plugin-powered}