简历工坊：从口述经历到可投递简历

前言¶

写简历时，真正难的不是排版，而是如何在真实约束下把内容组织对。ATS 解析器读不懂花哨的图片和表格，一个字都不能删的真实经历又常常超出一页。resume-crafter（简历工坊）是一个面向应届毕业生与职场人的 DSH 插件，维护者是 lhmlhmlhm11，分类为工作流。它把「排版好看」和「能过机筛」这两件事从手工调参变成一条命令，涵盖从口述经历整理、简历生成、JD 匹配、ATS 体检到面试准备的全流程。

核心功能¶

1. 一键构建¶

使用 build_all.py 可以一次产出 HTML + PDF + DOCX 三种格式，并自动完成内容质检与 ATS 体检：

python scripts/build_all.py resume.json --out ./out --style elite --surface ink

2. 四维正交外观¶

版式（9 种）× 底板（5 种）× 配色（7 种）× 密度（5 种），共 35 种组合可任意搭配。命令行参数优先级为：命令行参数 > JSON 的 meta > 版式默认值。

常用外观组合示例：

# 大厂投递：单栏 + 白底 + 靛蓝，最稳
python scripts/build_all.py resume.json --out ./out \
  --style classic --surface white --palette indigo

# 作品集/设计岗：几何版式 + 深墨底板
python scripts/build_all.py resume.json --out ./out \
  --style geo --surface ink --palette plum

3. 内容质检¶

lint_resume.py 基于中文简历的真实写法检查：姓名与联系方式完整性、分区名是否用 ATS 标准词、bullet 是否缺量化结果（识别中文量词：份/页/张/个/条等）、弱化动词与篇幅是否超标、装饰性字符与 AI 腔表达。

4. ATS 体检¶

ats_check.py 解析成品 PDF，输出页数、文本层是否正常、可提取字符数、识别到的分区顺序、跨栏风险、单页建议。

5. JD 匹配与批量定制¶

jd_match.py 输出关键词覆盖率、已命中项、简历缺失项及按优先级的定制修改建议。tailor_batch.py 支持一份底稿 + 多个 JD，一次生成多套定制版，每套附匹配报告与汇总 JSON。

6. 求职信与面试准备¶

cover_letter.py 生成求职信与「投递前自查」清单，支持 --interview 参数生成面试准备清单（岗位业务相关问题、经历追问点、自我介绍）。

7. 单页适配¶

fit_one_page.py 自动试 6 档排版参数，命中第一个「单页且排版正常」的档位。

8. 一寸证件照¶

basic.photo 支持本地路径 / data URI / 远程 URL，自动转成 base64 内嵌，支持 1in / small1in / 2in / square / boss 五种规格与 rect / rounded / circle 三种形状。没有照片时输出轻量占位框，不生成示例图。

安装与启用¶

环境要求¶

Python 3.10+
一个 Chromium 内核浏览器（Windows 用 Edge，macOS 用 Chrome，Linux 用 Chromium）

安装步骤¶

# 1. 克隆或解压本项目
cd resume-crafter

# 2. 安装依赖（推荐用虚拟环境）
python -m venv .venv
source .venv/bin/activate          # Windows: .venv\Scripts\activate
pip install -r requirements.txt

# 3. 自检
python scripts/doctor.py

DSH 一键安装¶

本仓库同时是一个标准的 DSH 组合包，可直接用 dsh plugin 安装：

dsh plugin --profile web add github:lhmlhmlhm11/resume-crafter

安装后重启 dsh web，组合包会注册一个 FileSystemSkillProvider，把 resume-crafter 技能加入技能发现列表。

安装位置：
- ~/.workbuddy/skills/resume-crafter/（WorkBuddy 全局）
- <项目>/.workbuddy/skills/resume-crafter/（项目级）

典型用法¶

完整流程示例：

# ① 写好简历 JSON（结构见 README）
# ② 一键出三份文件 + 自动质检
python scripts/build_all.py resume.json --out ./out --style elite --surface ink

# ③ 对着目标岗位做匹配分析
python scripts/jd_match.py resume.json jd.txt --out ./jd报告.json

# ④ 生成求职信与面试准备
python scripts/cover_letter.py resume.json jd.txt --out ./求职信.md --interview

# ⑤ 投之前体检成品 PDF
python scripts/ats_check.py ./out/张三.pdf

适用场景与注意¶

适合需要批量生成简历、多岗位定制、ATS 合规性检查、面试准备的应届毕业生与职场人。

插件以当前 dsh 进程权限运行，安装前应检查源码与许可证（MIT）。

总结¶

resume-crafter 将简历制作从手工调参转向流程化操作，覆盖从内容组织到投递体检的全链路。通过命令行脚本可直接使用，也可在对话中交给 Agent，由其读取技能说明书、数据格式、设计体系与写作规范按流程执行。

目录页
 GitHub