56 lines
5.1 KiB
Markdown
56 lines
5.1 KiB
Markdown
# 执行进度记录
|
||
|
||
> 本文件只追加记录任务执行、验证、阻塞和关键决策。当前目录、当前命令和下一任务以 [docs/current-state.md](docs/current-state.md) 为准。
|
||
|
||
## 记录格式
|
||
|
||
```markdown
|
||
## 【YYYY-MM-DD】T-【编号】 【任务名】
|
||
|
||
- 状态：【DONE / BLOCKED / PARTIAL】
|
||
- 变更：【文件或模块】
|
||
- 验证：【真实命令和结果】
|
||
- 阻塞：【原因与决策人】
|
||
- 决策：【本轮确定的取舍】
|
||
- 下一步：【任务 ID 或待确认事项】
|
||
```
|
||
|
||
## 执行记录
|
||
|
||
## 【2026-07-20】T-000 建立 Harness Coding 文档基线
|
||
|
||
- 状态：DONE
|
||
- 变更：创建仓库级 agent 入口、V1/V2 需求、技术栈、架构、任务看板、模块合约、当前状态和实施计划文档。
|
||
- 验证：`./init.ps1` 已通过：Python 3.8.10 可导入 OpenCV、NumPy、Ultralytics 8.3.205 与 PyQt5，且 `python -m compileall -q demo` 退出码 0；`demo/best.pt` 被识别为 `pose`、`kpt_shape=[17, 3]`、类别 `person`；20 个 Markdown 文档的本地链接均可解析，实施计划没有占位标记。全局 `pip check` 的其他项目冲突不作为本项目验收；`init.ps1` 检查实际依赖并对非零退出码失败。
|
||
- 阻塞：无代码 blocker；V1 依赖清单、RTSP 实流录像和现场验收录像尚未创建。
|
||
- 决策：`demo/` 作为旧基线保留；V1 使用 Python + PyQt5 + OpenCV + Ultralytics；V2 使用 Go，且必须以 V1 的录像回归集和 ONNX 一致性测试为迁移门槛。
|
||
- 下一步：T-101。
|
||
|
||
## 【2026-07-20】DESIGN UI/UX 客户演示原型规格
|
||
|
||
- 状态：PARTIAL
|
||
- 变更：创建 `docs/ui/silver-pose-ui-ux-spec.md`，定义离线 HTML 原型的正常监控、确认摔倒、连接异常状态、布局、视觉令牌、键盘操作和无障碍验收条件。
|
||
- 验证：`./init.ps1` 通过；规格共 98 行，未发现 `TBD`、`TODO` 或 `REPLACE` 占位符，`git diff --check` 通过。
|
||
- 阻塞：等待用户审阅已提交的规格；未生成 HTML，未变更 `demo/`、`v1/` 或任务看板状态。
|
||
- 决策：原型为单页、无网络依赖的视觉与交互演示，使用虚构摄像头和事件数据，不表现为真实 RTSP 或模型推理。
|
||
- 下一步：用户确认规格后，创建 `docs/ui/silver-pose-v1-prototype.html` 并执行离线交互验收。
|
||
|
||
## 【2026-07-20】DESIGN 离线 HTML UI/UX 原型
|
||
|
||
- 状态：DONE
|
||
- 可视化验证：使用本机 Chrome 无界面模式实际渲染 1280 × 800、900 × 900、600 × 1000 三种窗口截图；宽屏与窄屏截图已人工检查，主操作可见，窄屏下右栏纵向重排，未见横向溢出。Chrome 对 file 页面返回非零退出码，但三张 PNG 均实际生成，故以文件与画面结果作为结论。
|
||
- 变更：创建 docs/ui/silver-pose-v1-prototype.html 和实施计划 docs/ui/2026-07-20-html-prototype-plan.md。原型可在单页中通过按钮或数字键 1、2、3 切换正常监控、确认摔倒和连接异常；包含 16:9 模拟姿态画面、红色确认状态、一次性演示弹窗、报警/截图证据、最近事件、窄窗口重排、键盘焦点和屏幕阅读器状态提示。
|
||
- 验证：Node.js 22 解析唯一内联脚本，并确认三种状态按钮、弹窗、确认按钮、aria-live 与 1007/640/600 epx 响应式断点存在，输出 prototype static validation passed；敏感与网络边界扫描未发现凭证、模型路径或网络行为标记；./init.ps1 通过。
|
||
- 阻塞：无。该文件是离线视觉原型，已做静态和无界面浏览器布局验证，但不表示实时 RTSP、模型推理、声音播放或截图保存已实现。
|
||
- 决策：原型采用单窗口深色控制台布局，以同一画面状态切换展示客户关心的“正常不报警、确认后完整报警闭环、断流不误报”三种结果。
|
||
- 下一步：T-101；HTML 原型可作为后续 T-201 PyQt 界面实现的视觉与交互参考。
|
||
|
||
## 【2026-07-20】DESIGN 顶部 Tab 与设置原型修订
|
||
|
||
- 状态：DONE
|
||
- 变更：更新需求、页面导航、架构、T-201 验收、UI 规格和实施计划；将 HTML 原型改为顶部双 Tab。实时监控 Tab 保留姿态与报警演示；设置 Tab 显示来源环境变量就绪、模型只读信息、六项非敏感事件或重连参数、草稿版本与保存/重置操作。
|
||
- 验证：基线 ./init.ps1 通过；Node.js 22 解析唯一内联脚本，并检查 tablist、tab、tabpanel、设置表单、保存操作、运行配置版本、配置草稿控制器和三档响应式断点；敏感与网络边界扫描未发现凭证、模型路径或网络行为标记。Chrome 无界面模式实际渲染 1280 宽监控页、1280/900/600 宽设置页；宽屏与 600 宽截图已人工检查，未见横向溢出。
|
||
- 阻塞：无。设置页只模拟草稿编辑和保存反馈，不会写入本地配置，也不会热改监控中的运行配置。
|
||
- 决策：V1 固定采用顶部双 Tab，而非左侧导航；两个静态目的地不会挤压实时视频。设置草稿在下一次开始监控时才成为新的运行配置，事件工件继续追溯实际运行版本。
|
||
- 下一步：T-101；后续 T-201 按此交互和配置快照边界实现 PyQt 界面。
|