# Steps

**Repository Path**: popokaikai/Steps

## Basic Information

- **Project Name**: Steps
- **Description**: Steps · 纯本地多功能生活助手（计步/运动/地图轨迹/统计/饮食/心情/专注/生活/音乐/NFC）
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-17
- **Last Updated**: 2026-10-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Steps · 纯本地多功能生活助手

一款**数据只留在本机**的 Android 健康/生活 App：计步、运动、地图轨迹、统计、
饮食身体、心情习惯、番茄钟、生活提醒、音乐伴侣、NFC 读写、桌面小部件。

- 包名：`pk.steps`   语言：12 种（英/简/繁/日/韩/西/葡/法/德/意/俄/阿）
- 最低系统：Android 14（minSdk 34，targetSdk 34，compileSdk 36，Java 17）
- 依赖：仅 AndroidX（core / appcompat / constraintlayout）+ Material Components
- **不上传任何数据**，无广告、无统计 SDK

## 功能

| 模块 | 说明 |
|---|---|
| 健康首页 | 环形步数、7 天柱状、体重/BMI 折线、睡眠、饮水、自然语言记录 |
| 运动 | 6 类运动按 MET 估算热量 + 运动记录 |
| 统计 | 周/月/达标分析、14 天与 8 周图表、明细列表 |
| 饮食身体 | 三餐热量、体重/血压/血糖/心率 |
| 心情习惯 | 心情 5 档、自定义习惯连续天数、**16 枚勋章** |
| 专注 | 25/45/60 分钟番茄钟（通知 + 震动 + 语音） |
| 生活 | 纪念日倒数、提醒、闹钟、屏幕时间 |
| 地图 | 大陆用**高德 Web JS API**，海外用 **Google 瓦片**；GPS 轨迹 + 三层漂移过滤 |
| 音乐 | 媒体会话/广播读取歌名歌手、在线歌词（LRCLIB）、可滑动歌词、播放器来源可切换 |
| NFC | ReaderMode 读写 NDEF（未格式化卡自动 format） |
| 设置 | 单位/目标/语音/久坐/悬浮球/数据导入导出/12 语言/法律信息/检查更新 |

## 构建

```bash
# 需要 Android SDK（AndroidIDE 或 Android Studio）
./gradlew :app:assembleDebug
```

商店素材：`store/icon_512.png`、`store/icon_512_round.png`。

## 目录

```
app/src/main/java/pk/steps/
├── data/        数据库（16 张表）、DAO、通用 Store
├── logic/       纯逻辑：Calories/Bmi/Units/Lrc/DriftFilter/StatsEngine/MedalEngine/
│                LyricsClient/MusicApps/Region/UpdateChecker/SystemTranslate
├── model/       DayStep / HourLog / Workout / Medal
├── page/        12 个功能页（Page 框架 + Host 接口由 MainActivity 实现）
├── service/     计步前台服务、音乐媒体会话监听、悬浮球
├── receiver/    提醒/闹钟广播
├── ui/          Ui 构件、Page 基类、环形/柱状/折线图
└── widget/      桌面步数小部件
app/src/main/assets/
├── legal/{en,zh}/   隐私政策、用户协议、第三方声明（纯文本）
└── map/index.html   双引擎地图页（高德 / Google）
tools/i18n/          文案抽取与批量翻译工具（谷歌/百度，构建期使用）
```

## 隐私

所有数据存本机 SQLite；只有地图瓦片、在线歌词、系统翻译、检查更新会联网。
详见 `assets/legal/*/privacy_policy.txt`。

## 许可

MIT，见 [LICENSE](LICENSE)。