[T-014] 建立 Sense 本地 16 路批量收敛与容量基线 #49

2026-08-10T23:16:54+08:00

ila commented

2026-08-10 23:16:54 +08:00

任务映射

Closes [T-014] 建立 Sense 本地 16 路批量收敛与容量基线 (#47)
task_file: docs/tasks/T-014.md
context_ref: 8ebb8ced492c614106e766192c59b7f13fb4ad0f
claim_branch: claims/T-014
work_branch: agent/codex/T-014
write_paths:
- docs/tasks/T-014.md
- Sense/README.md
- Sense/scripts/t014-capacity.ps1
- docs/00-ai-start-here.md
- docs/03-tech-stack.md
- docs/04-architecture.md
- docs/06-tasks.md
- docs/current-state.md
- docs/research/sense-16-stream-capacity.md
- tests/test_sense_capacity_contract.py

变更摘要

新增可重复的 Windows 本地 16 路容量脚本和静态契约测试：使用隔离 PostgreSQL v5、真实 Sense Control API、两套 MediaMTX 与 16 个独立预编码合成 publisher，验证 17 路配额拒绝、三轮 16→0→16 批量收敛、固定四路故障隔离/恢复、30 分钟稳定窗口、资源观测及安全清理。同步 README、技术栈、架构、路线图、当前状态和正式研究报告。

正式结果绑定提交 d029067aa750ad75a2d79ef8e6c51b6bad55096d：Go 1.26.5，1800.1 s / 180 个 10 秒样本，最大/最终 unconverged=0，最终在线 Path 16，聚合入站 15.443 Mbps，帧错误 0。结果只代表本机低码率合成负载的软件基线，不解除 T-007/T-013，不形成真实 16 机、网络、录像、AI/GPU、64/128 路或生产 SLA。

验证证据

命令	结果
`./Sense/scripts/t014-capacity.ps1 -PgRoot D:\pgsql17 -OutputPath (Join-Path $env:TEMP 'yovision-t014-formal-final.json')`	通过；formal=true，1800.1 s / 180 样本，16 路在线，未收敛 0，清理后 session/受管进程 0
`python -m unittest discover -s tests -p "test_sense_capacity_contract.py" -v`	6/6 通过
`./init.ps1`	通过；58 个 Python 测试、生成漂移、全部 Sense Go 包测试、vet/build 成功
`./scripts/test_postgres.ps1 -PgRoot D:\pgsql17`	通过；PostgreSQL 17.10 隔离 migration/权限/repository 测试成功并清理
三条 Python 治理命令 + `git diff --check`	通过

风险与回滚

本基线不含真实摄像头、客户网络、录像、reader、AI/GPU 或分片，不可外推为生产 SLA。
回滚本 PR 即移除容量脚本/测试与对应文档，不涉及生产 migration、公共 API 或持久数据。
运行期只使用随机回环端口和系统临时目录；结果不含秘密或敏感拓扑。

检查清单

当前 PR 只对应一个任务 / Issue。
变更未超出 write_paths，没有夹带无关修改。
任务文件执行记录包含相同的验证证据。
合并前任务文件 frontmatter 已为 DONE。
未提交 Token、Authorization header、私有配置或实例地址。
Issue 已切换到唯一 status/review；创建 PR 后立即切换，合并后才标记 status/done。

## 任务映射 - Closes #47 - task_file: `docs/tasks/T-014.md` - context_ref: `8ebb8ced492c614106e766192c59b7f13fb4ad0f` - claim_branch: `claims/T-014` - work_branch: `agent/codex/T-014` - write_paths: - `docs/tasks/T-014.md` - `Sense/README.md` - `Sense/scripts/t014-capacity.ps1` - `docs/00-ai-start-here.md` - `docs/03-tech-stack.md` - `docs/04-architecture.md` - `docs/06-tasks.md` - `docs/current-state.md` - `docs/research/sense-16-stream-capacity.md` - `tests/test_sense_capacity_contract.py` ## 变更摘要新增可重复的 Windows 本地 16 路容量脚本和静态契约测试：使用隔离 PostgreSQL v5、真实 Sense Control API、两套 MediaMTX 与 16 个独立预编码合成 publisher，验证 17 路配额拒绝、三轮 16→0→16 批量收敛、固定四路故障隔离/恢复、30 分钟稳定窗口、资源观测及安全清理。同步 README、技术栈、架构、路线图、当前状态和正式研究报告。正式结果绑定提交 `d029067aa750ad75a2d79ef8e6c51b6bad55096d`：Go 1.26.5，`1800.1 s / 180` 个 10 秒样本，最大/最终 `unconverged=0`，最终在线 Path 16，聚合入站 15.443 Mbps，帧错误 0。结果只代表本机低码率合成负载的软件基线，不解除 T-007/T-013，不形成真实 16 机、网络、录像、AI/GPU、64/128 路或生产 SLA。 ## 验证证据 | 命令 | 结果 | | --- | --- | | `./Sense/scripts/t014-capacity.ps1 -PgRoot D:\pgsql17 -OutputPath (Join-Path $env:TEMP 'yovision-t014-formal-final.json')` | 通过；formal=true，1800.1 s / 180 样本，16 路在线，未收敛 0，清理后 session/受管进程 0 | | `python -m unittest discover -s tests -p "test_sense_capacity_contract.py" -v` | 6/6 通过 | | `./init.ps1` | 通过；58 个 Python 测试、生成漂移、全部 Sense Go 包测试、vet/build 成功 | | `./scripts/test_postgres.ps1 -PgRoot D:\pgsql17` | 通过；PostgreSQL 17.10 隔离 migration/权限/repository 测试成功并清理 | | 三条 Python 治理命令 + `git diff --check` | 通过 | ## 风险与回滚 - 本基线不含真实摄像头、客户网络、录像、reader、AI/GPU 或分片，不可外推为生产 SLA。 - 回滚本 PR 即移除容量脚本/测试与对应文档，不涉及生产 migration、公共 API 或持久数据。 - 运行期只使用随机回环端口和系统临时目录；结果不含秘密或敏感拓扑。 ## 检查清单 - [x] 当前 PR 只对应一个任务 / Issue。 - [x] 变更未超出 `write_paths`，没有夹带无关修改。 - [x] 任务文件执行记录包含相同的验证证据。 - [x] 合并前任务文件 frontmatter 已为 `DONE`。 - [x] 未提交 Token、Authorization header、私有配置或实例地址。 - [ ] Issue 已切换到唯一 `status/review`；创建 PR 后立即切换，合并后才标记 `status/done`。

ila added 9 commits 2026-08-10 23:16:54 +08:00

chore(task): claim T-014