MBE 文档中心

MBE 访客/用户旅程全流程文档

版本: 2.1.0
更新日期: 2026-01-28
最新更新: 访客限制提升、支付自动开通权限

📋 概述

本文档详细描述了普通用户从访客浏览到注册、购买、使用 MBE 的完整用户旅程。

流程总览：

访客浏览 → 用户注册 → 免费体验 → 升级付费 → 创建专家 → 使用专家 → 查看反馈 → 应用优化 → 持续使用

🆕 最新更新 (v2.1.0)

访客限制优化

  • ✅ 访客每日对话限制从5次提升到20次
  • ✅ 配置化管理，可通过配置文件调整
  • ✅ 超过限制时友好提示引导注册

支付自动开通权限

  • ✅ 支付成功后自动开通订阅权限
  • ✅ 自动更新Token计费配置
  • ✅ 自动更新用户权限
  • 📖 详细文档：支付自动开通权限流程

🚀 完整用户旅程

阶段 1: 访客浏览 (Visitor)

目的： 了解 MBE 功能，无需注册即可体验

1.1 访问首页

操作：

  • 访问：http://localhost:8000/
  • 查看产品介绍和功能说明

特点：

  • ✅ 无需注册
  • ✅ 公开访问
  • ✅ 了解核心功能
  • ✅ 每日20次免费对话（从5次提升）🆕

1.2 查看 API 文档

操作：

  • 访问：http://localhost:8000/docs
  • 浏览所有可用 API
  • 了解功能和技术细节

价值：

  • 📖 了解完整功能列表
  • 📖 查看 API 使用示例
  • 📖 理解技术实现

1.3 体验演示模式

API 调用：

GET /api/developer/demo_developer/dashboard

响应示例：

{
  "success": true,
  "developer_id": "demo_developer",
  "overview": {
    "total_experts": 24,
    "total_issues": 0,
    "total_suggestions": 0,
    "experts_needing_attention": 0
  },
  "experts": [
    {
      "expert_id": "dynamic_expert_001",
      "health_score": {
        "score": 100,
        "status": "healthy",
        "color": "green"
      }
    }
  ]
}

体验内容：

  • ✅ 查看演示专家列表
  • ✅ 了解专家功能
  • ✅ 无需注册即可体验

Web UI：

  • 演示仪表盘：http://localhost:8000/developer/feedback

阶段 2: 用户注册 (Registration)

目的： 创建账户，获取 API Key，开始使用

2.1 决定注册

触发条件：

  • 用户体验演示后满意
  • 需要创建自己的专家
  • 需要更多功能

2.2 提交注册信息

API 调用：

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

{
  "username": "myuser",
  "email": "user@example.com",
  "tier": "free"  # 默认免费
}

响应示例：

{
  "success": true,
  "message": "开发者账户创建成功",
  "developer": {
    "id": "dev_abc123",
    "username": "myuser",
    "email": "user@example.com",
    "tier": "free",
    "api_key": "mbe_xxxxxxxxxxxx",  // ⚠️ 只显示一次！
    "quota": {
      "max_experts": 3,
      "max_requests_per_day": 100,
      "max_storage_mb": 100
    }
  },
  "important": "请妥善保存您的 API Key，它不会再次显示！"
}

注册信息：

  • 📝 用户名（唯一）
  • 📧 邮箱地址
  • 🎯 服务等级（默认 free）

获得内容：

  • ✅ 开发者 ID
  • ✅ API Key（仅显示一次）
  • ✅ Free 等级配额

费用： $0（免费注册）

阶段 3: 免费体验 (Free Trial)

目的： 使用 Free 等级功能，了解系统能力

3.1 查看账户信息

API 调用：

GET /api/developer/me
X-Developer-Key: mbe_xxxxxxxxxxxx

响应示例：

{
  "success": true,
  "developer": {
    "id": "dev_abc123",
    "username": "myuser",
    "tier": "free",
    "status": "active"
  },
  "quota": {
    "max_experts": 3,
    "used_experts": 0,
    "max_requests_per_day": 100,
    "remaining_requests": 100
  }
}

3.2 查看仪表盘

API 调用：

GET /api/developer/{developer_id}/dashboard
X-Developer-Key: mbe_xxxxxxxxxxxx

初始状态：

  • 📊 专家数：0
  • 📊 问题数：0
  • 📊 建议数：0

3.3 体验权限控制

测试： 尝试访问他人专家

结果：

  • ✅ 权限控制正常
  • ✅ 无法访问他人专家
  • ✅ 只能访问自己的专家

3.4 Free 用户限制

限制说明：

  • ⚠️ 最多 3 个专家
  • ⚠️ 每日 100 次 API 调用
  • ⚠️ 不能自动应用优化建议
  • ⚠️ 只能查看建议，需手动实施

功能可用：

  • ✅ 创建专家
  • ✅ 查看指标
  • ✅ 检测问题
  • ✅ 获取建议
  • ✅ 查看仪表盘

阶段 4: 升级到 Pro (Upgrade)

目的： 解锁更多功能，提升使用体验

4.1 查看付费方案

服务等级对比：

功能 Free Pro Enterprise
价格 $0/月 $29/月 $99/月
专家数量 3 20 无限
API 调用/天 100 10,000 无限
存储空间 100 MB 1 GB 10 GB
自动应用建议 ❌ ✅ ✅
审计日志查询 3天 3天 30天
优先支持 ❌ ❌ ✅

4.2 选择 Pro 方案

决策因素：

  • 💰 价格合理（$29/月）
  • 📈 专家数量充足（20个）
  • 🚀 API 调用充足（10,000/天）
  • ⚡ 自动优化功能

费用： $29/月

4.3 升级账户

操作：

  • 通过支付系统完成订阅
  • 账户等级自动升级为 pro

升级后获得：

  • ✅ 20 个专家配额
  • ✅ 每日 10,000 次 API 调用
  • ✅ 1 GB 存储空间
  • ✅ 自动应用优化建议
  • ✅ 完整问题检测

阶段 5: 创建专家 (Create Expert)

目的： 上传知识库，创建专属专家模型

5.1 准备知识库文件

文件要求：

  • 📄 PDF 格式
  • 📄 内容相关且结构化
  • 📄 文件大小合理

示例：

  • 产品手册.pdf (2MB)
  • 常见问题.pdf (500KB)
  • 技术规格.pdf (1MB)

5.2 上传并创建专家

操作流程：

  1. 上传 PDF 文件
  2. 系统自动解析和向量化
  3. 创建专家模型
  4. 生成专家 ID

结果：

  • ✅ 专家创建成功
  • ✅ 专家 ID：dynamic_expert_001
  • ✅ 知识库：3个PDF，共3.5MB
  • ✅ 向量数：约500个

5.3 注册专家所有权

API 调用：

POST /api/developer/{developer_id}/experts/{expert_id}/register
X-Developer-Key: mbe_xxxxxxxxxxxx

结果：

  • ✅ 专家已绑定到账户
  • ✅ 可以开始使用和管理

阶段 6: 使用专家对话 (Use Expert)

目的： 与专家进行对话交互

6.1 开始新对话

操作：

  • 创建新会话
  • 会话 ID：conv_123456

6.2 对话交互

示例对话：

用户: 你好，我想了解产品的主要功能
专家: 您好！我们的产品主要有以下功能：
      1. 智能对话
      2. 知识检索
      3. 自动学习
      ...

用户: 价格是多少？
专家: 根据您的需求，我们有三个定价方案：
      - Free免费版
      - Pro专业版 $29/月
      - Enterprise企业版 $99/月
      ...

用户: 如何开始使用？
专家: 开始使用非常简单：
      1. 注册账户
      2. 上传知识库
      3. 配置专家
      4. 开始对话
      ...

6.3 对话统计

指标：

  • 📊 对话轮次：3
  • ⏱️ 平均响应时间：2.1秒
  • 🎯 知识命中率：85%

阶段 7: 查看专家反馈 (View Feedback)

目的： 了解专家表现，发现优化机会

7.1 获取专家表现指标

API 调用：

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

关键指标：

  • 使用量：

    • 总对话数：156
    • 独立用户：45
    • 总消息数：892

  • 性能：

    • 平均响应：3.2秒
    • P95响应：5.8秒

  • 质量：

    • 满意度：4.2/5
    • 切换率：8%

  • 知识库：

    • 命中率：85%
    • 相关性：0.78

7.2 检测潜在问题

API 调用：

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

检测结果：

  • ✅ 专家运行状况良好
  • ✅ 无明显问题
  • ✅ 或显示检测到的问题列表

7.3 获取优化建议

API 调用：

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

建议内容：

  • 📋 优化索引配置
  • 📋 补充知识库内容
  • 📋 调整响应参数
  • 📋 更新专家配置

自动应用：

  • Pro/Enterprise 用户可一键应用
  • Free 用户需手动实施

阶段 8: 应用优化建议 (Apply Suggestions)

目的： 自动优化专家性能（Pro/Enterprise 功能）

8.1 Pro 用户特权

对比：

  • Free 用户： 只能查看建议，需手动实施
  • Pro 用户： 可以一键自动应用建议

8.2 自动应用

API 调用：

POST /api/developer/{developer_id}/experts/{expert_id}/apply-suggestions
X-Developer-Key: mbe_xxxxxxxxxxxx
Content-Type: application/json

{
  "suggestion_ids": ["sug_001"]
}

执行过程：

  1. 选择建议
  2. 系统自动执行
  3. 应用优化配置
  4. 记录操作日志

8.3 查看应用效果

优化前：

  • 平均响应：3.2秒

优化后：

  • 平均响应：2.7秒
  • 提升：15.6%

效果验证：

  • ✅ 响应时间减少
  • ✅ 用户满意度提升
  • ✅ 知识命中率提高

阶段 9: 查看操作历史 (Audit Log)

目的： 追踪操作记录，了解使用情况

9.1 获取审计日志

API 调用：

GET /api/developer/{developer_id}/audit-log?days=7
X-Developer-Key: mbe_xxxxxxxxxxxx

响应示例：

{
  "success": true,
  "total": 15,
  "logs": [
    {
      "timestamp": "2026-01-28T10:20:00",
      "action": "view_metrics",
      "resource_id": "dynamic_expert_001",
      "success": true
    },
    {
      "timestamp": "2026-01-28T10:15:00",
      "action": "apply_suggestion",
      "resource_id": "dynamic_expert_001",
      "success": true
    }
  ]
}

记录内容：

  • 📝 操作时间
  • 📝 操作类型
  • 📝 资源ID
  • 📝 操作结果

查询限制：

  • Free/Pro：最近3天
  • Enterprise：最近30天

💰 用户消费统计

注册阶段

  • 注册费： $0（免费）

升级阶段

  • Pro 订阅： $29/月
  • Enterprise 订阅： $99/月（可选）

月度总计

  • Free 用户： $0/月
  • Pro 用户： $29/月
  • Enterprise 用户： $99/月

🎁 Pro 用户获得的权益

功能权益

  • ✅ 20个专家配额（Free: 3个）
  • ✅ 每日10,000次API调用（Free: 100次）
  • ✅ 1 GB存储空间（Free: 100 MB）
  • ✅ 自动应用优化建议（Free: 只能查看）
  • ✅ 完整问题检测
  • ✅ 审计日志访问

性能提升

  • ⚡ 响应时间优化
  • ⚡ 知识命中率提升
  • ⚡ 用户满意度提高

🌐 Web UI 访问地址

功能 地址
开发者反馈仪表盘 http://localhost:8000/developer/feedback
任务审批界面 http://localhost:8000/admin/tasks
任务生命周期 http://localhost:8000/admin/lifecycle
API 文档 http://localhost:8000/docs

📊 完整流程测试

运行测试脚本：

python scripts/test_user_journey.py

测试覆盖：

  1. ✅ 访客浏览
  2. ✅ 用户注册
  3. ✅ 免费体验
  4. ✅ 升级Pro
  5. ✅ 创建专家
  6. ✅ 使用专家
  7. ✅ 查看反馈
  8. ✅ 应用建议
  9. ✅ 审计日志

🎯 用户旅程可视化

┌─────────────────────────────────────────────────────────────┐
│                    用户旅程 (User Journey)                    │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  [访客]  ──→  [注册]  ──→  [免费体验]  ──→  [升级付费]    │
│    │           │             │               │              │
│    ▼           ▼             ▼               ▼              │
│  浏览演示   获取账户     试用功能       解锁全部功能         │
│  API文档    API Key      了解限制       $29/月              │
│                                                              │
│          ──→  [创建专家]  ──→  [使用]  ──→  [持续优化]    │
│                    │            │            │              │
│                    ▼            ▼            ▼              │
│              上传PDF知识库   对话交互    查看反馈+应用建议   │
│                                                              │
└─────────────────────────────────────────────────────────────┘

📝 最佳实践

1. 注册阶段

  • ✅ 使用真实邮箱（用于通知）
  • ✅ 立即保存 API Key
  • ✅ 先体验 Free 版本

2. 使用阶段

  • ✅ 定期查看专家指标
  • ✅ 关注问题检测结果
  • ✅ 及时应用优化建议
  • ✅ 监控 API 调用配额

3. 优化阶段

  • ✅ 优先处理 HIGH 优先级问题
  • ✅ 利用自动应用功能（Pro+）
  • ✅ 定期补充知识库内容
  • ✅ 关注用户反馈

🐛 常见问题

Q: 访客可以使用多少次对话？

A: 访客（未注册用户）每日可以免费使用20次对话。超过限制后可以注册账户获取更多额度。

Q: 如何从 Free 升级到 Pro？

A: 通过支付系统完成订阅，支付成功后账户等级自动升级，权限自动开通。🆕

Q: 支付成功后需要手动开通权限吗？

A: 不需要。支付成功后系统会自动开通订阅权限、更新Token额度、更新用户权限。🆕

Q: API Key 丢失怎么办？

A: 目前不支持找回，需要重新注册账户。

Q: 如何创建更多专家？

A: 升级到 Pro（20个）或 Enterprise（无限）。

Q: 如何提升专家性能？

A:

  1. 查看问题检测结果
  2. 获取优化建议
  3. 应用建议（Pro+可自动）
  4. 补充知识库内容

Q: 如何查看使用统计？

A: 通过仪表盘或审计日志查看详细统计。

📚 相关文档

最后更新： 2026-01-28