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

71 lines
2.8 KiB
Markdown
Raw Normal View History

2026-07-20 22:05:55 +08:00
# 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 验证命令为准
```