actual-budget

Actual Budget是一款开源的个人财务管理工具，支持自托管部署，而这个Skill提供了官方Node.js API的完整使用指南，帮助用户以编程方式管理个人财务数据。作为纯文档型资产，它详细记录了从环境配置到高级查询的全流程操作方法，让用户能够在保障数据主权的前提下，实现预算管理的自动化与智能化。

核心用法围绕@actual-app/api包展开，用户需配置ACTUAL_SERVER_URL、ACTUAL_PASSWORD和ACTUAL_SYNC_ID等环境变量以连接自托管实例。Skill支持预算查询（getBudgetMonth）、账户管理（createAccount、getAccountBalance）、交易操作（importTransactions、updateTransaction）以及分类和规则设置。特别值得一提的是ActualQL查询系统，它提供了类MongoDB的查询语法，支持复杂的数据聚合与筛选，如按类别汇总支出、搜索特定商户交易等，满足高级数据分析需求。

该Skill的显著优点在于其安全透明与功能深度的平衡。作为纯文档型技能，无代码执行风险，所有操作均需用户在本地环境中主动调用。依托Actual Budget官方API，功能覆盖全面，包括银行同步（GoCardless/SimpleFIN）、定期计划（Schedules）、自动分类规则（Rules）以及分拆交易（Split Transactions）处理。数据完全存储于用户自托管的服务器，避免了第三方云服务的数据隐私风险，特别适合对财务隐私要求极高的用户。

然而，该Skill也存在明显的局限性。首先，使用门槛较高，需要用户具备Node.js开发能力，并能独立部署维护Actual Budget服务器。配置过程涉及多个敏感环境变量，若管理不当可能导致凭证泄露。其次，来源为T3级个人开发者，虽然文档内容基于官方API，但缺乏企业级维护保障。此外，所有财务操作均为编程式，无图形界面缓冲，误操作可能直接影响预算数据，要求用户具备严谨的数据备份习惯。

该Skill最适合具备技术背景的开发者、重视数据隐私的自托管爱好者，以及需要自动化财务处理流程的高级用户。例如，可配合定时任务实现自动账单导入、预算超支预警或生成自定义财务报表。对于普通用户或非技术背景的财务管理者，建议先使用Actual Budget的Web界面熟悉系统，再考虑通过此Skill进行自动化扩展。

使用过程中需特别注意以下风险：环境变量中的ACTUAL_PASSWORD和ACTUAL_SYNC_ID为敏感凭证，必须使用安全的密钥管理方式（如.env文件或密钥管理服务），避免硬编码或提交至版本控制。自托管服务器需配置有效的TLS证书，文档明确警告不要禁用TLS验证以防中间人攻击。批量导入或更新交易前，务必做好预算数据备份，因为API操作直接作用于底层数据，无撤销机制。此外，确保Actual Budget服务器版本与API客户端版本兼容，避免因版本差异导致的数据同步异常。