chore(spec): 归档 blog-5n——八任务收敛(后台深度优化全家桶)

Spec: 2026-11-05_blog-5n-admin-deep-optimization

Co-authored-by: GLM-5.3
This commit is contained in:
wait4xandGLM-5.3 committed 2026-11-05 20:13:09 +08:00
1 parent a555a3e450
commit 5c0e6ed900
29 files changed
+1559 -512

No files matched your search

+26
View File
@@ -0,0 +1,26 @@
# 后台回滚指引
> **一句话版本**:改坏了内容 → 后台再保存一次对的就好;整次部署坏了 → Gitea 网页里把坏提交 Revert 掉;全站级灾难 → 找主理人执行灾备开关。
## 什么时候需要哪一层
| 情形 | 用什么 | 频率预期 |
|---|---|---|
| 某篇文章/瞬间/设置改坏了 | **后台再改一次**(Git 只是保险,不是日常工具) | 常见 |
| 一次部署把多处弄坏、说不清单点 | **Gitea 网页 Revert**(下面三步) | 偶发 |
| 静态站整体故障无法快速修复 | 灾备开关切回旧 Halo(仅主理人执行,见文末) | 理论上不会 |
## Gitea 网页 Revert 三步
1. 打开提交历史:https://git.wait4x.online/wait4x/blog/commits/branch/main
(每次后台「保存」都是一条提交,时间与描述能对上)
2. 点开**弄坏的那条提交** → 右上角 **Revert** 按钮 → 确认。Gitea 会自动生成一条反向提交并提示创建 PR/直接合并——选择直接合并到 `main`
3. 推送后 30–60 秒自动构建部署,站点回到坏提交**之前**的状态
注意:
- Revert 撤销的是**整条提交**(那一次保存改动的所有内容)。如果好改动和坏改动混在同一次保存里,别 Revert,回后台把坏的部分再改回来更精准
- 只想回退构建但保留内容?不存在这种需求场景——构建永远反映 main 最新状态
## 灾备开关(仅主理人)
`infra/deploy/rollback.sh` 是**整站切换**:把 nginx 从静态站切回旧 Halo(127.0.0.1:18090),秒级生效。这是静态站全面故障时的逃生通道,日常内容问题永远用不上它。预演:`bash infra/deploy/rollback.sh`(默认 dry-run);执行需 root + `--exec`。
+15
View File
@@ -240,3 +240,18 @@ token 位在 `~/docker_apps/blog/github-token.txt`(本机,0600)。
- 启动时探测 /api/forgejo 报 404 属良性回落(日志噪音,无影响)
- 大视频仍走仓外 store + /media/ 绝对路径(见写作指南体积纪律表)
## 媒体文件落点地图(5n 归置)
上传的文件各归各位,不用记——表里的「落点」由后台自动处理:
| 在哪上传 | 落到仓库哪 | 网页上从哪读 |
|---|---|---|
| 文章封面/文内图 | content/posts/assets/ | 构建期自动优化为 WebP |
| 瞬间配图 | 同上(按集合相对路径) | 同上 |
| 主页头像/关于页图 | content/site/assets/ | 构建期优化 |
| 站点图标 favicon | public/icons/ | 原样分发 |
| 图库照片 | content/photos/(摄取管线) | 灯箱走原图、列表走优化图 |
「媒体库」页面(后台左侧 Media)列出的是图库照片目录。要找某篇文章的配图,直接进那篇文章的编辑页点开图片字段即可。