个人所得税年度汇算申报辅助程序
Overview
本技能把"个人所得税综合所得年度汇算"做成一套可计算的辅助工具：录入收入、免税收入与各项扣除（基本减除、专项扣除、专项附加扣除、其他扣除），自动算出应纳税所得额、应纳税额、应退/补税额，并生成标准化申报表。内置录入校验 + 合规性检查，对房贷房租互斥、扣除超限、大病医疗口径、捐赠上限等常见错误实时提示。支持 JSON 数据导入/导出与结果汇总展示。
技能定位：政策合规的辅助测算器，不替代自然人电子税务局的正式申报，最终以税务机关核定为准。
When to Use
- 用户问"我今年个税能退多少/要补多少""帮我算个税汇算"。
- 用户要录入/核对 专项附加扣除、三险一金、收入构成。
- 用户要生成一份标准年度汇算申报表（用于自查、存档、或对账）。
- 用户上传/提供 JSON/CSV 申报数据，要求计算或校验。
- 用户问"房贷和房租能同时扣吗""大病医疗怎么算""赡养/子女扣除上限多少"等合规问题。
How to Answer（应答工作流）
- 判定意图：测算 / 生成申报表 / 校验合规 / 解释规则 / 导入导出。
- 取数：
- 若用户已给 JSON，直接用scripts/cli.py calc -i <文件>计算；
- 若用户口头报数，先汇总成数据字典，写临时 JSON 再计算；
- 若用户无数据，引导用cli.py interactive逐步录入，或先template生成模板。 - 计算与校验：调用
tax_engine.compute()，读取返回的issues（error/warn/info 三级）与结果字段。 - 结构化输出：先给"结果汇总"（收入额、应税所得、税率、应纳税额、已缴、应退/补），再列合规提示，最后按需用
report.build()生成完整申报表（Markdown/HTML）。 - 合规提示必带：凡出现 error 级问题，必须明确告知用户"需修改后才能申报"；warn/info 级作提醒。
- 加免责声明：结尾注明"本结果为辅助测算，以税务机关核定为准"。
脚本调用约定
- 引擎：
scripts/tax_engine.py——compute(data)返回完整结果（含issues）；validate(data)仅返回问题清单。 - 报表：
scripts/report.py——build(result, data)返回{"markdown":..., "html":...}。 - 命令行（推荐）：
bash python scripts/cli.py template -o data.json # 生成空白模板 python scripts/cli.py calc -i data.json -f md -o 申报表.md python scripts/cli.py calc -i data.json -f html -o 申报表.html python scripts/cli.py check -i data.json # 仅校验 python scripts/cli.py interactive # 交互录入 - 运行器用隔离 Python：
C:\Users\HUAWEI\.workbuddy\binaries\python\versions\3.13.12\python.exe
数据 schema（要点）
{
"tax_year": 2025,
"taxpayer": {"name": "张三", "is_resident": true},
"income": {"salary": 0, "labor_remuneration": 0, "author_remuneration": 0, "royalty": 0},
"tax_exempt_income": 0,
"basic_deduction": 60000,
"special_deduction": {"pension":0,"medical":0,"unemployment":0,"housing_fund":0},
"additional_deduction": {
"child_education":0,"continuing_education_degree":0,"continuing_education_vocational":0,
"critical_illness":0,"housing_loan_interest":0,"housing_rent":0,"elderly_care":0,"infant_care":0
},
"other_deduction": {"annuity":0,"commercial_health":0,"deferred_pension":0,"donation":0},
"annual_bonus": {"amount":0,"method":"separate"},
"prepaid_tax": 0,
"meta": {"children_count":0,"infants_count":0,"elderly_only_child":null,"rent_city_tier":0}
}
> meta 用于合规上限校验；未提供则跳过上限校验（仅做基础检查）。金额单位：元。
规则与限额
详见 references/tax_rules.md（税率表、7 项专项附加扣除限额、合规要点、办理时间）。应答具体数字前优先读该文件确保口径最新。
注意事项
- 互斥项：住房贷款利息 与 住房租金 不可同时扣。
- 口径时效：税率与扣除标准以最新政策为准；技能默认 2023 调整并延续至 2027 底口径。
- 不越界：本技能只做测算与合规提示，不代办真实申报、不收集敏感隐私用于外传。
- 捐赠/大病医疗：需用户填"可扣除额"而非"总额"，引擎已做提示。
