ilaandClaude Opus 4.8
8b33f61112
annotate_frame draws Chinese labels (e.g. '确认摔倒 P-0001') using a CJK font via Pillow when available (Windows uses Microsoft YaHei), and falls back to the ASCII cv2 label when Pillow or a CJK font is missing. 86 tests pass. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
55 lines
7.5 KiB
Markdown
55 lines
7.5 KiB
Markdown
# 当前实现状态
|
||
|
||
> 本文是可覆盖的当前快照；历史执行记录见 [../progress.md](../progress.md)。
|
||
|
||
## 当前快照
|
||
|
||
- 日期：2026-07-21
|
||
- 阶段：V1 事件管线、PyQt 双 Tab 界面、本地报警工件、结构化摄像头配置/连接测试、抓流低延迟参数与每帧判定诊断叠加已建立；T-202、T-203、T-206、T-207、T-208、T-209、T-210 已验收（T-203 真实海康流现场跑通实时预览与摔倒确认，断流/重连由确定性测试锁定）；下一可领取为 T-204（需现场正反例录像）。判定灵敏度默认已放宽（低位俯视：持续水平即可疑，膝踝可缺，水平阈值 45°），确认窗为主防误报闸；真实误报率待 T-204 验证。
|
||
- 已验证环境：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` 当前有 86 项配置、视频源、Pose、跟踪、证据、领域规则、状态机、管线、视图模型、报警工件、摄像头/URL 构建、抓流参数拼串、每帧诊断、灵敏度放宽、截图 ASCII 标注、断流重连、事件汇总、灵敏度写回、最新帧丢弃和截图中文标注测试并已通过（含来源模式显式声明、模型置信度经适配器生效、事件号跨轮唯一、结构化凭证不入 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：T-204（正反例回归录像与现场验收）需经同意成年人的摔倒/反例录像与现场安全措施，T-205 依赖 T-204，二者仍标为 BLOCKED；尚无带标签的正反例回归录像及事件标签。放宽灵敏度后的真实误报率（走动/坐下/弯腰/捡物是否不报警）尚未验证，属 T-204 范围。GUI 可视化、声音、弹窗与设置页测试连接的像素级观感需在 Windows 目视（逻辑侧已测）。
|
||
|
||
全局环境的 `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、T-101~T-106（V1 地基与事件管线）、T-201（PyQt 双 Tab）、T-202（本地报警/截图/JSONL）、T-203（海康 RTSP 与断流恢复）、T-206（结构化摄像头配置与连接测试）、T-207（抓流低延迟参数）、T-208（每帧诊断叠加）、T-209（放宽俯视灵敏度）、T-210（截图 ASCII 标注）。
|
||
- 正在进行：T-204（正反例回归录像与现场验收）——本轮先做可单人完成的反例（不误报）验证与调平衡；正例（安全模拟摔倒+1–3 秒延迟）仍需经同意成年人与现场安全措施。已交付 `v1/report.py` 事件汇总工具支撑延迟记录与误报计数。
|
||
- 下一个可领取：T-205（依赖 T-204，BLOCKED）。
|
||
|
||
## 当前可运行内容
|
||
|
||
```powershell
|
||
./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` 追加真实验证记录。
|