用途:当已算好税务数字、需要填写 IRS PDF 税表(如 Form 1120),或在改值后重新生成已填 PDF、发现新版税表字段名时使用。
主要能力:从空白可填写 PDF 中提取全部 widget 字段建立字段映射;通过文本标签坐标关联字段与行号;按字段名后缀填写文本与勾选框;生成后回读并交叉校验关键勾稽关系(Schedule L 资产=负债+权益、M-1 第10行=第1页第28行、M-2 期末余额=Schedule L 留存收益、应税所得×21%=税额、第1页第11行-第27行=第28行)。
使用方式:先安装依赖 uv pip install pymupdf(提供 fitz 模块),准备 IRS 空白可填写 PDF(如 irs.gov/pub/irs-pdf/ 的 f1120.pdf)和含全部计算值的 YAML 事实源。字段发现用 fitz.open 后遍历 page.widgets() 打印 field_name、field_type、rect;勾选框用 w.button_states() 查看可用状态。填写脚本按后缀匹配字段并设置 field_value 后 update()。输出目录建议 taxes/YYYY/,含空白表、填写脚本、已填 PDF、事实源 YAML 和填写指南。
限制与注意:字段名随每年税表修订变化,必须重新发现;Schedule L 行号逐年变动,需对照实际 PDF 核实;勾选框 on 值不一定是 "1";M-2 期末余额必须等于 Schedule L 留存收益,否则账面净利计算有误;现金为负时 Schedule L 第1行填 0,透支额移至第18行其他流动负债;fill() 按后缀匹配,跨页同后缀时需谨慎指定 page_idx。具体收费、平台支持等信息暂未提供。