Complete V2 user H5 flow

ai_knowledge_base_v2/development_records/2026-07-06-decision-register.md

@@ -29,6 +29,8 @@
 | D-006 | 短信、飞书、大模型都先做 mock provider，再接真实服务。 | 默认采用 | 保证本地开发和测试不被外部账号、权限、费用阻塞。 |
 | D-007 | RAG 一期作为后端内部 service，不单独拆微服务。 | 默认采用 | 降低一期部署和调试复杂度。 |
 | D-008 | 生产密钥不明文展示，不写入日志。 | 默认采用 | 降低模型 Key、飞书密钥、短信密钥泄露风险。 |
+| D-009 | 用户端 Markdown 渲染使用 `markdown-it`，不手写 Markdown 解析器。 | 默认采用 | 减少列表、代码块、表格等格式兼容问题，降低后续维护成本。 |
+| D-010 | 用户端停止生成先使用浏览器 `AbortController` 中断 SSE 读取，后端真实中断等接入真实模型时实现。 | 默认采用 | 当前后端仍是 mock 模型，前端先保证用户操作反馈真实有效。 |
 
 ## 待确认决策
 

ai_knowledge_base_v2/development_records/2026-07-06-phase3-user-client-completion.md

@@ -0,0 +1,45 @@
+# 阶段三记录：用户端 H5 主链路补齐
+
+日期：2026-07-06
+
+## 本次目标
+
+补齐阶段三用户端 H5 主链路中还缺的体验能力，让用户在手机端可以更完整地完成登录、提问、查看结构化回答、维护历史会话和停止生成。
+
+## 已完成
+
+- 聊天消息支持 Markdown 渲染：
+  - 段落
+  - 列表
+  - 行内代码
+  - 代码块
+  - 表格横向滚动
+  - 链接识别
+- 会话抽屉支持：
+  - 新建会话
+  - 切换会话
+  - 修改会话标题
+  - 删除会话
+- 停止生成体验增强：
+  - 前端使用 `AbortController` 中断当前 SSE 读取。
+  - 仍调用后端 `/chat/stop`，为后续真实模型中断保留接口。
+- 发送问题成功后刷新用户额度，顶部额度展示可以及时更新。
+- SSE 错误时优先展示后端返回的业务错误信息，例如额度用完。
+
+## 当前边界
+
+- 当前仍是 mock 登录、mock RAG 和 mock 模型。
+- 后端真实停止生成尚未实现，需要等真实模型流式调用接入后补齐。
+- Markdown 已禁用 HTML 解析，避免模型回答中出现 HTML 注入风险。
+
+## 阶段三判断
+
+阶段三可以认为主链路已具备可演示能力：
+
+1. 用户可以通过 mock 手机号验证码登录。
+2. 用户可以创建和切换会话。
+3. 用户可以发送问题并接收 SSE 回答。
+4. 用户可以查看历史聊天。
+5. 用户可以修改和删除会话。
+6. 用户可以停止当前生成。
+7. AI 结构化回答在手机端具备基础可读性。

ai_knowledge_base_v2/development_records/README.md

@@ -29,3 +29,4 @@
 | `2026-07-06-phase2-user-client.md` | 阶段二用户端 Vue 3 H5 第一批记录。 |
 | `2026-07-06-phase2-dev-compose.md` | 阶段二本地开发编排记录。 |
 | `2026-07-06-phase2-rag-skeleton.md` | 阶段二 RAG 问答链路骨架记录。 |
+| `2026-07-06-phase3-user-client-completion.md` | 阶段三用户端 H5 主链路补齐记录。 |