PilotDeck

面向任务制的 AI Agent 生产力平台 —— 以 WorkSpace 为单位，重新定义智能体的操作边界与记忆演化。

官方网站 在线体验 License MCP Native Stars
Discord   飞书群   MiniCPM 知识库   微信群

English | 简体中文
官网 · 在线体验 · 教程 · 快速开始 · 核心亮点 · 使用场景 · 社区

--- **更新日志** 🔥 - **[2026.05.28]** PilotDeck 正式开源！欢迎访问官网 [pilotdeck.openbmb.cn](https://pilotdeck.openbmb.cn)，期待社区的贡献、反馈与 Star 支持。 --- ## 💡 关于 PilotDeck **PilotDeck** 是一个以「WorkSpace（工作舱）」为核心设计的开源智能体操作系统，由清华大学 [THUNLP](https://nlp.csai.tsinghua.edu.cn/) 实验室、[面壁智能](https://modelbest.cn/)、[OpenBMB](https://www.openbmb.cn/) 与 [AI9Stars](https://github.com/AI9Stars) 联合研发并开源，面向通用场景、适用于多任务，是 Agent 时代一个真正的「生产力工具」。 当前 AI Agent Harness 领域已涌现出一批优秀的代表成果，各有侧重：**Claude Code / Cursor / Trae Solo** 把模型的推理能力深度集成进了编程 IDE；**Claude Cowork** 引入了项目隔离的概念，把 Agent 带到了桌面端的知识工作场景；**WorkBuddy** 打通了 IM 生态，让 AI 在企微 / 飞书等通讯工具中触手可及。 然而，当我们把视角从"单次编程"或"即时问答"切换到**长周期、多项目并行的生产力创作**时，仍有一些尚未被很好回答的问题： - 多项目并行时，记忆能否做到 **白盒可追溯**？AI 记错了，能否定位到哪条记忆出错、直接修改，而不必重开会话？ - Token 成本能否 **按任务分项追踪**？让后台常驻推进变得经济可行？ - 不同难度的任务，能否 **自动匹配不同模型**？而不是简单任务也跑最贵的旗舰模型？ - 人离开电脑后，活能否继续推进？Agent 能否 **主动发现值得做的事、汇报进展、把成果落地为文件**？ PilotDeck 正是围绕这些问题做的增量探索。它以 WorkSpace 为基本单位，将文件、记忆、技能在项目级别完整隔离与沉淀，并配套提供 **白盒记忆**、**智能路由**、**Always-on** 三大能力，整套系统原生支持 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/)，跨前端（Web / CLI / IM）行为一致。 ### ✨ 核心亮点
**WorkSpace 级隔离与沉淀** 每个项目拥有独立的专属文件系统、记忆库与技能集。多任务并行互不干扰，检索空间有边界，技能随任务自动沉淀，告别全局上下文污染。

WorkSpace 级隔离与沉淀演示

**可追溯的白盒记忆** 记忆的生成、抽取、存储与使用全链路可见。AI 记错时可直接定位并手动修改。内置 **Dream 模式**，利用空闲时间自动归纳整理，并支持一键回滚。

白盒记忆演示

**智能路由与成本优化** 内置任务难度识别，复杂任务调用强力模型（如 Claude 3.5 Sonnet / GPT-4o），简单任务降级至轻量模型。通过端云协同与精准匹配，大幅降低 Token 消耗。

智能路由演示

**Always-on 常驻执行** 突破"你问我答"的限制。用户离开后，Agent 仍能在后台主动发现潜在任务、执行长周期监控、并最终将成果落地为本地文件与摘要汇报。

Always-on 常驻执行演示

### 📊 核心能力实测数据 PilotDeck 的三大核心能力在实际生产环境中展现出了显著的优势： #### 1. 智能路由：社媒场景节省 ～70% 成本 在小红书等社媒运营场景中，开启智能路由后，系统会自动将简单的文本润色、排版任务降级给子 Agent（如 Sonnet 4.5），仅在核心规划节点使用 Opus 4.5，实测成本大幅下降：
方案 模型编排 费用 倍率
开启省钱路由 主 Opus 4.5 + 子 Sonnet 4.5 $2.83 1.1×
不开省钱路由 全 Opus 4.5（主 + 子） $12.58 5.0×
单体大模型 单体 Opus 4.5 长 react（预估） $12.20 4.8×
#### 2. 智能路由：复杂任务 1/6 成本超越顶级模型 研究团队在播客多语言推送、多源数据报告、领域论文综述、代码库架构文档等 7 个复杂任务上进行了对比测试。结果表明，采用"主强子弱"的路由编排，能以极低的成本达到最优效果：
配置 得分 成本
MiniMax-M2.7 单 Agent 37.1 $1.90
Claude Sonnet 4.6 单 Agent 69.1 $18.36
主 Sonnet 4.6 + 子 MiniMax-M2.7 70.6 $3.15
#### 3. 白盒记忆：排版与文风不再"串台" 在传统的黑盒 Agent 中，多任务混居会导致记忆全局污染。PilotDeck 通过 WorkSpace 实现了记忆的白盒化管理：
维度 现有 AI Agent（黑盒） PilotDeck（白盒）
可见性 看不到 AI 记住了什么，只能看到最终输出 随时查看记住了哪些内容、何时记录、属于哪个 WorkSpace
可控性 写入后无法修改、删除，只能等 AI 自己"想明白" 手动改 / 删 / 标记关键节点，重要决策不丢失
可追溯 出错时无法定位根本原因 生成 → 抽取 → 存储 → 使用，每个环节可查可改
隔离性 共享一个记忆池，跨项目互相污染 按 WorkSpace 隔离，A 项目的记忆不会跑到 B 项目
可回滚 上下文压缩后无法查看原始内容 Dream 整理后支持一键回滚到整理前状态，不怕"越整理越乱"
--- ## 🖥️ 交互界面与演示 PilotDeck 提供了开箱即用的 Web UI，支持完整的 WorkSpace 管理、白盒记忆编辑、以及多智能体协作过程的可视化。 ### 使用场景 > 以下所有演示均由端侧模型通过 PilotDeck 智能路由完成生成——无需调用云端大模型。 #### 工作文档生成 > *"调研一下中国大模型应用市场，整理成一份正式的 HTML 白皮书"*
执行过程 最终成果
#### 小游戏开发 > *"用 Vibe Coding 模式陪我做一款 iOS AR 小游戏《找球球》"*
执行过程 最终成果
#### AI 工程平台开发 > *"从零造一个 Embedding 低代码调优平台"*
执行过程 最终成果
#### 音视频剪辑&自媒体运营 > *"把这期英文播客推送给中日法韩西阿六语全球受众"*
执行过程 最终成果（含音频）
https://github.com/user-attachments/assets/a7245467-ee3c-4939-a055-c56576ac56d1
--- ## 📦 安装与快速开始 我们提供了 macOS/Linux 与 Windows PowerShell 下的一键安装脚本，以及适合开发者的源码启动方式。 ### 方式一：一键安装 (推荐, macOS/Linux) ```bash curl -fsSL https://raw.githubusercontent.com/OpenBMB/PilotDeck/main/install.sh | bash ``` 该脚本会检查/使用受支持的 Node.js 22 运行时（22.13+ 且低于 23，内置 SQLite 运行时所需）、克隆代码、安装依赖并编译前端。在 Linux 上，如果存在 `sudo` 和支持的包管理器，脚本可安装缺失的系统依赖；在 macOS 上，请先确保 Xcode Command Line Tools 以及带 `distutils` 的 Python 可用。安装完成后，直接运行： 如果所在网络下载 Node.js 或 npm 依赖较慢、连接不稳定，可以在运行安装器时指定国内镜像： ```bash curl -fsSL https://raw.githubusercontent.com/OpenBMB/PilotDeck/main/install.sh | \ PILOTDECK_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node \ NPM_CONFIG_REGISTRY=https://registry.npmmirror.com bash ``` 如果希望优先使用官方 Node.js 下载地址，也可以通过 `PILOTDECK_NODE_DIST_FALLBACK_MIRRORS` 显式设置一个或多个可信的备用镜像。 ```bash pilotdeck # 在 http://localhost:3001 启动服务 pilotdeck status # 查看运行状态 ``` 之后如果想在 macOS / Linux 上再次打开 PilotDeck，请在终端运行 `pilotdeck`，然后在浏览器中打开终端打印的地址。如果当前 shell 还没有刷新 PATH，请新开一个终端，或先 source 对应的 shell 配置文件。 ```bash pilotdeck # 然后打开 http://localhost:3001，或命令打印的地址 ``` ### 方式一补充：一键安装 (Windows PowerShell) 在普通用户 PowerShell 中执行： ```powershell powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/OpenBMB/PilotDeck/main/install.ps1 | iex" ``` PowerShell 安装脚本会使用 `%USERPROFILE%\.pilotdeck` 下的 Windows 原生路径，检查 Node.js 22.13+ 与 `node:sqlite`，在可用时通过 `winget` 安装缺失依赖，构建 PilotDeck，并在 `%USERPROFILE%\.pilotdeck\bin` 生成 `pilotdeck.cmd` 启动器。Git LFS 媒体资源对核心功能是可选的；如果 Git LFS 不可用或下载超时，安装脚本会跳过演示视频/GIF 并继续安装。 安装完成后，脚本会启动 PilotDeck 并打印 UI 地址，通常是 `http://localhost:3001`。脚本不会自动打开浏览器，请把该地址复制到浏览器中完成初始化配置（Provider + API key）。也可以在 PowerShell 中打开： ```powershell Start-Process http://localhost:3001 ``` 如果脚本刚刚更新了用户 `PATH`，请新开一个 PowerShell 窗口后运行： ```powershell pilotdeck # 在 http://localhost:3001 启动服务 pilotdeck status # 查看运行状态 ``` 之后如果想再次打开 PilotDeck，请在新的 PowerShell 窗口运行 `pilotdeck`，然后在浏览器中打开终端打印的地址。如果当前窗口还识别不到 `pilotdeck`，可以直接运行启动器： ```powershell & "$HOME\.pilotdeck\bin\pilotdeck.cmd" ``` #### Windows PowerShell FAQ **首次运行 `npm run dev` 报错：`npm.ps1` 因系统禁止运行脚本而无法加载** 这个问题现在仍可能出现：当你在 Windows PowerShell 中直接运行 `npm run dev` 等开发命令时，PowerShell 可能优先解析到 `npm.ps1`，而默认执行策略会阻止该脚本。 对当前用户设置一次执行策略，然后重新打开 PowerShell： ```powershell Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned ``` 如果不想修改用户执行策略，也可以显式调用 cmd shim： ```powershell npm.cmd run dev ``` **原生依赖构建失败（提示 `node-gyp`、`MSBuild` 或 Python 缺失）** 安装脚本通常会使用 `node-pty`、`better-sqlite3`、`bcrypt`、`sharp` 等原生依赖的预编译包。全新的 Windows 机器上，如果 npm 无法下载匹配的预编译包并回退到源码编译，请先安装带 C++ 工作负载的 Visual Studio Build Tools 和 Python，然后重新运行安装脚本。 **下载 `install.ps1` 时 GitHub 返回 `429: Too Many Requests`** 共享网络下频繁访问 `raw.githubusercontent.com` 可能触发 GitHub 限流。请等待几分钟后重新运行一键安装命令，或从仓库下载 `install.ps1` 后用 `powershell -ExecutionPolicy Bypass -File .\install.ps1` 本地执行。 ### 方式二：源码启动 (适合开发者) > 需要按平台安装依赖的命令？请查看[源码安装指南](./README_SOURCE_INSTALL.zh.md)。 **1. 克隆代码与安装依赖** > 源码安装默认跳过 Git LFS 管理的大型演示媒体文件，以保持安装轻量。如果之后需要演示视频/GIF，可在克隆后运行 `git lfs pull` 下载。 ```bash GIT_LFS_SKIP_SMUDGE=1 git clone https://github.com/OpenBMB/PilotDeck.git cd PilotDeck node --version # 必须为 v22.13.0 或更新版本，且低于 v23 corepack enable # 启用 package.json 中固定的 pnpm 版本 corepack pnpm install --frozen-lockfile --filter pilotdeck --filter pilotdeck-ui ``` PilotDeck 使用仓库提交的 `pnpm-lock.yaml` 保证源码安装可复现。上述过滤参数会避免 Web 部署安装 Electron 打包依赖。请优先使用上面的 `corepack pnpm ...`，不要改用 `npm install`；在 macOS 上，这也能减少原生依赖不必要地回退到源码编译的概率。 **2. 配置模型 Provider** PilotDeck 依赖 `~/.pilotdeck/pilotdeck.yaml` 进行配置。您可以手动创建，**或者启动 Web UI 后直接在 onboarding 中进行可视化配置**。 支持 OpenAI、Anthropic、原生 Google Gemini、DeepSeek、Qwen、Kimi、MiniMax 等多种协议。 如果配置文件不存在，PilotDeck 会先启动 Web UI 而不启动 Gateway，并直接进入 onboarding。保存有效的 Provider、API Key 和模型后，PilotDeck 会写入配置并自动启动 Gateway。 ```yaml schemaVersion: 1 agent: model: deepseek/deepseek-v4-pro model: providers: deepseek: protocol: openai url: https://api.deepseek.com/v1 apiKey: sk-your-api-key ``` 原生 Gemini 可以使用 `protocol: google`： ```yaml schemaVersion: 1 agent: model: google/gemini-3.1-pro-preview model: providers: google: protocol: google url: https://generativelanguage.googleapis.com apiKey: ${GEMINI_API_KEY} models: gemini-3.1-pro-preview: {} ``` **3. 启动服务** ```bash cd ui && npm run dev # 开发模式 (HMR)，访问 http://localhost:5173 # 或 cd ui && npm run start # 生产模式，访问 http://localhost:3001 ``` ### 方式三：Docker Compose 如果您已安装 Docker，也可以直接使用容器方式启动： ```bash docker compose up -d --build ``` 完整 Docker 配置请查看 [README_DOCKER.zh.md](README_DOCKER.zh.md)。 --- ## 🛠️ 扩展与插件 (Extension Protocol) PilotDeck 采用开放的插件架构，插件代码与开源核心严格隔离。开发者可以通过 `plugin.json` 轻松扩展系统能力： - **MCP Servers**: 原生支持集成 Model Context Protocol 服务器。 - **Tools & Skills**: 注册自定义工具，或通过 [ClawHub](https://www.npmjs.com/package/clawhub) 引入社区 Skill。 - **Lifecycle Hooks**: 拦截 `PreToolUse`、`UserPromptSubmit` 等关键生命周期。 - **Custom Memory**: 允许接入自定义的记忆存储 Provider。 --- ## 🤝 参与贡献 感谢所有为 PilotDeck 提交代码与反馈的开发者！我们欢迎新的成员加入，共同构建下一代智能体操作系统。 贡献流程：**Fork 本仓库 → 创建 Feature 分支 → 提交 PR**。 --- ## 💬 联系我们 - 关于技术问题及功能请求，请提交 [GitHub Issues](https://github.com/OpenBMB/PilotDeck/issues)。 - 欢迎加入我们的社区与我们交流：
微信交流群 飞书交流群 Discord 社区
微信二维码 飞书二维码 Discord 二维码
--- ## 🙏 致谢 ### 🏆 社区贡献者 感谢以下社区开发者在 PilotDeck 生态共创挑战赛中贡献的工具、Skill、MCP 与实践案例。 #### 🧩 Skill & MCP | 作者 | 作品 | 类型 | 链接 | 简介 | |:---|:---|:---|:---|:---| | 盛夏de背影 / [@panda-lsy](https://github.com/panda-lsy) | **ChemVision 化学查询 Skill** | Skill | [GitHub](https://github.com/panda-lsy/chemvision-skill) · [ClawHub](https://clawhub.ai/panda-lsy/skills/chemvision-skill) · [ModelScope](https://www.modelscope.cn/skills/mcshengxia/chemvision) · [小红书](http://xhslink.com/o/7wjpZRCb2aO) · [个人博客](https://shengxia.me/#/posts/4) | PilotDeck 首个垂直学科 Skill，调用 PubChem / OPSIN 真实化学数据库，支持分子结构查询、安全信息与反应预测。 | | Butterbeer / [@AaronAust1n](https://github.com/AaronAust1n) | **china-productivity-skills 中文生产力 Skill 包** | Skill Collection | [GitHub](https://github.com/AaronAust1n/PilotDeck/tree/feat/china-productivity-skills) · [PR #335](https://github.com/OpenBMB/PilotDeck/pull/335) · [知乎](https://zhuanlan.zhihu.com/p/2057150697896931426) | 一次性补齐 13 个中文互联网 Skill，覆盖微信公众号、知乎、B站、豆瓣、掘金、微博热搜、arXiv、HN、GitHub Trending 等，可组合成 AIGC 情报雷达流水线。 | | Butterbeer / [@AaronAust1n](https://github.com/AaronAust1n) | **industry-landscape-research 行业研究 Skill** | Skill | [GitHub](https://github.com/AaronAust1n/PilotDeck/tree/feat/industry-landscape-research) · [PR #336](https://github.com/OpenBMB/PilotDeck/pull/336) | 8 步行业研究方法论 Skill，覆盖研究章程、赛道拆解、公司画像、估值追踪、分析框架、单位经济学与投资论点综合。 | #### 🛠️ 工具 & 部署 | 作者 | 作品 | 类型 | 链接 | 简介 | |:---|:---|:---|:---|:---| | Andrew / [@umr2015](https://github.com/umr2015) | **PilotDeck-ReadyKit** | 部署工具 | [GitHub](https://github.com/umr2015/PilotDeck-ReadyKit) | Windows + Docker 一键部署包，PowerShell 脚本自动检查环境、生成配置、启动服务与健康验证，支持 Ollama / vLLM 本地模型接入。 | #### 📊 测评与反馈 | 作者 | 作品 | 类型 | 链接 | 简介 | |:---|:---|:---|:---|:---| | 程序员暮闲 | **国产开源智能体 PilotDeck 实测** | 测评 | [B站](https://www.bilibili.com/video/BV1mjj46PEZb) · [小红书](https://www.xiaohongshu.com/explore/6a375641000000001702aa75) · [YouTube](https://www.youtube.com/watch?v=EP2mW6el5JM) | 全面覆盖 PilotDeck 安装、配置、项目管理、IM 接入、Skills、MCP、路由、记忆与定时任务等核心功能。 | | Butterbeer / [@AaronAust1n](https://github.com/AaronAust1n) | **PilotDeck vs Hermes vs OpenClaw 冷启动实测** | 横评 | [知乎](https://zhuanlan.zhihu.com/p/2057163316859081709) | 从技术人员冷启动视角横评三款产品，记录关键问题并给出分优先级的产品改进建议。 | #### 💡 创意分享 | 作者 | 作品 | 类型 | 链接 | 简介 | |:---|:---|:---|:---|:---| | 熊有饭 | **用 PilotDeck 开发在线智能数据系统** | 实践案例 | [微信公众号](https://mp.weixin.qq.com/s/7p-A7TumCK2CEP3ouAmZsA) | 制造业真实落地案例，用 PilotDeck 将纸质不合格报告与卡顿 Excel 改造为在线智能图表系统，并接入 AI 助手实现自然语言查询。 | | Agent 折腾日志 | **Hermes 记忆系统升级：从 PilotDeck 偷师** | 技术分享 | [小红书](http://xhslink.com/o/2xEgrIPQyCK) | 研究 PilotDeck 记忆系统设计，并将相关思路应用到 Hermes 记忆系统升级中。 | #### 🎙️ VoxCPM 特色案例 | 作者 | 作品 | 类型 | 链接 | 简介 | |:---|:---|:---|:---|:---| | 星辰 / [@maomao-2001](https://github.com/maomao-2001) | **ASR + LLM + TTS 实时对话项目** | VoxCPM 案例 | [B站](https://www.bilibili.com/video/BV1nFE36mEmc/) · [GitHub](https://github.com/maomao-2001) · [便携安装包](https://pan.quark.cn/s/e3c9253ba232)（提取码 TLpM） | 语音输入、大模型理解、语音输出的完整实时对话链路，使用 VoxCPM 做 TTS 引擎，Qwen3.5-9B 做 LLM。 | ### 开源项目与参考 感谢 OpenClaw、Claude Code、Codex、Cursor、Hermes 等 Agent OS 先行者的探索，为这一领域的发展提供了重要启发。 PilotDeck 的建设离不开以下优秀开源项目的支持： - [ClawXRouter](https://github.com/OpenBMB/ClawXRouter) — 智能模型路由 - [ClawXMemory](https://github.com/OpenBMB/ClawXMemory) — Agent 记忆系统 - [Claude Code UI](https://github.com/siteboon/claudecodeui) — Web UI 参考 - [Claude Code Router](https://github.com/musistudio/claude-code-router) — 模型路由参考 - [UltraRAG](https://github.com/OpenBMB/UltraRAG) — RAG 框架 - [Anthropic Skills](https://github.com/anthropics/skills) — Agent 技能框架和内置技能（skill-creator） - [Vercel Labs Skills](https://github.com/vercel-labs/skills) — find-skills 技能 - [frontend-slides](https://github.com/zarazhangrui/frontend-slides) — 用编程 Agent 的前端能力创建精美网页幻灯片 - [Karpathy Guidelines](https://x.com/karpathy/status/2015883857489522876) — LLM 编码行为准则 - [Vite](https://github.com/vitejs/vite) — 前端构建工具 - [React](https://github.com/facebook/react) — UI 框架 - [Tailwind CSS](https://github.com/tailwindlabs/tailwindcss) — 原子化 CSS 框架 - [shadcn/ui](https://github.com/shadcn-ui/ui) — 可访问的 React 组件原语 --- ## 🏢 联合研发

PilotDeck 由清华大学 THUNLP、面壁智能、OpenBMB 与 AI9Stars 联合研发。

--- ## ⭐ 支持我们 如果您觉得 PilotDeck 对您的工作或研究有帮助，请点亮一颗 Star 支持我们！ --- ## 📝 引用 ```bibtex @misc{pilotdeck2026, author = {PilotDeck Team}, title = {PilotDeck: A WorkSpace-Centric Open-Source Agent Operating System}, howpublished = {\url{https://github.com/OpenBMB/PilotDeck}}, year = {2026}, note = {Accessed: 2026-05-29} } ``` ## 📄 许可证 本项目基于 [GNU Affero General Public License v3.0](LICENSE) 开源。