开发日记
按时间回看每个项目做了什么、踩了什么坑、做了哪些取舍。共 20 条记录。
项目全部项目智慧乐活圈 lehuoquan乐活圈 OA 考勤 lehuoquan-oaMagicEngine 悦居魔法引擎如影随形 TraceMate悦居集团数字化 · 统一后台悦居智能 CRM悦居可视通话 yueju-call悦居存储管家 StorageMate悦居反诈专家 AntiFraud悦居智能NVR小红花 LittleBlossom悦居统计后台 DashboardFileBreeze悦居护眼卫士 EyeGuard宠物小程序贝芽妈(lovely-child)悦居智能官网悦居存储管家 AndroidSmartHome 安卓控制端适老智家 AgeHome悦居 AI 日历轻风快传官网 FileBreeze中航天业竞价小程序绿荫网球中心官网绿荫网球小程序青年公社小程序青年公社官网中羊坊村官网 Zhongyangfang自动化脚本集 automation我的减肥日记 WeightLoss画山别墅的旅行家 Travel画山别墅里的国学世界 GuoXue冰雪冬奥张山营延庆骑行网 YanqingBike延庆徒步网 GoHike智能门锁 SmartLock排队仿真 QueueSimulation悦居智能小程序 yueju-miniprogram智能会议室预约 meeting乡村文旅 VillageHub减肥日记小程序日常运维国学小程序 guoxue3D智慧城市 SmartCityLiveRobot 数字人应梦寺爬山smart_home_chat花间向导 SmartGuideWorkBuddy 指标看板T5AI 聊天机器人悦居AI相册(相册管家)
2026-10-20
语音识别提速 1.1 秒:省下来的是一行发送节奏,不是换架构
- 讯飞 IAT 本来就是 40ms 一帧的流式协议,但调用方是「整段录完才发送」,发送耗时直接叠在端到端上:2.77 秒的话光发出去就要 1.39 秒。
- 发送节奏从 0.02(2 倍速)改到 0.004(10 倍速):0.97 秒短句 0.89→0.46 秒,2.77 秒长句 1.79→0.67 秒。本机 15 轮全通,识别文本逐字一致(含标点)。再压到 0.002 收益趋平且限流风险升高,停在 0.004。
- 没有改成真流式:只再省 0.2~0.3 秒,而握手 + 尾包 + 收尾约 0.24 秒的固定成本躲不掉;更关键的是真流式做不了整段音量归一化,而客厅这台电视麦克风增益极低(说话 rms 200~600、底噪 550),识别率全靠这一步。
- 端到端剩下的大头是判停 1300 毫秒,不是识别本身。再想快应该动判停,但要先统计真实说完后的静音分布,否则短句准确率会掉。
米家 / 涂鸦 / 天猫精灵三朵云接进同一套设备模型
- 米家的房间归属直接取 /v2/homeroom/gethome 的 roomlist[].dids,不自维护映射;动作统一收敛到一个 POST /api/action 接口。
- prop/set 回 code=1 不代表失败(部分属性只可回读),所以写完一律回读核对。蓝牙子设备(blt.3.*)先按 datasource=2 读、缺的点位用 1 补。窗帘的 target-position 是枚举(0 暂停 / 1 开 / 2 关),不是百分比。
- 红外遥控是电视之外的独立设备:电视彻底关机后仍能开机,唤醒词「关闭电视」也走这条红外。
- 米家动作曾经全部失效而接口仍回 200:动作 key 取的是 urn 末尾的版本号,「1」把十几个动作全撞成同一个。
- 涂鸦的签名铁律是 METHOD + sha256(body) + path(query 按字母序),HMAC 的 message 是 client_id + access_token + t + stringToSign。少拼 access_token 会回 1004,但 /v1.0/token 照样成功,很容易误判成参数错。online 只信设备列表、不信 status(离线时会返回缓存)。
- 天猫精灵与 BLE Mesh 各有一个桥。Mesh 的 NetKey / AppKey 等同设备钥匙,单独存放、不入库。
「能打断」不能听 HAL 声明:三层探测才问得出真话
- AcousticEchoCanceler.isAvailable() 只是厂商 HAL 的声明,不等于这条录音真的有回声消除。真判据是 create(sessionId) 成功且 getEnabled() 为真,而且必须在 startRecording 之前 enable——启动后再挂上去,HAL 已经按无 AEC 的路径把管道建好了。
- 最终还要看运行时:播报期间跟踪「自己说话时麦克风里还剩多少」。AEC 有效时残余只有几十,人声 300+ 立刻超线;无效时基线被抬到上千,人声压不过它,于是自动退化成「打不断」(连续 1.6 秒残余超过 1600 直接判定 AEC 是摆设并关麦)。
- 于是按能力分档而不是按机型写死:有 AEC 的电视边说边听,说话即打断;没有的退回半双工,播报时关麦。家里四台电视装同一个包,不用改配置。
- 遥控器语音键(219/231)根本到不了 App:在 framework 层被厂商语音助手吃掉,日志里连 key= 都没有,同一时刻发 OK 键(23)正常记录。所以半双工机器的打断入口是「OK=打断并聆听、BACK=只停播报」,播报时界面上直接写「按 OK 打断」,否则这能力等于不存在。
- 打断不能借用「停播报」那条路:它会把会话状态一起清掉,用户刚开口就被踢出对话。只停播放器、保留会话,也不清预录缓冲——开口那几百毫秒正好补回来。
- 顺带修掉两个「好电视反而变差」:好电视通常带系统识别引擎,原来「有就用」会把自建链路整个让出去,丢掉离线唤醒分流、10 秒连续对话和打断;TTS 也统一走云端同一音色,免得四台电视四种声音。
电视端:从「打开 App 按着说话」变成「喊一声就能聊」
- 8 个离线唤醒词常驻,喊「小悦同学」或「小悦管家」即应答并进入对话窗口,不用再开电视、开 App。
- 唤醒词本身不进识别:命中瞬间连同预录缓冲一起丢弃,否则会被静默判停截成一句「小悦同学」送去识别,屏幕闪一下「在听」就回待机。
- 熄屏待机:3 分钟无交互就把背光调到 0(screenBrightness 必须给 0,给 -1 是不熄屏),应用常驻、麦克风继续工作,唤醒时先恢复亮度再应答。电视从此不用关,应用也不用每次重开。
- 区分「熄屏」与「关闭电视」:前者只是关背光、还在听,后者走米家红外彻底断电;唤醒词「关闭电视」对应后者。
- 连续对话:唤醒后 10 秒内可以连着说,每轮重新计时,10 秒没声音才退回等唤醒。以前是一句落地就把窗口清零,第二句必须重新喊唤醒词。
- 唤醒应答是现生成的 2~6 字寒暄,不是固定的「我来了」;寒暄期间掐麦并压短,避免把用户紧接着说的第一句吞掉。
- 真机验收:第一句没听清(3301)时状态自动回「在听」,第二句不重新唤醒即识别成功;空闲到期距 TTS 播完 10.03 秒。
2026-10-14
「通电」不等于「在工作」—— 待机的烤箱被当成运行中
- 蒸烤箱待机被算成运行中:设备同时返回 power=true 与 status=standby,旧代码只看 power。
- 拆成「通电」与「在工作」两个语义;烤箱用白名单,只有烹饪中/暂停算干活,未知一律按没在工作。
- 选白名单因漏报误报代价不对称,告警一说谎就没人信;「运行中」在六个位置统一走同一字段。
- 真机验证房间页与智能页都变「0 台运行」,设备页如实显示待机。
文案里的病句:「一楼蓝色的一楼蓝色」
- 管家回答出现「一楼蓝色的一楼蓝色」:5 处直接拼「房间+的+设备名」,没走既有称呼函数。
- 该函数也只挡了一半:只处理设备名等于房间名,没处理设备名里已含房间。
- 收口到一个函数两条规则:名字含房间不再拼,名字就是房间名退回类型名;8 个用例含空房间/空名字边界全过。
家庭服务主机上线:局域网设备终于能在 4G 下控
- 家庭服务主机上线,四段体检全绿:本机服务、隧道进程、服务器三端口、公网三路径 200。
- 公网读到烤箱真实状态(待机、腔内 22°C、门关、童锁开),只认同网段协议的设备在 4G 下也能控。
- 探针实测 -60dBm、信噪比 31、5GHz、网关 4.5ms、公网 13ms、零丢包。
- 5 个系统级服务 + 1 个转发容器均开机自启;连不上时文案分层,区分链路问题与设备故障。
实机部署的五个坑,每一个都伪装成别的问题
- 五个坑:变量名后紧跟中文被并入变量名;端口被占,反向隧道只绑 IPv6 仍返成功,请求打到别家返回 200。
- 本机 8000 被另一项目容器占用,烤箱服务改可配端口 8001。
- 本地网络权限:包管理器装的 framework 解释器连不通,借 Docker 网络做 TCP 转发;测连通要用真正跑服务的解释器。
- 依赖漏声明,查清该库本就在公共索引上,改回正常依赖管理。
- 分段体检才能定位断在哪一段。
2026-10-08
家庭服务主机:让局域网设备也能远程控
- 烤箱只认局域网协议,手机 4G 到不了家,而家里机器无公网 IP、公网服务器也摸不到设备,两端都过不去。
- 解法:家里机器主动连云端,在服务器开只监听回环的端口,反向代理挂到域名子路径,App 只需传云端路径。
- 坑①:服务器默认不探测客户端,死连接永久占端口,重连报端口占用且永不自愈,两头都要设保活。
- 坑②:反向隧道端口被占时会「假装成功」连上不转发,必须显式要求转发失败即退出。
- 交付一键部署包:十步安装脚本、反向隧道与自愈守护、四段式体检、家庭网络探针(实测信号/噪声/延迟丢包/解析耗时)。
v1.3.0:家庭网络检测 —— 把误判做成功能
- v1.3.0 / versionCode 14,把上一轮误判做成家庭网络检测。
- 四档判定:全部设备离线(≥2 台)或 ≥2 台在 180 秒内先后离线为家里断网;有离线但不同时为各自故障;无异常为正常;任意设备 30 分钟内上下线 ≥3 次为网络不稳。
- 同时性判据是本次新增,上次空调全掉而净水器仍在线,只看全离线会漏判成设备故障。
- 认定断网时逐台离线告警全部跳过,铃铛只出 1 条未读而非 5 条。
- 排除电池类设备(门锁长期离线会污染全离线判据);7 个构造场景全部通过。
把「家里网断了」误判成「设备故障」
- 上一轮把离线结论定为设备联网模块故障,实际是家里路由器被关掉,网络恢复后全部自动恢复。
- 证据链本不指向该结论:同账号净水器云端一直在线,不同品类心跳超时不同,「全部设备离线」根本不成立。
- 教训:只看单台设备在线状态,永远分不清设备坏了与家里断网,排除法要用对照物。
- 排查顺序:域名解析 → 外部绕一圈请求 → 服务器本机请求 → 进程与日志 → 最后才怀疑设备侧。
设备掉线,界面却永远显示正常 —— 两层错都在
- 报障:空调离线,但自家界面四台都显示已关机、室温正常。
- bug ① 服务端桥:在线字段只在启动时拉过一次,实时推送里有新状态但解码时从未读取,设备离线桥仍报在线。
- bug ② App:适配器没把离线字段传给界面,界面上连「离线」文案都没有。
- 修法:服务端以实时推送为准并定期重拉列表(拉空保留旧列表);App 侧离线为最高优先级文案,盖过已关机/运行中,开关置灰且点击如实拒绝。
- 已发 v1.2.0;新规矩:接口返回的在线状态必须问清是哪一刻的值。
通知发出去了却不弹横幅:代码里改不动的那一层
- 现象:点通知自检提示已发送,但通知栏找不到,一度误判为假成功。
- 实际通知已发出、有声音和振动,只是被折进「更多通知」区且不弹横幅;系统把排序重要性降级,渠道设高重要性也无效,应用侧改不动。
- 真正开关在系统应用通知管理页,「横幅通知」「置顶通知」默认关闭,打开即正常;已在「我的」页加提示。
- 排查技巧:拉界面层级取精确坐标,目测 y 差 23px 就打空;判断截图是否变化要算哈希,状态栏时钟每分钟在变。
- 结论:第三方 App 无法用代码强制弹横幅。
v1.1.0:设备长转 / 无效运转告警 + 消息中心
- v1.1.0 / versionCode 12。
- 告警引擎:无效制冷、长转、报障三类规则,带严重度排序、去重、6 小时通知节流;待处理列表按严重度倒序(首版写反已修)。
- 消息中心:房间页右上角铃铛带未读红点,设备恢复正常后告警自动退出待处理,不用手动清。
- 系统通知带后台巡检,每 15 分钟一次,进后台启动、回前台停止。
- 长转阈值做成可调项(6/12/24/48 小时),放在「我的」页。
告警判据:不看你花了多少电,看这次运转还有没有意义
- 起因是家人问空调是否一直开着、是否费电;实测家里电耗并不高,按电量或费用告警的方向被推翻。
- 判据改为「这次运转还有没有意义」:无效制冷(制冷中且室温低于设定、已运行 ≥1 小时)、长转(默认 12 小时,可切 6/12/24/48)、报障。
- 严重度 = 类别权重 + 已运转小时数,长转超 24 小时升级;按「规则 + 设备」去重,通知 6 小时内不重复。
- 运行时长必须由服务器侧常驻桥追踪:App 端算的话,装一次新版本所有开着设备都会被算成刚开机 0 分钟。
- 首次看到已在运行的设备,开机时刻留空只记观测起点,宁可说「至少开了 X 小时」。
2026-09-29
接入热泵:开关「假成功」—— 布尔值传成了字符串
- 接入第四个品牌:空气能热泵(v0.8.0)。
- 开关「假成功」:接口返回 200、界面也变了,设备根本没动。
- 根因是开关字段该传布尔却传了字符串,服务端不校验直接忽略。
- 结论:协议无类型校验时,验证开关必须回读设备状态,不能只看接口是否成功。
接入美的蒸烤箱:一个没有云 API 的设备
- 美的蒸烤箱是唯一没有可用云 API 的设备,只支持局域网私有协议(TCP 6444)。
- 必须由同网段机器跑中转服务,App 再连那台机器;v0.9.0 先接入。
- 该约束后来成了系统最大架构问题:手机不在家里 WiFi 就够不到烤箱,10-08~10-14 另做反向隧道方案解决。
真机 App 重构为五 Tab(v1.0.0)
- 真机 App 从单页长列表重构为五 Tab,版本 v1.0.0。
- 分批渲染:各品牌桥谁先回谁先显示,首屏从十几秒降到 4 秒。
- 开关乐观更新:本地先翻转并显示「状态同步中」,600ms 后后台校准。
- 修两处显示:中央空调 name 常与房间名相同,标题改用类型名;无读数显示 -- 而非 --°C。
- 踩坑:无头浏览器 --window-size 最小 500px,380 宽截图按 500 布局再裁切,第 5 个 Tab 看似被挤出屏幕,靠 DOM 实测宽度才排除假 bug。
信息架构定稿:按房间组织,不按品牌
- 信息架构定稿五个一级 Tab:房间 / 设备 / 管家 / 智能 / 我的。
- 关键决策是按房间组织而非按品牌:用户关心客厅里有什么,不关心牌子。
- 列表页只放灯光、窗帘两项高频控制,全量设备与联动收进房间详情,避免两级重复。
- 底部五钮同水平线不做凸起主按钮(会遮挡内容区,聊天页实测被挡);管家负责说、智能负责看。
2026-09-28
立项:把五六个厂商 App 收进一个
- 起点是家里每买一个品牌就多一个 App,查一次客厅温度要先想清是哪个牌子。
- 首日打通洗碗机、中央空调、净水器三个品牌协议,迭代到 v0.7.0;两个纯出站连厂商云,一个走局域网。
- 难点在协议各异(WebSocket 长连、加密私有 TCP、局域网广播发现),定为每品牌一个独立桥,App 只读统一格式状态。