命令行掌控个人财务

基于社区维护的 YNAB CLI 工具，通过官方 API 实现预算、账户、交易的全流程管理，帮助用户高效掌控个人财务数据。

基本信息

• 技能名称?ynab
• 中文名称?命令行掌控个人财务
• 作者?obviyus
• 分类?效率
• 版本?2.5.0
• 标签?finance-accounting, productivity, automation, api, cli

使用方法

使用说明
核心用法
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 包由社区维护，更新频率和长期支持存在不确定性。