前言¶
在 DeepSeek Harness（DSH）里做简历，常见做法是让 Agent 直接写 Markdown 或调外部模板，再手工导出 Word / PDF。版式、页数和「PDF 三页、Word 四页」往往要对不齐，也很难用同一套规则做写作检查。
dsh-resume-studio（loeiy/dsh-resume-studio）把简历收成结构化 JSON，由插件统一渲染 HTML、DOCX、PDF，并提供三套版式、按目标页数自动压页，以及可复用的写作体检规则。下面介绍它是什么、如何安装，以及典型用法与限制。
这是什么¶
维护者 loeiy，分类为 客户端 插件，许可证 MIT。定位一句话：一份 JSON → HTML / Word / PDF，三套版式，自动压页，写作体检。
与「各格式各排一版」不同，README 强调 Word 与 PDF 同源：Word 是母版，PDF 由它转出，分页一致。社区目录页：https://www.skillhub.cn/plugins/loeiy/dsh-resume-studio；源码与文档：https://github.com/loeiy/dsh-resume-studio。
核心功能¶
渲染与版式¶
- 输出格式：HTML、DOCX、PDF（命名默认为
<姓名>-简历.html/.docx/.pdf）。 - 三套版式 id：
classic（经典蓝线）、minimal（极简黑白）、sidebar（侧栏信息带）；可用工具resume_templates列出详情。 - JSON 里
meta.template选版式，meta.maxPages约束页数。
自动压页¶
maxPages 是硬约束，不是建议。流程为：渲染 DOCX → 转 PDF → 回读页数 → 超页则行距减 1.5% 后重试，最多 7 轮。
写作与访谈¶
内置访谈流程与加粗规则；Agent 调用 resume_guide 即可按文档约定提问与排版。正文里 **双星号** 表示加粗，HTML 与 Word 共用同一套标记。
体检（resume_check）¶
| 规则 | 级别 | 说明 |
|---|---|---|
contact |
error | 缺电话 / 邮箱 |
pages |
error | 超过 maxPages |
numbers |
warn | 单条无数字；全篇数字覆盖率 < 60% |
density |
warn | 单条超过 110 字 |
bold |
warn | 加粗字符占比 > 30% |
structure |
warn | 模块数 < 3 或 > 6 |
verbs |
info | 以「负责 / 参与 / 协助」开头 |
date |
info | 时间格式不统一 |
五个工具¶
装好后对话里多出五个工具；也可在说明里直接自然语言描述需求，由 Agent 选用。
| 工具 | 作用 | 必填 |
|---|---|---|
resume_guide |
返回访谈流程、写作与加粗规则；topic 可取单节 |
— |
resume_init |
生成 JSON 骨架 | outPath |
resume_render |
出 HTML / DOCX / PDF，自动压页 | dataPath |
resume_check |
体检 | dataPath |
resume_templates |
列出三套版式 | — |
安装与启用¶
要求：DSH ≥ 0.2，Node.js ≥ 20（package.json 中 engines 与 README 一致）。
方式 A：GitHub（推荐）¶
图形界面：左侧 插件 → 右上 添加插件 → 粘贴仓库地址 → 安装：
https://github.com/loeiy/dsh-resume-studio
命令行：
dsh plugin add github:loeiy/dsh-resume-studio
固定版本示例（README 中的写法）：
dsh plugin add github:loeiy/dsh-resume-studio#v0.2.0
方式 B：本地目录¶
改代码即生效时，指向本地路径，例如：
dsh plugin add file:E:\dsh-resume
装完要重启¶
插件在启动时组合，安装后请 完全退出 DSH 再打开。在插件页应能看到 dsh-resume-studio。
插件以当前 DSH 进程权限运行；安装前建议阅读仓库源码与 MIT 许可证，确认符合你的环境策略。
典型用法¶
装好后不必死记工具名，用自然语言即可。README 中的对应关系如下：
| 你说 | Agent 会做 |
|---|---|
| 帮我写份简历，投技术项目经理 | 调 resume_guide 读流程 → 分三轮问你 → 建 JSON → 出三件套 |
| 这是我的旧简历，帮我改成投交付负责人 | 读旧内容、重排模块、按新岗位调整措辞 |
| 这是 JD：（全文）。按它改，保持 2 页 | 分析 JD、改侧重点、用 maxPages 压到 2 页 |
| 用 sidebar 版式重出一版，只要 PDF | 换版式、换输出格式 |
控制产出常用三句话：
- 页数：
最多 2 页/压到 1 页 - 版式：
classic/minimal/sidebar，可一次要三套对比 - 格式：
PDF 和 Word 都要/只要 PDF
产物默认落在指定输出目录。
数据格式概要¶
resume_init 可生成可填骨架。结构示例（节选）：
{
"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": ["**分类：**掌握的技术与工具"] }
]
}
kind 三种：timeline（带时间）、project（带项目介绍）、list（纯列表）。
环境与限制¶
- 生成 PDF 需要 DSH 自带的 LibreOffice Kit；找不到时只出 HTML + Word（
formats="html,docx"），或设置环境变量DSH_LO_CLI/DSH_LO_NODE。 - Word 与 LibreOffice 分页可能有 ±1–3% 差异：以「不超过 N 页」为目标，不承诺精确到行。
- 字体不嵌入：对方机器缺微软雅黑时，建议直接发 PDF。
- HTML 为连续长页预览，正式 PDF 以 DOCX 转出的为准。
结尾¶
dsh-resume-studio 把简历从「多格式各排一版」收成 JSON 驱动的一条流水线：同源 Word / PDF、可声明页数、三套版式与可检查的写作规则，适合在 DSH 里用 Agent 完成从访谈到交付的全流程。
- 社区目录：https://www.skillhub.cn/plugins/loeiy/dsh-resume-studio
- GitHub：https://github.com/loeiy/dsh-resume-studio
DSH 生态强调「一切皆插件」；SkillHub 等目录为社区站点，与 DeepSeek / 幻方无官方从属关系。选用插件时请自行核对版本、依赖与运行权限。
