一款面向 Windows 11 的轻量米家兼容灯光控制工具。它提供本地房间、设备重命名、收藏、紧凑模式、亮度与色温控制，并常驻系统托盘。
本项目是社区维护的非官方客户端，与小米、米家及其关联公司没有隶属、授权或合作关系。
- 控制灯的开关、亮度和色温
- 根据设备实际能力显示可用控件
- 日光/月光快捷模式（原生模式或本地预设）
- 本地房间与设备重命名，不修改米家 App 配置
- 收藏设备并置顶显示
- 标准/紧凑两种界面密度
- Windows 11 Mica/Acrylic 材质与纯色回退
- 系统托盘、开机自启和全局快捷键
- 操作发送状态、失败回滚与卡片内重试
截图请避免包含真实设备名称、设备 ID 或家庭房间信息。欢迎在脱敏后提交界面截图。
- Windows 10/11（Windows 11 可获得完整系统材质效果）
- Python 3.11 或更新版本
- 小米/米家账号及网络连接
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt
python login.py
python light_control_v3.py扫码登录产生的认证文件保存在：
%USERPROFILE%\.config\mijia-api\auth.json
本地名称、房间和偏好设置保存在：
%USERPROFILE%\.config\mijia-light\config.json
这两个文件都可能包含私人信息，不应提交到 GitHub、Issue 或日志中。
python -m pip install -r requirements-dev.txt
pyinstaller --noconfirm --clean build_exe.spec成品位于 dist/米家灯控.exe。认证文件不会被打进 EXE。
开启“全局快捷键”后：
Ctrl+Alt+L：显示或隐藏窗口Ctrl+Alt+↑：打开全部在线灯Ctrl+Alt+↓：关闭全部在线灯
- 使用非官方云端 API，小米接口变化可能导致登录或控制暂时失效。
- 不同灯具的 MIoT 属性映射不同；未知型号依赖自动发现，可能识别不完整。
- Mica/Acrylic 需要受支持的 Windows 版本；其他环境自动使用暖白纯色背景。
- 应用不会读取米家房间，房间关系只保存在当前电脑。
项目不会要求开发者将认证信息写进源码。提交问题前请阅读 安全政策（English），并删除日志中的 token、设备 ID、家庭名称和设备名称。
本项目在 akihitohyh/mijia-widget 基础上继续开发，并使用 Do1e/mijia-api 访问米家服务。详细来源和许可证见 NOTICE.md。
项目采用 GNU GPL v3 或更高版本 发布。PyQt6 免费版与 mijiaAPI 均采用 GPL 许可证，因此分发源码或 EXE 时需要遵守 GPL 的源代码与许可证义务。