career-ops 评估完成却没有生成 PDF:Playwright Chromium 未安装的排查方法

career-ops 评估完成却没有生成 PDF:Playwright Chromium 未安装的排查方法 career-ops 评估完成却没有生成 PDFPlaywright Chromium 未安装的排查方法【免费下载链接】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在 career-ops 中评估完一个职位后报告已经出现在reports/下但旁边没有对应的 PDF。这个现象最常见的原因不是评估流程出错而是本机缺少 PDF 渲染依赖的 headless Chromiumgenerate-pdf.mjs通过 Playwright 驱动 Chromium 把 HTML 渲染成 PDF而 Chromium 是一次性、按机器安装的浏览器不会随npm install一起到位。缺少它时career-ops 的文档明确描述了后果——“PDF 生成会失败而流水线的其他部分都正常工作所以你会得到一份旁边没有 PDF 的报告”见 docs/WINDOWS.md 第 5 节。确认问题出在 Chromium 缺失PDF 生成由npm run pdf调用 generate-pdf.mjs 完成该脚本从playwright包导入chromium并调用chromium.launch()启动无头浏览器。要确认本机是否具备这个条件最快的是跑一次 setup 自检npm run doctordoctor校验的项目包括Node.js 18、依赖已安装、Playwright chromium、必需文件cv.md、config/profile.yml、portals.yml以及字体目录缺失的目录data/、output/、reports/会自动创建见 docs/SCRIPTS.md 的 doctor 一节。退出码含义0表示全部检查通过1表示至少一项检查失败并打印对应的修复提示。如果 Chromium 缺失这里会给出明确的修复消息。安装 Chromium在 career-ops 工作目录内执行npx playwright install chromium这是文档要求的一步式安装命令docs/SETUP.md 的 “PDF rendering (one-time)” 一节每台机器只需要执行一次。前提是工作区已按 SETUP 指南完成初始化npx santifer/career-ops init或手动 clone npm install且满足 Node.js 18npx随 Node 附带。在 Windows 上该命令同样适用docs/WINDOWS.md 的检查清单把这条列为 PDF 生成前的必做项。验证 PDF 能正常产出修复后按顺序确认两件事再次运行npm run doctor退出码为0说明 Playwright chromium 这一项已通过。重新触发 PDF 生成——运行/career-ops pdf或在 Codex 等 CLI 中让 agent 执行pdf模式见 docs/SETUP.md 的 Available Commands 表批量场景下npm run pdf直接调用generate-pdf.mjs然后检查 PDF 文件是否真的存在而不是信任日志行。docs/WINDOWS.md 对此有明确提醒“不要相信日志行要断言文件存在。”generate-pdf.mjs本身在成功时会报告页数和文件大小见 docs/SCRIPTS.md但文件实际落盘才是判断依据。顺带区分扫描时弹出的 Chromium 是另一回事如果你注意到有时扫描会弹出 Chrome、有时不会那是另一个功能不要和 PDF 缺失混为一谈正常扫描直接读各 ATS 的公开 API不需要浏览器只有带--verify的运行才会启动 Chromium 做真实页面加载以确认职位确实还在线见 docs/FAQ.md 的 “Why does Chrome open during some scans but not others?”。--verify失败时给出的错误提示同样是执行npx playwright install chromium——也就是说一次安装同时覆盖 PDF 渲染和--verify两条路径。限制说明Chromium 安装在机器级别换机器或新的容器/云环境需要重新执行安装命令。career-ops 的 PDF 渲染路径固定使用 headless ChromiumPlaywright 自带下载文档没有提供使用系统已装 Chrome 的替代配置。如果npm run doctor通过但 PDF 仍缺失文档没有进一步的排错分支需要结合generate-pdf.mjs的错误输出单独定位本文不展开猜测。【免费下载链接】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),仅供参考