薪资核对审计 PerryLink/dsh-payroll-audit

dsh-payroll-audit — 薪资审计

English · 简体中文 · Español · Português · हिन्दी

dshfind

dsh-payroll-audit 拿薪资表对照已发布的社会保险、住房公积金和个人所得税参数逐项核对，每处差异都给出对应条款和涉及金额。

结果刻意分成四种：pass、pass_with_gaps、review、fail。某条规则的参数没取到，这条规则就停用并列出，所以「没发现问题」绝不会写成「合规」。参数文档自带 next_review_by 日期；参数过期的规则降级为 review，不会拿去年的数字蒙混过关。

安装

dsh plugin --profile <name> add dsh-payroll-audit
dsh --profile <name> --dump-config | grep 'dsh-payroll-audit'

长什么样

dsh-payroll-audit 的工作流图：文档 → 规则包 → 发现项。

工作流概览：文档 → 规则包 → 发现项。

边界： 这里只做算术核对和字段一致性检查，不做申报，不出审计意见，也不判定劳动关系。它不提交任何东西，不替代社保经办机构自己的核定，也不告诉你某个人该不该参保。由此有两点后果，报告里都看得见：跑不了的规则会照实列出；措辞里从不出现「合规」，只说「未发现差异」（在已检查的项目中未发现差异）。

能回答什么

- 申报的缴费基数是否落在该城市当期的下限和上限之间？
- 缴费金额是否等于基数乘以已发布的费率？
- 实发工资是否等于应发工资减去各项扣款？
- 哪些规则因为参数没取到而跑不了？

遵循的标准

每条规则都引用一份文档。规则包自带引用，每条引用都带来源、定位信息和原文摘录，方便读者自己去查：

- 北京社保基数上下限：北京市人社局 2026 年度缴费工资基数上下限通告（7,270 / 36,348）。
- 北京住房公积金：5%–12%，基数 2,540–36,348。
- 上海：基数上下限，住房公积金 5%–7%——不是国家规定里的 5%–12%，所以费率区间从参数文件读取，不写死在代码里。
- 个人所得税：按国家税务总局公告 2018 年第 61 号累计预扣。

没取到的参数标为 pending，写明原因和解锁条件；对应规则列在 disabled_rules 下，永不参与计算。

兼容性

| 层面 | 状态 |
| Harness | peer 范围 >=0.1.2-rc.1 <0.2.0 \|\| >=0.2.0-0 <0.3.0 |
| Node | ^22.19.0 || >=24.0.0 |
| 平台 | 全部（纯 ESM；无原生代码、无网络、不调用模型） |

功能说明

对每一行，引擎先计算规则包里的派生列（受限算术，不用 eval），再逐条检验规则的触发条件。命中的规则会给出自己的 reason_code、严重程度、影响和引用依据。规则按前面说的四态结论分组。

参数用点号键寻址（si.base.floor、hf.fund.employee_max、iit.extra.child_edu_monthly），从官方参数文档解析。声明为缺失的值解析为空，而不是 0。

配置

| 键 | 默认值 | 含义 |
| rulesFile | rules/payroll-audit.yaml | 规则库路径 |

材料格式

工资表是一张表，每行对应一个人。规则包读取的字段包括：

| 字段 | 含义 |
| period | 2026-07；用来选定参数有效期窗口 |
| base_declared | 申报的缴费基数 |
| gross_pay、net_pay | 应发工资与实发工资 |
| employer_pension、employee_pension | 实际缴纳的养老保险 |
| ee_unemployment、ee_medical、ee_hf | 员工侧缴费 |
| hf_base、hf_employer_rate、hf_employee_rate | 住房公积金输入 |
| insurance_set | 已参保的险种，逗号分隔 |

文件经 dsh-table-ingest 读取，所以 .xlsx、.xlsm 和 .csv 都能用。

规则来源

没有证据目录：引文就放在规则包里，紧挨着使用它的规则；check:citations 会逐条核对，确认每条引文都原样出现在规则包的引文表中。

已知限制：随包发布的两个规则包覆盖北京和上海，从 2026-07 起生效；更早的期间没有参数，所有规则都会退化为 gaps。医疗、生育、工伤档次和最低工资检查已停用，因为费率没有从一手来源取得——每一项都列出了解除停用所需的条件。引擎不申报任何东西，也不计算更正后的工资表。

故障排查

- 插件装上了，但工具始终不出现：检查 main 是否指向 lib/index.mjs，以及 pnpm run build 是否生成了它。
- dsh plugin add 拒绝该包：peer 范围覆盖 0.1.x 和 0.2.x；超出范围时，显式授予豁免。
- 某条规则没有运行：查看 skipped 数组。

开发

pnpm install
pnpm run typecheck
pnpm test
pnpm run build
node ../scripts/sync-shared.mjs dsh-payroll-audit

PerryLink DSH 插件家族

本项目属于 PerryLink 的 DeepSeek Harness 插件家族。下面这份名单默认折叠，好让每个 README 的首屏都保持简短；展开即可看到每一行及其状态。

展开全部插件

| 插件 | 状态 |
| dsh-aqua-input-check | |
| dsh-archive-check | |
| dsh-auto-review | |
| dsh-autotier | |
| dsh-bid-ca-precheck | |
| dsh-bid-qual-check | |
| dsh-cert-mcp | |
| dsh-checkpoint-rewind | |
| dsh-click | |
| dsh-composer-history | |
| dsh-contract-stance | |
| dsh-customs-doc-check | |
| dsh-data-quality | |
| dsh-demurrage-ledger | |
| dsh-doublecheck | |
| dsh-drill-script-check | |
| dsh-eia-guide-check | |
| dsh-emergency-plan | |
| dsh-essay-rubric-check | |
| dsh-evidence-check | |
| dsh-export-ctl-check | |
| dsh-fast | |
| dsh-fmea-table-check | |
| dsh-forecast-penalty | |
| dsh-fund-research | |
| dsh-github | |
| dsh-gongwen-flow-check | |
| dsh-gongwen-word-check | |
| dsh-guard-plan-qc | |
| dsh-hazchem-check | |
| dsh-hazplan-check | |
| dsh-hidden-risk-map | |
| dsh-hs-classify | |
| dsh-icd-rule-check | |
| dsh-industry-research | |
| dsh-lawcite-adapter | |
| dsh-laya | |
| dsh-lc-doc-check | |
| dsh-learning-gap-check | |
| dsh-library | |
| dsh-local-ai | |
| dsh-lsp-actions | |
| dsh-mask | |
| dsh-mcp-panel | |
| dsh-medrec-qc | |
| dsh-memento | |
| dsh-nsfc-form-check | |
| dsh-nurse-record-check | |
| dsh-observe | |
| dsh-origin-rvc-check | |
| dsh-ota-review-check | |
| dsh-output-styles | |
| dsh-paper-doc-adapter | |
| dsh-permission-rules | |
| dsh-permit-report-check | |
| dsh-pipeline-check | |
| dsh-pleading-draft | |
| dsh-plugin-doctor | |
| dsh-plugin-guide | |
| dsh-plugin-kit | |
| dsh-plugin-upgrade | |
| dsh-policy-brief-draft | |
| dsh-power-loss-split | |
| dsh-power-ticket-check | |
| dsh-ppap-check | |
| dsh-protest-deadline | |
| dsh-railway-window | |
| dsh-repair-order-qc | |
| dsh-research-report | |
| dsh-review-reply-check | |
| dsh-rulefile-check | |
| dsh-safety-brief-check | |
| dsh-score | |
| dsh-session-sync | |
| dsh-site-log-check | |
| dsh-skill-pack-security | |
| dsh-soe-decision-check | |
| dsh-soilwater-check | |
| dsh-sop-sync-check | |
| dsh-spc-gbt-adapter | |
| dsh-talk | |
| dsh-tender-extract | |
| dsh-tender-matrix | |
| dsh-test-drive | |
| dsh-ticktick | |
| dsh-translate | |
| dsh-warranty-calc | |
| dsh-budget | 🧊 已冻结 —— 见仓库 README |
| dsh-claude-move | 🧊 已冻结 —— 见仓库 README |
| dsh-defend | 🧊 已冻结 —— 见仓库 README |
| dsh-draw | 🧊 已冻结 —— 见仓库 README |
| dsh-reach | 🧊 已冻结 —— 见仓库 README |
| dsh-background-agents | 🚫 已退役 —— 见仓库 README |
| dsh-session-pin | 🚫 已退役 —— 见仓库 README |
| dsh-team-rooms | 🚫 已退役 —— 见仓库 README |

许可证

Apache License 2.0 © 2026 dsh-payroll-audit contributors。