内容
# Mi Fitness 数据桥
本地优先的数据桥，用于将您自己的 Mi Fitness 健康数据导出到 SQLite、JSON、CSV、Python 和 MCP 兼容的工具。
> 非官方社区项目。它不隶属于小米，也不得到小米的认可。实验性云适配器可能会在小米更改私有端点时停止工作。仅使用您有权访问的帐户和数据。
## 合成演示
* 上面显示的所有健康值都是合成的。不包含凭证、帐户标识符或个人导出数据。
## 本项目的作用
- 通过实验性的中国地区云适配器读取 Mi Fitness 健康数据。
- 将标准化记录存储在本地 SQLite 数据库中。
- 导出不包含凭证的可移植 JSON 或 CSV 文件。
- 为个人自动化提供本地 MCP 查询工具。
- 为下游项目（如个人减脂顾问）提供可重用的连接器实现。
它故意不提供医疗建议、减重指导、托管帐户访问或多用户云服务。
## 支持的数据集
- 每日活动：步数、距离、活跃热量和活跃分钟数。
- 睡眠会话和阶段。
- 锻炼。
- 身体测量：体重和可用的身体成分字段。
- 心率样本，包括可用的静息心率。
- SpO2、压力和异常心跳事件（如果适用于帐户/设备）。
可用性因设备、帐户地区、固件和小米的上游服务而异。
## 安装
```bash
git clone https://github.com/shkyyy18/mi-fitness-data-bridge.git mi_fitness_data_bridge
cd mi_fitness_data_bridge
python -m venv .venv
```
Windows PowerShell:
```powershell
.\.venv\Scripts\Activate.ps1
pip install -e ".[dev]"
```
macOS/Linux:
```bash
source .venv/bin/activate
pip install -e '.[dev]'
```
## 配置
更安全的交互式路径避免将 passToken 直接放入 shell 历史记录中：
```bash
mi-fitness-bridge setup
mi-fitness-bridge doctor
```
凭证存储在本地密钥环中。一些备用密钥环实现可能会以较低的安全性存储机密信息；在使用前请查看您的操作系统的密钥环行为。
## 同步
```bash
mi-fitness-bridge sync --start-date 2026-07-01 --end-date 2026-07-15
```
或同步单个数据集：
```bash
mi-fitness-bridge sync --type sleep --start-date 2026-07-01 --end-date 2026-07-15
mi-fitness-bridge sync --type body_measurements --start-date 2026-07-01 --end-date 2026-07-15
```
## 导出
创建单个可移植的 JSON 文件：
```bash
mi-fitness-bridge export --format json --output exports/mi_fitness.json
```
创建每个数据集的单个 CSV 文件：
```bash
mi-fitness-bridge export --format csv --output exports/csv
```
按数据集和日期筛选：
```bash
mi-fitness-bridge export --format json --type sleep \
--start-date 2026-07-01 --end-date 2026-07-15 \
--output exports/sleep.json
```
导出数据永远不会包含保存的小米 passToken。导出的健康记录仍然是敏感的个人数据，默认情况下会被 Git 忽略。
## MCP 服务器
兼容性命令仍然可用：
```bash
mi-fitness-bridge serve
# 旧别名
mi-fitness-mcp serve
```
可用的工具包括连接状态、同步、覆盖率、每日摘要、身体测量、睡眠、锻炼、心率、SpO2 和压力查询。
## 作为 Python 依赖项使用
标准适配器在兼容性模块名称下仍然可用：
```python
from mi_fitness_mcp.adapters.mi_fitness_cloud import MiFitnessCloudAdapter
```
下游项目应安装此软件包，而不是供应商或复制连接器源代码。
## 隐私和安全
- 请保持 passTokens、本地数据库、导出数据和日志的私密性。
- 不要将数据桥作为公共凭证代理运行。
- 不要提交包含个人指标的真实健康数据或截图。
- 在错误报告和文档中使用合成数据。
- 本软件用于个人数据访问和工程研究，不用于诊断或治疗。
有关负责任的报告，请参见 `SECURITY.md`；有关来源，请参见 `THIRD_PARTY_NOTICES.md`。
## 开发
```bash
pip install -e '.[dev]'
python -m pytest -q -p no:cacheprovider
python -m ruff check src tests
```
## 发布
有关版本历史，请参见 `CHANGELOG.md`；有关发布和发布后检查，请参见 `docs/release-checklist.md`。
## 许可证
MIT。参见 `LICENSE`。上游归属在 `THIRD_PARTY_NOTICES.md` 中予以保留。
MCP 市场