开发日记
按时间回看每个项目做了什么、踩了什么坑、做了哪些取舍。共 61 条记录。
2026-10-31
官网 5 处事实错误:全部「看起来正常」,没有一处会报错
- 起因:飞哥问「有新增功能吗,官网是不是该更新」。查下去发现不是「该不该更新」,而是官网已经错了 5 处,其中 2 处点开就失败。线上首页/product/about 的
Last-Modified停在 10-10,下载页 10-13,这 21 天恰好是功能最密集的一段。 - 错处一(硬伤):4 个页面顶栏「Web 版」都链到
(内网地址):3000,而本机已在(内网地址)网段。对外站放局域网 IP 本身就是错的设计 —— 任何公网访客点了必然失败。已直接去掉该入口,下载页留「访问同一网络下的系统地址」说明。 - 错处二(数字):原写「¥0.003/次、日均 50 次、¥4.7/月」。10 月账本实测 3311 次 / ¥17.52,其中低谷 75%、高峰 25%:低谷中位 ¥0.0037、高峰 ¥0.0075、综合 ≈¥0.005;有活动的 10 天日均 326 次 ⇒ 月约 ¥50。把 ¥4.7 改成 ¥50 看起来是「把自己写贵了 10 倍」,但那是真实账单。
- 错处三:「4 品牌 5 设备」→ 实际 6 台(新增地下室 .20,车库换 .76)。错处四:下载页版本号与 SHA。错处五:about.html 正文有 Markdown 星号泄漏(
带价值判据的事件管道),页面会真显示**。 - 为什么这些能活 21 天:它们都是「看起来正常」的东西 —— 链接是蓝色的、数字是像模像样的、版本号也有。没有一处会报错,只会默默指向错的地方。
- 验收:4 页本地与线上字节逐一相等;从线上拉回 dmg 算 SHA-256 与页面标注一致;并给下载页做了强制显示副本截图,实测四张卡片底边与按钮对齐(macOS 描述原来多一行把按钮顶高 5px,已缩到同宽)。
- 起因:飞哥问「有新增功能吗,官网是不是该更新」。查下去发现不是「该不该更新」,而是官网已经错了 5 处,其中 2 处点开就失败。线上首页/product/about 的
macOS 客户端 0.2.0 发版:打包脚本补上 .dmg 产出
- 为什么发:官网下载的 dmg 是 9-27 的 0.1.0,而源码已到 10-16。下载版缺:帧看门狗、AI 事件分析页、事件详情对话框、回放页、语音唤醒。用户下到的是个残缺品,页面却写着「最新版本」。
- 根因不是忘了发版,是打包脚本从来就不产 dmg:9-27 那个是手工
hdiutil做的,于是「源码天天改、下载包一动不动」。 - 修正:
build-app.sh补 release 模式自动hdiutil出 dmg 并打印 SHA-256;版本号从写死的0.1.0改为NVR_VERSION可覆盖(默认 0.2.0)—— 同上一个「部署脚本硬编码 apk 版本号」的坑是同一类。 - 产物:
NVRStation-0.2.0.dmg2.0M,SHAcd937893…c448。挂载校验:CFBundleShortVersionString=0.2.0、CFBundleName=悦居智能NVR、codesign --verifyvalid on disk + satisfies its Designated Requirement。 - 签名不是 ad-hoc:钥匙串里有「NVRStation Local Signing」(
security find-identity -v会过滤掉它,因为不被系统信任;不带-v才能看到)。用固定证书才能让 macOS 记住「本地网络」授权,否则每次重编译都重弹窗。 - 官网同步:v0.2.0 + 新 SHA + 描述补上 AI 事件分析页;并如实写明「本地签名、未走 Apple 公证,首次需右键打开」—— 不写这一句,用户会以为装坏了。
- 上线验收:从线上拉回 dmg 算 SHA-256,与页面标注逐字符一致(不是只看 HTTP 200)。
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,不是失败)。
- 现象:
官网重新部署:修掉部署脚本两个失效点
官网 nvr.filebreeze.cn 重新部署(远端停在 9 月 27 日版,落后半个月)。
部署脚本两个真失效点(直接跑会挂或漏更)
- 硬编码
nvr-tv-0.1.0.apk,而磁盘已是 0.2.0 ⇒ scp 阶段失败。改为按后缀取最新(版本升级不用改脚本) - 只上传
index.html⇒ download / product / about 永远停在旧版。改为整站打包上传,解包后 chown 回 ubuntu - 又踩一次「全角括号紧跟变量」:
$REMOTE_NGINX(报 unbound variable,必须${VAR}
验收(不只 curl 200,要比字节数)
- 首页 200 / 12389B,与本地 index.html 字节数完全一致(旧版只有 9.6K)
- 下载页 7271B,引用
NVRStation-0.1.0.dmg与nvr-tv-0.2.0.apk - 两个安装包 Range 请求均 206(支持断点续传)
- product / about 均 200;nginx -t 通过后 reload
- 硬编码
车库子码流 H.265→H.264:406 拒绝才是重启的真凶
背景:6 台主码流全 H.265,子码流里只有车库(id=11,海康白牌 800x448)也是 H.265。flv.js 只认 codecId=7、ExoPlayer FlvExtractor 只认 AVC ⇒ 仅这一路在 Web/TV 黑屏。设备无配置入口,只能转码。
链路:cam_11_sub → h264_videotoolbox → cam_11_sub_h264;网关自动发现
_h264变体,三端零改动。实测 5.5% 单核(libx264 speed 0.855x 跟不上)、拉 10 秒得 151 帧且 time=10.11s。四个坑
- ffmpeg 8.1.1 没有
-rw_timeout(rc=8 秒退)⇒ rtsp demuxer 用-timeout(微秒) - 不加
-fps_mode passthrough⇒ ZLM 声明 fps=22(源 15)快放 1.47× stderr=PIPE只在退出时读 ⇒ 警告写满 64KB 阻塞转码(进程活、画面不动)- ffmpeg 被 kill 后 ZLM 不立刻释放发布者 ⇒ 重推同名流必吃
ANNOUNCE 406(rc=8)。正常退出不触发、像「随机偶发」。推流前close_streams force=1,黑屏 10~20s → 3s
两个假阴性:
launchctl list恒空 ≠ 未注册;grep -E "^\s+(state|pid) ="在 BSD grep 下\s不匹配,会误报「未注册」。自省:曾把 aliveSecond 很大当成僵尸源,踢了一个正出数据的流(speed 34KB/s)。判据应是
bytesSpeed>0。- ffmpeg 8.1.1 没有
暴露面收敛: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、拉不到流,重启即消失)。
App 端媒体接口上线 + 对外集成 API 落地
- 新增
/api/client三接口(JWT 保护,DTO 不含任何凭据字段):逐个:清单 / 起流并返回四协议地址 / JPEG 截图 - 失败码语义分开:502 起流失败、504 流建好但 N 秒无数据(仍给地址)、503 截图取不到真实帧
mediaBase由请求 Host 推导 ⇒ 同一份代码在 127.0.0.1 与 (内网地址) 下各自返回可用地址- 对外集成(ADR-013/014):服务令牌 + 中间件、Webhook+HMAC、订阅调度、migration-013
- 双向令牌隔离:用户 JWT 打 /api/v1 返 401、服务令牌打 /api/* 返 401
- 修
zlm.Stream缺Schema字段:同一路流按 rtsp/rtmp/hls/ts/fmp4 各一条,原遍历会算成 5 路 - 实测:清单 6 台全在线、play readyMs=12、FLV 与 HLS 均 200
- 新增
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:// 就要问一句「本来有密码吗」。
Android TV v0.2.0:从「装不上」到「能看监控」
- tv-client 重写:API 基址运行时化,地址容错解析 + /24 扫描(并发 64、350ms 超时)。
- 取流不猜编码、失败再降级:主码流 HLS、子码流 FLV,网络类退避重连 1/2/4/8s。
- 实时宫格、单画面、事件列表、设置齐活;语音本地三级匹配,PCM 走 /api/asr。
- 单测 49 条全通过(地址 18 / 播放计划 11 / 语音 16 / 发现 4)。
- v0.2.0:debug 15.4MB 已签名、release 11.5MB 未签名,下载页已同步 SHA-256。
录制器静默死 24 小时 + ZLM 代理「补建后不等就绪」读帧死循环
- AI 事件分析零记录:录制器 10-12 21:41 静默死亡、不在 launchd 托管,日志无 traceback。
- 拉起后查出读帧死循环:addStreamProxy 异步,建完不等就绪就 open,读不到就重连、代理被回收,再补建又不等。
- 新增 _wait_zlm_ready(有 tracks 且码率>0)超时 12s,验证通过。
- 消费者无服务脚本,新增 understand-service.sh;匹配只认绝对路径会双份跑。
- 提交 4ecbfdd + c3adab7。
产品化成熟度盘点:技术已完成,产品化后半程空白;建议先 B 后 C
- 盘点 15 个维度:技术护城河已成,装/用/修/卖/合规基本空白,缺口多是差最后一公里。
- 三个空壳:有权限矩阵但全仓无 RequireRole 中间件、前端无成员管理;audit_logs 表完整但零写入;告警引擎完整但出口只有本地 TTS。
- 建议先 B 后 C:先服务已有付费客户,不做通用 App 抢 C 端;交付形态(盒子/自备/云托管)必须先拍板;暂不做人脸、云存储、通用 App 获客。
- 产物:15 维度评分 + 10 组缺口 + 三期路线图的盘点文档。
2026-10-12
车库纳入录制 + AI 事件分析页自动更新 + 事件详情对话框
- 车库摄像头纳入录制(--cams 补 21,共 5 路);只加参数无效,还要在 devices.json 填 rtsp 地址,空地址会被直接跳过。
- AI 事件分析页自动更新:时间轴 30 秒轮询 /api/events(¥0),先 pageSize=1 探测有新事件再拉全量。
- 简报只由按钮触发,避免每 30 秒重算一次、约 ¥0.02/次且界面无痕迹。
- 新增事件详情对话框:左录像右文字,支持跨设备翻页、0.25~4x 倍速、进度拖动,点事件不再跳回放页。
2026-10-10
M6 事件阅读与归纳上线(Web + mac 端),补上 mac 网关鉴权层
- M6 事件阅读与归纳上线 Web:按天按设备出四段简报、时间轴带缩略图,检索三维解析 + IDF 加权。
- 报告按事件 id 集合 SHA1 缓存,命中 0.178s vs 生成 9~17s;mac 端补上缺失的网关鉴权。
- 三个静默失败:摘要须带逐词命中数;思维链与正文共用 max_tokens,2048 致正文恒空需 16384;mac 主线程读 Keychain 冻结 UI。
- 验收 search 23/23、report 12 组、缩略图 51/51、报错 0;六笔提交已推 Gitee。
AI 两级推理 M4:成本看板 + 灵敏度在线可调
- M4 成本看板上线:网关新增 /api/ai/stats 读文件账本、/api/ai/gating 三档(保守/均衡/灵敏),前端新增 AiPage.vue 与顶栏侧栏入口。
- 机器永不回写 gating.yaml,另立覆盖层,避免 YAML 往返丢掉注释与实测依据;切档后原文件 mtime 未变。
- 录制器按 mtime_ns+size 指纹每秒比对,变更后 reload 约 1 秒生效、不重启服务,且不动门禁状态。
- Go 单测 12/12、Python 自检 20/20。
2026-10-09
AI 两级推理 M0~M3:从「落库假成功」到「一句话找回录像」
- M0~M3 均在真实摄像头上跑通。
- M0 修静默降级:Ping 失败即置 db=nil,事件接口回 200 但 id=0、events 恒 0,坏了两天;改为后台重连 + health,降级回 503。
- M1 契约走文件 spool,判据用运动帧跨度不用含预录缓冲的总时长,被挡也记 audit。
- M2 走视觉模型,单次 ¥0.003~0.0034,50 事件/天约 ¥4.7/月。
- M3 检索加意图解析:原 ILIKE 整句中文召回恒 0;另修时间戳、clipUrl、中文路径读图。
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。
手机端助手页语音输入 + 监控页及整体 UI 改版
- 助手页加微信式按住说话:16k 单声道 PCM → 网关 /asr → Python → 百度短语音,端到端识别正确。
- 监控页 LazyColumn 改 Column + verticalScroll,滚动不再释放 ExoPlayer。
- Theme.kt 补全 Typography/Shapes/色彩 token;VideoPlayer 重写直播重试 + 1/2/4/8s 退避。
- 注意:手机端默认子码流,cam_11_sub 是 H.265,解不了。
录制门禁误判根因:把 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 后生效。
车库(.21) 根因纠正:不是萤石,此前密码/取流路径全错
- 推翻早前结论:车库 .21 不是萤石,家里也没有萤石设备,是另一品牌。
- 错在沿用品牌假设用错账号,误判「设备不推流 / 需 App 唤醒」;mac 端一直能出画面本是强信号却被忽略。
- 实测:admin/admin + Digest、ONVIF 8888、RTSP 标识 happytime,主 ch0_0.264(H.265 2304×1296)、子 ch0_1.264(800×448)。
- 已修正 DB id=11 的 stream_url,重启 media 容器清掉 PlayerProxy 缓存。
mac 客户端新增「录像回放」页 + 清理 1292 个无效录像片段
- 清理无效录像:1298 个片段里仅 5 个真检出人(+1 疑似),1292 个静态误录共 1.0GB,体积 1.06GB→13.8MB。
- 新增 scripts/prune_recordings.py 按 L0~L4 同款判据复核,清理走废纸篓可恢复,报告存档。
- mac 新增录像回放页:直扫本地目录 + AVPlayer,左侧片段列表、右侧 24 小时时间轴可拖动定位并自动续播。
- build-app.sh release 编译通过、实机快照验证;待办录制服务需在真实终端 restart。
手机端 Android 完成开发并真机联调 + 二楼阳台补录
- 手机端 Android APK 完成并真机联调:Compose + ExoPlayer,功能对齐四端,竖屏单列、多路画面常驻不销毁。
- 修 5 项:播放地址补 MEDIA_BASE 前缀、网络请求切 Dispatchers.IO、401 自动登出、HLS 断流自动重试、登录页密码可见按钮。
- 二楼阳台(.48)补录网关 id=12,5 台摄像头全在线。
- 早前把车库(.21)记成萤石有误,当日 17:10 纠正为另一品牌,相关结论全部作废。
官方下载站 nvr.filebreeze.cn 上线,盘点各端进度与备案状态
- 官方下载站 nvr.filebreeze.cn 上线,HTTPS 证书已签发,只放最新版。
- 已完成:Web(Vue3,7 页 + 暗色系统)、macOS 原生(RTSP + 硬解 + 语音唤醒)、Android TV(Compose + ExoPlayer)。
- 可下载:NVRStation-0.1.0.dmg(1.37MB,已签名)、nvr-tv-0.1.0.apk(15.2MB,debug 签名)。
- 待办:手机与 Windows 未开发;TV 换正式签名;域名未做 ICP 备案,有被拦截风险。
2026-09-26
项目定名「悦居智能NVR」
- 中文名定为「悦居智能NVR」,英文保持 NVRStation。
- 落地 8 处显示名:构建脚本两个 CFBundle 键、README、前端 title、TopBar、MainPage、LoginPage、TV strings.xml 与 LoginScreen。
- 不改包名、bundle id、数据目录与 UserDefaults 域,旧配置与自测开关继续有效。
- 验证:lsappinfo 返回 LSDisplayName=悦居智能NVR,重启后 5 路设备 0~6s 出画面;看板同步改名。
git 首次入库:5 个逻辑提交 + 补齐 .gitignore
- 建仓后首次入库,按逻辑拆 5 个 commit:2c05c55 mac 客户端、e79c97a 探测脚本、017be55 节流文档、1be89dc 网关流媒体 + ZLMediaKit、24d87db Vue 前端 + TV 端。
- 提交前补 .gitignore,挡住 mac-client/.build(245MB)与 nohup.out。
- 安全检查:third_party 已由 vendor/ 规则忽略,db.go 无明文密码。
- 提交后工作区干净,后续开发有了可用基线。
第 6 台摄像头跨网段暂缓接入
- 光猫 + 3 台下级路由全开 NAT 的多层网络,Mac 在 3.x,第 6 台摄像头在另一路由的 10.x。
- 实测 3 个别名 IP(10.238 / 1.238 / 0.238)ping 全丢包,多层 NAT 下别名方案必然失败。
- 留三条路:下级路由改 AP 模式 / 光猫加静态路由 / 摄像头重新配网。
- 摄像头装得太高不便重置,本轮暂缓;客户端扫描范围与失败提示符合预期,不为跨网段改客户端。
两个隐蔽判据坑:bash 3.2 中文变量边界 / RTSP 连接数漏 -i
- macOS 自带 bash 3.2 会把紧跟 $VAR 的中文字节吞进变量名(zsh 不会),set -u 下报 unbound variable 并中断。
- build-app.sh 因此长期在签名后中断,codesign -dvv 校验步骤从未执行;全仓库改 ${VAR},按正则扫出 4 处修复。
- 查 RTSP 连接数用 grep -c estab 漏了 -i,输出是大写 ESTABLISHED 恒定返回 0,把 5 条活连接误读成一条都没有。
.48 切回主码流 + 修复 ONVIF 设备改不了取流地址
- .48 从子码流 /stream2 切到主码流 /stream1,解码由 H.264 640×480 变 H.265 2560×1440,首帧 9s。
- 切前链路已自行改善:ping 从 733~1136ms 降到 avg 53.8ms。
- 根因:ONVIF 模式下编辑表单把取流地址与路径预设整块隐藏,逻辑层其实一直支持覆盖。
- 修复:ONVIF 也显示「取流地址(可选)」,预设拆成主码流/子码流两个一键按钮。
四端通路打通,5 台真实设备稳定出画面
- 启动后 5 路全部 0~1s 出画面(4 台 TP-Link + 萤石),自动探测 8.9s 完成。
- 5 条 RTSP 连接每台正好 1 条,无会话堆积。
- 车库(.21 萤石)首次稳定出画面,解码 2304×1296,走 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 包,且须同时测一台正常设备对照。
左侧列表布局改造:自绘分栏 + 像素级快照验证
- 左侧列表突兀:NavigationSplitView 侧栏在 macOS 上会向上与标题栏融合,是系统行为不是 bug。
- 改自绘 HStack:sidebar | 6px 拖拽手柄 | detailContent,内容自然落在标题栏之下。
- 补回侧栏开关按钮与 200–320 宽度拖拽;全屏收起用 sidebarVisible = showSidebar && !isFullScreen,不写回原状态。
- 新增 UI 快照自测 NVR_UI_SHOT=1,无录屏权限时用 CALayer.render 在进程内绘制,须渲染 contentView.superview 且不翻转 y 轴。
- 像素扫描断言:侧栏 0–246、内容区 246→1148、标题栏高 52px 横跨全宽。
2026-09-20
AI 画面筛选与大模型节流方案:月成本从 ¥2100 压到 ¥7
- 方案:本地离线筛图,只把有价值画面送 DeepSeek,目标是省积分。
- 选型(M1/8GB):macOS Vision 9 项能力全可用(指纹 7.1ms、美学 7.3ms、光流 14.5ms),OpenCV 帧差 0.24ms;不引入 PyTorch/YOLO。
- 手写逐像素帧差 320×180 要 8.55ms,换 vDSP 后 0.264ms。
- 关键:省积分靠少发请求,DeepSeek 固定 384 tokens/张,每次请求都重复付 prompt 开销;事件驱动 ≈¥7/月,每 10 秒一帧 ≈¥2100/月。
- 坑:美学分不能做门禁(监控画面天然不美,最低 −0.38),基准须预热(光流冷启 16.6s → 稳态 14.5ms)。
事件为 0 是设备侧配置问题(三重验证),客户端无解
- 四台 TP-Link TL-IPC44K-4 能力一致:PTZ 可用、Events 声明 6 类主题(CellMotion/Motion、Tamper、Intrusion、LineCross、People、TPSmartEvent)。
- 但零事件,三重验证指向设备侧配置:150s 长监听 0 条;转云台造画面位移仍 0 条;GetRules 返回空规则表、GetVideoAnalyticsConfigurations 返回 HTTP 500。
- 结论:移动侦测/智能事件须在 TP-Link 客户端或 Web 手动开启,客户端侧已做对。
- 「声明支持」≠「真能用」,云台必须用位移差判定,不能只看请求被接受。
- 变焦无法用位置复核(Zoom.x 恒为 0),只能写「请求被接受」,不可写已验证通过。
云台控制 + 事件订阅落地(6 个坑逐一攻克)
- 交付:能力探测落盘、云台 8 方向按住即动/松开即停 + 变焦 + 复位 + 预置位、事件 PullPoint 订阅 + 去重 + 未读徽标。
- 坑:WSSecurity 注入命中 XML 声明结尾生成双根元素(设备回 200 但没带凭据);XMLParser 不处理命名空间导致元素名静默失配;PTZ 请求返回空响应体。
- 坑:订阅 8s 超时(设备 PT10S,改 20s);松开云台报 cancelled(改 detached 调 Stop);预置位 300 条空槽过滤后剩 3 条。
- 安全:设备侧 PT3S 保护窗 + 客户端 2.5s 续期 + 看门狗 25s 上限。
- 验证:订阅中断 115 次降至 150s 内 0 次,云台 Δpan=0.1914、复位 0.0000。
全屏「只剩画面」:SwiftUI 重排覆盖 + 延迟重压三次
- 全屏能进但顶部仍见工具栏。两层根因:.toolbar 只清空按钮、NSToolbar 仍挂窗口;didEnterFullScreen 里设 isVisible=false 被 SwiftUI 重排覆盖。
- 日志实测:进入时仍显示、1s 后已隐藏 —— 是滞后不是无效。
- 修复:.toolbar(isFullScreen ? .hidden : .visible) + 同步 toolbar/titlebar + 0.1/0.4/1.0 秒延迟重压三次(幂等)。
- 新增 windowDiagnostics,一行输出工具栏/标题栏/菜单栏/Dock 状态。
- 残留:鼠标移到屏幕顶部菜单栏仍会滑出,系统会重置 presentationOptions,确认不影响。
全屏闪退根因:presentationOptions 互斥约束违反即 abort
- 现象:一全屏就退出,4 份 .ips 崩溃日志全落在 FullScreenController.applyImmersive,SIGABRT。
- 根因:NSApp.presentationOptions 有硬性互斥约束,违反即抛 NSInvalidArgumentException,Swift 无法 catch 直接 abort。
- 逐 mask 验证:唯一合法组合是 [.hideDock, .hideMenuBar];新增赋值前逐条校验,非法则记日志降级。
- captureAppearance 统一快照,自建按钮与系统绿钮两条路径都能还原。
- 验证:app 内自测钩子直接调崩溃函数体触发。
最大教训:客户端多实例堆积把自己的摄像头打满
- osascript quit 静默失败,open -n 每轮开新实例,4 轮后 4 个实例并行,每台摄像头挂 2~4 条 RTSP 会话,打满 TP-Link 并发上限。
- 假象连串:首帧等 42 秒、对端关闭连接、退避重试 4 次全失败、ffprobe/ffmpeg 也拉不到流。
- 正确流程:killall → 确认实例数 0、554 连接归零 → 等 15~25s 让设备回收会话 → 只启一个实例,已固化为 scripts/run-app.sh。
- 诊断命令 pgrep -x NVRStation | wc -l,必须为 1。
- 教训:调试客户端前先确认实例数,多实例会自己打爆自己并制造假故障。
凭据泄漏修复:明文密码进了 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,打包后自动签名。
自动探测三通道实测:组播与单播 0 台,只有端口扫描有效
- 5 台设备实测三通道:WS-Discovery 组播 0 台、单播 0 台、端口扫描 5/5 为唯一有效通道。
- 附测 mDNS _rtsp._tcp / _onvif._tcp 无结果;组播通道保留,备将来换到支持 ONVIF 组播的网络。
- 坑:重写组播漏设 SO_RCVTIMEO,recv 全阻塞、超时判断失效,该通道卡 13.9s 而非 3s;修复后总耗时 22.5s → 11.8s。
- 启动自动探测默认 skipExisting: true,避免与已接入设备抢 RTSP 会话导致画面中断。
拉流失败自动重试: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 次重试 → 三路播放就绪,黑屏自愈。
可观测性建设:实时日志面板 + 落盘 + 沉浸式全屏
- 需求:排查画面不能靠 print,界面要有实时日志面板。
- LogCenter 单例,NSLock + 串行队列,带级别/时间戳/category,缓存 2000 条。
- LogView 支持级别与关键词过滤 + 自动滚动,sheet 弹出不占画面。
- 每条日志同步写 app 数据目录 nvr.log,可直接 cat,成了排障入口。
- 全屏:隐藏标题 + fullSizeContentView,ESC 退出,侧栏切 detailOnly,控制条 3 秒淡出。
扫描能力修复: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。
设备厂商判定修正:74:39:89 是 TP-Link 而非海康
- 74:39:89 曾按 OUI 判为海康(ONVIF 响应带 hikwsd 命名空间),实测推翻。
- GetDeviceInformation 显示 TP-Link TL-IPC44K-4,固件 1.0.13,74:39:89 是 TP-Link 的 OUI。
- hikwsd 只是兼容海康扩展协议的痕迹,不能当厂商判据。
- .21 的 9c:a3:a9 才是真海康 OUI(萤石为其消费品牌)。
- 结论:厂商以 GetDeviceInformation 为准。
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
Android TV 客户端构建成功(APK 15MB)
- app-debug.apk 15MB,包名 com.yueju.nvrtv。
- 栈:Kotlin 2.0 + Compose for TV + Media3 ExoPlayer 1.4.1。
- AGP 8.6.0 + Gradle 8.7 + Kotlin 2.0.20(compileSdk 35)。
- 排坑:gradle 8.9 下载 15 分钟仅 23MB;代理干扰 maven;无输入框改 BasicTextField。
- 播放走 HLS,导航 D-pad + LEANBACK_LAUNCHER。
原生 macOS 客户端首版:ONVIF + RTSP + VideoToolbox 硬解
- ONVIF 栈:WSSecurity + SOAPClient + WSDiscovery(UDP 3702)。
- RTSP 栈:SDP/RTP 解析 + NAL 拆包(H264 FU-A、H265 FU)+ BSD socket。
- 端到端:握手→解包→重建→H.264 硬解,123~124 帧成功。
- 坑:CFStream runloop 调度失效卡死,改 BSD socket 同步 recv。
- 教训:-12909 非代码 bug,是 profile 66 不被 VideoToolbox 兼容。
客户端形态选型:放弃 Electron/Tauri,改原生 SwiftUI
- 本机无 Rust(rustc/cargo 均无),Xcode 完整版已装,Swift 6.3,target arm64-apple-macosx26。
- 三条路径:Electron 与原生 SwiftUI 可立即做,Tauri 需先装工具链。
- 定调原生 SwiftUI + SPM,首期支持 ONVIF + RTSP 两种协议。
- 战略价值:可直连 RTSP + VideoToolbox 硬解,绕开媒体服务转协议那一跳,单路延迟与服务器 CPU 成本更优。
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 成本。
盘点发现「UI 层高于数据层」:4 个页面仍是硬编码 mock
- 当时只有登录页接通后端(JWT),MainPage / FourGridPage / PlaybackPage / EventsPage 仍硬编码设备数组。
- groupId 直接序列化成 {Int64:0, Valid:false},泄漏 Go 内部结构。
- 截图用 playwright-core 复用 Chromium,访问 localhost 须加 --noproxy '*',否则代理 502。
- 归档 docs/ui-preview/ 九页截图作改造前基线。
cameras 表为空:init-db.sql 的种子数据从未执行
- 现象:/api/cameras 返回空数组、stats 全 0,前端列表却显示 5/6 在线(那是硬编码 mock)。
- 根因:官方 PG 镜像的 initdb.d 只在数据目录为空时执行,种子 INSERT 是后期追加的,pg_data 早已初始化。
- 手动 psql 导入 6 路,验证 stats = total 6 / online 5 / recording 4 / offline 1。
- 教训:改 init-db.sql 不会自动生效,需 down -v 重建数据卷或手工补齐。
2026-09-16
7 个页面设计定稿
- 7 个页面设计定稿:登录 / 设置 / 单摄像头 / 四宫格 / 回放 / 事件页 / 主面板。
- 统一暗色优先。
- 下一阶段进入代码落地。
2026-08-21
Phase 3 LLM 集成:混元 API + Function Calling
- llm_client.py:OpenAI 兼容客户端,默认混元 v1,Bearer 鉴权 + 429 重试。
- search 用 LLM 解析意图为 JSON,无 Key 降级关键词(昨天下午红色车辆→time/object/attr)。
- chat 四个工具:switch_camera / playback / export_clip / query_events。
- 配置走 LLM_ENDPOINT 等环境变量,密钥不入库。
Docker 环境落地(colima)+ C++ ZLMediaKit 编译通过
- 无 Docker Desktop,改用 colima 0.10.3 + lima 2.2.0。
- 镜像加速配 DaoCloud;坑:colima 键名须复数 registry-mirrors。
- 代理失效:宿主 HTTP_PROXY 被映射成无效端口,env -u 后重启解决。
- C++ 关掉 x264/x265/faac/mp4v2,构建到 100%,五种编解码器加载成功。
- compose 全 healthy,真实 PG 登录端到端打通。
后端从 Mock 演进为可运行实现
- 新增 store/ 数据层:db.go(PG 连接+内存降级)、model.go、camera/event/recording 三 repository。
- 库不可用自动回退内存 mock,前端始终可跑。
- handler 层三模块改真实查库。
- WebSocket 用 Hub 广播+订阅 channel 过滤,复用 event/metric/detection/chat/recording。
- 选 database/sql + lib/pq,不引 ORM。
2026-06-29
Phase 1 MVP:从纯前端原型重构为全栈 Monorepo
- 前端迁入 frontend/,新建 backend 与 deploy。
- 前端 TS 化(TS 5.4 + vue-tsc):7 个 Pinia store、Axios/WS 层、6 个 API 模块。
- 新增 VideoPlayer、CameraGrid、PTZControl、DetectionOverlay 与自然语言搜索页。
- 后端 Go Gateway(Gin+JWT)/ C++ Media(ZLMediaKit)/ Python AI;init-db.sql 建 9 表,compose 六服务。