TYEclipse/dsh-checkdigit

dsh-checkdigit · 校验位数学工具箱

DeepSeek Harness 插件：为 13 种校验位方案提供生成、验证与识别——Luhn、Verhoeff、Damm、ISBN-10、ISBN-13、EAN-8、EAN-13、UPC-A、ISIN、CUSIP、IBAN、CAS 化学文摘号、ABA 美国银行路由号；另带 ISBN-10 ⇄ ISBN-13 互转工具。

零运行时依赖、纯本地整数算术、无网络无外部服务。所有算法按公开规范实现，并与公开标准例交叉验证（Apple US0378331005、经典 GB82 WEST 1234 5698 7654 32、Luhn 教科书例 79927398713、水的 CAS 号 7732-18-5 等）。

为什么

大模型手算校验位是高频出错点：银行卡号校验和算错、ISBN 通不过校验、IBAN 校验位不可能成立。本插件把这些算术交给确定性代码。

安装

dsh plugin --profile web add github:TYEclipse/dsh-checkdigit

安装后在 profile 的 package.json 的 dsh.profile.bundles 中加入 "dsh-checkdigit"（若未自动激活），重启 dsh。

四个工具

- checkdigit_generate —— 给 payload 计算校验位，返回完整标识符（如 7992739871 → 校验位 3 → 79927398713；GBWEST12345698765432 → 校验位 82 → GB82WEST12345698765432；02100002 → 021000021）
- checkdigit_validate —— 校验完整标识符；省略 scheme 时自动识别（CAS 连字符式 → ISIN → 9 位 ABA → CUSIP → IBAN → EAN-13 → UPC-A → EAN-8 → ISBN-10 → Luhn）；出错时返回期望的校验位便于程序化修复
- checkdigit_info —— 列出各方案的格式、长度、校验位位置与示例
- isbn_convert —— ISBN-10 与 ISBN-13 互转：先验证输入校验位，10→13 加 978 前缀、13→10 仅限 978 前缀（979 无 ISBN-10 等价物），保留输入的连字符分组。如 0-306-40615-2 → 978-0-306-40615-7；校验位可为 X：0-8044-2957-X → 978-0-8044-2957-3

方案一览

| 方案 | 标准 | 说明 |
|------|------|------|
| Luhn | ISO/IEC 7812 | 银行卡、IMEI、会员卡 |
| Verhoeff | — | 二面体群校验，捕获全部单错与相邻换位 |
| Damm | — | 拟群运算，全值计数须为 0 |
| ISBN-10 | ISO 2108 | 模 11，校验位可为 X（=10） |
| ISBN-13 | ISO 2108 | 与 EAN-13 同算术 |
| EAN-8 / EAN-13 | GS1 GTIN | 零售条码 |
| UPC-A | GS1 GTIN-12 | 北美零售条码 |
| ISIN | ISO 6166 | 证券代码；字母展开 A=10…Z=35 后 Luhn |
| CUSIP | ANSI X9.6 | 北美证券代码；* @ # 合法；偶数位加倍 |
| IBAN | ISO 13616 | 重排展开后模 97；内置 75+ 国家 BBAN 长度表 |
| CAS Registry Number | CAS | 化学物质号；各位数×从右起位置求和模 10 |
| ABA routing number | 美联储 | 美国银行路由号；3-7-1 加权和模 10 |

开发

pnpm install
pnpm build
pnpm test   # 67 个测试，锚点与公开标准例交叉验证
pnpm lint

许可

MIT