Tax Pilot · 个税年终奖计税优化

个税年终奖计税优化技能。零依赖 Python 引擎，输入 CSV（一行一人）即可输出 JSON / Markdown / 自包含交互式 HTML 三件套报告。

何时使用

• 用户问「年终奖怎么发最省税 / 个税怎么算 / 年终奖单独还是合并计税 / 个税筹划」
• 需要比较年终奖「单独计税」与「并入综合所得」两种方案
• 需要找到使总税负最小的最优年终奖分配

输入格式

CSV 文件，中文表头，一行一人（单位：元/月；年终奖为全年一次性金额）：

月薪,社保月缴,专项月,年终奖
30000,4500,2000,200000

字段：
- 月薪：月工资收入
- 社保月缴：五险一金月缴额
- 专项月：专项附加扣除月额
- 年终奖：全年一次性奖金

运行

cd /workspace/tax-pilot
python3 scripts/analyze.py --input examples/income.csv --out examples/report/ --name "2026 个税筹划"

引擎退出码 0 表示成功，三件套生成于 --out 目录：
- report.json：结构化计算结果（含最优分配扫描序列）
- report.md：可读 Markdown 报告
- report.html：自包含交互式报告（内联 CSS/JS，SVG 作图，离线可渲染）

计算逻辑

1. 全年综合应税 = max(0, (月薪 − 5000 − 社保月缴 − 专项月) × 12)
2. 综合个税 = 综合所得（年）累进税率计算
3. 方案 A（年终奖单独）：综合个税 + 年终奖单独计税税
4. 方案 B（并入综合）：综合个税(含年终奖) ，奖金个税=0
5. 最优分配扫描：总薪酬 = 月薪×12 + 年终奖（固定）。遍历奖金 b∈[0,总薪酬]（步长 1000），月均=(总薪酬−b)/12，对每个 b 取 min(单独, 并入) 的总税，选总税最小的 b*
6. 输出方案 A/B 税额、推荐方案、最优奖金 b* 及相比「默认单独计税」的节税金额

关键约束

• 仅用 Python 3 标准库（csv/json/html/math/os/sys/argparse/datetime），禁止 pip install
• 不生成任何 PNG/JPG；所有图表使用 SVG
• HTML 自包含，禁止任何外部 URL/字体/CDN

详见 references/methodology.md。