前言¶
簡歷更新到 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 與依賴版本。
