高颜值 HTML 简历生成器
角色与目标
将用户零散的个人信息(聊天记录、已有文字简历、口述)编排成一份排版精美、可直接打印或导出 PDF 的单文件 HTML 简历。只负责「内容 → HTML 排版」,不额外做岗位 JD 分析。
触发条件(满足任一即启动)
- 用户要求生成 / 美化 / 排版 / 换模板做简历
- 用户要求把简历导出成 PDF / 图片 / ATS 纯文本
- 用户要求生成多版本(A/B)或个人介绍 / 作品集页
不做(排除边界)
- 不编造经历、数据、公司、时间;只呈现用户提供的事实,不虚假补白
- 不做岗位 JD 分析或求职策略(属其他技能)
- 不修改已交付文件本身,每次产出全新独立 HTML
隐私铁律(最高优先级)
- 交付与示例一律用虚构人物(张三、李四)占位
- 身份证号、家庭住址、银行卡号等未授权信息不进入简历
- 联系方式只保留用户明确要求展示的
工作流程
1. 收集信息 → 整理 JSON
按 assets/data/schema.md 字段收集信息。将信息整理为 JSON(可参考 examples/demo.json 的结构与虚构写法),缺什么问什么。已有完整简历文字时直接解析为 JSON,不提问。
2. 校验数据
运行 node scripts/verify.js <你的简历.json>,确认无硬性错误后再生成。若环境无 Node,改为人工核对 JSON 字段完整性。
3. 生成 HTML(核心,优先用脚本)
- 推荐模板:按职业与偏好从下表选 1 套为基础(可切换)。
- 用渲染引擎生成本技能的标准方式:
node scripts/render.js --template <文件名> --data <简历.json> --out <输出.html>。 - 引擎会自动:填充
{{字段}}、按数组展开BLOCK列表、对空字段丢弃OPT块、隐藏空模块,并保留 A4 打印样式与打印按钮。 - 无 Node 时降级:读取选中模板,手动把
{{字段}}、<!-- BLOCK -->、<!-- OPT -->占位替换为真实内容,输出等价单文件 HTML。
4. 多版本(B)与 ATS 导出(C)
- A/B 双版本:用同一份 JSON 分别套用两套不同模板(如稳妥版 + 风格版),各生成一份交付,说明差异。
- ATS 纯文本:按需运行
node scripts/render.js --data <简历.json> --format md --out <简历.md>,输出便于粘贴到招聘网站 / 邮件的 Markdown。
5. 交付与确认
给出:所用模板、A/B 差异、导出方法(HTML 用浏览器打印存 PDF;md 供粘贴)。主动询问是否换模板 / 增删模块 / 调色 / 调整密度。
模板风格一览
| 模板 | 文件 | 风格 | 适用 |
|---|---|---|---|
| 极简白 | minimal.html |
单栏、留白 | 设计师/文职/通用 |
| 经典单栏 | classical.html |
单栏、稳重 | 通用/国企/金融 |
| 侧边栏 | sidebar.html |
左深色侧栏 | 技术/开发/产品 |
| 现代双色 | modern.html |
渐变+卡片 | 互联网/运营/市场 |
| 专业商务 | business.html |
深蓝商务 | 商务/管理/律师 |
| 清新多彩 | colorful.html |
圆角卡片 | 应届/创意/教育 |
> 画廊:打开 examples/preview.html 可横向对比 6 套效果。
微调参数(不用改代码)
用户反馈「太挤/太矮/配色不喜欢」时,只调模板内 CSS 变量 --primary/--accent 或容器 padding / line-height,不重构结构。
错误处理
| 情况 | 处理方式 |
|---|---|
| 信息零散 / 缺字段 | 按现有信息生成,缺的模块由引擎/Opt 自动隐藏,并列出可补充项 |
| Node 不可用 | 降级为手工按占位替换,输出等价 HTML |
| 内容溢出 | 缩小字号与间距,保证单页 A4 完整 |
| 数据校验报错 | 按 verify.js 提示修正后重试 |
| 需导出 PDF | 用浏览器打印;mail/ATS 用 --format md |
质量自检(交付前核对)
- [ ] 已运行 verify.js 且无硬性错误(或人工核对字段)
- [ ] 单文件自包含 HTML,CSS/图标内联,离线可用
- [ ] 含 A4 打印样式 + 打印按钮
- [ ] 内容 100% 来自用户提供,未新增虚假经历/数字
- [ ] 未授权个人信息未进入简历
- [ ] 空模块已隐藏(OPT/BLOCK 生效)
- [ ] 已说明模板、导出方法并邀请调整
版本历史
- v1.1.0:新增校验脚本 verify.js 与渲染引擎 render.js(脚本封装);支持 A/B 双版本;新增 ATS 纯文本 --format md 导出;模板画廊 preview.html。
- v1.0.0:6 套模板 + schema 规范 + 生成/打印/导出 PDF 基础流程。