dsh-duizhang：财务数据处理与对账工具集

在 DeepSeek Harness (DSH) 的插件生态中，处理财务数据通常涉及从 PDF 中提取信息、清洗 Excel/CSV 表格、匹配银行流水与账本，以及处理发票和税务计算。dsh-duizhang 针对这一链条提供了自动化能力，能够将银行对账单和发票批次转化为适合入账的表格，并完成对账工作。

插件概览¶

该插件由 ainetcafe.com 团队维护，属于工作流类工具。它通过 MCP (Model Context Protocol) 与 dsh 交互，提供 15 个工具，涵盖文档解析、表格处理、对账合并和企业数据清洗。所有工具遵循 MIT 许可证。

核心能力¶

工具分为四个主要类别，分别处理不同的财务处理环节。

1. 文档解析与清洗¶

• extract_statement：将银行或信用卡对账单 PDF 转换为干净的交易表格（支持 JSON 和 CSV 格式），并自动交叉检查余额。
• extract_invoices：处理最多 20 个发票 PDF 或页面图片，提取编号、日期、买卖方等字段，生成可直接入账的表格。
• read_xlsx / write_xlsx：读取或构建 Excel .xlsx 文件，支持读取所有工作表或指定工作表，并将数据写入为 CSV 文本或 JSON 数组。
• fix_csv_encoding：自动检测 CSV 的真实编码（如 GB18030、Shift-JIS、Windows-1252 等），修复乱码问题。
• clean_table：清洗导出的表格，去除重复行、修剪空白字符（包括全角和半角空格）。

2. 对账与合并¶

• reconcile_ledger：在两个数据集之间进行对账，匹配行，报告仅在 A、B 或两者中存在的键。
• match_transactions：当没有共享键（如账号）时，通过金额、日期窗口、参考号和模糊的对手方名称匹配银行流水与账本条目。
• diff_tables：对比两个 CSV 表格，按键列匹配并报告差异。
• merge_tables：合并最多 20 个 CSV 表格，即使列名不完全匹配也能通过并集处理。

3. 企业数据验证¶

• uscc_validate：校验统一社会信用代码（GB 32100 校验位），用于企业名单去重和发票抬头核对。
• amount_to_chinese：将人民币金额转换为中文大写（如“壹佰万零壹元贰角叁分”），适用于开票和合同场景。
• vat_calc_cn：进行增值税价税分离（含税价 ⇄ 不含税价 + 税额），支持 0.13 或 13 作为税率参数。

4. 任务发现¶

• what_can_you_do：用自然语言（支持多语言）描述任务，获取服务器上执行该任务的具体工具及调用参数。

安装与启用¶

安装该插件需要指定你的 profile。命令如下：

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

安装后，插件仅会向 dsh 的配置中添加一行 @deepseek-ai/dsh-mcp-client 的配置，不包含任何本地工具代码。

典型用法¶

在 DSH 中，你可以通过自然语言描述需求来调用工具。

1. 提取与转换：将银行对账单 PDF 转换为表格。
   > “把银行对账单 PDF 转换成干净的交易表格（JSON+CSV）。”
   > 这将调用 extract_statement，并自动验证余额是否平衡。

2. 无键匹配：匹配银行流水与账本。
   > “匹配银行流水和账本条目，它们没有共享账号，只能靠金额和日期找。”
   > 这将调用 match_transactions，处理 1:N 或 N:1 的支付情况。

3. 企业去重：清理供应商列表。
   > “找出供应商列表中可能重复的实体，比如“北京星辰科技有限公司”和“星辰科技（北京）”。”
   > 这将调用 dedupe_entities，结合税务 ID 校验和名称阈值判断。

运行环境与权限¶

• 运行时：基于 dsh v0.1 developer preview (Cordis v4) 构建。
• 本地代码：无。插件仅附带一个 cordis.patch.yml 配置文件，不包含任何生命周期脚本或构建步骤。
• 权限：
  • 文件系统/Shell/进程：无访问权限。
  • 网络：仅出站 HTTPS 到 ainetcafe.com。
• 数据处理：文档和提示词仅在内存中处理，不会被保留。
• 配额与计费：无免费匿名配额需要注册。表格操作按次计费（\(0.002-\)0.008），文档提取（银行对账单 $0.03，发票 $0.05）。失败调用不收费，每次响应会报告确切成本。

结语¶

dsh-duizhang 专注于财务数据处理这一细分领域，通过将复杂的对账逻辑封装在工具中，降低了 DSH 智能体进行财务自动化操作的门槛。对于需要处理大量银行流水、发票和进行会计对账的开发者，这是一个可以直接落地的插件。