模块 3 · 本地调试

npm run dev、Vite proxy
与 401 排障

前端 dev 服务器跑在 5173，API 在 8000。 Vite proxy 帮你转发——没起后端或头带错，Network 面板一眼 401。

启动顺序

后端 · 应用入口（main.py）：uvicorn app.main:app --reload --port 8000（Core 模拟库 + Redis 6380 按需）

前端：cd web && npm run dev → 打开 http://localhost:5173

vite.config.ts

server: {
  port: 5173,
  proxy: {
    '/api': {
      target: 'http://127.0.0.1:8000',
      changeOrigin: true,
    },
  },
},

白话

浏览器请求 localhost:5173/api/... 时，Vite 偷偷转给 8000 端口。

前端代码里写相对路径 /api 即可，不用硬编码 :8000。

生产构建没有 proxy，要 Nginx 或同域部署反代。

没登录或 token 过期 → 重新点 Demo 登录；改过后端角色也要重登拿新 JWT。

走了 /api/chat 但没带 X-Agent-Type → 查 ChatPanel 的 agentType 和 chat.ts headers。

JWT 角色和 X-Agent-Type 不配，如客户 token 却带 advisor → 换账号或改 prop。

8000 没起或 proxy 失效 → curl http://127.0.0.1:8000/health 先确认后端活着。