Skip to main content

常见问题

按现象查找即可。多数问题看 日志 或 任务面板里的错误说明 就能定位。

打不开 AI 智能体窗口​

现象：点新中控里的 「AI 智能体」 没反应。

请检查：

  1. 安装目录下是否有 aibin 文件夹及里面的 AI 程序（安装包一般自带）
  2. 打开 aibin/log/，看 javaexec-iosagent-ui.log 是否有报错
  3. Windows 首次运行可能需要 WebView2；安装包同目录常有安装程序，或从中控菜单安装
  4. 杀毒软件是否拦截

显示未连接​

现象：工具栏提示 AI 服务离线。

请检查：

  1. 点 「启动 AI」
  2. 看 aibin/log/javaexec-iosaiagent.log 有无错误
  3. 仍不行可关闭 AI 窗口，从新中控重新打开

只能输入 list workflows，不能正常聊天​

原因：还没配大模型，或密钥、接口地址不对。

处理：

  1. 点 「模型配置」，确认接口地址、模型名、密钥 正确
  2. 工具栏应能看到当前模型名称
  3. 公司网络是否拦了外网 API（代理、防火墙）

AI 说找不到某个工作流​

处理：

  1. 左侧 工作流库 点 刷新
  2. 让 AI「列出所有工作流」，或自己在库里确认名称
  3. 若是刚新建的流程，先在编辑器里 保存

设备授权失败​

现象：任务报错，提示授权相关；对话或流程中 device_auth_ok 失败。

处理：

  1. 确认已购买并绑定 USB 设备授权（不是 USB 投屏授权）→ 见 环境与授权 或 USB 投屏教程 · 购买授权
  2. 新中控设备列表里确认手机 在线
  3. 重新插拔 USB，或检查代理 App / 自动化服务是否正常
  4. 在中控 授权中心 刷新授权
  5. 流程里若有「授权检查」步骤，确认类型选对（USB 设备授权 / 投屏授权）

无法启动自动化 / 点击截图失败​

现象：ensure_auto_env 失败，或自动化截图、点击无响应。

处理：

  1. 按 环境与授权 检查：IPA 是否已签名安装、bundleID 是否配置、开发者镜像是否就绪
  2. 在中控 开启自动化，直到服务状态为 是；设备右键 测试自动化 查看具体日志
  3. 详细图文：USB 投屏教程 · 签名 ipa、启动自动化
  4. 若只需截图/OCR、不想开自动化，改用 无自动化截图/OCR 步骤或对话指令

BLE 步骤失败​

现象：工作流中 ble_click 等步骤报错。

处理：

  1. 完成 环境与授权 中的蓝牙/OTG 配置
  2. 中控 蓝牙 HID 设置 → 测试蓝牙 BLE
  3. 详见 蓝牙 BLE 教程、OTG 教程

对话里截图失败​

现象：说了「自动化截图」却失败。

处理：

  1. 先说「启动自动化环境」，再截图
  2. 若不想开自动化，改说「无自动化截图」或「无自动化 OCR」

两种截图在对话和工作流里 名称一致：无自动化截图 / 自动化截图。

OCR 第一次很慢或任务结束后又变慢​

原因：OCR 引擎按 设备 + 引擎类型 加载；正式任务 结束后会释放，下次需重新初始化。

处理：

  1. 同一流程内连续 OCR 会 复用 引擎，第二次起会快很多
  2. 编辑器 OCR 预览 默认保持引擎，适合调试
  3. 不要随意混用多种 ocrType，每种类型都会单独占内存

找图 / 偏色找图未匹配​

  1. 确认模板路径相对 工作目录 正确，或用 找图预览 重新 截取图片
  2. 无自动化找图 不用 开自动化；自动化找图需先 启动自动化环境
  3. 透明/偏色小图请用 偏色找图 步骤，不要用普通模板找图
  4. 点击位置偏了：流程里加 找图数据提取（center）再 点击，不要直接用左上角坐标

详见 图色找图。

打不开 App、自动化环境起不来​

建议顺序（可在流程里加对应步骤，或让 AI 按此排查）：

  1. 重置 USB 连接
  2. Windows 可试 闪断 USB（等同拔插线），然后 等待 5～10 秒
  3. 启动自动化环境，再等就绪
  4. 再 打开 App

仍失败：到 任务面板 展开该任务，看 哪一步失败 及错误文字。

工作流保存 / 校验失败​

  1. 点 校验，看第一条红色提示
  2. 常见原因：缺路径、流程图没连到结束、子流程引用不存在
  3. 对照 工作流步骤参考 检查参数

试跑时选不到设备​

  • 新中控里需有 在线 设备
  • 编辑器试跑栏里 刷新 设备列表

外部命令行跑不起来​

  • 在 CLI/MCP 集成 里确认已 添加 且名称一致
  • 看 aibin/log/api-error.log

数据是不是存错地方了​

正确情况：

  • 业务数据：aibin/data/aiagent/（或您在设置里指定的目录）
  • 日志：aibin/log/

若升级后路径不对，请使用 10.1.0 及以上 的新中控与 AI 组件。

日志在哪​

内容位置
AI 服务aibin/log/javaexec-iosaiagent.log
AI 窗口aibin/log/javaexec-iosagent-ui.log
接口错误aibin/log/api-error.log

任务面板或中控里若有 打开 AI 日志目录，可一键打开 aibin/log/。

多台设备跑得慢​

  • 设置 里增大 单任务最大设备数，改后 重启 AI
  • 同一台手机 不能 同时跑两个任务

看版本号​

AI 智能体窗口 状态栏 可查看版本与构建时间。

还是解决不了​

请准备：

  1. aibin/log/ 里相关日志
  2. 任务 ID（任务面板可复制）
  3. 出问题的 工作流（工作流库 → 打开文件夹 拷贝文件）
  4. 新中控版本、复现步骤

联系技术支持时一并提供。