YouHao

项目概述

油迹（Fuel Track）把加油、里程和花费整理成真正有用的驾驶数据。它不依赖中心化账号：Web 与 Android 都把数据保存在本机，需要跨设备时，再同步到你自己的 WebDAV 空间。项目目前处于早期开发阶段（0.1.x）。

主要功能

• 看清真实油耗：基于连续满箱区间计算，支持部分加油，不用估算表显数据
• 数据属于自己：Web 使用 SQLite WASM，Android 使用原生 SQLite；离线也能完整使用
• 同步不整库覆盖：按记录更新时间合并，结合 UUID、软删除与 ETag 冲突重试
• 一套体验，多端运行：Vue 3 界面通过 Capacitor 同时服务桌面 Web、移动 Web 与 Android
• 多车辆独立账本、满箱区间油耗、月度与累计费用、油耗趋势图
• WebDAV 双向合并、JSON 完整备份、CSV 报表导出
• 响应式桌面侧栏、移动端底部导航

适用人群

• 需要记录车辆油耗的用户
• 拥有多辆车需要独立账本的用户
• 需要跨设备同步油耗数据的用户
• Web / Android 用户

快速上手

1. 需要 Node.js 20+ 与 npm
2. 克隆仓库：git clone https://github.com/GayFirends/YouHao.git
3. 安装依赖：npm install
4. 运行开发环境：npm run dev
5. 构建 Android 需要 Java 21

核心优势

• 本地优先，数据属于自己
• 按记录更新时间合并，不整库覆盖
• 支持 WebDAV 同步到坚果云、Nextcloud、群晖等
• 一套代码同时服务 Web 和 Android

系统要求

• 操作系统：Web / Android
• 额外依赖：Node.js 20+、npm；Android 构建需要 Java 21