silver_pose/AGENTS.md

AGENTS.md

Silver Pose 的仓库级 AI coding agent 入口。开始任何工作前先读本文，再从 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 记录，绝不是“代码已写”。
• 不新增数据库、云服务、账号系统、远程告警、模型训练或重量级框架，除非当前任务和需求明确要求。
• 不删除用户已有文件、重置工作区或覆盖模型；任何潜在破坏性操作先说明目标和原因。