-
一个适用于 Yunzai 系列机器人框架 的米家插件，在任何地方控制家中米家生态设备
-
用奇怪的方式，让你在聊天框中控制米家设备，或者让群友控制你的米家设备（雾）
-
使用中遇到问题请加 QQ 群咨询：707331865
Tip
最近把家里的一些家具接入了米家，我也能享受智能家庭啦！闲的没事找了下米家的 API，就写了这个插件。（其实也没太大用处对叭）
git clone https://github.com/CikeyQi/mijia-plugin.git ./plugins/mijia-plugin
Note
如果你的网络环境较差，无法连接到 Github，可以使用 GitHub Proxy 提供的文件代理加速下载服务
git clone https://mirror.ghproxy.com/https://github.com/CikeyQi/mijia-plugin.git ./plugins/mijia-plugin
pnpm install --filter=mijia-plugin
Caution
本插件已兼容 Guoba-plugin ，你可以在锅巴插件中设置允许他人查看/控制你的智能设备，但这是很危险的操作，我们默认关闭了非主人控制，我们非常不建议你打开它。如果你误操作导致任何财产损失，我们概不负责！
登录小米账号
安装插件后，发送 #米家登录 或者 #米家扫码登录 ，根据提示登录即可
自己写适配器
🌟 由于米家设备数量大，种类复杂，作者无法做到全部适配，但是写适配器非常简单，所以建议自己配置，如果看完本教程实在是不会可以加群 707331865 或者在 issue 留下你的设备型号，我会尽量给大家适配
适配器文件保存在插件根目录下的 /adapter 文件夹，适配器文件的文件名为设备型号（可发送 #米家设备 查看你所拥有的设备型号），一个型号对应一个适配器
接下来打开网站 小米/米家产品库，在搜索框直接搜索设备型号，找到自己的设备型号，点击 规格，选择最新的 released，进入开发文档
看到图中，SIID 是功能分类 ID，里面有很多设备属性 ID，就是 PIID，一个 SIID 加上一个 PIID 即可定位到一个属性，可以看到图中，当 SIID 为 2，PIID 为 1 时，控制的就是灯的开关
以下是插件自带的适配器示例 yeelink.light.lamp1.yaml，actionable 部分是 写，viewable 部分是 读
actionable: # 权限"写"接口
- name: ["开关"] # 操作名称
desc: "台灯开关，可用值：开、关" # 操作描述与值范围提示，操作设备时会提示
siid: 2 # 功能分类ID
piid: 1 # 设备属性ID
value_regexp: '/(开|关)/g' # 值的正则表达式，避免用户传入不符合规范的值
- name: ["亮度"]
desc: "调整台灯亮度，可用值：1-100"
siid: 2
piid: 2
value_regexp: '/([1-9]|[1-9][0-9]|100)/g'
- name: ["色温"]
desc: "调整台灯色温，可用值：2700-6500"
siid: 2
piid: 3
value_regexp: '/(27[0-9]{2}|6[0-4][0-9]{2}|6500)/g'
- name: ["模式"]
desc: "调整台灯模式，可用值：0 - 阅读 / 1 - 计算机 / 2 - 夜读 / 3 - 防蓝光 / 4 - 有效工作 / 5 - 蜡烛 / 6 - 闪烁"
siid: 2
piid: 4
value_regexp: '/(0|1|2|3|4|5|6)/g'
viewable: # 权限"读"接口
- name: '灯泡状态' # 展示名称
siid: 2 # 功能分类ID
piid: 1 # 设备属性ID
unit: '' # 值的单位，可不填
- name: '灯泡亮度'
siid: 2
piid: 2
unit: '%'
- name: '灯泡色温'
siid: 2
piid: 3
unit: 'K'
开 与 关 对应值 true 与 false，已经做了内置处理，其他的值需要完全对应产品库中的值
如何控制设备
以操作 台灯 为例，使用命令 #米家台灯状态 即可查看台灯状态。使用 #米家控制台灯 即可控制台灯，修改相关值。使用 #米家设备 即可列出所有设备
- 密码 / 扫码的登陆
- 查看设备状态
- 控制设备
- 查看房间
- 插件安全吗？
- 插件只与米家 API 交互，插件本身不会收集你任何信息也不会主动控制你的设备
- 不确保插件被滥用，建议使用时小心谨慎，不要被有心群友使用
如果你喜欢这个项目，请不妨点个 Star🌟，这是对开发者最大的动力， 当然，你可以对我 爱发电 赞助，呜咪~❤️
有意见或者建议也欢迎提交 Issues 和 Pull requests。
本项目使用 GNU AGPLv3 作为开源许可证。