工资条生成

> **本地运行，零网络、免 API Key、数据不出电脑。**
> 四项诚实承诺：① 算不出就说算不出，绝不编造数字；② 高危动作强制人工确认；③ 幂等断点，绝不重复副作用；④ 全程留痕可审计。

# 工资条拆分生成

工资条是要发给员工本人看的。它能同时把「这个人这个月挣了多少」和「公司还有多少人在同一批里」
暴露出去——一次群发，全办公室的工资都透明了。

本包的原则是：**默认脱敏**。个人金额一律掩码成 `****`，身份证只留前 4 后 2，
银行卡只留后 4 位。要明文必须显式加 `--no-mask`，而且脚本会大喊三声警告。

## 做什么

- 按「姓名」分组，**一个人一张工资条**
- 明细项从表头自动识别（所有数值列都是明细项：应发、各项补贴、社保、公积金、个税、实发……）
- 文本列（部门 / 工号 / 岗位）作为抬头信息，原样带出
- 同名多行 → **自动合并，并明确提示**合并了几行、来自哪些行
- 身份证 / 银行卡默认掩码

## 输入 / 输出

输入：1 个工资表（`.xlsx` / `.csv`），首行表头。`payroll-calc` 输出的 `pr_主表.csv` 可直接吃。

| 列 | 必需 | 别名 |
|---|---|---|
| 姓名 | 必需 | 姓名 / 员工姓名 / 员工 / 人员 / 职工姓名 |
| 实发工资 | 必需 | 实发工资 / 实发 / 实发金额 / 发放金额 / 实发合计 |
| 其他数值列 | 可选 | 自动识别为工资条明细项 |
| 身份证号 / 银行卡号 | 可选 | 默认脱敏，也可 `--no-mask` 一并关闭 |

输出（进 `_out/`，源文件一个字节都不动）：

| 文件 | 内容 |
|---|---|
| `sl_主表.csv` | 每人一行：姓名 + 抬头 + 明细项（脱敏后）+ 脱敏口径 + 工资条行数 + 备注 |
| `sl_工资条明细.csv` | 长表：姓名 / 序号 / 项目 / 金额 / 是否脱敏 / 备注 |
| `sl_异常表.csv` | 实发缺失、实发为负、明细项缺失（带风险等级） |
| `sl_校验表.csv` | 人数、脱敏口径、合并情况、人工复核声明 |
| `fin-log.jsonl` | 处理日志（追加） |

## 用法

```bash
PY="<python 3.8+ 路径>"   # 纯标准库，无需 pip install
"$PY" <skill目录>/scripts/slip.py 工资表.xlsx --execute
```

生成明文工资条（**谨慎**，会打印警告）：

```bash
"$PY" slip.py 工资表.xlsx --no-mask --execute
```

指定列名：

```bash
"$PY" slip.py 工资表.csv --name-col 员工姓名 --execute
```

**默认不写盘**——不加 `--execute` 只打印预览，确认无误再落盘。

## 真实输出

默认脱敏（5 人）：

```
方案：sl_工资表.xlsx（5 行 / 5 人；姓名列「姓名」，实发列「实发工资」）
      脱敏：默认开启，个人金额掩码为 ****

--- 工资条（前 10 张）---
  张伟        明细  8 项  默认脱敏（个人金额掩码为 ****）
  李娜        明细  8 项  默认脱敏（个人金额掩码为 ****）
  王强        明细  8 项  默认脱敏（个人金额掩码为 ****）
  赵敏        明细  8 项  默认脱敏（个人金额掩码为 ****）
  陈涛        明细  8 项  默认脱敏（个人金额掩码为 ****）

--- 异常表：本次未发现异常记录（0 条）---

已生成工资条明细：sl_工资条明细.csv（35 行）
```

`sl_工资条明细.csv` 前几行：

```csv
姓名,序号,项目,金额,是否脱敏,备注
张伟,1,基本工资,****,是,
张伟,2,绩效工资,****,是,
张伟,3,补贴,****,是,
张伟,4,应发工资,****,是,
张伟,5,社保个人,****,是,
张伟,6,公积金个人,****,是,
张伟,7,估算个税,****,是,
```

关闭脱敏（醒目警告）：

```
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! 已关闭脱敏，工资条含明文金额，请按 confidential 处理
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
方案：sl_工资表.xlsx（5 行 / 5 人；姓名列「姓名」，实发列「实发工资」）
      脱敏：已关闭脱敏，工资条含明文金额，请按 confidential 处理
...
张伟,研发部,15000.0,4000.0,500.0,19500.0,1800.0,1560.0,904.0,已关闭脱敏（明文）,1,
```

同名多行合并：

```
提示：检测到同名多行，已合并为一张工资条 —— 张伟
      合并规则：金额列逐项相加，抬头信息取第一行；合并了几行、哪些行，见「工资条行数」「备注」两列。
方案：sl_工资表_重人多.xlsx（3 行 / 2 人；姓名列「姓名」，实发列「实发工资」）
      脱敏：默认开启，个人金额掩码为 ****

--- 工资条（前 10 张）---
  张伟        明细  4 项  默认脱敏（个人金额掩码为 ****）
  李娜        明细  4 项  默认脱敏（个人金额掩码为 ****）
```

失败路径：

```
$ slip.py sl_工资表_坏.xlsx --execute
--- 异常表（3 条）---
  [李娜    ] 实发工资缺失或不是数字，工资条不可生成
  [王强    ] 实发工资为负（-400.00），发工资前请先查扣款
  [赵敏    ] 明细项「社保个人」缺失或不是数字，工资条上留空不填 0

$ slip.py sl_坏表_缺实发列.xlsx --execute
【算不出】「sl_坏表_缺实发列.xlsx」里找不到实发工资列
建议：工资条必须知道实发多少；可用别名：实发工资、实发、实发金额、应发实发、发放金额、实发合计
本包不会给一个看似合理的替代数字 —— 财税场景算错比不做更危险。
```

## 拒绝权（什么情况下不给数）

| 情况 | 处理 |
|---|---|
| 缺姓名列 / 缺实发工资列 | 拒绝（RC=2），列出别名 |
| 文件不存在 / 空表 / 只有表头 | 拒绝（RC=2） |
| 某人的实发工资缺失或不是数字 | 该人进异常表（高），不生成其工资条，不填 0 |
| 实发工资为负 | 该人进异常表（高），仍出条但备注提醒 |
| 明细项缺失 / 为负 | 该明细在条上留「—」并进异常表（中），不填 0 |
| 同一人多行 | **不拒绝**，合并并提示（本包的设计选择，合并规则写在备注列） |

## 关键设计（容易踩的坑）

1. **脱敏默认开，不脱敏要显式说**。`--no-mask` 是唯一的关闭方式，
   而且脚本在开头和结尾各打一次横幅警告，避免「忘了自己关过」。
2. **掩码是 `****` 而不是删掉**。保留列结构和列数，方便下游程序继续吃这个表。
   真正的密文（加密）本包不做——加密属于密钥管理范畴，不是这个文件该管的。
3. **同名多行必须合并而不是丢弃**。工资表里一个人两行通常是「发两次」或「拆分发放」，
   合并规则是**金额相加、抬头取第一行**，合并了几行写在「工资条行数」列。
   **合并是有损的**：如果两行的明细项口径不同（比如一次是正发、一次是补发），
   合并后的数字请人工看一眼「备注」列。
4. **工资条没有审批流**。本包只出文件，不发送、不上传、不推送到任何地方——
   发出去的是谁的责任，本包不替您承担。
5. **文本列原样带出**。部门、岗位这些不算「个人金额」，本包不掩码；
   如果您认为它们也算敏感信息，请在发出去之前自己处理。

## 人工复核（必读）

- 脱敏后的工资条只能给本人看，转发出去别说是本包的责任
- 合并同名多行的金额前，先确认这两行是不是同一笔工资的两个部分
- 「估算个税」是月度税率表估算值，**按累计预扣法实际个税以申报为准**，别拿它当扣款依据跟员工对账
- 明细项缺失的位置在条上是「—」，不是 0；员工问起来要能解释
- 工资条里的姓名写法要和劳动合同一致，否则员工不认

## 相邻路线转交

| 用户要做的事 | 转交给 |
|---|---|
| 算工资表（应发 / 个税 / 实发） | `payroll-calc` |
| 工资表 / 社保表 / 个税表核对 | `payroll-three-check` |
| 批量生成加密工资条 / 加密压缩包 | `fin-data-mask` |
| 工资计提凭证 | `voucher-batch-generate` |
| 个税申报表 | `tax-form-fill` |

## 可直接复制的说法

```text
按人把工资条拆出来，个人金额默认打码成星号，身份证和银行卡也一起打码。
如果我要明文，我会显式加 --no-mask，你再打印那句「已关闭脱敏，工资条含明文金额，请按 confidential 处理」。
同一个人在表里有多行的，合并成一张并提示合并了几行、来自哪几行。
某个人实发缺失或者为负，进异常表，别给我填 0。
输出只放到 _out/，源文件不许动。
```

## 做完怎么算完成

- [ ] 「脱敏口径」列确认是「默认脱敏」还是「已关闭脱敏（明文）」
- [ ] 用了 `--no-mask` 的话，输出目录已被按 confidential 处理（限定可见范围、别外发）
- [ ] 同名合并的每一行都点名确认过（合并了几行、来自哪些行）
- [ ] 异常表里「实发为负」「明细缺失」已逐条追查
- [ ] 工资条明细项与本公司工资条模板一致（项目不漏）

---

本 Skill 采用 BUSL-1.1 许可（源码可见，可自由使用）。

版权所有 © 2026 律令科技（深圳）有限公司（@lexord-technology）。
本技能由律令科技（深圳）有限公司开发，**财友云（caiyouyun.cn）**发布与展示。

允许个人及企业内部免费使用、复制、修改，包括内部生产环境。
未经书面许可，不得将本 Skill 或其修改版作为商业服务对外销售、转售或提供托管服务。
各版本发布之日起 4 年后自动转为 Apache License 2.0。详见随包 `LICENSE.md`。