7 Commits

Include renames

Author	SHA1	Message	Date
xuyue	d25b5dbe6d	update	2026-09-27 19:36:28 +08:00
xuyueandClaude Opus 5	88b695d34f	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
xuyueandClaude Opus 5	e62f41f6c7	refactor(web): Header 只管顶栏，全局的东西挂回 App ... Header 一直兼着「全局挂载点」：课堂求助的提示、新求助 toast、求助列表和 教师端协作弹框都寄生在里面，只因为顶栏是全局的。它其实不是 —— /admin/* 走的是 admin.vue，没有 Header，老师一进后台这四个消费者全部 卸载：求助照收，提示、角标、弹框一个都不出现，正好是 collab.ts 里写的 「老师可能正在后台改题时收到求助」那个场景。 这些东西跟着连接走，而连接在 App.vue 按登录态开关，所以搬进 CollabHost 挂在同一层。Header 因此不必再是单根组件，default.vue 那个靠 class 传 居中样式的写法也换成外层 div，连带删掉「必须挂在根 n-flex 内部」那段 补丁注释。 顺带： - 圆环扩散的暗黑切换抽成 useDarkTransition - 求助的角标/toast/列表不再限桌面端 —— 老师缩窗口也得知道有人在等； 接单确实要在电脑上写代码，那道闸挪进 HelpRequestList - 站名改 text 按钮，能 tab 到、回车能按 - logout 的两步收进 userStore.signOut() - 清掉死代码：handleMenuSelect 只认一个不存在的 key、active 里 ["user","setting"] 永远不生效的排除、两个 show:false 的菜单项 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QqqZwxtXLo2GTqMi51C94D	2026-08-31 07:36:14 -06:00
xuyueandClaude Opus 5	38b81881d5	feat(collab): 教师端弹框补上代码提示，语言跟着学生走 ... 教师端的协作编辑器只有高亮和括号匹配，没装 autocompletion —— 老师替学生 写代码时没有下拉补全，只能盲敲。而且语言写死 cpp()，学生写 Python 时老师 看到的是 C 的高亮。 - 求助协议带上语言：help_request 记到 HelpRequest，accept 时写进 Room， room_open 发给两端；认不出的语言一律当 C（老客户端不带这个字段，而它 以前就是写死 C 的） - 新增 help_language / room_language：学生在排队或协作期间切语言，只更新 语言，不动队列位置和房间；已开房就把新语言推给老师，弹框的高亮和补全 实时跟着换 - CollabModal 装上 autocompletion，和学生端用同一套 enhanceCompletion + completeAnyWord；语言→高亮扩展的映射抽到 shared/extensions/language.ts 两端共用，免得再分叉 - 学生端求助按钮合并状态提示：原来按钮旁边还挂一个 n-tag，一行工具栏在 1280 的机房屏上放不下，改成状态全进 label（已求助 · 待接入 / 已求助 · 前面 N 人 / xxx 老师帮你中） 扩展数组变了 vue-codemirror 会整体 reconfigure，但 CM6 对已存在的 compartment 取 `compartments.get() || ext.inner`，collabDoc 那个装 yCollab 的 compartment 内容会被沿用，切语言、切主题都不会把协作弄断 —— 实跑验证过 双向同步、补全下拉、协作中切语言三条路径。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015APGLsyaCUa7XFMYAaCho4	2026-08-30 10:28:36 -06:00
xuyueandClaude Opus 5	ffabcd4a0d	fix(collab): 提示会丢、排队位置不刷新；显式声明 lib0 ... - 一次性提示原来挂在题目页的 Form.vue 上消费：学生排着队切去看提交记录， 老师这时取消了他的求助，那条提示就永远没人消费。挪到顶栏统一弹， 教师端的 error 提示同理。另外加了序号——连着两次同样的文案在 Vue 眼里 === 相等，watch(notice) 不会第二次触发。 - queueAhead 原来只在「建请求 / 重连 / 退回排队」推过，前面的人被接走或 被取消之后不重算，第五个学生会一直显示「前面还有 4 人」。跟着 broadcastRequests 一起推，两件事永远同时发生。 - collabDoc 动态 import 了 lib0/encoding 和 lib0/decoding，但 lib0 不在 package.json 里，靠 yjs 提升到根 node_modules 才能解析。上游依赖树一变 就断，而且断在运行时不在构建时。按现装的 0.2.117 钉住。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016DHxhKNxXfG89JnVzHbvgj	2026-08-30 09:38:04 -06:00
xuyueandClaude Opus 5	ab8fcc2d42	fix(collab): room_closed 无条件归位、断线重连补状态、学生 socket 重连迁移 ... Critical：room_closed 不再按 reason 挑着重置 helpStatus——学生自己的 socket 发送失败时服务端删了请求却发不出任何纠正帧，store 会卡在陈旧的 active/pending 上出不来。现在一律先归 idle，老师掉线那条路径服务端会紧跟着补一条 help_status:pending，同一条连接消息严格按序到达，不会被这次重置抢跑。 Critical：断线重连没有补状态。前端 CollabWebSocket 加 onConnected 钩子， 每次连接建立（含重连）都清空本地 requests/helpStatus/room，等服务端补发； 后端 handleCollabOpen 对非老师的重连方，如果这个账号名下还有请求， 补发对应的 help_status（pending 带重算的 queueAhead，active 带 teacherName）。 Critical：重连后请求仍绑在旧 socket 上，导致 handleHelpCancel 的归属校验 认不出新连接、后续通知也写进死连接。handleCollabOpen 里把请求和（如果有） 房间迁移到新 socket，并清掉旧 socket 的 roomOwnerId，防止它稍后的 close 反过来拆掉刚迁移出去的房间。 Minor：disconnect() 补齐 queueAhead/teacherName/notice 的重置，不留陈旧值。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01K1d8B3f4SXJwDvUY625eQd	2026-08-28 06:01:41 -06:00
xuyueandClaude Opus 5	17aa69f8a7	feat(web): 课堂求助 store 与全局 collab 连接 ... 连接全局常驻，不跟题目页起落 —— 老师在任何页面都要能收到求助。 列表按题目聚合，同题多人时能一眼看出该全班讲。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01K1d8B3f4SXJwDvUY625eQd	2026-08-28 05:36:51 -06:00