简历工坊 loeiy/dsh-resume-studio

dsh-resume-studio

DeepSeek Harness 的简历插件：一份 JSON → HTML / Word / PDF，三套版式，自动压页，写作体检。

- Word 与 PDF 同源：Word 是母版，PDF 由它转出，不会出现「PDF 三页、Word 四页」
- 说几页就几页：给它目标页数，它收紧行距、重排版、回读页数，直到不超页
- 不只排版，还会写：内置访谈流程与加粗规则，智能体调 resume_guide 就知道怎么问你

安装

要求：DSH ≥ 0.2，Node.js ≥ 20。

方式 A：GitHub（推荐）

图形界面：左侧 插件 → 右上 添加插件 → 粘贴仓库地址 → 安装

https://github.com/loeiy/dsh-resume-studio

命令行：

dsh plugin add github:loeiy/dsh-resume-studio

固定到某个版本：

dsh plugin add github:loeiy/dsh-resume-studio#v0.2.0

方式 B：本地目录（改代码即生效）

dsh plugin add file:E:\dsh-resume

装完要重启

插件在启动时组合，装完请完全退出 DSH 再打开。之后在插件页能看到 dsh-resume-studio，对话里多出五个工具。

怎么用

装完之后不用记工具名，直接说话：

| 你说 | 智能体会做 |
| 帮我写份简历，投技术项目经理 | 调 resume_guide 读流程 → 分三轮问你 → 建 JSON → 出三件套 |
| 这是我的旧简历，帮我改成投交付负责人 | 读旧内容、重排模块、按新岗位调整措辞 |
| 这是 JD：（全文）。按它改，保持 2 页 | 分析 JD、改侧重点、用 maxPages 压到 2 页 |
| 用 sidebar 版式重出一版，只要 PDF | 换版式、换输出格式 |

控制产出的三句话：

- 页数：最多 2 页 / 压到 1 页
- 版式：classic / minimal / sidebar，可一次要三套对比
- 格式：PDF 和 Word 都要 / 只要 PDF

产物默认落在你指定的输出目录，命名 <姓名>-简历.html/.docx/.pdf。

五个工具（给想直接调的人）

| 工具 | 作用 | 必填 |
| resume_guide | 返回访谈流程、写作与加粗规则；topic 可取单节 | — |
| resume_init | 生成 JSON 骨架 | outPath |
| resume_render | 出 HTML / DOCX / PDF，自动压页 | dataPath |
| resume_check | 体检：数字覆盖、加粗占比、条目长度、页数 | dataPath |
| resume_templates | 列出三套版式 | — |

三套版式

| id | 观感 | 适合 |
| classic 经典蓝线 | 深蓝分区线、单栏、信息两列 | 银行 / 国企 / 制造 / 项目经理 |
| minimal 极简黑白 | 无彩色、细线、三列信息、字距标题 | 外企 / 咨询 / 学术 / 海外投递 |
| sidebar 侧栏信息带 | 灰底信息带 + 左侧竖线 + 页码 | 互联网 / 产品 / 技术 |

数据格式

{
"meta": { "template": "classic", "maxPages": 2 },
"basics": {
"name": "你的姓名", "intent": "求职意向：目标岗位",
"fields": [["电话", "13800000000"], ["邮箱", "you@example.com"]]
},
"sections": [
{
"kind": "timeline",
"title": "工作经历",
"items": [{ "head": "公司名称", "sub": "职位", "date": "2022.04 - 至今",
"bullets": ["动词 关键名词，带一个可验证的结果数字。"] }]
},
{ "kind": "list", "title": "专业技能", "bullets": ["分类：掌握的技术与工具"] } ] }

- 双星号 = 加粗，HTML 与 Word 共用同一套标记
- kind 三种：timeline（带时间）、project（带项目介绍）、list（纯列表）
- 用 resume_init 可以直接生成一份可填的骨架

自动压页

maxPages 是约束，不是建议：

渲染 DOCX → 转 PDF → 回读页数 → 超页则行距 −1.5% → 重来（最多 7 轮）

体检规则

| 规则 | 级别 | 说明 |
| contact | error | 缺电话 / 邮箱 |
| pages | error | 超过 maxPages |
| numbers | warn | 单条无数字；全篇数字覆盖率 < 60% |
| density | warn | 单条超过 110 字 |
| bold | warn | 加粗字符占比 > 30% |
| structure | warn | 模块数 < 3 或 > 6 |
| verbs | info | 以「负责 / 参与 / 协助」开头 |
| date | info | 时间格式不统一 |

环境与限制

- 生成 PDF 需要 DSH 自带的 LibreOffice Kit，插件会自动查找；找不到时只出 HTML + Word（formats="html,docx"），或设置 DSH_LO_CLI / DSH_LO_NODE
- Word 与 LibreOffice 分页有 ±1–3% 差异：以「不超过 N 页」为目标，不承诺精确到行
- 字体不嵌入：对方机器缺微软雅黑时，建议直接发 PDF
- HTML 是连续长页预览，正式 PDF 以 DOCX 转出的那份为准

开发

npm install
npm test # 15 个用例
npm run release -- --bump patch # 测试 → 升版本 → 打包到 dist/

推 v* tag 会自动跑测试、打包并创建 Release（见 .github/workflows/release.yml）。

License

MIT

一个简历插件，用于 DeepSeek Harness：一份 JSON → HTML / DOCX / PDF，三种版式，自动适配页面，并做内容检查。DOCX 是母版；PDF 由它转换而来，所以两者分页完全一致。

dsh plugin add github:loeiy/dsh-resume-studio

工具：resume_guide、resume_init、resume_render、resume_check、resume_templates。