README.zh.md
July 20, 2026 · View on GitHub
面向任务制的 AI Agent 生产力平台 —— 以 WorkSpace 为单位，重新定义智能体的操作边界与记忆演化。
English | 简体中文
官网 · 在线体验 · 教程 · 快速开始 · 核心亮点 · 使用场景 · 社区
更新日志 🔥
- [2026.05.28] PilotDeck 正式开源！欢迎访问官网 pilotdeck.openbmb.cn，期待社区的贡献、反馈与 Star 支持。
💡 关于 PilotDeck
PilotDeck 是一个以「WorkSpace（工作舱）」为核心设计的开源智能体操作系统，由清华大学 THUNLP 实验室、面壁智能、OpenBMB 与 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)，跨前端（Web / CLI / IM）行为一致。
✨ 核心亮点
|
WorkSpace 级隔离与沉淀 每个项目拥有独立的专属文件系统、记忆库与技能集。多任务并行互不干扰，检索空间有边界，技能随任务自动沉淀，告别全局上下文污染。
|
可追溯的白盒记忆 记忆的生成、抽取、存储与使用全链路可见。AI 记错时可直接定位并手动修改。内置 Dream 模式，利用空闲时间自动归纳整理，并支持一键回滚。
|
|
智能路由与成本优化 内置任务难度识别，复杂任务调用强力模型（如 Claude 3.5 Sonnet / GPT-4o），简单任务降级至轻量模型。通过端云协同与精准匹配，大幅降低 Token 消耗。
|
Always-on 常驻执行 突破"你问我答"的限制。用户离开后，Agent 仍能在后台主动发现潜在任务、执行长周期监控、并最终将成果落地为本地文件与摘要汇报。
|
📊 核心能力实测数据
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)
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 依赖较慢、连接不稳定，可以在运行安装器时指定国内镜像：
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 显式设置一个或多个可信的备用镜像。
pilotdeck # 在 http://localhost:3001 启动服务
pilotdeck status # 查看运行状态
之后如果想在 macOS / Linux 上再次打开 PilotDeck，请在终端运行 pilotdeck，然后在浏览器中打开终端打印的地址。如果当前 shell 还没有刷新 PATH，请新开一个终端，或先 source 对应的 shell 配置文件。
pilotdeck
# 然后打开 http://localhost:3001，或命令打印的地址
方式一补充：一键安装 (Windows 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 中打开：
Start-Process http://localhost:3001
如果脚本刚刚更新了用户 PATH，请新开一个 PowerShell 窗口后运行：
pilotdeck # 在 http://localhost:3001 启动服务
pilotdeck status # 查看运行状态
之后如果想再次打开 PilotDeck，请在新的 PowerShell 窗口运行 pilotdeck，然后在浏览器中打开终端打印的地址。如果当前窗口还识别不到 pilotdeck，可以直接运行启动器：
& "$HOME\.pilotdeck\bin\pilotdeck.cmd"
Windows PowerShell FAQ
首次运行 npm run dev 报错：npm.ps1 因系统禁止运行脚本而无法加载
这个问题现在仍可能出现：当你在 Windows PowerShell 中直接运行 npm run dev 等开发命令时，PowerShell 可能优先解析到 npm.ps1，而默认执行策略会阻止该脚本。
对当前用户设置一次执行策略，然后重新打开 PowerShell：
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
如果不想修改用户执行策略，也可以显式调用 cmd shim：
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 本地执行。
方式二：源码启动 (适合开发者)
需要按平台安装依赖的命令？请查看源码安装指南。
1. 克隆代码与安装依赖
源码安装默认跳过 Git LFS 管理的大型演示媒体文件，以保持安装轻量。如果之后需要演示视频/GIF，可在克隆后运行
git lfs pull下载。
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
PilotDeck 使用仓库提交的 pnpm-lock.yaml 保证源码安装可复现。请优先使用上面的 corepack pnpm ...，不要改用 npm install；在 macOS 上，这也能减少原生依赖不必要地回退到源码编译的概率。
2. 配置模型 Provider
PilotDeck 依赖 ~/.pilotdeck/pilotdeck.yaml 进行配置。您可以手动创建、运行启动脚本自动生成，或者在启动 Web UI 后直接在设置界面中进行可视化配置。
支持 OpenAI、Anthropic、原生 Google Gemini、DeepSeek、Qwen、Kimi、MiniMax 等多种协议。
如果本机还没有配置文件，生产模式启动前请先准备 Web UI 的首次 onboarding 流程：
node scripts/bootstrap-pilotdeck-config.mjs
该命令会初始化 ~/.pilotdeck/pilotdeck.yaml，让 Gateway 可以启动并进入首次 onboarding。随后打开 Web UI，在 onboarding/设置面板中完成 Provider 和 API Key 配置。
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：
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. 启动服务
cd ui && npm run dev # 开发模式 (HMR)，访问 http://localhost:5173
# 或
cd ui && npm run start # 生产模式，访问 http://localhost:3001
方式三：Docker Compose
如果您已安装 Docker，也可以直接使用容器方式启动：
docker compose up -d --build
完整 Docker 配置请查看 README_DOCKER.zh.md。
🛠️ 扩展与插件 (Extension Protocol)
PilotDeck 采用开放的插件架构，插件代码与开源核心严格隔离。开发者可以通过 plugin.json 轻松扩展系统能力：
- MCP Servers: 原生支持集成 Model Context Protocol 服务器。
- Tools & Skills: 注册自定义工具，或通过 ClawHub 引入社区 Skill。
- Lifecycle Hooks: 拦截
PreToolUse、UserPromptSubmit等关键生命周期。 - Custom Memory: 允许接入自定义的记忆存储 Provider。
🤝 参与贡献
感谢所有为 PilotDeck 提交代码与反馈的开发者！我们欢迎新的成员加入，共同构建下一代智能体操作系统。
贡献流程：Fork 本仓库 → 创建 Feature 分支 → 提交 PR。
💬 联系我们
- 关于技术问题及功能请求，请提交 GitHub Issues。
- 欢迎加入我们的社区与我们交流：
| 微信交流群 | 飞书交流群 | Discord 社区 |
 |
 |
 |
🙏 致谢
🏆 社区贡献者
感谢以下社区开发者在 PilotDeck 生态共创挑战赛中贡献的工具、Skill、MCP 与实践案例。
🧩 Skill & MCP
| 作者 | 作品 | 类型 | 链接 | 简介 |
|---|---|---|---|---|
| 盛夏de背影 / @panda-lsy | ChemVision 化学查询 Skill | Skill | GitHub · ClawHub · ModelScope · 小红书 · 个人博客 | PilotDeck 首个垂直学科 Skill，调用 PubChem / OPSIN 真实化学数据库，支持分子结构查询、安全信息与反应预测。 |
| Butterbeer / @AaronAust1n | china-productivity-skills 中文生产力 Skill 包 | Skill Collection | GitHub · PR #335 · 知乎 | 一次性补齐 13 个中文互联网 Skill，覆盖微信公众号、知乎、B站、豆瓣、掘金、微博热搜、arXiv、HN、GitHub Trending 等，可组合成 AIGC 情报雷达流水线。 |
| Butterbeer / @AaronAust1n | industry-landscape-research 行业研究 Skill | Skill | GitHub · PR #336 | 8 步行业研究方法论 Skill，覆盖研究章程、赛道拆解、公司画像、估值追踪、分析框架、单位经济学与投资论点综合。 |
🛠️ 工具 & 部署
| 作者 | 作品 | 类型 | 链接 | 简介 |
|---|---|---|---|---|
| Andrew / @umr2015 | PilotDeck-ReadyKit | 部署工具 | GitHub | Windows + Docker 一键部署包，PowerShell 脚本自动检查环境、生成配置、启动服务与健康验证，支持 Ollama / vLLM 本地模型接入。 |
📊 测评与反馈
| 作者 | 作品 | 类型 | 链接 | 简介 |
|---|---|---|---|---|
| 程序员暮闲 | 国产开源智能体 PilotDeck 实测 | 测评 | B站 · 小红书 · YouTube | 全面覆盖 PilotDeck 安装、配置、项目管理、IM 接入、Skills、MCP、路由、记忆与定时任务等核心功能。 |
| Butterbeer / @AaronAust1n | PilotDeck vs Hermes vs OpenClaw 冷启动实测 | 横评 | 知乎 | 从技术人员冷启动视角横评三款产品，记录关键问题并给出分优先级的产品改进建议。 |
💡 创意分享
| 作者 | 作品 | 类型 | 链接 | 简介 |
|---|---|---|---|---|
| 熊有饭 | 用 PilotDeck 开发在线智能数据系统 | 实践案例 | 微信公众号 | 制造业真实落地案例，用 PilotDeck 将纸质不合格报告与卡顿 Excel 改造为在线智能图表系统，并接入 AI 助手实现自然语言查询。 |
| Agent 折腾日志 | Hermes 记忆系统升级：从 PilotDeck 偷师 | 技术分享 | 小红书 | 研究 PilotDeck 记忆系统设计，并将相关思路应用到 Hermes 记忆系统升级中。 |
🎙️ VoxCPM 特色案例
| 作者 | 作品 | 类型 | 链接 | 简介 |
|---|---|---|---|---|
| 星辰 / @maomao-2001 | ASR + LLM + TTS 实时对话项目 | VoxCPM 案例 | B站 · GitHub · 便携安装包（提取码 TLpM） | 语音输入、大模型理解、语音输出的完整实时对话链路，使用 VoxCPM 做 TTS 引擎，Qwen3.5-9B 做 LLM。 |
开源项目与参考
感谢 OpenClaw、Claude Code、Codex、Cursor、Hermes 等 Agent OS 先行者的探索，为这一领域的发展提供了重要启发。
PilotDeck 的建设离不开以下优秀开源项目的支持：
- ClawXRouter — 智能模型路由
- ClawXMemory — Agent 记忆系统
- Claude Code UI — Web UI 参考
- Claude Code Router — 模型路由参考
- UltraRAG — RAG 框架
- Anthropic Skills — Agent 技能框架和内置技能（skill-creator）
- Vercel Labs Skills — find-skills 技能
- frontend-slides — 用编程 Agent 的前端能力创建精美网页幻灯片
- Karpathy Guidelines — LLM 编码行为准则
- Vite — 前端构建工具
- React — UI 框架
- Tailwind CSS — 原子化 CSS 框架
- shadcn/ui — 可访问的 React 组件原语
🏢 联合研发
PilotDeck 由清华大学 THUNLP、面壁智能、OpenBMB 与 AI9Stars 联合研发。
⭐ 支持我们
如果您觉得 PilotDeck 对您的工作或研究有帮助，请点亮一颗 Star 支持我们！
📝 引用
@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 开源。