README

PI-Desktop

 可拆卸的 AI Agent 桌面工作台

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

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













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







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



---

 为什么是 PI-Desktop？

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

PI-Desktop 想做得更进一步：

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






 独立工作台

不依附某个 IDE 或 Terminal。

Project、Session、Review、Preview 与 Agent 都有自己的空间。





 插件驱动

插件扩展的不只是 Agent。

面板、视图、Widget、Tool、MCP、主题与后台服务都可以插件化。





 Agent 编排

一个 Agent 不够，就拆开做。

Subagent 与 Worker Session 可以承担独立任务并行工作。





 模型自由

云端、本地、自建网关、Compatible API。

模型随时换，工作流不用换。








它不是某个模型的壳，也不是某个 IDE 的插件。

 它是承载 Agent 工作流的桌面平台。



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

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

---

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

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

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






 Agent

扩展 Agent 能力

Agent Tools
Skills
Completion
pi Extensions





 Workspace

扩展整个桌面

Commands
Panels
Work Panel Views
Floating Widgets
Themes





 Platform

扩展运行平台

MCP Servers
Resident Services
Plugin Message Bus






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

它可以是一整个产品：

text
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


 插件能做什么？

| 能力                  | 用途                  |
| ------------------- | ------------------- |
| Command         | 向全局命令系统添加操作         |
| Panel           | 创建独立插件界面            |
| Floating Widget | 创建语音球、状态窗、计时器等悬浮界面  |
| Work Panel View | 向右侧工作区加入新视图         |
| Agent Tool      | 注册 Agent 可调用工具      |
| Completion      | 调用用户已经配置的模型         |
| Skill           | 为 Agent 提供可复用能力与工作流 |
| Theme           | 修改工作台视觉             |
| MCP Server      | 接入本地或远程 MCP         |
| Service         | 运行常驻后台任务            |
| Message Bus     | 在插件之间传递消息           |

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



 开发一个插件 →



---

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

text
                         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 提供底座，插件决定它最终长什么样。

---

 三种工作方式






 Agent

你给任务，它直接做。

读代码、改文件、跑命令、测试、持续迭代。

适合日常开发。





 Plan

它先给方案，你确认后再执行。

先研究项目，再生成实施计划。

适合重构与高风险修改。





 Goal

你定义结果，它决定路径。

锁定目标与验收条件，其余交给 Agent。

适合复杂与长期任务。






高权限操作始终经过 PI-Desktop 的 Perm