docs: ai-service 流巡检骨架与监控（#23/#26）变更记录与开发交接记录

开发交接记录.md

@@ -556,6 +556,27 @@
 
 ---
 
+## 2026-08-13 模块：ai-service 扩展（#23 骨架 + #26）
+
+### 做了什么
+
+- `POST /stream-detect`：OpenCV 拉流抽帧（3 帧）→ 检测，返回帧数与检测列表（骨架，未接正式巡检编排）；
+- `GET /metrics`：模型模式/uptime/请求数/平均延迟 + nvidia-smi GPU 信息。
+
+### 思路与决策
+
+- #23 按计划二期，本期只做能力骨架：接口形态先定（url → 抽帧检测），视角数据与巡检任务编排待补；
+- #26 监控先做服务级指标 + GPU 可选采集（nvidia-smi 存在即读，不存在返回 null），不依赖具体 GPU 型号；
+- 顺带发现：开发服务器经 nvidia-smi 可读到 NVIDIA 940MX 2GB，说明本地非 T4 环境也能做基础 GPU 监控。
+
+### 验证与部署
+
+- pytest 8/8（TDD 红→绿）；ai-service 更新至开发服务器；
+- 冒烟：health ok；metrics 返回 GPU 信息；stream 无 url 被拒（400/422）；
+- 相关提交：`156b670`；回滚：ai-service 源码 git 恢复 + 重启 start.sh。
+
+---
+
 ## 环境与踩坑备忘（新同事必读）
 
 - **VPN**：开发服务器经 NetBird 访问；服务 Running 后需 `netbird up`，登录走 SSO（管理端 `115.191.19.95:6680`）。