0 Fork 0

mirror of https://github.com/This-weiyuqing/mi-fitness-health.git synced 2026-10-18 03:03:49 +08:00

Files

T

binglua 2dd32f1ee6 feat: REST API with API keys, QR login, and web dashboard (v0.2.0)

- REST API (FastAPI): all data endpoints, sync (foreground/background),
  coverage stats, interactive docs at /docs
- API key system: exchange Xiaomi credentials for mif_sk_* keys
  (multi-account contexts, last-used tracking, prefix revocation);
  static key via MI_FITNESS_API_KEY, admin endpoints via MI_FITNESS_ADMIN_KEY
- QR code login: reverse-engineered Xiaomi universal QR flow
  (sid=xiaomiio), auto-issues API key after scan confirmation
- Built-in web dashboard (Flask): visual console for all endpoints,
  key management, QR login; reverse proxy with server-side key relay
- Standalone testpage/ console (python app.py, no install needed)
- Fix: pin mcp<2 (SDK 2.x removed Server.list_tools, broke startup)
- CI: install [all,dev] extras; docs: full technical documentation
  and QR login implementation guide

2026-09-03 22:28:31 +08:00

1.7 KiB

Raw Blame History

Mi Fitness Web UI & API 调试控制台（Python Flask）

现代化的小米运动健康数据可视化面板与反向代理控制台（基于 Python Flask），提供开箱即用的 Web 界面，方便直观查看健康数据、触发同步、管理 API Key 及扫码登录授权。

📊 现代化仪表盘：涵盖每日活动、心率采样、睡眠分期、运动训练、体重体成分、血氧、压力与异常心跳。
📈 多维指标序列分析：支持步数、距离、卡路里按天/周/月进行 sum/avg/max/min 聚合与图表走势。
📱 扫码登录：内嵌小米官方 App / 米家扫码登录流程，自动轮询并一键换取 API Key。
🔑 API Key 体系：多账号凭据发放、列表查询与前缀吊销。
💻 开发者控制台：实时响应检视、JSON 语法高亮/过滤、耗时统计与一键生成 cURL 命令。
⚡ 无缝代理：自动反向代理 /proxy/* 到后端 FastAPI（默认 http://127.0.0.1:8321），并自动中继服务端安全 Key（X-API-Key / X-Admin-Key）。

快速启动

方式 1：通过主项目 CLI

mi-fitness-mcp web [--host 127.0.0.1] [--port 8322] [--backend-url http://127.0.0.1:8321]

方式 2：直接运行脚本

python testpage/app.py
# 浏览器打开 http://127.0.0.1:8322/

环境变量

变量名	默认值	说明
`BIND`	`127.0.0.1:8322`	Web 界面监听地址与端口
`MI_FITNESS_API_URL`	`http://127.0.0.1:8321`	FastAPI 后端服务地址
`MI_FITNESS_API_KEY`	无	设置后代理自动附加 `X-API-Key`（密钥不进浏览器）
`MI_FITNESS_ADMIN_KEY`	无	设置后代理自动附加 `X-Admin-Key`（管理端点鉴权）

1.7 KiB Raw Blame History Unescape Escape