前言¶

大模型在處理校驗位（如銀行卡號、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。