如何用 career-ops 的 verify-ats.mjs 检查生成的 CV HTML 是否可被 ATS 解析并拿到修复清单【免费下载链接】career-opsOpen-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)项目地址: https://gitcode.com/GitHub_Trending/ca/career-opscareer-ops 的pdf模式会先把定制后的简历渲染成 HTML例如output/cv-{candidate}-{company}.html再交给generate-pdf.mjs出 PDF。在这个中间产物上仓库提供了verify-ats.mjs一个确定性的只读检查器读取一份已生成的 CV HTML输出一个 0-100 的结构性分数、字母等级A-F以及一份逐条可修复的问题清单。它不调用 LLM、不访问网络、不写任何文件尊重 DATA_CONTRACT.md 的用户层只读约定同一份 HTML 输入永远得到同一份结果。与同样以verify开头的 verify-cv-facts.mjs 分工不同后者是pdf管线里的硬性关卡管简历里声称的事实是否属实verify-ats.mjs是建议性的advisory管ATS 解析器到底能不能把这份 HTML 读出来。它没有被接入pdf流程永远不会阻塞 CV 生成——modes/ats.md 明确要求把分数和 issues 呈现给用户而不是据此拦截。前置条件先拿到一份生成的 CV HTML检查的对象是pdf模式在渲染 PDF 之前产出的 HTML 文件。按 modes/pdf.md 的管线这份文件的来源是从cv.md定制内容后写出 JSON 渲染载荷到/tmp/cv-{candidate}-{company}.json{candidate}取自config/profile.yml的name规范化为 kebab-case 小写运行node build-cv-html.mjs /tmp/cv-{candidate}-{company}.json {html-path} {template}生成 HTML。一次性 CV 的{html-path}通常是output/cv-{candidate}-{company}.html复用型 bundle 则在cv/tailored/vNNN/cv.html通过事实关卡node verify-cv-facts.mjs {html-path}这一步是硬性关卡失败必须先修。之后才是本文的主角——对同一份{html-path}跑verify-ats.mjs。如果你手上只有一步一步手写的 HTML也同样适用检查器只认一个 HTML 文件。运行检查在项目根目录下执行node verify-ats.mjs output/cv-jane-smith-acme.html其中文件名替换成你实际的 CV HTML 路径。仓库的 package.json 里还有一个等价入口npm run cv:verify-ats -- file。完整参数形式node verify-ats.mjs output/cv-jane-smith-acme.html --keywords python,kubernetes,rag node verify-ats.mjs output/cv-jane-smith-acme.html --role Senior Backend Engineer node verify-ats.mjs output/cv-jane-smith-acme.html --min-score 80 --json各参数的用途--keywords a,b,c— 逗号分隔的目标关键词用于一份建议性的关键词覆盖度报告对照 CV 正文统计命中与缺失。--role ...— 把一个职位标题作为整句短语加入关键词集合。它只在逗号、斜杠和单词 and 处切分短语按原文整体匹配不会被拆成单词。--min-score N— 通过阈值取值 0-100默认 70。--json— 以机器可读的 JSON 输出结果通过和失败时都打印。--self-test— 运行内置回归测试套件见后文。--help/-h— 打印用法。退出码约定结构性分数达到--min-score且不存在任何critical级别 issue 时返回0否则返回1。这与项目里其他 verify 脚本的 0/1 约定一致方便放进脚本判断。读懂输出分数、等级与修复清单人类可读输出--json之外的默认模式长这样——下面是按 modes/ats.md 描述的结构整理的示例结果具体数值取决于你的文件ATS check: cv-jane-smith-acme.html Score: 85/100 (B) Threshold: 70 Issues: [warning] Non-standard font(s): comic sans ms. Prefer widely-supported, embeddable fonts ... [info] No phone number detected (optional, but many ATS intake forms expect one). ATS check passed: cv-jane-smith-acme.html判断逻辑只有两条Score是否 ≥Threshold以及Issues里有没有critical。每条 issue 都带critical/warning/info三个严重级别之一并说明修什么。修复优先级按严重级别来critical必须处理warning建议处理info仅供参考比如没检测到手机号只是 info。分数由 8 项固定权重加总到 100每项扣分都会挂一条对应 issue。权重与含义如下引自 modes/ats.md与 verify-ats.mjs 源码一致权重检查项为什么重要15存在真实、可选中的文本≥ 300 字符纯图片/栅格化 CV 没有文本层ATS 读不到20标准章节标题Experience、Education、Skills 必备Summary/Projects/Certifications 加分ATS 解析器靠可识别的标题切分简历15联系邮箱位于正文可达位置另检测电话是否存在不计位置ATS 常丢弃语义化header/footer区域邮箱必须落在正文20单栏布局无布局表格/多栏 CSS表格和分栏会打乱抽取器遵循的阅读顺序10没有把 CV 文本烧进图片ATS 读不到图片里的文字10标准、可嵌入的字体冷门字体可能抽取为乱码或缺字5声明了 UTF-8保证重音字符和符号在抽取中完整5无隐藏文本/关键词堆砌白底白字或display:none的关键词会被扣罚等级映射A≥ 90B≥ 80C≥ 70D≥ 60其余F。几个容易踩坑的判定细节都来自源码注释邮箱只出现在语义化header/footer里会被判为critical——因为 ATS 通常直接丢弃这两个区域而模板里用普通div classheader做的联系块属于正文不会被误报。单个元素的display:table随附模板的 certifications 区块就是这样用的不会被标记只有真正的table元素和多栏 CSScolumn-count/columns≥ 2才会扣分。table是 critical多栏 CSS 和绝对定位是 warning。年份区间如 2019 - 20248 位数字不会被误判为电话号码电话号码要求至少 9 位数字。白字检测只扫描内联style不扫描style块——样式表里的白色彩色徽章、标题渐变是合法的而stylecolor:#ffffff这种内联白字才是典型的关键词堆砌信号。单引号写法也逃不过检测。可选附带关键词覆盖度检查--keywords或--role是建议性的只报告目标关键词在 CV 正文里命中了多少、缺了哪些永远不改变 0-100 的结构性分数所以不带职位信息的裸跑不会产生假失败。典型用法是在渲染 PDF 之前把 JD 的关键词传进去确认覆盖度node verify-ats.mjs output/cv-jane-smith-acme.html --keywords python,kubernetes,rag --json输出里会多出一段Keyword coverage: {found}/{total} ({percent}%)和Missing: ...列表--json下对应keywordCoverage字段。修复循环与自验证modes/ats.md 给出的建议工作流是四步闭环通过pdf模式生成 CV经过事实关卡运行node verify-ats.mjs output/cv-{candidate}-{company}.html修复critical/warning项——通常改在模板或渲染载荷上——然后重新运行可选地带--keywords确认 JD 关键词覆盖度再渲染 PDF。修复的落点取决于 issue 类型结构问题章节标题、布局、字体、编码声明改模板或build-cv-html.mjs的渲染载荷内容问题缺邮箱、文本量不足回到定制流程补内容。改完必须重跑同一命令用新的Score行和空Issues或只剩info确认修复生效退出码变为0即为通过。想先验证工具本身行为再对真实文件下结论可以跑内置回归套件node verify-ats.mjs --self-test它会用一组内联 fixture 断言各个单项检查干净 CV 得 A、缺两个必备标题判 critical、table布局判 critical、图片为主且文本不足判 critical、非标准字体判 warning、邮箱缺失判 critical 等并打印verify-ats self-test: N passed, M failed有任何断言失败则以退出码 1 结束。限制与边界建议性不是关卡。它不属于pdf的硬性关卡链不会阻止生成。输出失败时脚本会提示 Fix the critical/warning items above, or lower the bar with--min-scoreif you accept the risk.——是否放行由你决定。只报结构风险不报事实。事实与虚构防护归verify-cv-facts.mjs管两者互补不要混用。输出固定为英文。verify-ats.mjs出于零 LLM 设计固定输出英文modes/ats.md 要求把分数和 issues 转述给用户时按 AGENTS.md 的输出语言机制把面向用户的摘要翻译成language.output但脚本原始 stdout 保持英文。只读。只读取一个 HTML 文件不写任何用户层文件。如果--min-score被调高后一直不过、而结构性问题已修复完modes/ats.md 的说明是唯一出口接受风险并显式降低阈值或继续修剩余 issue——文档没有给出第三种判定方式。检查通过退出码 0后下一步就是按 modes/pdf.md 的第 21 步执行node generate-pdf.mjs {html-path} {pdf-path} --format{letter|a4} --report{report number}渲染 PDF。【免费下载链接】career-opsOpen-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)项目地址: https://gitcode.com/GitHub_Trending/ca/career-ops创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考