Demo 服务

Demo 由四部分组成：AI 服务、Socket.IO 后端、Demo 前端、Admin 前端。数据流如下：

sequenceDiagram
  participant UI as demo-frontend
  participant Backend as demo-backend
  participant AI as ai-service
  UI->>Backend: Socket IO user_message
  Backend->>AI: POST /stream SSE
  AI-->>Backend: data: {token or event}
  Backend-->>UI: ai_response

一键启动

just demo-up

该命令会按系统类型启动多个进程，适合本地联调。

手动启动

uv run python main.py

cd demo-backend
uv run python app/main.py

cd demo-frontend
npm install
npm run dev

cd admin-frontend
npm install
npm run dev

关键说明

• demo-backend/app/main.py 默认请求 http://localhost:8000 的 AI 服务，可通过 AI_SERVICE_URL 覆盖。
• Demo 前端通过同源 /api 代理访问 Demo 后端（http://localhost:3000），并通过 /api/socket.io 建立 Socket.IO 连接。
• Admin 前端代理 /api 到 http://localhost:8000。

SSH 隧道访问说明

• 对外暴露 5173 和 5174 即可访问两个前端页面。