YNAB CLI 允许开发者通过命令行直接管理预算、账户、分类和交易，适合自动化财务工作流与脚本集成。
说明：
## 核心用法
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 服务器上运行财务巡检的运维人员
## 常规风险
1. **API 密钥泄露**：`YNAB_API_KEY` 需妥善保管，误提交到代码仓库将暴露完整预算读写权限
2. **误操作交易**：`delete`、`update` 无二次确认，脚本错误可能导致数据丢失
3. **速率超限**：自动化脚本未限速将触发 429 错误，中断服务
4. **预算数据同步延迟**：API 数据与官方 App 可能存在短暂不一致，高频对账场景需注意
会员专属
