快速开始
这份指南按首次使用顺序整理：先完成部署，再登录系统、配置账号和同步车辆数据。
1. 部署服务
推荐使用脚本一键部署：
git clone git@github.com:Ponyix/xiaomiev-mate-public.git
cd xiaomiev-mate-public
cp .env.example .env
chmod +x deploy.sh
./deploy.sh首次部署前，请先修改 .env 中的数据库密码：
DB_PASSWORD=your_password如果你希望手动控制 Docker Compose、固定版本或查看升级说明，请阅读 部署指南。
2. 访问系统
部署完成后，默认前端访问地址为：
http://localhost:18080如果你部署在 NAS、家庭服务器或云主机上，请把 localhost 替换为对应设备的 IP 或域名。
3. 登录默认管理员
系统首次启动时会自动创建管理员账号：
用户名：admin
密码：admin首次登录后请立即修改默认密码。
4. 配置小米账号
进入 个人中心 → 登录小米账号，按页面提示完成账号配置。
- 小米手机用户可优先尝试自动获取设备信息。
- 其他设备可能需要手动填写账号参数。
- 完成配置后可使用二维码登录保存小米登录态。
账号配置涉及敏感信息，请仅在可信私有网络中操作。
配置小米账号详细教程，请回到 账号配置 文档继续阅读。
5. 添加车辆
进入 车辆管理 → 添加车辆。
系统会尝试获取当前小米账号下的车辆列表，你只需要选择需要同步的数据车辆。
6. 首次同步数据
首次部署建议执行一次完整同步：
- 同步全部历史行程
- 同步月度行车报告
- 检查当天行程是否补齐
同步入口通常位于 个人中心 → 车辆管理 → 数据同步。
7. 日常使用
完成首次同步后，可以使用这些核心功能：
- 监控大屏：查看车辆数据概览
- 行程记录：查看历史行程和轨迹
- 数据统计：查看里程、能耗等统计数据
- 充电管理：查看充电记录和充电分析
- 车辆状态：查看车辆状态历史
- 月度报告：查看月度用车报告
问题反馈
如果部署或使用过程中遇到问题，可以到 GitHub Issues 反馈