用途:面向加密货币交易活动,整理并生成美国监管申报所需的报表数据,覆盖联邦表格(IRS Form 8949、Schedule D)、FinCEN 海外账户申报(FBAR)、州级加密义务、大额交易标记与截止日期跟踪。
主要能力(现状):当前为 STUB 占位技能,已提供从交易数据生成 Form 8949 行项目的基础脚本(scripts/form_8949_generator.py),以及监管要求概览文档(references/planned_features.md),并带示例交易数据的演示模式。
规划能力:完整的 Form 8949 与 Schedule D PDF 生成、海外交易所账户超 1 万美元时的 FBAR 生成、州级申报要求检测与模板、申报阈值跟踪与截止日历、1 万美元以上大额交易标记、FATCA Form 8938、洗售检测与调整、成本基础方法选择(FIFO/LIFO/Specific ID/HIFO)、DeFi 事件分类(兑换、LP 进出、质押、空投)、IRS 兼容的 CSV/PDF 输出。
使用方式:演示脚本无需外部依赖,运行 python scripts/form_8949_generator.py --demo;生产实现需安装 uv pip install pandas reportlab。
适用场景:年终报税准备、季度预估税跟踪、FBAR 阈值监控、审计准备、多州申报。
限制:非税务或法律建议,须由具备加密经验的 CPA、EA 或税务律师审核;仅聚焦美国,不覆盖国际税务;规则频繁变化,可能未反映最新 IRS 通知;尚未处理复杂 DeFi 事件;洗售规则对加密是否适用尚无定论;演示仅实现 FIFO。美国联邦截止日期:Form 8949/Schedule D 为 4 月 15 日(可延至 10 月 15 日),FBAR 为 4 月 15 日(自动延至 10 月 15 日),Form 8300 为交易后 15 天,FATCA Form 8938 随税表,1040-ES 季度为 4/15、6/15、9/15、1/15。