科目映射标准化

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

# 科目映射标准化

换账套、换 ERP、 Historical 科目表清理，都要做科目映射。手工对几百个科目代码是纯体力活，而**硬凑一条"看起来像"的映射，会让后续所有凭证都错到根上**。

本包用三级匹配算置信度：

| 级别 | 规则 | 置信度 |
|---|---|---|
| ① | 代码全等 | 1.00 |
| ② | 名称规范化后全等（去空格、括号、全半角） | 0.95 |
| ③ | 名称包含 / 被包含 | 0.75 |

达到 `--min-score`（默认 0.70）自动采纳，达不到**一律进待人工确认清单**，不硬凑。

## 输出四件套

| 文件 | 内容 |
|---|---|
| `am_主表.csv` | 采纳映射：源代码 / 源名称 / 目标代码 / 目标名称 / 置信度 / 匹配依据 |
| `am_异常表.csv` | 待人工确认：源科目 + 未达阈值原因 |
| `am_校验表.csv` | 匹配顺序、阈值、采纳与待确认统计 |
| `fin-log.jsonl` | 处理日志（追加） |

## 环境准备

```bash
PY="<python 3.8+ 路径>"   # 纯标准库
"$PY" <skill目录>/scripts/subject_map.py <源科目表> <目标科目表> [参数]
```

## 用法

```bash
subject_map.py 源科目.xlsx 目标科目.xlsx
subject_map.py 源科目.xlsx 目标科目.xlsx --min-score 0.8 --execute
```

真实输出：

```
方案：源 源科目.xlsx（7 条）→ 目标 目标科目.xlsx（6 条）| 自动采纳阈值 0.70
--- 映射结果 ---
  自动采纳 6 条 / 待人工确认 1 条
--- 待人工确认（前 10 条）---
  9999       待清理科目              无科目达到置信度 0.70（最高 0.00，无任何匹配）
```

常用参数：

| 参数 | 默认 | 说明 |
|---|---|---|
| `--min-score` | 0.7 | 自动采纳的最低置信度 |

## 输入表

两张表都需要 `科目代码`、`科目名称` 两列。支持自动识别的列名：代码 `科目代码/科目编码/科目号/代码`，名称 `科目名称/科目/名称`。

## 名称规范化规则

比对前先做：去首尾空白、去所有空格、全角括号转半角、去掉「应收账款」「应付账款」之外的常见修饰词（见脚本 `norm()`）。

**规范化的目的是比对稳定，不是语义判断**——"银行存款-基本户" 与 "银行存款 基本户" 视为全等，但 "银行存款" 与 "银行借款" 不会被误判为相同。

## 安全与边界（拒绝权）

- **源文件零改动**：输出进 `_out/`，原表不动
- **默认预览**：不加 `--execute` 不写盘
- **不硬凑映射**：任何低于阈值的匹配只进待确认清单
- **不判断业务含义**：会计政策变更导致的科目口径不同（如新旧准则），本包识别不了

## 人工复核（必读）

- 待人工确认清单要逐条人工定，这是本包唯一要求人做的事
- 同一源科目映射到多个目标科目时（多对一），以置信度高者为准，其余进待确认
- 科目名称相近但方向相反的（如"预收"与"预付"），置信度可能不低，**必须人工看**

## 相邻路线转交

| 用户要做的事 | 转交给 |
|---|---|
| 按映射批量出凭证 | `voucher-batch-generate` |
| 凭证分录合法性校验 | `accounting-entry-check` |
| 科目表本身的结构检查 | 见 `fin-table-clean` |

## 可直接复制的说法

```text
把源科目表按目标科目表做映射。
先做三级匹配：代码全等、名称规范化后全等、名称包含。
置信度 0.7 以上的自动采纳，低于 0.7 的一律列进待人工确认清单，
不要为了凑数量硬给我一条看起来像的映射。
最后把采纳条数和待确认条数报给我。
```

## 做完怎么算完成

- [ ] 待人工确认清单已人工过一遍
- [ ] 置信度相近但业务含义相反的科目（预收/预付、应收/应付）已重点看
- [ ] 采纳映射已导入目标账套并抽验 5 条

---

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

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

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