LightVela

诊断中心

摘要

诊断中心用于查看和导出 Hermes Agent 日志,并在模型配置异常或运行状态持续异常时执行恢复操作。 建议先用最短时间范围定位问题,再按影响从小到大的顺序选择刷新日志、重置模型配置、重置工作环境或保留数据重置 Hermes。


诊断中心用于排查 Hermes Agent 的异常情况。你可以在同一处查看和导出近期日志、重置模型配置,或在保留数据的前提下重置 Hermes。

当前入口与操作范围

选择目标 Bot,打开「探索 → 管理 → 诊断中心」,可查询或导出 1、3、6、12、24 小时日志。重置模型配置只作用于所选 Bot 的 Profile。重置 Hermes、工作环境或实例等实例级维护请切到主 Bot;这些操作与下文按目标区分的备份恢复不同。

本页覆盖

  • 查看和导出近期日志
  • 重置异常的模型配置
  • 保留数据重置 Hermes
  • 判断何时应使用恢复操作,何时应寻求进一步帮助

建议按影响最小的方式处理: 先看日志,再执行必要的修复操作。重置配置和重置 Hermes 更适合持续存在的问题。

开始前

  1. 打开出现问题的 Agent,并选中需要排查的 Bot。
  2. 记录异常表现、发生时间,以及它影响的是聊天、已连接的渠道,还是某一项具体任务。
  3. 如果是模型无法使用,重置前先检查配置模型中的当前设置。

打开诊断中心

  1. 打开管理台,选择出现问题的 Bot。
  2. 在「探索 → 管理」中打开诊断中心。
  3. 选择近期日志的时间范围:1、3、6、12 或 24 小时。
  4. 选择 查询 加载日志。

LightVela 管理台中的诊断中心

优先选择刚好覆盖异常发生时间的最短范围。时间窗口更小,通常更容易将错误和触发它的操作对应起来。

查看和导出日志

通过日志确认 Agent 当时是否正常运行,并定位异常发生的时间。需要保留记录或向支持人员说明问题时,可以将当前时间范围内的日志导出为文件。

反馈问题时,建议提供:

  • 大致发生时间;
  • 当时让 Agent 执行的操作;
  • 选用的日志时间范围;
  • 相关报错信息,但不要包含密钥或 API Key 等敏感内容。

修复模型配置

如果 Agent 无法使用已配置的模型,并且确认过提供商、模型选择和凭证后问题仍未解决,可在诊断中心选择 重置模型配置。

该操作只会重置当前 Bot 对应的 Hermes Profile:恢复系统内置模型及其凭证,并移除用户添加的模型、Provider 和备用模型。同一 Agent 中的其他 Bot 不受影响。完成后:

  1. 在聊天中发送一条简短消息,确认系统内置模型可用。
  2. 如果仍需使用自定义模型,返回配置模型重新添加或选择。

重置工作环境

采用分离工作环境的实例,在主 Bot 的诊断中心可直接使用 重置工作环境。该操作重建工作环境并保留数据,期间终端、文件和云电脑会暂时不可用;它与重置模型配置、重置 Hermes 是不同操作。

阅读影响说明后,只有确认问题与工作环境有关时再启动重置;等待维护任务结束后,分别验证文件访问、终端或云电脑。维护操作进行期间按钮会暂时不可用,等当前任务结束后再试;不要同时发起多项维护。

保留数据重置 Hermes

对于查看日志和检查模型设置后仍持续的问题,诊断中心在主 Bot 上提供 重置 Hermes(保留数据)。它会重置 Hermes 运行环境,并保留数据。非主 Bot 看不到可用的重置入口时,请先切回主 Bot,不要把模型配置重置当成同一操作。

  1. 阅读诊断中心显示的操作说明。
  2. 启动重置后,保持页面打开并留意状态变化。
  3. 完成后重新加载 Agent 控制台。
  4. 在聊天中测试一项简单任务,再检查云存储和日常设置。

重置 Hermes 确认弹窗

维护期间,Agent 可能暂时不可用。重置尚未完成时,请不要连续发起另一项修复操作。

备份与恢复:以控制台显示为准

选择目标 Bot 后,在诊断中心打开「备份与恢复」。先确认实例正在运行、账号已绑定邮箱,且同一 Agent 没有其他备份、恢复或维护任务进行中。

  • 主 Bot:备份包含整个 Agent 的主 Bot 和子 Bot 的配置、工作空间、记忆及技能;恢复会覆盖目标 Agent 的对应数据,影响所有 Bot。
  • 子 Bot:仅备份或恢复当前 Bot 的配置、人设、记忆、会话、技能和工作空间。恢复保留当前 Bot 的通道连接,且仅接受单 Bot 备份包;不要把整实例备份包用于此入口。

点击「备份到邮箱」,阅读范围提示并提交,等待任务状态及绑定邮箱中的结果。恢复前先保存不可替代的数据,再选择「从备份恢复」,上传兼容的 ZIP 备份并核对目标及范围。即使只操作子 Bot,备份或恢复期间整个 Agent 也会暂时不可用;同一 Agent 每次只能运行一个此类任务。

通过「刷新」和执行记录核对最终结果,再验证目标 Bot 的模型、文件、记忆和对话。提交成功不代表已完成;结果未知时先查状态,不重复提交。

确认问题已解决

出现以下情况时,通常说明问题已恢复:

  • 近期日志不再重复出现同一错误;
  • Agent 能在聊天中正常回复简单测试;
  • 预期的模型与文件可以再次正常使用。

若同一错误再次出现,请先导出相关日志,并记录下一次出现的时间,再继续排查或反馈。

常见问题

应该选择多长的日志时间范围?

选择刚好包含问题的最短时间范围。只有在问题更早开始或偶发出现时,才使用更长范围。

重装会清除 Agent 数据吗?

诊断中心的操作标注为 重置 Hermes(保留数据),设计目标是保留数据。仍建议不要中断维护过程,并在完成后检查 Agent 状态。

每次模型报错都需要重置模型配置吗?

不需要。请先在配置模型检查所选模型和凭证,并确认提供商可用。仅在模型配置本身需要重新建立时,才使用重置。

下一步

最后更新于 2026-11-16