核心用法
YNAB API Skill 是一套面向个人财务自动化的技术规范，涵盖预算管理的关键 API 操作与最佳实践。
交易管理：支持通过 REST API 创建、查询交易，强制使用 milliunits（千分之一单位）进行金额计算，避免浮点误差。提供完整的 curl 示例，包括认证、请求构造和 JSON 解析。
智能分类：核心原则是"绝不创建无分类交易"。遇到陌生商户时，自动检索历史交易记录，复用既往分类以保持数据一致性，减少用户手动干预。
防重复机制：创建新交易前检查待确认交易（unapproved transactions），避免与银行导入数据重复。
复杂交易处理：自动展开 Split（拆分）交易至子分类，确保报表准确性；标准化转账交易的收款人命名格式（Transfer: To/From [Account]）。
月度支出计算：支持自定义排除类别（如税款、报销、转账），聚焦可支配支出分析。
显著优点
- API 设计严谨：遵循 YNAB 官方 milliunits 规范，金额处理零误差
- 数据一致性优先：历史交易检索机制确保长期分类稳定
- 自动化友好：提供完整的 bash/curl 工作流，易于集成到定时任务
- 安全意识强：明确禁止硬编码密钥，推荐 600 权限配置文件
潜在局限
- 依赖环境配置：需手动设置
YNAB_API_KEY和YNAB_BUDGET_ID，无交互式配置向导 - 速率限制：约 200 请求/小时，大规模数据同步需自行实现退避重试
- 无内置缓存：每次查询直接请求 API，频繁操作可能触发限制
- 分类规则本地化：商户映射、排除类别等个性化配置需用户自行维护（JSON 或 Markdown）
适合人群
- 熟悉命令行和 REST API 的技术型用户
- 希望自动化 YNAB 数据录入的开发者/高级用户
- 需要自定义财务报告（超越 YNAB 原生功能）的数据分析师
常规风险
- API 密钥泄露：密钥暴露可能导致预算数据被读取或篡改
- 数据同步冲突：自动化脚本与 YNAB 移动端/网页端同时操作可能产生竞态条件
- milliunits 计算错误：金额单位误用（如输入 10 而非 10000）会导致 1000 倍误差
- 分类漂移：过度依赖历史分类可能将错误归类 perpetuate 到新交易