# 阶段二记录：用户端 H5 第一批

日期：2026-07-06

## 本次目标

根据已确认决策，用户端直接使用 Vue 3，不使用 uni-app。本次先搭建 H5 工程，并接入后端 mock 登录和 mock 聊天接口，为后续手机端主链路开发打基础。

## 已完成

- 新建 `ai_knowledge_base_v2/apps/user-client/`。
- 使用 Vue 3 + Vite + TypeScript。
- 新增用户端 `.env.example`、`README.md`、构建脚本。
- 新增 API 服务层：
  - Token 保存和清理
  - 发送验证码
  - 登录
  - 退出登录
  - 当前用户信息
  - 会话列表
  - 创建会话
  - 聊天历史
  - SSE 问答
  - 停止生成
- 新增页面组件：
  - 登录面板
  - 会话抽屉
  - 聊天气泡
  - 输入框
  - 主应用壳
- 完成手机端优先样式。

## 已验证

- `npm install` 通过，0 个漏洞。
- `npm run build` 通过。
- 前端 dev server 启动通过，访问 `http://127.0.0.1:5173/` 返回 200。

## 当前边界

- Markdown 渲染还是基础文本展示，后续需要接入 Markdown 渲染库。
- 后端数据库服务未纳入统一启动编排，完整登录/聊天链路需要先启动后端和数据库。
- 会话重命名接口已接 API，但 UI 入口还未做。
- 停止生成目前是后端占位逻辑，真实模型接入后需要做请求取消。
- 本轮未做浏览器截图级视觉验收；后续接完整本地编排后，需要补移动端和桌面端截图检查。

## 下一步建议

1. 补本地开发编排：MySQL + backend + user-client。
2. 用真实启动环境跑通登录和 mock 聊天。
3. 增加 Markdown 渲染和错误提示细化。
4. 开始管理后台或继续完善用户端主链路。
