feat(editor-api): 线上容器切「CNB 主 + Gitea 备」双推；备份补 fetch 步骤

用户定案：「editor-api 容器 采用 cnb主仓 gitea备份仓 openlist文件备份」。
三层各有各的失效模式，不能互相替代：
  ① 主仓 origin = CNB          —— 源码 + 触发构建，依赖 CNB 平台
  ② 代码辅仓 gitea = 自建 Gitea —— 不受第三方平台规则约束，可 clone / 按提交追溯
  ③ 离线备份 = F50/OpenList     —— 单一加密文件，平台全挂也能恢复

一、线上容器实测切双推（国内机 119.29.215.187）

先探测出两个关键事实：
  · 国内机**能**直连自建 Gitea（/api/v1/version → 200，0.38s）
  · 国内机**够不到**家里的 OpenList（192.168.0.1 私有地址，6s 超时）
    → 「文件备份」这一层只能由家庭机发起，国内机做不到（下面的 fetch 修复正因此

改动：
  · /srv/blog 停在 432cf5e3，落后 origin/main 10 个提交且是其后代
    → git merge --ff-only 追平到 448b898e，**未强推**
  · 挂 gitea 远端（凭据编在 URL 里，同本机做法）
  · .env：PUSH_REMOTES=origin → origin,gitea；追加 GITEA_URL/USER/PASS
  · docker-compose.yml 默认值同步为 ${PUSH_REMOTES:-origin,gitea}
  · docker compose up -d --build 重建

验证（全部实测通过）：
  · 启动日志 [editor-api] 分支 main 推送远端 origin, gitea
  · curl /health → "remotes":["origin","gitea"]
  · 容器内推 origin ✅ / 推 gitea ✅（推临时分支 → ls-remote 确认 → 删分支，无残留）
  · 三处 main 对齐 448b898e（本地 / origin / gitea）；工作区干净

二、备份侧：修掉一个静默漏洞 —— 打包前必须先 fetch

git bundle create --all 取的是**本地已知** ref，其中 refs/remotes/origin/main
停在上次 fetch/pull 的位置。而这份备份跑在**家里**那台机器上，工作区并不会
随写作后台（editor-api）的发布自动更新。所以原先是：后台新发的文章**一篇都不
在备份里**，而备份照样报「成功」—— 失败是静默的。

  · backup-bundle.mjs 打包前插入 git fetch --all --tags --prune
    - 失败**不致命**（离线也得出得来备份）→ 降级为「用本地已有 ref 打包」+ 显著告警
    - 新增 --no-fetch 可跳过；步骤号 1/6..6/6 → 0/7..6/7
    - 新增一行 `快照 origin/main = <sha> <时间> <标题>` —— 恢复时第一件要确认的就是它
  · backup-run.mjs：头部补三层说明；失败邮件的「常见原因」加上 fetch 降级这一条

验证：fetch 3s 拉完 origin+gitea → 打包 3.6s → 加密 1.7s → 上传 19.2s(31.5MB/s)
      → 读回 sha256 一致，快照 = 448b898e

三、bootstrap.sh：修掉另一个静默陷阱

脚本每次都会**重写** .env，而 .env 是 GITEA_PASS 的唯一落点 →
「重跑一次但没现给 GITEA_PASS」会把辅仓推送**静默关掉**（PUSH_REMOTES 降级成
origin），不报错、不提示，直到要恢复时才发现 Gitea 早就没在同步。
  · 改为：命令行没给就从旧 .env 里捡回来（显式传新值仍优先）
  · 并把 GITEA_URL/USER/PASS 也写进 .env（容器不读这几个键，仅作复用锚点）
  · 该逻辑用 4 个用例离线验证（有/无 .env、显式覆盖、.env 里没 PASS），
    并确认 set -euo pipefail 下不会被 [ -n ] && cmd 这类写法误触发退出

四、文档

· 架构总览.md：§1.2 地址地图加 editor-api 行；§2 旅程图补「两条推送入口同一套语义」；
  §5.2 加「线上容器的推送目标」段（含验证方法与 pull 源只有 origin 的铁律）；
  §5.6 加「打包前必须 git fetch」+「覆盖范围」表（诚实列出够不到的部分）；
  §6 待办 #4/#10 更新、新增 #12
· editor-api/README.md：新增「落盘：写一次，存三处」
· README.md：推送说明补线上后台那一路与 fetch 说明；脚本表更新

editor-api/README.md

@@ -57,6 +57,30 @@
 - 鉴权复用后台登录会话：管理员和编辑都放行（`/editor/*` 只有文章相关接口），
   评论/用户/设置等其它后台模块仍然只认管理员。
 
+## 落盘：写一次，存三处（2026-10-06 定案）
+
+| 层 | 载体 | 说明 |
+|---|---|---|
+| **主仓** | `origin` = CNB（`cnb.cool/zqlit/blog`） | **唯一的 fetch 源**，推送即触发构建 |
+| **代码辅仓** | `gitea` = 自建 `23.254.236.47:3001` | 只推不拉，代码留档；失败**不阻断**发布 |
+| **文件备份** | 中兴 F50 上的 OpenList | 整仓加密 bundle，由**家里那台机器**每天 03:30 跑（国内机够不到家庭局域网，故不在这边） |
+
+线上容器（国内机 `119.29.215.187`）实测配置：
+
+```ini
+# /srv/editor-api/.env
+PUSH_REMOTES=origin,gitea
+```
+
+改完必须验：`curl -s http://127.0.0.1:8017/health` 的 `remotes` 字段应为 `["origin","gitea"]`；
+容器启动日志也会打一行 `[editor-api] 分支 main 推送远端 origin, gitea`。
+写权限用「推临时分支 → `ls-remote` 确认 → 删分支」实测 ——
+**别用 `--dry-run`**，远端落后时它会误报 non-fast-forward。
+
+> ⚠️ **铁律：任何提交都必须先落到 CNB。** pull 源只有 `origin`，
+> 在别处只推了 `gitea` 的提交后台看不见（`git pull` 不从它拉），
+> 下一次发布就会因 non-fast-forward 被拒。
+
 ## 环境变量
 
 | 变量 | 默认 | 说明 |