为了关一盏灯, 我研究了它怎么听懂 App
这件事从结果看, 不太划算.
台灯有自己的 App, 开关, 亮度和色温都能调. 我却想省掉打开它的那几步, 直接让平时使用的 AI 助手替我操作. 为了少点几下屏幕, 最后查了网络流量, 翻了 App 的实现, 还写了一个 Python 程序.
只算省下的时间, 大概很难回本. 但手边正好有一盏联网的灯, Mini 上也已经跑着 Hermes, 我想试试聊天时顺口说一句, 它能不能知道该去哪里, 做哪件事.
在写 Mini 的那篇文章里, 我提过这盏灯. 当时只说最后用上了, 中间那些绕路, 还没细讲.
手机按下开关以后
台灯是家超 LT955. 研究范围很小: 自己的灯, 自己的 App 账户, 把平时已经能做的操作换一种方式完成.
第一件事, 是弄清手机到底在和谁说话.
手机和灯连着同一个 Wi-Fi, 很容易让人以为, 按一下开关, 命令就直接从手机送到灯上. 但当时观察到的控制过程, 要先经过厂商云端.
我们把操作拆开, 一项一项看: 打开 App, 进入设备页面, 开灯, 关灯, 再调亮度. 每次操作时, 对照手机与台灯两边的网络变化.
按下开关后, 先是手机向服务器发出数据, 接着服务器向台灯下发, 然后台灯回报. 结合 App 里的调用路径, 才确认这条链路用的是 MQTT over TLS.
通信内容是加密的. 能看到什么时候有数据经过, 数据有多大, 却不能凭这些就读出里面写了什么. 开灯和关灯的数据长度相近, 更不能看着几个数字, 就猜自己已经找到了开关指令.
这一轮观察说明, 要让独立程序控制它, 得接上这条云端链路.
这也意味着, 即使不用厂商 App, 仍然要依赖厂商服务. 我没有把它改造成可以完全离线控制的灯, 只是给现有的控制方式另做了一个入口.
20% 里面, 藏着一个 40
接下来才是命令本身.
沿着 App 的实现, 我们找到消息的结构和对应字段, 再用独立客户端查询台灯状态. 屏幕上的按钮和滑块, 这时才逐渐变成可以理解的参数.
亮度的处理就有过一次误判.
App 显示的是百分比, 协议里却有自己的数值范围. 早先根据 UI 控件坐标做过一次推算, 后来发现控件上的位置不能直接当成用户输入的百分比. 那个推算只能放弃, 回到真实操作和回包上来.
实际把亮度设为 20% 后, 台灯返回的 lc 是 40. 对照 App 实现与这次验证, 控制程序才采用百分比乘以二的转换方式.
还有一件容易被忽略的小事: 我只想调亮度, 就不应该顺便把色温改了.
所以程序先查询当前状态, 保留已有的色温参数, 再修改亮度字段. 调色温时也一样, 保留亮度. App 把这些细节处理好了, 自己接手以后才发现, 一个滑块背后还会影响别的参数.
白光色温则沿用设备的六个档位, 从暖到冷. 没有核实过对应的 Kelvin 数值, 我就没有给它添上一组看起来更专业的数字.
最后做出的程序很小, 叫 lampctl.py. 查询状态, 开灯, 关灯, 调亮度, 选色温档位, 就这几件事. 没有另做界面, 也没有为了管一盏灯搭一套新的智能家居平台.
命令发出去, 还得再问一遍
这盏灯不会对设置命令返回我们期待的那种确认消息.
如果程序把消息发出去就结束, 我最多只能知道发送这一步完成了. 灯有没有按要求变化, 还得另查.
于是每次控制之后, 程序都会主动查询状态. 关灯就检查开关状态, 亮度和色温则核对相应字段. 不符合预期就报错, 避免 Hermes 把消息已发送说成操作已经完成.
Mac 上实际试过开关, 20% 亮度和第 4 档色温. 每轮测试也都记得恢复原来的状态. 调试结束后, 灯该关着就仍然关着, 不把实验时的参数留给下一次使用.
查询时还发现, 连接后收到的消息不全是灯光状态. 有一类设备配置, 会带上位置和网络标识等信息. 控制程序只提取需要的灯态, 不把整包设备资料都交给助手.
Hermes 还是去错了地方
底层程序跑通以后, 我们把它放到 Mini 上, 配成 Hermes 的 Skill.
因为走厂商云端, Mini 不必和台灯待在同一个局域网. 它能连接对应服务, 就可以沿着已经验证的路径查询和控制. 部署过去以后, 程序的自检和真实状态查询也都通过了.
但聊天里的助手仍会去 Home Assistant 里找灯.
文件已经放好, 单独运行也能查到状态, 聊天里的 Hermes 却没有使用这个新工具. 继续告诉它灯的名字也不见得有用, 因为它正在另一个入口里找.
后来查清, 这里既有旧智能家居语境的影响, 也有旧会话没有加载新增 Skill 的问题. 我们补清了 Skill 的中文触发描述和调用入口; 新会话里, 才看到 Hermes 读取这份 Skill, 调用控制程序, 根据真实回包回答台灯状态.
长期沿用的微信会话则还保留着旧的工具说明. 当时那份说明里有 Home Assistant, 没有刚装好的台灯 Skill.
这比协议处理多出了一步: 给助手安装能力后, 还要确认正在使用的会话已经加载它. 只检查文件在不在, 很容易漏掉这一点.
后续处理完入口问题, 我才确认这套控制可以用了.
也有没往下做的部分
App 里还有场景模式, 通用代码里也能找到 RGB 相关字段. 但这些线索, 并不足以说明眼前这款台灯接受任意 RGB 控制.
我没有继续拿猜出来的组合试颜色. 已经确认的白光亮度和色温, 就足够覆盖这次想做的事. 没有验证的能力, 让助手直接说明暂不支持就好.
最后没有新面板, 也没有仪表盘. 灯还是那盏灯, 厂商 App 也还可以用. 多出来的是一个小程序, 一份 Skill, 和聊天时另一种操作它的办法.
本文根据 2026-08-16 的协议调查, 控制测试及后续使用确认整理. 写作时未重新操作台灯; 账户, 设备标识, 私有地址与认证信息均已省略.