agentbudget

Agentbudget 是一个高精度、以代理为核心的命令行接口，专为零基信封预算设计。它让开发者和高级用户能够利用 SQLite 或 Turso/libSQL 数据库自动化管理个人财务。本工具采用 TypeScript 与 Drizzle ORM 构建，提供强大的架构来管理账户、信封、收款人与交易，并透过 JSON 输出机制聚焦于程序化自动化整合。

• 零基预算：强制执行严格的信封分配，确保每一分钱都分配到特定类别。

• 代理优先架构：主要接口支持 --json 参数，为大型语言模型代理或自动化脚本提供机器可读的数据。

• 灵活的后端：原生支持本地 SQLite 文件与远程 Turso (libSQL) 数据库，实现跨设备同步。

• 交易管理：内置收款人规则解析、多信封拆分交易支持以及详细的对账工具。

• 货币处理：提供智能转换与格式化支持，严格区分主要单位（输入）与次要单位（内部存储）。

• 排程与报表：内置概览指令，可可视化每月现金流、余额与最高支出类别。

• 输入格式：CLI 指令采用主要单位（例如 23.50），而 JSON 输出则以次要整数单位（例如 2350）提供，以避免浮点数误差。

• 安全性：使用标准环境变量（如 TURSO_DATABASE_URL 与 TURSO_AUTH_TOKEN）进行配置。

• 工作流程：典型用法包含初始化数据库、定义账户、设定币别，并透过 JSONL 文件进行批次交易导入。

• 错误处理：提供一致的 JSON 错误响应与状态码，适合构建稳定的自动化流水线。

• 限制：严格要求 Node.js 20+ 环境；透过 Drizzle 自动处理数据库迁移，确保数据完整性。