终端掌控每一笔预算 - Manage YNAB budgets, accounts, categories, and transactions.

YNAB CLI 允许开发者通过命令行直接管理预算、账户、分类和交易，适合自动化财务工作流与脚本集成。

基本信息

• 技能名称?Manage YNAB budgets, accounts, categories, and transactions.
• 中文名称?终端掌控每一笔预算
• 作者?obviyus
• 分类?专业技能
• 版本?1.0.0
• 标签?finance, budgeting, cli, automation, api-client, accounting

使用方法

使用说明
核心用法
YNAB CLI 是基于 Node.js 的命令行工具，封装了 YNAB（You Need A Budget）的官方 API，提供完整的预算管理功能。用户通过 npm i -g @stephendolan/ynab-cli 安装后，需配置 YNAB_API_KEY 环境变量或执行 ynab auth login 完成认证。
工具采用层级命令结构：
预算层 ： ynab budgets list/view/set-default 管理多预算切换
账户层 ： ynab accounts list/view/transactions 查看账户余额与流水
分类层 ： ynab categories list/budget 支持按月份调整预算金额
交易层 ：完整的 CRUD 操作，含高级筛选（ --approved=false 、 --min-amount ）、搜索（memo/payee）及拆分交易功能
原始 API ： ynab api GET/POST 提供底层访问能力
数据输出默认为格式化 JSON，可用 --compact 获取精简格式。
显著优点

1. 零 GUI 开销 ：纯 CLI 设计，服务器/CI 环境友好
2. 交易自动化 ：支持程序化创建、拆分、批量更新交易，适合报销处理、定期记账脚本
3. 灵活筛选 ：多维度查询（账户、日期范围、金额阈值、审批状态、备注关键词）
4. 直接预算调整 ：可命令行修改分类月度预算，便于快速重新分配资金
5. 标准 API 兜底 ： ynab api 子命令弥补封装未覆盖的端点
   潜在缺点与局限性
   只读限制 ：无法通过 API 创建新分类、分类组或收款人，需先在 YNAB Web/App 中手动创建
   速率限制 ：200 请求/小时，高频自动化场景需自行实现限流与重试
   货币处理风险 ：工具以"预算货币单位"直接操作，而非 YNAB 内部使用的 milliunits，虽提升可读性，但大额计算需注意浮点精度
   无内置缓存 ：重复查询相同数据将消耗 API 配额
   Node 依赖 ：需维护 Node.js 运行时环境
   适合人群
   习惯终端操作的 YNAB 重度用户
   需将财务数据同步到其他系统的开发者（如自建报表、Excel 自动化）
   希望编写报销脚本、定期转账记录的自动化爱好者
   在 headless 服务器上运行财务巡检的运维人员
   常规风险
6. API 密钥泄露 ： YNAB_API_KEY 需妥善保管，误提交到代码仓库将暴露完整预算读写权限
7. 误操作交易 ： delete 、 update 无二次确认，脚本错误可能导致数据丢失
8. 速率超限 ：自动化脚本未限速将触发 429 错误，中断服务
9. 预算数据同步延迟 ：API 数据与官方 App 可能存在短暂不一致，高频对账场景需注意