silver_pose/README.md

# Silver Pose

Silver Pose 是一个面向固定机位大厅或走廊的本地摔倒事件演示系统。目标是向客户演示“RTSP 实时视频 → 人体姿态与人员跟踪 → 突发倒地事件 → 红色画面、声音、弹窗和事件截图”的完整闭环。

> 当前阶段是重新建立工程化 V1。旧代码保留在 `demo/` 作为可运行基线；`v1/` 将存放 Python 正式实现；`v2/` 将在 V1 验收后存放 Go 部署实现。

## 项目结构

```text
silver_pose/
├── demo/                 # 旧 Python 演示基线，含 best.pt 与样例视频
├── v1/                   # Python V1（待任务 T-101 创建）
├── v2/                   # Go V2（V1 验收后才开始）
├── docs/                 # Harness Coding 文档
├── AGENTS.md             # AI coding agent 入口
├── CLAUDE.md             # Claude 薄入口
├── init.ps1              # Windows 统一启动与基础验证入口
└── progress.md           # 只追加执行流水
```

## V1 启动与验证

在 Windows PowerShell、仓库根目录运行：

```powershell
./init.ps1
```

它会检查当前 Python 环境、编译旧 `demo/` 基线并运行 V1 测试。首次部署先安装锁定依赖：

```powershell
python -m pip install -r v1/requirements.txt
```

将 `v1/config.release.example.json`（发布包中生成）或 `v1/config.example.json` 复制为未跟踪的 `v1/config.local.json`，仅在本机填写摄像头来源与凭证。然后启动 V1：

```powershell
python -m v1.app
```

运行 GUI 或 RTSP 演示前，必须在本机准备已安装的 PyQt5、OpenCV、NumPy、Ultralytics 与 Pillow 环境。真实 RTSP 凭证、客户视频、截图和 JSONL 事件工件不得提交。

## 客户演示与发布包

客户演示步骤、证据复查和适用边界见 [docs/demo-runbook.md](docs/demo-runbook.md)。构建发布包时，模型必须提供受控 SHA-256；脚本只复制 V1 代码、公开示例、运行手册和锁定模型，不复制本地配置或事件工件：

```powershell
$modelSha = (Get-FileHash -Algorithm SHA256 demo/best.pt).Hash.ToLower()
pwsh -File v1/scripts/build-v1-release.ps1 -ModelPath demo/best.pt -ModelSha256 $modelSha -Output dist/SilverPose-V1
python -m v1.release verify --package dist/SilverPose-V1
```

发布包和现场演示仅覆盖固定俯视、全身大部分可见、单路大厅或走廊；`best.pt` 是人体姿态模型，不是摔倒分类器，也不构成医疗级或全场景可靠性承诺。

## 文档入口

所有 agent 从 [docs/00-ai-start-here.md](docs/00-ai-start-here.md) 开始。人类可从 [docs/README.md](docs/README.md) 查看完整导航。

## 模型说明

`demo/best.pt` 是与 `D:\PythonP\fall_detection` 训练工程中 `best.pt` 哈希一致的 YOLOv8 Pose 权重：1 个 `person` 类，17 个 COCO 关键点。它提供姿态，不提供“摔倒”标签；摔倒由 V1/V2 的质量门控、跟踪和时序状态机判定。