resume-version-manager

简历版本管理器

以私有 resume-facts.yaml 为唯一事实源，为每次投递建立可回溯、可比较的母版和定制版本。HTML/PDF 是从已确认事实生成的交付物，不替代事实记录。

它不占用用户的主流程入口：在母版确认或 JD 定制版确认后记录版本即可；用户需要比较、恢复或维护投递记录时再展示版本操作。

先读

读取 简历事实契约、JD 匹配报告模板 和 写作规范。

工作流

1. 找到或创建私有 resume-facts.yaml 和明确标识的母版；事实文件保存候选人全部已确认的 claim，不能被定制操作覆盖。
2. 为一个公司/岗位/JD 创建独立目录：tailored/<公司名>-<岗位>/。
3. 记录父版本、目标 JD、创建日期、使用的候选人事实、重排项、改写项、关键词来源、未匹配要求和待确认字段。
4. 生成该版本的 resume_visual.html，必要时生成 resume_ats.html 和 matching-analysis.md；验证 PDF 页数、可提取文本和 HTML 溢出，并只记录 hash 对应当前文件的 valid manifest。
5. 比较版本时按事实、顺序、措辞和样式分组；发现事实不一致时标记冲突并请求候选人确认。

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，但以目标平台要求为准。
• 不通过删除历史版本、静默覆盖文件或伪造版本记录来“整理”工作区。