Skip to content

架构概览 ​

CosmoEdge 当前仓库是完整产品运行时,而不只是单个推理库或后端程序。

总体结构 ​

text
+---------------------------------------------------------------+
| Web Console                                                   |
| Vue 3 | Vite | Element Plus | Vue Flow | ECharts | i18n        |
+-------------------------------+-------------------------------+
                                | HTTP / WebSocket
                                v
+---------------------------------------------------------------+
| C++ Backend Runtime                                           |
| API Router | Services | Flow | Media | Inference | Database    |
+-------------------------------+-------------------------------+
                                |
                                v
+---------------------------------------------------------------+
| Runtime Package                                               |
| cosmo-engine | nginx | SRS | scripts | resources | data | fonts   |
+---------------------------------------------------------------+

后端入口 ​

入口说明
src/app/main.cc创建 cosmo::app::Application
src/app/application.cc应用启动外壳
src/app/app_init.cc服务注册、初始化、网络服务启动
src/app/AppConstants.h默认 HTTP / WebSocket 端口

主可执行目标:

text
cosmo-engine

服务注册 ​

后端通过 cosmo::service::ServiceRegistry 进行服务装配。

启动流程分为:

  1. 注册基础设施服务。
  2. 注册业务服务。
  3. 初始化服务。
  4. 启动 MQTT、HTTP、WebSocket、设备发现、存储清理、看门狗等运行服务。

主要源码目录 ​

目录说明
src/apiAPI 路由和消息处理
src/app应用入口和启动流程
src/dbDAO 和数据库支持
src/flow任务、算法、动作链路
src/infer模型推理封装
src/linkage告警联动
src/media视频解码、编码、帧处理、OSD
src/mem内存池和设备内存抽象
src/networkHTTP、MQTT、网络消息
src/nn推理后端抽象
src/platform平台相关能力
src/service服务接口和实现
src/util通用工具
src/webVue 3 前端

前端 ​

前端路径:

text
src/web

已确认技术栈:

  • Vue 3
  • Vite 6
  • Vue Router 4
  • Element Plus
  • Axios
  • ECharts
  • Vue I18n
  • Vue Flow

前端构建产物会被安装到发布包的 web 目录。

推理和模型 ​

CosmoEdge 在构建时选择推理后端:

  • x86:ONNX Runtime CPU,直接加载 ONNX 模型。
  • Sophon BM1688/CV186X:BMRT,使用与目标芯片匹配的模型产物。
  • Rockchip RK3576/RV1126B:RKNN Runtime,使用目标平台的 RKNN 模型。

RK3576 的 VLM 使用独立的 RKLLM 路径,并需要匹配的运行时和模型。后端支持、随包模型和 VLM 能力应分别确认。

资源目录:

  • data/resource/aiboxresource_bm1688
  • data/resource/aiboxresource_cv186x
  • data/resource/aiboxresource_x86
  • data/resource/aiboxresource_rknn(Rockchip 目标覆盖资源,结合基础模板使用)

当前模板覆盖检测(YOLO v5/v8/v9/v11/v12/26)、分类、关键点、特征、分割(SAM2)、目标定位(DINO)以及视觉语言模型(Qwen3VL、Qwen3.5)。完整清单以各 data/resource/aiboxresource_*/model_template/ 目录下的实际文件为准。

引擎代码采用 Apache-2.0 许可证。模型与依赖遵循各自许可。

CosmoEdge / 项目咨询

聊聊你的边缘 AI 项目。

模型部署、设备选型或系统对接,都可以从你眼前的问题开始。

商务与项目咨询

hello@cosmowander.ai

安装使用与开源问题前往社区讨论
邮件中可以介绍哪些信息?

先介绍已掌握的部分,其余信息可以在沟通中补充。

  • 应用场景

    想识别什么,事件如何使用

  • 已有条件

    已有的模型、设备或系统

  • 处理需求

    视频路数、频率与时延要求

  • 项目进展

    项目阶段,以及眼前的问题