MBE 文档中心

🚀 启动 MBE Desktop 应用

⚠️ 重要区别

  • http://localhost:8000 = 后端 API 服务（Web UI，不是 Desktop 应用）
  • MBE Desktop = Electron 桌面应用（独立窗口，这才是我们要测试的应用）

📋 启动步骤

1. 确认后端服务运行

# 检查后端是否运行
Invoke-WebRequest -Uri "http://localhost:8000/api/health" -UseBasicParsing | Select-Object -ExpandProperty Content

应该返回: {"status":"healthy","service":"mises-behavior-engine"}

2. 启动 Desktop 应用

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

等待:

  • ✅ Vite dev server 启动（http://localhost:5173）
  • ✅ Electron 窗口自动打开
  • ✅ 窗口标题显示 "MBE Desktop"

3. 在 Electron 窗口中测试

  • 不要在浏览器中访问 http://localhost:8000
  • 应该在 Electron 应用窗口内进行测试
  • 在 Electron 窗口内按 F12 打开开发者工具

🔍 如何识别 Desktop 应用窗口

✅ Desktop 应用（Electron）

  • 独立的桌面应用窗口（不是浏览器标签页）
  • 窗口标题: "MBE Desktop"
  • 窗口内显示登录/注册页面（类似 Cursor IDE 风格）
  • 可以按 F12 打开开发者工具

❌ 后端 Web UI

  • 浏览器标签页
  • URL: http://localhost:8000
  • 显示后端用户中心界面（/user/dashboard）

🛠️ 如果窗口没有打开

检查 1: 查看启动日志

运行 npm run dev:electron 后，终端应该显示：

VITE v5.x.x  ready in xxx ms

➜  Local:   http://localhost:5173/
➜  Network: use --host to expose

wait-on http://localhost:5173 dist/main/index.js
Electron window opened

检查 2: 手动检查进程

# 检查 Electron 进程
Get-Process | Where-Object {$_.ProcessName -like "*electron*"}

# 检查端口 5173（Vite dev server）
Get-NetTCPConnection | Where-Object {$_.LocalPort -eq 5173}

检查 3: 重新启动

如果窗口没有打开：

# 1. 停止所有相关进程
Get-Process | Where-Object {$_.ProcessName -in @("electron", "node")} | Where-Object {$_.Path -like "*mbe-desktop*"} | Stop-Process -Force

# 2. 清理缓存（可选）
Remove-Item -Recurse -Force .\node_modules\.vite -ErrorAction SilentlyContinue

# 3. 重新启动
npm run dev:electron

📝 测试流程

✅ 正确的测试方式

  1. 启动 Desktop 应用:

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

  2. 等待 Electron 窗口打开:

    • 应该看到一个独立的桌面应用窗口
    • 窗口标题: "MBE Desktop"
    • 窗口内显示登录/注册页面

  3. 在 Electron 窗口中测试:

    • 在 Electron 窗口内打开开发者工具（F12）
    • 在 Electron 窗口内进行注册/登录测试
    • 查看 Network 标签页，应该看到请求发送到 http://localhost:8000/api/v1/users/*

❌ 错误的测试方式

  • ❌ 在浏览器中访问 http://localhost:8000（这是后端 Web UI）
  • ❌ 在浏览器中访问 http://localhost:5173（这是 Vite dev server，不是应用）
  • ✅ 必须使用 Electron 应用窗口

🎯 总结

关键点:

  • Desktop 应用 = Electron 桌面应用（独立窗口）
  • 后端服务 = http://localhost:8000（Web UI，不是 Desktop）
  • 测试时必须在 Electron 窗口内进行

启动命令:

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

最后更新: 2026-02-08