开发日记
按时间回看每个项目做了什么、踩了什么坑、做了哪些取舍。共 21 条记录。
项目全部项目智慧乐活圈 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-31
AI 事件落库断了 5 天:真因是登录 401,却被记成「网关 503」
- 现象:
events最后一条停在 10-30 22:36,spool/dead/积了 542 个事件(书房 227 / 客厅 219 / 玄关 96),而成本账本 10-31 19:55 还在正常扣费 —— 理解在跑、钱在花、结果被丢掉。 - 真因:
ai_understand用默认密码admin123登录,而 10-30 安全加固已把密码改掉 ⇒ 每轮 401。日志里全历史 1635 次「登录网关失败 HTTP 401」,零次 503。 - 为什么排查会被带偏:
_save_to_db只返回 True/False,上层把一切失败写成「落库未确认(网关 503/降级或返回 id=0)」。错误归因比没有归因更贵,它会让人去网关里查一天。 - 三处修正:①凭据改读
(本机路径)(600),改密码不用重装 launchd 服务(改 plist 后bootstrap在受限终端恒 EIO);②新增_LAST_DB_ERROR/last_db_error(),dead 备注写真实原因;③补 flock 单实例锁。 - 为什么必须加锁:launchd 每 120s 起一轮
--once,积压大时一轮跑不完 ⇒ 两个消费者同时读写同一 spool,互相os.remove、同一条事件重复理解重复扣费、run_once抛 FileNotFoundError 整轮中断。重放 500 条时第一次必然撞车,平时事件量小看不出来。 - 重放:新增
scripts/replay_dead_events.py,必须清掉_consume.attempts否则移回 spool 会被立刻再判死。514 条重放,按 ¥0.0043/次约 ¥2.2。 - 验收:小批 3 条全部落库(id 1702~1704)、死信 0、超 300s 的旧事件只落库不播报;并发第二个进程干净退出(退出码 0,不是失败)。
- 现象:
暴露面收敛:7 个端口收回本机 + JWT_SECRET 改必填
接上网线后发现局域网内任一设备可直接连数据库与 Redis(实测 Redis 无密码直接回 +PONG),遂做收敛。
做了什么
- 5432 / 6379 / 1883 / 9091 / 8082 / 80 从 0.0.0.0 收窄到 127.0.0.1(网关用容器名访问 redis、mosquitto,本来就不需要宿主端口)
- Redis 加 requirepass;admin 密码重置为 18 位强口令(旧 admin123 实测返 401)
比弱口令严重得多的一条
docker-compose.yml写着JWT_SECRET: change-me-in-production,Go 代码读不到环变量时的默认值也是同一个串。知道这串就能自己签发任意用户令牌,跳过密码调用所有 API,admin 密码多强都没用。已改为
${JWT_SECRET:?...}必填、值放deploy/.env(600);缺变量则网关拒绝启动,宁可不起也不静默回落。代价:三端已登录 token 全部失效,mac / 手机 / TV 需重新登录。
遗留:ZLM secret 仍为可猜字符串且在 git 历史里(与 PG 密码同),真正解药是轮换而非改文本;554 端口因 Lima 残留监听未能关闭(实测不响应 RTSP、拉不到流,重启即消失)。
2026-10-16
三端补「帧看门狗」:修掉画面静默冻结,并纠正一个错误归因
- 画面冻在 12:34,源端 OSD 正常、日志六小时无重连与拉流错误:三端只做首帧超时,没有中途停帧检测。
- 判据改为「最近一次收到新帧的时间」:mac 10 秒无新帧重建并加 120 秒内 3 次的刹车,Web 四路径三档信号,TV 看 currentPosition。
- 纠正错误归因:ZLM 按需拉流 0 路,摄像头只有 mac 的 5 条直连、每台 1 条已是最小,改走 ZLM 不做。
- 三端编译通过,看门狗自测 13/13;提交 f1a98e7 已推。
2026-10-13
修网关拉流接口的凭据泄露(source 字段带 admin 密码)
- 拉流接口 /cameras/:id/stream/start 的 source 字段原样回传带 admin 密码的 rtsp 地址,任何登录用户可调。
- 网关新增 redactSource():清空 UserInfo,解析失败返回空串;重建容器后两份响应搜密码与 user@host 均 0 命中。
- /api/health 恢复(database.ready=true, degraded=false)。
- 教训:内部字段顺手回给前端不会报错,凡响应出现 rtsp:// 就要问一句「本来有密码吗」。
录制器静默死 24 小时 + ZLM 代理「补建后不等就绪」读帧死循环
- AI 事件分析零记录:录制器 10-12 21:41 静默死亡、不在 launchd 托管,日志无 traceback。
- 拉起后查出读帧死循环:addStreamProxy 异步,建完不等就绪就 open,读不到就重连、代理被回收,再补建又不等。
- 新增 _wait_zlm_ready(有 tracks 且码率>0)超时 12s,验证通过。
- 消费者无服务脚本,新增 understand-service.sh;匹配只认绝对路径会双份跑。
- 提交 4ecbfdd + c3adab7。
2026-09-27
Web 端打通真实监控画面 + 主界面重构 + 智能助手真实化
- Web 端入口定为内网 3000:云端域名无 API 反代,HTTPS 调 http 被混合内容拦截。
- VideoPlayer.vue 重写:NETWORK_ERROR 静默重连、首帧 18s 超时、generation 作废旧回调;5 路真机出画面。
- 主界面改左设备列表 + 右画面区替换 mock;助手修 5 处,含 randomUUID 崩溃与 stream 幂等。
- H.265 播不了真凶是 flv.js 只认 H.264,ZLM 输出 Enhanced FLV;浏览器链路须有 H.264。
录制门禁误判根因:把 motion 当价值 → 改为「只有检出人才录」
- 玄关每 15 秒封一个 15s 片段,存量 1298 个 / 1.06GB;根因是 valuable 判据把 motion 也算价值。
- 12 个片段 person 检出全为 0;帧差挡不住夜视切换,静态片段帧差最高 71%~88%。
- 配额统计只扫顶层,子目录录像恒为 0,64GB 循环覆盖失效。
- 改为只认 person、min_value_frames=3、尾巴 15s→5s、配额递归统计,加 L0 亮度护栏。
- 实测 9 个静态片段全拒、有人片段仍录;待办:录制服务需真实终端 restart。
手机端「登录已过期」根因:token 30 分钟 + 无续期,两端修复
- 「登录已过期」与 mac 版无关,真因是网关 access token 仅 30 分钟,手机端无续期,401 直接登出。
- 排除网关重启致密钥漂移:JWT_SECRET 写死在 docker-compose.yml。
- 手机端加 refreshToken 持久化与 tryRefresh(),401 静默续期后重试原请求;executeAndUse 改接受 suspend 闭包。
- 网关改为 access 7 天 / refresh 30 天。待办:重建容器 + 重装 APK 后生效。
2026-09-26
.48 切回主码流 + 修复 ONVIF 设备改不了取流地址
- .48 从子码流 /stream2 切到主码流 /stream1,解码由 H.264 640×480 变 H.265 2560×1440,首帧 9s。
- 切前链路已自行改善:ping 从 733~1136ms 降到 avg 53.8ms。
- 根因:ONVIF 模式下编辑表单把取流地址与路径预设整块隐藏,逻辑层其实一直支持覆盖。
- 修复:ONVIF 也显示「取流地址(可选)」,预设拆成主码流/子码流两个一键按钮。
2026-09-21
添加流程端口知识硬编码 6 处 → 收敛为一表
- 内网萤石设备添加失败:端口知识硬编码只认 2020(散落 6 处),该设备 ONVIF 在 8888。
- 设备侧另有一问题:RTSP 逐步全 200 但 8 秒收 0 个 RTP 包,同时刻三台 TP-Link 正常送流(1501/719/171 包)。
- 新增 PortScanner.portHints 表统一端口→ONVIF 路径→厂商→RTSP 默认路径,扫端口、拼地址、给默认路径三处共用。
- 修两处假成功:test() 握手后等首个 RTP 包 6 秒,超时如实报「设备接受了会话但没送流」。
- 固化 scripts/rtsp_diagnose.py 与自测钩子;权威判据只有数 RTP 包,且须同时测一台正常设备对照。
2026-09-20
全屏「只剩画面」:SwiftUI 重排覆盖 + 延迟重压三次
- 全屏能进但顶部仍见工具栏。两层根因:.toolbar 只清空按钮、NSToolbar 仍挂窗口;didEnterFullScreen 里设 isVisible=false 被 SwiftUI 重排覆盖。
- 日志实测:进入时仍显示、1s 后已隐藏 —— 是滞后不是无效。
- 修复:.toolbar(isFullScreen ? .hidden : .visible) + 同步 toolbar/titlebar + 0.1/0.4/1.0 秒延迟重压三次(幂等)。
- 新增 windowDiagnostics,一行输出工具栏/标题栏/菜单栏/Dock 状态。
- 残留:鼠标移到屏幕顶部菜单栏仍会滑出,系统会重置 presentationOptions,确认不影响。
凭据泄漏修复:明文密码进了 devices.json 与 nvr.log
- 取证:nvr.log 出现 rtsp://admin:<明文>@IP 的 SETUP 记录,devices.json 中三台 rtspURL 仍内嵌明文凭据。
- 上轮凭据剥离只对新保存设备生效,存量未清洗,等于没修。
- 新增 Log/Redaction.swift 覆盖全部日志点;DeviceStore.load() 加 migrateEmbeddedCredentials() 存量迁移,改写前自动备份。
- 验证:地址字段 0 个 @,日志明文密码出现 0 次,脱敏单测 5/5 通过,4 台设备认证正常。
- 教训:安全修复必须覆盖存量数据,「只对新增生效」是假修复。
添加摄像头三个叠加缺陷:无编辑入口 / 黑屏无提示 / 列表静默截断
- 从扫描结果添加设备后找不到输账号密码的地方,画面不出,devices.json 里凭据全空。
- 三缺陷叠加:无编辑入口;ONVIF 取流失败纯黑无提示,状态停在 .idle;画面 prefix 截断,新设备排末尾看不到。
- 修复:AddDeviceView 编辑模式 + 独立「认证」Section;右键、状态栏、失败浮层三处加入口;新增 reportFailure 推进 .failed。
- 监控改按页切片 + 翻页,新设备自动跳末页;指纹变更自动重连,RTSP 401/403/404 文案语义化。
- 验证:4 台设备全部出画面。
2026-09-19
macOS 本地网络权限反复弹窗根治(稳定自签名证书)
- 每次启动弹「是否允许查找附近的设备」,签名 adhoc、Info.plist 未绑定。
- 根因:无稳定签名身份,重建后 cdhash 变,被当新应用;macOS 14+ 按签名标识记授权。
- 解法:openssl 自签名证书(codeSigning)+ codesign 固定 identifier。
- 坑:系统 security 不认 OpenSSL 3.x 默认 PKCS#12,须用 openssl -legacy 导出。
- 固化:幂等 setup-signing.sh,打包后自动签名。
拉流失败自动重试:2/4/8/8 退避 + generation 代次号
- 问题:pkill 后 2 秒内重启,上一 RTSP 会话未释放,三台摄像头首连 socket 全失败并永久黑屏。
- 实现失败重试最多 4 次,退避 2/4/8/8 秒;generation 代次号让旧回调与待执行重试失效,pendingRetry 防双重调度。
- 连接成功(.playing)重置 retryCount,后续断线重新获得完整重试机会。
- 验证:故意 pkill 后等 2 秒重启,socket 失败 3 次 → 2 秒后第 1/4 次重试 → 三路播放就绪,黑屏自愈。
扫描能力修复:poll 循环 + SO_ERROR 判据 + 并发度硬约束 → 5/5
- 5 台只扫出 3 台、耗时 20.4 秒,写了 5 个版本逐一验证。
- poll 必须循环到超时,单次 poll 会漏掉握手中的连接(v3/v4 命中 0)。
- 判定要 revents != 0 且 SO_ERROR == 0,未完成握手时 SO_ERROR 同为 0。
- 并发是硬约束:30 台并发只命中 2/5,批次降到 10 才 5/5。
- 终态:ARP 预筛 254→约 28 台 + 探 554/批次 10/超时 2.5s + 补 2020、8000、8888,两轮 5/5,8~9 秒。
黑屏真正原因:渲染层 frame 零尺寸(拉流解码全通)
- 日志证据:首帧已送入显示层(bounds=0×0),拉流解码全通,问题在渲染层尺寸为零。
- 旧 View 两 bug:makeNSView 用空 CALayer 覆盖原 layer;layer.frame 未随 bounds 更新。
- 修法:新建 SampleBufferContainerView 重写 layout(),布局时同步 frame。
- 修复后 bounds=326×300,画面出来。
- 降噪:status=1 正常,isReadyForMoreMediaData 短暂 false 是背压。
黑屏三大叠加 Bug:sin_len / control 路径 / PLAY Range 头
- Bug 1:sockaddr_in 未设 sin_len,macOS 下 connect 直接失败。
- Bug 2:SETUP 的 control 路径丢前缀,track1 应为 /stream1/track1。
- Bug 3:PLAY 缺 Range 头且 Session 带 ;timeout=15,报 400。
- 修完 OPTIONS→DESCRIBE 401→200→SETUP→PLAY 全 200,RTP 帧持续流入。
- 经验:TP-Link 的 RTSP 交互与 ffmpeg 一致。
RTSP 客户端从未实现认证:补 Basic/Digest 自动识别
- 缺陷:connect() 的 OPTIONS→DESCRIBE→SETUP→PLAY 全程不发 Authorization,TP-Link 要密码,DESCRIBE 直接 401。
- 认证方式也误判:实测是 Basic,不是 Digest。
- 补 AuthScheme + buildAuthorization(Basic=base64 / Digest=MD5)+ 401 重试。
- 验证:无密码/错密码 401,正确密码 200;SDP 为 H265,2560×1440@15fps。
ZLMediaKit 两个阻断性 Bug:MediaServer 未编入 all + enable_rtmp=0
- Bug 1:镜像缺 MediaServer,make 只构建 all 而它带 EXCLUDE_FROM_ALL;改 make MediaServer 并校验产物。
- Bug 2:AddStreamProxy 传 enable_rtmp=0,.live.flv 依赖 rtmp,播放 000;改 1 后 200。
- 附带:gateway 容器是 8/21 旧镜像,不含新拉流路由,需重建。
- 端到端:ffmpeg 推流→注册五协议→stream/start 拉流,FLV/HLS/fmp4 全可播。
2026-09-18
Web 端打通真实拉流:前端从未调用 startStream
- 根因:网关早有 stream/start,前端从未调用,播放器直接拼 /live/cam_{id}.flv 播不存在的流。
- 修:camera.ts 加 startStream/stopStream,play() 先 await 成功再启 flv/hls/webrtc,失败报错。
- 硬约束:flv.js 不支持 H.265,种子数据 3 路就是 H.265。
- 判断:浏览器不能直连 RTSP,须媒体服务转协议,多一跳延迟与 CPU 成本。