在 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 中,你可以通過自然語言描述需求來調用工具。
-
提取與轉換:將銀行對賬單 PDF 轉換爲表格。
> “把銀行對賬單 PDF 轉換成乾淨的交易表格(JSON+CSV)。”
> 這將調用extract_statement,並自動驗證餘額是否平衡。 -
無鍵匹配:匹配銀行流水與賬本。
> “匹配銀行流水和賬本條目,它們沒有共享賬號,只能靠金額和日期找。”
> 這將調用match_transactions,處理 1:N 或 N:1 的支付情況。 -
企業去重:清理供應商列表。
> “找出供應商列表中可能重複的實體,比如“北京星辰科技有限公司”和“星辰科技(北京)”。”
> 這將調用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 智能體進行財務自動化操作的門檻。對於需要處理大量銀行流水、發票和進行會計對賬的開發者,這是一個可以直接落地的插件。