refactor(AI): 四份 SSE 请求代码合成 streamAI + useAIStream

学情分析、班级分析、班级 PK、AI 提示四处原来各有一份几乎一样的 fetch + SSE 解析，
错误处理各漏各的：

- 裸 fetch 绕过了 axios 拦截器，未登录时只显示「AI 分析生成失败」而不弹登录框。
  拦截器里的全站错误处理抽成 handleGlobalApiError，两条路共用
- 班级分析、班级 PK 离开页面不中止流。useAIStream 在作用域销毁时自动 abort
- AI 提示换了一次提交不掐上一条，旧提示会写进新提交的面板

utils/stream.ts 的 streamAI 负责请求 + 解析 + 错误翻译；组件用 useAIStream
（waiting = 第一个字还没到，running = 流没结束）；学情分析在 store 里直接用 streamAI。

浏览器实跑核过：学情分析逐字流出、provider 500 时显示后端的固定中文文案、
未登录调用弹出登录框。班级 PK / 班级分析卸载即中止这条没有在浏览器里点过
（本机库里没有班级数据），逻辑在 useAIStream 的 onScopeDispose。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

apps/web/src/utils/stream.ts

@@ -1,3 +1,5 @@
+import { handleGlobalApiError } from "./api"
+
 export interface JSONEventStreamHandlers<T = any> {
   onMessage: (data: T, event?: string) => void
   onEvent?: (event: string) => void
@@ -96,12 +98,21 @@ export async function consumeJSONEventStream<T = any>(
 /**
  * AI 端点的非 2xx 响应体是 JSON 不是 SSE，直接丢给上面的解析器只会抛
  * 「无法解析服务端事件数据: {...}」。后端 error.message 是英文的，按 code 换成中文。
+ *
+ * 登录失效 / 账号禁用走和 axios 拦截器同一套处理（弹登录框 / 提示禁用）——
+ * 原来这里裸 fetch 绕过了拦截器，未登录时只显示一句「AI 分析生成失败」。
  */
-export async function aiStreamError(response: Response) {
+async function aiStreamError(response: Response) {
   const body = (await response.json().catch(() => null)) as {
-    error?: { code?: string }
+    error?: { code?: string; message?: string }
   } | null
-  switch (body?.error?.code) {
+  const code = body?.error?.code ?? "network-error"
+  handleGlobalApiError(code, body?.error?.message)
+  switch (code) {
+    case "login-required":
+      return new Error("请先登录")
+    case "account-disabled":
+      return new Error("账号已被禁用，请联系老师")
     case "too-many-requests":
       return new Error("AI 请求太频繁了，歇一会儿再试")
     case "hint-locked":
@@ -114,3 +125,50 @@ export async function aiStreamError(response: Response) {
       return new Error("AI 分析生成失败")
   }
 }
+
+/** AI 流的事件形状，和 apps/api/src/services/ai.ts 的 streamChat / streamWhole 一致 */
+type AIStreamEvent =
+  | { type: "delta"; content?: string }
+  | { type: "error"; message?: string }
+  | ({ type: "done" } & Record<string, unknown>)
+
+export interface AIStreamHandlers<Done> {
+  onDelta: (content: string) => void
+  /** done 事件里后端并进来的额外字段（比如 AI 提示的 hintId / level） */
+  onDone?: (data: Done) => void
+  signal?: AbortSignal
+}
+
+/**
+ * 发起一次 AI 流式请求并读到结束。学情分析、班级分析、班级 PK、AI 提示四个入口共用 ——
+ * 原来是四份几乎一样的 fetch + SSE 解析，错误处理各漏各的。
+ *
+ * 失败抛 Error，`message` 是能直接给用户看的中文（后端下发的错误文案本来就是固定的
+ * 中文，见 services/ai.ts 的 CLIENT_ERROR_MESSAGE）。被 abort 时抛 AbortError，
+ * 调用方一般用 `useAIStream` 就不用自己分辨。
+ */
+export async function streamAI<Done = Record<string, unknown>>(
+  path: string,
+  body: unknown,
+  handlers: AIStreamHandlers<Done>,
+) {
+  const response = await fetch(`/api/${path}`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body),
+    signal: handlers.signal,
+  })
+  if (!response.ok) throw await aiStreamError(response)
+  await consumeJSONEventStream<AIStreamEvent>(response, {
+    signal: handlers.signal,
+    onMessage(event) {
+      if (event.type === "delta") {
+        if (event.content) handlers.onDelta(event.content)
+      } else if (event.type === "error") {
+        throw new Error(event.message || "AI 服务异常")
+      } else if (event.type === "done") {
+        handlers.onDone?.(event as Done)
+      }
+    },
+  })
+}