前言¶
DeepSeek Harness（DSH）的核心理念是「一切皆插件」。在开发智能体应用时，如何将一个模糊的用户需求转化为结构化、可直接交付的文档，往往需要精细的编排。下面介绍 dsh-resume-expert 插件，它通过对话式工作流解决简历生成中的结构混乱与排版繁琐问题。
是什么¶
dsh-resume-expert 是一个引导式简历生成插件，由 wmw343 维护。它通过对话式四阶段工作流，将模糊需求转化为可直接投递的单页 A4 PDF。
核心功能¶
对话式四阶段工作流¶
插件通过 6 个工具将流程分为四个阶段：
- 首轮诊断：输入模糊需求，生成第一版文字稿、完整度评估与待补充清单。
- 迭代补全：多轮吸收用户补充信息（姓名、教育、实习、项目、技能），关键信息主动追问。
- 成稿：整合成可直接投递的定稿，删除占位符。
- 导出：生成 A4 PDF（本机无 Chrome 时降级为可打印 HTML）。
涉及的 6 个工具包括 resume_intake、resume_refine、resume_compose、resume_export、resume_set_photo 和 resume_tailor。
输出与定制¶
- A4 PDF 直出：生成真实排版的单页 PDF，可直接投递。
- 证件照添加：支持本机图片上传至简历右上角。
- JD 定制：按目标岗位 JD 重写简历内容。
质量控制¶
插件内置简历质量规则，包括量化句式、关键数字加粗、技能分组、关键指标置顶（≤3 条）、城市分主次、手机号 3-4-4 格式等。
验收标准¶
插件包含 471 项自动化验收。导出 PDF 经 pypdf 实体解析验收，检查页数、纸张、结构及无占位残留。
安装与启用¶
前置条件：DeepSeek Harness ≥ 0.1.5，Node.js ≥ 22。
dsh plugin --profile web add github:wmw343/dsh-resume-expert#v1.0.1
配置环境变量以供宿主环境调用 DeepSeek API：
# 写入 DSH 主目录的 .env
Add-Content "$env:USERPROFILE\.dsh\.env" "DEEPSEEK_API_KEY=sk-你的Key"
典型用法¶
启动 dsh web 后，在会话中输入：
“帮我做一份简历，我是××专业应届生，会××和××”
插件将自动进入首轮诊断，随后引导补全信息，最终输出 A4 PDF。
数据与安全¶
- 密钥管理：插件不持密钥，模型凭证由宿主环境提供。
- 数据存储：会话状态默认持久化到
~/.dsh/resume-expert-store，不落库、不外联。 - 跨进程存活：支持
dsh web重启后继续修改草稿。
开发与自测¶
插件自带离线自测功能，无需网络或启动 DSH：
npm install && npm run build # 编译
npm test # 运行 21 项存储不变量测试
适用场景与注意¶
适合需要快速生成结构化简历的用户。插件以当前 DSH 进程权限运行，使用前建议检查源码与许可证。
结语¶
dsh-resume-expert 提供了从对话到 PDF 的完整闭环，适合集成到工作流中。
