Table of Contents

25 MediaMTX 进程与状态对账

背景与目标
最终方案
修改文件
验收结果
测试
相关提交
用户验收

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

25 MediaMTX 进程与状态对账

类型：需求
所属 Epic：#7
所属 MVP / 版本：#8
状态：已完成
日期：2026-08-12
Gitea 工单：#25
Wiki 页面：Task-25-MediaMTX进程与状态对账
Wiki revision：见本地镜像头

背景与目标

让 Sense 管理外部 MediaMTX 的期望配置、进程和状态收敛，而不嵌入媒体内核。

最终方案

实现只管理自身进程句柄的 Supervisor、最多三次重启边界、localhost v3 Control API、媒体路径期望/实际状态、reader 数和对账审计。源秘密只在本机控制请求中瞬时组装，不写仓库、数据库、日志或 Sense 响应。

与已确认方案一致。为使用 #21 的模块注册和项目内窄端口，实施前已在工单评论中记录精确集成 write_path；未修改 contracts、Brain、Bell 或根级部署。

修改文件

Sense/server/app/sense/：本工单后端领域、适配器、服务、HTTP 与测试。
Sense/server/cmd/sense/modules_*.go：独立模块注册文件。
Sense/server/database/migrations/：本工单需要的 PostgreSQL 迁移（如适用）。
Sense/ui/src/：本工单 API、页面、路由及明确需要的局部业务组件。
Sense/tests/、Sense/testdata/：无生产数据、无真实秘密的验收说明与夹具。

验收结果

控制 API 方法、瞬时凭据、进程显式启动、正常/启动失败/控制失败/停止 fake 测试和 race 测试通过。

工单保持 open / 待验收，未代替用户执行浏览器、真实设备或部署环境验收。

测试

Go 1.26.5 go vet ./...：通过。
Go 1.26.5 go test -race ./...：全部通过。
Go 1.26.5 go test -count=1 ./...：全部通过。
Go 1.26.5 go build ./...：通过。
corepack pnpm@9.15.1 install --frozen-lockfile：通过。
corepack pnpm@9.15.1 lint --quiet：通过。
corepack pnpm@9.15.1 build：通过；仅有 Element Plus vendor bundle 体积建议警告。
Sense 独立 smoke、Harness 严格检查和 31 项 Harness 测试：通过。
未验证部分：本机无 MediaMTX 二进制和实验室流，未验证真实进程启动、崩溃恢复、拉流、reader 与部署版本兼容。

用户验收

2026-08-14：用户明确确认当前未验收工单通过验收。
本次验收确认该工单在历史 explore 快照中的交付与证据；不恢复旧自研基础框架为 dev 产品基线，后续迁移仍受 #58、#61、#62 约束。