docs: 迁 CNB 前的架构决策文档 + 构建骨架

- 决策文档：架构总览 / 代码源与构建平台选型 / CNB构建落地方案 /
  EdgeOne双区域 / Gitee / 阿里云ESA / 精简方案
- CNB 构建骨架：deploy/Dockerfile、bin/linux/hugo
  （84MB，linux/amd64 extended 0.128.2，供 CNB 容器 COPY 用）
- scripts/setup-cnb-remotes.sh：双远端切换（CNB 主仓 + GitHub 备份）
- .gitignore 补 .workbuddy/（工作数据不入库）

砍COS改造步骤.md

@@ -4,10 +4,40 @@
 > 改成「build → Gitea artifact →（中转机拉取）→ 又拍云 → 多吉云」，
 > 砍掉腾讯云 COS 这一层，省下 COS 存储/流量账单。
 
-> 状态（2026-10-04）：
-> - ✅ `deploy.yml` 已改完（本地，未推送）
-> - ⏸️ `sync.sh`（国内中转机）待改，**卡在需要一个 Gitea 只读 token**
-> - ⚠️ 两者必须一起改一起推，否则国内博客会停更（见下方「为什么不能只推一半」）
+> 状态（2026-10-04 更新）：
+> - ✅ `deploy.yml` 已改完并**已推送**
+> - ✅ 中转机 `sync.sh.new`（artifact 版）已上传到 `/opt/upyun-sync/sync.sh.new`，**尚未生效**
+> - ✅ Gitea 只读 token 已写入中转机 `/opt/upyun-sync/.gitea_token`（600 root:root）
+> - ❌ 链路**尚未跑通**：run #55 倒在 v4 不支持，run #56 倒在 v3 的 finalize 500
+> - ⏸️ 最新修复（单文件 tar，commit `1f568bbf`）**本地已提交、待推送**
+> - ⚠️ `deploy.yml` 与 `sync.sh` 必须一起生效，否则国内线路停更（见下）
+
+---
+
+## 零、实测踩到的两个坑（都已修，记录备用）
+
+### 坑 1：`upload-artifact@v4` 在 Gitea 上直接失败（run #55）
+
+```
+::error::@actions/artifact v2.0.0+, upload-artifact@v4+ and download-artifact@v4+
+are not currently supported on GHES.
+```
+
+Gitea 被 v4 识别为 GHES，但它没实现新版 artifact API → **降级 v3**（commit `ed38f938`）。
+
+### 坑 2：v3 传「目录」时 Gitea finalize 返回 500（run #56，耗时 30 分钟）
+
+v3 收目录是**逐文件上传**：3216 个 blob / 376MB 全部传完（日志可见 `Processed file #3216`），
+但最后的 finalize 调用被 Gitea 拒绝：
+
+```
+Finalize artifact upload - Attempt 1..5 of 5 failed with error: Request timeout
+::error::Finalize artifact upload failed: Artifact service responded with 500
+```
+
+**结论：Gitea 扛不住「文件数多」的 artifact。** 改法（commit `1f568bbf`）：
+build 侧先把 `public/` 打成**单个** `public.tar.zst`，只上传这 1 个文件。
+副作用是好的——产物结构从此完全确定，不再有「解出来会不会多一层 `public/`」的歧义。
 
 ---