本帖最后由 462541011 于 2026-8-3 09:07 编辑
[插件发布] IAM空气净化器 (KJ500F-T3) 自定义组件 —— 云端全功能集成（附“永不掉线”方案）
2026.07.21 首发 | 支持 HA 2025.6.1 及以上版本
一、插件简介
本插件实现了对 IAM 空气净化器（型号 KJ500F-T3 ）的完整云端控制与状态监控。
通将以下功能无缝接入 Home Assistant：
- 风机主控：开关机、1~5 档风速调节（百分比滑块同步）、智能/睡眠模式切换
- 环境传感器：PM2.5、温度、湿度、甲醛(HCHO)浓度、TVOC等级
- 设备状态：滤芯剩余寿命（运行小时数）、总运行时长、当前风速档位
- 辅助开关：负离子发生器、童锁
- 定时功能：定时关机（1~24 小时可调）
二、重磅必看：关于“稳定在线”与设备共享策略
由于本插件通过云端 API 进行控制，而官方 App 的频繁启停或 Token 刷新会与插件产生冲突，导致插件 Token 失效而需要重新登录。
为了达到*配置一次，长期稳定不掉线的效果，强烈推荐以下方案：
【最佳实践 —— 设备共享给小号】
- 使用您的主手机号登录官方 IAM App，并正常绑定空气净化器。
- 在 App 内将空气净化器完全控制权共享给一个新注册的手机号（小号）。
- 在 Home Assistant 插件配置中，使用这个小号的用户名和密码登录。
原理：插件独享小号的登录凭证，并在后台持续发送心跳包（APPOnLine），只要手机 App 不去反复登录登出这个小号，插件的云端会话就可以保持数月不掉线。而您的主号手机 App 可以随便开关，完全不影响 HA 中的控制稳定性。
三、安装与配置步骤
1. 下载与安装
2. 添加集成
-
进入 HA 的 设置 -> 设备与服务。
-
点击右下角的 添加集成，在搜索框中输入 IAM Air Purifier。
-
点击进入配置：
- 用户名：输入您的手机号（建议使用前面提到的“小号”）。
- 密码：输入该账号在 IAM App 中设置的登录密码。
-
点击提交。如果该账号下只有一台设备，会自动添加成功；若有多台设备，会弹出列表供您选择。
-
添加成功后，您会看到名为 IAM 空气净化器 的设备卡片。
四、可用实体清单
添加成功后，您将获得以下实体（如图）：
伍、免责声明
- 本插件为开源社区项目，仅供技术交流与个人学习使用。
- 本插件依赖于 IAM 官方云端 API，请勿进行高频次、大规模异常请求，以免引起官方注意并导致接口封禁。
- 若因使用本插件导致设备异常或账号风控，使用者需自行承担风险。
| 
发表于 2026-7-21 16:51:17
