能力、兼容性与已知边界

功能在代码中存在，不等于任意设备、网络和规模都已经生产验证。采购、方案与上线决策应标记证据等级。

flowchart LR
    A[L1 已实现] --> B[L2 构建通过]
    B --> C[L3 自动回归]
    C --> D[L4 真实环境]
    D --> E[L5 生产观察]

证据等级

对目标场景只声明实际达到的等级。

当前明确能力

• Linux、Windows、macOS 与 Docker 的部署和宿主治理。
• 统一设备、通道、MediaServer、流与录像管理。
• ONVIF 发现、Profile、拉流、PTZ、Imaging、事件和对讲相关流程。
• GB28181 Server/Client、目录、实时流、回放、控制、订阅和级联相关流程。
• RTSP 拉流、HLS/FLV/RTSP/RTMP/WebRTC 等媒体出口。
• 录像计划、文件索引、播放下载、磁盘治理与裁剪合并。
• RTC 房间、成员、WHIP/WHEP 媒体会话与事件。
• NodeAgent、配置版本、任务、日志、安全与审计。

具体能力仍取决于当前版本、启用模块、授权与现场兼容验证。

不应误解的边界

• RTC 是基于 MediaServer 的 SFU 控制面，不提供服务端 MCU 混流/转码。
• 多节点不保证已有 RTP、RTSP 或 RTC 会话无损迁移。
• 控制面多实例 Active/Active 的任务与事件消费需要专项验证。
• ONVIF 与 GB28181 的厂商私有扩展需要真实设备矩阵。
• GB28181 已有多版本协商骨架，但不能宣传已经完成 2022 全量扩展命令与正式符合性认证。
• FFmpeg 不是所有场景必需，但裁剪、转码等能力依赖它。
• Linux 主服务由 NodeAgent 独立恢复且 unit 使用 Restart=no；NodeAgent 自身仍由 systemd 保活。其他平台必须按当前发布清单验证唯一恢复所有者，不能假定多套策略可以安全并行。
• 浏览器不能原生播放 RTSP。
• GPS FileSegment 是节点独占写入格式，不支持多个进程并发写同一共享目录。

兼容矩阵必须记录

• AKStream.Next、WebUI、NodeAgent、MediaServer、数据库和 FFmpeg 版本；
• 操作系统、CPU 架构和部署方式；
• 浏览器版本与网络类型；
• 设备厂商、型号、固件和协议版本；
• RTP TCP/UDP、NAT、TURN 与媒体编码；
• 验收日期、证据和已知差异。

升级时复制旧矩阵形成目标版本计划。没有证据的单元格标记“未验证”，不能默认为兼容。