# 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 验证命令为准
```