chasen-liao 简历版本管理器
以私有 resume-facts.yaml 为唯一事实源，为每次投递建立可回溯、可比较的母版和定制版本。HTML/PDF 是从已确认事实生成的交付物，不替代事实记录。
它不占用用户的主流程入口：在母版确认或 JD 定制版确认后记录版本即可；用户需要比较、恢复或维护投递记录时再展示版本操作。
先读
工作流
- 找到或创建私有
resume-facts.yaml和明确标识的母版；事实文件保存候选人全部已确认的 claim，不能被定制操作覆盖。 - 为一个公司/岗位/JD 创建独立目录：
tailored/<公司名>-<岗位>/。 - 记录父版本、目标 JD、创建日期、使用的候选人事实、重排项、改写项、关键词来源、未匹配要求和待确认字段。
- 生成该版本的
resume_visual.html，必要时生成resume_ats.html和matching-analysis.md；验证 PDF 页数、可提取文本和 HTML 溢出，并只记录 hash 对应当前文件的 valid manifest。 - 比较版本时按事实、顺序、措辞和样式分组；发现事实不一致时标记冲突并请求候选人确认。
Git 版本历史（推荐）
将 resume/ 放在本地私有 Git 仓库中，用提交记录确认后的事实和投递版本；不要默认推送到公开远程仓库，简历可能包含联系方式和其他个人信息。
- 候选人确认母版变更后，创建一次说明明确的提交，例如：
更新母版：补充 RAG 项目。 - 每次确认生成一份定制版后，创建一次提交，例如：
定制：字节跳动 - 前端实习生。 - 比较、恢复或审计时，以提交差异为准；比较范围仍按事实、顺序、措辞和样式分组，并优先确认事实冲突。
- 只有候选人希望同时尝试互斥的母版方向时，才创建分支；普通的 JD 定制保存在
tailored/目录并用提交追溯即可。 - 不自动执行 Git 初始化、提交、推送或覆盖；在每个会改变版本历史的操作前说明范围并取得候选人确认。
推荐清单
resume/
├── resume.html # 母版
└── tailored/
└── <公司名>-<岗位>/
├── resume_visual.html
├── resume_visual.pdf
├── resume_ats.html # 按需生成
├── resume_ats.pdf # 按需生成
├── matching-analysis.md
└── version-notes.md
version-notes.md 最少记录：父版本、所用 resume-facts.yaml、JD 来源/日期、变更摘要、关键词来源、未匹配要求、待确认字段和导出验证结果。
若使用 Git，version-notes.md 还应记录对应提交 ID，便于从定制版回到母版事实和生成依据。
约束
- 定制版只能重排、强调或改写已确认事实；回写母版需要用户明确要求。
- 命名可使用
姓名_岗位_公司_YYYYMM.pdf，但以目标平台要求为准。 - 不通过删除历史版本、静默覆盖文件或伪造版本记录来“整理”工作区。