Skip to content
vanvan-programPublic

About

Offline local-first Android couple travel expense tracker grouped by trip, with analytics, trip comparison, widgets & JSON/CSV export. | trip cent:按次分类的情侣旅行离线记账应用

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Repository files navigation

简体中文 | 繁體中文 | English

trip cent

按次(地点)分类的情侣旅行离线记账原生 Android 应用

Release Android Kotlin License

下载最新版 APK(v1.4.1) · 更新日志 · 第三方组件说明 · 问题反馈


项目定位

trip cent 是一款专为两个人记录每次旅行开支而设计的原生 Android 应用。全中文、完全离线、本地私有保存,无账号、无网络权限、无广告。

Tip

1.1.0 ~ 1.4.1 的逐版本更新说明已整理至 CHANGELOG.md。

核心功能

  • 按次(地点)独立归档:每次出行独立建账并支持自定义封面照片(压缩存至应用私有目录);首页以蓝色票券卡片展示最新旅行,历次旅行可在归档中检索查看。
  • 情侣三方收支记账:
    • 支持记录「支出」与「收入」(如奖金等),并区分三方来源:本人 / 伴侣 / 小荷包(设置中可自定义两人称呼,改名不影响历史统计)。
    • 支持最多 100 个自定义分类与安全删除分类(历史账单自动归入“其他”);支持单笔开关「计入日均计算」及预订机票等早于出发日的账单归属。
  • 开支分析与多旅行对比:
    • 单次旅行与「一起走过的旅程」汇总页均提供分类环形饼图与付款来源条形图,支持按付款来源筛选,账单默认按日期分组并支持按时间/金额升降序。
    • 「对比」页支持选择两次及以上旅行,一键切换总开支与日均开支对比。
  • 桌面 2 × 1 快捷小组件:采用柔光渐变圆角样式,配色随系统浅/深色自动切换,直接显示最新旅行并一键跳转记账。
  • 严谨的整数“分”统计规则:
    • 金额以整数“分”存储,避免浮点误差;天数包含首尾两日;日均仅统计勾选「计入日均」的支出;收入单独汇总,净花费 = 总开支 − 收入。
    • 小荷包作为独立第三付款来源仅计一次,不做存取流水、预算或 AA 欠款结算。
  • JSON v3 完整备份与 Excel 兼容 CSV 导出:
    • JSON 备份包含旅行、账单、收支标记、称呼、分类、外观与封面(兼容 v1 / v2),恢复前严格校验并在数据库事务内原子替换。
    • CSV 使用带 BOM 的 UTF-8 编码与中文表头,正确转义特殊字符与防公式注入,适合表格分析。

安装与使用

  1. 前往 GitHub Releases 下载 trip-cent-1.4.1.apk(支持 Android 8.0 及以上)。
  2. 已安装旧版的用户可直接覆盖安装以保留全部数据(切勿先卸载);自行构建的 APK 签名不同,切换前请先导出 JSON 备份。
  3. 使用流程:
    • 在「旅行」页点击「新建旅行」填写目的地与起止日期;
    • 进入旅行点击「记一笔」记录支出/收入、分类与来源;
    • 在「开支分析」与「对比」查看统计图表;
    • 在「设置」管理称呼、分类、浅/深色外观与完整备份。

数据与隐私

  • 全部数据保存在应用私有 Room 数据库中,无网络权限。
  • 卸载应用会清除本地数据,建议定期将 JSON 备份导出并保存在手机以外的安全位置。

技术栈与开发构建

  • 技术栈:Kotlin 2.0.21 · Jetpack Compose · Material 3 · Room 2.6.1(数据库 v3)· AGP 8.9.2 · Gradle 8.11.1
  • 环境要求:JDK 17 或 21 · Android SDK 35 · Build Tools 35.0.0
  • 核心模块:Models.kt(校验与统计)· Database.kt(持久化)· Backup.kt(JSON 备份与 CSV 导出)· TravelViewModel.kt · TravelUi.kt
# 使用项目构建脚本(优先复用本机 .tools 环境):
.\scripts\build.ps1
# 已缓存依赖时离线构建:
.\scripts\build.ps1 -Offline
# 在专用测试模拟器上运行设备测试(会清理模拟器内本应用数据):
.\scripts\build.ps1 -Offline -ConnectedTests
  • 其他环境可直接使用 Android Studio 打开根目录,或通过 Gradle Wrapper(.\gradlew.bat / ./gradlew)执行构建与测试。测试结果与截图见 docs/验收记录.md。

开源协议

自 1.1.0 起源码、项目文档与应用图标采用 MIT License 开源;第三方依赖许可说明见 THIRD_PARTY_NOTICES.md。

About

Offline local-first Android couple travel expense tracker grouped by trip, with analytics, trip comparison, widgets & JSON/CSV export. | trip cent:按次分类的情侣旅行离线记账应用

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages