Files
silver_pose/docs/current-state.md
T
ilaandClaude Opus 4.8 1471e7ce78 feat(v1): configurable low-latency capture options
Config gains source.transport (tcp/udp), timeout_seconds and low_latency;
build_ffmpeg_options assembles OPENCV_FFMPEG_CAPTURE_OPTIONS and app.py
sets it into the environment before opening the stream, so tuning lives
in config/settings instead of a launch script. Settings tab exposes a
dropdown/number/checkbox rather than the raw option string. 64 tests pass.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-21 22:56:14 +08:00

7.0 KiB
Raw Blame History

当前实现状态

本文是可覆盖的当前快照;历史执行记录见 ../progress.md。

当前快照

  • 日期:2026-07-21
  • 阶段:V1 事件管线、PyQt 双 Tab 界面、本地报警工件、结构化摄像头配置/连接测试与抓流低延迟参数已建立;T-202、T-206、T-207 已验收,T-203 进行中(真实海康流已连通,GUI 现场预览待 Windows 冒烟)。
  • 已验证环境:Windows PowerShell;Python 3.8.10;Ultralytics 8.3.205;PyQt5 可导入。注意:当前 WSL/Linux 环境未安装 PyQt5,且其 ultralytics/torch 版本与该基线不兼容(模型前向不可用),故 GUI 可视化与真实模型端到端渲染只在 Windows 验证;本环境用 Qt-free 的 view_model.py 单元测试与假适配器管线冒烟覆盖视图逻辑。
  • 旧生产基线:demo/main.py、demo/fall_detection_gui.py、demo/detect_fall.py、demo/best.pt。
  • V1 代码:已建立安全配置、显式 Replay/Stream 视频源、Pose、轻量跟踪、质量/几何证据、倒地领域规则、按 ID 四态事件机及 v1/pipeline.py 事件管线;运行事件带非敏感 config_version,缺帧/低质量/断流会中断证据确认。新增 v1/view_model.py(Qt-free 监控视图状态与设置草稿三份隔离)、v1/gui.py 薄 PyQt5 双 Tab 外壳与 v1/app.py 装配(FrameWorker 只发出已判定的 FrameAnalysis,窗口只渲染)。新增 v1/alerts.py:按 event_id 去重,对首次 CONFIRMED 保存带标注截图、追加 JSONL 事件行,并经可注入 AlertSink(Windows 侧 QtAlertSink 提供声音与一次性弹窗)触发一次声音/弹窗。新增 v1/camera.py(RTSP URL 构建 + 有界连接测试抓帧)与 config.py 的结构化来源(host/端口/通道/账号/密码,凭证百分号编码)、write_local_camera_source;设置页新增摄像头连接分组、测试连接与预览,以及传输协议/连接超时/低延迟三项抓流调优(由 config 存值、app 开流前写入 OPENCV_FFMPEG_CAPTURE_OPTIONS)。真实海康流已用 VideoSource(STREAM) 连通(1920×1080)。
  • V2 代码:v2/ 目录存在但尚无实现。
  • 非代码设计工件:docs/ui/silver-pose-ui-ux-spec.md、docs/ui/2026-07-20-html-prototype-plan.md、docs/ui/silver-pose-v1-prototype.html 与 docs/ui/silver-pose-v2-prototype.html 已建立。v2 HTML 是符合正式浅色 Windows 规范的当前视觉参考:浅灰蓝底、白色卡片,红色只表示确认摔倒、其弹窗和事件证据;文件名中的 v2 只表示原型设计修订,不能理解为 Go V2 实现已开始。v1 HTML 保留为历史深色对照。两者均使用顶部双 Tab、设置草稿与状态交互,且画面、事件和时间都是模拟数据,不连接真实摄像头、模型或网络,也不改变 Phase 1 任务顺序。
  • 测试:python -m compileall -q v1 demo 已通过(含 gui.py、app.py、alerts.py、camera.py 语法);python -m pytest v1/tests -v 当前有 64 项配置、视频源、Pose、跟踪、证据、领域规则、状态机、管线、视图模型、报警工件、摄像头/URL 构建和抓流参数拼串测试并已通过(含来源模式显式声明、模型置信度经适配器生效、事件号跨轮唯一、结构化凭证不入 config_version 且公开示例无凭证的守卫)。demo/1.mp4 的首两帧回放时间戳已验证为 0.000000 与 0.033333 秒;T-106 的真实模型/录像 smoke 在首帧得到 2 名已分析人员、第二帧得到 0 名人员且未创建事件;T-201 的视图冒烟以真实录像解码 + 真实管线 + 确定性假 Pose 适配器驱动 build_monitor_view,得到稳定 ID、box、14 段骨架、17/17 关键点与 NORMAL/success,断流帧 0 人且不显示摔倒标签;T-202 的报警冒烟用 demo/1.mp4 首帧(848×480)落盘一张可被 cv2.imread 读回的标注截图(480×848×3,约 330 KB)与一行 JSONL(相对截图路径、含 config_version/source_id、无 rtsp),重复派发返回 0。这些只验证管线、视图与报警工件可运行,不表示摔倒识别准确率。init.ps1 会检查运行时依赖、编译旧基线并运行 V1 测试,但不会安装软件包。
  • 模型:demo/best.pt 可加载为 YOLO Pose,类别 person,kpt_shape=[17, 3];与 D:\PythonP\fall_detection\best.pt 哈希一致。
  • 当前标准启动:./init.ps1。
  • 当前标准验证:python -m compileall -q demo。
  • 当前 blocker:PyQt 界面、报警闭环与摄像头连接测试/预览已实现,但可视化、声音、弹窗与设置页测试连接的冒烟需在 Windows 执行;T-203 的真实海康流已连通,剩「带骨架的操作员现场预览」与「真实断流→重连观察」待 Windows 完成;T-204(正反例回归录像与现场验收)需经同意成年人的摔倒/反例录像与现场安全措施,T-205 依赖 T-204,二者仍标为 BLOCKED;尚无带标签的正反例回归录像及事件标签。

全局环境的 pip check 存在其他项目的包冲突,因此它不是 Silver Pose 的验收命令。init.ps1 只检查本项目实际导入的 OpenCV、NumPy、Ultralytics 与 PyQt5,并在命令非零退出时失败。

当前目录要点

路径 状态 说明
demo/ 已有 旧 Python GUI、Pose 模型与样例视频;当前单帧规则不适合作为正式事件逻辑。
v1/ 待开发 新 Python V1 的正式实现目录。
v2/ 待开发 Go V2 目录;V1 验收前不实现功能。
docs/ 已有 Harness Coding 文档、任务和计划。
tests/ 不适用 V1 测试将在 v1/tests/ 下创建。
artifacts/ 待创建 本地事件截图和 JSONL,不提交。

任务状态

  • 已完成:T-000(Harness 文档与旧基线快照)、T-101(V1 安全配置基线)、T-102(视频源与录像回放)、T-103(Pose 适配器与模型校验)、T-104(跟踪与姿态质量证据)、T-105(按 ID 时序状态机)、T-106(事件管线与事件契约)、T-201(顶部双 Tab 的 PyQt 监控与设置界面)、T-202(本地报警、弹窗、截图和 JSONL 日志)。
  • 正在进行:无。
  • 下一个可领取:T-203(接入海康 RTSP 与断流恢复)——需现场真实海康流,当前环境无法验收,标为 BLOCKED。

当前可运行内容

./init.ps1
Set-Location demo
python main.py

已知事实和限制

  • 当前 demo/ 的摔倒判定来自单帧、硬编码阈值和任意规则短路;界面部分阈值不会传入实际逻辑。
  • 当前模型是通用 person Pose 模型,不是摔倒事件分类模型。
  • 当前机器在无 GPU 条件下,对 848×480 本地样例以 640 输入运行 Pose 的测量均值约为 64.5 ms/帧;这仅是模型推理,不是端到端 RTSP/GUI 性能承诺。
  • V1 的客户演示范围限于固定俯视大厅/走廊、全身大部分可见、单路本地视频。

更新本文件时,必须同步 06-tasks.md 的任务状态,并向 ../progress.md 追加真实验证记录。