# Step

**Repository Path**: aufesta/step

## Basic Information

- **Project Name**: Step
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-09
- **Last Updated**: 2026-06-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 微信步数追踪 (StepTracker)

每隔 10 分钟自动打开微信运动，读取指定用户的当天步数，保存到本地数据库，并在主界面以柱状图展示今日各时间点的步数变化。

## 工作原理

1. **无障碍服务 (AccessibilityService)**：自动操作微信 UI，进入「微信运动」→「步数排行榜」→ 查找目标用户并读取步数。
2. **AlarmManager 定时器**：按设定间隔（默认 10 分钟）触发采集任务。
3. **Root 辅助（可选）**：通过 `su` 命令更可靠地启动微信、返回桌面。
4. **Room 数据库**：持久化保存每次采集的步数和时间。
5. **Compose 柱状图**：展示今日每次采集的步数趋势。

## 前置条件

- 已安装并登录微信
- 已开启微信运动功能
- 目标用户已开启微信运动，且你能在其排行榜中看到 TA
- **将「微信运动」公众号置顶**到聊天列表顶部
- 手机已 Root（可选但推荐）
- 开启本应用的无障碍服务
- 在电池优化中将本应用设为「不限制」

## 安装步骤

```bash
cd /home/gzpeite/Downloads/Step
./gradlew assembleDebug
adb install app/build/outputs/apk/debug/app-debug.apk
```

## 首次配置

1. 打开应用，开启无障碍服务
2. 确认「使用 Root 启动微信」已开启（Root 设备推荐）
3. 点击「开启定时」或「立即采集」测试

## 注意事项

- 微信 UI 更新可能导致自动化失效
- 采集过程中请勿操作手机
- 本应用仅供个人学习研究使用