概述

微应用架构是平台的核心扩展机制。每个 AI 应用（如写标书、去水印、音乐创作等）都是一个独立的微应用模块， 通过统一的 Manifest 清单注册到平台，实现独立开发、独立部署、热插拔加载。

Manifest 清单规范

// shared/micro-app/types.ts
export interface MicroAppManifest {
  id: string;              // 唯一标识，如 "bid"
  name: string;            // 显示名称，如 "AI写标书"
  version: string;         // 语义化版本号
  description: string;     // 功能描述
  icon: string;            // lucide-react 图标名
  category: string;        // 分类：image/audio/video/document
  creditsPerUse: number;   // 每次调用消耗积分
  routes: RouteConfig[];   // 前端路由配置
  adminRoutes?: RouteConfig[]; // 后台管理路由
  apiPrefix: string;       // 后端 API 前缀
  features: string[];      // 功能标签
  status: 'active' | 'beta' | 'deprecated';
}

注册流程

动态路由加载

前端通过 AppRouter.tsx 动态加载微应用路由。 每个微应用的 index.ts 导出 getRouteComponents() 和getAdminRouteComponents() 两个函数，分别返回用户端和管理后台的路由组件映射。

// client/src/micro-app/apps/bid/index.ts
export function getRouteComponents() {
  return {
    'BidApp': lazy(() => import('@/pages/ai/BidApp')),
    'BidHistory': lazy(() => import('@/pages/ai/BidHistory')),
  };
}

export function getAdminRouteComponents() {
  return {
    'BidScales': lazy(() => import('@/pages/admin/apps/bid/Scales')),
    'BidPrompts': lazy(() => import('@/pages/admin/apps/bid/Prompts')),
  };
}

CI 校验

提交代码时，CI 自动运行以下校验脚本，确保新应用符合规范：

相关文档