问题排查

诊断异常与检查更新

查看组件与运行状态,预览和导出脱敏报告,并核对客户端版本。

遇到客户端连接、组件或任务异常的用户约 6 分钟阅读
操作入口
设置 → 客户端诊断;设置 → 关于
完成结果
定位需要处理或核实的检查项,并获得可预览、可导出的本机诊断报告。
本篇目录

1. 运行一次客户端检查

出现本机引擎无法连接、任务状态异常或组件不可用时,打开「设置 → 客户端诊断」。进入页面会自动收集一次检查,稍后也可点击「重新检查」。排查前记下发生时间、客户端版本及复现步骤,便于把报告与实际问题对应。

实际客户端诊断页面,显示客户端版本、本机运行引擎和数据任务的检查状态
实际客户端诊断结果:查看版本、本机运行引擎和数据任务状态。图中的版本与检查结果对应拍摄时的本机环境。 真实产品界面 · 演示数据
1. 运行一次客户端检查参考表
检查项重点核对
客户端与本机引擎安装包、界面、引擎发布版本和协议是否一致。
数据与任务、终端组件数据库状态、运行及排队任务、原生组件是否响应。
模型配置、网络状态已加载的模型数量,以及系统报告的联网状态。

2. 读懂正常、需处理与需核实

逐项阅读状态旁的说明。正常表示该项检查已取得预期响应;需处理或异常需要按提示继续排查;需核实表示当前检查不能得出完整结论。例如系统报告在线,不代表平台、VPN 或 SSH 目标都可访问。模型配置检查不会实际调用模型,也不产生模型费用。

  1. 认证或访问权限异常时,重新登录后检查。
  2. 组件协议或版本不一致时,核对当前启动的安装包,使用完整客户端版本。
  3. 模型列表为空时,检查登录、网络并刷新模型目录。
  4. 浏览器预览无法验证原生安装包和终端能力;这类问题需要在实际桌面客户端复查。

3. 预览并导出这份报告

实际诊断结果中的模型配置、待核实的网络状态及脱敏报告预览和导出入口
实际诊断结果下方:网络项目提示「需核实」,并提供脱敏报告预览和导出入口;系统在线不代表所有业务目标都可访问。 真实产品界面 · 演示数据
  1. 展开「预览脱敏诊断报告」,核对报告生成时间、产品与版本,以及检查结果是否对应本次问题。
  2. 点击「导出这份报告」,选择保存位置;报告以 JSON 文件保存。导出失败时重新选择位置,当前报告仍会保留。
  3. 点击「查看本机错误日志」补充查看异常。反馈问题时说明操作步骤、预期结果和实际现象,并提供对应时间的报告。

4. 核对版本并检查更新

诊断页可点击「检查更新」,也可在「设置 → 关于」查看当前版本、软件更新和更新日志。是否有可用版本及后续操作,以更新面板和当前发布渠道返回的信息为准。升级前先完成或妥善保留正在处理的工作,升级后再运行诊断,确认组件版本与原来的异常是否恢复。

  • 没有获取到更新结果时,先检查网络和发布渠道连接,再重试。
  • 升级失败时保留当前可运行版本,通过已有发布渠道获取完整安装包。
  • 同一异常仍能复现时,提供升级后的版本、发生时间、复现步骤和新报告。
  • 涉及 SSH、VPN 或系统权限的问题,在对应电脑和真实网络中单独验证。