前言¶

在 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