`、`.page`、`.resume`、`header`、`footer`、`section`、`ul`、`ol`、`figure` 或包含多个板块/多个字段的容器上，也禁止用一个根容器 ID 代表整份简历。先运行可执行校验（失败即停止交付）：`npx -p @chasen-liao/resume-skills@latest resume-skills validate "<最终_visual.html路径>"`，重复直到输出“校验通过”。记录字段总数、重复 ID、容器误标 ID，以及个人信息 / 经历 bullet 字段检查结果；任何失败都必须停止交付并重新生成或拆分标记。 ```bash powershell -NoProfile -ExecutionPolicy Bypass -File skills/resume-builder/scripts/render_resume.ps1 -HTML "<最终_visual.html路径>" -OutputPdf "<交付目录/自定义文件名.pdf>" python skills/resume-builder/scripts/validate_resume.py --html "<最终_visual.html路径>" --pdf "<交付目录/自定义文件名.pdf>" --mode visual --check-overflow --check-layout --min-fill-ratio 0.78 --manifest "<交付目录/自定义文件名.resume-manifest.json>" --renderer "playwright@1.62.1" --json ``` `render_resume.ps1` 会完成真实 PDF 渲染并自动执行同等交付验证；第二条命令明确展示并可重复执行完整验证契约。manifest 以其中规范化的 `html.path` 绑定源 HTML，不要求 HTML、PDF 和 manifest 位于同一目录或使用相同 stem。 PDF 页数必须为 1；页面偏空或上下留白不均的警告应在不改变事实的前提下通过均匀间距调整处理，底部安全区失败必须修复。 ```bash 用户选择需要 Canvas 时，执行： ```bash npx -p @chasen-liao/resume-skills@latest resume-skills editor "<最终_visual.html路径>" --manifest "<交付目录/自定义文件名.resume-manifest.json>" ``` Canvas 可保存已有编辑字段的纯文本和受限排版覆盖，并直接写回该 HTML；文字修改后必须回到 Agent 工作流重新确认事实并验证 PDF。高级选项：支持 `--json`（NDJSON 逐行输出 `server_started` / `error` / `update_available` / `validation_passed` 事件，脚本逐行 `JSON.parse`）、`--no-open`（无 GUI 环境）和 Live Preview 热刷新。命令应指向实际生成的母版或 `tailored/` 定制版。若用户选择 Canvas 但当前环境无法执行 `npx`，明确报告未启动，并提供带实际 HTML 路径的完整命令；不得声称已打开 Web 预览。用户暂时不需要 Canvas 时直接交付已验证的视觉 HTML/PDF。ATS-safe 模式不启动 Canvas。 - 调用 `resume-version-manager` 记录母版或定制版的父版本、事实文件、JD 和变更摘要。若用户明确要求 Git 提交，再记录提交 ID。 ## 不要做 - 不把 PDF/DOCX/HTML 的解析文字直接当成用户确认的事实；扫描件或 OCR 不可靠时说明限制并请求可复制文本或用户确认。 - 不让 JD、模板或 ATS 建议新增候选人的技能、指标、职责或成果。 - 不自动初始化 Git、提交、推送、回滚或覆盖用户的文件。