English version: README.en.md

米桥（Mi Fitness Data Bridge）

本地优先的数据桥接器，把你自己的小米运动健康数据导出到 SQLite、JSON、CSV、Python 以及兼容 MCP 的工具。

小米运动健康 App 很乐意给你看你的步数、睡眠和心率——却从不让你把这些数据带走。这个桥接器把你自己的数据放进你自己硬盘上的一个 SQLite 文件里。

商标声明：小米、米家、Mi Fitness 均为小米公司商标。本项目为非官方社区项目，与小米公司无任何隶属或背书关系。

实验性的云端适配器可能因为小米改动私有接口而随时失效。请只在你有权访问的账号和数据上使用。

实测验证

2026-07-20 在 Windows（Python 3.14）上基于 main 分支的提交录制。所有数据均为合成数据，不涉及任何凭据或网络访问。（测试数量已于 2026-08-17 复核更新。）

测试套件：

$ python -m pytest -q -p no:cacheprovider
........................................................................ [ 96%]
...                                                                      [100%]
75 passed in 10.27s

端到端合成演示（examples/synthetic_demo.py 先用合成记录填充本地 SQLite 缓存，再跑真实的 JSON/CSV 导出流水线）：

$ python examples/synthetic_demo.py
Seeded synthetic database: C:\Users\<you>\AppData\Local\Temp\mi-fitness-demo-53el7cfh\mi_fitness.db
  daily_activity: 2026-07-15 .. 2026-07-15 (1 day(s))
  sleep: 2026-07-14 .. 2026-07-14 (1 day(s))
  workouts: 2026-07-15 .. 2026-07-15 (1 day(s))
  body_measurements: 2026-07-15 .. 2026-07-15 (1 day(s))

Export completed
  mi_fitness.json
  daily_activity.csv
  sleep.csv
  workouts.csv
  body_measurements.csv
  heart_rate.csv
  spo2.csv
  stress.csv
  abnormal_heart_beat.csv

JSON envelope:
  schema_version: 1.0
  source: mi_fitness_data_bridge
  records.daily_activity: 1 row(s)
  records.sleep: 1 row(s)
  records.workouts: 1 row(s)
  records.body_measurements: 1 row(s)

Sample sleep row (synthetic):
  start_at=2026-07-14T23:20:00 end_at=2026-07-15T07:05:00
  duration_minutes=465 score=86
  stages=[{"stage": "deep", "minutes": 82}, {"stage": "light", "minutes": 271}, {"stage": "rem", "minutes": 88}, {"stage": "awake", "minutes": 24}]

已合并 health-assistant 项目

health-assistant 项目（本地优先的个人健康看板：Strava、睡眠、身体成分、饮食分析）已合并进本仓库，其原仓库已归档。吸收过来的资产位于 docs/health-assistant/ 目录下：

• analytics.py —— 零依赖的训练/恢复总结与建议引擎参考实现（7 天训练统计、急性/慢性负荷比、就绪度检查、每日训练建议）。
• coaching_methodology.md —— 其背后可解释的骑行教练、身体成分与运动营养方法论。
• README.md —— 完整的迁移说明，包括有意未移植的部分（FastAPI 看板、Strava OAuth/Webhook 管线、餐食照片分析）以及原因。

这个项目做什么

• 通过一个实验性的中国区云端适配器读取小米运动健康数据。
• 把规范化后的记录存进本地 SQLite 数据库。
• 导出不含凭据的便携式 JSON 或 CSV。
• 暴露本地 MCP 查询工具，供个人自动化使用。
• 为下游项目（比如个人减脂顾问）提供一份可复用的连接器实现。

它刻意不提供医疗建议、减肥指导、托管式账号访问或多用户云服务。

为什么做这个桥接器？

支持的数据集

• 每日活动：步数、距离、活动热量和活动分钟数。
• 睡眠记录及睡眠阶段。
• 运动记录。
• 身体测量：体重及可用的身体成分字段。
• 心率样本，包括可用时的静息心率。
• 血氧（SpO2）、压力和异常心跳事件（取决于账号/设备是否提供）。

实际可用性因设备、账号地区、固件和小米上游服务而异。

安装

git clone https://github.com/shkyyy18/mi-bridge.git mi_fitness_data_bridge
cd mi_fitness_data_bridge
python -m venv .venv

Windows PowerShell：

.\.venv\Scripts\Activate.ps1
pip install -e ".[dev]"

Windows Git Bash：

source .venv/Scripts/activate
pip install -e ".[dev]"

macOS/Linux：

source .venv/bin/activate
pip install -e '.[dev]'

配置

更安全的交互式配置路径可以避免把 passToken 直接写进 shell 历史：

mi-fitness-bridge setup
mi-fitness-bridge doctor

在可用时，凭据通过本地钥匙串（keyring）存储。某些备用的 keyring 实现存储密钥的方式可能不够安全，使用前请先了解你操作系统的 keyring 行为。

如何获取 user_id 和 passToken

本桥接器使用的是小米账号级凭据（与米家 App 同一套登录态），以下两种方式任选其一：

方式一：浏览器手动复制

1. 在浏览器打开 account.xiaomi.com 并登录你的小米账号（与小米运动健康 App 同一个账号）。
2. 打开开发者工具（F12）→「应用 / Application」→ Cookies → `htt

... View full README on GitHub