sakowicz/actual-ai

解決的問題

Actual AI 是 Actual Budget 的自動化交易分類工具。它利用大型語言模型（LLM）分析交易細節，並提出最合適的分類，從而消除手動為未分類交易分配類別的繁瑣工作。

工作原理

該應用程式連接到 Actual Budget 伺服器，識別出沒有類別的交易。它將交易的描述、金額和備註傳送給設定好的 LLM 提供商（如 OpenAI、Anthropic、Google 或 Ollama）。LLM 根據現有的分類結構對交易進行分類。

關鍵功能包括：

• 網頁搜尋整合：透過 ValueSerp API，系統可搜尋不熟悉的商家資訊，為 LLM 提供更佳的分類上下文。
• 分類擴展：若交易不符合現有分類，LLM 可建議並自動建立新分類。
• 排程運行：可依 cron 計畫執行或於啟動時執行，以保持預算資料的即時更新。
• 審核系統：所有猜測的交易會在備註中標記為 "guessed"，失敗的嘗試標記為 "not guessed"，方便使用者審查變更。

適用對象

希望自動化財務追蹤、減少手動交易分類時間的 Actual Budget 使用者。

主要亮點

• 多 LLM 支援：相容 OpenAI、Anthropic、Google Generative AI、Ollama、OpenRouter 和 Groq。
• 智慧分類：利用交易元資料（付款方、金額、日期等）和自訂提示詞來決定分類。
• 網路增強上下文：可線上搜尋商家資訊，提升對不常見企業的分類準確性。
• 自動建立分類：可智能建議並建立新分類，適用於目前分組無法匹配的交易。
• 安全優先：包含「乾運行」模式，僅記錄建議變更而不修改實際預算資料。