PilotDeck 使用教程

📖 项目简介

PilotDeck 是一个以「WorkSpace（工作区）」为核心的开源 AI Agent 操作系统，由清华大学 THUNLP、面壁智能（ModelBest）、OpenBMB 与 AI9Stars 联合开发并开源。它面向「长周期、多项目」的真实生产力工作场景——当你同时推进很多项目时，把每个项目的文件、记忆、技能彻底隔离开，让 AI 真正成为一个能长期托管任务、还能在你离线后继续干活的生产力工具。

和 Claude Code / Cursor 这类「一次性编程」、或即问即答的助手不同，PilotDeck 把重心放在 白盒记忆、智能路由、常驻执行三大能力上，原生支持 MCP 协议，并在网页端、命令行、IM（企微 / 飞书）等多端表现一致。

💡

GitHub 地址： https://github.com/OpenBMB/PilotDeck
官方网站： https://pilotdeck.openbmb.cn

✨ 核心亮点

🗂️

WorkSpace 级隔离

每个项目独立的文件、记忆与技能，多任务并行互不污染，检索范围有界

🧠

白盒记忆

记忆的生成、抽取、存储、检索全程可见，记错能定位到具体条目直接改，支持一键回滚

🔀

智能路由省成本

自动判断任务难度，难任务上旗舰模型、简单任务走轻量模型，社媒场景实测省约 70% 费用

🤖

常驻后台执行

你下线后 AI 继续发现候选任务、跑长周期监控，最终把成果落成本地文件并附总结报告

📊

真实数据：在小红书风格的社媒运营工作流中，开启智能路由后成本从 $12.58 降到 $2.83，约为原来的 1/5；在 7 个复杂任务评测中，「强主模型 + 轻量子模型」的路由方案以约 1/6 的成本追平甚至超过前沿单模型。

🚀 如何使用

方式一：一行命令安装（推荐，macOS / Linux）

                bash
                curl -fsSL https://raw.githubusercontent.com/OpenBMB/PilotDeck/main/install.sh | bash
            

脚本会自动安装 Node.js 22、克隆仓库、安装依赖并构建前端。完成后：

                bash
                pilotdeck            # 启动服务，访问 http://localhost:3001
pilotdeck status     # 查看运行状态
            

方式二：源码安装（开发者）

克隆仓库并安装依赖

仓库使用 Git LFS 管理大体积媒体文件，克隆前请先安装 git lfs；若不需要演示视频/GIF，可在 git clone 前加 GIT_LFS_SKIP_SMUDGE=1 跳过。

                        bash
                        git clone https://github.com/OpenBMB/PilotDeck.git
cd PilotDeck
npm install              # 根目录依赖（Gateway 运行时）
cd ui && npm install     # 前端 UI 依赖
cd ..
                    

配置模型供应商

PilotDeck 读取 ~/.pilotdeck/pilotdeck.yaml。可手动创建、让引导脚本生成，也可以直接打开 Web UI 在设置面板里可视化配置。支持 OpenAI、Anthropic、DeepSeek、Qwen、Kimi、MiniMax 等所有 OpenAI 兼容协议。

                        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
                    

启动服务

                        bash
                        cd ui && npm run dev     # 开发模式（HMR），访问 http://localhost:5173
# 或
cd ui && npm run start   # 生产模式，访问 http://localhost:3001
                    

方式三：Docker Compose

                bash
                docker compose up -d
            

🛠️ 扩展协议

PilotDeck 采用开放插件架构，核心开源、插件可定制，一个 plugin.json 即可扩展系统：

MCP Servers —— 一等公民集成任意 Model Context Protocol 服务器
Tools & Skills —— 注册自定义工具，或通过 ClawHub 拉取社区技能
Lifecycle Hooks —— 拦截 PreToolUse、UserPromptSubmit 等关键生命周期事件
Custom Memory —— 接入你自己的记忆存储提供方

❓ 常见问题

Q: PilotDeck 和 OpenClaw / Claude Code 有什么区别？

OpenClaw、Claude Code 等更偏「一次性编程」或即问即答；PilotDeck 面向长周期、多项目的生产力工作，强调 WorkSpace 隔离、白盒记忆、智能路由和常驻后台执行，目标是让 AI 长期托管任务并自动落地成果。

Q: 为什么能省 70% 的 token 费用？

靠「智能路由」自动判断任务难度：规划等复杂环节才调用旗舰模型（如 Opus），润色、排版等简单任务自动降级给轻量子模型（如 Sonnet）。社媒运营实测成本约为全程旗舰模型的 1/5，质量基本不打折。

Q: 支持 Windows 吗？

一行命令安装脚本面向 macOS / Linux；Windows 用户可使用源码安装或 Docker Compose 方式运行。

Q: 白盒记忆的「一键回滚」是什么？

PilotDeck 内置 Dream Mode，会在空闲窗口整理/压缩记忆。和黑盒 Agent 压缩后原文即丢失不同，它支持一键回滚到压缩前的状态，记忆全程可审计、可编辑、可固定关键决策。