猎头服务费与保证期退款核对（免费版）

猎头服务费账单与保证期明细表逐项核对，服务费=年薪×服务费率逐行复算、保证期内离职按未满天数折算退款、账单合计勾稽、同一候选人重复计费、费率超合同上限、关键字段缺失与负数。每条结论都带原文行号与候选人，材料不足时不给结论。触发词包括 猎头服务费核对、猎头费账单对不上、保证期退款核对。

完全本地运行：引擎已经打包在本技能里（engine/ 目录）。 核对过程不需要联网、不需要 API Key、没有调用次数上限。

什么时候用

谁会在什么时候用：HR / 财务在收到猎头服务费账单、准备请款或月末对账时， 必须把这张表核一遍才能往下走。

具体场景：猎头供应商发来一张账单（一行一个候选人），合同里写着「候选人年薪 × 服务费率」， 以及「候选人在保证期（常见 90 天）内离职，按未满天数比例退还服务费」。 付款之前你要确认：账单里的服务费是不是按约定费率算的、该退的退款有没有退、合计行与明细对不对得上。

这张表会逐项核对什么：猎头服务费账单与保证期明细表的逐行算术、保证期退款口径、合计勾稽、重复与空缺。

这个免费版查什么

1. 服务费复算：候选人年薪 × 服务费率 = 服务费，逐行复算（年薪与服务费率一律以你填的为准，不套默认值）。
2. 保证期退款复算：保证期内离职 ⇒ 应退比例 = (保证期天数 − 已服务天数) ÷ 保证期天数、应退金额 = 服务费 × 应退比例；非保证期内离职 ⇒ 应退比例与应退金额都应为 0。
3. 账单合计勾稽：合计行的服务费 / 应退金额 / 实退金额 = 各明细行逐列相加（公差 1 分）。
4. 同一候选人重复计费检测：同一供应商 + 同一候选人 + 同一月份出现多行。
5. 服务费率超合同上限检测：服务费率 > 合同费率上限。
6. 关键字段缺失 / 占位符 / 负数检测：空白、「待填」这类占位符、负金额。

每条结论都带原文行号与候选人，可由第三方用同一份输入复算； 材料不足时不给结论，会明确列出还缺什么（缺列、只有表头、空正文都会如实说明）。

怎么用

bash

node scripts/run.mjs --sample                      # 先看内置样例（含表头，可直接照抄列名）
node scripts/run.mjs --input 你的材料.json          # 跑自己的账单单据
node scripts/run.mjs --input 你的材料.json --json   # 机器可读输出

材料写法：{"text": "（把 Excel 里那张表**含表头**整段复制成文本，Tab 分隔最稳）"}。

需要这些列（列名可用等价别名）：所属月份 / 猎头供应商 / 候选人 / 职位 / 入职日期 / 年薪 / 服务费率 / 服务费 / 合同费率上限 / 保证期天数 / 保证期内离职 / 已服务天数 / 应退比例 / 应退金额 / 实退金额。

出参

• status：success 表示真的执行了检查；insufficient_input 表示材料不足 —— 此时不给结论，也不会输出「未发现问题」。
• result.findings[]：每条含 line（原文行号）、level（P0 必须改 / P1 需确认 / P2 提示）、category、message、who（月份 + 供应商 + 候选人）。
• result.scope：本次执行的检查项、明细行数、月份数与供应商数、服务费 / 应退 / 实退合计、withheld（本版本未执行的检查项）、totals_row（是否认出了合计行）。
• result.summary.verdict：ERROR_FOUND（有 P0）/ NEEDS_REVIEW（只有提示）/ NO_ISSUE_FOUND。

常见错法（本产品专属）

1. 服务费不是按「年薪 × 服务费率」算的 —— 拿月薪直接乘费率，或者用年度总包（含奖金、股权）当分母 却仍按基础年薪谈定的费率。服务费率一律按百分数填：20% 与 20 都表示 20%，写成 0.2 会被当成 0.2%。
2. 保证期内离职退错比例 —— 拿 365 天当分母（按年度口径折），或者按整月数硬砍（入职 45 天离职按 2 个月算）。 约定口径是保证期天数做分母的自然日折算，不是 365 天、也不是整月。
3. 已服务天数填成「在职月数」或从入职到本月的天数 —— 保证期退款的分子分母都用自然日； 填成整月会让退款比例整列偏掉，而且不会报错，只会算少。
4. 同一候选人同一月份被建了两行 —— 一个岗位先按预估年薪开一次账单、offer 定稿后又按实际年薪补一行， 两行都在就等于重复计了一遍费。本工具按「供应商 + 候选人 + 月份」判重，不靠名字写法是否一致。
5. 合计行是手打或从上一版复制的 —— 明细改过合计没改；或者合计行只填了服务费， 应退 / 实退两列留空，等于这两列根本没参与对账。合计是请款与对账的取数口径，对不上就是三方都对不上。

需要完整档时（可选）

本免费版是完整可用的核心产出，本版本不包含下面这些项：

• 跨供应商跨月汇总台账（按供应商 × 月份汇总服务费 / 应退 / 实退 / 待退，用于月末合并对账）
• 按差异金额排序的处理清单（每条带原文行号、候选人与供应商，可直接当待办清单用）
• 实退与应退差额判定（应退未退 / 实退多于应退，逐行报出差额）
• 保证期天数档位判定（不在常见约定档位 30/45/60/90/120/180/365 内即提示）
• 退款口径矛盾与归因（保证期内离职却已服务满保证期天数、未按全额退款；并把差异归因到年薪口径 / 费率档位 / 保证期天数 / 退款比例）

同名工具的完整档是另一个独立商品（条款与条件以它自己的商品页为准）；两档的差别就是上面这些，没有别的。

边界（请务必知道）

本工具不做引擎 CHECKS_OUT_OF_SCOPE 里列的那些判断：年薪口径本身对不对（税前 / 税后、含不含奖金、 12 薪还是 13 薪）、合同里的费率档位与保证期长度是否合法、候选人是否真的在保证期内离职 （要拿离职证明与社保记录核）、个税社保税额、以及读取 Excel / HR 系统 / 供应商 PDF。

材料不足时不给结论，也不会输出「未发现问题」。