Actual Budget

核心功能

Actual Budget API 是开源个人财务管理工具 Actual Budget 的官方 Node.js SDK，支持对自托管实例进行完整的预算数据操作。核心能力涵盖：预算查询与月份管理、账户创建与余额追踪、交易批量导入/导出（支持去重与规则自动分类）、类别与收款人管理、预算金额设定与结转、自动化规则引擎、周期性账单计划、以及 GoCardless/SimpleFIN 银行同步。

显著优点

1. 官方背书与生态完整：由 Actual Budget 官方维护，API 与产品功能同步更新，文档详尽
2. 自托管隐私优先：数据存储于用户自有服务器，支持端到端加密，避免第三方托管风险
3. ActualQL 灵活查询：类 MongoDB 的查询语法支持复杂聚合、过滤与分组，满足定制化报表需求
4. 自动化友好：完整的交易规则引擎与导入接口，适合构建自动化记账工作流
5. 银行同步原生支持：内置 GoCardless 和 SimpleFIN 集成，可直接拉取银行流水

潜在局限

• 技术门槛较高：需自行部署服务器、配置环境变量、处理 Node.js 依赖
• 自托管运维成本：需维护服务器可用性、备份策略与 SSL 证书
• 无官方云托管：相比 YNAB、Mint 等 SaaS 产品，缺少开箱即用的托管服务
• API 仅限 Node.js：无 REST/GraphQL 网关，非 JavaScript 生态集成需额外封装

适合人群

• 注重财务隐私的技术用户与开发者
• 希望自建自动化记账系统的个人或家庭
• 需要从 YNAB/Mint 迁移至开源方案的用户
• 愿意承担自托管运维成本以获得数据主权的进阶用户

常规风险提示

• 数据备份责任自负：自托管模式下数据丢失风险由用户承担，需建立定期备份机制
• 端到端加密密码不可丢失：启用加密后遗忘密码将导致数据永久不可恢复
• 自签名证书配置：内部网络部署时需正确配置 NODE_TLS_REJECT_UNAUTHORIZED，避免中间人攻击
• API 密钥与 Sync ID 安全：环境变量泄露将导致完整预算数据暴露，建议使用密钥管理服务

核心用法

Actual Budget API Skill 提供对开源个人预算管理工具 Actual Budget 的完整 Node.js API 封装。用户可通过环境变量配置连接自托管服务器，执行预算查询、交易管理、账户操作、分类规则设置及银行同步等核心功能。

关键操作包括：

• 预算概览：获取月度预算数据、收入可用额度
• 账户管理：创建/关闭账户、查询余额、处理账户间转账
• 交易处理：导入导出交易、自动去重、批量更新、支持拆分交易
• 智能规则：创建分类规则实现自动化记账
• 定期账单：设置周期性支出计划
• 银行同步：集成 GoCardless/SimpleFIN 自动同步银行数据
• ActualQL 查询：类 SQL 的灵活查询语言支持复杂数据分析

显著优点

1. 官方正统：基于 @actual-app/api 官方 npm 包，API 设计规范，文档完备
2. 功能完整：覆盖预算管理的全生命周期，从数据导入到智能分析
3. 隐私优先：自托管架构，数据完全自主可控，符合 GDPR/CCPA 合规要求
4. 自动化友好：支持规则引擎和银行同步，大幅减少手动记账负担
5. 查询强大：ActualQL 提供类似 SQL 的查询能力，支持聚合、过滤、分组

潜在局限

1. 部署门槛：需自行搭建 Actual Budget 服务器，技术门槛较高
2. 生态局限：相比 YNAB、Mint 等商业产品，第三方集成和移动端体验较弱
3. 货币限制：原生设计以美元/整数分为单位，多货币支持需额外处理
4. 同步依赖：离线修改需显式调用 sync()，网络不稳定时体验受限

适合人群

• 技术型用户：熟悉 Node.js 和自托管部署的开发者
• 隐私敏感者：不愿将财务数据交由第三方托管的用户
• 自动化爱好者：希望构建个性化财务工作流的高级用户
• 开源支持者：偏好开源、可审计的财务管理工具

常规风险

• 凭证管理：ACTUAL_PASSWORD 和 ACTUAL_ENCRYPTION_PASSWORD 需妥善保管，泄露将导致预算数据暴露
• 自签名证书：生产环境应避免设置 NODE_TLS_REJECT_UNAUTHORIZED=0，否则存在中间人攻击风险
• 本地缓存：ACTUAL_DATA_DIR 目录需设置适当权限，防止多用户环境下的数据泄露
• API 变更：Actual Budget 仍在活跃开发中，重大版本更新可能导致 API 不兼容