MBE 完整系统架构
版本: 3.1.0 | 更新日期: 2026-02-09
概述
MBE (Mises Behavior Engine) 是一个基于米塞斯人类行为学理论的完整AI决策分析系统。本文档描述了系统的完整架构设计。
系统架构图
┌──────────────────────────────────────────────────────────────────────────────┐
│ MBE 完整系统架构 v3.1 │
├──────────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────────────────────────────┐ │
│ │ Cloudflare Tunnel │ │
│ │ mbe.hi-maker.com | edu.hi-maker.com | aigc.hi-maker.com | lawyer... │ │
│ └─────────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ┌───────────────────────────────────┼───────────────────────────────────┐ │
│ │ 前端应用层 │ │
│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │
│ │ │ Admin UI │ │MBE Education│ │AIGC Committee│ │Civil Lawyer │ │ │
│ │ │ :3000 │ │ :3001 │ │ :3002 │ │ :3004 │ │ │
│ │ │ 管理后台 │ │ 学习平台 │ │ 审核平台 │ │ 法律咨询 │ │ │
│ │ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │ │
│ │ │ │ │
│ │ ┌─────────────────────────────────────────────────────────────────┐ │ │
│ │ │ @mbe/ui 设计系统 │ │ │
│ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │
│ │ │ │GlassCard │ │ Button │ │ Badge │ │ Input │ ... │ │ │
│ │ │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │ │ │
│ │ │ @mbe/design-tokens + @mbe/tailwind-config │ │ │
│ │ └─────────────────────────────────────────────────────────────────┘ │ │
│ └────────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌────────────────────────────────────────────────────────────────────────┐ │
│ │ MBE Core API (:8000) │ │
│ │ ┌───────────────────────────────────────────────────────────────────┐ │ │
│ │ │ FastAPI 应用 │ │ │
│ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │
│ │ │ │ /api/* │ │ /mcp/* │ │ /admin/* │ │/expert/* │ │ │ │
│ │ │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │ │ │
│ │ └───────────────────────────────────────────────────────────────────┘ │ │
│ │ ┌───────────────────────────────────────────────────────────────────┐ │ │
│ │ │ 市场服务 │ │ │
│ │ │ ┌──────────────────┐ ┌──────────────────┐ │ │ │
│ │ │ │ Expert Market │ │ App Market │ │ │ │
│ │ │ │ 专家市场 │ │ 应用市场 │ │ │ │
│ │ │ └──────────────────┘ └──────────────────┘ │ │ │
│ │ └───────────────────────────────────────────────────────────────────┘ │ │
│ └────────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌────────────────────────────────────────────────────────────────────────┐ │
│ │ AI 核心引擎层 │ │
│ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │
│ │ │ TITANS │ │ MIRAS │ │ HOPE │ │ MoE │ │ │
│ │ │ │ │ │ │ │ │ │ │ │
│ │ │ 神经记忆 │ │ 多尺度检索 │ │ 在线学习 │ │ 专家混合 │ │ │
│ │ │ - 短期64 │ │ - 局部4 │ │ - 惊喜驱动 │ │ - 43专家 │ │ │
│ │ │ - 中期256 │ │ - 上下文6 │ │ - 持续优化 │ │ - Top-2激活 │ │ │
│ │ │ - 长期512 │ │ - 全局8 │ │ - 个性化 │ │ - 稀疏路由 │ │ │
│ │ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘ │ │
│ │ │ │
│ │ ┌────────────────────────────────────────────────────────────────┐ │ │
│ │ │ Unified Knowledge Graph 统一知识图谱 │ │ │
│ │ │ (NetworkX DiGraph) │ │ │
│ │ │ │ │ │
│ │ │ 节点类型: Expert | Domain | Keyword | Topic | User | KP │ │ │
│ │ │ 边类型: COVERS | BELONGS_TO | RELATED_TO | PREFERS | ... │ │ │
│ │ │ 能力: 多跳推理 | 环检测 | 拓扑排序 | PageRank | 增量持久化 │ │ │
│ │ └────────────────────────────────────────────────────────────────┘ │ │
│ │ │ │
│ │ ┌────────────────────────────────────────────────────────────────┐ │ │
│ │ │ Expert Router 专家路由 │ │ │
│ │ │ 25+ 业务专家: 法律、烹饪、健身、心理、技术、教育... │ │ │
│ │ │ └─ 集成图谱路由: 互补专家查找、用户偏好增强、反馈闭环 │ │ │
│ │ └────────────────────────────────────────────────────────────────┘ │ │
│ └────────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌────────────────────────────────────────────────────────────────────────┐ │
│ │ 存储层 │ │
│ │ ┌────────────────────────┐ ┌────────────────────────┐ │ │
│ │ │ PostgreSQL + pgvector │ │ Redis │ │ │
│ │ │ :5432 │ │ :6379 │ │ │
│ │ │ │ │ │ │ │
│ │ │ - 用户数据 │ │ - 会话缓存 │ │ │
│ │ │ - 专家配置 │ │ - 任务队列 │ │ │
│ │ │ - 向量嵌入 │ │ - 实时状态 │ │ │
│ │ │ - 知识库 │ │ - 限流计数 │ │ │
│ │ │ - 闭环事件 │ │ │ │ │
│ │ │ - 评估结果 │ │ │ │ │
│ │ └────────────────────────┘ └────────────────────────┘ │ │
│ │ │ │
│ │ ┌────────────────────────────────────────────────────────────────┐ │ │
│ │ │ 统一知识图谱存储 (文件系统) │ │ │
│ │ │ data/graph/ │ │ │
│ │ │ - nodes.jsonl (增量保存) │ │ │
│ │ │ - edges.jsonl (增量保存) │ │ │
│ │ │ - metadata.json (图谱元数据) │ │ │
│ │ └────────────────────────────────────────────────────────────────┘ │ │
│ └────────────────────────────────────────────────────────────────────────┘ │
│ │
└───────────────────────────────────────────────────────────────────────────────┘
设计系统架构
包结构
packages/
├── mbe-design-tokens/ # 设计令牌包
│ ├── tokens/
│ │ ├── colors.json # 颜色定义
│ │ ├── typography.json # 字体定义
│ │ ├── spacing.json # 间距定义
│ │ └── effects.json # 效果定义
│ ├── dist/
│ │ ├── tokens.css # CSS变量输出
│ │ ├── tokens.js # JavaScript输出
│ │ └── tokens.d.ts # TypeScript类型
│ └── package.json
│
├── mbe-ui/ # UI组件库
│ ├── src/
│ │ ├── components/
│ │ │ ├── GlassCard/ # 毛玻璃卡片
│ │ │ ├── Button/ # 按钮组件
│ │ │ ├── Badge/ # 徽章组件
│ │ │ ├── Input/ # 输入框
│ │ │ ├── Skeleton/ # 骨架屏
│ │ │ └── Toast/ # 提示组件
│ │ └── index.ts # 统一导出
│ └── package.json
│
└── mbe-tailwind-config/ # Tailwind配置
├── tailwind.config.js # 预设配置
└── package.json
组件依赖关系
@mbe/design-tokens
│
┌────────────┴────────────┐
▼ ▼
@mbe/ui @mbe/tailwind-config
│ │
└────────────┬────────────┘
▼
前端应用
(MBE Education, AIGC Committee, Civil Lawyer)
前端应用架构
MBE Education
opensource/mbe-education/frontend/
├── app/
│ ├── page.tsx # 首页
│ ├── student/[id]/
│ │ ├── page.tsx # 学生仪表板
│ │ ├── courses/page.tsx # 课程列表
│ │ └── learn/[courseId]/ # 学习页面
│ ├── teacher/[id]/ # 教师端
│ ├── developer/ # 开发者端
│ └── admin/ # 管理端
├── components/ # 本地组件
├── lib/ # 工具函数
└── tailwind.config.ts # 继承 @mbe/tailwind-config
AIGC Committee
opensource/mbe-aigc-committee/frontend/
├── app/
│ ├── page.tsx # 首页
│ ├── dashboard/ # 仪表板
│ ├── review/ # 审核页面
│ └── settings/ # 设置页面
└── tailwind.config.ts
Civil Lawyer
opensource/mbe-civil-lawyer/frontend/
├── app/
│ ├── page.tsx # 首页
│ ├── consult/ # 咨询页面
│ ├── cases/ # 案例库
│ └── about/ # 关于页面
└── tailwind.config.ts
Docker 部署架构
服务组成
services:
# 基础设施
postgres: # PostgreSQL + pgvector
redis: # Redis 缓存
# 核心服务
mbe-api: # FastAPI 后端
# 前端应用
mbe-admin-ui: # 管理后台
mbe-education: # 教育平台
mbe-aigc-committee: # AIGC审核
mbe-civil-lawyer: # 法律咨询
# 公网访问 (生产环境)
cloudflared: # Cloudflare Tunnel
网络拓扑
Internet
│
▼
┌─────────────────┐
│ Cloudflare Edge │
│ (CDN + WAF) │
└────────┬────────┘
│
▼
┌─────────────────┐
│ Cloudflare │
│ Tunnel (本地) │
└────────┬────────┘
│
┌──────────────┼──────────────┐
▼ ▼ ▼
┌─────────┐ ┌─────────┐ ┌─────────┐
│ MBE API │ │Education│ │ Lawyer │
│ :8000 │ │ :3001 │ │ :3004 │
└─────────┘ └─────────┘ └─────────┘
│
▼
┌─────────────────────────┐
│ mbe-network (Docker) │
│ PostgreSQL + Redis │
└─────────────────────────┘
数据流
用户请求流程
1. 用户访问 edu.hi-maker.com
│
2. Cloudflare Edge (CDN缓存、WAF防护)
│
3. Cloudflare Tunnel → 本地 mbe-education:3001
│
4. Next.js 服务端渲染 / API 路由
│
5. 调用 MBE Core API (mbe-api:8000)
│
6. Expert Router → 匹配专家
│
├─→ Unified Graph → 图谱路由、互补专家、用户偏好
│
7. TITANS Memory → 检索知识
│
8. MIRAS 多尺度检索 → 图谱上下文增强
│
9. LLM 生成响应
│
10. HOPE 学习 → 更新记忆
│
11. Unified Graph → 同步实体、更新偏好、记录交互
│
12. 返回响应给用户
专家问答流程
用户提问: "什么是合同违约?"
│
▼
┌─────────────────┐
│ Expert Router │ → 匹配 "中国民事律师" 专家
└────────┬────────┘
│
├─────────────────────────────────┐
│ │
▼ ▼
┌─────────────────┐ ┌──────────────────────┐
│ Unified Graph │ │ TITANS Memory │
│ 图谱路由增强 │ │ 检索 350,000+ 案例 │
│ - 互补专家查找 │ └──────────┬───────────┘
│ - 用户偏好加权 │ │
│ - 领域关系推理 │ │
└────────┬────────┘ │
│ │
└──────────────┬──────────────────┘
│
▼
┌─────────────────┐
│ MIRAS 多尺度 │ → 局部/上下文/全局检索 + 图谱上下文增强
└────────┬────────┘
│
▼
┌─────────────────┐
│ MoE 专家路由 │ → 激活 Top-2 相关专家
└────────┬────────┘
│
▼
┌─────────────────┐
│ LLM 生成 │ → DeepSeek/Qwen 生成回答
└────────┬────────┘
│
▼
┌─────────────────┐
│ HOPE 学习 │ → 记录交互，更新偏好
└────────┬────────┘
│
▼
┌─────────────────┐
│ Unified Graph │ → 同步实体追踪、更新用户偏好、记录咨询历史
│ 图谱同步 │
└────────┬────────┘
│
▼
返回专业法律解答
技术选型
| 层级 | 技术 | 理由 |
|---|---|---|
| 前端框架 | Next.js 14 | App Router, SSR, 性能优异 |
| UI库 | React 18 | 生态丰富, Hooks支持 |
| 样式 | Tailwind CSS | 原子化, 高效开发 |
| 设计令牌 | Style Dictionary | 跨平台, 多格式输出 |
| 动画 | Framer Motion | 流畅, 声明式 |
| 后端 | FastAPI | 异步, 高性能, 类型安全 |
| 数据库 | PostgreSQL + pgvector | 关系型 + 向量存储 |
| 缓存 | Redis | 高性能, 丰富数据结构 |
| 图谱引擎 | NetworkX | 图算法、拓扑排序、PageRank |
| 容器 | Docker | 标准化, 易部署 |
| 编排 | Docker Compose | 简单, 适合单机 |
| 公网 | Cloudflare Tunnel | 免费, 安全, 无需公网IP |
| 包管理 | pnpm | 快速, 节省空间 |
| 构建 | Turborepo | Monorepo 优化 |
安全架构
认证授权
┌─────────────────────────────────────────┐
│ 认证流程 │
├─────────────────────────────────────────┤
│ 1. 用户登录 → JWT Token │
│ 2. Token 存储 → HttpOnly Cookie │
│ 3. 请求携带 → Authorization Header │
│ 4. 后端验证 → Token + 权限检查 │
└─────────────────────────────────────────┘
角色权限
| 角色 | 权限 |
|---|---|
| super_admin | 全部权限 |
| admin | 用户管理、专家管理 |
| operator | 内容审核、运营 |
| developer | 创建知识库、发布专家 |
| enterprise | 批量API调用 |
| user | 使用专家、订阅 |
监控告警
指标收集
- 应用指标: 响应时间、错误率、QPS
- 系统指标: CPU、内存、磁盘、网络
- 业务指标: 用户活跃、专家调用、收入
日志架构
应用日志 → stdout → Docker logs → 日志聚合
扩展性设计
水平扩展
Load Balancer
│
┌────────────────┼────────────────┐
▼ ▼ ▼
┌─────────┐ ┌─────────┐ ┌─────────┐
│ API-1 │ │ API-2 │ │ API-3 │
└─────────┘ └─────────┘ └─────────┘
│ │ │
└────────────────┼────────────────┘
▼
Shared DB/Redis
微服务演进路径
- 当前: 单体 + 前端分离
- 近期: 核心服务拆分 (Expert, Market)
- 远期: 完整微服务架构
统一知识图谱架构
概述
统一知识图谱 (Unified Knowledge Graph, UKG) 是 MBE 系统的核心知识基础设施，基于 NetworkX 构建，统一管理专家、领域、关键词、用户、话题和知识点之间的关系。
架构设计
┌─────────────────────────────────────────────────────────────────┐
│ UnifiedKnowledgeGraph │
│ (NetworkX DiGraph) │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 节点类型 (NodeType): │
│ ├── Expert (专家节点) │
│ ├── Domain (领域节点) │
│ ├── Keyword (关键词节点) │
│ ├── Topic (话题/实体节点) │
│ ├── User (用户节点) │
│ └── KnowledgePoint (教育知识点节点) │
│ │
│ 边类型 (EdgeType): │
│ ├── COVERS Expert → Domain │
│ ├── BELONGS_TO Keyword → Domain │
│ ├── RELATED_TO Keyword ↔ Keyword (加权) │
│ ├── EXPERT_FOR Expert → Keyword │
│ ├── PREFERS User → Expert/Domain (加权+衰减) │
│ ├── CONSULTED User → Expert (咨询历史) │
│ ├── PREREQUISITE KnowledgePoint → KnowledgePoint │
│ └── IN_COURSE KnowledgePoint → Domain │
│ │
│ 核心能力: │
│ ├── 多跳推理 (multi_hop_query, shortest_path) │
│ ├── 环检测 (would_create_cycle, is_directed_acyclic_graph) │
│ ├── 拓扑排序 (topological_sort, get_learning_path) │
│ ├── 重要度排序 (pagerank, degree_centrality) │
│ ├── 增量持久化 (delta save, not full dump) │
│ └── 线程安全 (read-write lock) │
└─────────────────────────────────────────────────────────────────┘
系统集成点
| 组件 | 集成功能 | Feature Flag |
|---|---|---|
| ExpertRouter | 图谱路由、互补专家查找、反馈闭环 | MBE_GRAPH_EXPERT_ROUTING |
| MIRASMatcher | 用户偏好加权、领域偏好加权 | MBE_GRAPH_MIRAS_CONTEXT |
| ConversationContext | 实体追踪、用户偏好更新 | MBE_GRAPH_CONVERSATION |
| CourseManager | 环检测、学习路径生成、节点同步 | MBE_GRAPH_EDUCATION |
| RetrievalMoE | 结构化查询适配器 | MBE_GRAPH_RETRIEVAL_KG |
数据持久化
- 存储位置:
data/graph/ - 格式: JSONL (增量保存)
- 文件:
nodes.jsonl- 节点数据（增量追加）edges.jsonl- 边数据（增量追加）metadata.json- 图谱元数据（版本、统计信息）
Feature Flags 控制
# 全局开关
MBE_UNIFIED_GRAPH_ENABLED=true
# 组件级别开关（可选）
MBE_GRAPH_EXPERT_ROUTING=true
MBE_GRAPH_MIRAS_CONTEXT=true
MBE_GRAPH_CONVERSATION=true
MBE_GRAPH_EDUCATION=true
MBE_GRAPH_RETRIEVAL_KG=true
性能指标
| 操作 | 100节点 | 1000节点 | 10000节点 |
|---|---|---|---|
| 添加节点 | < 1ms | < 2ms | < 5ms |
| 添加边 | < 1ms | < 2ms | < 5ms |
| 多跳查询 | < 5ms | < 20ms | < 100ms |
| 拓扑排序 | < 2ms | < 10ms | < 50ms |
| PageRank | < 5ms | < 30ms | < 200ms |
| 环检测 | < 1ms | < 5ms | < 20ms |
相关文档
- MBE_GRAPH_MIGRATION_GUIDE.md - 迁移指南
- MBE_GRAPH_FEATURE_FLAGS.md - Feature Flags 使用指南
文档版本: 3.1.0 最后更新: 2026-02-09