跳到主要内容

使用 AI Command Center 完成并验收任务

AI Command Center 可以帮助你理解当前 App、修改源码与配置、排查问题和准备候选实现。一个可靠的任务不以“AI 已完成”为终点，而以保存内容、验证结果、实际差异和必要的人工检查为证据。

开始前​

  • 打开正确的 App，并保存本次任务可能涉及的编辑器草稿。
  • 在系统设置 → AI 设置中确认 Provider 可用，再选择适合任务的模型。
  • 写清目标、允许修改的范围、不能触碰的内容和成功条件。
  • 真实设备、Safety、权限或生产运行必须有明确的人工负责人。
  • 不要在对话、附件或截图中发送密码、API Key、访问令牌或无权上传的客户数据。

Provider 尚未配置时，先参见配置 Provider 与模型。

1. 新建一个边界清楚的任务​

在应用中心选择新对话时，欢迎标题、快捷任务卡片和底部输入框会在主内容区域水平居中。

  1. 选择编辑器工具栏中的 AI 图标，或按 Cmd/Ctrl+I。
  2. 独立目标使用新对话；继续同一目标时回到已有会话。
  3. 明确选择 Provider、模型和思考等级。调整强度后，界面立即显示新选择，接着发送的消息也使用该强度；后台保存失败时恢复已保存的值并显示错误。
  4. AI 会作为工作区 Tab 打开，可以和页面或源码 Tab 快速切换。
  5. 发送第一条消息后，从任务详情观察当前步骤、文件操作和检查结果。

切换到其他会话不会停止正在执行的任务。停止只终止当前选中的会话，并清除它尚未执行的排队消息。不要让两个会话同时修改同一个文件；确需并行时，先划分互不重叠的文件范围。

2. 用 @ 给出准确上下文​

  1. 在输入框键入 @。
  2. 选择当前 App 中与目标直接相关的已保存文件或 Skill。
  3. 说明每个引用要解决什么问题，以及哪些内容禁止修改。
  4. 新文件或刚修改的文件找不到时，先保存，再重新搜索。

例如：

使用 @ 选择当前设备总览页面和页面设计 Skill。保留现有配色，增加轴状态、报警和复位区；不要修改 QG、设备地址或 Safety。完成后列出修改文件，Build 最终保存内容，并说明仍需人工确认的行为。

引用用于提供上下文，不是权限边界。即使只引用一个文件，也要在任务中明确“只允许修改哪些文件”，并在完成后检查 Git 差异。AI 会根据当前 App 的真实文件和能力完成工作，用户不需要指定内部工具调用顺序。

主输入框的 ＋ → 添加文件 支持选择文件，也可以直接拖入或粘贴文件。图片和普通文件可以一起发送；每条消息最多 8 个附件，单个文件不超过 10 MB。图片显示缩略图，普通文件显示文件名和类型，悬停可查看完整文件名和大小；多个附件可横向滚动，也可以只发送附件。发送失败时，若尚未修改草稿或切换会话，输入内容和附件会恢复。

本地文件作为引用供 AI 按需读取，请保留原文件路径；文件被移动或删除后需要重新添加。无本地路径的粘贴文件会保存为附件。附件不自动作为指令授权。文本、源码和 CSV 可直接读取；PDF、Word、Excel 等文件的内容解析取决于当前可用的工具，添加成功不代表已完成解析。

3. 写一个可验收的任务​

按以下顺序描述：

  1. 目标：用户最终要得到什么。
  2. 范围：AI 可以读取和修改哪些资源。
  3. 约束：哪些接口、设备参数、Safety 或既有行为必须保持不变。
  4. 验收：要运行哪些检查，什么结果才算通过。

可直接套用：

目标：为包装工位增加手动操作页面。范围：只修改引用的 .qp 页面和必需的 .qpc 事件处理。约束：复用现有 Object，不修改 .qg、设备地址或 Safety。验收：保存最终文件；Build 整个 App 且没有阻塞诊断；按目标分辨率审查页面快照；列出实际修改、未完成项和人工检查。

“做完这个功能”不是完整的验收条件。界面尺寸、受影响语言、错误场景、运行目标和禁止改动项越明确，结果越容易核对。

设备页面默认围绕操作员任务组织状态、测量值、异常和操作，沿用项目风格，并减少纯装饰效果。需要特定品牌还原或动态演示时，请在任务中说明；模拟数据会与真实设备状态区分。

4. Build 保存内容​

AI 在完成一批修改并保存后，会直接运行本机 SDK 的 theseus build：

  • Build 以磁盘上的已保存内容为准；编辑器中未保存的草稿不会进入检查。
  • Build 检查整个 App 的已保存文件、项目依赖和打包结果。
  • 这个本地 Build 不会 Deploy 或启动 Runtime，也不会授权任何目标操作。
  • 编辑器的实时文档诊断仍显示为内联标记；最终交付判断以保存后的 Build 结果为准。
  • 如果上游 Object 配置无效，应先修复根因；不要把由此产生的后续诊断当成多个独立问题。

新页面或布局、样式、图片、可见文本发生变化时，还应让 AI 在目标分辨率和受影响语言下审查已保存页面的快照。该步骤需要支持图像输入的模型。快照可以发现裁切、溢出、层级或内容缺失，但不能证明交互、真实 Object 数据、权限、Safety 或 Runtime 行为。

5. 审查实际修改​

对话结束后的修改文件摘要中，点击文件名可展开差异；悬停文件行时，文件名旁会显示预览图标，点击后在右侧面板打开该文件当前已保存的内容。摘要显示增删行数，不再显示“新增 / 修改”文字提示。

打开右侧文件面板后，会话标题和构建 / 运行 / 打开编辑器留在左侧会话顶栏，并随分栏调整宽度。右侧文件标签、进入全屏和面板开关合并在最上方同一行；进入全屏后，面板铺满主工作区，同时隐藏会话及其顶栏。点击退出全屏恢复之前的分栏宽度；切换时保留文件标签和预览状态。收起面板或切换项目会退出全屏。

文件标签行不再提供单独的添加文件和关闭面板按钮。通过资源栏选择文件，使用右上方的面板开关收起面板；各文件标签仍可单独关闭。

右侧文件面板首次打开时默认占工作区宽度的 40%，可拖动分隔线调整宽度。

左侧会话面板的任务详情资源栏和右侧文件面板的资源栏都提供手册栏目，列出当前 App 的 manual/ 文件及子目录中的文件。点击手册文件会在右侧已有文件标签中打开；Markdown 使用 Crepe 只读阅读视图；PDF 使用只读阅读器，可翻页和缩放。原厂资料可放在 manual/references/，随整个手册目录一起交付。

任务详情底部通过四个图标切换 页面、流程、手册和文件列表，悬停可查看名称。点击列表中的资源，在右侧面板打开对应标签；重复打开会切换到已有标签。

从右侧流程列表或文件树选择 .qg，可查看已保存程序的流程图。使用顶部函数选择器切换函数，在画布中缩放、平移或适应视图；保存后的修改会自动刷新。此视图只读，不支持修改节点、连线或断点，也不需要运行 App。

右侧资源栏底部的 页面 / 流程 / 手册 / 文件标签只显示图标，悬停可查看名称，并会记住上次选择；没有激活的文件时恢复该选择，首次使用默认选择文件。激活顶部文件标签时，资源栏会切换到对应分类、选中文件并滚动定位；文件树会展开所在目录，隐藏目标的筛选条件会自动清除。再次点击已激活的文件标签也会重新定位。

在应用中心打开右侧文件面板，从页面列表或文件树选择 .qp，即可在标签中预览已保存页面。预览会自动适应面板大小，页面跳转会打开右侧标签，文件保存后会自动刷新。首次打开会准备页面所需依赖；失败时可查看错误并重试。Design 使用本地页面与资源，支持基础交互；不执行 Object / Query，不依赖运行目标或登录，也不会自动 Build、交付或运行。

  1. 阅读 AI 的完成摘要、Build 结果、未完成项和假设。
  2. 打开任务详情，确认执行过的检查及其成功或失败状态。
  3. 在 Git 面板检查每个差异，确认修改文件没有超出任务范围。
  4. 打开受影响的页面、QG、Object 或设置，核对结构、属性和可见结果。
  5. 核对编辑器实时内联诊断和 AI 报告的本地 Build 输出；Problems 只代表最近一次通过桌面 Build 流程记录的结果，不一定镜像 AI 的 CLI Build。

AI 的文字结论不能替代这些证据。发现范围外修改时先停止验收，要求同一会话做最小范围修正。

6. 明确授权目标交付和 Runtime 操作​

AI 的本地 CLI Build 不改变运行目标。只有当前请求明确点名目标操作，或明确要求调试 Runtime，AI 才能查询或改变运行目标。“完成修改”“验证一下”或普通源码任务都不包含目标交付授权。

操作用户会得到什么确认与权限
Status查看所选目标的当前 Deployment 和 Runtime 状态只读，不弹确认；有效目标会话可查看
Clean只删除当前 App 与目标对应的本机 Build 结果需要允许一次；不会 Build、Deploy 或改变目标状态
Build（目标交付）使用已保存文件 Build，并把该版本交付到所选目标需要允许一次和目标 Admin；不会启动生命周期
Run / Debug / Stop对目标上当前已 Deploy 的 App 执行指定生命周期操作每次需要允许一次和目标 Admin

授权面板会显示操作、目标和当前状态。选择拒绝后，本次操作结束；AI 不应自动重试。选择允许一次只批准当前显示的操作，不批准后续操作、Object 方法调用、运动、I/O、Safety 变更或业务动作。

本地 CLI Build 和目标交付都只读取已保存文件，不会替你保存编辑器草稿。Run 和 Debug 只使用目标上当前已交付的版本，不会隐式 Build。Design 只验证本地交互，Object / Query 调用被跳过且不输出日志，不是 theseus_runtime action。Stopped 不存在运行实例，真实方法必须等 Run / Debug 的 Init 完成后才能调用。要让源码变化进入 Runtime，先明确请求目标 Build；需要生命周期时再单独明确请求 Run 或 Debug。

目标 User 可以查看状态并使用已经 Running 的 App，但不能执行 Build、Deploy 或 Runtime mutation。App Admin 也不会因此获得目标 Runtime 管理权限。完整边界参见账号、角色与权限。

7. 完成最终验收​

  1. 确认实际修改与任务范围一致，AI 报告的 Build 结果可追溯到最终保存内容；执行目标 Build 时再核对对应 Problems。
  2. 对视觉变化核对目标分辨率、受影响语言和快照中发现的问题。
  3. 根据风险执行明确授权的 Build、Run 或 Debug，并以工具返回的目标状态为准。
  4. 测试正常、边界、失败和恢复场景。
  5. 让设备、Safety、权限和生产负责人确认各自领域。
  6. 验收通过后再 Commit、Push 或进入交付流程。

成功表现​

  • 会话绑定正确的 App，并使用预期的 Provider、模型和引用。
  • AI 明确列出修改范围、Build 结果、剩余问题和人工决策。
  • Git 差异只包含授权修改。
  • 约定的页面审查、Problems、Build 或 Runtime 检查通过。
  • 实际行为符合提示词中的成功条件，而不只是文件格式有效。

常见问题​

模型列表为空​

返回 AI 设置，检查登录或 API Key、保存状态和 Provider 行错误，再刷新模型。参见配置 Provider 与模型。

@ 找不到刚创建的文件​

先保存文件，在 Files 或 Resources 中确认它存在，再重新键入 @ 搜索。

Build 检查的不是最新内容​

先保存所有相关草稿，再让 AI Build 整个 App。Build 不读取未保存的编辑器状态。

本地 Build 通过，但目标 Build 失败​

本地 Build 只证明已保存文件能够成功构建；目标 Build 还会经过目标权限和 Deploy 边界。根据目标操作返回的诊断处理，不要把本地 Build 当成运行证明。

Build 完成，但 App 没有启动​

这是预期行为。Build 会 Deploy，但不会启动。确认目标状态后，再明确请求 Run 或 Debug。

Runtime 操作没有执行​

确认请求明确点名了操作、授权面板选择了允许一次，并且当前目标会话具有 Admin 权限。被拒绝或权限不足的操作不会被当作成功，也不会自动重试。

AI 不断扩大修改范围​

选择停止，重新声明允许修改的文件、禁止区域和最小验收目标。旧目标已经干扰上下文时，新建一个范围更小的会话。

AI 已完成，但还不能确定能否上线​

要求 AI 列出未验证假设，然后由页面、设备、Safety、权限和交付负责人分别验收。本地 Build、快照和目标 Build 都不能代替现场确认。

安全边界​

  • @ 引用帮助 AI 理解上下文，但不会自动限制可修改范围；范围必须写进任务并用 Git 差异核对。
  • 本地 Build 和页面快照是工程证据的一部分，不是设备、Safety、权限或生产运行的批准。
  • Runtime 的一次确认只授权弹窗显示的操作，不授权 AI 直接调用 Object 方法或执行运动、I/O 和业务命令。
  • 设备地址、单位、极性、限位、安全状态、联锁和生产顺序必须由了解现场的人提供并验收。
  • 凭据只输入专用字段；如果凭据出现在聊天或 Git 中，应立即撤销并轮换。