2026-05-19-23-23-50 回滚简历PDF下载文件名

工程分析/经验记录.md

@@ -37,3 +37,21 @@ C. 解决问题方案
 D. 后续如何避免问题
 
 Gitea 推送前先检查认证方式。优先使用 SSH 或安全凭据助手；如果 HTTP remote 需要 token，应通过安全环境变量或凭据管理器提供，不要直接拼进 URL。
+
+## 2026-05-19-23-23-50 回滚错误的 PDF 下载文件名指令
+
+A. 具体问题
+
+用户说明上一条修改 PDF 下载文件名的指令写错了，需要撤销中文文件名变更。
+
+B. 产生问题原因
+
+上一条需求将 Reactive Resume 的 PDF 下载文件名从 `ZhiboWang-Resume.pdf` 改为中文文件名；之后最新提交又把中文文件名调整为不带短横线版本。只回滚最新提交会仍然保留中文文件名，不能真正回到原始状态。
+
+C. 解决问题方案
+
+以原始文件名 `ZhiboWang-Resume.pdf` 为目标，直接恢复 `scripts/patch-reactive-resume-filename.sh` 中 shell 与 Node 两处文件名常量，并恢复 cache bust 为 `rr-filename-20260519`。随后重新执行补丁脚本，让运行中容器 public JS 与 SSR 文件同步恢复。
+
+D. 后续如何避免问题
+
+用户要求回滚时，先确认要回到哪一个历史状态，而不是只撤销最近一个 commit。涉及线上容器补丁时，Git 文件回滚后必须重新执行补丁脚本并验证 HTTP 静态资源。