wind_power_cal/.claude/skills/ota-e2e-release/SKILL.md

name, description

name	description
ota-e2e-release	OTA升级端到端测试。用于用户说“ota升级端到端测试 新版本号xxx”“去87测试OTA”“发布并上传后去87升级”等场景，默认走 82 打包发布、云平台上传、87 前端OTA验证的一整套流程。

OTA 升级端到端测试

触发词

• ota升级端到端测试
• ota升级端到端测试 新版本号 xxx
• 发布并上传后去87测试OTA
• 去87测试OTA

固定约定

• 82 主机：cat@192.168.40.82
• 82 代码根目录：/home/cat/code/edge_collector
• 云平台账号：admin
• 目标版本由用户在“新版本号 xxx”里指定
• 如果本次包含云平台前端或 cloud_server 代码改动，先使用 cloud-deploy-verify 流程部署云平台并验证关键接口

执行流程

0. 可选：部署云平台

   • 仅当本次改动影响云平台前端、云端后端、OTA 包上传/查询接口时执行
   • 在仓库根目录运行 ./deploy_cloud.sh
   • 确认 cloud-server 运行，并验证相关云端接口

1. 82 主机发布新版本

   • cd /home/cat/code/edge_collector
   • git pull
   • ./package.sh --publish --version <version>

2. 上传到云平台

   • 使用云平台 admin 账号登录
   • 上传 publish/edge_<version>_arm64.tar.gz
   • 确认版本号、架构、发布状态与产物一致

3. 87 主机 OTA 验证

   • 打开边缘侧前端
   • 查询云平台可用版本，确认 <version> 可见
   • 通过前端接口触发 OTA 升级
   • 检查 /api/ota/status，确认当前版本已变成 <version>

失败时优先排查

• 云端字段或页面不生效：先确认已走 deploy_cloud.sh，再查 cloud-server 状态和云端接口响应
• 87 上看不到版本：先确认 82 包已上传成功，再查 87 的 OTA 配置
• 87 OTA 起不来：先执行 sudo bash /home/cat/edge/scripts/ota/install_ota_service.sh
• 前端升级失败：先看后端 OTA 接口返回，再看服务日志