zh CN principles architecture

服务、节点与数据的分工

单机安装时，浏览器、AKStream.Next、NodeAgent、MediaServer 和数据库协同工作。多机部署时可以分开职责，但每个节点仍须能到达它需要的控制面、媒体服务、数据库和存储。

flowchart TB
    U["用户浏览器 / 第三方程序"] --> A["AKStream.Next：网页、API、权限、任务"]
    A --> DB["数据库：设备、通道、配置、索引"]
    A --> M["MediaServer：媒体流、协议输出"]
    M --> FS["录像磁盘：实际音视频文件"]
    N["NodeAgent：受控启停与恢复"] --> A

Loading

组件	主要工作	发生问题时先看什么
AKStream.Next	提供 WebUI/API，管理身份、通道、命令和状态	/health、应用日志、目标 API 结果
NodeAgent	按平台允许的动作管理主服务生命周期	Agent 状态、系统服务日志
MediaServer	收发视频并提供播放出口	节点进程、目标流、对应协议端口
数据库	保存业务对象与文件索引	连接测试、迁移和查询结果
录像磁盘	保存实际文件	挂载、可写、空间与文件路径

数据库中有录像文件记录，不代表文件一定仍在磁盘；MediaServer 中有在线流，也不代表浏览器一定能解码。运维时从用户看到的结果倒推，找到第一处不一致。

一体化是第一次部署的稳妥起点。多节点可分离主控与媒体职责，但不保证正在传输的媒体会话在节点故障时无损迁移。控制面多实例和共享任务消费还需要按当前版本、数据库及实际负载单独验收，不能只因界面显示两个节点就认定具备自动容灾。

准备部署时先看安装与首次配置；上线后按日常巡检保存基线。