46 lines
3.5 KiB
Markdown
46 lines
3.5 KiB
Markdown
# AGENTS.md
|
|
|
|
> Silver Pose 的仓库级 AI coding agent 入口。开始任何工作前先读本文，再从 [docs/00-ai-start-here.md](docs/00-ai-start-here.md) 进入项目上下文。
|
|
|
|
## 项目定位
|
|
|
|
Silver Pose 是面向固定机位大厅或走廊的本地摔倒事件演示系统。它从海康摄像头 RTSP 视频流中识别全身可见的人员，在同一人员从站立或行走转为持续倒地时，显示红色姿态、播放声音、弹出警报并保存事件截图。
|
|
|
|
第一版用 Python 构建并验证；第二版在 Python 行为基线通过后迁移为 Go 部署版。模型 `best.pt` 仅用于人体姿态估计，不是摔倒分类器。
|
|
|
|
## 目录和事实来源
|
|
|
|
| 路径 | 角色 | 修改纪律 |
|
|
| --- | --- | --- |
|
|
| `demo/` | 当前旧 Python 演示基线、模型和样例视频 | 未经任务明确授权不得重构或覆盖 |
|
|
| `v1/` | 新 Python V1 的正式实现目录 | 当前优先开发目标 |
|
|
| `v2/` | 新 Go V2 的正式实现目录 | 仅在 V1 验收和模型导出一致性验证后开始 |
|
|
| `docs/` | 需求、架构、任务和当前状态的权威记录 | 需求或代码现实变化时必须同步 |
|
|
| `progress.md` | 只追加的执行流水 | 每轮任务完成、部分完成或阻塞均追加 |
|
|
| `D:\PythonP\fall_detection` | `best.pt` 的训练工程，只读参考 | 不在本仓库任务中改写，训练事实见文档 |
|
|
|
|
项目事实以 `docs/`、当前可运行代码和真实验证结果为准；不得以历史聊天、`__pycache__/` 或未验证的旧结果推断事实。
|
|
|
|
## 强制工作流
|
|
|
|
1. 依次阅读 `docs/00-ai-start-here.md`、`01-vision.md`、`02-requirements.md`、`03-tech-stack.md`、`04-architecture.md`、`05-coding-rules.md`、`06-tasks.md`、`current-state.md` 和 `progress.md`。
|
|
2. 运行 `./init.ps1`，再运行当前任务要求的测试。基线失败时先修基线，不领取新功能。
|
|
3. 只领取 `docs/06-tasks.md` 中第一个依赖满足的 `TODO` 任务；改为 `DOING` 后开始。
|
|
4. 完成后必须运行验收命令，把结果追加到 `progress.md`，同步任务状态和 `current-state.md`，然后停止。
|
|
5. 结束前执行 `docs/clean-state-checklist.md`。
|
|
|
|
## 安全、范围和演示表述
|
|
|
|
- 不把真实海康 RTSP 用户名、密码、内网地址、摄像头序列号或客户视频写入仓库、文档、日志和截图文件名；使用环境变量或本地未跟踪配置。
|
|
- V1 只承诺固定俯视机位、全身大部分可见的大厅/走廊演示；不得对所有公共场所、所有摄像头或医疗级可靠性作未经验证的声明。
|
|
- 正常行走、坐下、弯腰、捡物和短暂停留是必须验证的不报警反例；安全模拟摔倒必须使用经同意的成年人和现场安全措施。
|
|
- `best.pt`、ONNX 导出物和截图属于构建或运行工件，不得在没有哈希、来源和验证记录的情况下替换。
|
|
- V2 不得直接读取 `.pt`；必须从锁定的 V1 模型导出 ONNX，并通过同一录像集的关键点、事件和延迟一致性测试后才可用于演示。
|
|
|
|
## 文档与验证纪律
|
|
|
|
- 需求改变先改 `docs/02-requirements.md`；模块职责、事件字段或状态改变先改 `docs/04-architecture.md` 和 `docs/api.md`。
|
|
- 任务完成的证据是可运行命令、可观察结果和 `progress.md` 记录，绝不是“代码已写”。
|
|
- 不新增数据库、云服务、账号系统、远程告警、模型训练或重量级框架，除非当前任务和需求明确要求。
|
|
- 不删除用户已有文件、重置工作区或覆盖模型；任何潜在破坏性操作先说明目标和原因。
|