Actual预算管理

技能简介

通过官方Node.js API连接Actual Budget自托管实例，实现预算查询、交易导入导出、账户管理、分类标记、规则配置、定期账单及银行同步等操作。

业务背景

在个人对话环境中直接操作Actual Budget自托管实例，实现预算查询、交易管理和财务规则配置。帮助业务人员随时掌握资金状况，自动化处理重复性财务操作，减少手工记账负担，提升个人财务管理的及时性和准确性。

落地案例：自由职业者月底通过对话查询各分类支出占比，发现"办公设备"超支后调整下月预算额度；随后批量导入本月银行流水，系统自动去重匹配收款人并标记分类，最后设置定期账单规则使房租、软件订阅等固定支出自动入账，大幅缩减月度对账时间。

能做什么

• 查询月度预算余额与分类支出情况
• 批量导入银行交易并自动去重
• 创建和管理账户、分类、收款人
• 设置预算金额与结余结转规则
• 配置自动分类规则与定期账单
• 执行GoCardless/SimpleFIN银行同步
• 使用ActualQL进行复杂数据查询

使用说明

1. 安装依赖
   npm install @actual-app/api
2. 配置环境变量
   设置ACTUAL_SERVER_URL（服务器地址）、ACTUAL_PASSWORD（登录密码）、ACTUAL_SYNC_ID（预算同步ID，从设置→高级获取），可选ACTUAL_ENCRYPTION_PASSWORD（端到端加密密码）和ACTUAL_DATA_DIR（本地缓存目录）
3. 自签名证书处理
   将CA证书加入系统信任库，或设置NODE_EXTRA_CA_CERTS=/path/to/ca.pem
4. 初始化连接
   调用api.init()建立连接，使用api.downloadBudget()下载预算数据
5. 执行操作
   调用各类API完成查询或修改，最后务必执行api.shutdown()关闭连接

注意：金额以整数分存储（$50.00=5000），日期格式为YYYY-MM-DD，月份为YYYY-MM。

输入与输出

见下方输入与输出表格。

风险提示

• 避免完全禁用TLS验证，防止中间人攻击
• 妥善保管同步ID和加密密码，泄露可能导致财务数据暴露
• 批量导入前建议先备份预算数据
• 始终调用shutdown()释放资源，避免数据不一致

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/thisisjeron/actual-budget/SKILL.md
来源类型：GitHub仓库