71 lines
2.8 KiB
Markdown
71 lines
2.8 KiB
Markdown
# AI 开发入口
|
|
|
|
> 每次开始编码前先读本文件。它只负责导航和流程；硬性规则见 [05-coding-rules.md](05-coding-rules.md)。
|
|
|
|
## 一句话定位
|
|
|
|
Silver Pose 是一个在固定俯视大厅或走廊中，从海康 RTSP 视频流识别人员突发倒地事件并现场报警的本地桌面演示系统。
|
|
|
|
V1 MVP 只做：RTSP 连接、人体姿态和人员 ID、时序摔倒事件、红色姿态/声音/弹窗/截图，以及可重复的正反例验收。
|
|
|
|
## 必读顺序
|
|
|
|
1. [../AGENTS.md](../AGENTS.md)
|
|
2. [项目愿景](01-vision.md)
|
|
3. [需求](02-requirements.md)
|
|
4. [技术栈](03-tech-stack.md)
|
|
5. [架构设计](04-architecture.md)
|
|
6. [编码规则](05-coding-rules.md)
|
|
7. [任务看板](06-tasks.md)
|
|
8. [当前实现状态](current-state.md)
|
|
9. [../progress.md](../progress.md)
|
|
|
|
## 固定开工流程
|
|
|
|
1. 确认仓库根目录是 `D:\opc_project\silver_pose`。
|
|
2. 运行 `./init.ps1`；失败时先记录和修复基线，不领取新功能。
|
|
3. 只领取 [06-tasks.md](06-tasks.md) 中第一个依赖均为 `DONE` 的 `TODO` 任务，并改为 `DOING`。
|
|
4. 先写任务指定的失败测试，再做最小实现；不在同一轮领取第二个任务。
|
|
5. 完成后运行验收命令，追加 `../progress.md`，更新 `06-tasks.md` 与 `current-state.md`。
|
|
6. 过一遍 [clean-state-checklist.md](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 地址与客户视频：仅本机未跟踪配置，不能提交。
|
|
|
|
## 验证命令
|
|
|
|
```powershell
|
|
./init.ps1
|
|
python -m compileall -q demo
|
|
# T-101 后以 docs/03-tech-stack.md 的 v1 验证命令为准
|
|
```
|