MBE 行为引擎系统 - 用户操作手册

版本: v1.0
更新日期: 2026-02-02
适用范围: 全部用户角色

📖 目录

系统概述
四层架构说明
角色体系与权限
L1 核心开发者操作指南
L2 专家市场操作指南
L3 应用开发者操作指南
L4 终端用户操作指南
管理员操作指南
常见业务流程
智能终端使用指南
常见问题解答
附录

1. 系统概述

1.1 什么是 MBE

MBE (Mises Behavior Engine) 是一个基于行为经济学的智能学习与决策引擎，采用四层架构设计，为不同角色用户提供个性化的AI服务。

1.2 核心特性

特性	说明
MOE架构	混合专家系统，智能路由到最适合的专家
HOPE学习	惊讶度驱动的持续学习，越用越智能
TITANS记忆	多尺度记忆系统，精准检索知识
五步行为分析	不舒适检测→愿望分析→路径生成→方案评估→行动支持

1.3 系统访问地址

环境	前端地址	API地址
生产环境	https://mbe.hi-maker.com	https://api.mbe.hi-maker.com
开发环境	http://localhost:3000	http://localhost:8001
测试环境	http://staging.mbe.local	http://api.staging.mbe.local

2. 四层架构说明

┌──────────────────────────────────────────────────────────────────────────┐
│  L1: MBE Core (核心引擎层)                                                │
│  角色: Core Developer (核心开发者)                                         │
│  职责: 维护核心算法、提供底层API                                           │
├──────────────────────────────────────────────────────────────────────────┤
│  L2: Expert Marketplace (专家市场层)                                       │
│  角色: Expert Creator (专家创建者) / Expert Admin (专家管理员)              │
│  职责: 创建专家、管理知识库、审核发布                                       │
├──────────────────────────────────────────────────────────────────────────┤
│  L3: Application Market (应用市场层)                                       │
│  角色: App Developer (应用开发者) / App Publisher (应用发布者)              │
│  职责: 开发应用、集成专家、发布上架                                         │
├──────────────────────────────────────────────────────────────────────────┤
│  L4: End Users (最终用户层)                                                │
│  角色: Student / Teacher / Parent / Professional                          │
│  职责: 使用应用、学习成长、提供反馈                                         │
└──────────────────────────────────────────────────────────────────────────┘

3. 角色体系与权限

3.1 角色层级

Level 0: 超级管理员 (super_admin) ─── 全部权限，不可被删除
    │
Level 1: 管理员 (admin) ─── 管理用户、内容、配置
    │
Level 2: 运营员 (operator) ─── 只读权限，查看报表
    │
Level 3: 开发者 (developer) ─── 创建知识库、训练模型
    │
Level 4: 企业用户 (enterprise) ─── 高额度，可创建子账号
    │
Level 5: 普通用户 (user) ─── 标准使用额度

3.2 权限矩阵

权限	super_admin	admin	operator	developer	enterprise	user
管理所有用户	✅	部分	❌	❌	❌	❌
系统配置	✅	✅	❌	❌	❌	❌
查看所有数据	✅	✅	✅	❌	❌	❌
创建知识库	✅	❌	❌	✅	❌	❌
训练/发布模型	✅	❌	❌	✅	❌	❌
审核开发者/模型	✅	✅	❌	❌	❌	❌
创建子账号	✅	❌	❌	❌	✅	❌
使用专家服务	✅	✅	✅	✅	✅	✅

4. L1 核心开发者操作指南

4.1 适用角色

Core Developer (核心开发者)

4.2 主要职责

维护 MOE、HOPE、TITANS 核心模块
提供核心 API 服务
监控系统健康状态
优化系统性能

4.3 操作流程

4.3.1 系统初始化

# 1. 克隆代码库
git clone https://github.com/mbe/mises-behavior-engine.git
cd mises-behavior-engine

# 2. 安装依赖
pip install -r requirements.txt

# 3. 初始化数据库
python scripts/init_database.py

# 4. 配置环境变量
cp .env.example .env.development
# 编辑 .env.development 配置必要参数

# 5. 启动服务
python -m uvicorn src.main:app --host 0.0.0.0 --port 8001

4.3.2 核心 API 使用

API	方法	功能
`/api/core/route`	POST	专家路由，根据问题匹配最佳专家
`/api/core/learn`	POST	HOPE学习，惊讶度检测与记忆更新
`/api/core/memory`	GET/POST	TITANS记忆读写
`/api/health`	GET	系统健康检查

示例：专家路由

import httpx

async def route_to_expert(question: str):
    async with httpx.AsyncClient() as client:
        response = await client.post(
            "http://localhost:8001/api/core/route",
            json={"question": question, "context": {}}
        )
        return response.json()

4.3.3 系统监控

# 查看系统状态
curl http://localhost:8001/api/health

# 查看性能指标
curl http://localhost:8001/api/metrics

# 查看日志
tail -f logs/mbe.log

5. L2 专家市场操作指南

5.1 专家创建者 (Expert Creator)

5.1.1 注册开发者账户

Web操作：

访问 https://mbe.hi-maker.com/register
选择"开发者注册"
填写信息并提交
等待管理员审核

API调用：

POST /api/developer/register
Content-Type: application/json

{
  "username": "myexpert",
  "email": "expert@example.com",
  "tier": "pro"
}

5.1.2 创建知识库

步骤：

登录开发者后台
- 访问：/developer/dashboard

创建新知识库

点击 "创建知识库" → 填写名称和描述 → 确认创建

上传文档
- 支持格式：PDF、DOCX、TXT、MD
- 单文件限制：50MB
- 总存储限制：根据订阅等级
文档处理
- 系统自动进行文本提取
- 智能分块处理
- 向量化存储

5.1.3 创建专家

配置参数：

参数	说明	示例
name	专家名称	"法律顾问"
description	专家描述	"专业民事法律咨询"
domain	领域	"legal"
keywords	关键词	["合同", "诉讼", "民法"]
knowledge_base_id	知识库ID	"kb_xxx"

API调用：

POST /api/expert/create
X-Developer-Key: mbe_xxxxxxxxxxxx
Content-Type: application/json

{
  "name": "民事律师专家",
  "description": "专业民事法律咨询服务",
  "domain": "legal",
  "keywords": ["合同", "诉讼", "民法"],
  "knowledge_base_id": "kb_abc123",
  "config": {
    "temperature": 0.7,
    "max_tokens": 2000
  }
}

5.1.4 测试专家

POST /api/expert/test
X-Developer-Key: mbe_xxxxxxxxxxxx
Content-Type: application/json

{
  "expert_id": "expert_abc123",
  "question": "离婚需要什么手续？"
}

5.1.5 发布专家

发布流程：

测试通过 → 提交发布申请 → 等待审核 → 审核通过 → 上架市场

状态说明：

draft - 草稿
testing - 测试中
pending_review - 待审核
approved - 已通过
rejected - 已拒绝
published - 已发布
suspended - 已下架

5.1.6 查看统计数据

GET /api/developer/{developer_id}/experts/{expert_id}/metrics
X-Developer-Key: mbe_xxxxxxxxxxxx

返回数据：

调用次数
响应时间
用户满意度
收益统计

5.2 专家管理员 (Expert Admin)

5.2.1 审核专家

审核清单：

知识库内容合规性
专家回答质量
响应时间性能
安全合规检查

操作步骤：

登录管理后台
进入"待审核专家"列表
查看专家详情和测试结果
做出审核决定（通过/拒绝）
填写审核意见

5.2.2 管理在线专家

监控指标：

错误率 < 5%
平均响应时间 < 500ms
用户满意度 > 4.0

下架条件：

错误率持续超过10%
收到多次用户投诉
内容违规

6. L3 应用开发者操作指南

6.1 获取开发资源

6.1.1 注册并获取API密钥

POST /api/developer/register
Content-Type: application/json

{
  "username": "appdev",
  "email": "dev@example.com",
  "tier": "pro"
}

响应：

{
  "success": true,
  "developer": {
    "id": "dev_abc123",
    "api_key": "mbe_xxxxxxxxxxxxxxxxxxxx",
    "tier": "pro",
    "quota": {
      "max_experts": 10,
      "max_requests_per_day": 10000
    }
  }
}

6.1.2 安装 SDK

Python SDK：

pip install mbe-sdk

JavaScript SDK：

npm install @mbe/sdk

6.2 集成专家

6.2.1 浏览专家市场

GET /api/expert/list?domain=education&status=published

6.2.2 调用专家

Python 示例：

from mbe_sdk import MBEClient

client = MBEClient(api_key="mbe_xxxxxxxxxxxx")

# 调用专家
response = client.ask_expert(
    expert_id="expert_abc123",
    question="什么是行为经济学？",
    context={"user_id": "user_001"}
)

print(response.answer)

JavaScript 示例：

import { MBEClient } from '@mbe/sdk';

const client = new MBEClient({ apiKey: 'mbe_xxxxxxxxxxxx' });

const response = await client.askExpert({
  expertId: 'expert_abc123',
  question: '什么是行为经济学？',
  context: { userId: 'user_001' }
});

console.log(response.answer);

6.3 发布应用

6.3.1 应用配置

{
  "name": "智能学习助手",
  "description": "基于MBE的个性化学习应用",
  "version": "1.0.0",
  "category": "education",
  "experts": ["expert_001", "expert_002"],
  "pricing": {
    "model": "subscription",
    "plans": [
      {"name": "free", "price": 0, "limit": 100},
      {"name": "pro", "price": 29.9, "limit": -1}
    ]
  }
}

6.3.2 提交审核

POST /api/app/submit
X-Developer-Key: mbe_xxxxxxxxxxxx
Content-Type: application/json

{
  "app_id": "app_abc123",
  "version": "1.0.0",
  "changelog": "首次发布"
}

7. L4 终端用户操作指南

7.1 学生用户 (Student)

7.1.1 登录系统

访问学习平台：https://mbe.hi-maker.com/student
输入账号密码登录
或使用魔法链接（邮箱登录）

7.1.2 学习仪表板

登录后进入学习仪表板，可查看：

模块	内容
学习进度	各课程完成度、知识点掌握情况
今日任务	待完成的学习任务
XP和等级	经验值、当前等级、距下一级
成就徽章	已获得和待解锁的成就
排行榜	班级/全站排名

7.1.3 课程学习

MBE 五步行为分析流程：

┌─────────────────────────────────────────┐
│          MBE 五步行为分析               │
│                                         │
│  ① 不舒适检测 ─→ 发现知识缺口          │
│         ↓                               │
│  ② 愿望分析 ─→ 理解学习目标            │
│         ↓                               │
│  ③ 路径生成 ─→ 推荐学习路径            │
│         ↓                               │
│  ④ 方案评估 ─→ 惊讶度检测              │
│         ↓                               │
│  ⑤ 行动支持 ─→ AI导师辅导             │
└─────────────────────────────────────────┘

操作步骤：

浏览课程 - 查看推荐课程或搜索感兴趣的课程
开始学习 - 进入课程学习界面
AI对话 - 与AI导师对话，获取知识点讲解
完成练习 - 做选择题、编程题等练习
获得奖励 - 获得XP、成就徽章

7.1.4 与AI导师对话

你: 什么是复利效应？

AI导师: 复利效应是指投资收益再投入后产生的"利滚利"现象。
让我用一个简单的例子解释：

假设你有100元，年利率10%：
- 第1年: 100 × 1.1 = 110元
- 第2年: 110 × 1.1 = 121元
- 第3年: 121 × 1.1 = 133.1元

你发现了吗？每年增加的金额越来越多！
这就是复利的魔力 ✨

要不要做几道练习题巩固一下？

7.2 教师用户 (Teacher)

7.2.1 教师后台

访问地址：/teacher/dashboard

功能模块：

模块	功能
班级管理	添加/管理学生、查看班级概况
课程管理	创建/编辑课程、配置知识点
学习分析	知识点热力图、学习趋势、困难学生识别
个性化干预	AI建议、调整学习路径、发送提醒
成就管理	设置任务和成就、激励体系

7.2.2 创建课程

步骤：

点击"创建课程"
填写课程基本信息
添加知识点和章节
配置练习题（可使用AI生成）
设置学习目标和奖励
发布课程

AI辅助内容生成：

教师: 帮我生成一道关于"复利计算"的选择题

AI: 好的，为您生成以下选择题：

【题目】小明将1000元存入银行，年利率为5%，按复利计算，
3年后本息合计约为多少元？

A. 1150元
B. 1157.63元  ✓
C. 1150.50元
D. 1160元

【解析】复利公式：本息 = 本金 × (1 + 利率)^年数
1000 × (1.05)³ = 1000 × 1.157625 ≈ 1157.63元

7.2.3 学习数据分析

知识点掌握热力图：

知识点          掌握度
────────────────────────
复利计算        ████████░░  80%
单利计算        ██████████  100%
年金计算        █████░░░░░  50%
贴现计算        ████░░░░░░  40%

困难学生识别：

系统自动识别学习进度落后的学生
提供AI干预建议
一键发送学习提醒

7.3 家长用户 (Parent)

7.3.1 家长门户

访问地址：/parent/dashboard

查看内容：

内容	说明
学习报告	本周学习时长、完成任务数、获得XP
学习进度	各课程进度条、知识点掌握情况
教师评语	教师的反馈和建议
学习目标	本周目标和完成情况

7.3.2 设置学习时间

每日学习时间限制设置：

周一至周五: ___2___ 小时
周六周日:   ___3___ 小时

休息提醒: [✓] 每学习30分钟提醒休息

[保存设置]

7.4 专业人士 (Professional)

7.4.1 使用场景

职业	使用场景
医生	诊断辅助、病例检索、用药建议
律师	案例检索、法规查询、文书生成
金融分析师	投资分析、风险评估、市场趋势
企业顾问	业务咨询、战略规划、流程优化

7.4.2 专业知识查询

你: 我需要查找关于"股权激励"的最新税务政策

专家: 根据最新的税务政策，股权激励主要涉及以下几个方面：

1. **股票期权**
   - 行权时：按"工资薪金所得"缴纳个税
   - 税率：3%-45%累进税率

2. **限制性股票**
   - 解禁时：按"工资薪金所得"缴纳个税
   - 可选择12个月内分期缴纳

3. **股票增值权**
   - 行权时：按"工资薪金所得"缴纳个税

需要我详细解释某一项吗？

8. 管理员操作指南

8.1 超级管理员 (Super Admin)

8.1.1 登录管理后台

访问：/admin

8.1.2 系统管理

功能	操作
用户管理	创建/编辑/删除所有用户
角色管理	设置用户角色和权限
系统配置	修改系统参数
审核管理	审核开发者和模型发布
日志审计	查看系统操作日志

8.1.3 创建管理员

POST /api/admin/users
Cookie: admin_session=xxx
Content-Type: application/json

{
  "email": "admin@example.com",
  "password": "secure_password",
  "role": "admin"
}

8.2 管理员 (Admin)

8.2.1 用户管理

可管理角色：

operator (运营员)
developer (开发者)
enterprise (企业用户)
user (普通用户)

注意：不能管理超级管理员

8.2.2 审核开发者

审核流程：

查看开发者申请列表
审核开发者资质
通过或拒绝申请
填写审核意见

8.2.3 审核模型发布

审核清单：

内容合规性
功能完整性
安全性检查
性能测试

8.3 运营员 (Operator)

8.3.1 权限范围

✅ 查看所有数据
✅ 生成报表
✅ 查看日志
❌ 修改任何数据
❌ 管理用户

8.3.2 报表生成

可用报表：

用户增长报表
使用量报表
收入报表
开发者活跃度报表

9. 常见业务流程

9.1 专家发布全流程

┌─────────────────────────────────────────────────────────────┐
│                    专家发布流程                              │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  开发者注册 ──→ 等待审核 ──→ 审核通过                       │
│       │                          │                           │
│       ↓                          ↓                           │
│  创建知识库 ←──────────── 登录开发者后台                     │
│       │                                                      │
│       ↓                                                      │
│  上传文档 ──→ 文档解析 ──→ 向量化存储                        │
│       │                                                      │
│       ↓                                                      │
│  创建专家 ──→ 配置参数 ──→ 关联知识库                        │
│       │                                                      │
│       ↓                                                      │
│  测试专家 ──→ 质量检查 ──→ 修复问题                          │
│       │                                                      │
│       ↓                                                      │
│  提交发布 ──→ 管理员审核 ──→ 上架市场                        │
│       │                          │                           │
│       ↓                          ↓                           │
│  用户使用 ←─────────────── 获得收益                          │
│                                                              │
└─────────────────────────────────────────────────────────────┘

9.2 学生学习全流程

登录系统
    ↓
查看学习仪表板 ──→ 了解今日任务和进度
    ↓
浏览/搜索课程 ──→ 选择感兴趣的课程
    ↓
进入学习界面
    ├── 观看视频/阅读材料
    ├── 与AI导师对话
    └── 完成知识点练习
    ↓
获得XP和成就 ──→ 查看排行榜
    ↓
继续下一个知识点

9.3 订阅升级流程

免费用户
    ↓
达到使用限制 ──→ 系统提示升级
    ↓
选择订阅计划
    ├── 基础版: ¥29.9/月
    ├── 专业版: ¥99/月
    └── 企业版: ¥999/月
    ↓
完成支付
    ↓
自动开通权限 ──→ 配额更新
    ↓
享受高级功能

9.4 企业子账号管理

企业用户登录
    ↓
进入账号管理
    ↓
创建子账号
    ├── 填写员工信息
    ├── 分配权限
    └── 设置配额
    ↓
员工收到邀请邮件
    ↓
员工激活账号
    ↓
企业统一管理和计费

10. 智能终端使用指南

10.1 支持的终端

终端	接入方式	唤醒词
小度音箱	DuerOS	"小度小度"
天猫精灵	AliGenie	"天猫精灵"
小爱同学	XiaoAi	"小爱同学"
小智	MCP协议	"小智"

10.2 小度音箱使用

对话示例：

用户: 小度小度，打开米塞斯
小度: 好的，已为您打开米塞斯智能助手

用户: 什么是复利效应？
小度: 复利效应是指投资收益再投入后产生的"利滚利"现象...

用户: 谢谢，退出
小度: 好的，再见！

10.3 天猫精灵使用

对话示例：

用户: 天猫精灵，问问米塞斯
天猫: 好的，米塞斯为您服务

用户: 帮我分析一下职业发展
天猫: 好的，我来帮您分析职业发展...

10.4 终端专家绑定

企业可以将特定终端绑定到指定专家：

# 示例：律所前台绑定到民事律师专家
binding = TerminalExpertBinding(
    device_id="law_firm_reception_001",
    bound_expert_id="civil_lawyer_expert",
    binding_mode="exclusive",
    description="律师事务所前台专属终端"
)

11. 常见问题解答

11.1 账户相关

Q: 如何找回密码？

A: 点击登录页面的"忘记密码"，输入注册邮箱，系统会发送重置链接。

Q: 如何修改邮箱？

A: 登录后进入"账户设置" → "修改邮箱"，需要验证原邮箱。

Q: 如何升级账户类型？

A: 进入"订阅管理"页面，选择目标计划并完成支付。

11.2 开发者相关

Q: 开发者审核需要多长时间？

A: 通常1-3个工作日，可在开发者后台查看审核状态。

Q: 知识库支持哪些文件格式？

A: 支持 PDF、DOCX、TXT、MD 格式，单文件最大50MB。

Q: 专家被拒绝后怎么办？

A: 查看拒绝原因，修改后重新提交审核。

11.3 使用相关

Q: 免费用户每天能用多少次？

A: 访客20次/天，注册用户100次/天，Pro用户不限次数。

Q: 如何查看使用量？

A: 登录后在仪表板或"使用统计"页面查看。

Q: API调用报错怎么办？

A: 检查以下几点：

API Key是否正确
配额是否用完
请求格式是否正确
查看错误码说明

11.4 支付相关

Q: 支持哪些支付方式？

A: 支持支付宝、微信支付、银行卡。

Q: 支付后多久生效？

A: 支付成功后即时生效，权限自动开通。

Q: 如何申请退款？

A: 联系客服，说明退款原因，审核通过后7个工作日内退还。

附录

A. API错误码说明

错误码	说明	解决方案
401	未授权	检查API Key
403	权限不足	检查用户权限
404	资源不存在	检查ID是否正确
429	请求过多	降低请求频率
500	服务器错误	联系技术支持

B. 订阅计划对比

功能	免费版	基础版	专业版	企业版
每日对话次数	100	1000	无限	无限
专家数量	3	10	50	无限
存储空间	100MB	1GB	10GB	100GB
API访问	❌	✅	✅	✅
子账号	❌	❌	❌	✅
技术支持	社区	邮件	优先	专属

C. 联系方式

类型	联系方式
技术支持	support@mbe.hi-maker.com
商务合作	business@mbe.hi-maker.com
社区论坛	https://community.mbe.hi-maker.com
文档中心	https://docs.mbe.hi-maker.com

文档版本: v1.0
最后更新: 2026-02-02
维护者: MBE 产品团队