[开源推荐] Mi Fitness Data Bridge：把小米运动健康记录导出成本地表格

项目地址

https://github.com/shkyyy18/mi_fitness_data_bridge

类别

Python

项目标题

把小米运动健康记录导出成本地表格

项目描述

Mi Fitness Data Bridge 是一个面向个人数据备份与整理的 Python 工具：从本人有权访问的 Mi Fitness 账户同步可用记录，落入本机 SQLite，再导出 JSON 或便于表格软件读取的 CSV，也能供本地 MCP 客户端查询。浏览器合成演示无需注册，便于先看输出格式。项目非官方且实验性；真实同步取决于设备、地区和上游接口，目前需要已有凭证，并非一键授权工具。

亮点

• 先看结果，不先交凭证：提供中英文静态演示，切换日常活动、睡眠、运动、身体测量样例，下载合成 CSV/JSON。页面不接受登录、文件上传或真实健康记录。
• 导出工具可独立使用：CLI、Python 集成和本机 stdio MCP 是不同入口，不必先接入 AI 才能备份数据。
• 可复现的学习路径：示例将合成记录写入 SQLite，再经过真实导出器生成文件；适合阅读 Python 数据模型、SQLite 存储和 CSV/JSON 导出流程。测试不连接真实账号。
• 边界透明：不提供医疗建议、托管凭证或公网代理。合成测试不等于设备兼容性验证，文档明确列出尚未验证的范围。

许可证为 AGPL-3.0-only，保留上游 MIT 归属。此为维护者自荐，投稿文案与合成演示使用 AI 辅助制作；不声称这是从零独立原创的全部实现，也不声称已验证所有小米设备。

示例代码

安装：Python 3.11+，克隆仓库后在虚拟环境中安装。

python -m pip install -e .
python examples/synthetic_demo.py

上述示例无需账号和 Token，不请求小米接口。真实账户配置需另读 README 和兼容性文档，不要在命令行参数或 Issue 中提供凭证。

截图或演示视频

浏览器演示：https://shkyyy18.github.io/mi_fitness_data_bridge/

兼容性与配置前提：https://github.com/shkyyy18/mi_fitness_data_bridge/blob/main/docs/compatibility.md