按现象排查
先记录完整错误文本和当前操作，再按下面的顺序检查。不要为了消除提示而反复覆盖文件、切换目标或重启设备。
启动和连接
| 现象 | 先检查 | 下一步 |
|---|---|---|
| 桌面 App 没有进入应用中心 | 安装是否完整；是否已有另一个 Theseus 进程 | 完全退出后重开；仍失败时保留启动日志 |
| 本机 Runtime target 不可用 | 系统设置中的当前目标和健康状态 | 切回本机目标并重新检查，不要删除 app 工作区 |
| 远程目标检查失败 | 地址、网络、证书和目标机器上的运行服务 | 按连接 Runtime target逐项确认 |
| 已 Qixin 登录但不能 Run | 当前 Runtime target 是否已连接并授权 | Qixin 登录与 target 账户分开，按目标行提示连接 |
| 浏览器能打开目标但管理操作失败 | 是否使用受信任的 HTTPS，以及当前账户角色 | 远程受保护操作需要合适的连接与 Admin 权限 |
AI 问题
| 现象 | 先检查 | 下一步 |
|---|---|---|
| 没有模型可选 | Qixin 登录/权益、Provider 状态、模型刷新结果 | 打开AI Command Center 指南 |
| 某个 Provider 报错 | 该行的认证或网络错误 | 单独修复该 Provider；其他 Provider 不需要删除 |
| AI 修改了错误范围 | 对话中是否写清目标、范围、约束和验收 | 立即停止任务，要求先列影响面，再做最小修复 |
| AI 说已完成但界面没变化 | 实际文件、问题面板、打开 Tab 的保存/冲突状态 | 以工程资产和诊断为准，不以聊天文字为准 |
| 对话太长或跑偏 | 当前任务是否混入多个不相关目标 | 新建对话，并用 @ 只引用本次相关文件 |
页面和运行页
| 现象 | 先检查 | 下一步 |
|---|---|---|
| 运行页提示没有首页 | 当前 App 是否设置首页 | 在资源 → 页面中把正确页面设为首页 |
| 编辑器正确，运行页还是旧内容 | 页面是否保存；新构建是否已部署到所选目标 | 保存页面；Stop、执行编辑器 Build，再开始 |
| 页面或组件打不开 | 问题面板中的元素、方法或表达式错误 | 把错误和对应文件 @ 引用给 AI，先诊断后修改 |
| 点击按钮没有动作 | Action 是否绑定到存在的页面事件函数；方法诊断是否通过 | 检查属性面板绑定和问题，不要把脚本直接写进 Action 字段 |
| 运行页要求登录 | 当前是否已经以这个 App 的用户登录 | 使用 App 用户登录；Runtime target 账户只用于连接和管理目标，不能替代 App 用户 |
构建、运行和 QG
| 现象 | 先检查 | 下一步 |
|---|---|---|
| 构建按钮不可用 | App 是否已 Stopped；是否有其他 Build/运行操作正在执行 | 先 Stop，或等待当前操作完成；点击 Build 后按提示先保存要交付的修改 |
| 开始 / 调试提示没有可用构建 | 当前目标是否已有这个 App 的最新构建结果 | 选择 Build and continue，等待 Build 和部署完成；如果构建失败，先修复 Problems 中最早的错误 |
| 开始 / 调试出现运行错误 | 控制台和问题面板中第一条明确错误 | 按文件定位 Page、QG 或 Script；修复后 Stop、Build 并重新验证 |
| QG 构建失败 | 节点、端口、对象绑定和变量引用是否仍存在 | 让 AI 读取当前可用节点和诊断，不要猜节点字段 |
| 保存后运行逻辑没变化 | 是否只刷新了编辑态，旧运行实例是否仍在运行 | Stop、执行编辑器 Build，再开始或调试，让下一次运行使用新构建 |
设备、Pulsar、Vision 和 Safety
| 现象 | 先检查 | 下一步 |
|---|---|---|
| AI 无法理解 Axis、IO 或相机用途 | Object Tree 和设备描述是否写明物理/业务语义 | 由工程人员补充语义后再让 AI 编排 |
| 设备方法不可用 | 对应模块是否启用、配置是否保存、App 是否重新加载 | 在已停止状态保存并 Build，再显式开始或调试 |
| 外部设备或自定义方法没有出现 | 最近一次应用构建是否成功 | 先修复构建错误，再检查可用方法列表 |
| Vision 无法生成或验证版本 | 相机、inspection、样本和支持图像的模型是否就绪 | 逐项补齐，不允许用伪造 OK 结果兜底 |
| Safety 结果与预期不符 | 输入、输出、组、真实接线和安全硬件 | 停止设备，由合格工程人员检查；不要让 AI 自动放宽联锁 |
数据和 Git
| 现象 | 先检查 | 下一步 |
|---|---|---|
| 变量重启后丢失 | 是否把耐久值放在普通运行内存中 | 按选择数据能力改用 QG.saved、saved variable、Recipe 或 TableStore |
| Query 失败 | URL、认证、参数和外部系统响应 | 先用无副作用请求验证；生产写入需人工确认 |
| 未检测到 Git | Git for Windows 是否已安装 | 在版本面板或导入项目弹窗下载 Git，安装后点击重新检测；不需要重建 App |
| 同步团队失败 | 当前版本、团队同步地址、凭据和未保存修改 | 按版本协作指南逐项处理；特殊冲突进入高级 Git |
让 AI 或支持人员继续排查时
至少提供：
- 正在做的具体操作。
- 完整错误文本，不只截最后一行。
- 当前 app 状态和 Runtime target。
- 问题 / 控制台中最早出现的相关错误。
- 相关 Page、QG、配置或 Script 的
@引用。 - 哪些真实设备操作已经停止，哪些仍在运行。
注意
设备出现异常动作、Safety 状态不可信或现场人员无法确认风险时，先停止设备并按现场安全流程处理，不要继续在线试错。