Merge remote-tracking branch 'origin/master' into feat/agc_track

合并最新master
2026-09-21 04:18:38 +00:00
parent ca82e6b745 55cb047654
commit b840973d82
3 changed files with 35 additions and 2 deletions
@@ -1,5 +1,9 @@
 # 踩坑与排障记录

+## macOS 通用包里的 Node 便携运行时仍是宿主架构
+
+`stage-node-runtime.mjs` 只把**构建宿主的 Node** 打成便携运行时（`targetRuntime` 只支持 per-arch 目标），而 `build-macos-ci.mjs` 构建的是 `universal-apple-darwin`：2026-09-21 macOS Job #13 因此在 `stageNodeRuntime` 直接抛 `Node 运行时不支持发布目标：universal-apple-darwin`。当前按「通用包 + 宿主架构（arm64 构建机 → arm64）Node」放行：`check-macos-bundle.mjs` 按 `process.arch` 校验，所以本机自检通过，但**Intel Mac 上该侧车不可执行**。要真正通用需要另行下载另一架构官方 Node 发行版并用 `lipo -create` 合并，同时把 bundle 检查改成接受 `universal` 并核验 `lipo -archs node = arm64 x86_64`；在此之前不得宣称 macOS 通用包在 Intel 上可用。
+
 ## release 冷备空间不足会把生产留在维护态

 `Genarrative-Stdb-Module-Publish` 先进入维护模式、停掉 API/controller/worker，再执行发布前冷备份；archive 口径要求 `data × 1.1`（40.6GiB 数据 → 44.7GiB，加上生产根盘只剩 13.5GiB），于是 2026-09-21 的 release 发布在停服后失败并保持维护态，站点 503 直到人工恢复。规则：空间预检必须先于 `maintenance-on` 与停服；archive 不足且未显式禁用降级时改用 files（`max(data × 0.05, 2GiB)`，不落地本地归档，但 files 不支持 `--defer-upload`，会从 async 收敛为 sync）；只有真正开始 `spacetime publish` 之后的失败才允许保持维护态。另：定时备份的失效锁在当前仓库版本会自动清理，但生产机 `/var/lib/genarrative/backup-tools/database-backup-to-oss.mjs` 若是旧版会拒绝抢锁并要求人工删锁，需随 provision 更新。