PI‑Desktop – 用于 AI 代理的模块化、本地优先桌面

它是什么

PI‑Desktop 是一个跨平台（macOS, Windows, Linux）桌面应用程序，为 AI 代理提供持久且可扩展的工作空间。它不是 IDE 插件或单一 LLM 的轻量封装；相反，它提供了一个桌面平台，您可以在其中运行、编排和管理代理、插件和模型后端。

核心理念

理念	含义
独立工作空间	项目、会话和代理存在于各自的沙盒中，与任何 IDE 或终端分开。
插件驱动	功能通过插件添加，这些插件可以贡献面板、指令、小工具、服务、主题或新的代理工具。
代理编排	一个代理可以生成子代理（轻量级后台工作者）或完整的工作者会话，这些会话可以并行运行，每个都有自己的上下文。
模型自由	您可以将运行时指向 OpenAI, Anthropic, Ollama, LM Studio, 自定义网关或任何本地模型。模型可以在会话间或会话中随时切换。

如何使用

1. 下载 应用程序 (DMG, installer, AppImage 等)。
2. 连接模型，通过添加提供者（API key, endpoint 等）。
3. 打开本地项目 (任何 git repo 或文件夹)。
4. 选择工作流模式：
   • Agent – 给予具体任务，让代理进行编码、运行测试、编辑文件。
   • Plan – 代理在触碰代码之前先产生实施计划。
   • Goal – 您设定结果和验收标准；代理决定路径。

所有工作皆存储在本地：项目、会话、日志和设置永远不会离开您的机器，除非您明确发送请求给远程模型。

插件 – 扩展性界面

插件是一等公民，可以添加以下任何功能：

• Commands (全局动作)
• Panels (独立 UI 窗口)
• Floating widgets (例如：语音球、状态灯)
• Work‑panel views (右侧工作区标签)
• Agent tools / skills / completions (代理可以调用的函数)
• Themes
• MCP servers (桌面可以与之对话的本地/远程服务)
• Background services
• Message bus 用于插件间通讯

插件以 .piplug 软件包形式分发，或通过内置市场获取。

会话模型

• Project → Session → Agent → Work 层级。
• 会话在应用程序重启后持续存在，可以归档、分支、搜索和排队。
• 您可以使用 @ 引用文件、使用斜线指令、查看差异并检查指令输出。
• 子代理和工作者会话让您在不超载单一 LLM 上下文窗口的情况下实现并行处理。

模型无关架构

您为每个模型配置：

• 提供者、模型 ID、上下文窗口、温度等。
• 不同的会话可以使用不同的模型，单一会话也可以即时切换模型（例如：使用 Model A 规划，使用 Model B 编码）。

本地优先与隐私

• 所有数据（项目、会话、日志）皆保留在您的设备上。
• API 凭证存储在 OS 钥匙圈中。
• 无强制账号、遥测或中继服务。
• 权限层让您批准或拒绝特权动作（文件写入、指令执行等）。

开发与扩展

• 建立在 pi 生态系统上 (pi-ai, pi-agent-core, pi-coding-agent)。
• 源代码需要 Node ≥22, pnpm 和稳定的 Rust 工具链。
• 快速开始：git clone … && pnpm install && cargo build -p host-core && pnpm dev。
• 文档包含架构规范、插件开发指南和 E2E 测试计划。

谁适合使用？

• 想要专用 AI 助理桌面而非聊天窗口的开发者。
• 通过插件构建自定义 AI 代理产品（语音代理、DevOps 控制台、数据助理）的团队。
• 实验多代理编排和模型切换的研究人员。

授权

GNU LGPL v3 – 您可以在保持开源的同时使用、修改和重新分发核心。

---

总结： PI‑Desktop 是一个真正的开源平台，让您可以在自己的机器上运行、管理和扩展 AI 代理，并高度专注于模块化、模型无关性和隐私。