开发日记
按时间回看每个项目做了什么、踩了什么坑、做了哪些取舍。共 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-31
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-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
手机端助手页语音输入 + 监控页及整体 UI 改版
- 助手页加微信式按住说话:16k 单声道 PCM → 网关 /asr → Python → 百度短语音,端到端识别正确。
- 监控页 LazyColumn 改 Column + verticalScroll,滚动不再释放 ExoPlayer。
- Theme.kt 补全 Typography/Shapes/色彩 token;VideoPlayer 重写直播重试 + 1/2/4/8s 退避。
- 注意:手机端默认子码流,cam_11_sub 是 H.265,解不了。
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 纠正为另一品牌,相关结论全部作废。
2026-09-26
四端通路打通,5 台真实设备稳定出画面
- 启动后 5 路全部 0~1s 出画面(4 台 TP-Link + 萤石),自动探测 8.9s 完成。
- 5 条 RTSP 连接每台正好 1 条,无会话堆积。
- 车库(.21 萤石)首次稳定出画面,解码 2304×1296,走 ONVIF 动态取流,推翻此前「设备侧不推流」的判断。
2026-09-21
左侧列表布局改造:自绘分栏 + 像素级快照验证
- 左侧列表突兀: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
云台控制 + 事件订阅落地(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。
2026-09-19
自动探测三通道实测:组播与单播 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 会话导致画面中断。
可观测性建设:实时日志面板 + 落盘 + 沉浸式全屏
- 需求:排查画面不能靠 print,界面要有实时日志面板。
- LogCenter 单例,NSLock + 串行队列,带级别/时间戳/category,缓存 2000 条。
- LogView 支持级别与关键词过滤 + 自动滚动,sheet 弹出不占画面。
- 每条日志同步写 app 数据目录 nvr.log,可直接 cat,成了排障入口。
- 全屏:隐藏标题 + fullSizeContentView,ESC 退出,侧栏切 detailOnly,控制条 3 秒淡出。
2026-09-18
原生 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 兼容。
盘点发现「UI 层高于数据层」:4 个页面仍是硬编码 mock
- 当时只有登录页接通后端(JWT),MainPage / FourGridPage / PlaybackPage / EventsPage 仍硬编码设备数组。
- groupId 直接序列化成 {Int64:0, Valid:false},泄漏 Go 内部结构。
- 截图用 playwright-core 复用 Chromium,访问 localhost 须加 --noproxy '*',否则代理 502。
- 归档 docs/ui-preview/ 九页截图作改造前基线。
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 六服务。