PI-Desktop 拆解：给 AI Agent 一个不属于 IDE 也不属于终端的桌面工作台

核心判断

vastsa/PI-Desktop（约 4.9k stars，TypeScript，LGPL-3.0，当前 0.15.x Early Preview）给自己的定位一句话说清了市场空白：终端 Agent 长于执行，IDE Agent 活在编辑器里，而它给 Agent 一个独立的、持久的、可扩展的桌面工作台。

它不是某家模型的壳，也不是某个 IDE 的插件，而是把「项目 / 会话 / Agent / 模型 / 插件 / 工作流」组装成一个桌面平台。发布节奏非常勤：v0.15.3（2026-09-21）当天连发三个 release，主分支当日仍有多个合并 PR，处于快速迭代期。

架构：三栈分工

README 对自身的描述是 “Electron + Rust host core + pi Agent Harness + user-installable plugins”。拆开看：

• Electron 壳：跨平台桌面 UI（macOS 签名 + 公证，Windows / Linux 全覆盖）
• Rust host 核心：承载本地状态与运行时职责（本地优先的关键落点）
• pi Agent Harness：Agent 执行框架
• 插件层：用户可安装的扩展体系

官方用一张分层图概括能力归属：

        Agent              Workspace           Platform
     Agent Tools             Panels              MCP
       Skills              Widgets            Services
     Subagents              Views            Message Bus
   pi Extensions            Themes

三层各自回答一个问题：Agent 层扩展"Agent 能做什么"；Workspace 层扩展"桌面长什么样"；Platform 层扩展"运行时能接什么"。

两个值得注意的设计

Session 是持久资产，不是一次性聊天

组织模型是 Project → Session → Agent → Work，而不是聊天线程。Session 可以置顶、归档、分支、搜索，可以排队输入（Agent 跑着的时候先排下一条指令），可以跨多次应用启动续命，中断的工作尽量恢复。这直接对准了编码 Agent 的真实痛点：上下文丢了就是丢了，重跑一遍成本极高。

两级委派：Subagent 与 Worker Session

复杂工作不该挤在一个上下文窗口里，PI-Desktop 给了两档：

1. Subagent：后台子代理，独立上下文，干完汇报（代码探索、实现、测试分析、调研、review）
2. Session Orchestrator：把工作委派给完整的 Worker Session——每个 Worker 是一个货真价实的 PI-Desktop 会话，有独立上下文、独立执行、可直接打开检查、完整 transcript 可回看。主会话像项目经理一样分派前端 / 后端 / 测试 / review。

第二档是它和"子代理 API 封装"类产品的分水岭：委派出去的不是函数调用，是可独立审计的工作台。

插件能力模型

插件不是"多一个工具按钮"，而可以是一个完整产品。官方给了三个例子：语音 Agent（悬浮球 + 语音服务 + Agent 工具 + 命令）、GitHub 工作区（工作面板 + MCP Server + Agent 工具 + 后台服务）、会话分析（仪表盘 + 命令 + 视图）。

单插件可注册的能力：Command（全局命令）、Panel（独立界面）、Floating Widget（悬浮 UI）、Work Panel View、Agent Tool（Agent 可调用的工具）、Completion、Skill、Theme、MCP Server、后台 Service、插件间 Message Bus。分发支持 .piplug 包和内置市场。

本地优先与模型无关

数据表写得很直白：项目、会话、设置、日志全部本地；API 凭证进 OS 钥匙串；无强制账号、无强制中继、无遥测；模型请求直连用户配置的 provider。

模型侧支持 OpenAI / Anthropic / OpenAI 兼容 API / 自定义网关 / Ollama / LM Studio / 本地模型，每个模型独立配置（provider、上下文窗口、输出上限、推理档位、温度、认证方式）。官方的场景示例很实际：

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

同一个 Session 中途可以换模型——模型是工作流里可替换的组件，不是工作流本身。另外它可以从 Claude Code、Codex、OpenCode、Pi 导入本地会话，迁移成本有交代。

权限层维持经典三段式：工具请求 → Allow / Ask / Deny → 执行，特权操作必须过闸。

上手与边界

下载安装 → 配 provider → 打开本地项目 → 选 Agent / Plan / Goal 三种工作模式之一。Linux 提供 AppImage / deb / rpm / asar，macOS 双架构 dmg。

边界也要说清：0.15.x 是 Early Preview，功能面铺得广（插件总线、编排器、多模型路由全都有），但成熟度和长期维护承诺尚未经过大版本验证；对普通用户，它目前更适合当"第二工作台"试水，而非替换主力 IDE。

一句话总结

PI-Desktop 押注的方向是：Agent 时代需要一个不属于任何编辑器、不属于任何模型厂商的持久桌面层。它的两级委派 + 插件即产品 + 本地优先三件事组合得自洽，值得持续观察。