feat(课堂求助): 教师端接单直接跳题目页协作，删掉 CollabModal

点求助列表里的一条 = 跳到 /problem/:id，在页面自带的那个编辑器里和学生同步。原来是弹一个 CollabModal（弹框里再挂一个 CodeMirror + 一份只读题面）： - 按一下 Esc 弹框就关、协作跟着结束（`show` 的 setter 里 leave 是唯一的关闭语义， Esc 和点遮罩都走它），上课太容易误触； - 弹框里那份题面不能跑测试、不能提交，老师还是得另开标签页对照。现在结束协作只有两条明确的路：工具栏的「结束协作」按钮、离开这一页。教师端也少了一个 CodeMirror 实例 —— setBinaryHandler 那个单例槽位只剩 SyncCodeEditor 一个使用者。改造中撞出两个真问题，根因是同一个：`/problem/1002` → `/problem/1001` 是同一条路由换 params，**组件被复用、不卸载**。 - 老师在别的题上接单跳过来，`@ready` 不会再触发，而 room 早在导航前就 open 了 —— 老师停在一个空编辑器上干等。watch 的源从 room 一个变成 [room, roomIsHere] 两个。 - 反过来老师协作中切去别的题，onUnmounted 不触发 → 不发 leave，学生一直挂着「老师正在帮你」而老师的字一个也过不去。加 `bound` 标记区分「房间从我这儿挪走了」（补发 leave）和「房间在别处开起来了」（跟我无关，接单那一瞬间就是这种）。 `leave` 分两种语义（协议加 reason）： | 前端 | 求助记录 | 对面看到 | |---|---|---| | leave("done") 点「结束协作」 | 删除 | 老师已结束这次帮忙 | | leave("left") 离开这道题的页面 | 教师走→退回排队；学生走→删除 | 老师暂时离开，已重新排队 | "left" 复用的是老师掉线那条路（requeueAfterTeacherGone），两件事语义相同。原来两者都按 done 处理 —— 老师点一下「提交信息」，学生就得重新举手，而他看到的是「协作已结束」，会以为被处理完了。发起方收到的 reason 单独一份（self_left/done），不然学生自己切走了却看到「老师已结束这次帮忙」。其余为这套交互补的闸： - 学生排队期间离开那道题 → 自动取消求助。那条求助说的是「我卡在这道题」，人走了就不成立；原来它会一直挂在队列里，老师接进来时学生的编辑器不在这道题上、根本不会绑，老师对着空编辑器敲字，两边都没提示。 - 协作中**教师的语言选择跟着 room.language 走**（写 codeStore，不只是改高亮），结束后还原。只改高亮的话老师会拿自己那档语言提交学生的代码（学生写 C、老师选的是 Python，当场 CE），工具栏还可能显示「提交流程图」。学生端一个字不动 —— 服务端的 room_language 只发给教师，学生本地那份停在建房那一刻。 - 协作中不给「重置代码」：v-model 一写回就顺着 Yjs 同步过去，等于一键清空学生的作业。 - 协作中「提交信息」走新标签 —— 那是教师工具栏上唯一会跳路由的按钮。 - 接单时 resetScreenMode()：分屏在「题目」「自测」两档时右侧编辑器根本没挂出来，停在同一道题上接单会落进一个没有编辑器的页面（跳到别的题时 detail.vue 的 init() 会重置，同页不会）。 - 老师已在一个房间里时前端也拦住接下一单（服务端本来就拦），不拦的话前端已经跳到新题目上，等于把手上那场协作断掉。 - 文案：协议层那四条英文（Invalid problemId 之类）会被原样弹成 toast，改成中文；「请先退出当前协作」统一成「结束」；room_closed 的提示按 reason × 角色展开。验证：本机起 api + web，三个账号两两组合实跑 —— 跨题接单 / 同页接单、双向编辑、连按 Esc、结束协作、老师跳走后再接、学生跳走、学生排队中切题、学生协作中切语言、分屏在「题目」档接单、协作中重复接单，以及上面每一句提示的实际文案。 api typecheck / check:routes、前端 type-check / build、fmt 全过。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-16 19:13:42 -06:00
1 parent ed56a209ea
commit 88b695d34f
@@ -84,6 +84,37 @@ export const useCollabStore = defineStore("collab", () => {
    )
  })

+  /**
+   * room_closed 的提示语。四种 reason 各自对两个角色说一句准确的话 ——
+   * 原来不管什么情况都是一句「协作已结束」，学生分不出「老师处理完了」和
+   * 「老师走开了」。
+   *
+   * 服务端保证发起方和对面**收到的 reason 不同**（teardownRoom 的 initiator）：
+   * 自己干的是 `done` / `self_left`，对面才是 `peer_left` / `peer_offline`。
+   * 所以这里既要看 reason 也要看角色。
+   */
+  function closedNotice(reason: unknown) {
+    const teacher = userStore.isTeacherOrAbove
+    switch (reason) {
+      case "peer_offline":
+        return "对方已断开连接"
+      // 对面离开了这道题：学生那侧要说明求助的去向 —— 服务端紧接着会补一条
+      // help_status:pending 把他放回队列
+      case "peer_left":
+        return teacher
+          ? "学生离开了这道题，协作已结束"
+          : "老师暂时离开，你的求助已重新排队"
+      // 自己离开了这道题（跳走页面、把语言切成流程图）
+      case "self_left":
+        return teacher
+          ? "你已离开这道题，求助退回队列了"
+          : "你已离开这道题，协作结束"
+      // done：有人点了「结束协作」
+      default:
+        return teacher ? "已结束这次协作" : "老师已结束这次帮忙"
+    }
+  }
+
  const handleMessage = (data: CollabMessage) => {
    switch (data.type) {
      case "requests":
@@ -126,9 +157,7 @@ export const useCollabStore = defineStore("collab", () => {
        // 这里先归零，那条 pending 补发会立刻把它纠正回来，不会被这次重置盖掉
        room.value = null
        helpStatus.value = "idle"
-        setNotice(
-          data.reason === "peer_offline" ? "对方已断开连接" : "协作已结束",
-        )
+        setNotice(closedNotice(data.reason))
        return
      case "error":
        setNotice(String(data.message ?? ""))
@@ -192,8 +221,16 @@ export const useCollabStore = defineStore("collab", () => {
    ws.send({ type: "reject", studentId })
  }

-  function leave() {
-    ws.send({ type: "leave" })
+  /**
+   * 退出房间。**两种语义**（服务端按 reason 分，见 collab/handler.ts 的 handleLeave）：
+   *
+   * - `"done"` —— 点了「结束协作」，这次帮忙结束，求助记录一并清掉；
+   * - `"left"` —— 只是离开了这道题的页面。教师端「页面即协作现场」，跳走就不在
+   *   房间里了，但那不等于处理完了：服务端会把求助**退回排队**，老师回来再点一次
+   *   就接上，学生不用重新举手。
+   */
+  function leave(reason: "done" | "left" = "done") {
+    ws.send({ type: "leave", reason })
  }

  function sendBinary(data: Uint8Array) {