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 自動處理資料庫遷移，確保資料完整性。