# Trace

**Repository Path**: goushiiyun/trace

## Basic Information

- **Project Name**: Trace
- **Description**: Trace · 痕迹 —— Android 原生日记 App（Kotlin + Jetpack Compose + Room）。把「今天做了什么、花了多少钱」讲给 AI，自动生成日记、时间线事件、结构化支出三层数据；含动态朋友圈、回收站、月度统计、三星日历写入、局域网多设备自动发现双向同步。多 AI 接力开发，每次更新（新功能/问题修复）编译通过后都会推送至此仓库。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-08-16
- **Last Updated**: 2026-09-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Trace · 痕迹

一款安卓原生日记 App：**像聊天一样把"今天做了什么、花了多少钱"讲给 AI**，自动产出三层结果——

1. **Markdown 日记**（可复制、可导出 .md、可发给其他 AI）
2. **时间线事件**（确认后写入系统日历 `CalendarContract`，兼容所有品牌手机）
3. **结构化支出**（渠道 × 类别 × 时间，支持小票照片 AI 逐项识别）

> 本项目由多 AI 接力开发维护（qwen3.8max → QoderWork CN → DeepSeek Harness），完整开发历程见仓库内 `Trace-项目总览与开发计划.md`。

## ✨ 功能一览（当前 v0.44.0）

- **AI 自然语言解析**：一句话拆出事件 + 支出，确认卡片逐条核对后再入库；信息不全自动追问；账单照片逐项识别入账
- **日记**：手写 / AI 生成（简洁 / 温暖 / 幽默）/ AI 优化（旧版进回收站可恢复）、周报 / 月报 / 年报自动生成并存档；**v0.43 自动生成**：前一天日记在次日 15 点由 AI 自动写好（当天有数据且未手写才生成，设置→通用可关）
- **日历**：按日时间线 + 仿三星月历（农历 / 节日 / 节气红字、事件色条、长按添加日程）+ 系统日历只读区 + 搜索；时间线/日记/支出页均可左右滑切前一天/后一天（v0.43 修正：抽屉模式完全不挂横滑手势，日历/日记/支出页左缘均可呼出抽屉；底栏模式左缘不滑抽屉）；**长按日历/支出条目多选，批量改时间/加照片/改支付方式、批量删进回收站（v0.42）**
- **支出**：按日 / 按周 / 按月统计，消费热力图 / 类别饼图 / 每日折线 / 时段趋势，图表可自选显隐；新建支出预填当前浏览日期（v0.41）；设置可选仅一张照片时照片时间当开始还是结束
- **知识库**（开发中，仅开发者模式可见）：类 Obsidian 笔记，可手写 Markdown，也可让 AI 把一段话整理成笔记
- **计划**：便利贴白板，自由拖拽摆放，丢进垃圾桶还能捡回来
- **互动**：类微信朋友圈图文动态；**v0.39 多人 AI 互动**：Trace 助手永远优先首评，你在聊天里创建的人设 AI 也会错峰跟评；点任意 AI 的评论可弹窗单独回复它
- **聊天（全局 AI）**：能查也能改——可见事件/支出/互动/日记/知识库/报告（每条带 #编号），修改会以建议卡片呈现，你同意才执行；可发照片给它看；微信式会话列表，可自定义双方头像与聊天背景；逐字流式输出+随时停止（深度思考过程单独展示，不支持流式的网关可一键退回一次性返回）；**v0.39 人设系统**：➕新建人设对话（AI 名/用户名/双方头像/双方人设），Trace 助手为不可删除的固定主 AI，每个人设 AI 都同样拥有读改数据与记忆能力，支持默认直接打开新会话（v0.41 修正：进聊天自动接着上次对话带历史，新建只走➕）；**v0.40 会话三开关**：回复互动（朋友圈跟评）/AI 记忆（全局含互动场景）/查看或更改数据权限（关掉变纯问答），点顶部标题直接回会话列表；**上下文预算 K 值**（最高 400K）：历史超预算自动压缩成摘要，省钱防超窗；**v0.41 相册重做**：内置九宫格相册选图（系统相册权限，被拒回退系统选择器），头像方形框内拖拽缩放自己调不再自动剪
- **回收站**：事件 / 支出 / 日记 / 动态 / 报告 / 知识分类存放，可恢复或彻底删除
- **局域网双向同步**：自动发现同网设备，首次配对确认一次，之后免确认；相同跳过、改过更新、缺的补齐、删除进对方回收站
- **全量数据备份**：所有数据（含照片、AI 配置）打包成单个 JSON 文件导出；导入即整机恢复到文件那个版本，覆盖前自动留档
- **健康数据**（v0.44，需系统授权）：走 Google **Health Connect** 通道读三星健康等已接入平台的**睡眠时段与运动时段**（三星健康需先在 设置 → 连接到健康应用 开启同步），自动写成普通行程（「睡眠 7 小时 20 分」「跑步 43 分钟」），可照常改删且不重复写入；设置→通用 一键同步近 7 天，每 6 小时自动补今天与昨天；**只读这两项、不写回健康库、数据不出手机**（不读心率/位置，不上传不同步）
- **使用时长守护**（需系统「使用情况访问权限」）：别的 App 单次连续用超 20 分钟，弹窗建议把这段时间记成行程/日历（如「看视频 40 分钟 · 来源：抖音」，备注含连续时长与时间窗）；**v0.43 陌生 App AI 识类别**：内置表认不出的 App（如蛋仔派对）由 AI 一次性识别归类，设置→通用→应用使用类别可改可删
- **AI 花费估算**：设置页每个服务卡片展示本地 token 记账估算花费（内置免费显今日额度）；**v0.36 账本升级**：真实回传 token 逐笔记入 Room，新增「本月 AI 花费」明细卡，支持自定每百万单价·改价后历史重算·算不出标「费用未知」
- **AI 记忆库**（v0.38，需 设置→AI 服务 开启）：聊天几轮后后台自动把稳定偏好/人物关系/常去地点/生活规律沉淀为长期记忆，下次对话自动参考；助手可提议「记一条长期记忆」（确认才入库）；可逐条删/清空档案；只存用户特异事实，不上传不跨机
- **桌面小组件**：今天速览 / 月度支出 / 日历 / AI 助手，背景透明、外观可自定义
- **四套主题**：晨雾 / 奶油纸 / 莫兰迪 / 墨夜，可跟随系统深色模式；自定义背景图/视频+透明度可调，背景失效自动恢复默认底色（磨砂玻璃/噪点/高光效果已在 v0.40 按用户反馈移除，界面回到干净底色）

## 🛠 技术栈

| 项 | 值 |
|---|---|
| 语言 | Kotlin 2.0.21 |
| UI | Jetpack Compose（BOM 2024.09.03）+ Material 3 |
| 数据 | Room 2.6.1（数据库 v14，全表全局 uid，支持多设备合并同步；v12 增 AI token 逐笔账本，v13 增记忆库三表，v14 动态表增人设 AI 跟评队列列（均本机不同步）） |
| 网络 | OkHttp 4.12.0（AI 调用 / 局域网同步） |
| 构建 | Gradle 8.9 / AGP 8.7.3 / JDK 17 |
| 健康数据 | androidx.health.connect:connect-client 1.1.0-beta01（只读；稳定版 1.1.0 要 compileSdk 36 + AGP 8.9.1，会顶坏当前基线） |
| minSdk / targetSdk | 26 / 35 |
| 当前版本 | v0.44.0（versionCode 48） |

## 🚀 构建

```bash
# Windows 命令行（脚本内置 JDK 17，自动进入工程目录；因目录含中文需 gradle.properties 的 android.overridePathCheck）：
..\compile-trace.bat :app:assembleDebug

# 或在工程根目录手动：
./gradlew :app:assembleDebug

# 产物路径：
app/build/outputs/apk/debug/app-debug.apk
```

## 🔒 数据与隐私

- 全部数据存储在本机（Room 数据库 + App 内部存储），**不收集、不上传任何个人数据**
- 系统日历同步仅在授权后写入专属日历「Trace · 痕迹」，可随时关闭
- 局域网同步是两台手机**直连传输**，不经过任何服务器
- App 永久免费、无广告、开源

## 📦 开源协议

[木兰宽松许可证，第 2 版（Mulan Permissive Software License, Version 2）](http://license.coscl.org.cn/MulanPSL2)

## 📚 仓库内文档

| 文档 | 说明 |
|---|---|
| `Trace-项目总览与开发计划.md` | 项目全貌、功能清单、踩坑清单、更新日志（每棒必更新） |
| `Trace-多AI接力汇总.md` | 各 AI 接力开发时间线 |
| `Trace-项目交接报告.md` | 早期交接报告（部分内容已过时，以总览文档为准） |
| `时间线日记App设计方案.md` | 产品设计文档 v0.4 |