dsh-validate：離線校驗與中文金額/稅務計算插件

前言¶

DeepSeek Harness (DSH) 的插件化架構允許開發者通過配置層擴展能力。在構建智能體或自動化工作流時，經常會遇到需要校驗數據格式（如身份證號、銀行卡號）或進行固定算術（如金額轉大寫、個稅計算）的場景。直接調用外部 API 存在依賴風險，而使用大模型進行精確算術容易產生幻覺。dsh-validate 作爲一個基於確定性算法的插件，旨在解決上述問題，提供經過校驗的算法能力。

插件定位¶

mario03690/dsh-validate 是一個專注於離線標識符校驗和中文金額/稅務算術的 DSH 插件。它不包含本地工具代碼，僅作爲配置層存在。該插件維護者隸屬於 ainetcafe.com 團隊，使用 MIT 許可證。它不依賴任何第三方查詢服務，所有校驗均基於 ISO/GB 國家標準算法（如 Luhn、MOD 97、GB 11643 等），確保結果的一致性和長期穩定性。

安裝與啓用¶

安裝該插件需要在 DSH 的命令行中執行官方提供的安裝命令。安裝過程會向指定 Profile 添加一個配置條目，該條目指向 GitHub 倉庫中的 cordis.patch.yml 文件。

dsh plugin --profile <your-profile> add github:mario03690/dsh-validate

安裝完成後，插件即可在 DSH 的配置上下文中生效。

核心能力¶

該插件包含 18 個工具，主要分爲以下幾類能力：

校驗和驗證：基於 ISO/GB 標準算法，校驗各類號碼的自洽性。
- 中國大陸身份證（GB 11643 校驗位 + 出生日期真實性）
- 統一社會信用代碼（GB 32100 校驗位）
- 銀行卡號（Luhn 校驗）
- 車牌號（省份簡稱 + 發牌機關 + 序號，支持新能源車牌規則）
- 車架號（VIN，ISO 3779 校驗位）
- ISBN-10/13、IMEI、IBAN、EAN/UPC 等條碼與設備號校驗
金額轉換：將數字金額轉換爲中文大寫或英文大寫。
稅務計算：基於中國稅法規則的計算。
- 中國個人所得稅（綜合所得年度彙算，含速算扣除法）
- 增值稅價稅分離（含稅 ⇄ 不含稅）
金融與日程：
- 貸款測算（等額本息與等額本金）
- 調休感知的工作日計算（識別補班，非簡單去週末）

典型用法¶

1. 校驗中國居民身份證¶

輸入身份證號碼，插件會返回校驗結果，並解析出生日期、性別及行政區劃碼。

{
  "id": "id_validate",
  "arguments": {
    "id": "110101199003078034",
    "number": "110101199003078034",
    "text": "110101199003078034"
  }
}

2. 人民幣金額轉中文大寫¶

適用於開票、合同等場景，避免手寫錯誤。

{
  "id": "amount_to_chinese",
  "arguments": {
    "amount": "100.56",
    "value": "100.56",
    "text": "100.56"
  }
}

3. 中國個人所得稅計算¶

基於 2019 年起稅率表，計算綜合所得年度彙算。

{
  "id": "tax_calc_cn",
  "arguments": {
    "income": 150000,
    "special_deduction": 20000,
    "special_additional": 12000,
    "other_deduction": 0,
    "threshold": 60000
  }
}

權限與安全¶

在部署和使用該插件前，需瞭解其運行環境與權限模型：

運行環境：需要 DSH v0.1 開發者預覽（Cordis v4）環境。插件本身不包含工具代碼，不涉及本地構建步驟。
本地訪問：無文件系統、Shell 或進程訪問權限。僅通過配置層注入 @deepseek-ai/dsh-mcp-client。
網絡訪問：僅允許出站 HTTPS 請求至 ainetcafe.com。
數據隱私：文檔處理在內存中完成，不上傳或保留任何持久化數據。
計費：免費匿名配額內，每次調用成本 $0.001。調用失敗不收費。

總結¶

dsh-validate 通過將確定性算法封裝爲 DSH 插件，爲開發者提供了一個安全、可控且成本極低的工具集，用於處理強規則校驗和精確算術任務。如果你正在處理大量的財務單據、企業資質校驗或稅務計算，該插件能直接集成到工作流中，替代不穩定的 API 調用。

目錄頁：https://www.skillhub.cn/plugins/mario03690/dsh-validate
源碼倉庫：https://github.com/mario03690/dsh-validate