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。
• 智能分类：利用交易元数据（付款方、金额、日期等）和自定义提示词来确定分类。
• 网络增强上下文：可在线搜索商户信息，提升对不常见企业的分类准确性。
• 自动创建分类：可智能建议并创建新分类，适用于当前分组无法匹配的交易。
• 安全优先：包含“干运行”模式，仅记录建议变更而不修改实际预算数据。