ynab

核心用法

YNAB CLI Skill 是一个命令行预算管理工具的封装器，专为 You Need A Budget（YNAB）用户设计。用户需先通过 npm 全局安装 @stephendolan/ynab-cli，并从 YNAB 官网获取个人 API 密钥完成认证。该 Skill 覆盖预算管理的完整生命周期：支持多预算切换与默认预算设置；账户层面可列出账户、查看余额及交易流水；分类预算支持按月设定金额并追踪支出；交易模块功能最为丰富，涵盖创建、更新、删除、搜索、拆分等操作，支持按账户、日期、金额、备注等多维度筛选；此外还提供收款人管理、月度概览、定期交易及原始 API 调用等高级功能。

显著优点

功能全面且专业：几乎覆盖 YNAB 网页版的核心功能，尤其适合习惯命令行的高效用户。交易搜索支持按备注、收款人名称模糊匹配，拆分交易功能可精细处理复杂消费场景。数据格式友好：金额直接以预算货币单位显示，无需处理 YNAB 内部的 milliunits 转换，降低使用门槛。输出灵活：提供 --compact 参数输出精简 JSON，便于脚本集成和数据处理。架构简洁：作为纯命令包装器，无额外业务逻辑，行为可预测，易于审计和排错。

潜在缺点与局限性

API 能力边界：无法通过 API 新建分类、分类组或收款人，需先在 YNAB 网页端完成基础架构搭建。速率限制严格：每小时 200 请求的上限对批量导入或高频查询场景构成瓶颈。错误处理依赖底层：Skill 本身不封装错误处理逻辑，异常信息直接透传 ynab-cli 的输出。无可视化能力：纯文本输出，需配合其他工具实现图表分析。环境依赖较重：要求 Node.js 环境和全局 npm 包安装，对非技术用户不够友好。

适合的目标群体

• 技术背景的 YNAB 重度用户，追求键盘驱动的效率体验
• 需要将预算数据集成到自动化工作流的开发者
• 偏好命令行工具进行批量数据操作的财务分析师
• 希望编写自定义脚本实现个性化预算报告的高级用户

使用风险

数据安全风险：transactions delete 和 update 命令对财务数据的修改不可逆，误操作可能导致预算记录丢失。密钥泄露风险：YNAB_API_KEY 以环境变量形式存储，在多用户环境或日志中可能意外暴露。服务可用性风险：超出 200 req/hour 限流后，所有操作将暂时中断，批量任务需设计重试和降速机制。依赖维护风险：底层 npm 包由社区维护，更新频率和长期支持存在不确定性。