平台架构与运行形态

平台架构与运行形态

平台由后端业务服务、Saber 宿主、Saber-Kit 契约包和 Saber-AI 业务远端组成。

工程职责

工程	主要内容
BladeX-AI-Pro	启动装配、AI 业务服务、六个引擎及系统能力适配
Saber	登录、会话、菜单、权限、布局、主题、国际化与请求拦截链
Saber-Kit	平台契约、公共组件、工具、联邦工厂和开发外壳
Saber-AI	AI 路由、业务页面、自研前端引擎和分享入口

宿主与业务远端通过 @saber/micro 协作，互不引用对方源码。装入宿主的业务页面运行在同一 Vue 组件树中。

宿主集成

开发入口为 http://localhost:1888/。Saber 登录后读取已授权菜单，按 /ai/** 路径装载 AI 远端，再以宿主布局承载页面。模型、知识库和应用等操作均通过统一平台请求链访问后端。

联调步骤见 前端宿主集成。

独立开发

开发入口为 http://localhost:1881/。Saber-AI 使用 @saber/micro/dev 创建开发外壳，装载同一份业务路由。侧栏与展示身份来自开发配置，接口仍由真实后端认证。

开发外壳的 index.html 不进入联邦生产产物。生产部署由 Saber 承载管理端。

启动步骤见 AI 业务独立调试。

分享与嵌入

访客入口位于 /share/ai/，由 src/share.ts 和 vite.share.config.mts 独立构建。产物包括 share.html 与 embed.js。

应用、智能体、知识库和问数提供资源运行页；仪表盘提供看板访问；创作作品提供指定版本的只读分享。iframe 与气泡嵌入使用对应分享入口，访问权限由资源与分享配置决定。

后端分层

启动模块 blade-api 装配 blade-ai-business 和系统 SPI 适配。业务层组织接口、服务、持久化与权限，引擎层实现各领域执行逻辑，公共数据对象位于对应引擎模块。

具体依赖关系见 模块分层与依赖关系。