happy-next: Skill for Claude Code

happy-app OTA 发布与回滚

App 的 JS 和资源可以不经过商店直接更新：yarn ota（packages/happy-app/sources/scripts/ota.ts）把更新上传到 happy-server（/v1/ota/*），App 里的 expo-updates 从 https://api.happy-next.com/v1/ota/manifest 拉取。

• runtime version 就是原生 fingerprint（fingerprint.config.js）。一个更新只会发给 fingerprint 相同的安装包。改了原生依赖、插件或 app.config.js 中影响原生的部分以后，fingerprint 会变，旧包就收不到这次更新，要先打新的原生包。
• App 什么时候收到更新：
  • 冷启动时，原生层会在后台下载更新，到下一次冷启动才换上。
  • App 从后台回到前台时，也会检查并下载（hooks/useUpdates.ts，在根布局里启动）。下载好后，收件箱顶部会出现「有可用更新」横幅，点一下立即重载。不点的话，下一次冷启动时生效。
• 渠道： production、preview、development 各对应同名 channel，默认用 production。

调用本技能，就是授权执行下面「流程」第一、三、四段的操作。第二段的计划要用户确认后才能执行。由 happy-next-release 照本文件执行时，以它的发布计划为准，不再单独确认。

一、检查（不询问用户）

在 packages/happy-app 下：

1. 工作区： 运行 git status --porcelain --untracked-files=no。有未提交的已跟踪改动时停下，让用户选「先提交」还是「不发布」。不要把未提交的改动发出去，ota.ts 遇到这种情况只会警告，不会拦。

2. 算出这次的 runtime： 和发布时一样，要在 EAS 环境里算：

   T=$(mktemp -d); npx eas-cli env:pull production --path $T/p.env --non-interactive >/dev/null
   for p in ios android; do ( set -a; . $T/p.env; set +a; export APP_ENV=production NODE_ENV=production CI=1
     npx expo-updates runtimeversion:resolve --platform $p 2>/dev/null | tail -1 ); done; rm -rf $T
   

3. 哪些安装包收得到： 把上一步的 runtime 和已经装在用户手机上的包的 fingerprint 对一下（工具：.claude/skills/happy-ota/scripts/embedded-fingerprint.sh <ipa|apk>）：

   • 最近一次 GitHub Release（App Store 和 Android 用户用的就是它）：

     D=$(mktemp -d); gh release download <tag> -p '*-ios.ipa' -p '*-android.apk' -D $D
     

     解出 fingerprint 后删除目录。输出「no embedded fingerprint」，说明这个包打在自建 OTA 之前，收不到任何 OTA。
   • Mac mini 测试包： ~/wwwroot/appdown/builds/ 里最新的 HappyNext-*.ipa，用 orchestrator_exec 在 Mac mini 上执行 unzip -p <ipa> 'Payload/*.app/EXUpdates.bundle/fingerprint'。
   • 历史更新： yarn ota list --platform ios 和 --platform android，列出之前的更新发到了哪些 runtime。

   哪个平台都对不上，就说明没有设备能收到这次更新。这时停下，告诉用户要先打原生包（测试包用 happy-ios-build，正式版走 happy-next-release）。

4. 这次包含哪些改动： 从 yarn ota list 里取同平台最近一次更新的 gitCommit，执行 git log --oneline <gitCommit>..HEAD -- packages/happy-app packages/happy-wire。如果其中有原生相关的改动（package.json 里的依赖、plugins/、modules/、targets/、patches/、app.config.js），第 2 步算出的 runtime 应该已经变了，要和第 3 步的结论一起核对。