Files
silver_pose/docs/00-ai-start-here.md

2.8 KiB

AI 开发入口

每次开始编码前先读本文件。它只负责导航和流程;硬性规则见 05-coding-rules.md。

一句话定位

Silver Pose 是一个在固定俯视大厅或走廊中,从海康 RTSP 视频流识别人员突发倒地事件并现场报警的本地桌面演示系统。

V1 MVP 只做:RTSP 连接、人体姿态和人员 ID、时序摔倒事件、红色姿态/声音/弹窗/截图,以及可重复的正反例验收。

必读顺序

  1. ../AGENTS.md
  2. 项目愿景
  3. 需求
  4. 技术栈
  5. 架构设计
  6. 编码规则
  7. 任务看板
  8. 当前实现状态
  9. ../progress.md

固定开工流程

  1. 确认仓库根目录是 D:\opc_project\silver_pose。
  2. 运行 ./init.ps1;失败时先记录和修复基线,不领取新功能。
  3. 只领取 06-tasks.md 中第一个依赖均为 DONE 的 TODO 任务,并改为 DOING。
  4. 先写任务指定的失败测试,再做最小实现;不在同一轮领取第二个任务。
  5. 完成后运行验收命令,追加 ../progress.md,更新 06-tasks.md 与 current-state.md。
  6. 过一遍 clean-state-checklist.md,汇报结果后停止。

当前阶段和路径

  • 当前阶段:V1 工程化起步。
  • Phase 0:冻结 demo/ 基线并建立 v1/ 可验证骨架。
  • Phase 1:验证 RTSP、Pose、跟踪和时序事件的最高风险链路。
  • Phase 2:完成 PyQt 实时监控与报警截图闭环。
  • Phase 3:在固定录像和实时流上完成客户演示验收。
  • Phase 4:导出 ONNX、验证一致性并开始 Go V2。

MVP 范围

只做:

  • 固定俯视机位、全身大部分可见的大厅/走廊。
  • 单机本地 RTSP 实时监控。
  • 成人安全模拟摔倒,以及行走、坐下、弯腰、捡物等不报警反例。
  • 1–3 秒内的确认报警、红色姿态、声音、弹窗和事件截图。

不做:

  • 多摄像头统一管理、云端平台、账号体系或远程告警。
  • 医疗诊断或所有公共场景的可靠性承诺。
  • V1 未验收前的 Go 功能开发。
  • 未经数据与评测支持的模型重训或模型替换。

事实来源

  • 当前旧基线:demo/main.py、demo/fall_detection_gui.py、demo/detect_fall.py、demo/best.pt。
  • 模型训练参考:D:\PythonP\fall_detection\train.py、convert_coco_to_yolo.py、runs\pose\coco-pose2\results.csv。
  • 产品范围和验收:本 docs/ 目录。
  • 实际 RTSP 地址与客户视频:仅本机未跟踪配置,不能提交。

验证命令

./init.ps1
python -m compileall -q demo
# T-101 后以 docs/03-tech-stack.md 的 v1 验证命令为准