dsh-bossintroduce
npm 包名与仓库名都是 dsh-bossintroduce，在 dsh 的插件页输入包名即可安装。
同一个仓库也是一份 skill：根目录有 SKILL.md，scripts/ 是零第三方依赖的引擎，
拷进 ~/.workbuddy/skills/ 就能用，两种形态共用同一套代码。
在 Boss 直聘（求职者侧）替你在一个可见的浏览器里翻岗位，为每一条 JD 写一段
只属于它的自我介绍，发给那位 HR。
批量投递时，给每个岗位写一段"看起来是为它写的"开场话术很费神；但同一段话投所有岗位，
HR 一眼看穿，反而扣分。这件事的全部价值在差异化 —— 同一个人，针对不同岗位点不同的名、
上不同的事实。所以这个插件做的不是"群发"，而是把你的能力图谱和JD 的具体要求
接起来，逐条产出不同的开场话术。
它怎么工作
三段式，各管一段，边界不重叠：
| 段 | 谁做 | 内容 |
|---|
| 判断 | 模型 | 读 JD，决定投不投；决定拿哪条事实当主攻；写文案 |
| 动作 | scripts/flow.mjs | 查状态、点意向、读描述、翻卡片、点立即沟通、填入、发送 |
| 闸门 | scripts/guard.py | 文案在发出去之前必须过八项检查，退出码 0 才放行 |
状态判定与动作顺序写死在执行器里，运行时只查表 + 检查，不做推理 —— 模型每次重新
推导一遍"现在该点哪个按钮"，是这类自动化最不稳的地方。
HOME ──职位──> JOBS ──意向筛选──> 逐张读 JD ──匹配──> 立即沟通 ──> CHAT ──填入并发送──> 回 JOBS
↑ │
└──────────────────── back（自动切回意向）──────────────────────┘
三条约束是实测撞出来的，写进引擎而不是写进文档提醒：
- 岗位只从意向筛选列表里取。 实测：意向列表在点过「立即沟通」后会自行刷新
（已沟通的岗位移出、其余重排），而在默认推荐流里点完沟通，卡片和顺序纹丝不动 ——
所以推荐流看起来"更稳"，但它永远给你同一批岗位。
- 一张一张看，不允许批量取列表。 因为列表会重排，任何提前批量抓下来的清单
（索引 / 标题 / 顺序）下一轮必然错位。
back 会落回默认推荐流，意向筛选丢失。所以回列表这一步必须带意向标签重选，
由执行器一步做完，不指望临场记得。
能力图谱：事实的唯一来源
自我介绍只能引用能力图谱里的条目，不得新增事实。图谱是一份 JSON，每人一份，抽自简历 /
公开仓库 / 自述，每条事实带 jd_hits（这条事实能回应哪些 JD 词）、on_resume
（在不在简历上）、visibility、blacklist（不能怎么写）。
blacklist 是最容易被漏、也最影响可信度的一项 —— 例："写「从零实现」，不写「自研引擎」"、
"不得写「完全独立完成」"、"不许搬业绩数字"。护栏会逐条检查，所以它不靠自觉。
文案护栏：不可撤回动作的最后一道闸
发出去的话收不回来，所以 boss_say 之前必须过 boss_guard。八项检查：
| 检查 | 口径 |
|---|
| 长度闸门 | 可见字符数落在预算区间（区间来自图谱 writing_rules.budget；不写则用引擎默认 120–200 字） |
| 禁用数字 | 白名单硬失败：只放行「有出处」的数字（日期、年份、版本号、指令集、院校背书） |
| 事实来源 | 文里至少有一个能在图谱里找到对应条目的实体 |
| 点名词 | 指定的 JD 原词确实出现在文里 |
| 主攻事实 | 声明的主攻事确实落在文里（私有仓库直接拒） |
| 未上简历项 | 引用了不在简历上的项目时，必须带上它自己的链接 |
| 黑名单 | 条目级 + 全局黑名单均未被触犯 |
| 可验证入口 | 文案里带公开主页（最强可验证信号） |
「默认零数字」值得单独说：提速倍数、测试条数、吞吐量、百分比这类业绩数字一律不写。
它们对 HR 的边际价值接近零，而且一眼就能看出是从一份通用材料里搬来的。
安装
方式一：从 npm 装（推荐）
dsh 桌面应用 → 插件页 → 添加插件 → 填 dsh-bossintroduce → 重启。
管理器做的事：pnpm add dsh-bossintroduce → 把它加进 profile 的 dsh.profile.bundles →
包自带的 cordis.patch.yml 作为 bundle 层自动生效，用户不用手写任何配置。
这个形态下插件不需要自带 node_modules —— @deepseek-ai/* 那类 peer 由宿主自己解析。
方式二：绝对路径挂载（本地开发，改代码即生效）
git clone https://github.com/RaganaBloodedge/dsh-bossintroduce.git
cd dsh-bossintroduce
npm install # 顺带跑 prepare（即 tsc），产出 dist/
cp cordis.example.yml cordis.local.yml # 把里面的 <本仓库的绝对路径> 换成真实路径
dsh --profile web --patch "<cordis.local.yml 的绝对路径>" --dump-config # 只组合配置
dsh --profile web --patch "<cordis.local.yml 的绝对路径>" # 真启动
用绝对路径挂载时入口文件在 node_modules 之外，Node 找不到 @deepseek-ai/*，
所以必须先 npm install。
方式三：当 skill 用（WorkBuddy / 其它读 SKILL.md 的宿主）
把仓库整个拷到 ~/.workbuddy/skills/dsh-bossintroduce/，然后照根目录的 SKILL.md 走。
这条路径不用 Node 依赖，只用 scripts/ 里的引擎。
前置要求
| 需要 | 说明 |
|---|
| Edge 或 Chrome | 插件会起一个可见的浏览器并开 CDP 调试端口；用 browserPath 指定绝对路径，留空自动发现 |
| Python 3 | 只有文案护栏需要；用 pythonPath 指定，留空自动发现 |
| Node ≥ 22.6 | 本地挂载/开发时需要；桌面应用内由宿主提供（Electron 下插件自动带 ELECTRON_RUN_AS_NODE=1，不需要另装） |
首次使用：初始化
node scripts/init.mjs # 建数据目录 + 落「空图谱 + 投递配置」模板
node scripts/init.mjs --migrate # 旧版把数据放在仓库目录里 → 迁到用户目录
node scripts/flow.mjs where # 看引擎/数据/图谱/profile 到底解析到哪
然后建能力图谱（这一步必须由模型驱动，见 references/01-能力图谱.md 的八步）：
从简历 PDF / 公开仓库 / 自述里抽身份、教育、荣誉、经历、项目，逐条打 jd_hits、分档、
标 on_resume/visibility、写黑名单。做完把关键条目念给用户逐项确认 ——
图谱里每条事实都会变成发给 HR 的一句话。
投递配置写在数据目录的 profile.md 里：城市、意向标签、薪资左边界、学历门槛、
毕业时间窗口、循环次数 N。
工具
| 工具 | 作用 |
|---|
boss_where | 报告引擎/数据/图谱/profile/浏览器 profile 的解析结果（不连浏览器） |
boss_init | 落初始化脚手架（可带 migrate 迁旧数据） |
boss_browser | status 探 CDP 端口 / launch 起可见浏览器并等端口应答 |
boss_state | 当前状态 + 登录判定（每次开工第一件事） |
boss_wait_login | 停在登录页等用户登录完（仅在 boss_state 判出 LOGIN 后调用） |
boss_enter | HOME → 岗位页 |
boss_pick | 切到某个意向的岗位列表（label / index / list） |
boss_read | 读右侧职位描述 |
boss_next_card | 选下一张卡片（事件派发，不跳页） |
boss_contact | 点「立即沟通」→ 聊天页 |
boss_say | 填入并发送（不可撤回）；不给 text 则发送框里已有的内容 |
boss_back | 回岗位列表并自动切回意向（一定要带 label） |
boss_recover | 失败态出口：回 HOME |
boss_guard | 文案护栏，退出码 0 才允许发送 |
插件还会往系统提示词里加一节，说明开工顺序与红线 —— 否则模型只看到十四个孤立的工具名，
会把它当浏览器遥控器乱点。
一轮循环
boss_state → [LOGIN？让用户登录 + boss_wait_login]
boss_enter → boss_pick --label "<意向标签>" → boss_read → 硬过滤 + 匹配判断
├ 不匹配 → boss_next_card → boss_read → …
└ 匹配 → 取 JD 头号要求 → 从图谱挑一条最相关的事实当主攻
→ 按图谱口径写文案（语气 + 长度，见 `references/02`）→ boss_guard（退出码 0）
→ boss_contact → boss_say → boss_back --label → 下一条
凑满 N 份即停，报清单：岗位 / HR / 公司 / 薪资 / 主攻事实 / 文案首句。
已知坑
都是实测踩出来的。违反了不报错，只是行为不对：
| 症状 | 原因 | 处置 |
|---|
| 明明发成功却报「最后一条消息不是刚发的文案」 | 早期把我方消息的类名猜成了 item-mine，实际是 item-myself | 已修；气泡文本可能带「已读」尾巴，所以用前缀包含比对 |
| 刚填入就点发送，报「按钮是禁用态」 | 编辑器状态是异步同步的，填入后按钮会短暂 disabled | 已修：等它变可点（≤6s）再点 |
| 按坐标点发送点空，且没有任何报错 | 页面比窗口宽，按钮落在视口右边外面 | 已修：先 scrollIntoView 再量，不在视口内就明确报错 |
| 中文输入框里塞进去的内容被插件改写 | 用了 CDP 的 Input.insertText 之外的路径 | 引擎走 innerText 直写并读回比对，不一致就报错 |
boss_state 在登录页误判成已登录 | 早期判据是"找不到登录入口"，而登录页上就有登录入口 | 已修：抽成纯函数 decideLogin，真值表回归 |
| 从 HOME 点「消息」进岗位页 | 消息页没有选中 HR，右侧没有输入框 ⇒ CHAT_FAIL | 别点消息，用 boss_enter；进了失败态一律 boss_recover，不手动补救 |
| 点卡片结果跳到了职位详情页 | 卡片 hover 会浮出「立即沟通」浮层，鼠标命中浮层 | 选卡片用事件派发，不用鼠标点 |
| 窗口最小化后什么都点不到 | 坐标点击依赖元素尺寸，最小化时尺寸为 0 | 保持窗口可见 |
taskkill 之后用户得重新登录 | 那会连用户已登录的浏览器一起杀掉 | 绝不 taskkill 清场；要停就停启动它的那个任务 |
数据在哪
引擎与个人数据是分开的，所以升级/分享/发布插件都不会碰到你的数据：
| 位置 | 内容 |
|---|
| 引擎 | 包目录（SKILL.md / scripts / references / assets / dist） | 流程、执行器、护栏、模板 |
| 个人数据 | $AI_HOME/data（默认 ~/.auto-introduce/data） | capability-graph.json、profile.md、resume-raw.txt、drafts/ |
| 浏览器登录态 | $AI_HOME/edge-profile | 已登录的浏览器 profile |
解析顺序（Node 与 Python 同一套口径，见 scripts/paths.mjs）：
AI_DATA_DIR → $AI_HOME/data → <包目录>/data（旧版遗留，仅在确实存在时才用并提示迁移）。
随包发布的只有引擎。scripts/pack.mjs 打可分发副本时会再扫一遍有没有夹带个人数据
（图谱、profile、简历、浏览器缓存），有就报错退出。
自检
npm run selftest # 引擎 + 图谱结构一起过（离线，不需要浏览器）
node scripts/flow.mjs where
自检在没有个人图谱的全新环境下也能全绿（图谱相关断言正确跳过），
所以它是"这个包收到了就能用"的最低保证。
发版（维护者）
npm version patch --no-git-tag-version # 或 minor / major
git commit -am "chore(release): x.y.z"
npm publish --registry=https://registry.npmjs.org/
三件容易踩的事：
- 本机默认 registry 往往是镜像（
registry.npmmirror.com），它只读、不能发布 —— 必须显式带
--registry=https://registry.npmjs.org/。
- 新包的第一个版本不会直接上线。 npm 2026 年起启用了暂存发布（staged publishing）：首次
publish 只是把版本提交到暂存区，registry 上会出现一个 0.0.0-stage 占位版，真实版本要到
npmjs.com 的 Staged Packages 里点 Approve 才上线（这一步需要 2FA）。同包的后续版本直接
上线、不再进暂存。
- 发布凭证。 npm 现在强制「账号开着 2FA」或「一个勾了 Bypass 2FA 的 granular access token」
才能发布 —— 关掉 2FA 反而会拿到
403 Two-factor authentication or granular access token with bypass 2fa enabled is required。
需要非交互发布时，建一个 bypass-2FA 的 granular token（Packages and scopes 给 Read and write），
临时写进项目内 .npmrc（已在 .gitignore 里），发完即删。
License
MIT © 2026 Li Yichen (李依宸)
