跳到主要内容

升级、备份与迁移

维护操作可能同时影响面板、Agent、模型凭据、实例和任务数据。任何升级、卸载或换机都应先做可验证备份，再逐项恢复。

  1. 01备份
    先做可验证备份导出配置、记录实例与凭据，备份放到不同设备。
  2. 02停用
    停用自动任务停用定时任务，结束正在运行的会话。
  3. 03升级
    官方包升级核对签名与校验值，关闭面板后安装。
  4. 04验收
    逐项验收版本、模型、实例、只读任务逐个测试。
  5. 05迁移
    分批导入换机时在新设备分批导入并逐项测试。
  6. 06回滚
    确认可回滚仅官方支持且备份兼容时才回滚。

备份清单​

  1. 在“关于”记录面板版本和系统版本。
  2. 停用定时任务，结束正在运行的 Agent 会话。
  3. 使用软件商店、AI 模型等页面当前提供的“导出”入口保存可迁移配置。
  4. 记录实例名称、运行位置、工作目录和 Agent 关联关系。
  5. 备份真实项目文件；加密数据先完成解锁/恢复演练。
  6. 单独记录需要重新授权的模型、MCP、IM 和软件账号。
  7. 把备份放到不同设备，并打开检查，不要只确认文件存在。

导出文件可能包含凭据，必须按敏感资料保管。页面导出也不代表覆盖全部数据。

升级​

  1. 阅读目标版本说明，确认支持的系统和迁移要求。
  2. 仅从本手册或官方渠道下载安装包。
  3. 在 Windows 文件属性中检查数字签名发布者；官方提供 SHA-256 时再核对校验值。
  4. 完成备份并停用自动任务。
  5. 关闭面板后执行升级，不在任务运行时覆盖安装。
  6. 启动后按下面的验收顺序逐项测试。

升级后验收​

  1. 面板能启动，“关于”显示目标版本。
  2. 运行环境检测通过。
  3. 模型连接测试通过。
  4. 软件商店和实例状态正常。
  5. 使用测试目录完成一个只读任务。
  6. Skill、MCP、IM 和定时任务按需逐个恢复。
  7. 文件加密和敏感文件夹先用测试数据验证。

回滚​

只有官方明确支持目标版本回滚，且备份与旧版本兼容时才回滚。不要直接用旧安装包覆盖新数据目录。先保留升级后的完整现场，再按官方版本说明恢复程序和对应备份。

卸载​

  1. 结束任务并停用定时计划。
  2. 完成备份，确认受保护数据已经解锁或解密。
  3. 记录仍需撤销的模型、MCP、IM 和授权凭据。
  4. 使用系统或当前安装程序提供的卸载入口。
  5. 不要手动删除未知数据目录；先确认其中没有项目、日志或配置。
  6. 在外部平台撤销不再使用的 Token 和机器人权限。

换机与便携运行​

产品保留 U 盘和移动硬盘便携使用能力，但必须使用当前版本明确提供或验证的运行包。不要只复制普通安装目录就假定能够工作。

换机时先在新设备安装匹配版本，再分批导入模型、Agent、实例和工具配置。每导入一类就做一次测试；本地路径、盘符、SSH 密钥和系统权限通常不能直接照搬。

故障排查​

现象处理方式
升级后无法启动保留现场，记录版本和日志，不要连续覆盖安装
配置没有迁移核对导出范围、版本兼容和新设备数据目录
模型或 IM 失效重新授权并检查凭据是否绑定旧设备或旧回调
路径失效更新工作目录和实例配置，不批量替换未知配置文件
加密资料打不开停止继续写入，保留备份并联系技术支持

需要人工处理时，按 技术支持 提交版本、操作顺序和第一条错误。

下一步​