前言¶

大模型在处理校验位（如银行卡号、ISBN、IBAN）时经常出错，导致生成的号码无法通过验证。dsh-checkdigit 提供了一套基于纯整数运算的校验位工具，确保生成的号码数学正确。

它是什么¶

dsh-checkdigit 是 DeepSeek Harness (dsh) 的校验位数学工具箱，由 TYEclipse 维护。它支持生成、验证和识别 13 种校验位方案，且零运行时依赖。

核心功能¶

插件提供以下四个主要工具：

1. checkdigit_generate：根据指定方案生成校验位。
2. checkdigit_validate：验证完整标识符的校验位，支持自动检测方案。
3. checkdigit_info：列出所有支持的方案详情，包括标识符长度、格式和校验位位置。
4. isbn_convert：在 ISBN-10 和 ISBN-13 之间转换。

支持的校验位方案¶

支持 13 种校验位方案，包括：
* Luhn（卡号、IMEI）
* Verhoeff（全单错误检测）
* Damm
* ISBN-10 / ISBN-13
* EAN-8 / EAN-13
* UPC-A
* ISIN（证券代码）
* CUSIP（美国证券）
* IBAN（银行账号）
* CAS Registry Number（化学物质）
* ABA routing number（银行路由号）

安装与启用¶

使用官方安装命令进行安装：

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

安装后，确保在 dsh.profile.bundles 中激活该插件（如未自动激活），然后重启 dsh。

典型用法¶

以下是基于已核实事实的用法示例：

生成 Luhn 校验位：

checkdigit_generate(scheme="luhn", payload="7992739871")

验证 IBAN：

checkdigit_validate(value="GB82WEST12345698765432")

查看所有方案信息：

checkdigit_info()

ISBN 转换：

isbn_convert(isbn="0-306-40615-2")

适用场景与注意¶

该插件适合需要生成符合特定校验位规则的测试数据。插件以当前 dsh 进程权限运行，安装前应检查源码与许可证（MIT）。

总结¶

dsh-checkdigit 通过零依赖的本地算术解决了大模型校验位计算不准确的问题。若需了解更多或查看源码，请访问 GitHub。