它到底解决什么

本文仅作技术交流，不构成任何投资建议。市场有风险，决策需谨慎。

账本总是一团乱，又不想把家底传到别人服务器？ 一款叫 Aurelio 的开源项目最近在 GitHub 上快速涨到 2700+ Star，它把"财富管理 + AI 顾问"整套搬到了你自己的电脑上：数据留在本地 SQLite，AI 部分可选、走你自己的 OpenRouter Key。它不替你做买卖决定，只帮你把"拥有什么、欠了什么、现金流怎么走"算清楚，再用大模型把全局讲给你听。下面从工程视角拆解它的架构、数据模型和推理设计。

市面上的记账与财富工具大多要求你把数据上传到厂商云。Aurelio 反过来：一切数据留在本人机器，AI 只是可选的"顾问"，而且用的是你自己的模型 Key。它的核心能力可以分成几块：

• 财富总览：银行、券商的现金，以及每个机构"某一天持有什么"的快照。
• 组合透视：每一笔持仓按市价重估，带成本、账面变动与定期回报。
• 穿透查看：你买的基金到底持有哪些国家、行业、公司与币种。
• 计划、房产与负债：定投计划、实物资产、以及为它们融资的贷款。
• 现金流与目标：收入、支出、储蓄率，以及每个目标需要的回报率。
• 问 Aurelio：一个能读你账本、能联网搜索、并把每条改动做成"卡片"等你确认的对话。

技术架构拆解

从工程结构看，Aurelio 是标准的本地前后端 + 本地数据库组合，没有中心化服务：

• 前端：React + Vite + Tailwind v4，开发态跑在 localhost:5173，生产构建后由后端直接托管。
• 后端：FastAPI，用 uv 管理依赖，数据全部落在 backend/data.db（SQLite 文件）；每次更新格式前，程序会先在旁边存一份备份。
• AI 顾问：通过 OpenRouter 调用你自己的 Key，默认模型是 Claude Opus 5.5，可在对话里换别的模型。
• 对话入口：Ask Aurelio 读取全部账本，提出改动时只生成"卡片"，真正的写入仍走和表单完全相同的路径——模型没有表单没有的后门。

这套设计的出发点很明确：数据不出本机，离线也能用，AI 是可插拔的增强，而不是必须的依赖。

数据模型拆解：锚点 + 事件

Aurelio 最硬核的地方，是它对"财富"的建模方式。它没有用"流水余额"那种容易算错的结构，而是定义了锚点（某日快照）+ 其后的事件（分类账）：

• 每个机构有一系列带日期的快照（snapshots），记录那天持有/现金的真实照片。
• 今天的状态 = 最新那张快照 + 所有严格晚于它的账本事件（买入、卖出、派现、平仓、转账）。
• 一张更新的快照到来，会重新锚定整个计算——这正是防止重复计数的关键。代码把这个"之后"的严格性写在一个地方（backend/app/dated.py）。
• 因此一个算错的数字，只可能来自"错照片"或"错事件"两种原因之一，不存在第三种可能，也没有需要你盲目信任的余额。

现金同理：一个现金锚点是某天的真实余额，程序用绑定到该机构的收支、流入流出、以及投资账本花掉或收回的钱，把它向前推算。

AI 顾问怎么推理

很多人担心"AI 会不会乱改我的账本"。Aurelio 的做法是把推理拆成三段，并且每一次写入都只是待确认的卡片：

• 分析者（盲评）：只读账本，找出异常与机会，产出初步观察清单。
• 知己（了解你）：结合你的目标与风险偏好进行辩论，给出反向意见与提醒。
• 综合者：只在争议点介入修订，最后告诉你"优先看什么"。

更细致的是"来源随每个数字传递"原则：一笔成本会标注是"记录"还是"估算"；一个价值带着它被确认的日期；一次换算带着所用汇率的日期。一个被程序自动记录的派现默认是毛额，当你用券商实际到账额去更正时，会同时把"估算"标记清除。税估计只放在总额旁边，永远不混入净值本身——它明确标注"估算"并展示所用税率，是辅助判断，而不是假装是一张税单。

还有一条很妙的防呆规则：每张提案都声明自己依赖什么数据，你确认时程序会重新算一遍，若任何底层数据变了就返回 409 拒绝。卡片不会因为市场波动而过期，只会因为"它赖以建立的数据变了"而失效。

AI 调用要花多少钱

AI 是可选的，本体完全免费。下面是项目方 2026 年 10 月的实测费用（默认 Claude Opus 5.5）：

可以看到，日常追问低至 0.02 美元左右一轮，一次完整的"分析者+知己+综合"大约 0.33–0.51 美元。对轻度使用来说，按量付费远比订阅制年费友好，而且 Key 和额度都在你自己手里。

本地优先 vs 云端 SaaS

把 Aurelio 和典型云端理财工具放在一起看，差异一目了然：

核心价值就三点：数据不出本机、完全离线可用、长期成本可控。代价是你得自己跑一行命令，并且 AI 需要自备 Key。

怎么跑起来

环境需要 Git、Node.js 22+、以及 uv。然后：

git clone https://github.com/LosaLosSantos/aurelio-finance.git
cd aurelio-finance
./start.sh --demo          # macOS / Linux，用虚构家庭数据体验
# Windows PowerShell:  .\start.ps1 -Demo

首次启动会在文件夹内安装依赖，并打开 http://localhost:8000。不带 --demo 则用自己的数据，账本就在 backend/data.db。启用 AI 只需把 backend/.env.example 复制为 backend/.env，填入 OPENROUTER_API_KEY。整个过程不需要注册任何第三方账号来存你的账本。

适合谁，以及一点提醒

Aurelio 适合这几类人：想看清自己全貌又介意数据上云的；想把持仓、基金穿透、现金流和目标放在一个本地面板的人；以及愿意用自有 Key 体验"AI 读账本"的工程师。它是 MIT 协议，代码和测试都在仓库里，状态以代码为准。

再次提醒：本文只讲技术架构与工具特性，不构成任何投资建议。Aurelio 本身也不替你做买卖决策——它把"模型提议、你来写入"写进了结构里。把它当作一个本地、透明、可审计的账本与透视工具，而非"自动赚钱机器"，才用对了地方。