xuyue/OJ2
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
696 Commits 1 Branch 0 Tags
95dc2f24e61b40ad210666e33a1f0746c234f821
Commit Graph
59 Commits
Author SHA1 Message Date
xuyueandClaude Opus 5.5 e511d82f3b perf(暗色): 提交列表、排名首屏卡掉的一秒多回来了 —— 全站共用一个 useDark 
VueUse 的 useDark 每个实例挂载时都插一段 style、getComputedStyle 逼整页重算样式，
亮色下它的「没东西要改就跳过」永远不成立。提交列表每行的结果胶囊（useTone）都调它，
一页 30 行就是 30 次整页重算，翻页、换条再来。

改成 shared/composables/dark.ts 的 createGlobalState，auto-import 用 priority 盖掉
@vueuse/core 的同名项，显式 import 的 7 处一并换掉。

生产构建、CPU 降速 6 倍实测：提交列表首屏主线程 2015 → 1092ms（列表出来 1.34 → 0.85 秒），
排名 1950 → 850ms，比赛 1060 → 757ms；右栏换到没看过的一条不再每次卡 100ms。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-11-03 13:55:33 +08:00
xuyueandClaude Opus 5.5 29c31640b5 refactor(课堂任务): 「课堂看板」改名「课堂任务」，地址换成 /task；班级 PK 换成 /pk 
- 界面上的「课堂看板」「课堂作业」统一叫「课堂任务」，顶栏、老师首页、后台菜单一起改
- 前端 oj/classroom → oj/task、oj/class → oj/pk，两个名字不再只差几个字母却毫不相干；旧地址不留跳转
- 后端 routes/classroom.ts 拆开：课堂任务的接口进 routes/task.ts（/task/board|lesson|today），
  首页的「上次来」「班里在做」进 routes/home.ts；共用的取题口径挪进 services/lesson.ts
- 契约 classroom.ts 同样拆成 task.ts / home.ts，ClassBoard* 改叫 TaskBoard*

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-11-02 22:53:07 +08:00
xuyueandClaude Opus 5.5 df8af40d61 feat(布置作业): 课上老师改了作业，学生页面上弹出改了哪些题，点「刷新」就拿到新题单
Deploy / deploy (push) Canceled after 0s
Details 
看板「改 / 新的一节 / 清掉」和后台课堂作业的增改删，前后比较学生看到的那一节，
真变了才按班推 lesson_update（加了、去掉了、语言、顺序），走学生的 /ws/config，老师不收。
没点刷新又改会合并成一条。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-11-02 21:14:52 +08:00
xuyueandClaude Opus 5.5 0916015405 feat(流程图): 输入/输出/语句/条件/循环五种框各一种颜色，不再输入输出同色、条件循环同色
Deploy / deploy (push) Canceled after 0s
Details 
输出改紫、循环改青，绿和红留给起止框、选中和标错。存下来的 Mermaid 里循环也标成
decision，画之前按「有箭头从后面绕回来」认出循环，历史提交的图也按新颜色画。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-28 12:33:00 +08:00
xuyueandClaude Opus 5.5 195069450f style(格式化): 改成单引号、一行最长 160，全仓重新格式化
Deploy / deploy (push) Canceled after 0s
Details 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-26 13:52:24 +08:00
xuyueandClaude Opus 5.5 793848b06f refactor(登录): 登录态从 Cookie 换成 access token + refresh token
Deploy / deploy (push) Canceled after 0s
Details 
- access token 是 15 分钟的 JWT，走 Authorization: Bearer；refresh token 7 天，每次换都轮换
- 退出登录、改密码、禁用账号仍然立刻生效：每个请求核对 Redis 会话和库里新加的 user.token_version
- 在服务器后台改密码 / 禁用，机房那边登着的也会一起下线（原来两边 Redis 分开，管不到）
- WebSocket 握手借子协议带 token；JWT 密钥存在本站 Redis，部署不用加配置
- 去掉 COOKIE_SECURE；上线后所有人要重新登录一次

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-20 19:22:52 +08:00
xuyueandClaude Opus 5.5 3fa897bec1 revert(流程图): 去掉「显示时自动认老参考图的框」——线上 36 张参考图已经全部转成结构树
Deploy / deploy (push) Canceled after 0s
Details 
c4306b0 是给手写 Mermaid 的老参考图兜底的；36 张已经在线上逐题转成画布格式（自动转 19 张、
照原图手工画 10 张，重复的比赛题 7 张），回读核对过其余字段没变，线上不再有没标种类的图。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-19 22:27:46 +08:00
xuyueandClaude Opus 5.5 c4306b092d fix(流程图): 老师给的参考流程图是一堆彩色方框，和学生画的标准符号对不上 
题面里的 36 张参考图都是 2026-10 之前手写的 Mermaid，一个框的种类都没标，只能按字分彩色。
显示前按写法和字认框（花括号是判断、开始结束是起止、以输入 / 输出 / 打印开头或写着
input( / print( 的是输入输出框，其余是处理框），换成标准形状和配色。数据不动；
学生的老提交都标了种类，不受影响。36 张全部渲染过，框数不变。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-19 22:18:28 +08:00
xuyueandClaude Opus 5.5 38360e8668 perf(流程图): 流程图改用 pele 渲染，懒加载从 200 kB 降到 44 kB（gzip）
Deploy / deploy (push) Canceled after 0s
Details 
mermaid 换成 obsidianmd/pele：同一套 Mermaid 语法、同步渲染、没有依赖。
库里 2170 张图（题目参考图 36、学生提交 2134）两边逐张对过，能画的和报错的完全一致。
配色按 pele 的 DOM 重写选择器，颜色不变；版本锁死在 1.6.0。

顺带按 modernPolyfills: true 重新探测了 polyfill 清单（50 项），并改正注释里
「DEBUG 会打印全集」的说法 —— 写死清单时它只回显清单。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-19 20:50:17 +08:00
xuyueandClaude Opus 5.5 e8a20d12f9 refactor(前端): shared / utils 不再 import oj 和 admin 下的任何东西 
依赖方向原来是反的：顶栏、登录框、举手列表这些 shared 组件从 oj/ 里拿东西。
- 跨端的接口挪进 shared/api.ts（按 apps/web/CLAUDE.md 的分法）：学生端题目列表、
  出题人列表、这节课的题、待弹的成就
- 这节课的 store → shared/store/lesson.ts；头像 RankAvatar → shared/components
- 纯函数挪进 utils/：举手列表的错法归类 errorKind、它依赖的答案错误分类 wrongAnswer
  和 Python 报错翻译 pythonError、题目列表行的 toProblemRow
- 只有后台在用的出题人下拉 AuthorSelect 挪回 admin/components

纯搬家。首页、题目列表、题目页、排名、课堂看板、后台题目列表打开无报错，
顶栏题号框敲 1001 回车直达题目页。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-16 15:11:21 +08:00
xuyueandClaude Opus 5.5 d4aadc7722 fix(后台列表): 加载失败有提示、慢的时候表格转圈、旧请求晚回来不再盖掉新结果
Deploy / deploy (push) Canceled after 0s
Details 
后台八个列表（题目、比赛、用户、公告、题单、AI 报告、从题库加题、标签下的题）原来是
`const res = await getXxx(); rows.value = res.results`：接口 500 或断网时什么都不提示，
表格停在旧数据上；关键词防抖和翻页一交错，先发的晚回来会把新结果盖掉。

shared/composables/listLoader.ts 的 track() 把请求包一层：带请求序号、出错按后端文案提示
（登录过期、没权限这几种全局拦截器已经提示过，不弹第二遍）、表格挂 loading。

实跑：六个列表各 10 行正常；拦掉题目列表的接口再翻页，弹「网络异常，请检查网络后重试」
（原来没有任何反应）。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-16 15:07:10 +08:00
xuyueandClaude Opus 5.5 309ca0ece2 refactor(前端): 全站共用的班级下拉、胶囊配色挪出提交列表目录，编辑器不再偷读题目页的 store
Deploy / deploy (push) Canceled after 0s
Details 
- classLabel / groupClassOptions / classSelectOptions 挪到 utils/classes.ts，useTone 挪到
  shared/composables/tone.ts：原来放在 oj/submission/ 下，被前台、后台、shared 引了 50 多处
- 流程图编辑器的草稿键改由题目页传进来（键名不变，学生存着的草稿照样读得到）。原来编辑器
  自己读题目页的 store 和路由拼，后台出题页也用这个组件，那边 store 是空的
- SQL 表名补全改由题目页传表进来。原来补全直接读题目页的 store，自学页的 SQL 代码块会
  补出上一道看过的题的表名

实跑：提交列表、题目页、排名、后台题目页、SQL 题、流程图题打开无报错；SQL 题输入 stu
补出 students；流程图加一步，草稿照旧存在 flowchart-v2-problem-<题号>。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-16 14:59:55 +08:00
xuyueandClaude Opus 5.5 64994b9499 perf(判题结果): 全班一起交、判题排队时不再每人每 2 秒问一次结果
Deploy / deploy (push) Canceled after 0s
Details 
原来交上去 5 秒没结果就每 2 秒（流程图 3 秒）拉一次，分不清 WebSocket 断了还是队列长：
50 人一起交、队列排一分钟时每秒二十几个请求，全在和判题抢那两个核。

- 收到这一条的任何推送（服务端订阅时就回一帧当前状态）就认定 WebSocket 是通的，
  轮询退到 20 秒一次，只防推送丢失；连接断了才回快档，2 秒起按 1.5 倍退到 10 秒
- 拉失败不再永久停掉（掉线那几秒拉失败是常事），连着失败 5 次才放弃
- 页面在后台时不拉；比赛题目页、榜单、班级页的定时刷新也一样，切回来立刻补一次
- 代码判题和流程图评分共用 shared/composables/fallbackPoll.ts

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-16 14:37:08 +08:00
xuyueandClaude Opus 5.5 90ce1ab0f5 fix(手机): 点开提交、班级详情、自学目录这类整屏的东西，按返回直接退出了整页，现在是先关掉它
Deploy / deploy (push) Canceled after 0s
Details 
- 提交列表：手机上点开一条，地址带上 ?id=，返回键就是关详情回到列表；刷新、转发链接
  也还停在这一条；上一条 / 下一条、翻页、滚动位置都在；详情里点「只看他」先关详情再筛选
- 看板讲错误、排名班级详情、自学目录、题目页底部抽屉：手机上按返回只关它（useBackClose）；
  在自学目录里选一课，返回是回到上一课，不多一站
- 分页列表（提交、题目、比赛、后台几个列表）用浏览器后退翻回前一页时会多压一条历史，
  前进的记录被冲掉、返回要多按一次 —— 电脑上也是，一起修了

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-15 11:55:30 +08:00
xuyueandClaude Opus 5.5 20a6f667d8 refactor(设置): 站点配置去掉从来没人读的网址、简称、页脚三项和 AI 小助手开关 
库里 options 表那几行旧值留着，没有代码再读。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-13 14:37:35 +08:00
xuyueandClaude Opus 5.5 1fcd12f6f4 feat(举手与协作): 顶栏「N 人举手」点开按题分组带错法；看板多一列「在写」点了就能看他的代码；帮完了回看板、还有人就「下一个」 
学生那边按钮写「xuyue 在帮你 / 在看你的代码」。顺带修了老师接单后编辑器里留着自己的
草稿或模板、学生的代码插在前面、两边从此不一致的问题。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-13 13:04:57 +08:00
xuyueandClaude Opus 5.5 09f8a56913 feat(流程图): 画流程图不用再拖框连线——点箭头上的 + 加一步，判断自动分出是 / 否，排版全自动 
原来要从节点库拖框、对准连接点拉线、自己摆位置，还能画出断线和孤立的框；
画布上全是彩色圆角块，交上去的却是平行四边形和菱形。现在照画布稿 FlowEdB：
- 图存成一棵结构树（顺序 / 判断 / 循环），开始、结束固定在两头，排版是纯函数
- 每根箭头上一个 +，点了选输入 / 输出 / 处理 / 判断 / 循环；点框直接改字，右上角「删除」
- 形状照国标流程图，画布、缩略图、交给 AI 的 Mermaid 是同一套；缩略图配色跟着画布改
- 已保存时间、撤销、重做挪到工具栏，「清空画布」收进「⋯」；空框交不上去
- 去掉 vue-flow 三个包（编辑器打包后 16 KB），删掉没人进的 /flowchart 页

2026-10 之前交的图是 vue-flow 格式，只能看缩略图、载不回画布；旧草稿键名不同，不去碰。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-12 20:56:45 +08:00
xuyueandClaude Opus 5.5 845e41c060 feat(自学): 自学重做——首页课程地图、读一课按项目分目录、代码块就地运行、学完给题做
Deploy / deploy (push) Canceled after 0s
Details 
- 顶栏「自学」进新的自学首页 /learn：接着学（按服务端记录，不再串到上一个学生）+ 按项目分组的课程地图
- 读一课：左边目录按项目折叠，正文加宽，右边本课大纲带练一练标记；去掉了不能运行的示例代码栏
- 正文里的代码块能改能运行，报错用题目页那套中文解释；读输入的代码出输入框
- 课末：练一练做到几道 → 学完了 → 老师挑的几道题（必会标出来）→ 下一课
- 练一练统一成绿色提交、结果一行字；手机版目录从底部弹出
- 后台：教程列表按项目分组拖动排序，编辑页左写右看、练一练插到光标处、挑相关题；
  自学情况改成方块格 + 还没打开过的名单

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-12 09:40:34 +08:00
xuyueandClaude Opus 5.5 50660abf11 fix(题目列表): 切了几个知识点再按后退，地址回到了全部题目、页面还停在上一个知识点 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-09 16:49:09 +08:00
xuyueandClaude Opus 5.5 1ba8928d41 feat(课堂看板): 「请假隐藏」不会用——改成班级旁一个「请假」按钮勾名单，请假的人变灰排到最后、今天有效
Deploy / deploy (push) Canceled after 0s
Details 
原来要先打开开关、名字变成带 × 的标签再点 ×，× 像删除；标完人从页面上消失，
恢复只能全部恢复。现在：

- 班级下拉旁「请假」按钮，标了人之后按钮直接写「请假 2 人：陈言、黄依露 · 修改」
- 弹框只列今天还没交过的人（请假的人一定在里面，刚上课时就是全班），勾上点确定
- 请假的人在表格里变灰排到最后，不算进进度和「还没交过」
- 交了题或举手就算来了，自动取消标记
- 有效期从两小时改成今天（请假一般是一整天），仍然只记在这台电脑上

顺带修掉：被标过的学生后来交了题，会从表格里整个消失、也不算进进度。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-09 10:38:25 +08:00
xuyueandClaude Opus 5.5 0bcc981e6f fix(提交列表/统计): 按方向键会顺手切掉「代码/流程图」、重判后右栏还是旧内容、没人交时统计说「全都做完了」 
提交列表：
- 焦点在单选框、下拉框上时方向键不再一边切控件一边换条；跨页没回来前不再连跳一整页
- 重判、重新评分之后右栏重新拉，不再命中旧缓存；同一条新旧请求不再互相覆盖
- 从「我的提交」点顶栏「提交」、浏览器后退时，地址里没有的筛选回到默认
- 找回点用户名开个人主页；「只看他 / 只看这题」学生也能用；重判不用等代码拉下来
- 手机上老师也能重判、能按语言筛，流程图行有手机排版；学生界面带着的班级筛选显示成能点掉的标签
- mermaid 画不出来时先说中文、原始报错折起来

统计页：
- 没人交时说「这段时间没有人交」，不再说「全都做完了」；没填题号时各处统一叫「做对过题」
- 班级按 class_name 单独传；查询失败清掉旧数据并说清原因；标签跟着查出来的那一份走
- 「语法未过」的格子单独标「语」；正确率不算还在判的；截断提示说清哪些数字受影响
- 看板的请假隐藏只藏还没交过、没在举手的人，「恢复」只恢复这个班的
- 手机上筛选折行、上下排，不再挤出屏幕

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-29 18:52:58 +08:00
xuyueandClaude Opus 5.5 f09da88ff7 feat(统计): 统计接口补上每人每道题的每一次提交、流程图每人最好的一次，流程图也能一次查几道题 
- 新增 GET /submissions/statistics/grid：范围内每个学生的每次提交（只含普通学生，最多 5000 条），
  没选班级时附带各班花名册人数，统计页按「人 × 题」画方块串、按班级汇总
- /flowcharts/statistics 题号可以一次填几道，多返回 people（每人分数最高的那张）

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-29 18:28:27 +08:00
xuyueandClaude Opus 5.5 22459cc212 feat(统计): 提交记录和流程图的统计弹框记住上次查的班级、题号、时间段，一小时内再打开自动带上 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-29 08:36:16 +08:00
xuyueandClaude Opus 5.5 26e22e2542 refactor(题目): 提交状态挪进 store——手机上切页签、桌面切分栏，判题结果和点评不再丢 
提交按钮那个组件（SubmitCode）在编辑器的工具栏里，而提交的全部状态和判完之后的
反应都长在它身上：手机上交完切到「描述」页签（Naive 的页签切走即卸载）、桌面切到
「题目 / 自测」模式，编辑器一卸载，判题结果、AI 提示、失败计数、通过后的点评、
题单里的回题单全丢了。

- oj/store/submission.ts：这次提交、判题跟踪、语法检查报错、结果面板开合、冷却、
  AI 提示（useSubmissionHint）
- SubmissionEffects.vue：挂在题目页这一层，失败计数、标成已解决、烟花、强制点评
  （连同「先点评再换题」的导航拦截）、回题单
- SubmitCode 只剩按钮和结果面板
- WebSocket 通道和判题监控的收尾改成 onScopeDispose：onUnmounted 在 store 里挂不上

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-28 13:36:35 +08:00
xuyueandClaude Opus 5.5 039992dc86 feat(前台): 顶栏可以输入题号直达；首页列出班里最近一次课一起做的题和自己的完成情况
Deploy / deploy (push) Canceled after 0s
Details 
课上老师报题号、全班去找，是 2025 秋七成非比赛提交的来路，界面上原本没有它的入口。

- 顶栏（桌面端）加题号框，首页「找题」同一套逻辑：题号对上直接进题，否则去列表搜
- 新接口 GET /me/class-activity：同班同一天 ≥5 人做过的题，取最近 7 天里最近的一天，
  附带我自己的状态与班里通过人数；首页据此显示「今天班里在做」卡片，没有就不占位

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-27 20:58:15 +08:00
xuyue d25b5dbe6d update
Deploy / deploy (push) Canceled after 0s
Details
2026-09-27 19:36:28 +08:00
xuyueandClaude Opus 5.5 572a818d49 style: 按 Oxfmt 重新格式化
Deploy / deploy (push) Canceled after 0s
Details 
换格式化器带来的差异，只有 5 个文件：长联合类型改成每项一行、以 | 开头。
和上一个提交分开，方便 blame 时跳过（git blame --ignore-rev）。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-27 15:37:23 +08:00
xuyueandClaude Opus 5.5 c43da01ff2 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>
 2026-09-27 15:01:43 +08:00
xuyueandClaude Sonnet 5 b5ba56ccd0 refactor(契约): 判题状态码收进契约唯一一份，并收紧 18 处 as any 
- 状态码常量与 judgeStatusSchema 移到 packages/contract/src/judge-status.ts，
  后端 judge/status.ts 只再导出；前端 SubmissionStatus 枚举加编译期断言对齐契约
  （实测改坏一个码会当场类型检查失败）
- 类型逃逸 22 处降到 4 处：collab/handler、pagination、configUpdate、
  ExerciseManager、ProblemSubmission、pk.vue tooltip；剩下的是词云插件无类型、
  生成的 .d.ts、skulpt 和 TextEditor

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-09-19 04:40:30 -06:00
xuyueandClaude Opus 5 ed56a209ea chore(格式): Prettier 统一到全仓，后端和契约一次性格式化
Deploy / deploy (push) Has been cancelled
Details 
原来只有 `apps/web` 在 Prettier 下（配置在 `apps/web/.prettierrc.toml`、脚本在
web 的 package.json），后端和契约从来没格式化过 —— 手写在 100 列上下，`db/schema.ts`
还是 drizzle-kit pull 留下的 tab 缩进。两套口径分叉久了，跨端改一处就得记着「这边
什么风格」。

- 配置搬到根目录 `.prettierrc.toml`，内容不变（`semi=false`，其余全默认，
  printWidth 80 —— 和前端已有的格式一致，不另立一套宽度）；
- 脚本统一成根目录 `bun run fmt`，覆盖 `apps/*/src`、`apps/web/tests` 和两个构建
  配置；web 自己那份 `fmt` 和重复的 prettier 依赖删掉；
- `.prettierignore` 挡掉两类不该碰的：drizzle-kit 生成的 `src/db/meta/` 结构快照
  （它是 db:generate 的比对输入，只该由 drizzle-kit 写）、unplugin 每次 dev 都会
  重写的 `auto-imports.d.ts` / `components.d.ts`；
- 全量跑了一遍。纯格式，无行为改动：api typecheck / check:routes / check:ast、
  前端 type-check 全过，起 api 打了接口确认正常。前端这 39 个文件的小改动是
  prettier 版本漂移（类型断言的换行口径变了），不是新配置带来的。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-16 08:27:34 -06:00
xuyueandClaude Opus 5 3559ae4d6f chore(前端): 浏览器基线从 Chrome < 94 提到 105，删掉 mermaid@9 那套 fallback 
机房只有部分电脑还是 Chrome 105，其余更新，按最低那档定基线。

- legacy 插件留着：vite 8 的默认 build.target 是 chrome111，比机房高。
  modernTargets 不写，用插件自带的 chrome>=105 基线，正好是这一档。
- polyfill 清单按 105 重新探测，63 → 50 项，仍然写死：自动探测要对每个产物
  跑 Babel 扫描，构建 3s → 12s。写死后产出的 polyfills chunk 与自动探测同尺寸。
- 删 mermaid-legacy(mermaid@9)、useMermaid 里按 UA 分叉的 v9 回调式 render、
  为它存在的 cytoscape UMD→ESM 别名 —— 105 直接用 mermaid 11。
- View Transitions 要 111，darkTransition 的降级分支保留，注释改成 105。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-16 07:43:21 -06:00
xuyueandClaude Opus 5 f581029eb2 refactor(统计面板): 抽出 useHiddenStudents，两份逐字相同的「请假隐藏」合成一份 
StatisticsPanel.vue 和 FlowchartStatisticsPanel.vue 各写了一遍隐藏学生的逻辑
（loadHidden / saveHidden / hideStudent / showAll / onMounted 里的过期清理），除了
存储键和一个参数名逐字相同；「这个人有没有被隐藏」的判断两边还各自内联了三处。

现在是 shared/composables/hiddenStudents.ts，存储键作参数传进去 —— 两个面板仍然各用
各的键，提交统计里隐掉的人不该连带在流程图统计里也消失，那是两件事。

composable 不导出 hiddenStudents 那张表本身，只给 isHidden / notHidden：两个面板要的
都是「这个人该不该显示」，把表递出去只会让判断逻辑又散回组件里。

## 验证

起全栈在浏览器里真点了一遍（提交列表 → 数据统计 → 未完成 tab）：

- 打开「请假隐藏」开关后学生标签变成可关闭，关掉「单田芳」，未完成从 5 变 4、
  「还没交」也同步从 5 变 4；
- localStorage 落的是 {"ks251单田芳": <时间戳>}，刷新页面后仍在，到期时间 120 分钟；
- 流程图那把键 oj_hidden_students_flowchart 全程为 null，没被串到。

vue-tsc、vite build 通过。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012j1vgeDqay8wKCh8dPgPcH
 2026-09-10 19:46:32 -06:00
xuyueandClaude Opus 5 79bfd28b07 chore: 删掉 369 行没有任何调用方的代码
Deploy / deploy (push) Has been cancelled
Details 
## utils/functions.ts 砍掉一半（622 → 291 行）

- trickOrTreat()：317 行、八种页面恶搞效果（中文乱码、页面翻转、去掉鼠标……），
  **全仓零调用**，占这个共享工具文件的一半；
- 文件末尾注释掉的 getChromeVersion / isLowVersion / protocol 六行。

## 其余没有调用方的导出

- services/achievement-metrics.ts 的 RARITIES / OPERATORS —— 和契约的
  achievementRaritySchema / achievementOperatorSchema 取值逐字相同，是没人用的第二份；
- collab/state.ts 的 hasRequest；以及 resetCollabState，它的注释写着「仅供进程退出或
  测试用」，而本仓库不写测试（项目约定），进程退出那条路径也没调过；
- contract/language.ts 的 JUDGE_LANGUAGES，注释说「前端用它排语言 tab」——前端并没有，
  它排 tab 用的是 constants.ts 里以 ProblemLanguage 为键的 SOURCES / LANGUAGE_SHOW_VALUE
  （那组映射的完整性 tsc 已经在管）；
- web 的 useSimplePagination（usePagination 的一层空壳包装）和 updateProblemSetProgress。

扫描口径：三个包全部 .ts / .vue 里逐个导出符号数出现次数，只在定义处出现的算无引用
（.vue 模板里的引用也计入）。剩下 56 个仍无引用的全部是契约里 `z.infer` 派生的一行
类型（46 个请求类型 + 10 个领域类型）—— 它们是在用的 schema 的类型另一半，成体系的
1:1 镜像，删一部分只会让那个文件变得随意，所以不动。

## 留给你定的一件事

`updateProblemSetProgress` 删掉之后，后端 `PUT /problem-set-progress`（routes/problemset.ts:249）
就没有任何调用方了。题单进度实际是判完之后由 services/problemset.ts 的 recordSolvedProblem
在服务端记账的（schema.ts 里那条注释写明了），这个端点是一条客户端自报进度的平行路径。
没顺手删：删端点是行为变化，而且不能排除有脚本在打它。

tsc、vue-tsc、vite build、单二进制编译、check:routes、check:ast 均通过。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012j1vgeDqay8wKCh8dPgPcH
 2026-09-10 19:38:16 -06:00
xuyueandClaude Opus 5 8520192a98 refactor(前端): websocket 合并三层继承与三份重复 composable，803 → 660 行
Deploy / deploy (push) Has been cancelled
Details 
## 删掉的

- **六个从没人传过的配置项。** WebSocketConfig 上的 maxReconnectAttempts /
  reconnectDelay / maxReconnectDelay / heartbeatTime / enableHeartbeat /
  enableAutoReconnect，六个默认值、六处 ??，而三条通道从建起来到现在没有一个调用方
  传过任何一个，也没在运行时改过。收成三个模块常量，连带三处恒真/恒不触发的分支
  （if (enableHeartbeat)、!enableAutoReconnect、reconnectAttempts >= Infinity）。
- **一个没人用的工厂。** createWebSocketComposable 顶着二十五行 @example，示例里那条
  通知通道并不存在，三个真实 composable 一个都没调它，各自手写一遍转发对象。
- **三个空壳子类。** SubmissionWebSocket / FlowchartWebSocket / ConfigWebSocket 的全部
  内容就是在构造函数里拼 URL；前两个连 URL 都是同一条 /ws/submissions，两个类加两份
  三十行 composable 的差异只有一个类型参数。改成 useChannel(path, handler) 一个工厂，
  三个 useXxxWebSocket 各自只剩一行。
- SubscribingWebSocket 这一层并进基类：三层继承变两层，只剩 CollabWebSocket 还在扩展
  （它确有自己的二进制缓冲与房间语义）。URL 拼接收进 channelUrl()。

行为一处没动：重连仍然不封顶（后端 deploy 重启一次就超过原来那 15 秒，这条注释保留）、
指数退避带抖动、30 秒上限、心跳 30 秒、force_logout、断线重连补订阅全部照旧。

## 验证

起全栈用浏览器实跑：

- 提交一发 Python3，/ws/submissions 连上并推回 judging → judging → finished，
  控制台没有出现「WebSocket未及时响应，启动轮询保底」，即结果确实走的 WS 而非轮询；
- kill 掉后端观察三条通道重连：682ms → 1.4s → 2.4s → 4.4s → …… → 15~26s 封顶，
  指数退避与 30 秒上限均符合；
- 后端起回来后**不刷新页面**自动恢复（/ws/config、/ws/collab 各自重连成功），
  再提交一发仍然全程走 WS —— 这正是「重连不封顶」要保的场景；
- vue-tsc --noEmit exit 0；vite build 通过。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012j1vgeDqay8wKCh8dPgPcH
 2026-09-10 18:25:47 -06:00
xuyue 69883bd016 fix chart
Deploy / deploy (push) Has been cancelled
Details
2026-09-03 02:35:29 -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): 教师端弹框补上代码提示，语言跟着学生走
Deploy / deploy (push) Has been cancelled
Details 
教师端的协作编辑器只有高亮和括号匹配，没装 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 4abaf9c7e4 fix(collab): 动态 import 竞态、切走页面的语义、演示模式的身份错位 
- collabDoc.start 要 await 六个动态 import，房间可能在这期间就关了（机房首次
  加载 y* 那几个 chunk 正是最慢的时候）。stop() 先跑完面对的是 doc === null，
  什么也拆不到；import 回来之后 start 的后半段照样建文档、装 binaryHandler、
  挂 yCollab、发 SyncStep1——给一个不存在的房间。加会话代号，过期就整个放弃。

- SyncCodeEditor 卸载（切走题目页、把语言切成流程图）原来只是悄悄 stop()，
  房间和 active 都还留着，老师那边模态框照开、字照敲，一个也到不了；watch
  没有 immediate，学生切回来也不会重建。改成明确 leave() 结束协作。
  另外 @ready 也作为起点之一：学生排队时切走、老师这期间接了单，切回来能接上。

- 演示模式下 isTeacherOrAbove 被强制 false，服务端却按库里的 adminType 照样
  把他算作在线老师：学生因此拿到 pending 而不是 no_teacher，排队等一个顶栏里
  根本没有求助列表的人；他自己看到的求助按钮点下去，服务端回「教师不能发起求助」。
  两头都不对，索性对演示模式整个关掉这个功能。

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 66a564710f fix(collab): 两处会让协作「看起来正常、其实各写各的」的缺陷 
都是实测复现出来的，不是推测。

1. 教师第二次接单，看到的是上一个学生的代码拼在自己文档里
   CollabModal 的 code ref 跨会话不清。n-modal 默认 display-directive="if"，
   每次打开都重挂 CodeMirror，拿这个 ref 当初始文档；而 yCollab 只观察 ytext、
   从不反过来用 ytext 覆盖编辑器。于是上一轮的代码留在文档里，新学生的内容
   作为 delta 插到位置 0，两边偏移从此对不上。
   实测三轮会累积成 CCC/BBB/AAA/XXX，且教师敲一行之后，教师看到
   「BBB/AAA/XXX」、学生看到「BBB/XXX」——两份不同的文档。
   改法：不绑 v-model，文档完全交给 Yjs；并把 start 的起点从「房间打开 +
   await nextTick」换成「编辑器 ready」，顺带修掉绑到已 destroy 的旧 view。

2. 学生换连接后房间静默死掉
   handleCollabOpen 迁移 socket 时只补发了 help_status，没补 room_open，
   而前端每次连接建立都会把 room 清成 null —— 页面显示「老师正在帮你」，
   编辑器却早把 yCollab 摘了，老师敲的字一个也到不了。
   补发 room_open 也修不好：CRDT 状态跟着旧连接没了，新建 Y.Doc 再 seed
   会和老师那份合并成重复文本。所以改成直接拆房、请求退回排队，
   老师再点一次 —— 和老师掉线走同一条路子。

顺带修掉验证时挖出来的第三个：握手帧会被丢。
两端挂 yCollab 的时刻不同步（教师等模态框、学生等 chunk），先挂好的那端发的
SyncStep1 到对面时还没有 binaryHandler，服务端转发是成功的、客户端却静静丢掉。
丢的偏偏是握手——y-protocols 里 A 的内容靠 B 发的 Step1 换回来，教师的 Step1
一丢，学生的代码就永远到不了教师那边（单向同步，同样看着像在协作）。
CollabWebSocket 改成 handler 装上之前先把二进制帧缓着，装上再按序放行。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016DHxhKNxXfG89JnVzHbvgj
 2026-08-30 09:37:41 -06:00
xuyueandClaude Opus 5 d1fc6349b7 refactor(web): 删掉 y-webrtc 协同编辑的旧实现 
sync.ts / syncStatus.ts、y-webrtc 依赖、PUBLIC_SIGNALING_URL 全部移除，
外部信令服务器 signaling.xuyue.cc 不再被使用。
顺带修掉 CLAUDE.md 里「协作在流程图编辑器」这句一直是错的描述。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016DHxhKNxXfG89JnVzHbvgj
 2026-08-30 08:22:06 -06:00
xuyueandClaude Opus 5 86857dedf0 feat(web): 协作编辑走 collab 通道 
Yjs sync/awareness 协议直接跑在 /ws/collab 上，服务端哑转发。
内容源是学生：学生端先把编辑器内容写进 ytext 再挂 yCollab，
教师端 seedContent 恒为 null —— 这条根治了老实现里谁的代码活下来看运气的问题。

订正 brief 里的一处疏漏：SyncCodeEditor.vue 挂在每个用户的题目页上，教师也不例外
（ProblemEditor.vue 只按语言是不是 Flowchart 分支，不看角色）。教师接单同样会让
collabStore.room 非空，若不按角色收窄，教师自己停在某道题页面上接单时，这个组件
会把教师自己的编辑器内容当成种子插入文档，还会跟 CollabModal 抢
setBinaryHandler 这个单例槽位。改为 `room && !collabStore.isTeacher` 才起协作，
教师端的协作只归 CollabModal 管。

另外两处修正：
- editorView 用 shallowRef 而非 ref —— CodeMirror 的 EditorView 是带 getter 的类
  实例，ref() 的深度 UnwrapRef 会把它拆成丢了原型方法的假类型，vue-tsc 报错。
- Header.vue 挂 CollabModal 放进根 n-flex 内部而不是同级 —— 组件一旦变成多根
  fragment，default.vue 里 `<Header class="header" />` 的 class 就没有单一根节点
  可以落地，header 行会丢掉居中样式（实测触发了 Vue 的
  Extraneous non-props attributes 警告）。n-modal 默认 teleport 到 body，塞在
  这里不影响其实际渲染位置。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01K1d8B3f4SXJwDvUY625eQd
 2026-08-28 07:43:08 -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
xuyue c04570b4ad feat(web): BaseWebSocket 支持二进制帧收发 
onmessage 原来无条件 JSON.parse，收到 Yjs 二进制帧会落进 catch。
加 onBinary 钩子与 sendRaw，让 collab 通道能复用基类的重连与心跳。
 2026-08-28 02:06:13 -06:00
xuyueandClaude Opus 5 5f0fe713dc fix(流程图渲染): 出错后再也画不出来、每失败一次往 body 漏一个 div 
## 渲染失败后永久空白

四个渲染点都是同一个写法：

    <n-alert v-if="renderError" ... />
    <div v-else ref="mermaidContainer"></div>

一旦渲染出错，容器被 `v-else` 卸载，`mermaidContainer.value` 变成 null。而
`renderFlowchart` 一进来就先清 `renderError`、再因为 `!container` 直接 return ——
于是**报错提示消失了，图也再画不出来**，只剩一块空白，只能刷新页面。翻历史提交
最容易踩到。改成容器常驻、用 `v-show` 隐藏，和 MermaidEditor 本来的写法一致。
`FlowchartScoreDetail` 那处 Teleport 上不能挂 v-show，把条件挪到内层容器。

实测：修复前切回合法代码后 0 个 svg（永久空白），修复后正常渲染。

## 每次渲染失败都往 body 漏一个 div

`m.render(id, code)` 没传容器，mermaid 会在 `document.body` 上建一个临时
`div#d{id}`。而 `suppressErrorRendering` 默认关着，看 mermaid 源码，解析出错时
是先 `errorRenderer.draw()` 再 `throw`，**清理临时容器的那行在 throw 之后**，
永远执行不到；每次 render 用的又是新的随机 id，`removeExistingElements` 也清不掉
旧的。于是渲染失败一次就留一个。

出题页是边敲边预览，且没有防抖，每个字符触发一次完整渲染，中间态几乎全是语法
错误 —— 实测逐字符敲 26 个字符，body 里留下 16 个残留 div。打开
`suppressErrorRendering`（该分支是先清理再抛）+ 预览防抖 300ms，实测降到 0，
预览功能不受影响。

## 顺带

`loadMermaid` 缓存的是实例，两个组件同屏挂载时会双双落进 `if (!mermaidInstance)`，
import 和 initialize 各跑两次。改成缓存 Promise，并在失败时清掉缓存，避免一次
网络抖动把后续所有渲染都钉死在这个失败结果上。

`SubmitFlowchart` 的 `updatePage` / `openDetailModal` / `loadToEditor` 一并补了
错误兜底（同文件，见下一个提交的说明）：前两个失败时 `rendering` 会卡在 true，
弹框永久转圈；`loadToEditor` 是裸 `JSON.parse`，老提交数据坏掉就点了没反应。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-27 06:14:40 -06:00
xuyueandClaude Opus 5 64facc5701 fix(WebSocket): 断线不重连、评分结果会丢、登出后连接还活着
Deploy / deploy (push) Has been cancelled
Details 
排查 WS 这一块时发现的一批问题，多数是「机制写了但从没生效过」。

## 重连

`disconnect()` 里 `enableAutoReconnect = false`，而 `connect()` 从不改回 true ——
登出再登录后，这条连接就永远失去了自动重连能力（configUpdate 那条 watch 上尤其
明显）。改成用 `closedByUser` 表达「用户主动断开」的意图，和 `enableAutoReconnect`
这个**配置**分开。

`scheduleDisconnect` 的回调里断完紧接着一句 `enableAutoReconnect = true`，而
close 是异步的 —— 等 onclose 跑到时标志已经翻回来了，1 秒后又自动连上。那个
「15 分钟空闲省资源」从来没真正断开过。现在只断开，不做事后翻转。

重连的 setTimeout 没存句柄，组件卸载后照样触发 `connect()`，在已销毁的组件上
又建一条连接。现在 `disconnect()` 里 clearTimeout。

退避从「线性 ×5 次」改成「指数 + 抖动、30 秒封顶、次数不封顶」。原来 1+2+3+4+5
只有 15 秒，后端 deploy 重启一次就超了，之后这条连接死到用户刷新为止。抖动是
为了避免一个班几十台机器在同一毫秒一起冲回刚起来的后端。另挂 online /
visibilitychange，网络恢复或切回标签页立刻重连，不必等退避走完。

所有 socket 回调改成闭包住局部 ws 并在入口 `if (ws !== this.ws) return`，旧连接
迟到的 onclose 不再污染新连接的状态 —— 也是让 `disconnect()` 能被 onclose 识别
出来的关键。

## 订阅重放

`pendingSubmissionId` 一发送成功就清空，它只解决了「还没连上就 subscribe」，
**没解决断线重连**。而真正会丢结果的恰恰是后者：服务端收到 subscribe 会回一份
当前状态，掉线期间错过的推送就是靠这次重放补回来的；不重新订阅，重连后只收得到
「将来」的事件，可结果已经是过去式了。改成订阅意图保留到显式 `unsubscribe()`，
每次 onConnected 都重发。

这套逻辑原来只有 SubmissionWebSocket 有，FlowchartWebSocket 是 send 失败打一行
日志了事 —— socket 一掉，那次评分结果就再也回不来，按钮一直转圈。提成公共基类
SubscribingWebSocket，两条通道共用。

流程图另加轮询兜底：提交后 5 秒 WS 还没出结果就每 3 秒拉一次，读 status 2/3
结算，3 分钟上限。判题那边一直有兜底，流程图这边没有，而 Redis pub/sub 是发完
不管的，worker 推的那一刻连接不在就永远丢了。

`useSubmissionMonitor` 里 `watch(wsStatus, ..., { immediate: true })` 的回调在
watch() **返回之前**就同步跑了，已经连着时 `unwatch` 还是 null，if 不成立，
watcher 永远停不掉：每提交一次泄漏一个，往后每次重连它们都会把各自那个早就判完
的旧 submissionId 重新订阅一遍。整块删掉，直接 subscribe —— 基类已经管了时序。

WS handler 原来不校验 submissionId。学生同时开着几道题的页面时，每条连接都订在
同一个用户 topic 上，别的页面的评分结果会被当成自己的。

## 会话

握手时校验过一次会话就再也不管了，这条连接却能挂几个小时：用户在别的标签页
登出、或者会话本身到期，旧 socket 照样收推送。加一条 60 秒一轮的巡检，用
Redis EXPIRE 一条命令同时完成「判断存在」和「续期」（续期是必要的：只开着页面
挂 WS 的人一次 HTTP 请求都不发，不该被算成不活跃踢下线）。Redis 抛错时整轮
放弃，绝不因为一次抖动把全班踢下线。

禁用只改数据库的 isDisabled 列、不动 Redis 里的会话，巡检永远发现不了。加
`session:revoked` 频道主动通知，**两种作用域不能混**：

    { token }   用户登出。只断这一张会话 —— 同一个人在别的设备上是另一张
                会话，按 userId 广播会把他手机上的登录一起踢掉
    { userId }  账号被禁用。所有设备都得断

先发一帧 force_logout 再隔 100ms 断开。只断不发的话前端只看到一次普通掉线，
会照常重连、页面上还显示着登录态。token 不进帧里 —— 那是 httpOnly cookie 的值，
推到 WS 上就等于交给了 JS，匹配全在服务端做。

前端在协议层拦截 force_logout（和 pong 一样，不下发给业务 handler），并主动
disconnect —— 否则会一路 401 重连到退避上限，正是这机制要消掉的浪费。表现刻意
和 utils/api.ts 里 account-disabled / login-required 两支保持一致：同一件事从
HTTP 和 WS 两条路进来，学生看到的不该有两个样子。

## 开销与安全

`void handleMessage(...)` 是裸的，里面有两次 DB 查询和一个会抛的 schema.parse，
库抖一下就是一个 unhandled rejection（隔壁 bridgeSubmissionEvents 两处都接住了，
只有这里漏了）。

ping 提到用户查询之前。原来的顺序是「先查 user 再看消息类型」，每个客户端每
30 秒都要为一次心跳打一趟数据库。禁用用户不会因此漏网：推送路径上 bridge 会查，
subscribe 这条真正读数据的路径下面照样查。

bridge 两条 per-user 通道都先看 `server.subscriberCount(topic)`，没人订阅就别
查库了 —— 判题高峰期绝大多数事件的目标用户此刻并不在线。

flowchart 评分失败原来把 error.message 原样推给学生、前端直接弹出来，AI provider
的地址和内部报错就这么进了浏览器。改成真实原因写服务端日志。

加每连接令牌桶（20 突发 + 每秒回填 2）。一条 subscribe 在服务端是一到两次数据库
查询，一个学生开着一条 socket 狂发就能压住库。正常流量离阈值几十倍远。

升级时校验 Origin。会话 cookie 是 SameSite=Lax、WS 握手不是导航，跨站页面本来就
带不上 cookie，所以这是防御纵深不是唯一防线。同源放行；本机开发（Vite 5173 →
API 3000）自动放行，且只在两边都是本机时成立 —— 生产环境 url.hostname 是正式
域名，这条永远不触发；跨域部署走 ALLOWED_WS_ORIGINS。不发 Origin 的一律放行：
真正的攻击面是带着受害者 cookie 的浏览器页面，而浏览器一定会带 Origin。

顺带：useConfigWebSocket 的 handler 从 onMounted 挪到同步注册（调用方在 setup
阶段就 connect() 了），删掉每条消息打完整内容的 console.log 和死字段
ws.data.username。

## 没动的

题目页上并没有两条 /ws/submissions —— Form.vue 里 SubmitFlowchart 和 SubmitCode
是 v-if/v-else，互斥。学生实际是 2 条连接：全站一条 /ws/config + 一条
/ws/submissions，正常，不必合并。

## 验证

55 个用例，分六组打桩跑（假 WebSocket + 假计时器；会话/限流/吊销三组对着真
Redis）：

    重连语义        7   断开后不再自我复活、卸载后计时器已取消、退避封顶、
                        online 立即重连、旧 onclose 不污染新连接
    订阅重放        9   未就绪时补发、重连后重新订阅、unsubscribe 后不再重放
    会话巡检        8   EXPIRE 三态、只断失效的、同 token 只查一次、
                        Redis 抖动时一个都不踢
    Origin/限流    13   跨站与跨端口拒绝、生产不因 localhost 开后门、
                        突发额度、按时间回填
    强制登出       13   登出只断同 token（别的设备不受牵连）、禁用断所有设备、
                        巡检先通知再断
    前端登出        5   两支表现、收到后不再重连、两条通道只处理一次

前两组做了改动前/后对比，老代码该挂的都挂了 —— 「重连后自动重新订阅」正是这么
跑出来的，此前我以为 pendingSubmissionId 已经覆盖了这种情况。

apps/api 的 tsc 和 apps/web 的 vue-tsc 都干净，仓库既有测试照常通过。

**SubmitFlowchart.vue 的轮询兜底未经运行时验证** —— 在 SFC 内，没搭组件挂载
环境，只过了类型检查和人工核对。要验的话，停掉 worker 提交一次流程图，看 5 秒
后是否转入轮询、3 分钟后是否给出超时提示。

这批改动动了 WS 的行为面（限流会断连接、Origin 会拒绝、巡检会踢会话），上线前
建议手测：提交代码看判题、切流程图看评分、后台改配置看全站生效、开两个标签页
在一个里登出、禁用一个在线学生看另一端反应。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-27 05:07:26 -06:00
xuyueandClaude Opus 5 6ac458e6f3 refactor(WebSocket): 判题/流程图推送改用驼峰，去掉没人读的三个字段 
submission_id / time_cost / memory_cost / err_info 是 OJ2 两端自己定的线上格式，
没有第三方消费（/ws/submissions 只有 apps/web 一个客户端），没理由留着 snake。
flowchart 那条更别扭：同一个对象里 submission_id 是 snake、criteriaDetails 是驼峰。

三个字段直接删掉而不是改名 —— 它们是从 statistic_info 原样抄出来的一份，前端
一处都没读过（useSubmissionMonitor 只用 submissionId / result / status）。耗时和
错误信息在提交详情里本来就有，判完了去拉一次就是，不必让推送顺带背一份 JSONB
的形状。score 保留，它不涉及大小写。

**没动的都是有外部约束的**，别顺手一起改：

- 发给判题沙箱的请求体（language_config / max_cpu_time / max_memory /
  test_case_id / io_mode）和它回的字段（cpu_time / memory / test_case）——
  那是沙箱的 API，不是我们的
- 测试点 info 文件的键，沙箱直接读那个文件
- submission.statistic_info 里的 time_cost / err_info / ast_results ——
  判题机按这套写，12 万条历史提交就是这形状
- acm_problems_status、progress_detail 这些存量 JSONB
- AST 规则键（for_loop）、成就指标（accepted_count）、reaction 语义键 ——
  那是词汇表标识符不是字段名，for_loop 还要映射到 tree-sitter 的 while_statement

验证：起 dev 栈（api + worker + 沙箱），学生账号真提一次代码，抓 /ws/submissions
的帧：

    {"type":"submission_update","submissionId":"bf13b7f0…","result":6,"status":"pending"}
    {"type":"submission_update","submissionId":"bf13b7f0…","result":7,"status":"judging"}
    {"type":"submission_update","submissionId":"bf13b7f0…","result":-2,"status":"finished","score":0}

subscribe 帧也换成 submissionId 并被接受（否则会回一个 error 帧，没有）。
流程图那条路径要 AI 评分才跑得起来，本机没配，只做了类型检查。

前后端同一个 docker 栈一起构建部署，没有版本错配窗口。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-27 00:48:54 -06:00
xuyueandClaude Opus 5 8ae14f055a refactor(站点配置): WS 直接推契约字段名，去掉前端那层 snake→驼峰胶水 
上一版是在前端加 toCamel 把 `enable_maxkb` 换成 `enableMaxkb`。但 snake_case
是 options 表从 Django 继承来的**存储格式**，只该活在库里；WS 这一跳两边都是
OJ2 自己写的，没理由让前端再维护一层换名。

后端改成广播 OPTION_KEYS 的 key（契约字段名）而不是 value（表列键），前端直接
按名字赋值。库里的列名一个字没动。

顺带清掉两处已经死掉的客户端→服务端配置推送：

- admin/setting/config.vue 保存后调 updateConfig("enable_maxkb", ...) 和
  ("submission_list_show_all", ...)。那条 ConfigWebSocket 从没 connect() 过，
  send() 直接返回 false；就算连上了，服务端的消息处理也只认 ping / subscribe，
  会回一个 error 帧。广播本来就由后端在 POST /admin/website 里做，八个键一个
  不落，这两行纯属多余，且用的正是刚废掉的 snake 键。
- ConfigWebSocket.updateConfig 一并删掉，免得再有人调一个静默失败的方法。
  这条通道是单向的，原地留注释说明。

验证：dev 栈 + headless chromium 走 CDP 抓 Network.webSocketFrameReceived。
后台保存配置后，页面收到的八条帧的 key 全是驼峰（websiteName / enableMaxkb
/ submissionListShowAll ...），且页面不刷新，document.title 和页头站点名当场
跟着变。小助手那四条路径重跑一遍照旧：未登录不加载、登录后出现、后台关掉当场
消失、开回来当场重现。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-27 00:42:14 -06:00
xuyueandClaude Opus 5 0f34d67cc8 fix(站点配置): WebSocket 广播的 key 是 snake，store 字段是驼峰，实时生效一直空转 
后端推的是 options 表里的 snake_case 键：

    {"type":"config_update","key":"enable_maxkb","value":false}

前端 configUpdate.ts 收到后写的是 `if (data.key in configStore.config)`，而
store 里的字段是驼峰（enableMaxkb）。这个 `in` 判断**永远是 false**，一条配置
都写不进去 —— 站点名称、页脚、班级名单、允许注册、提交列表看全部、知识库挂件，
全部都要刷新才生效，且没有任何报错。`conf.ts` 里那句「前端 configStore.config
用的就是这套键名」是写错的，八成就是照着它写的这段代码。

加一层 snake → 驼峰的转换。八个键都符合通用规则，所以用正则转而不是列表，
将来加键不用改这里；转完认不出来的键直接忽略，别把 store 撑出野字段。
站点改名时顺便同步 document.title —— getConfig() 里本来就是这么设的，
只更新页面里那份、标签页还是旧名字说不过去。

顺带把 MaxKB 挂件那块理干净：

- 加载条件改成「已登录 且 后台开关打开」。挂件本来就要登录才能用，原来对匿名
  访客也照样注入。
- 删掉它自己那条 /ws/config 连接和 handleConfigUpdate。store 修好之后，
  原有的 watch 自然就跟着动了；多开一条连接是重复的，而且没登录时会撞 401
  （后端 /ws/config 要求会话），控制台常年一条「[WebSocket] 连接错误」就是它。

匿名访客不做实时生效：/ws/config 保持要求登录，不对外开不鉴权的 WS 端点。
没登录的人下次刷新页面时拿到新配置。

验证：起 dev 栈，用一个假的 MaxKB embed 端点（返回建出 #maxkb-chat-button 的
脚本）顶掉真实地址，headless chromium 走 CDP 看 DOM：

    ① 开关=开、未登录        → 挂件不在，script 标签 0
    ② 开关=开、已登录        → 挂件在，  script 标签 1
    ③ 后台关掉（页面不刷新）  → 挂件消失，script 标签 0
    ④ 后台开回来（不刷新）    → 挂件重现，script 标签 1

另外把其余三条 WS 通道的键名也对了一遍，没有同类问题：submission_update
（submission_id / time_cost / memory_cost / err_info）两边都是 snake；
flowchart 的 criteriaDetails 两边都是驼峰且 handler 没读它；成就通知的字段
全是单词，不涉及大小写。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-27 00:34:51 -06:00
xuyueandClaude Opus 5 8600f8143a fix(MaxKB): 「启用 MaxKB」开关在生产构建下拦不住脚本 
vite 的 inject-maxkb 插件把 `<script src>` 写进 index.html 的 head，于是构建
产物在 Vue 启动之前就把第三方挂件拉下来执行了。App.vue 的 useMaxKB() 那条运行时
路径只能事后把标签和 `[id^="maxkb-"]` 的 DOM 删掉 —— 代码早跑完了。表现就是后台
把开关关掉、刷新，挂件的副作用照旧（其中之一是它自带的性能上报在每个页面抛
`Cannot read properties of undefined (reading 'startTime')`，堆栈全是 <anonymous>
因为它 bootstrap 时又 eval 了一层），而且关不掉。

改成只留运行时那一条路：

- 删掉 inject-maxkb 插件，index.html 不再带这个 script 标签。原地留注释说明
  为什么不能加回去。
- config store 的 enableMaxkb 默认值从 true 改成 false。默认 true 的话
  getConfig() 还没回来挂件就已经加载了，服务端说「关」依然晚一步。代价是配置
  拿不到时挂件不出现 —— 第三方脚本 fail closed 是对的方向。
- URL 为空的兜底从 vite 插件挪进 loadMaxKBScript，否则会拿 undefined 当 src。

验证：headless chromium 走 CDP 记录网络请求。

- dev（5173）：enable_maxkb=false → 0 个请求、0 个 script 标签；改成 true →
  发出 embed 请求、head 里 1 个标签。
- 生产构建（bun run build 后把 dist 静态跑起来、/api 转发到后端）：同样两种
  配置下分别是 0 和 1。构建出来的 index.html 里已经没有 maxkb 的 script 标签，
  只剩原本就在源文件里的那行 maxkbMaskTip。

MaxKB 脚本自身那个 startTime 报错是它自己的 bug，本次只保证「关得掉」，没去
动第三方代码。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-27 00:26:54 -06:00