用途：根据用户提供的源文档（W-2、1099、往年申报表、CSV）准备联邦和州所得税申报，并填写官方 PDF 表格。工作目录分为 source、work、forms、output 四个子目录。
主要能力：提取源文档数据（PDF 用 pdfplumber，CSV 用 Read 工具）；按年份查询 IRS.gov 与 FTB.ca.gov 的最新税率、标准扣除额、抵免；计算联邦申报（总收入、AGI、应税收入、QDCG 工作表、抵免、退税/欠税）；计算资本利得（Form 8949 与 Schedule D，含 3000 美元亏损限额与结转）；计算加州 Form 540；下载空白 PDF（往年 IRS 用 /irs-prior/，加州用 ftb.ca.gov/forms/YEAR/）；用 discover_fields.py --compact 发现字段并填写；用 verify_filled.py 校验。
使用方式：先创建目录，再按工作流执行。强制步骤 2 须向用户确认申报身份、受抚养人、居住州、扣除方式、数字资产交易、健康保险（加州）、已缴预估税及其他抵免，未确认不得进入下一步。提交前需核实下载文件含 %PDF- 头。关键命令如 python scripts/discover_fields.py forms/f1040_blank.pdf --compact > work/f1040_fields.json 与 python scripts/verify_filled.py output/f1040_filled.pdf work/expected_f1040.json 保持原样。
适用场景：个人联邦及加州州税申报，含资本利得、已婚合并申报与单身对比分析。
限制：不读取 PDF 原文（避免上下文膨胀），不重复读取同一文档；字段名逐年变化须重新发现；8949 与 Schedule D 保留精确到分，1040 与 CA 540 四舍五入到整美元；IRS 字段需加 [0] 后缀；复选框需同时设置 /V 与 /AS；加州字段名为 540-PPNN 且单选按钮用命名 AP 键；申报表须签名，未签名会被拒收。其他州、收费、价格、平台支持情况暂未提供。