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