MBE 文档中心

使用 MBE Desktop 创建设计知识库

目标

将 E:\平面设计 目录下的全部设计类 PDF、EPUB 等文件上传到「设计专家知识库」，用于设计领域的 RAG 检索与专家问答。

前置条件

  1. 后端服务已启动（端口 8001 或 8000）

    # 检查后端
Invoke-WebRequest -Uri "http://localhost:8001/api/health" -UseBasicParsing

  2. MBE Desktop 已启动

    cd d:\Mises\mbe-desktop
npm run dev:electron

  3. 已登录（如需要）

操作步骤

1. 创建知识库

  1. 打开 MBE Desktop，进入 知识库 页面
  2. 点击 创建知识库
  3. 填写：
    • 名称：设计专家知识库
    • 描述：涵盖平面设计、计算机图形学、设计心理学、设计史、网格系统、配色、排版、3D渲染、设计伦理等专业资料
    • 分块大小：1000（默认）
    • 重叠大小：200（默认）
  4. 勾选 创建后立即上传文件（可选）
  5. 点击 创建

2. 上传 E:\平面设计 全部内容

方式 A：选择文件夹（推荐）

  1. 在刚创建的知识库卡片上，点击 选择文件夹
  2. 在文件选择器中导航到 E:\平面设计
  3. 选择该文件夹并确认
  4. 应用会自动递归扫描并上传文件夹内所有支持的 PDF、TXT、MD、PPT、DOCX、HTML 等文件

方式 B：拖放文件夹

  1. 打开文件资源管理器，进入 E:\平面设计
  2. 将整个「平面设计」文件夹拖拽到 MBE Desktop 的知识库卡片上
  3. 松手后自动开始上传

方式 C：分批选择文件

  1. 若文件夹内文件过多，可分批选择
  2. 点击 选择文件，多选 PDF/EPUB 等文件
  3. 重复多次直到全部上传完成

3. 等待处理

  • 上传完成后，后端会异步处理文档（分块、向量化等）
  • 状态会从「 pending」→「 processing」→「 ready」
  • 可点击知识库卡片查看详情和进度
  • 大文件（>5MB）会自动使用断点续传

4. 发布为专家（可选）

知识库状态变为 就绪 后，可在详情页中将其发布为专家，供聊天、检索等场景使用。

支持的文件格式

  • PDF
  • TXT
  • MD
  • PPT / PPTX
  • Excel (XLS / XLSX)
  • Word (DOC / DOCX)
  • HTML / HTM

EPUB 格式暂不支持。若需上传 EPUB 内容，可先用 Calibre 等工具转换为 PDF 后再上传。

常见问题

Q: 选择文件夹后没有任何文件？
A: 确认文件夹内包含上述支持格式的文件，且文件名无特殊字符。

Q: 上传失败或超时？
A: 单文件超过 50MB 需使用分块上传；批量上传时单批总大小不超过 50MB，会自动分批。

Q: 后端端口不是 8001？
A: 启动 Desktop 前设置环境变量：$env:VITE_API_PORT="8000"，再执行 npm run dev:electron。

最后更新: 2026-02-11