用途
该技能用于管理日本「故乡纳税」（ふるさと納税）的捐赠数据。当用户需要登记捐赠数据、读取捐赠收据、核对控除上限时使用。
主要能力
- 读取寄附金受领证明书（收据）图片，提取自治体名、都道府县、寄附金额、寄附日期、受领证明书编号等信息。
- 支持单张与多张收据的批量处理。
- 登记捐赠数据，并确认是否申请了「一站式特例」（ワンストップ特例）。
- 汇总捐赠：统计寄附自治体数与合计金额、所得控除额（合计减 2,000 日元）、一站式特例申请数。
- 估算控除上限，并在超过上限时显示警告。
- 说明与确定申告的关系及制度变更要点。
使用方式
- 首先读取
shinkoku.config.yaml配置（db_path、tax_year、furusato_receipts_dir）。若文件不存在，则引导执行/setup技能后结束。 - 读取进度文件（
.shinkoku/progress/progress-summary.md、.shinkoku/progress/01-setup.md等，存在时），避免重复向用户提问。 - 步骤1：确认文件存在（
import_data.py furusato-receipt --file-path PATH），读取收据图片。图片读取委派给对应的reading-技能（如/reading-receipt），并进行双重校验（两份独立读取结果比对）。比对 amount、date、municipality_name：一致则采用；不一致则向用户展示原图路径与两份结果，通过 AskUserQuestion 提供「采用 A / 采用 B / 手动输入」三选一。 - 步骤2：确认后以
shinkoku furusato add --db-path DB --input FILE登记。输入 JSON 格式包含 fiscal_year、municipality_name、amount、date、municipality_prefecture、receipt_number、one_stop_applied。登记时确认是否申请一站式特例。 - 步骤3：询问是否还有其他收据，有则重复步骤1~2。
- 步骤4：以
shinkoku furusato summary --db-path DB --fiscal-year YEAR [--estimated-limit N]汇总。若有收入信息，可用shinkoku tax calc-furusato-limit --input FILE估算上限。 - 步骤5：说明与确定申告的关系及制度变更。
- 输出引継书至
.shinkoku/progress/05-furusato.md，并更新.shinkoku/progress/progress-summary.md。
适用场景
- 整理与登记故乡纳税收据。
- 核对捐赠合计与控除上限。
- 准备确定申告时的寄附金控除申报。
限制与注意
- 副业需确定申告时，一站式特例无效，需在确定申告时全额作为寄附金控除申报。
- 控除上限的详细估算考虑住民税侧的控除与调整控除；住宅贷款控除的住民税控除部分未被考虑，适用者结果会偏小。
- 简易估算因所得税基础控除较大，会低估上限（令和8年分约差 1~2 万日元）。
- 制度变更：令和7年10月1日起，经门户网站的捐赠禁止积分授予（信用卡本身积分除外）；令和8年10月1日起适用寄附金活用可能额 6 成以上基准与地场产品基准严格化；令和9年中以后捐赠（令和10年度分住民税）住民税特例控除额设 193 万日元上限（仅影响合计所得 4,000 万日元以上高收入者）。
- 参考文件：
references/furusato-tax-rules.md（税制规则与计算式）、references/furusato-consultation-guide.md（上限额、返礼品、时机、咨询）。 - 后续步骤：以
income-tax技能计算所得税（寄附金控除自动反映）；若有其他控除（如医疗费控除）需先处理。