# 经验记录

本文件用于记录个人简历构建项目修改过程中的关键问题与解决方案。每条经验使用四段式结构。

## 2026-05-19-23-10-56 Reactive Resume PDF 下载文件名修改

A. 具体问题

用户希望浏览器下载 PDF 时的文件名从 `ZhiboWang-Resume.pdf` 改为 `王志博-医工智能外科-简历.pdf`，当前 DICOM 项目中没有该文件名，需要定位真实项目。

B. 产生问题原因

该下载文件名不是 DICOM 项目功能，而是个人简历构建项目中的 Reactive Resume 容器补丁脚本硬编码。Reactive Resume 的前端 public JS 和 SSR 文件都需要同步修改，且浏览器可能缓存旧静态资源。

C. 解决问题方案

在 `/home/wkmgc/Desktop/个人材料编写/个人简历构建` 中定位到 `scripts/patch-reactive-resume-filename.sh`，将 shell 与 Node 补丁逻辑中的 PDF 文件名统一改为中文文件名；同时把 cache bust 更新为 `rr-filename-20260519-cn`，并让 import 替换逻辑兼容旧 cache bust。执行脚本后容器重启并恢复 healthy。

D. 后续如何避免问题

涉及线上下载文件名时，应先全局搜索目标文件名并确认真实项目；修改容器补丁脚本后必须立即运行脚本、验证容器内 public/SSR 文件、验证 HTTP 静态资源和服务健康，避免只改脚本未生效。

## 2026-05-19-23-10-56 Reactive Resume Gitea 推送凭据缺失

A. 具体问题

本次本地备份 commit 已创建，但执行 `git push origin main` 时失败，Git 提示无法读取 `http://192.168.31.5:5002` 的用户名。

B. 产生问题原因

当前 `origin` 使用 HTTP Gitea 地址，执行环境没有交互式凭据输入，也没有已配置的凭据助手。

C. 解决问题方案

保留本地 commit，不把账号密码写入命令、文档或 Git remote。将推送失败写入测试方案和经验记录，后续由用户配置安全凭据或改为 SSH remote 后再推送。

D. 后续如何避免问题

Gitea 推送前先检查认证方式。优先使用 SSH 或安全凭据助手；如果 HTTP remote 需要 token，应通过安全环境变量或凭据管理器提供，不要直接拼进 URL。