回滚操作需按四步执行：一、确认当前与目标版本；二、用mulerun rollback原子降级；三、离线介质强制恢复；四、验证认证、Agent调度及HTTP Skill调用功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在升级骡子快跑后出现功能异常、接口不可用或agent无法启动等问题，说明新版本部署已影响生产稳定性。以下是执行版本回滚以恢复服务的标准化应急操作流程：一、确认当前运行版本与目标回滚版本
回滚前必须精准识别正在运行的异常版本号及上一个已验证稳定的版本标识，避免因版本错配导致兼容性灾难。所有版本信息均需从运行时环境直接提取，不得依赖人工记录或网页显示。
1、在终端中执行mulerun --version命令，捕获输出中的完整语义化版本字符串（如v3.7.2-rc1）。
2、访问https://app.mulerun.ai/settings/system，在“部署历史”面板中查找最近一次标记为Verified状态的版本条目，记录其SHA256校验值与发布时间戳。
3、执行journalctl -u mulerun-agent -n 20 --no-pager | grep "Starting MuleRun v"，比对日志中实际加载的版本是否与--version输出一致，排除二进制缓存污染可能。
二、使用内置回滚命令触发原子化降级
骡子快跑自v3.5.0起内置mulerun rollback指令，该命令将自动拉取本地缓存的前序版本二进制、校验完整性、停用当前进程、切换符号链接并重启服务，全程无需手动干预文件系统。
1、确保当前用户具备sudo权限且/var/cache/mulerun/versions/目录存在至少一个历史版本子目录（命名格式为vX.Y.Z）。
2、执行sudo mulerun rollback --to v3.6.8 --force，其中v3.6.8须替换为步骤一中确认的稳定版本号。
3、观察终端输出是否包含Rollback completed successfully及Active version now: v3.6.8两行确认信息。
4、立即执行systemctl is-active mulerun-agent，验证返回值为active而非failed或inactive。
三、从离线介质恢复指定版本
当本地缓存被清空或目标版本未被预下载时，必须通过可信离线介质强制还原，该方式绕过网络校验环节，适用于断网环境或证书链失效场景。
1、将官方提供的回滚包mulerun-v3.6.8-offline.tar.gz（SHA256校验值：a1f8b2c9d0e7f6a5b4c3d2e1f0a9b8c7d6e5f4a3b2c1d0e9f8a7b6c5d4e3f2a1）拷贝至目标服务器/tmp目录。
2、执行sudo tar -xzf /tmp/mulerun-v3.6.8-offline.tar.gz -C /opt/mulerun/ --overwrite，强制覆盖所有文件。
3、运行sudo /opt/mulerun/bin/post-install.sh --skip-network-check，跳过联网验证步骤，仅执行本地配置重载与权限修复。
4、手动删除/var/run/mulerun.pid与/var/log/mulerun/agent.log，防止旧进程残留锁或日志污染干扰新实例启动。
四、验证回滚后核心功能可用性
回滚操作完成后必须执行最小集冒烟测试，确认关键路径未因版本切换引入隐性故障，测试项必须覆盖身份认证、Agent调度与HTTP Skill调用三大基础能力。
1、在浏览器中访问https://app.mulerun.ai/api/v1/auth/status，检查返回JSON中"authenticated"字段是否为true且"version"值匹配目标版本号。
2、在控制台新建一个最简Agent，仅包含单个HTTP GET Skill节点，目标URL设为https://httpbin.org/status/200，点击运行并确认日志输出中出现HTTP Status: 200。
3、执行curl -s http://localhost:8080/health | jq '.status'，验证响应为"UP"且uptime_seconds值大于60。
