衡仓

给有多个账户、多种币种的家庭:把资产汇总成一份账本,按进取、稳健、防守三类对照目标,一眼看出差多少。网页版可以不注册试用示例账本,用自己的账本需要注册登录;Android 应用已开源。

状态
在线· 三端可运行,Web 可不注册试用示例;Android 正式签名包与真机、实时行情尚未验收
更新
2026.10.14
技术
Kotlin · Jetpack Compose · FastAPI · React

试用示例(不用注册) ↗(在新窗口打开)

  1. Android 与 Web 录入
  2. 服务端账本计算
  3. 分币种与三桶快照
  4. 两端展示与确认

衡仓示例账本的总览页:总资产 233,600 元;进取、稳健、防守三类的实际占比为 19.0%、38.2%、42.8%,目标为 40%、40%、20% 在线示例的总览页:三类资产的实际占比对照目标,一眼看出偏离。数字全部虚构,改动不保存。

为什么做

管理账户、持仓和资金流时,如果每个页面各算一遍余额,总览和明细就容易对不上;跨币种、跨账户的时候,更难说清"这笔钱现在该放在哪一桶"。我做衡仓,是想让这些数字由服务端统一算一次,Android 应用和 Web 工作台读同一份结果。

方案

  • 一份账本快照:FastAPI 服务在同一个数据库读事务里取账户、持仓、流水和目标;Android 应用与 Web 工作台共用这份汇总,不再各算一遍。
  • 三桶规划:资产按进取、稳健、防守三类归置,配合目标配置、专款隔离、再平衡、风险红线和回撤阶梯来看当前结构。
  • 明确金额口径:现金余额由期初余额和流水算出,再与持仓市值合并;不同币种分别展示,缺汇率时不直接相加,金额在服务端按 Decimal 处理。
  • 截图识别后确认:持仓截图经用户确认后才送服务端解析并写入持仓,原图只在识别请求期间使用。
  • 失败边界可见:缺少价格、成本或真实行情接入时,界面显示估算或未配置状态,不把参考数据说成实时行情。
  • 不注册先试:未登录打开 Web 工作台,进入的是示例模式。一个虚构家庭的持仓和 6 个月资金流放在浏览器内存里,可以看三桶与目标的偏离、增改持仓和流水、调整目标比例,也能用内置的示例截图走一遍“识别 → 核对 → 写入”。示例模式不向服务端发请求,刷新后恢复原样;账本汇总沿用服务端同一套取整规则。

衡仓示例里的截图导入:一张虚构的持仓截图,识别出三行持仓,逐行核对后再写入 示例里的“识别 → 核对 → 写入”:截图和识别结果都是预先准备好的,页面上也这样写明;用自己的截图需要先注册。

我负责的工作

设计三端共用的账本口径和业务接口;实现 Web 交互、Android 界面与服务端逻辑;统一账户、持仓、现金流和三桶配置的计算规则,并处理输入校验、版本冲突和行情刷新失败。

怎么验证的

“示例模式”一条是 2026-10-14 的本机结果;其余测试数字引用 2026-10-02 项目核对记录,没有重跑三端测试。2026-10-03 复核了 Android 开源仓库与 Web 公开入口,均可访问;公开页面可访问不等于登录与账本操作已通过端到端验收。

  • Android:Debug 构建通过,146 项 JVM 单元测试通过。正式签名的 APK/AAB 和真机安装升级尚未验收。
  • 服务端:生产镜像内 83 项测试通过,真实模型的合成持仓截图导入通过。行情目前是固定参考样本,界面明确标记为参考或过期数据,实时行情供应商尚未接入。
  • Web:2026-10-02 更新线上静态版本,生产构建与 lint 通过,12 项测试通过;线上英文隐私与条款页、API 就绪检查返回 HTTP 200,HTTP 会跳转到 HTTPS。
  • 示例模式(2026-10-14,本机):前端现有 39 项测试通过,其中 16 项针对示例模式,包括确认它不调用 fetch;用服务端源码里的账本函数对照 6000 条随机持仓和示例账本两个月的汇总,没有发现不一致;在 Chrome 里跑完 12 步浏览器验收,对 /api 的请求为 0。线上表现以后续验收记录为准。
  • 还没验证的:完整登录流程与语言偏好的端到端验收、真实持仓截图导入、正式证书链、行情同步,以及异地备份和监控;示例模式只在本机 Chrome 里验证过,Safari、Firefox 和真机未测。

现在做到哪

Android 应用已开源。Web 工作台已公开部署:不注册就能进入示例账本(数据全部虚构,改动不保存);用自己的账本需要注册登录。三端都具备持仓、资金流、三桶配置和截图识别能力。实时行情仍是参考数据,正式签名的应用包和真机验收还没做,因此这里同时写明已通过的部分和未验收的边界。

过程记录

回到产品列表