feat(v1): add demo runbook and release package

This commit is contained in:
ila
2026-07-22 15:10:11 +08:00
parent 3b263a87ea
commit 084082055d
10 changed files with 446 additions and 12 deletions
+22 -5
View File
@@ -18,7 +18,7 @@ silver_pose/
└── progress.md # 只追加执行流水
```
## 当前可验证基线
## V1 启动与验证
在 Windows PowerShell、仓库根目录运行:
@@ -26,14 +26,31 @@ silver_pose/
./init.ps1
```
它会检查当前 Python 环境并编译 `demo/`。图形界面可用:
它会检查当前 Python 环境、编译旧 `demo/` 基线并运行 V1 测试。首次部署先安装锁定依赖:
```powershell
Set-Location demo
python main.py
python -m pip install -r v1/requirements.txt
```
运行 GUI 或 RTSP 演示前,必须在本机准备已安装的 PyQt5、OpenCV、NumPy 与 Ultralytics 环境。真实 RTSP 凭证不得提交。
将 `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` 是人体姿态模型,不是摔倒分类器,也不构成医疗级或全场景可靠性承诺。
## 文档入口