AI Office

它是什么，以及如何打开

AI Office 以全屏窗口的形式打开，覆盖在整个应用之上。它不是主分页器五个页面中的一个。它没有键盘快捷键、命令面板入口或深度链接：下面四条路径是仅有的入口，并且都会经过同一次 Pro 检查。

打开方式

Pro：只在入口检查一次

• AI Office 整体属于 Pro 模块。免费版从上述任何路径进入都会显示 Pro 付费墙（Office 列在自主工作的 AI之下，与 Cortex、Swarmcode 和 AI 设计器并列），Office 不会打开。
• 进入之后，除项目数量外，没有其他内容受套餐限制（见「免费版与 Pro」）。AI 提供商不属于套餐：你自带密钥。

窗口的行为

• 关闭窗口不会暂停正在运行的办公室。它会在前台通知的保护下继续工作，直到完成或由你暂停。
• 返回（系统手势）：在欢迎页会关闭 Office；在「我的办公室」、大厅和动态页会回到欢迎页（在大厅内会先退回上一页）；在分析、计划审查和 AI 提供商页会回到大厅；在规划页会取消规划并回到大厅；在看板、聊天和结果页会回到动态页。

团队：八个角色

Office 有八个角色。它们不是八个固定的智能体：团队由你来选，从一个智能体到全部八个都可以，你选中的每个角色对应一个智能体。下表说明每个角色在应用里做什么。

你的团队

• 大厅列出八个角色，每个都有一个开关。项目经理带有锁（必填），不能关闭，因此一个团队有 1 到 8 个智能体。
• 默认团队有五个：项目经理、架构师、前端开发、后端开发和 QA 工程师。每个模板会建议自己的团队，并且总是加入项目经理。
• 只有团队里有 QA 工程师时才会有审查：没有的话，任务不经审查直接通过。
• 你在聊天里看到的编排器，以及分析背后的项目研究员，都不是角色：它们是 Office 引擎的功能。

每个角色使用哪个模型

• 你不能为每个角色单独选模型。当你按下启动办公室时，Office 会在已有密钥的提供商中为每个角色选出最合适的模型，并显示在团队页的角色卡片上、动态的智能体面板里，以及结果的智能体表现中。
• 它把角色分成三档：项目经理、架构师和 QA 工程师用最强的模型；前端开发、后端开发和数据工程师用速度快、能力强的模型；DevOps 和技术文档撰写用最便宜、最快的模型。
• 如果同一关联项目的早期会话显示，另一个提供商在某个角色上明显表现更好（至少 3 个样本，且成功率高出 15 个百分点以上），就会把该角色切换到那个提供商。

你不能，以及原因

• 为单个角色选择模型、提供商或推理等级：Office 没有这样的控件，AI 提供商与模型里的选择也不会设置它。尚未提供
• 关闭项目经理：它始终在团队中。有意为之
• 在 Office 内部部署：它没有连接到后端管理器，因此没有部署步骤或按钮。请在后端管理器中部署。有意为之
• 在没有连接任何 AI 提供商的情况下使用 Office：没有密钥时，第一次调用就会失败，大厅会显示「规划失败——请查看聊天记录了解详情」。需要网络

欢迎页与我的办公室

欢迎页是 Office 的第一个界面。在这里你可以打开已有的办公室，或开始一次新会话。

欢迎页

两个操作，加上功能下的三个信息磁贴。横屏时信息磁贴在左、操作在右；竖屏时全部堆叠成一列。

我的办公室

办公室就是你启动过的会话：当前的和以往的。顶部有三个计数器：总计、运行中（正在执行的办公室）和已完成（已完成的）。卡片显示名称、状态、需求描述的前几行、一条显示已完成任务的进度条，以及若干标签：智能体数量、冲刺数量、日期、估算的 token（~Xk tok）和已关联项目。状态共有七种标签；等待冲刺评审的办公室和已取消的办公室都显示为设置。

大厅：需求、团队与配置

大厅是一个两页的向导。第 1 页是今天我们构建什么？；第 2 页是你的团队，配置面板从这里打开。返回从第 2 页回到第 1 页。

第 1 页：构建什么

一个大文本框、三个示例标签、一个模板轮播；如果你已有项目，还有基于其中一个项目构建的入口。「用你自己的话描述，团队负责其余的一切。」

第 2 页：你的团队

你的团队页有项目名称、每个角色一张卡片，以及调整细节按钮。

配置面板

调整细节会打开一个标题为配置的面板。它只存在于大厅：一旦按下启动办公室，其中的任何设置都不能再改。以下是它的控件，按顺序排列。

这些控件实际做什么

• 快速模式总是跳过澄清问题，让规划者给出 3 到 5 个任务、每个涉及 2 到 4 个文件，并在并行任务为 1 时把它提高到 2。只有当项目被评为 Trivial 或 Simple 时，它才会自动批准计划并跳过 QA 审查；从 Moderate 起，你仍要审查计划，QA 仍会审查。
• 启用 QA 审查：只有团队里有 QA 工程师时才有审查。如果审查调用本身失败，任务会不经审查直接通过，聊天里会说明。在最后一次允许的重试上，超过 200 个字符的输出会被自动批准。
• 原生工具调用：开启时，智能体使用提供商的原生工具调用，权限关卡与 AI Chat 相同，文件被限制在工作文件夹内。关闭时，它们使用较旧的文本协议，按角色和风险等级使用固定的工具列表，每个任务最多 8 轮工具调用。
• 并行任务：滑块可到 4，但 Office 同时最多运行 3 个任务，而且只运行计划中标记为可并行并且声明了所涉文件的任务。Feature Delivery 方案、SPARC 和自动（默认是 Feature Delivery）会把最小值提高到 2，这会关闭 Best-of-N。
• 最大冲刺数：规划者最多被要求给出最大冲刺数与建议冲刺数加一两者中较小的那个。建议值：Trivial 和 Simple 为 1，Moderate 为 2，Complex 为 3，Massive 为 5。
• Best-of-N 次尝试：对每个代码任务，它依次尝试 N 次，保留通过本地检查的那一次，因此这些任务大约要花 N 倍的 token。它只在并行任务为 1、开启原生工具调用，并且是每个任务的第一次尝试时才生效。
• Adversarial review：由 N 位持怀疑态度的评审组成评审团（1 到 5 位，需达到法定人数，同时最多 3 位），取代单个 QA 工程师来审查每个任务。它要求开启 QA 审查，且团队里有 QA 工程师，并且会成倍增加调用次数。这个开关上的所有文字都是英文。
• 设计系统、Playbook 和工作流方案塑造智能体的提示词；它们不会增加工具或审批步骤。

你不能，以及原因

• 选择 SPARC：Office 有这个方案，但选择器显示八张卡片，其中没有 SPARC。只有当你的需求描述包含「sparc」、「specification pseudocode」或「pseudocode architecture」时，自动才会启用它。尚未提供
• 让自动批准计划起任何作用：应用里没有任何地方读取它。要跳过计划审查，请使用快速模式，它只对 Trivial 和 Simple 项目有效。尚未提供
• 设置 token 上限、时间上限、测试策略或工具的严格模式：它们存在于 Office 的设置中，但没有任何控件展示它们。尚未提供
• 在按下启动办公室之后更改办公室的配置：这个面板只存在于大厅。有意为之

工作流方案：工作如何被规划

每张卡片告诉项目经理如何规划和分派工作：它塑造规划提示词，以及哪个智能体拿到哪个任务。它本身不会增加工具或审批步骤。

Playbook：质量标准

Playbook 是添加到每个智能体提示词中的一组规则。名称和描述是固定的英文文本。

规划与计划审查

按下启动办公室之后，由项目经理进行规划。正在创建你的计划界面显示三行固定文字（正在组建智能体…、正在分析需求…、正在创建任务分解…），它们不是真实的进度条，另有一个取消按钮；返回同样会取消并回到大厅。

规划做了什么

1. 1选定工作流方案（选自动时，根据你需求描述里的词）。
2. 2提出项目经理的澄清问题，除非快速模式已开启。
3. 3按 1 到 5 评估复杂度：Trivial、Simple、Moderate、Complex 或 Massive。如果评估调用失败，则按 Moderate 处理。
4. 4请模型以冲刺和任务的形式给出计划，每个任务包含标题、描述、角色、优先级、依赖、文件、技能、验收标准、风险、工作量，以及是否可并行运行。计划使用你设备的语言书写。
5. 5把每个任务交给团队里最合适的智能体；如果团队有 QA 工程师，则指定一位不是执行者的 QA 工程师作为审查者。
6. 6最后进入计划审查。如果快速模式已开启且项目被评为 Trivial 或 Simple，则直接开始工作。如果计划无法解析，它会创建一个兜底的单一任务，并在聊天中说明。

快速提问

除非快速模式已开启，项目经理会先用你设备的语言提出 3 到 5 个问题，每个问题有 3 或 4 个答案选项。「回答这些问题，帮助 PM 制定更好的计划。」

审查计划

界面显示复杂度（一个英文标签：TRIVIAL、SIMPLE、MODERATE、COMPLEX 或 MASSIVE）、项目经理说明的策略，以及冲刺及各自的任务数。

批准与复杂度

• 批准计划是 Office 自己的确认。在被评为 Complex 或 Massive 的项目中，冲刺之间还有另一次确认：办公室会停在冲刺评审，底部栏显示跳过冲刺和批准。
• 快速模式只对被评为 Trivial 或 Simple 的项目跳过计划审查。自动批准计划不起任何作用。
• 从 Moderate 起，估算为 Large 或 Extra Large 的任务会在办公室工作期间被拆成更小的子任务。Complex 和 Massive 项目会把代码任务压后，直到架构任务完成。

动态：办公室的工作现场

计划获批后，办公室在四个界面上工作，你可以在它们之间滑动，或用底部栏的四个图标打开：动态、看板、聊天和结果。顶部显示项目名称、一个在办公室规划或工作时会闪动的圆点，以及一行包含冲刺、有几个智能体在工作（N 个在工作）和估算 token（~N tokens (est.)）的文字。保存图标在右侧（见「它会向你的项目写入什么」）。动态页是运行中办公室的主页。

操作栏

暂停、继续，以及它们保留什么

• 暂停会立即停止：正在进行的 AI 调用被丢弃，其部分结果丢失，进行中的任务回到待办，在你继续时重新开始。已经写入的文件保持原样。
• 继续会从中断处重新启动计划。重试失败项会把失败的任务（重试次数重置）和被阻塞的任务放回待办并继续。跳过冲刺会把冲刺标记为已跳过，阻塞其中未完成的任务，并转到下一个冲刺。
• 工作结束时：如果每个任务都完成，办公室为已完成；如果有的完成、有的失败或被阻塞，它会停在已暂停，并给出类似「N/M tasks completed, N failed, N blocked」的消息，这样你可以重试、重新规划或保存已有的成果；如果没有任何任务成功，则为已失败。
• 失败的任务会再尝试最多每个任务的最大重试次数次，每次新尝试之前依次等待 3、6、12、24 秒。连续两个任务失败时，办公室会自行暂停（「⚠ N consecutive failures detected. Pausing to reassess the plan…」）。当智能体向你提问时，以及当它的项目文件夹丢失而你的套餐没有额度再容纳一个项目时，它也会暂停。

工具审批在 AI Chat 中决定

• Office 没有自己的工具审批对话框。智能体对工具做的任何事都经过与 AI Chat 相同的关卡：你在AI 工具权限（设置 → AI）中拒绝的工具、对每条终端命令风险程度的检查、聊天的访问级别（不用工具、只读、先询问、自动编辑、完全访问），以及对任何离开设备的操作（例如 git push、curl 或 ssh）的批准。
• 需要你同意的操作会被放进队列，智能体继续工作：它会被告知该操作没有执行而是进入了队列。卡片出现在 AI Chat 里，聊天的 活动 面板会在 需要你处理 · N 下列出 AI Office。在那里批准或拒绝：Office 绝不会在自己的界面里询问。
• 默认级别自动编辑下，文件编辑无需询问即可运行，但运行命令和任何离开设备的操作都要等你同意。在先询问下，写文件也会询问，Office 在任务结束时写入回答中的代码块时也一样：每个文件都在同一个队列中等待，在你批准之前不会写入。在只读或不用工具下，智能体的工具会被拒绝，Office 自己也不会写入文件。

它会向你的项目写入什么

这是最重要的一节：Office 在工作时会写入你的真实项目。

它写在哪里

• 关联了项目时，它在该项目自己的文件夹里工作并修改其中已有的文件；它被告知要扩展已有内容，而不是新建一个脚手架项目。
• 没有关联项目时，它会在应用的 projects/ 文件夹里创建一个与项目同名的文件夹，该文件夹会成为你列表中的又一个项目。如果已存在同名文件夹，Office 就在其中工作。除非你编辑了项目名称，名称取自需求描述的前三个词。
• 开始时，聊天会说明它将写到哪里：「Working in the linked project: …」或「No project linked — the team will work in a new project: …」。
• 智能体不能写到该文件夹之外：带有 .. 的路径或绝对路径会被丢弃，指向文件夹之外的符号链接会被拒绝。

文件如何写入

• 任务运行期间（原生工具调用，默认开启），智能体用应用的工具创建和编辑文件、运行命令，范围被限制在工作文件夹内。
• 任务结束时，Office 还会写入在智能体回答中找到的文件（带有 path= 的代码块，或写入任务目标文件的第一个代码块）。在先询问下，每个文件都会经过与智能体工具相同的审批队列：它会停放在 AI Chat 中，在你批准之前不会写入。在自动编辑或更高级别下无需询问直接写入；在访问级别为只读或不用工具时会跳过这一步，Office 自己不会写入任何内容。
• QA 审查读的是文本。在此之上，Office 还会在本地检查成果：前端开发写的 HTML 和 CSS 会做结构检查，智能体写的脚本（Python、JavaScript、Ruby、PHP 等）会在你的设备上用与编辑器运行按钮相同的运行器执行，最长 30 秒。真正的失败会让任务打回重试（仅第一次尝试，且需开启 QA 审查）。
• 另有一道独立的诚实性检查，把报告声称运行过的内容与实际执行过的命令作对比。一个声称运行了测试、实际上无人启动的任务会被打回；如果没有剩余重试次数（或智能体没有运行命令的途径），则以 Not verified by PocketCode 标记结束。

它会向你询问什么

• 你对计划的批准，以及在 Complex 和 Massive 项目中对每个冲刺的批准。这是 Office 自己唯一的确认。
• 你的 AI 提供商的数据说明，每个提供商和账号一次：与 AI Chat 是同一个说明、同一条记录。如果你拒绝，就不会发送任何内容。
• 工具审批，在 AI Chat 中决定（见「动态」）。

保存图标

• 从计划审查开始出现在顶部的保存会写入一份摘要和各任务结果中的文件。在已关联的项目中，摘要写到 .pocketcode/office/session-<id>.md，这样不会覆盖你的 README.md；否则它就是项目的 README.md。之后图标变成绿色对勾，不会显示任何消息。
• 你不需要它来保留文件：文件已经在项目里了（在先询问下，仍在等你批准的除外）。
• 保存写入的是智能体留在任务结果里的代码，绝不会把它们的报告写到某个文件上：带有 path= 的代码块写到该路径，任务的第一个代码块写入其目标文件，没有代码块的结果则写入 tasks/<title>.md，所以任务的目标文件不会被动到。

暂停、关闭与恢复

• 每个完成的任务都会保存到设备上，所以办公室重启后仍保留已完成的工作。
• 如果应用在办公室运行时关闭，请从我的办公室打开它：它会以暂停状态回来，并显示消息「This office was interrupted when the app closed (X/Y tasks done). It's paused — tap Resume to continue.」，你按继续即可。
• 每个冲刺之后，Office 还会保存一份会话检查点，但应用里没有任何地方从它恢复。

你不能，以及原因

• 查看差异、接受或拒绝某个文件、撤销 Office 写入的内容，或列出它碰过的文件：引擎私下保存着哪个智能体改了什么的记录，但没有任何界面展示它。尚未提供
• 从检查点恢复办公室：每个冲刺之后会保存检查点，但应用里没有任何地方使用它们。恢复通过我的办公室和继续进行。尚未提供
• 让智能体写到工作文件夹之外：路径会与文件夹的真实位置对照检查。有意为之

隐私与成本

AI Office 直接从你的设备把项目内容发送给你选择的 AI 提供商：PocketCode 不会在中间放置任何 AI 服务。请把需求描述和你让智能体读取的文件，当作你的提供商会处理的内容。

哪些内容会发给提供商

• 你的需求描述、你对问题的回答、计划和任务，出现在需要它们的调用里。
• 每个任务的上下文：之前的结果（每个截取前 1,500 个字符）、智能体用工具读取的文件和命令的输出；关联了项目时，还有它的路径、技术栈和最多 60 个文件名。
• 项目的说明文件（如果有的话，取前 4,000 个字符）。
• 使用分析时：项目的清单和文档，外加最多 17 个源文件，每个截取前 2,000 个字符。
• 教训与记忆：会话中最多 10 条教训，每个任务最多 8 条相关记忆，以及同一关联项目最近 5 次会话中最多 12 条记忆。
• 你第一次使用每个提供商时，Office 需要你接受它的数据说明，与 AI Chat 显示的是同一个。每个提供商和账号只询问一次，并且不会向你没有接受的提供商发送任何内容。
• AI 消息、交付物和复盘上的旗帜图标会打开举报回复：你选择一个原因（儿童性虐待或性剥削、仇恨或骚扰、暴力、色情内容、非法或有害的指示，或其他），然后发送举报，它会发给 PocketCode。

哪些内容留在你的设备上

• 每个办公室在每个任务完成后都会保存到应用的私有存储中：需求描述、计划和带结果的任务、最近 200 条聊天消息、记忆、交付物、配置以及已关联项目的路径。在我的办公室中删除办公室，会把它从列表和数据库中移除。
• 冲刺检查点是应用私有存储中的 JSON 文件。

成本

AI Office 消耗你自己提供商的额度或账单。PocketCode 不出售 AI 额度，也不显示任何金额：你看到的唯一数字是 token 数量，始终是估算值（~N tokens (est.)）。

• 你不能设置 token 或时间上限。能约束花费的有：暂停和取消会话、每个任务的最大重试次数、最大冲刺数、更小的团队、在简单项目上使用快速模式，以及连续两个任务失败后的自动暂停。
• 每次调用的超时时间为 4 分钟。失败后会再试一次，然后换用另一个已连接的提供商，除非问题是缺少数据说明。
• 估算会显示在顶部、智能体面板、团队栏（~1.2k）、智能体表现，以及我的办公室中每个办公室的卡片上（~Xk tok）。

一个办公室会发起的调用