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

财务人理财科普

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

已上线 P2 L0

财务人理财科普

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

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

标签

[理财科普, 个人理财, 个税汇算, 社保公积金, 稳健理财, 防诈防坑]

技能正文(随包 SKILL.md)

> **本地运行,零网络请求、免 API Key、不主动外发数据。**
> 四项诚实承诺:① 不荐股(不提具体标的);② 不承诺收益(不写「年化 X%」);③ 不荐具体产品(不指定品牌);④ 仅科普与提醒,配置须咨询持牌顾问。
> 边界说明:本包脚本自身不联网、不外发;若你把内容贴进 AI 对话,内容是否离开本机由你所使用的客户端决定。

<!-- WB-CLAIM-BOUNDARY v1 -->

# 财务人理财科普

财务人帮公司算账精明,轮到自己家「理财」却常被两类坑:
**一是信息过载**——个税、社保、公积金、养老金、保险、理财,每个都该懂一点,但碎片信息难成体系;
**二是销售话术**——「保本高息」「稳赚不赔」「内部渠道」,专挑懂点财务、又想要收益的人。

本包不做「卖你一个产品」,而是把**财务人自身最该懂的理财主题**,整理成一张张**结构化科普卡**:
政策依据 + 核心要点 + 操作步骤 + 风险提示 + 红线。确定性、可核查、不画饼。

> ⚠️ 本包是**理财科普与风险提醒**,**不构成投资建议、不荐股、不承诺收益、不荐具体产品**。
> 任何具体配置(买哪只、投多少、怎么组合)须咨询持牌投资/保险顾问,以监管与机构最新口径为准。

## 运行方式

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

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

**作用**:把输入的关注主题,逐条生成结构化科普卡。

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

```bash
# 方式一:清单文件(.xlsx / .csv,首行表头:主题)
python scripts/finance_literacy.py <主题清单.csv>

# 方式二:直接指定主题(可多个)
python scripts/finance_literacy.py --topic 个税汇算 稳健理财 防诈防坑

# 确认无误后正式执行
python scripts/finance_literacy.py <主题清单.csv> --execute
```

**参数**:

| 参数 | 说明 |
|---|---|
| `<file>` | 主题清单(.xlsx / .csv),首行表头,含 主题 |
| `--topic` | 主题(可多个,与 file 二选一) |
| `--out-dir OUT_DIR` | 产物输出目录(默认 `<cwd>/_out`) |
| `--operator OPERATOR` | 操作人(写入留痕) |
| `--execute` | 真正写盘 |

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

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

## 何时不触发

1. 要的是**公司财税筹划**(分红/架构/优惠临界点) → 转 `caiyouyun-tax-plan-advisor`。
2. 要的是**投资个股/基金标的推荐** → 明确拒绝:本包不荐股、不荐具体标的。
3. 要的是**具体产品/平台推荐** → 明确拒绝:本包不荐具体产品,只做科普与机制讲解。
4. 要的是**涉税违法筹划**(阴阳合同/虚开) → 明确拒绝并转专业税务/法律人士。

## 工作流(编号阶段)

| 阶段 | 做什么 | 产物 | 闸门 |
|---|---|---|---|
| 一 | 主题读取:逐行取「主题」 | 主题清单 | 行内无主题,直接进异常表 |
| 二 | 主题匹配:命中内置科普知识库(支持别名/包含匹配) | 命中清单 | 未命中 → 进异常表,不编造 |
| 三 | 出卡:政策依据 + 核心要点 + 操作步骤 + 风险提示 + 红线 | 科普卡主表 | — |

## 判断框架(主题覆盖范围)

| 主题 | 覆盖要点 |
|---|---|
| 个税综合所得汇算 | 四类综合所得合并计税、3–6 月办理、多退少补机制 |
| 专项附加扣除 | 七项扣除、标准内定额/限额、降应纳税所得额 |
| 社保缴费与待遇 | 五险、缴费基数核定、断缴影响 |
| 住房公积金 | 缴存比例、购房/租房提取、贷款连续缴存要求 |
| 个人养老金 | 年缴上限、递延纳税、封闭运行、自负盈亏 |
| 家庭保障配置 | 保障优先于投资、先大人后小孩、看清责任免除 |
| 稳健理财 | 风险由低到高:存款→国债→货基→理财R1/R2;收益风险成正比 |
| 防诈防坑 | 保本高息/杀猪盘/庞氏识别、查牌照、96110 |

> 未收录主题一律进异常表标「须人工判断」,绝不编造一张卡凑数。

## 输入 / 输出

输入:1 张主题清单(`.xlsx` / `.csv`),首行表头。

| 列 | 必需 | 别名 |
|---|---|---|
| 主题 | 必需 | 主题 / 关注主题 / 想了解 / 事项 |
| 备注 | 可选 | 备注 / 说明 / 补充 |

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

| 文件 | 内容 |
|---|---|
| `理财科普_主表.csv` | 逐条:主题 / 政策依据 / 核心要点 / 操作步骤 / 风险提示 / 红线 |
| `理财科普_异常表.csv` | 未收录主题(须人工判断) |
| `理财科普_校验表.csv` | 核验口径 / 知识库条目 / 版本 / 重要声明 / **条目守恒校验** |
| `fin-log.jsonl` | 处理日志(追加,含输入 sha256) |

## 真实输出

正常(3 个主题):

```
--- 理财科普(共 3 张卡,0 条须人工判断)---
  个税综合所得汇算 | 红线:不荐股/不承诺退税金额/不代持身份
  稳健理财 | 红线:不荐具体产品/不承诺收益/不写「年化 X%」
  防诈防坑 | 红线:不荐任何「项目/平台」;警示一切「保本高息」极高风险

--- 校验表 ---
  条目守恒 | 输入 3 = 主表 3 + 异常 0
  知识库条目 | 8
  重要声明 | 本包为理财科普与风险提醒,不构成投资建议;不荐股/不承诺收益/不荐具体产品
```

## 拒绝权(什么情况下不给科普卡)

| 情况 | 处理 |
|---|---|
| 缺「主题」列 | **拒绝(RC=2)**,列出可用别名 |
| 行内无主题描述 | 该行进异常表(高),不猜 |
| 主题未收录 | 该行进异常表(中),标「须人工判断」 |
| 索要「买哪只/投哪个平台」 | 明确拒绝荐产品/荐标的,只做机制科普 |
| 索要「稳赚/保本高息」方案 | 明确警示风险,拒绝承诺收益 |

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

1. **科普 ≠ 建议**。本包只讲「机制、依据、风险、红线」,不给「你该买什么」。
2. **不承诺收益**。任何「年化 X%」「稳赚」都违反红线,本包输出里不会出现。
3. **不荐股不荐产品**。涉及具体股票/基金/银行/保险/理财品牌,一律不提。
4. **政策时效**。社保/公积金/个人养老金/专项扣除的具体标准由各地与年度公告调整,卡内标注「以现行口径为准」,不替你判断当下数值。
5. **条目守恒**:输入条数 = 主表条数 + 异常表条数。对不上账,本包**拒绝输出**。

## 人工复核(必读)

- 本包输出是**科普与风险提醒**,不是投资建议,不能作为任何投资/投保决策依据;
- 具体配置(买哪只、投多少、如何组合)须咨询**持牌**投资/保险顾问;
- 涉及税务办理,以**主管税务机关**当年公告与口径为准;
- 遇「保本高息」「内部渠道」「拉人头」,先打 96110 / 查金融牌照再动钱。

## 相邻路线转交

| 用户要做的事 | 转交给 |
|---|---|
| 公司税务筹划(分红/架构/优惠) | `caiyouyun-tax-plan-advisor` |
| 涉税风险自查(稽查信号) | `caiyouyun-audit-redflag-check` |
| 政策效力核验 | `caiyouyun-policy-validity-check` |
| 具体投资/投保方案 | 持牌投资/保险顾问(本包不替代) |

## 可直接复制的说法

```text
把这份理财主题清单跑一遍科普生成。
每张卡给我:政策依据、核心要点、操作步骤、风险提示、红线。
不荐股、不承诺收益、不荐具体产品,只做科普与提醒。
先跑预览,我确认了再加 --execute。
```

## 做完怎么算完成

- [ ] 每个主题都给到了**政策依据 + 要点 + 操作 + 风险 + 红线**
- [ ] 异常表里的「须人工判断」项已逐条处理或有明确去向
- [ ] 明白本包是**科普提醒**、不是投资建议
- [ ] 校验表「条目守恒」对得上
- [ ] 输出未出现任何具体标的/产品/收益承诺

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

| 文件 | 内容 | 何时读 |
|---|---|---|
| `references/01-legal-basis.md` | 各主题政策依据与口径来源 | 需要核对依据时 |
| `references/02-decision-table.md` | 主题匹配口径、红线含义、边界情形 | 需要确认判定逻辑时 |
| `references/03-verification-checklist.md` | 使用前置清单 + 高风险情形 | 自查前准备、事后复核 |

> 这三份是**科普口径与政策来源**,不是投资建议库——具体配置以持牌顾问与监管最新口径为准。

## 输出规范

- **交付形态**:执行结果 + 变更清单,说清动了什么、没动什么。
- **必含字段**:执行前状态 / 执行动作 / 执行后状态 / 失败项与原因 / 回滚方式。
- **留痕**:产生副作用的执行必须写留痕文件(manifest / log),可回溯。
- **自检**:失败项未列原因,或无可回滚路径,视为未完成。

## 免责声明

本技能输出的是**理财科普与风险提醒**,不构成任何投资建议、税务意见或法律意见,
**不荐股、不承诺收益、不荐具体产品**。具体配置须咨询持牌投资/保险顾问,
并以监管与机构最新口径为准。因使用本提示产生的任何后果,由使用者自行承担。

---

版本:v0.1.0 · 出品:【财友云】 · 规则版本:2026.10

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

| ❌ 反例 | ✅ 正例 | 判据 |
|---|---|---|
| 「这款理财年化 5%,闭眼买」 | 只讲风险等级(R1–R5)与匹配逻辑,不写具体收益 | 有没有承诺收益 |
| 「买 XX 银行 XX 产品最划算」 | 不指定品牌,讲机制与对比维度 | 有没有荐具体产品 |
| 「这只股票必涨」 | 本包不覆盖个股,转持牌顾问 | 有没有荐股 |
| 未收录主题编一张卡 | 进异常表标「须人工判断」 | 用户能否看出这条没把握 |

<!-- 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 / 合规声明 / 必备章节 / 打包卫生 / 脚本可编译 / 入口脚本 `--help` 可运行。

## 退出码(脚本契约)

| 码 | 含义 | 你要对用户说的话 |
|---|---|---|
| 0 | 成功 | 直接给结果,不解释过程 |
| 2 | 输入错误 | 「你给的 <X> 不对,需要 <Y>」 |
| 3 | 鉴权/授权失败 | 「需要你先提供 <凭据>」 |
| 4 | 服务/环境失败 | 「这一步依赖 <X> 不可用」 |
| 8 | 部分成功 | 「N 项成功、M 项失败」,逐条列出失败项 |

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

## 状态与断点

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

常见问题

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

财务人理财科普 这个技能,具体能帮我做什么?

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

常见的触发场景有:理财科普、个人理财、个税汇算怎么弄。

完整说明、版本记录和安装方式在 SkillHub 上的「财务人理财科普」页面 →。

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

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

1.理财科普_主表.csv逐条:主题 / 政策依据 / 核心要点 / 操作步骤 / 风险提示 / 红线
2.理财科普_异常表.csv未收录主题(须人工判断)
3.理财科普_校验表.csv核验口径 / 知识库条目 / 版本 / 重要声明 / 条目守恒校验
有没有算不了、它明确拒绝的情况?

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

·缺「主题」列:拒绝(RC=2),列出可用别名
·行内无主题描述:该行进异常表(高),不猜

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

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

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

·科普 ≠ 建议。本包只讲「机制、依据、风险、红线」,不给「你该买什么」。
·不承诺收益。任何「年化 X%」「稳赚」都违反红线,本包输出里不会出现。
·不荐股不荐产品。涉及具体股票/基金/银行/保险/理财品牌,一律不提。
跑完的数能不能直接用?我还要核什么?

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

·本包输出是科普与风险提醒,不是投资建议,不能作为任何投资/投保决策依据;
·具体配置(买哪只、投多少、如何组合)须咨询持牌投资/保险顾问;
·涉及税务办理,以主管税务机关当年公告与口径为准;
数据会不会传出去?我自己怎么验证?

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

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

打开包里的 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 数据

出口退税测算与勾稽核查

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

规划中 P2 数据

表格→分析报告

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

规划中 P2 数据

从零构建工作簿

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

规划中 P0 数据

多表批量合并

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

规划中 P2 数据

中小企业划型判定

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

规划中 P2 数据

AI 可读性诊断

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

规划中 P2 数据

公式解释器

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

规划中 P0 数据

财务数据脱敏采样

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

规划中 P0 数据

财务明细表清洗标准化

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