数据 · 清洗 / 合并 / 脱敏 / 异常

出口退税测算与勾稽核查

【财友云】把企业申报的出口明细逐条与官方出口退税率对账——按商品代码查官方退税率,核对申报退税率是否一致,并按「出口金额 × 官方退税率」勾稽申报退税额,差异超容差或代码查不到的一律进异常表并给差额与风险等级。内置国家税务总局《出口退税率文库》在效快照(约 3.2 万个商品代码)。适用于出口退税申报前复核、退税数据自查、代账交接核对等场景。数据为离线快照、版本可查,运行时零联网。

已上线 P2 L0

出口退税测算与勾稽核查

【财友云】把企业申报的出口明细逐条与官方出口退税率对账——按商品代码查官方退税率,核对申报退税率是否一致,并按「出口金额 × 官方退税率」勾稽申报退税额,差异超容差或代码查不到的一律进异常表并给差额与风险等级。内置国家税务总局《出口退税率文库》在效快照(约 3.2 万个商品代码)。适用于出口退税申报前复核、退税数据自查、代账交接核对等场景。数据为离线快照、版本可查,运行时零联网。

这个包已上线。正文与用法以下方随包 SKILL.md 为准;安装则去 SkillHub 对应页面 →。装到本地即可离线运行,数据不出电脑。

标签

[出口退税, 退税测算, 勾稽核查, 退税率, 出口明细, 差异核查, 外贸财税]

技能正文(随包 SKILL.md)

> **本地运行,零网络请求、免 API Key、不主动外发数据。**
> 四项诚实承诺:① 对不上就说对不上,绝不替企业把差异抹平;② 高危动作强制人工确认;③ 幂等断点,绝不重复副作用;④ 全程留痕可审计。
> 边界说明:本包脚本自身不联网、不外发;若你把内容贴进 AI 对话,内容是否离开本机由你所使用的客户端决定,不由本包决定。
> 数据说明:内置码表为**离线快照**(国家税务总局《出口退税率文库》CMCODE-2026B),按季更新,跨季使用请核对版本号。
<!-- WB-CLAIM-BOUNDARY v1 -->

# 出口退税测算与勾稽核查

外贸财税复核里最高频的动作,不是「从头算一遍退税」,而是**拿申报数据与官方口径对账**——
申报的退税率是不是官方那个?申报的退税额和「出口金额 × 官方退税率」对不对得上?

这两笔账一旦对不上,就是**自相矛盾**:要么退税率填错了,要么金额口径错了,
要么退税额是估的。逐票人工核到眼花,还容易漏。

本包做的事很明确:**逐条勾稽**——按商品代码取官方退税率,核对申报退税率,
再按「出口金额 × 官方退税率」算出应勾稽退税额,与申报值比对;
**对不上的进异常表,给出差额和风险等级**。对得上就是「通过」。

> ⚠️ 定位先说清楚:**本包不做完整免抵退测算**。
> 完整测算需要进项税额、上期留抵、免抵退税额抵减额、内销销售额等一整套数据,
> 缺一不可,那是另一件事。本包做的是**勾稽核查**——把企业申报的数据与官方退税率对账,
> 找出自相矛盾之处。

## 运行方式

<!-- WB-INVOKE-CONTRACT v1 -->

**环境**:Python 3.8+,**仅标准库,无需安装任何依赖**。

**作用**:逐条勾稽出口明细的退税率与退税额,输出核查主表与差异/无法核验清单。

**命令**(在技能目录下执行):

```bash
# 默认预览(不写盘)
python scripts/export_rebate_calc.py <出口明细.csv>

# 声明金额口径、调整容差后正式执行
python scripts/export_rebate_calc.py <出口明细.csv> --amount-basis 不含税 --tolerance 0.01 --execute
```

**参数**:

| 参数 | 说明 |
|---|---|
| `<file>` | 出口明细(.xlsx / .csv),首行表头,含 商品代码 / 出口金额 |

**选项**:

| 选项 | 说明 |
|---|---|
| `--tolerance N` | 申报退税额与勾稽应退税额的比对容差(元,默认 `0.01`) |
| `--amount-basis S` | 出口金额口径(如 `不含税` / `含税` / `未声明`),仅写入校验表留痕 |
| `--data PATH` | 自定义退税率码表 CSV 路径(默认用包内 `data/cmcode.csv`) |
| `--out-dir OUT_DIR` | 产物输出目录(默认 `<cwd>/_out`) |
| `--operator OPERATOR` | 操作人(写入留痕) |
| `--execute` | 真正写盘 |

**退出码**:`0` 成功 / `2` 输入错误 / `3` 鉴权失败 / `4` 环境或依赖失败 / `8` 部分成功。

**输出**:四件套写入 `--out-dir`,源文件不改动;先跑预览确认,再加 `--execute` 落盘。

## 何时不触发

以下情况**不要**启动本技能,并主动告诉用户该走哪条路:

1. 要**做完整免抵退 / 免退税测算**(含进项、留抵、抵减额、内销额) → 本包**不做**,需另备完整数据后按申报表逻辑测算。
2. 只想**查某个商品代码的退税率是多少**(不做勾稽) → 转 `caiyouyun-export-rebate-rate`(更轻、更快)。
3. 要**判断商品该归哪个 HS 编码**(归类) → 转 `caiyouyun-hs-code-guide`(归类是法律行为)。
4. 要判断**能不能退税、适不适用免税**(政策适用性,含跨境电商路径) → 转 `caiyouyun-crossborder-tax-adapter` / `caiyouyun-tax-benefit-matcher`。
5. 要查的是**进口关税 / 最惠国税率** → 转 `caiyouyun-tariff-rate-lookup`。
6. 要核**进项能不能抵扣**(含征退税率差的进项处理) → 转 `caiyouyun-vat-input-deduction-check`。
7. 用户要的是**保证正确的退税结论** → 明确告知:本包是勾稽辅助,最终以主管税务机关口径为准。

> 误触发一次的成本高于漏触发一次:差异被抹平,用户可能直接照着错的数申报。

## 工作流(编号阶段)

| 阶段 | 做什么 | 产物 | 闸门 |
|---|---|---|---|
| 一 | 加载码表 + 读入出口明细,校验必需列 | 内存码表 + 明细行 | 缺 商品代码 / 出口金额 列 → 拒绝(RC=2) |
| 二 | 逐条取官方退税率:代码空 / 位数错 / 查不到 → 异常 | 官方税率命中 | 查不到不猜,进异常表(高) |
| 三 | 退税率核对:申报值 ≠ 官方值 → 异常(高) | 差异清单 | 差异未被抹平 |
| 四 | 退税额勾稽:\|申报 − 应退\| > 容差 → 异常(高) | 差额清单 | 差额写明金额 |
| 五 | 出表:主表(通过)+ 异常表(差异/无法核验) | 核查主表 + 异常表 | 条目守恒校验 |

> 按顺序推进;上一阶段闸门没过,不进入下一阶段。

## 判断框架(勾稽三道关,逐条过)

**第一关 · 代码 → 官方退税率**:商品代码必须是 8/10 位数字,且能在官方码表中**精确命中**。
命中不了就是**无法核验**(不是「大概 13%」),进异常表。

**第二关 · 申报退税率 vs 官方退税率**:两者不一致即**差异**(高)——
这是最典型的「填错税率」,直接影响退税额计算。

**第三关 · 申报退税额 vs 勾稽应退税额**:`应勾稽退税额 = 出口金额 × 官方退税率 / 100`,
与申报退税额比对,|差| > 容差 即**差异**(高),并**输出差额**。

> 三关全过才算「通过」。任一关不过,该行进异常表——**绝不在主表给一个被平滑过的结论**。

## 能力边界(先说清楚)

| 本包**能**做 | 本包**不做** |
|---|---|
| 按商品代码取官方退税率并与申报值对账 | **完整免抵退 / 免退税测算**(需进项、留抵、抵减额等) |
| 按「出口金额 × 官方退税率」勾稽申报退税额 | 判断商品该归哪个 HS 代码(归类是法律行为) |
| 输出差异项与差额、区分风险等级 | 判断能不能退税 / 适不适用免税(政策适用性) |
| 逐条留痕、条目守恒可核 | 判断金额口径(含税 / 不含税由用户声明) |

> 边界是有意为之:**本包对账,不对账之外的事一概不下结论**。
> 「应勾稽退税额」是**核对基准**,不是「你应退多少」的结论。

## 数据说明

| 项 | 值 |
|---|---|
| 来源 | 国家税务总局《出口退税率文库》(CMCODE,各省税务局发布) |
| 版本 | **CMCODE-2026B**(2026-06-04 编制) |
| 内置范围 | 每商品代码取**最新一期**(在效快照),约 **32,099** 个代码 |
| 字段 | 商品代码 / 商品名称 / 计量单位 / 征税率% / 出口退税率% / 生效起 / 生效止 |
| 更新节奏 | **按季更新,每年 A/B/C 三版**(A≈3 月、B≈6 月、C≈10 月) |

> 当前退税率分布(前几位):13% ≈ 11,690 个 · 0% ≈ 6,172 个 · 9% ≈ 3,945 个 · 16% ≈ 3,398 个。

## 输入 / 输出

输入:1 张出口明细(`.xlsx` / `.csv`),首行表头。

| 列 | 必需 | 别名 |
|---|---|---|
| 商品代码 | 必需 | 商品代码 / 商品编码 / 代码 / HS编码 / 海关商品编码 / 商品编号 / 税则号列 |
| 出口金额 | 必需 | 出口金额 / 金额 / 出口额 / 计税金额 / 销售额 / 离岸价 / FOB |
| 申报退税率 | 可选 | 申报退税率 / 退税率 / 申报税率 / 退税率% |
| 申报退税额 | 可选 | 申报退税额 / 退税额 / 已退税额 / 退税金额 / 应退税额 |

> 同时给「申报退税率」和「申报退税额」核查最完整;只给其中之一,本包核对应的那一关。

输出(进 `--out-dir`,源文件一个字节都不动):

| 文件 | 内容 |
|---|---|
| `出口退税勾稽核查_主表.csv` | 逐条:商品代码 / 商品名称 / 出口金额 / 官方退税率% / 申报退税率% / 申报退税额 / 勾稽应退税额 / 差值 / 结论 |
| `出口退税勾稽核查_异常表.csv` | 差异项 / 无法核验项(代码空·位数错·查不到·金额缺失·税率或退税额对不上),带风险等级 |
| `出口退税勾稽核查_校验表.csv` | 核查口径 / 能力边界 / 金额口径 / 容差 / 数据版本 / **条目守恒校验** |
| `fin-log.jsonl` | 处理日志(追加,含输入 sha256) |

## 真实输出

正常(5 行输入,含 1 条退税率不一致、1 条代码查不到):

```
--- 出口退税勾稽核查(通过 3 条)---
  8517120000   手持式无线电话机         出口 1000000.0     官退13%  应退129999.99  差值0.01  通过
  8471300000   便携式自动数据处理设备   出口 500000.0      官退13%  应退65000.00   差值0.00  通过
  9013803000   液晶显示屏             出口 120000.0      官退0%   应退0.00       差值0.00  通过(仅代码核验:无申报退税率/退税额可比)

--- 差异 / 无法核验(2 条)---
  8541401010   [高] 申报退税率 9% 与官方退税率 13% 不一致(差 -4 个百分点)
  9999999999   [高] 商品代码未收录于官方退税率码表(CMCODE-2026B),无法核验
```

校验表(条目守恒):

```
  条目守恒 | 输入 5 = 主表 3 + 异常 2
  数据版本 | CMCODE-2026B(2026-06-04 编制)
  能力边界 | 本包做勾稽核查,**不做免抵退完整测算**(缺进项/留抵/免抵退税额抵减额等完整数据)
```

> 注意第 1 条:申报退税额与勾稽应退税额差 0.01 元 —— **恰好在容差内**故判「通过」;
> 若差 0.02 元即进异常表并写明差额。容差不是用来「抹平」的,是用来容忍四舍五入的。

## 拒绝权(什么情况下不给判断)

| 情况 | 处理 |
|---|---|
| 缺「商品代码」列 | **拒绝(RC=2)**,列出可用别名 |
| 缺「出口金额」列 | **拒绝(RC=2)**,说明勾稽需要出口金额 |
| 商品代码为空 | 该行进异常表(高) |
| 商品代码非 8/10 位数字 | 该行进异常表(高) |
| 商品代码未收录于码表 | 该行进异常表(高)「无法核验」,**绝不取相近代码凑** |
| 申报退税率 ≠ 官方退税率 | 该行进异常表(高),写明偏差 |
| 申报退税额与勾稽应退税额差 > 容差 | 该行进异常表(高),写明差额 |
| 出口金额缺失 / 非数值 | 该行进异常表(高),**不按 0 处理** |
| 输入文件不存在 / 格式不支持 | **拒绝(RC=2)**,说明支持 .xlsx / .csv |
| 包内码表缺失 | **拒绝(RC=4)**,说明需 `/data/cmcode.csv` 或 `--data` |

## 关键设计(容易踩的坑)

1. **「应勾稽退税额」是核对基准,不是结论**。它 = 出口金额 × 官方退税率,
   用来与企业申报值对账;**不是**「你该退这么多」。完整退税额还要看进项、留抵、抵减额。
2. **查不到代码就进异常表,绝不取相近代码**。代码是一位一位的,取错一位税率的商品可能完全不同。
3. **金额口径由用户声明,本包不猜**。出口金额是含税还是不含税、是 FOB 还是 CIF,
   直接影响勾稽结果;口径不一致会表现为「退税额对不上」,本包会把金额口径写进校验表供追溯。
4. **容差只为四舍五入,不为抹平差异**。默认 0.01 元;**改大容差前先想清楚为什么**,
   把容差调到几百元,等于把真实差异放行。
5. **退税率 0 是有效答案**。官方退税率 0% → 勾稽应退税额 0;这与「查不到代码」是两回事。
6. **条目守恒**:输入条数 = 主表条数 + 异常表条数。对不上账,本包**拒绝输出**。
7. **本包不做完整免抵退测算**。别把「通过」理解成「退税没问题」——它只表示
   「这份申报数据内部自洽、与官方退税率对得上」。

## 人工复核(必读)

- 本包输出的是**勾稽核查结果**,是复核辅助,**不是退税结论**;
- **差异项必须人工复核**:确认是退税率填错、金额口径不一致、还是退税额估算偏差,
  再决定更正方式;
- 金额口径(含 / 不含税、FOB / CIF 等)由用户声明,本包不判断,请与申报口径对齐;
- 官方退税率以**现行有效版本**为准,跨季使用请核对版本号并用官方查询复核;
- 完整退税还需判断政策适用性、进项合规性、单证齐备性等,本包不覆盖。

## 相邻路线转交

| 用户要做的事 | 转交给 |
|---|---|
| 单纯查某商品代码的退税率 | `caiyouyun-export-rebate-rate` |
| 判断商品归哪个 HS 编码 | `caiyouyun-hs-code-guide` |
| 判断能否退税 / 免税(政策适用性) | `caiyouyun-tax-benefit-matcher` |
| 跨境电商退免税路径(9610/9710/9810/1210) | `caiyouyun-crossborder-tax-adapter` |
| 查进口关税 / 暂定 / 最惠国税率 | `caiyouyun-tariff-rate-lookup` |
| 进项能不能抵扣(含征退税率差) | `caiyouyun-vat-input-deduction-check` |
| 填出口退税申报表 | `caiyouyun-tax-form-fill` / `caiyouyun-tax-form-guide` |
| 核验退税依据文件是否仍有效 | `caiyouyun-policy-validity-check` |

## 可直接复制的说法

```text
把这份出口明细做一次退税勾稽核查。
按商品代码取官方退税率,先核申报退税率跟官方退税率一致不一致;
再按「出口金额 × 官方退税率」算出应勾稽退税额,跟申报退税额对账。
对不上的单独列出来,写清楚差在哪、差多少,不要替我抹平。
代码查不到的直接进异常表,别拿相近代码的税率凑。
容差就用 0.01 元,别调大。
先跑预览,我确认了再加 --execute。
```

## 做完怎么算完成

- [ ] 每条结果都带**商品代码 + 官方退税率**,不是只给一个数
- [ ] 差异项已单列并写明**差额**(退税率差几个点 / 退税额差几元)
- [ ] 查不到的代码进异常表标「无法核验」,**没有**取相近代码凑
- [ ] 校验表写明**本包做勾稽核查、不做免抵退完整测算**
- [ ] 校验表写明了**出口金额口径**与**比对容差**
- [ ] 输出里带了**数据版本戳**(CMCODE-2026B)
- [ ] 校验表「条目守恒」对得上

## 参考资料(渐进式披露)

| 文件 | 内容 | 何时读 |
|---|---|---|
| `references/01-legal-basis.md` | 退税率来源、勾稽依据、官方核对入口 + 数据版本 | 需要核对依据与来源时 |
| `references/02-decision-table.md` | 逐条判定表(9 步)+ 差异分级 + 边界口径 | 需要确认判定逻辑时 |
| `references/03-verification-checklist.md` | 前置信息清单 + 高风险情形 + 复核动作 | 核查前齐备性检查、事后复核 |
| `data/cmcode.csv` | 内置退税率码表快照(32,099 条) | 脚本自动读取,勿手工改 |
| `data/NOTICE.txt` | 数据来源与版权声明 | 引用数据时 |

## 输出规范

- **交付形态**:执行结果 + 变更清单,说清动了什么、没动什么。
- **必含字段**:执行前状态 / 执行动作 / 执行后状态 / 失败项与原因 / 回滚方式。
- **留痕**:产生副作用的执行必须写留痕文件(manifest / log),可回溯。
- **自检**:失败项未列原因,或无可回滚路径,视为未完成。
- **本包四件套**:主表(关注项)/ 异常表(差异与无法核验)/ 校验表(口径·容差·守恒)/ 日志。

## 免责声明

本技能输出的是**出口退税勾稽核查结果**,不构成税务意见,也不是退税结论。
完整退(免)税测算须在完备数据下按主管税务机关口径另行进行;
退税率以国家税务总局《出口退税率文库》官方现行版本为准。
因使用本结果产生的后果,由使用者自行承担。

---

版本:v0.1.0 · 出品:【财友云】 · 数据版本:CMCODE-2026B

## 反例对照(避开这些写法)

| ❌ 反例 | ✅ 正例 | 判据 |
|---|---|---|
| 把「应勾稽退税额」当成「你该退这么多」的结论 | 只作对账基准,声明不做免抵退测算 | 有没有越界给结论 |
| 差异被四舍五入 / 调大容差后「通过」 | 超容差即进异常表并写明差额 | 差异有没有被抹平 |
| 代码查不到就按相近代码取税率 | 进异常表标「无法核验」 | 有没有猜税率 |
| 出口金额缺失就按 0 勾稽 | 进异常表(高),提示补金额 | 缺数据时有没有硬算 |
| 不记录金额口径(含税 / 不含税) | 写进校验表,提示与申报口径对齐 | 口径能否追溯 |
| 输出不带数据版本 | 每次输出带 CMCODE-2026B 版本戳 | 跨季使用时会不会误用旧值 |

<!-- WB-SELFCHECK v1 -->

## 交付前自检(必跑)

本包自带可执行自检脚本。**在交付 / 打包 / 发布之前,必须运行并通过**:

```bash
python scripts/selfcheck.py
```

退出码语义(与本节末尾「退出码(脚本契约)」一致):

| 码 | 含义 | 你要做的事 |
|---|---|---|
| 0 | 全部通过 | 可以交付 |
| 2 | 用法错误 | 检查运行路径,用包根目录下 `scripts/selfcheck.py` |
| 3 | **门禁未通过** | 按 FAIL 项逐条修好再交付,**不要带病交付** |
| 4 | 环境问题 | 检查 Python 版本(需 3.8+)与入口脚本是否可运行 |
| 8 | 部分通过 | 无 FAIL,但有 WARN;建议先修警告项再交付 |

自检覆盖:SKILL.md 与 frontmatter(`name`·`description`)/ 合规声明(frontmatter `license` **或** `ATTRIBUTION.md`,二者其一即可)/ 必备章节 / 打包卫生(禁止 .pyc·__pycache__·.bak·.zip)/ 脚本可编译 / 入口脚本 `--help` 可运行。
<!-- /WB-SELFCHECK -->

## 退出码(脚本契约)

| 码 | 含义 | 你要对用户说的话 |
|---|---|---|
| 0 | 成功 | 直接给结果,不解释过程 |
| 2 | 输入错误(缺参数 / 格式不对 / 文件不存在) | 「你给的 <X> 不对,需要 <Y>」—— 说明正确格式,不要猜默认值硬跑 |
| 3 | 鉴权/授权失败(密钥缺失、无权限) | 「需要你先提供 <凭据>」—— 说明去哪里拿,不要跳过鉴权 |
| 4 | 服务/环境失败(网络不可用、依赖缺失) | 「这一步依赖 <X> 不可用」—— 给出替代路径或降级方案 |
| 8 | 部分成功(有成功项也有失败项) | 「N 项成功、M 项失败」—— 逐条列出失败项与原因,不要只报总数 |

脚本退出非 0 时:**不要静默重试**。先把该码对应的话告诉用户,再决定是补齐输入重试、还是换路径。

## 状态与断点

- 多阶段流程在执行目录写 `outputs/.state.json`,记录「当前阶段 + 已完成产物路径 + 时间」。
- **每个阶段结束后写一次**;中途中断后重启,先读该文件,从断点阶段继续,**不从头重跑**。
- 状态文件只记阶段与产物路径,不记对话内容、不记敏感数据。
- 发现状态文件与实际情况不符(产物已不存在)时,以实际产物为准并重置状态。
这个包已在 SkillHub 上线,可一键安装。
在 SkillHub 上查看完整说明、版本记录与安装方式,支持一键装到你的 AI 客户端。

常见问题

按真实会被问到的顺序排,每条答案都给得出可核对的依据,不含含糊其辞的部分。

出口退税测算与勾稽核查 这个技能,具体能帮我做什么?

【财友云】把企业申报的出口明细逐条与官方出口退税率对账——按商品代码查官方退税率,核对申报退税率是否一致,并按「出口金额 × 官方退税率」勾稽申报退税额,差异超容差或代码查不到的一律进异常表并给差额与风险等级。内置国家税务总局《出口退税率文库》在效快照(约 3.2 万个商品代码)。适用于出口退税申报前复核、退税数据自查、代账交接核对等场景。数据为离线快照、版本可查,运行时零联网。

常见的触发场景有:出口退税测算、退税勾稽、退税额对不对。

完整说明、版本记录和安装方式在 SkillHub 上的「出口退税测算与勾稽核查」页面 →。

跑完之后我会拿到什么东西?

输出会落在 _out/ 目录,主要包括:

1.出口退税勾稽核查_主表.csv逐条:商品代码 / 商品名称 / 出口金额 / 官方退税率% / 申报退税率% /
2.出口退税勾稽核查_异常表.csv差异项 / 无法核验项(代码空·位数错·查不到·金额缺失·税率或退税额对不上),带风
3.出口退税勾稽核查_校验表.csv核查口径 / 能力边界 / 金额口径 / 容差 / 数据版本 / 条目守恒校验
有没有算不了、它明确拒绝的情况?

有。下面几种情况它会明确拒绝,而不是硬给答案:

·按商品代码取官方退税率并与申报值对账:完整免抵退 / 免退税测算(需进项、留抵、抵减额等)
·按「出口金额 × 官方退税率」勾稽申报退税额:判断商品该归哪个 HS 代码(归类是法律行为)

总之是算不出就说算不出,不会给你一个看着合理、实际没依据的数字。

用之前我得注意什么?容易踩哪些坑?

这几条是设计时就写进去的口径,不知道会直接算错,不是「留意一下」那种套话:

·「应勾稽退税额」是核对基准,不是结论。它 = 出口金额 × 官方退税率,
·查不到代码就进异常表,绝不取相近代码。代码是一位一位的,取错一位税率的商品可能完全不同。
·金额口径由用户声明,本包不猜。出口金额是含税还是不含税、是 FOB 还是 CIF,
跑完的数能不能直接用?我还要核什么?

不能直接拿去报。它给的是建议和依据,最终判断还是得你来做。下面这几条是它要求你逐条过的:

·本包输出的是勾稽核查结果,是复核辅助,不是退税结论;
差异项必须人工复核:确认是退税率填错、金额口径不一致、还是退税额估算偏差,
·金额口径(含 / 不含税、FOB / CIF 等)由用户声明,本包不判断,请与申报口径对齐;
数据会不会传出去?我自己怎么验证?

不会。运行时不发一个网络包。你自己就能验证,三条路任选:

把网断掉再跑一遍,功能照常——它本来就没打算联网。

打开包里的 SKILL.md,权限声明写的是 network: none,不声明就没有联网能力。

直接翻 scripts/ 下的源码,全站都是 Python 标准库写成,没有一行网络代码。

要付费吗?要不要配 API Key?

都不要。免费使用,不需要任何 API Key,不联网就不需要 Key,也不存在额度这回事。开源协议 BUSL-1.1,发布满 4 年后自动转为 Apache License 2.0。

装上之后怎么用?

安装后,在支持 SkillHub 的 AI 客户端(如 WorkBuddy)里直接使用即可。

触发方式:对话里提到「出口退税测算、退税勾稽、退税额对不对」等场景,或上传相关表格/凭证,它就会自动响应。

典型用法:把原始文件发给 AI,说『帮我跑 出口退税测算与勾稽核查』或『处理一下这个』,结果会输出到当前目录的 _out/出口退税勾稽核查_主表.csv。

也可以从客户端的「已安装技能」列表里手动唤起。

什么环境能跑?需要装依赖吗?

Windows / macOS / Linux 都能跑,不需要 pip install 任何东西。

运行只依赖 Python 3 标准库:全站 345 个脚本的首行都是 #!/usr/bin/env python3,没有第三方依赖,也就没有环境冲突要调。

装在哪个客户端上?会不会弄坏我原来的文件?

在 SkillHub 上一键安装即可,主流 AI 客户端都能装。运行是只读 + 输出到 _out/,你原来的账套和表格一个字节都不会被动。

相邻技能

规划中 P2 数据

财务人理财科普

【财友云】面向财务人自身的理财科普:输入关注主题(个税汇算/专项扣除/社保公积金/个人养老金/家庭保障/稳健理财/防诈防坑),输出结构化科普卡(政策依据+核心要点+操作步骤+风险提示),严守不荐股/不承诺收益/不荐具体产品红线。

规划中 P2 数据

表格→分析报告

【财友云】把表格变成带数字溯源的分析报告:每个数字可回溯到原表区域与聚合口径,提供溯源模板与回查清单。

规划中 P2 数据

从零构建工作簿

【财友云】从零构建可审计工作簿的强制规范:计算用活公式、假设集中引用、关键假设黄底、交付前 recalc 验证零错误。

规划中 P0 数据

多表批量合并

按标准字段模板合并多张 Excel/CSV,保留来源文件与来源部门列,业务唯一键查重,输出合并表/重复表/缺字段表

规划中 P2 数据

中小企业划型判定

【财友云】按《中小企业划型标准规定》逐户判定大型 / 中型 / 小型 / 微型,十六个行业门类的指标门槛内置,多指标行业按「且」关系判定,行业认不出或指标缺失一律进异常表不猜。适用于小微优惠前置判断、政府采购资格、专精特新申报等场景。

规划中 P2 数据

AI 可读性诊断

【财友云】诊断表格会不会被 AI 误读:合并单元格占比、多级表头、表头偏移、数字存文本、单位混用、日期不一,输出评分与修复项。

规划中 P2 数据

公式解释器

【财友云】把复杂 Excel 公式逐层翻译成人话,标风险点:绝对引用缺失、IF嵌套过深、整列引用、易失函数;本地零联网。

规划中 P0 数据

财务数据脱敏采样

从大表抽样 20-50 行并对姓名/税号/银行卡/手机号/金额做保形脱敏,供试跑与外发,原表零改动

规划中 P0 数据

财务明细表清洗标准化

日期统一 YYYY-MM-DD、金额转数值、名称按映射表替换、空值/重复/非数字进异常表,输出标准表+异常表+校验表