Files
mi-fitness-health/CHANGELOG.md
T
binglua a47a8470f8 feat(security): privacy hardening + data export (v0.2.1)
- CORS: default localhost-only origins (was *, allowed any webpage
  to read local health data cross-site); env override MI_FITNESS_CORS_ORIGINS
- Host header allowlist middleware on FastAPI and Flask (DNS-rebinding
  protection); auto-configured for non-loopback binds via CLI
- Move API key passTokens from SQLite plaintext to system keyring,
  with automatic migration on startup and cleanup for revoked keys
- Disable uvicorn access log by default (query params out of terminals)
- New GET /api/export: JSON/CSV export of local data (offline, Excel BOM)
- Add docs/PRIVACY.md: full data-flow audit, outbound endpoint inventory,
  threat model, self-verification steps
- 6 new tests (host allowlist, keyring roundtrip, CSV)
2026-09-03 22:43:15 +08:00

2.1 KiB
Raw Blame History

Changelog

0.2.1(隐私加固)

  • 数据安全审计文档 docs/PRIVACY.md:全部对外请求清单(仅小米域名)、本机数据存放表、威胁模型与自验方法
  • CORS 收紧:默认仅允许本机来源(原来为 *,恶意网页可跨站读取本地健康数据);可用 MI_FITNESS_CORS_ORIGINS 覆盖
  • Host 头白名单中间件(FastAPI + Flask 双侧):阻断 DNS 重绑定攻击;非回环绑定时 CLI 自动放行绑定地址,可用 MI_FITNESS_ALLOWED_HOSTS 覆盖
  • API Key 的 passToken 迁出 SQLite 明文,改存系统 keyring(启动时自动迁移历史数据);吊销时同步清理
  • api 命令默认关闭 uvicorn 访问日志(查询参数不再落入终端)
  • 新增 GET /api/export:本地数据导出为 JSON/CSV(含 Excel BOM),纯离线操作

0.2.0

  • 内置 Web 仪表盘(mi-fitness-mcp web,Flask):可视化测试全部 API 端点、Key 管理、扫码登录,内置反向代理(自动附加 X-API-Key/X-Admin-Key,上游耗时透传)
  • REST API 服务(mi-fitness-mcp api,FastAPI):全部数据端点 + 同步(前台/后台)+ 覆盖统计,交互式文档 /docs
  • API Key 体系:POST /api/auth/keys 用小米凭据换取 mif_sk_* Key(类大模型平台风格),支持多账号上下文、last_used 统计、按前缀吊销;静态 Key 经 MI_FITNESS_API_KEY、管理端点经 MI_FITNESS_ADMIN_KEY
  • 扫码登录:逆向小米通用扫码流程(sid=xiaomiio),/api/auth/qr/start|poll 生成二维码并轮询换取凭据后自动发放 Key,无需浏览器 F12
  • Rust 测试页 testpage/(可选,内置 Web 仪表盘的 Rust 替代实现)
  • 修复:mcp 依赖加上界 <2(MCP SDK 2.x 移除 Server.list_tools 导致启动崩溃)
  • 文档:完整技术文档 docs/PROJECT_DOCUMENTATION.md(架构/协议/已知问题/重构指南)、扫码登录方案 docs/QR_LOGIN.md

0.1.0

  • initial standalone mi-fitness-mcp repository
  • Xiaomi auth via userId + passToken
  • Mi Fitness cloud sync for steps, heart rate, calories, body measurements
  • MCP tools for sync, summaries, heart rate, body measurements, coverage