Actual Budget

核心用法

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 CLI Skill 是一款纯 Markdown 文档型工具，旨在帮助用户通过命令行与自托管的 Actual Budget 实例交互。用户需首先配置环境变量（SERVER_URL、SERVER_PASSWORD）和 config.js 文件，定义账户、分类及自定义解析规则。主要功能包括：

• setup: 根据配置文件初始化账户和分类体系
• export: 导出交易记录至 JSON 文件，便于备份或外部分析
• import: 从银行导出文件（CSV/PDF）导入交易，支持 Credit Suisse、DKB、ZKB 等内置解析器
• categorize: 基于自定义过滤规则自动归类未分类交易
• delete: 清空所有交易数据（破坏性操作，需谨慎）

金额统一采用"分"为单位（$50.00 = 5000），负值为支出、正值为收入。

显著优点

1. 高度灵活：支持自定义解析器和分类规则，适配非标准银行格式
2. 本地优先：完全基于用户自托管服务，数据不经过第三方云端
3. 自动化友好：命令行设计便于与 cron 等调度工具集成，实现定期同步
4. 零代码风险：纯文档型 Skill，无可执行代码，无供应链攻击面

潜在局限

• 配置门槛：需自行搭建 Actual Budget 服务器并维护 SSL 证书
• TLS 配置陷阱：文档提及的 NODE_TLS_REJECT_UNAUTHORIZED=0 易被误用于生产环境
• 无实时同步：依赖手动或定时触发，非实时双向同步
• 社区维护：由个人开发者维护，长期支持稳定性存疑

适合人群

• 注重数据隐私、愿意自托管财务系统的技术用户
• 需要批量处理银行对账单、实现自动化记账的高级用户
• 已使用 Actual Budget 且希望扩展 CLI 工作流的现有用户

常规风险

1. 凭证泄露：config.js 可能包含服务器密码，需严格限制文件权限
2. 误操作数据丢失：delete 命令无二次确认机制，执行前务必备份
3. 自签名证书风险：开发环境的 TLS 绕过配置不可用于生产
4. 解析器兼容性：自定义正则匹配可能因银行格式变更而失效