70 lines
5.1 KiB
Markdown
70 lines
5.1 KiB
Markdown
# 当前实现状态
|
||
|
||
> 快照日期：2026-08-04。只记录仓库现实与 blocker；任务实时状态到 Gitea Issue 查看。
|
||
|
||
## 当前阶段
|
||
|
||
- 阶段：M0 已收敛为首期指定摄像头型号准入，实机验证尚未执行；M1 Sense 无实机软件骨架已完成，但不得提前宣称 M0/M1 出口完成。
|
||
- 生产代码：Sense M1 无实机骨架已建立，包含可构建进程、SQLite 台账、ONVIF port/fake、MediaMTX 生成客户端、最小对账与探活；真实 ONVIF adapter 和单实机混合源验收仍未开始。
|
||
- 默认容量：16 路；单站点本阶段上限 128 路，必须横向分片。
|
||
|
||
## 仓库现实
|
||
|
||
- `Sense/` 已有 Go module 与 `cmd/sense-api`；`Brain/`、`Bell/` 仍只有目录占位。
|
||
- Sense 设备模型使用 `modality + capabilities`，SQLite 执行 v1 migration；视频配额默认 16、允许 1～128，17/128/129、新增/启用和“降低配额不关闭已有流”均有测试。
|
||
- MediaMTX 固定为独立二进制 `v1.19.3`，官方 OpenAPI 已按 SHA-256 vendoring，并由固定 `oapi-codegen v2.8.0` 生成客户端；手写薄封装有 create/read/delete、幂等 ensure 与探活假 HTTP 测试。
|
||
- T-003 对账进度与指数退避持久化，覆盖取消和 SQLite 重启恢复；当前不枚举/删除孤儿，也不包含真实摄像头 adapter。
|
||
- `docs/raw/01`～`08` 已记录需求、分析、方案、客户场景、事件比对和三系统职责。
|
||
- `docs/raw/contracts/event-v0.1.schema.json` 已冻结，并有多份示例与语义说明。
|
||
- harness coding 文档、上下文清单、Gitea Issue/PR 模板和治理脚本已接入。
|
||
- Gitea 已初始化 12 个协作标签；`status/waiting` 用于依赖或外部条件未满足的未领取任务，实时可领取状态必须从 Gitea 查询，不在本文复制。
|
||
- T-002 已关闭架构影响型问题：首期 S2 民办寄宿学校、客户侧私有部署、ONVIF/RTSP、NVIDIA 主路径、自研 Bell、Web/H5 与客户侧证据存储等边界已批准。
|
||
- T-004 的 Sense/Bell 单文件交互原型已获产品确认；T-005 已归档 Claude 原稿并补录缺失评审文档，当前定稿与原始依据分开保存。
|
||
- `_reference/mibeenvr` 为本地只读参考仓库，已被忽略；只允许 M0 实验与白名单借鉴。
|
||
|
||
## 当前可运行命令
|
||
|
||
Windows：
|
||
|
||
```powershell
|
||
./init.ps1
|
||
```
|
||
|
||
该入口会下载锁定 Go module，运行三条治理验证、MediaMTX 客户端生成漂移检查、`go test`、`go vet` 和 `go build`。只启动 Sense：
|
||
|
||
```powershell
|
||
go -C Sense run ./cmd/sense-api
|
||
```
|
||
|
||
跨平台直接验证：
|
||
|
||
```powershell
|
||
python scripts/validate_agent_context.py
|
||
python -m unittest discover -s tests -p "test_*.py"
|
||
python scripts/validate_harness_governance.py
|
||
```
|
||
|
||
Sense 默认监听 `127.0.0.1:8080`，提供 `/healthz` 与 `/readyz` 运维探针；它们不代表摄像头或 M1 里程碑健康。MediaMTX 获取、校验和独立启动方法见 `Sense/README.md`。
|
||
|
||
## 当前 blocker / 待确认
|
||
|
||
- 项目负责人已将 T-001 重构为一个指定型号/固件基线、至少一台真实样机的 ONVIF/RTSP 准入；数量条件已满足，但实物身份、隔离网络、ONVIF 账号和原始证据仍须在领取后核验。单样机结论不代表批次或多品牌兼容。
|
||
- 后续本地开发统一使用现有一台 Hikvision IP Camera；T-006 以该实机 + 至少 4 条独立合成 RTSP 源完成五路软件闭环，不要求当前购买更多摄像头。合成 publisher 的具体工具和版本在 T-006 领取后冻结。
|
||
- T-007 保留至少 5 条独立真实上游的客户现场门禁，可使用客户授权、借用或租赁设备；它不阻塞本地开发/M1 实验室出口，但继续阻塞生产试点和真实多路 SLA。
|
||
- S2 真实生产试点的未成年人影像、公共安全视频法规适用性和最终留存政策仍需客户/法务确认，阻塞 M3 上线但不阻塞 M1 实验室骨架。
|
||
- 人脸方向已延后至 M5 的 S4 成人园区候选试点；必要性/PIP 影响评估、单独同意与替代方式、合法底库来源和删除流程未完成，阻塞人脸能力上线。
|
||
- 短信/语音具体供应商未选；生产前必须选定两条独立投递路径并验证故障切换。
|
||
- Python/PostgreSQL/Savant 的精确版本、目标硬件和 Bell 前端栈尚未冻结；Sense M1 的 Go、SQLite driver、MediaMTX、生成器及生成运行时版本已在 T-003 冻结。
|
||
- 代码知识图谱在无业务代码阶段可能为空；工具不可用时使用 `rg` 处理文档与配置。
|
||
|
||
## 下一步
|
||
|
||
先领取并完成 T-001 海康指定型号准入；随后 T-006 使用该一台实机和至少 4 条独立合成 RTSP 上游完成五路软件闭环，无需采购额外摄像头。客户/借用/租赁条件具备后再执行 T-007 真实多路现场门禁。实时领取状态仍以 Gitea 为准。
|
||
|
||
## 已知风险
|
||
|
||
- M0 临时 NVR 容易被误当生产基线，必须持续隔离。
|
||
- 16 路默认值容易被写死，任务评审需专项搜索和测试边界值 17/128/129。
|
||
- 未经真实硬件压测不能给出 GPU 路数承诺。
|
||
- Gitea 使用 HTTP；token 传输风险只在本机私有配置中接受，不把 token 或实例配置写入仓库。
|