PilotDeck
面向生产力的智能体开源平台
逐步使用工作舱、记忆、技能与常驻任务。先熟悉基础界面与工作模式，再按项目需要启用路由、记忆、定时任务与消息渠道。
只提供基础使用，高阶彩蛋自行探索
一、基础界面介绍
PilotDeck 界面分为两个区域：左侧为项目目录区，右侧为对话区域。左上方有开始新对话、查看技能等快速入口；右上角可查看当前项目的详情，包括项目文件、项目记忆、常驻任务运行状态与路 由使用情况。点击右上角的搜索按钮，可对对话内容进行模糊检索。
项目与工作空间
一个项目对应一个工作空间，PilotDeck 在此空间中读取和保存文件，主要包含项目文件、项目记忆、项目技能与项目会话，避免项目间相互干扰。通用对话适合临时问答等轻量任务；需要读写文件、长期积累上下文或反复修改成果时，建议显式创建项目。
创建项目时，可点击左侧“项目”标题右侧的 +，或点击输入框下方的项目选择器“新建项目”。
进入创建向导后，点击工作区后方的“选择文件夹”，选择“现有文件夹”或“新建文件夹”，也可选填 GitHub URL 从仓库克隆。
切换项目：
- 发送新对话：点击输入框下方的项目名称，在列表中搜索并选择目标项目。
- 查看历史任务：点击左侧项目名称，再点击项目旁的新建对话按钮创建新对话，或点击某一对话查看历史信息。
工作模式
当前提供“智能体”“计划”“询问”三种模式，点击输入框左下角的 + 切换。
| 模式 | 工作方式 | 适用场景 |
|---|---|---|
| 智能体（Agent） | 理解要求后直接调用工具完成任务 | 目标明确、任务范围清楚的任务 |
| 计划（Plan） | 先拆解目标并给出实施计划，确认后再执行 | 复杂、长周期或影响范围较大的任务 |
| 询问（Ask） | 侧重解释、分析和回答问题，不修改文件 | 概念咨询、文件解读等只需要分析和回答的任务 |
模型切换
点击输入框右下方显示的模型名称与推理强度按钮（显示“自动”表示按已配置的路由策略自动选用模型），在列表中搜索并选择目标模型；所用模型需在“设置 → 模型池”中预先配置。切换模型时对话历史保留，从上下文窗口较大的模型切换至较小模型时需注意上下文溢出。
操作权限
“默认权限”下常规操作按规则执行、遇到风险操作先询问；“完全访问权限”跳过确认并允许更广泛的文件、命令和网络操作。点击输入框下方的权限按钮即可切换。
输入框交互
支持添加文件 / 文件夹，一共有三种方法：
-
点击输入框左下角
+，选择“文件”添加本地内容作为任务上下文，或选择“文件夹”保留目录层级并上传全部内容。
-
点击右上角的“文件”，将文件或文件夹直接拖入工作区目录中。
-
直接拖入对话框。
引用技能
- 自动选用：PilotDeck 会根据你的任务描述，自动判断需要调用的技能并使用。
- 手动指定：点击输入框左下角
+，搜索并选择适合当前任务的技能，点击选择后确认技能标签已经添加，再描述具体目标并发送。
调用斜杠命令
命令是 PilotDeck 预先定义好的常用操作或标准工作流。在输入框中输入 / 会打开当前可用的命令列表。继续输入关键字筛选，选择目标命令，并输入自然语言要求。
对话补充
对话补充用于在 PilotDeck 执行任务时追加新要求、纠正理解或补充限制条件。补充内容可通过“调整方向” 加入当前任务，PilotDeck 会据此调整后续工作，无需另开一轮对话。
- 在任务运行过程中，编辑新要求并发送，新要求内容会出现在对话框上方。
- 点击对话框上方的“调整方向”，新内容被加到对话中。若不点击，则会等到当前任务完成后发送并执行。
- 继续观察 Agent 的执行步骤和工具活动，确认后续工作已经按新方向推进。
对话检索
点击右上角的搜索按钮，可对上下文进行模糊搜索。
二、后台常驻
常驻指的是在用户没有主动发送新任务时，PilotDeck 可以定期检查已经启用的项目，发现值得继续推进的工作，并在后台完成任务、生成报告，在用户确认任务保留后再归档。
常驻的基本工作过程为：
- PilotDeck 定期检查已启用常驻的项目。
- 根据项目文件、记忆、最近对话和已有计划寻找可继续推进的工作。
- 如果存在合适任务，生成一份计划。
- 在隔离工作区中执行计划。
- 生成执行报告，并将结果显示在常驻界面中。
- 你检查结果后，决定应用或归档本轮工作。
常驻与普通对话、定时任务的区别：
| 功能 | 如何触发 | 适合的任务 |
|---|---|---|
| 普通对话 | 用户主动发送请求 | 需要立即处理的明确任务 |
| 常驻 | PilotDeck 根据项目状态自动发现任务 | 持续维护、主动补全和长期推进的项目工作 |
| 定时任务 | 到达用户设置的时间后执行 | 每天、每周或指定时间重复运行的固定任务 |
开启常驻与设置触发条件
常驻按项目开启，进入“设置 → 智能体 → 常驻”，在左侧项目列表中找到目标项目，开启该项目右侧的常驻开关。在“触发”区域单击“编辑”，可以调整以下参数：
| 参数 | 作用 |
|---|---|
| 检查间隔 | 两次检查之间的最短时间 |
| 冷却时间 | 一轮常驻任务结束后，再次触发前的等待时间 |
| 每日预算 | 单个项目每天可执行的常驻任务数量上限 |
| 心跳过期 | 判断上一轮常驻任务是否中断的时间阈值 |
| 最近用户消息 | 距离上一条用户消息的时间，用于避免与正在进行的对话冲突 |
初次使用时建议保留默认参数。需要降低模型调用频率时，可以延长检查间隔和冷却时间，或降低每日预算。
查看常驻面板
选择任意项目，点击右上角“探索 → 常驻”，进入常驻面板，包含 2 类内容：
- 仪表盘：用于查看常驻任务的整体运行情况，主要包括常驻事件、今日事件数量、活跃项目和正在运行的任务。
- 计划：各个项目已经生成的计划、所在工作周期、创建时间、状态和可用操作。
点击计划列表中某个具体任务，可查看其执行 的计划与报告，并跳转至会话页面。
应用或归档结果
常驻任务默认在隔离工作区中执行。页面显示“执行完成”时，改动还没有进入主工作区。确认结果无误后，在“计划”页面对应的工作周期中单击“全部应用”，将该工作周期内的改动应用到主工作区。一个工作周期可能包含多个计划，“全部应用”会处理这个周期中的整体结果。
如果不需要保留这一轮结果，可以归档对应的工作周期。执行失败的计划可以单击“重新执行”，但重新执行会再次调用模型和工具，应先查看失败原因。
三、Memory 记忆
PilotDeck 会从对话和任务中提取有长期价值的信息，经过索引后，在后续任务需要时检索相关内容，如你的长期偏好、项目背景、已确认的决定和协作要求。PilotDeck 提供白盒化记忆，可审计、可追溯。
记忆通常包括以下内容：
| 类型 | 记录的内容 | 示例 |
|---|---|---|
| 项目记忆 | 项目进展、关键事实与当前状态 | 已交付的报告版本、尚未解决的问题 |
| 通用记忆 | 可跨项目复用的稳定信息 | 常用的文档结构、惯用的工具链 |
| 协作反馈 | 用户对交付物的偏好、约束与验收规则 | 报告需标注数据来源、术语先解释再展开 |
| 用户画像 | 用户的长期身份、角色与工作习惯 | 负责文档站内容、偏好中文输出 |
记忆的适用范围不同：
- 项目记忆：只与某个项目有关的信息。
- 通用记忆与用户画像：能够在多个项目中复用的稳定信息。
开启记忆
首次使用前，进入“设置 → 智能体 → 记忆”：
- 打开“启用记忆”开关。
- 设置处理记忆所用的模型，默认选择继承主智能体模型。
- 设置自动索引和自动 Dream 的执行间隔。将自动索引或自动 Dream 的间隔设置为
0，表示关闭对应的自动任务。
写入与召回记忆
与 PilotDeck 对话即可形成记忆。对于希望长期保留的内容，建议明确说明事实、适用范围和使用方式。例如：
请记住：在“官网文档”这个项目中，所有功能介绍都面向第一次使用 PilotDeck 的用户。
出现专业术语时，要先用一句话解释它是什么，再介绍操作步骤。
记忆提取和索引可能需要一段时间。如果某要求在当前任务中必须执行，请同时把它写在本次提示词中，不要只依赖长期记忆。
当你在同一项目中发起新任务时，PilotDeck 会根据当前问题检索相关的项目记忆和用户信息。PilotDeck 只会召回它判断为与当前任务有关的内容，因此记忆库中存在某条记录，不代表每个任务都会使用它。
查看记忆与记忆追踪
在左侧项目列表中选择项目（通用项目无法查看记忆），点击右上角“探索 → 记忆”，右侧打开记忆面板，可查看项目信息、项目记忆和协作反馈。
- 项目信息：项目名称、项目摘要、项目状态和项目路径。
- 项目记忆：当前项目的进展、事实和状态记录。
- 协作反馈：用户对当前项目的偏好、约束和交付规则。
PilotDeck 支持项目记忆检索，在顶部搜索框输入关键词即可。点击右上角“探索 → 记忆 → 记忆追踪”，可以查看 PilotDeck 如何生成、使用和整理记忆，实现记忆审计。当 Agent 的回答不合理时，可以通过记忆追踪定位问题。
四、Routing 省钱路由
智能路由根据任务的复杂程度为每轮请求选择合适的模型：简单任务交给速度快、成本低的模型，复杂任务可以使用能力强的模型，在保证任务效果的同时减少不必要的 Token 消耗。路由相关的几个关键概念如下：
| 概念 | 作用 |
|---|---|
| 判定模型 | 判断当前请求属于哪个任务层级，本身主要负责分类 |
| 任务层级 | 描述不同复杂程度的任务 |
| 默认层级 | 无法明确匹配任务层级时使用的层级 |
| 层级模型 | 执行该层级任务的模型 |
| 子智能体策略 | 决定子智能体任务是否重新判断任务层级 |
| 模型定价 | 用于估算不同模型产生的调用成本 |
PilotDeck 预置了四个任务层级：
| 层级 | 适合的任务 |
|---|---|
| Simple | 快速问答、确认、轻量改写和简单文件操作 |
| Medium | 单次工具调用、短文本生成、少量文件修改和常规代码变更 |
| Reasoning | 多文件分析、长上下文、数据分析、研究和深度推理任务 |
| Complex | 需要拆分任务或交给多个子智能体并行处理的工作 |
准备模型
在“设置 → 模型池”内，添加路由准备使用的模型，建议至少准备 2 个模型。
开启路由
进入“设置 → 智能体 → 路由”，开启“启用智能路由”。关闭智能路由时，主智能体会直接使用当前对话所选模型，子智能体默认继承主智能体模型，支持切换其他模型。
选择判定模型
在“路由模型”中，为“判定模型”选择一个模型。判定模型需要快速理解请求并判断复杂度，通常可以选择速度较快、成本较低，同时具备基本指令理解能力的模型。
为任务层级分配模型
分别为 Simple、Medium、Reasoning 和 Complex 4 个任务层级选择执行模型。选择模型时需要确认模型是否具备任务执行的能力，例如图片输入、工具调用和足够的上下文长度。单击某个层级旁的“设为默认”，可在无法明确任务层级时使用该层级；通常可以将 Medium 设置为默认层级，在成本和能力之间取得平衡。
发起任务
配置完成后，将对话框右下角的模型改为“自动”，即可使用路由策略执行任务。
查看路由结果
点击右上角“探索 → 路由”，打开路由看板，查看路由使用情况，主要包括：
| 数据 | 含义 |
|---|---|
| 请求数 | 路由器处理的模型请求数量 |
| Token 数 | 模型调用产生的输入和输出 Token |
| 成本 | 根据模型定价估算的调用费用 |
| 会话 | 每个会话中的主智能体、子智能体和模型使用情况 |
| 最近调用 | 最近请求使用的时间、项目、供应商、模型和 Token 数量 |
成本区域还会对比“实际开销”和“不走 Router 开销”。其中“不走 Router 开销”是假设所有路由 Token 都交给主模型后的估算值。可切换“项目”或“总计”，查看项目或整体路由的使用情况。
高级设置
子智能体策略：普通用户完成判定模型和各层级模型的配置后即可开始使用。需要进一步调整时，在“设置 → 智能体 → 路由”中展开“高级设置”。PilotDeck 支持两类子智能体策略：
judge：每个子智能体任务都会判断任务层级，并选择对应模型。skip：子智能体不再重新判断，固定使用“子智能体模 型”，此时需要设置子智能体模型。
任务层级定义：单击任务层级定义旁的“编辑”，修改层级名称和描述，或添加自定义层级。层级描述是判定模型分类的重要依据，应清楚说明该层级适合处理哪些任务。添加任务层级后，需要在上方“路由模型”内，为该任务层级配置执行所用的模型。
模型定价：模型定价用于计算路由看板中的成本数据。可以为每个模型设置输入、输出和缓存读取价格，并选择美元或人民币作为显示单位。
五、Skill
技能（Skill）是 PilotDeck 的能力扩展机制。它把处理某一类任务需要的方法、步骤和注意事项整理成一套可复用的工作流程，帮助 Agent 更准确、更稳定地完成任务。技能可以做到：
- 让专业任务更容易完成：技能可以为 Agent 补充特定领域的操作方法。
- 减少重复说明：经常使用的格式、步骤和验收规则可以放入技能。以后执行同类任务时，不必在每次对话中重复输入完整要求。
- 让结果更稳定：技能为 Agent 提供明确的执行顺序和检查标准，可以减少步骤遗漏、格式不一致以及不同任务之间的结果波动。
- 沉淀个人和项目经验：个人工作习惯可以保存为用户技能，在不同 WorkSpace 中重复使用；只适用于某个项目的术语、规范和流程，可以保存为项目技能，与该 WorkSpace 一起持续使用。
使用技能
- 自动使用：当任务与某个技能的用途明显匹配时，Agent 可以根据技能描述判断是否使用它。如果任务很重要，或者你希望 Agent 严格遵循某个特定流程，建议手动选择技能，并在提示词中明确说明。
- 手动选择：点击输入框左下角的
+，搜索并选择适合当前任务的技能，点击选择后确认技能标签已经添加，再描述具体任务并发送。
确认技能是否生效：发送前，检查所选技能是否已出现在输入区域；发送后，可以结合执行过程和最终产物判断技能要求是否被采用。
技能分类
点击左侧导航栏中“技能”按钮，查看当前可用的技能。选中某一技能，进一步查看它适合处理的任务类型，以及执行时遵循的要求。PilotDeck 中的技能分为 2 类：
- 用户技能：即全局技能，可以在不同项目中使用，如文档、表格等常见、通用技能。
- 项目技能：只在当前项目中使用，如项目术语、写作规范等项目专用技能。
当对话没有关联具体项目时，只能使用用户技能；进入某个项目后，还可以使用该项目的项目技能。如果技能名称相同，采用的优先级为：项目技能 → 用户技能。
新增与编辑技能
点击“技能 → 新建”，进入新增技能页面。PilotDeck 提供三种方式：从 ClawHub 安装、从文件夹导入和自己写一个。
在技能管理页选择一个技能，可以查看它的路径和 SKILL.md：若想修改内置技能，先创建用户覆盖版本，再对覆盖版本进行修改；用户技能和项目技能支持编辑并保存；支持技能删 除与调整技能范围（用户或项目）。
删除技能会移除整个技能文件夹，执行删除前请再次确认内容。
六、定时任务
PilotDeck 按设定的时间自动唤起智能体执行预先写好的提示词，适合周报、定期检查、固定时间提醒等时间明确、操作规则固定的工作。支持两种创建方式。
对话内创建
在目标项目的对话中，明确提出“创建定时任务”，并写清任务内容、执行时间、时区，以及只执行一次还是按固定周期重复执行，然后发送创建请求。例如：
请为当前项目创建一个周期性定时任务：每周五 18:00（Asia/Shanghai）执行。读取当前工作区的“进展记录.md”和“项目计划.md”，整理本周已完成事项、风险和下周计划，保存到“周报/YYYY-MM-DD.md”，文件名使用执行当天的日期。不要修改源文件；如果文件不存在，请说明原因，不要编造数据或创建空报告。
如果只需要执行一次，可以将时间要求改为具体日期、时间和时区，并注明“仅执行一次”；如果对话要求补充任务信息，先补全再继续创建。创建后，打开“定时任务 → 任务列表”，确认任务已经出现，并核对工作区、提示词、执行规则和“下次运行”时间。以任务列表中的实际记录为准，仅收到一段文字计划不代表任务已经成功创建。
在定时任务界面创建
进入“定时任务”页面，切换到“创建任务”：
- 在“提示词”中写明任务目标、处理范围、输出位置和完成标准。
- 在“工作区”中选择任务需要使用的项目（workspace）。
- 选择任务类型。一次性任务：只在指定日期和时间触发一次，适合发布检查、截止日期提醒或预约处理，任务触发并结束后不会继续作为待执行任务保留，需设置执行日期、执行时间和时区；周期任务：按照设定的规则重复触发，需设置重复周期、执行日、时间、时区，或使用高级 Cron 表达式设置。
- 单击“创建任务”，任务会出现在“任务列表”中。检查“下次运行”时间是否符合预期。
管理定时任务
- 任务列表：打开“定时任务 → 任务列表”，可以按项目查看已经创建的任务。状态栏中“已安排”表示正在等待触发，“运行中”表示任务正在执行，可对任务进行立即运行、停止、编辑或删除操作。
- 查看执行结果：到达运行时间后，PilotDeck 会自动在项目内开启一个新对话发送任务提示词，Agent 执行任务并反馈结果。
- 全局设置：进入“设置 → 智能体 → 定时任务”页面，设置时区与最大并发运行数。
如何写定时任务的提示词
定时任务在后台运行，执行过程中无法停下来向你确认缺失信息，因此提示词应当可以独立执行。建议写清以下内容：
| 内容 | 写法示例 |
|---|---|
| 处理对象 | 读取当前 WorkSpace 的“进展记录.md”和“项目计划.md” |
| 时间范围 | 只统计自上次周报以来新增或修改的内容 |
| 具体动作 | 提取已完成事项、风险和下周计划 |
| 输出格式 | 使用 Markdown 表格，并按优先级排序 |
| 输出位置 | 保存到“周报/YYYY-MM-DD.md” |
| 异常处理 | 文件不存在时说明原因，不要编造数据，也不要创建空报告 |
| 修改边界 | 不要修改源文件，只新增周报文件 |
一条适合 定时执行的提示词，应尽量避免“帮我处理一下”“照之前的方式做”等依赖即时上下文的表达。需要引用的规则、文件名和保存路径，应直接写在提示词中。
使用注意事项
定时任务依赖正在运行的 PilotDeck 服务。运行服务的电脑或服务器需要保持开机，并确保网络、模型服务和项目目录可以正常访问。退出 PilotDeck 服务、电脑休眠或关机、网络中断、模型不可用以及额度不足，都可能阻止任务触发或导致任务失败。
定时任务不能唤醒已经关机或休眠的电脑。
任务没有按时运行时，可以依次检查：
- 任务是否仍在列表中，状态和“下次运行”是否正常；
- 是否有其他任务占用了全部并发运行数量；
- 任务时区是否正确；
- PilotDeck 服务以及运行服务的电脑或服务器是否持续在线；
- 模型、网络和所选工作区是否可以正常访问。
七、消息渠道
PilotDeck 支持通过手机上的即时通讯软件（飞书 / Lark、微信、企业微信）远程控制电脑上的 PilotDeck 执行任务。进入“设置 → 外部集成 → 消息渠道”，开启“启用网关”后，按引导扫码或填写应用凭据即可接入对应渠道。消息渠道只提供新的交互入口，任务仍由运行 PilotDeck 的电脑或服务器执行，模型、技能也使用该运行环境中的配置。
接入前准备
配置消息渠道前，请确认：
- PilotDeck 服务正常运行，完成模型配置，确认普通对话可正常回复；
- 具备在对应即时通讯软件中创建、安装或使用 Agent 的权限。
消息网关统一负责外部消息的接收、路由和回复。普通用户通常不需要修改“网关主目录”，保留默认值即可。
通过飞书 / Lark 发送消息
PilotDeck 支持扫码创建和连接已有应用两种接入飞书的方式。
扫码创建：进入“设置 → 外部集成 → 消息渠道”，点击“飞书 / Lark”，选择“扫码创建”。根据实际使用的通讯软件，将域名设为 feishu.cn 或 larksuite.com，单击“生成二维码”。使用对应的飞书或 Lark App 扫描二维码，并按照页面提示完成授权。返回 PilotDeck，等待页面显示“应用创建成功——配置已保存并启用”，并确认飞书渠道状态显示为“已启用”。如果所在组织限制成员创建或安装应用，需要由管理员完成审批，或改用已经创建好的应用。
连接已有应用：进入“设置 → 外部集成 → 消息渠道”，点击“飞书 / Lark”，选择“手动输入”，依次填写域名、连接方式、App ID、App Secret 等信息。
| 连接方式 | 说明 |
|---|---|
| Stream（WebSocket） | 由 PilotDeck 主动建立长连接，不需要公网回调地址，适合桌面端和普通服务器部署 |
| Webhook | 由飞书向回调地址发送事件，需要飞书能够访问 PilotDeck 的公网服务 |
一般情况下建议选择 Stream（WebSocket）；只有已经准备好公网回调服务时，才选择 Webhook。填写完成后，点击“测试连接”，测试应用的可用性，再点击“保存”。
在飞书中发送消息：在飞书中找到刚刚创建或连接的机器人，直接使用自然语言发送消息即可。
通过微信发送消息
进入“设置 → 外部集成 → 消息渠道”，点击“微信”，单击“ 扫码登录”。使用微信扫描二维码，并在手机上确认登录。返回 PilotDeck，等待页面显示“登录成功——凭据已保存”，并确认微信渠道状态显示为“已启用”或“已连接”。
在微信中打开扫码后绑定的机器人私聊，直接使用自然语言发送消息即可。
通过企业微信发送消息
PilotDeck 支持扫码配置和连接已有应用两种接入企业微信的方式。
扫码配置：进入“设置 → 外部集成 → 消息渠道”，点击“企业微信 WeCom”，选择“扫码配置”，单击“生成企业微信二维码”。使用企业微信扫描二维码，并按照页面提示完成授权。返回 PilotDeck，等待页面显示“企业微信配置成功——Bot 凭据已保存并启用”。
扫码配置完成后，默认允许私聊，群聊默认关闭。如果需要在群聊中使用，请点击“手动输入”修改。已通过扫码完成配置后，Bot ID、Secret、WebSocket URL 可以留空，按需填写允许使用的用户或群聊白名单。如果所在组织限制成员创建或安装应用，需要由管理员完成审批，或改用已经创建好的应用。
连接已有应用：进入“设置 → 外部集成 → 消息渠道”，点击“企业微信 WeCom”，选择“手动输入”，依次填写 Bot ID、Secret、WebSocket URL（通常保留默认值）、私聊策略和群聊策略等信息。对企业项目，建议优先使用白名单控制访问范围：私聊白名单填写企业微信用户 ID，群聊白名单填写群聊 ID，多个值使用英文逗号分隔。
在企业微信中发送消息：在企业微信中找到刚刚创建或连接的机器人，直接使用自然语言发送消息即可。
相关资源
| 主题 | 入口 |
|---|---|
| PilotDeck 部署 | 部署指引 |
| PilotDeck 配置 | 模型、路由、MCP 与消息渠道配置 |
| 案例广场 | PilotDeck 案例广场 |
| 教程视频 | B 站教程合集 |