前言¶
简历更新到 BOSS 直聘上，通常是登录浏览器、打开在线简历、逐段填表的手工活。对智能体而言这件事有两个难点：一是文档解析，PDF、DOCX、HTML、Markdown 各自一套提取方式；二是浏览器操作，需要有人登录的浏览器上下文。已有通用浏览器控制插件（Playwright MCP、Chrome DevTools MCP、browser-use）解决的是通用控制，不是“同步简历”这条窄路径。
下面介绍的 520mxj/boss-zhipin-resume-sync 只做一件事：解析本地简历文档，生成结构化 JSON，再通过 Microsoft Edge 把变化同步到用户已登录的 BOSS 直聘在线简历。插件由 520mxj 维护，分类为联网工具，GitHub 星标 1。仓库是标准 npm/Cordis 包，同一套 Skill 核心同时提供 Codex、Claude Code 和 DSH 适配清单。
定位与解决的问题¶
插件不针对某一份固定简历硬编码字段，而是先把文档抽成可审查的结构化数据，再写入在线简历。它有几条明确边界：
- 默认保留已有项目经历，除非用户明确要求修改或删除。
- 不接管登录、不绕过验证码；遇到安全验证时等待用户手动完成。
- 不保存账号密码，同步结束后删除临时 Edge 用户目录。
- 通用浏览器控制能力不重复实现，仓库只保留 BOSS 简历同步所需的窄范围、域名受限 CDP 桥，去重依据见
docs/duplicate-check.md。
支持的输入¶
| 格式 | 支持方式 |
|---|---|
pdfjs-dist 提取文本；扫描件由 Agent 的视觉/OCR 能力补足 |
|
| DOCX | mammoth 提取正文 |
| HTML / HTM | 提取可读文本 |
| TXT / Markdown | 直接读取 |
| DOC | 不支持，请先另存为 DOCX 或 PDF |
识别不了的字段不臆造，缺失信息原样暴露给用户确认。
工作流¶
工作流是六个步骤，前三步在本地完成解析和校验，后三步处理浏览器：
extract读取上传文档。- Agent 根据 Resume schema（
skills/boss-zhipin-resume-sync/references/resume.schema.json）生成resume.json。 validate校验结构化简历。start复制必要的 Edge 登录数据到临时目录，并用仅监听127.0.0.1的 CDP 打开 BOSS 在线简历。- Agent 使用
read、fill、click、eval分区块保存，逐项复核。 stop关闭调试浏览器并删除临时登录副本。
执行 start 前需要退出所有普通 Edge 窗口。脚本不会自动关闭其他浏览器窗口，避免丢失用户数据。
安装与启用¶
先安装依赖：
npm install
DSH 侧的安装命令来自 README 原文，不需要 git clone：
dsh plugin add github:520mxj/boss-zhipin-resume-sync
仓库包含 cordis.patch.yml 和 lib/index.js，是标准 npm/Cordis 包。DSH 通过 ctx.skills.registerProvider() 注册同一份 Skill。作者在 package.json 中声明了 peerDependencies：@deepseek-ai/cordis ~4.0.4 与 @deepseek-ai/dsh-skill ^0.2.0-rc.2，engines 要求 Node >=20.16。另有 bin: boss-resume 指向 skills/boss-zhipin-resume-sync/scripts/boss-resume.mjs。
Codex 与 Claude Code 的安装方式不同：Codex 看根目录 .codex-plugin/plugin.json 和标准 skills/，Claude Code 看 .claude-plugin/plugin.json；两者也可以只把 skills/boss-zhipin-resume-sync 目录放进项目或个人 skills 目录。
典型用法¶
CLI 快速验证走这条链路，路径需要与插件安装位置一致：
node skills/boss-zhipin-resume-sync/scripts/boss-resume.mjs extract ./resume.pdf --out ./.boss-resume/source.json
node skills/boss-zhipin-resume-sync/scripts/boss-resume.mjs validate ./.boss-resume/resume.json
node skills/boss-zhipin-resume-sync/scripts/boss-resume.mjs start
node skills/boss-zhipin-resume-sync/scripts/boss-resume.mjs read --max-chars 20000
node skills/boss-zhipin-resume-sync/scripts/boss-resume.mjs stop
仓库自带开发验证脚本，可用它检查安装是否完整：
npm test
node skills/boss-zhipin-resume-sync/scripts/boss-resume.mjs --help
适用场景与注意¶
适合需要把自己手上的简历文档同步到 BOSS 直聘在线简历、又希望过程可审查的开发者。字段生成后先落地为 resume.json，再进入浏览器写入，便于逐项核对。
几个注意点：
- 插件以当前 DSH 进程权限运行，安装前应先阅读源码和许可证（仓库声明为 MIT），确认 peerDependencies 与本地版本匹配后再启用。
- 安全边界限定在
www.zhipin.com：CLI 的eval、fill、click只允许对该域名执行。 - 插件不处理密码、银行卡、验证码或身份验证弹窗；删除简历区块或联系方式前必须获得用户明确授权。
- 临时浏览器资料目录由脚本创建、使用并清理，不要把它提交到 Git。
- 本工具服务于用户自己的求职简历，不包含自动投递、批量爬取、招聘方操作或规避风控功能。
结尾¶
这个插件的价值在于把“解析文档 + 浏览器写简历”拆成一条窄路径，同时给出三套 Agent 适配清单。目录页在 https://www.skillhub.cn/plugins/520mxj/boss-zhipin-resume-sync ，源码在 https://github.com/520mxj/boss-zhipin-resume-sync 。使用前请自行核对源码、license 与依赖版本。
