Actual Budget

💰 自托管预算 CLI 工具

通过 CLI 工具管理自托管 Actual Budget 实例,实现预算查询、交易导入导出、自动分类等个人财务自动化操作

收藏
12.4k
安装
3.9k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Actual Budget CLI 是一款面向自托管 Actual Budget 实例的命令行工具,通过 actual-budget-cli 命令实现完整的个人财务管理流程。

主要功能:

  • setup: 从配置文件批量创建账户和分类体系
  • export: 导出交易数据为 JSON 格式
  • import: 从银行导出文件(CSV/PDF)批量导入交易
  • categorize: 基于正则规则自动分类未分类交易
  • delete: 清空所有交易数据(破坏性操作)

配置驱动设计:通过 config.js 定义同步 ID、分类规则(支持 payee_name 正则匹配)、账户信息及自定义解析器。内置支持 Credit Suisse、DKB、ZKB、Interactive Brokers 等银行格式,同时允许扩展自定义解析器。

数据规范:金额以分为单位($50.00 = 5000),负数为支出、正数为收入。

显著优点

1. 自动化程度高:filter 函数支持灵活的正则匹配,实现交易智能分类
2. 银行生态完善:内置多国银行解析器,覆盖瑞士、德国主要金融机构

3. 自托管友好:专为 Actual Budget 自托管场景设计,数据完全可控

4. 可扩展性强:customParser API 允许处理任意格式的银行对账单

潜在局限

1. 技术门槛:需自行部署 Actual Budget 服务端、配置 Node.js 环境变量
2. 安全风险NODE_TLS_REJECT_UNAUTHORIZED=0 配置若滥用会削弱 TLS 安全

3. 破坏性操作:delete 命令无二次确认机制(文档仅建议人工确认)

4. 生态依赖: tightly coupled 到 Actual Budget 单一产品生态

适合人群

  • 已使用或计划自托管 Actual Budget 的技术用户
  • 需要批量处理历史银行对账单的重度记账用户
  • 追求数据隐私、不愿使用云端财务软件的用户

常规风险

  • 自托管实例的访问凭证(SERVER_PASSWORD)需妥善保管
  • import/delete 操作对财务数据有不可逆影响,建议操作前备份
  • 自定义 parser 的错误实现可能导致数据污染

Actual Budget 内容

暂无文件树

手动下载zip · 1.3 kB
contentapplication/octet-stream
请选择文件