前言¶

在 DeepSeek Harness（DSH）裏做財稅類 Agent，常見難點有兩類：一是政策回答容易缺出處或編造文號；二是稅額、監管模式等計算若只靠模型口算，結果不穩定。通用對話能力不等於可複覈的財稅作業。

下面介紹維護者 fleekelon 發佈的工作流插件 dsh-fintax（npm 包名 dsh-fintax，分類：工作流）。它把政策引證問答、跨境電商合規自查、監管模式選擇與確定性稅額試算串成可調用工具與技能，並與騰訊 IMA 知識庫只讀對接，便於用你自己的政策庫做引證。

插件定位¶

dsh-fintax 是 DSH 插件：向 ctx.tools / ctx.skills 註冊財稅專業能力。簡介概括爲：基於 IMA 知識庫的政策引證問答、跨境電商合規自查、確定性稅額試算（FinTax workbench for DeepSeek Harness）。

實現爲純 ESM JavaScript，零運行時依賴、免構建；許可證 MIT。package.json 當前版本爲 0.2.1，要求 Node >=18.17.0，DSH >=0.2.1-rc.2 <0.4.0（README 說明爲 developer preview，破壞性變更可提 issue）。

核心能力¶

政策引證問答¶

檢索用戶配置的 IMA 知識庫中的政策原文與解讀，回答附來源；查不到則明確說明，不編造文號。對應技能 fintax-policy-qa，強調引證紀律與降級路徑。

跨境電商合規自查¶

按清單逐項輸出結構化風險報告，覆蓋主體備案、正面清單、三單對碰、限值、出口退免稅、收匯、申報等。對應技能 fintax-crossborder-check。

監管代碼與模式選擇¶

按監管代碼決策樹定位 9610 / 9710 / 9810 / 1210 / 1039 / 0110 等模式，並同步分析退稅鏈路、收結匯、數據報送。對應技能 fintax-mode-select。

確定性稅額試算¶

算術由代碼完成，結果帶政策文號引證；技能 fintax-calc 要求先核參數、必須走工具。fintax_calc 支持五種場景：

1. cross_border_import：跨境電商零售進口綜合稅（含超限預警）
2. vat：增值稅價稅分離
3. annual_bonus_iit：年終獎單獨計稅個稅（含「多發一元」臨界點陷阱預警）
4. export_rebate：外貿企業出口退稅免退稅（孰低規則、徵退稅率差轉成本、9810 預退稅提示）
5. cbec_assessed_cit：綜試區零售出口覈定徵收企業所得稅（4% 所得率、小微疊加、9810 口徑收緊預警）

README 中的端到端示例：詢問「1000 元商品走跨境電商零售進口交多少綜合稅」時，Agent 可檢索知識庫、覈對政策原文（gov.cn）、調用工具計算並輸出帶引證的回答。政策參數（稅率、限值、徵收比例）可由調用方覆蓋；默認值僅爲試算起點，工作流要求先覈對現行政策。

安裝與啓用¶

在 DSH 中爲指定 profile 添加插件，官方 README 提供三種方式：

# 從 npm（推薦）
dsh plugin --profile <你的profile> add dsh-fintax

# 從 GitHub
dsh plugin --profile <你的profile> add github:fleekelon/dsh-fintax

# 本地目錄
dsh plugin --profile <你的profile> add /path/to/dsh-fintax

桌面端用戶也可在插件頁通過本地包安裝。社區目錄頁：https://www.skillhub.cn/plugins/fleekelon/dsh-fintax。

插件以當前 DSH 進程權限運行；安裝前建議閱讀倉庫源碼與 MIT 許可證，確認工具行爲符合你的安全策略。

配置 IMA 憑證（可選）¶

知識庫相關四個工具需要騰訊 IMA OpenAPI 憑證；未配置時會給出配置指引，稅額試算不受影響。

1. 打開 https://ima.qq.com/agent-interface 獲取 Client ID 與 API Key。
2. 二選一：
   - 寫入 ~/.config/ima/client_id 與 ~/.config/ima/api_key；
   - 或設置環境變量 IMA_CLIENT_ID / IMA_API_KEY。

憑證僅作爲 HTTP 頭髮送到官方 ima.qq.com，不寫日誌、不落其他文件。插件對知識庫只讀（列表 / 搜索 / 原文信息），不做寫入。領域內容由各用戶自己的 IMA 知識庫供給。

工具與技能一覽¶

適用場景與注意¶

適合在 DSH 中搭建財稅研究、跨境合規初篩、稅額試算輔助的 Agent。輸出爲研究輔助與算術試算，不構成稅務申報依據或鑑證意見；重大決策應諮詢執業稅務師 / 律師並以主管稅務機關口徑爲準（README 免責聲明）。

DSH 生態以「一切皆插件」爲方向；SkillHub 等爲社區目錄，與 DeepSeek / 幻方無官方從屬關係。本插件 GitHub 當前星標爲 0，不代表功能完備度，使用前請以 README 與版本約束爲準。

結語¶

dsh-fintax 將引證紀律、合規清單、模式決策樹與代碼化試算封裝爲 DSH 工具與技能，並可對接自有 IMA 知識庫。安裝與憑證配置按上文步驟即可上手；細節與實測截圖見倉庫 README。

• 目錄頁：https://www.skillhub.cn/plugins/fleekelon/dsh-fintax
• GitHub：https://github.com/fleekelon/dsh-fintax