跳到主要内容

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

何时用​

当你要理解当前 app、设计页面或流程、修改配置、排查错误或生成候选实现时，使用 AI Command Center。AI 是默认工作入口，但最终结果仍要在编辑器和运行环境中验收。

开始前​

  • 打开正确的 app，并保存当前 Page 或 Graph 草稿。
  • 明确目标、允许修改的范围、不能触碰的内容和成功条件。
  • 处理真实设备、Safety、权限或生产部署时，先确定人工负责人。
  • 不要在对话、附件或截图中发送密码、API Key、访问令牌或客户敏感数据。

步骤​

配置 Provider 和模型​

  1. 打开系统设置 → AI 设置。
  2. 使用可用的 Qixin AI 模型。账号拥有 BYOK 权限时，也可以新增 Provider，或登录 Codex Provider。
  3. 新增 API Provider 时选择预设或 OpenAI-compatible，填写显示名称、endpoint 和 API Key，然后保存。
  4. 点击该 Provider 的刷新模型；需要全部更新时使用刷新全部模型。
  5. 确认模型卡显示所需输入能力。带图片的 Vision 任务必须选择支持图像输入的模型。

打开并管理会话​

  1. 在编辑器顶栏点击 AI 图标，或按 Cmd/Ctrl+I。
  2. 选择全屏模式集中处理任务，或选择作为 Tab 打开与 Page、Graph 并排检查。
  3. 点击新对话处理独立任务；继续同一目标时回到原会话，避免重复解释上下文。
  4. 选择模型和需要的思考等级，再发送第一条消息。
  5. AI 运行时可以切换到其他会话；任务会继续。点击停止会停止当前会话并清除其排队消息。

用 @ 提供准确上下文​

  1. 在输入框键入 @。
  2. 从候选中选择当前 app 文件或适合任务的 Skill。
  3. 只引用与任务直接相关的 Page、Graph、脚本、查询或配置。
  4. 引用后仍要在正文中说明希望 AI 如何使用它，而不是只发送文件名。

例如：

使用 @ 选择当前设备页和页面设计 Skill。保持现有主题，增加轴状态、报警和复位区；不要修改 Safety 或设备地址。完成后列出修改文件，并检查页面诊断。

写一个可验收的任务​

使用下面的顺序：

  1. 目标：用户最终要得到什么。
  2. 范围：允许读取和修改哪些资源。
  3. 约束：哪些行为、接口或安全配置不能改变。
  4. 验收：必须执行哪些检查，正确结果是什么。

可直接套用：

目标：为包装工位增加手动操作页。范围：只修改引用的 Page 和所需 Page Method。约束：复用现有 Object，不改 Graph、设备地址和 Safety。验收：页面诊断无错误；启动、停止按钮只调用现有对象方法；列出修改文件、人工检查项和未完成项。

验收 AI 的结果​

  1. 阅读 AI 的完成摘要、验证结果和未完成项，不以“已完成”三个字作为验收。
  2. 在任务详情查看修改文件，再到 Git 面板逐个检查 diff。
  3. 在编辑器中打开被修改的 Page、Graph、Object 或 Settings，确认结构和属性。
  4. 查看 Problems，执行与风险相称的 Build、Run 或 Debug。
  5. 按正常、边界、异常和恢复四类场景测试。
  6. 发现问题时，把具体表现和期望结果发回同一会话，让 AI 做窄范围修正。
  7. 验收通过后再 Commit、Push 或部署。

成功表现​

  • 会话使用了正确的 app、Provider、模型和引用文件。
  • AI 能明确说明修改范围、验证结果、剩余问题和人工确认项。
  • Git diff 只包含批准范围内的变更。
  • 编辑器诊断和约定的 Build、Run 或 Debug 通过。
  • 真实操作结果与提示词中的验收条件一致。

常见问题​

模型列表为空​

回到 AI 设置确认 Provider 已启用和保存；检查登录或 API Key，再刷新模型。某个 Provider 失败不会阻止其他可用 Provider。

@ 找不到刚创建的文件​

先在资源或文件视图确认文件已经保存并刷新，再重新输入 @ 搜索。

AI 修改范围越来越大​

停止当前任务，重新说明允许修改的文件、禁止项和最小验收目标。必要时新建会话，避免混入旧目标。

AI 正在运行，但需要补充信息​

可追加消息进入队列；如果原方向错误，先停止，再用修正后的完整要求继续。

会话结束后仍不确定能否上线​

这是正常的。要求 AI 列出未验证假设，然后由页面、流程、设备、安全和交付负责人分别签收。

AI 可以怎么帮​

适合交给 AI 的工作包括：

  • 从当前文件解释 Page、Graph、Object、Query 和变量之间的关系。
  • 生成页面、流程、配置或自定义代码的候选修改。
  • 检查 Problems、Build 输出和引用错误，并提出最小修复。
  • 生成测试清单、变更摘要和候选提交信息。

AI 不应替你决定真实设备参数、安全策略、生产停机窗口或凭据授权。

必须人工确认​

  • AI 读取和修改的是正确 app、正确文件和正确任务范围。
  • Page、Graph 和 Object 的业务语义符合现场流程。
  • 设备地址、运动参数、PLC、Vision、权限和 Safety 由对应负责人验收。
  • 删除、Discard、Deploy、Stop、Commit 和 Push 等高影响操作已经明确授权。
  • API Key、密码和令牌只在专用输入框中填写，没有进入对话或仓库。