100 Commits

This Branch

This Branch

All Branches

Author	SHA1	Message	Date
xuyueandClaude Opus 5.5	c64b0a402b	feat(点评): 点评轮盘换成一排大按钮，选之前不显示人数，选完看大家怎么选、直接去下一题 ... - 七个选项不变，排成 4 + 3 的大按钮（表情 + 15px 的字）。原来的轮盘要把鼠标移到扇区上 才看得清，每块的字只有 12px 左右；还用了 Chrome 111 才有的 color-mix()，机房 105 那档 渲染不出扇区底色 - 选之前不显示「N 人选择」，免得跟风；选完换成横条图，标出自己选的那一项 - 防误触：弹出后 600ms 内点不了，强制弹窗里不响应 Enter / 空格，也不预选任何一项 - 选完弹窗不马上关，下面只有一个按钮、焦点就在上面：这节课的「下一题」，或者刚才被拦下 的换题「继续」，都没有就是「好的」 - 标题从「恭喜你成功提交」改成「做对了！」：交上去不等于做对 - 提交失败留在弹窗里提示「没记上，再点一次」；没做对的人在抽屉里只看到一句说明 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-28 16:22:48 +08:00
xuyueandClaude Opus 5.5	116b0a2c95	feat(题目): 左栏顶上标出「这节课做完几道」、题单进度或比赛倒计时，统计 / 点评 / 我的提交收进抽屉 ... - 上下文条（按入口三选一）：课堂 = 「这节课 做完 3/5」+ 每道题号 + 上一题 / 下一题； 题单 = 题单名 + 进度 +「第 N 题」+ 上一题 / 下一题；比赛 = 比赛名 + 每道题号 +「还剩 38:12」+ 排名。 题号只放号码，状态用 ✓ / ! 字符区分，不只靠颜色；多于 5 道横向滚动，当前题保持可见。 通过之后当场 +1，不用刷新 - 左栏只剩「题目 / 结果」两个页签；统计 / 点评 / 我的提交变成页签行右侧的按钮，点开是抽屉， 只盖题面、编辑器不动，交完判出结果时自动收起。手机上收进页签行的「⋯」 - 流程图并进「题目」页签：参考流程图默认折叠；自己画到 A/S 的那张缩略显示、可放大， 一进题就能看到（原来要先切到「流程图」这门「语言」），也不再强行切页签 - 「本题已经被你解决啦」两条整宽提示改成标题下的「✓ 已解决 / ! 尝试过」标签； 时间内存限制只写「限时 1 秒」 - 入口差异收成一张表（problemPageContext）：题单里不给抽屉、状态标签、相似题； 比赛里没有点评和求助。工具栏的「本题提交」挪到「我的提交」抽屉底部 - 顺手修：没有例子的题点「去自测猫」会抛错；「我的提交」没交过时一片空白 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-28 16:02:28 +08:00
xuyueandClaude Opus 5.5	45505e8384	feat(题目): 工具栏加「运行例子」、结果页签加「自己输入」，去掉每个例子旁的「测试」和顶栏的分栏切换 ... - 工具栏「运行例子」：一键用全部例子试跑（Judge0，不算提交），结果进「结果 › 运行例子」， 每个例子 ✓ / ✕，没对上的沿用答案错误那套中文说明；比赛里只摆输出、不给提示句 （后端在比赛里故意不做例子对比）；SQL 题不给 - 「结果」页签分成提交结果 / 运行例子 / 自己输入三段；「自己输入」顶替顶栏「自测」模式 那个单独的编辑器 - 试跑出错（编译、运行、超时）给中文说明，Judge0 的英文原文折叠起来 - 例子比对两边都去掉末尾空白：原来只 trim 了运行输出，样例末尾带空格的题永远「不通过」 - 去掉题面里每个例子旁的「测试」、顶栏的「双栏 / 自测 / 题目」切换、EditorForTest 和 screenMode store Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-28 14:35:58 +08:00
xuyueandClaude Opus 5.5	f4db7dc81c	feat(题目): 判题结果从提交按钮下的浮层挪到左栏「结果」页签——改代码时结果就摆在旁边 ... 原来结果是提交按钮下面的 n-popover：点一下外面就收起、最高 600px、盖住编辑器， 学生没法一边看「正确输出 / 你的输出」一边改代码，还得靠「上次结果」按钮找回来。 - 左栏新增「结果」页签（手机上排在「代码」后面），交上去或者语法检查没过就自动切过去； 页签标题带状态图标（✕ / ✓ / ! / 判题中转圈），不只靠颜色 - 页签用 show:lazy：切走不卸载，编辑器里的错误标记、AI 提示都留着 - 「题目描述」改叫「题目」；去掉浮层和「上次结果」按钮 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-28 14:21:57 +08:00
xuyueandClaude Opus 5.5	5cb7cfa924	refactor(流程图): 评分状态挪进 store——交完切去写代码，这次的评分结果不再丢 ... SubmitFlowchart 只在语言选成 Flowchart 时才挂载，评分的全部状态（WebSocket 订阅、 轮询兜底、3 分钟超时）都长在它身上：交完马上切去写代码，组件一卸载就断开连接， 正在评的那次结果丢了 —— 不提示分数，评到 A/S 也不亮到「我的流程图」。 - oj/store/flowchart.ts：提交、评分跟踪、评完的提示、A/S 亮图、最近一次分数； 换题和离开页面时收掉 - SubmitFlowchart 只剩从画布取图和评分详情弹框 - 顺手补了登录检查：原来没登录也能点，请求发出去才被拦，只看到一句「提交失败」 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-28 13:49:45 +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	a8b83ba762	refactor(题目): 比赛和题单改用题库那个编辑器——题单里的求助终于接得上，一键换中文标点也能用了 ... 比赛和题单原来用的是另一个精简版编辑器（BasicEditor），没有协作绑定、也没有 错误标记扩展：题单里学生点「求助」，老师接单后编辑器绑不上；比赛和题单里 「把中文标点都换成英文」点了没反应、出错行也不标红。三种入口统一成 ProblemEditor， 删掉 BasicEditor。流程图仍然只在题库入口出现（语言列表那道闸没动）。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-28 13:18:58 +08:00
xuyueandClaude Opus 5.5	0daa74651d	fix(题目): 通过后马上点「下一题」或换题，强制点评会被跳过 ... 从答案正确到点评弹窗出来有 1.5 秒（外加查一次评过没有），而换题会取消弹窗的 定时器 ——「下一题」在通过的那一刻就出现，学生手快就绕过了强制点评。 现在这段时间里离开这道题的导航（下一题、题号直达、顶栏导航、相似题……）先拦下： 立刻弹点评，选完再去原来要去的地方。只改 query（左栏切页签）不拦；弹窗已经开着时 也不拦，免得点评接口一直失败时把学生关在这一页。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-28 12:08:45 +08:00
xuyueandClaude Opus 5.5	85fadd237e	docs(题目页): 重设计的设计文档——结果放左栏页签，适配机房 1366×768 与 1280×1024 两种屏 ... Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-28 11:30:54 +08:00
xuyueandClaude Opus 5.5	1b149a4f3f	fix(题目): 在题目页里直接换题（下一题、题号直达）后，例子和语言还停在上一道题 ... 题目页换题是同一个组件复用、只换路由参数，几处只在创建时读一次的状态就停在了上一道题： - 例子：新题下面摆着旧题的例子，「测试」也拿旧例子比对 - 语言：下拉选项不跟着变，也不回退——从 Python 题跳到 SQL 题，语言停在 Python，提交必被拒 - 比赛 / 题单的编辑器只在挂载时载入一次代码 - 流程图：分数按钮、评分弹框、「我的流程图」还是上一道题的，上一道题还没评完的那次会挂到新题上 语言回退挪进 problem store 的 supportedLanguage()，两个编辑器在载入草稿之前调用， 保证先定语言再读这门语言的草稿。没有用给整块加 key 强制重新挂载的办法：课堂协作的 绑定依赖组件复用，重挂载会让协作中切题的老师语言恢复不了。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-28 09:15:50 +08:00
xuyueandClaude Opus 5.5	71670e609b	feat(成就): 新增「最长连续新通过周数」指标，按课表的节奏算连续；修掉比赛成就重扫因孤儿提交失败 ... 按天的连续成就对这里的学生基本拿不到：2025 秋最长连续交题天数的中位数是 1 天， 连续 7 天的只有 3 人。按周算，连续 2/4/8 周分别有约 73%/49%/8% 的学生做到过。 - 新指标 max_ac_week_streak：连续几个自然周（周一起、东八区）每周都至少新通过一道题 （不含比赛）。判题结算时增量累计（比按天那段多一道判断：重判更早的提交不会把连续清零）； 后台建成就触发重扫时，先从提交记录全量补算（refreshAcWeekStreakForAll），同 contest_joined - 老的「坚持三天」「坚持一周」不动：下架的成就连已获得的人也看不到 - 修：库里 28 个已不存在的用户留下了 935 条提交（其中 11 人有比赛提交），全量补算往 user_stat 写时撞外键，整次失败——比赛类成就的重扫因此一直是失败的；两处都改为只算 还在的用户。本地修好后重扫「初入赛场」补发了 3 人 - 本地验证：连续 2/4/8 周补发 1086/618/123 人，与独立 SQL 一致 线上要在后台手动建成就（指标选「最长连续新通过周数」），建的时候自动补发。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-28 08:27:25 +08:00
xuyue	8ca427b5cd	update	2026-09-27 23:28:17 +08:00
xuyueandClaude Opus 5.5	a7f6ebaf49	feat(激励): 知识点地图——每个知识点做对几道、在哪一档、再做几道升级，首页一句话提示本周进步 ... 现有 38 个成就全是累计量（通过几题、提交几次、连续几天），起步的人人都有、往上的够不着， 而且没有一个在说「你学会了什么」。连续打卡在这里结构上做不到：2025 秋学生最长连续交题 天数的中位数是 1 天，连续 7 天的只有 3 人。 - GET /me/knowledge：题数 ≥10 的知识点标签（10 个），每个给做对几道、档位、周一时的档位、 下一档门槛；四档 入门 1 / 会了 3 / 熟练 题数 40%（≤10）/ 精通 75%（≤20）。 回测 2025 秋：中位数学生一学期升 5 档；「入门」一档是给只做对一两道的 71 人加的 - 同班 ≥30% 点亮过的知识点才会出现在「还没碰过」里，免得 Python 班看到「C 语言」 - 个人主页加「我的知识点」，只在看自己时显示；首页一句话：本周升级 > 离下一档最近的 > 去点亮一个班里在学的，点了去按知识点筛的题目列表 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 23:17:43 +08:00
xuyueandClaude Opus 5.5	a63bf6ea07	feat(题目): 通过之后直接给出这节课的下一题；在题目页里换题时不再带着上一道题的结果和评价弹窗 ... 72% 的提交一次就通过，每次通过之后学生都要回首页或再问一遍题号去找下一道。 - 结果面板在通过时显示 LessonNext：取 /me/class-activity（老师布置的优先，否则推断）， 给出排在当前题后面、还没通过的第一道，后面都做完了再从头找；全做完了显示「都做完了」 并指向题单。当前题不在列表里、比赛、题单入口都不显示 - 评价弹窗关掉后重新打开结果面板：点弹窗时面板会被当成点了外面收起来，「下一题」就在面板里 - 换题（同一组件只换路由参数，有了题号直达和下一题之后成了常规操作）时收掉上一道题的 结果面板、语法错误、还在跟的提交（新增 useSubmissionMonitor.reset），并取消通过后 那两个 1.5 秒的定时器——否则会给还没做的新题弹评价，上一道判完时还会把新题标成已解决 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 22:58:19 +08:00
xuyueandClaude Opus 5.5	a6bf845e06	feat(课堂看板): 标出最近几节课经常没交的学生，求助的学生置顶，点一下打开求助列表 ... 2025 秋至少上过 5 节课的学生里，12.5% 七成以上的课一道都没交，37% 的学生贡献了 一半以上的「没交」；当堂那份「今天还没交过」把偶尔没来的和一直不动手的排在同一行。 - 看板接口给每个学生加 recentAttended：最近几节课（最多 5 节、不含今天、45 天内； 一节课 = 同班同日 ≥5 人做同一题）里交过几节，另给 recentLessons - 「今天还没交过」拆成「经常没交」（≥3 节可比且最多交过 1 节）和其他；表格加一列 「最近 N 节」；只给老师看，投影模式不出现 - 求助读老师端常驻 WebSocket 的 collabStore.requests（不改后端）：求助的学生置顶， 状态显示「举手了 / 老师在帮」，点一下打开求助列表；求助提示不论布没布置题都显示 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 22:47:24 +08:00
xuyueandClaude Opus 5.5	80106eaa04	feat(课堂): 老师的课堂看板——布置这节课的题、看全班谁还没开始谁卡住了，布置的题直接出现在学生首页 ... 2025 秋平均每节课有 14 个平时在用的学生一道都没交（三分之一），交了 3 次以上还没过的 平均不到 1 个；而老师原来只能一道题一道题打开统计弹窗看。 - 新表 class_lesson（迁移 0023，仅建表）：一个班一天一行，存老师布置的 problem.id 与顺序； day 存东八区日历日文本，created_by CASCADE - GET /classroom/board：这个班今天的题 × 全班学生（通过与否不限今天、今天交了几次、 最后提交时间）；不给班级时猜最近两小时提交人数最多的班，不记老师上次选的 - PUT /classroom/lesson：按展示题号布置，对不上的题号点名拒绝，空数组 = 清掉 - /me/class-activity 优先返回老师布置的题（source = teacher），否则照旧推断 - 前端 /classroom：没交过的名单置顶，按 没交过 → 卡住 → 在做 → 做完 排序，15 秒刷新； 投影模式只显示每题完成人数、不出名字；用户菜单给老师加入口 - 学生首页：老师布置的标题写「今天老师布置的题」，没人交时不显示 0/0 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 22:37:59 +08:00
xuyueandClaude Opus 5.5	7e964fdbdd	feat(题目): 答案错误时拿公开样例重跑，并排显示正确输出和你的输出，按差异类型给中文提示 ... 原来答案错误只有四个字。6901 条历史答案错误在公开样例上重跑过：73% 在样例上就错了， 其中约三分之一只差格式（没输出、input() 提示文字、空格换行、中英文标点、小数位数）。 - judge/run.ts 的 checkSamples：判出答案错误后以内联测试点重跑题目样例（output: true）， 记下第一个没过的样例和学生在它上面的输出，写进 statistic_info.sample_check； 样例全过则只记 passed。全是公开信息，不碰隐藏测试点；比赛不跑（有期末考试） - 前端按差异归类（数字先于「多了内容」判，免得 007 被当成多打了文字）， 并排显示输入 / 正确输出 / 你的输出，标出第一处不同的行；只差空白时把空格、换行画出来， 末尾空白不画（判题本来就忽略） - 提示给具体值（「正确输出是 84.10，你输出的是 84.1」），input("…") 单独提示 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 22:14:24 +08:00
xuyueandClaude Opus 5.5	db70ab62e8	feat(题目): 运行时错误告诉学生第几行、为什么出错（Python 看回溯，C 看信号），不泄露测试数据 ... 原来学生只看到「运行时错误」四个字：主判题 output: false，Python 回溯没回来； C 的信号值在 info 里，而 info 只给管理员。 - Python 判出 RE 时，拿第一个失败测试点单独重跑一次（内联测试点 + output: true）， 从回溯取行号（扣掉模板前置行）、异常类型和按句式归的类别。主判题仍不开 output， 免得每个点最多 16MB 的输出回到 worker - C / C++ 取失败点的信号和退出码（段错误提示 scanf 漏 &、return 非 0 等） - 写进 statistic_info.runtime_error；不存异常原文（里面常带测试点输入），名字只在 出现在学生代码里时才存——raise Exception(input()) 实测只落下类型 - 前端按类型翻成中文、摆出出错那行并在编辑器标红；比赛提交不诊断（ACM 只报对错） - 没有诊断的 RE 不再说「代码格式写错了」 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 22:01:30 +08:00
xuyueandClaude Opus 5.5	2a4405d2ea	feat(题目): Python 语法错误改成中文说明，在编辑器里标出位置，中文标点可以一键换成英文 ... 中职学生看不懂英文报错。原来提交前用浏览器里的 Skulpt 拦语法错误，只弹一句 「第 N 行存在语法错误」——Skulpt 九成报的是 bad input / bad token，没有列号。 - 提交前的语法检查挪到服务端：/code/format 先用 CPython 编译一遍（只编译不执行）， api 镜像加 python3-minimal（3.13，与判题机同版本，+17MB），前端删掉 Skulpt - 报错按规则表翻成中文（pythonError.ts），生产库 2695 条 Python 编译错误覆盖 99.7%； 提交前拦下的和判题回来的编译错误共用同一张卡片 - 编辑器里标红出错行和 ^ 指的位置 - 中文标点（历史编译错误的 22%）一键换成英文，跳过字符串和注释、处理 f 字符串花括号； 594 条里修好 593 条，经 tokenize 核对没有改到字符串内容；走编辑器事务，可 Ctrl+Z Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 21:47:01 +08:00
xuyueandClaude Opus 5.5	039992dc86	feat(前台): 顶栏可以输入题号直达；首页列出班里最近一次课一起做的题和自己的完成情况 ... 课上老师报题号、全班去找，是 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
xuyueandClaude Opus 5.5	d07459928d	feat(标签): 题目列表的标签分成「知识点」「主题」两组，新建的标签在后台标出待归类 ... - 迁移 0022：problem_tag 加 category（knowledge / theme）和 category_confirmed； 存量 25 个题材、题集类标签归主题，其余归知识点，全部记为已确认 - 前台题目列表按两组显示标签，组内按题目数从多到少 - 后台标签管理：每行切换分类；出题时新建的标签默认知识点、标「待归类」并排在最前， 页头提示待归类数量，可点「确认」保留默认；加分类筛选 - 新接口 PUT /admin/problem-tags/:id/category，设置分类即视为确认 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 20:38:43 +08:00
xuyueandClaude Opus 5.5	e1b6a9e9fa	feat(前台): 题单卡片显示完成进度，手机上题目列表不再横向溢出，个人主页数据排得更紧凑 ... - 题单卡片：完成进度条和「已完成 x / y 题」，「已完成」改成绿色，未获得的徽章置灰； 进度按加入时的快照算，题单后来加了题就注明「新加了 N 题」，不再出现「已完成」却是 5 / 6 - 题目列表：手机上只留状态、编号、题目、难度四列；标签默认收起，选中的标签显示在按钮旁 - 个人主页：六项数据保留，改成三列两行的小卡片，头像缩小 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 20:27:00 +08:00
xuyueandClaude Opus 5.5	6bf8c6e1d9	style(前台): 列表页去掉表头 emoji、已结束的比赛改成灰色；比赛列表置顶进行中的比赛，排名页先看榜单 ... - 前台 53 处表头改成纯文字，删掉只剩这一个用途的 utils/renders.ts - 「已结束」从红色改灰色（比赛列表 / 详情 / 后台 / 首页一起） - 比赛列表第一页、无筛选时顶部列出进行中和即将开始的比赛 - 内容少的页面页脚贴底，不再悬在半屏 - 排名页两张柱状图挪到最后，第一屏是 Top100、本周进步榜和我的排名 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 20:13:29 +08:00
xuyueandClaude Opus 5.5	31aa5f6e74	feat(前台): 登录后首页改成个人首页；题目详情页的代码要求挪到最前面、样例并排显示 ... - 登录后 / 是个人首页：继续学习、最近提交、进行中/即将开始的比赛、公告； 没登录仍是题目列表，题目列表另有 /problem 地址，顶栏「题目」指向它 - 继续学习按服务端留痕取最近打开的一课，不用 localStorage（机房一机多人） - 题目详情：标题下加难度与时空限制，代码要求提到最前，小节收紧， 样例输入/输出并排；工具栏「提交信息」「更多操作」改为「本题提交」「更多」 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 20:08:47 +08:00
xuyueandClaude Opus 5.5	d3823430f9	feat(后台): 侧栏分组带图标、可收起，加顶栏；所有后台页面统一页头 ... - 侧栏按 概览 / 教学内容 / 学情分析 / 站点管理 分组，去掉超管菜单里的重复项； 菜单项的角色与路由守卫一一对应，没有题目权限的教师不再看到点了就被踢回首页的「题目」 - 顶栏：面包屑、回到前台、明暗切换、用户菜单（退出登录）；窄屏侧栏自动收起 - 新增 PageHeader：标题 + 右侧主操作 + 下方筛选栏，编辑页带返回按钮 - 卡点分析 / 年度趋势 / 标签管理从题目列表的按钮挪进侧栏 - 首页改成统计卡片 + 班级排名卡片；设置页按钮移到卡片右上角 - 题目、比赛、题单、用户列表的「选项」列固定在右侧，不再被挤出屏幕 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 19:54:42 +08:00
xuyue	d25b5dbe6d	update	2026-09-27 19:36:28 +08:00
xuyueandClaude Opus 5.5	23844ae301	fix(班级筛选): 输入 ks251 会把 2511 班的学生也算进来 ... 班级号 3~4 位并存，按用户名前缀/包含匹配时 ks251 会捞到 ks2510~ks2519。 新增 classPrefixCondition：ks + 3 位以上数字按具体班级匹配（后面不能再跟数字）， 1~2 位仍是年级前缀。后台首页的用户排名、随机抽签，以及题单的学生进度筛选 （只填数字时补上 ks）都改用它。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 19:34:28 +08:00
xuyueandClaude Opus 5.5	41cd141769	docs(CLAUDE.md): 修正前端文档里指错的路径，补上提交约定 ... - apps/web/CLAUDE.md 三处 `../CLAUDE.md` 指向不存在的 apps/CLAUDE.md，改成 `../../CLAUDE.md` - composables 清单补上 aiStream - 删掉与旧版本对比的措辞（< 94 基线、mermaid-legacy、PUBLIC_OJ_URL）和格式化、时区的历史记录 - 新增「提交」一节：直接在 main 上干活、中文提交信息格式（原来只写在 AGENTS.md，Claude Code 读不到） Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 19:27:22 +08:00
xuyueandClaude Opus 5.5	a698ebf585	perf(前端): 首页和题目详情页按需加载，首页 477 → 380KB、详情页 1031 → 682KB（传输量） ... 浏览器实测（preview 构建，生产规模数据）：首页解压后 1428 → 1112KB， 未登录的题目详情页 3317 → 2021KB。后端接口 6–8ms，不是瓶颈，没动。 首页： - 登录速报弹框挂在默认布局上，静态 import 了 md-editor-v3（~160KB JS + 76KB CSS）， 而 AI 分析只在登录后、提交满 3 次才有。MdPreview 改成异步组件，目标是本地包装 LoginSummaryPreview.vue —— 直接 import("md-editor-v3") 会让 rolldown 把它和 CodeMirror 语言包并成一个 467KB 的 chunk，排名页反而涨了 560KB（实测） - 题目列表经 oj/api.ts 还带着 zod（~70KB）：那个文件静态 import 了题目详情、提交详情 两个 schema。改成和请求并行动态加载（单独的 oj/detailSchemas.ts，理由同 profileSchema.ts），闸门仍是同步的 —— submissionDetailSchema 有 .catch()， 不能改 contractDeferred 题目详情页： - skulpt（~226KB gzip）原来一选 Python 就立刻预取。改成登录后才取（没登录交不了）， 且等 requestIdleCallback，不和题面、编辑器抢带宽 - StatisticsPanel 只有老师可见，却被 EditorToolbar 静态 import，每个学生都白拉一份 chart.js（~68KB gzip）。改成异步组件，打开课堂统计时才加载 - SubmissionResult（带 DataTable）改成异步组件，第一次提交弹出结果面板时才加载 浏览器核过：首页正常；详情页未登录不再加载 skulpt / chart.js / DataTable；学生登录后 skulpt 空闲预取、提交后结果面板正常弹出；老师点课堂统计按需加载图表并正常渲染。 登录速报的 AI 分析与语法错误拦截路径本机没能触发，未在浏览器里核。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 16:34:32 +08:00
xuyueandClaude Opus 5.5	ca1df38440	chore(web): 构建配置清理 —— 别名读 tsconfig、调高 chunk 警告阈值、删死掉的 browserslistrc ... - resolve.alias 换成 resolve.tsconfigPaths，别名只在 tsconfig.app.json 写一份 - chunkSizeWarningLimit 调到 1000：超 500 kB 的三个 chunk（skulpt / wangeditor / @mermaid-js/parser）都是懒加载，默认阈值下每次构建都报，真涨了反而看不见 - 删 .browserslistrc（chrome >= 90）：renderLegacyChunks 关着时 plugin-legacy 不读它， vite / oxc 也不读，留着只会和 105 的基线打架 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 16:15:05 +08:00
xuyueandClaude Opus 5.5	9412ba3cf6	refactor(契约): 展示题号统一叫 problemDisplayId，题单 id 统一叫 problemSetId ... 前后端同时改，部署前开着的旧页面要刷新一次（题号列会是空的、提交筛选会失效）。 - 挂在非题目对象上的展示题号，原来叫 problem（字符串）或 displayId，统一成 problemDisplayId：提交列表、流程图列表、统计的 lastFailure / items / 今日最热题、站内信里的提交、后台题单的题目列表。别处的 problem 都是对象 或数字 id，这几处是字符串，最容易看错 - 列表筛选的 query 参数 ?problemId= 实际传的是展示题号，改成 ?problemDisplayId=（提交列表、流程图列表、三个统计接口） - 契约里 problemsetId / problemSetId、problemset / problemSet 两种拼法并存， 统一成 problemSetId / problemSet，和 ProblemSet* 类型名、problem-sets 路径、前端路由参数一致。drizzle 的列键跟表名走，没动 - aiDetail.user（用户名字符串，而契约里别的 user 都是对象）→ username。 ai_analysis.data 里存的历史快照仍是 user，没有代码读回它 - 后台题单题目表的列是按字符串键 'displayId' 取的，类型检查抓不到，一并改 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 16:08:31 +08:00
xuyueandClaude Opus 5.5	5ae830a7f9	refactor: 一批名不副实的命名改掉（只动一端，不碰契约） ... 后端： - getUserByToken → authenticateToken：它会删会话、续 TTL、记在线，不是纯读 - todayStart → dayStart(instant)：本来就接受任意时刻，不只是「今天」 - objectValue → asRecord，删掉 4 份一模一样的私有拷贝和 `as toObject` 别名 - 报错文案 "does not exists" / "Already be a public problem" 改通顺 前端： - utils/types 里 Contest / User / Problem 三个别名删掉：Contest 原来指后台 比赛、契约里同名的却是学生侧。现在 Contest = 学生侧、AdminContest = 后台， 后台用户表单叫 AdminUserForm，题目详情直接用 ProblemDetail - SubmissionInfo → ContestSubmissionInfo，免得和 submission.info 撞名 - utoa / atou → compressToBase64 / decompressFromBase64（实际是 zlib + base64）， encode / decode → base64EncodeUtf8 / base64DecodeUtf8 - filterResult → toProblemRow、toProblemListItem → toAdminProblemRow， 行字段 submission / rate → submissionCount / acRate - 组件：Modal → AddFromLibraryModal、Form → EditorToolbar、 ContestEditor → BasicEditor（题单也在用它）、rank 的 Index → RankMedal、 Name → UserNameCell、Password → PasswordCell、ContestType → ContestAccessTag Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 16:08:21 +08:00
xuyueandClaude Opus 5.5	572a818d49	style: 按 Oxfmt 重新格式化 ... 换格式化器带来的差异，只有 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	44295188b9	chore: 格式化、lint、任务编排换成 Vite+ ... Prettier + oxlint + 散在各包的检查脚本，收成 vite-plus（1.0.0-rc.1）一套，配置只有 根目录 vite.config.ts 一份： - fmt（Oxfmt，替掉 Prettier）：semi: false、printWidth: 80。Vite+ 下 Oxfmt 默认 100 列， 不显式写 80 就是 267 个文件的 diff。范围和原来 Prettier 一致，只管代码 —— md / yml / json / toml 排掉（文档表格、compose 注释是手排的），db/meta 快照和 unplugin 的两个 .d.ts 照旧排掉。.prettierrc.toml / .prettierignore 删除 - lint（Oxlint，vite-plus 自带同版本 1.85.0，单独的 oxlint 依赖删掉）：denyWarnings。 范围从三个 src 目录扩到全仓，多抓出 apps/web/vite.config.ts 里没人用的 loadEnv，删掉 - run.tasks：typecheck:api / typecheck:web / check:routes / check:ast 四个检查 + 汇总的 verify（vp check + 前四个）。一律经 `bun run <脚本>` 调 —— 任务定义在根包，PATH 是根 目录的 node_modules/.bin，直接写 tsc 拿到的是根目录的 TS 5.9 而不是 apps/api 的 TS 7， 实测报一堆假错 - 根脚本：fmt → vp fmt，lint → vp lint，新增 check → vp check。verify 不设同名脚本 （Vite+ 不许任务和脚本重名），用 `bunx vp run verify` - dev 仍是 bun run --parallel：常驻进程，缓存用不上 实测：verify 首跑全过；第二遍 5/5 命中缓存、0.25 秒；往 apps/api 塞一个类型错误， 只有 typecheck:api 和 check:routes 重跑并失败、前端直接命中缓存；.vue 里塞类型错误 同样被抓到；denyWarnings 下有一条 warning 退出码就是 1。前端构建、后端单二进制编译照常。 代价：vite-plus 带 vitest、tsgolint 等约 120MB 依赖，只进 Docker builder 阶段、不进运行 镜像，CI 的 --prebuilt 部署不受影响。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 15:37:23 +08:00
xuyueandClaude Opus 5.5	f8b04af4ea	chore: 加 oxlint，现存 19 条 warning 清零 ... 原来只有 Prettier，没有任何 lint。根目录加 `bun run lint`（oxlint，覆盖后端、前端、 契约，--deny-warnings：有一条就算失败），CLAUDE.md 常用检查里加上。 现存 19 条顺手清掉： - 11 处未使用的 import / catch 参数 / 回调参数 - oj/store/problem.ts：`...problem.value?.languages` 展开可能是 undefined （外层 if 已经保证非空，去掉 ?.） - admin/problem/detail.vue：`contestId = contestId` 自赋值，删掉 - judge/sql/engine.ts：注释里的 `/*x*/` 示例原来靠零宽空格防止提前闭合注释， 改成 `*\/` - 其余：多余的 !!、new Array(n)、展开里多余的 `|| {}` 两边类型检查、前端构建、后端单二进制编译都过。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 15:25:27 +08:00
xuyueandClaude Opus 5.5	83b9d23c68	perf(前端): zod 移出首屏包，首屏 JS 721KB → 594KB（gzip 237 → 199KB） ... 首屏包里带着整个 zod 运行时（~100KB），来路有三条，缺一条都挪不出去（逐条撤回实测过）： - 契约包没有 sideEffects: false，入口从桶里取任何一个值都会把所有 schema 模块带上。 契约包里没有顶层副作用（核过），加上之后 rolldown 才能按导出摇树 - roles.ts 里的 USER_TYPE / toAdminType 是入口要的，同文件却定义了两个 z.enum。 schema 挪到 admin.ts（唯一用处），roles.ts 文件头写明不许 import zod - 启动就要调的 getWebsiteConfig / getAILoginSummary 在 oj/api.ts 里，而那个文件同步 import 了题目详情、提交详情两个 schema。这两个函数挪到 shared/api.ts；那两道 闸门保持同步 —— submissionDetailSchema 有 .catch()，放行原文和解析结果不等价 - /me 的契约闸门改成 contractDeferred：先放行原文，schema 按需加载后在后台核、只记 日志。userProfileSchema 没有 default / transform，两者等价。动态 import 的目标是 单独的 shared/profileSchema.ts —— 直接 import 契约桶会让 rolldown 重排共享 chunk， 实测首屏反而涨到 1811KB 浏览器实跑核过：登录后 profile 正常加载、profileSchema 按需拉取、无控制台报错； 故意喂一份不符的数据，后台闸门照常打出 [契约] 分歧日志。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 15:23:31 +08:00
xuyueandClaude Opus 5.5	6b2da41882	refactor(题单后台): 添加 / 编辑弹窗两两合并成 ProblemModal、BadgeModal ... AddBadgeModal / EditBadgeModal、AddProblemModal / EditProblemModal 各是两份八成相同 的组件，改一处表单项另一处总要漏。合并成一个组件，传了 badge / problem 就是编辑、 null 就是添加；两种模式分别 emit create / update，detail.vue 的四个 handler 不变。 表单项、校验、文案、提交的数据形状都照旧（题目弹窗添加时带 problemId、编辑时只显示 标题）。有一处刻意的行为变化：编辑弹窗原来只在换了一条记录时才重新填表，取消后再打开 同一条会看到上次没保存的改动；现在每次打开都按库里的值重新填。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 15:16:03 +08:00
xuyueandClaude Opus 5.5	f49834f19f	refactor(班级 PK): 十个柱状图 computed 合成 barChart 工厂 ... 十张对比图只差标题和取哪一列，原来各写一份 18 行的 computed。合成 barChart(label, key)，key 限定为 ClassComparison 里值必为数字的字段， 渲染出的数据结构（labels / datasets / 配色 / borderWidth）逐字不变。 Chart.js 在本文件只注册了一次，没有重复。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 15:16:03 +08:00
xuyueandClaude Opus 5.5	e17da63fc6	fix(上传): 头像和题面插图按文件头认格式，不信扩展名 ... 原来只看扩展名：改个后缀什么都能落盘，再由 /public/* 按扩展名配 content-type 发出去。线上 Caddy 有 nosniff 兜着，但不该把非图片存到盘上。 - services/image.ts：按 PNG / JPEG / GIF / BMP 的文件头识别，返回落盘用的扩展名 —— 以内容为准，改名成 .png 的 JPEG 存成 .jpg，content-type 才对得上 - 头像上传、后台插图上传都走它；插图那边扩展名白名单保留当第一道快速筛 - serveUpload 自己也带 x-content-type-options: nosniff，不只靠 Caddy 实跑核过：真 PNG / GIF 正常；改名成 .png 的 JPEG 存成 .jpg；改名成 .png 的 HTML 两个入口都拒；/public/upload 回 image/png + nosniff。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 15:15:36 +08:00
xuyueandClaude Opus 5.5	b105fe3cbd	fix(测试点): 解压前按条目头拦大小，防 zip bomb ... 原来 unzipSync 先把整包解进内存，再逐个查大小 —— 检查之前就已经解完了。 实测一个 300KB 的 zip（10 个 30MB 的全零文件）让进程 RSS 涨 455MB， 容器只有 512MB。 - 第一遍 unzipSync 的 filter 只读目录、恒返回 false，按条目头的 originalSize 累计，单个超 32MB / 总计超 128MB 就抛；第二遍才真解，而且只解 N.in / N.out / N.sql（N ≤ 500），压缩包里别的文件一律不解 - originalSize 可以造假，但 fflate 按它分配输出缓冲、不扩容（解多了只截断）， 所以按它限额就是按实际内存限额 实测：同一个 zip bomb 被拦下时 RSS 只涨 1MB；单文件 300MB 的包按单文件上限拦； 正常测试点照常落盘、CRLF 照常归一、带 ../ 的条目名照常被忽略。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 15:14:12 +08:00
xuyueandClaude Opus 5.5	7a390323fe	refactor(前端): 接口错误改成 ApiError 类，catch 不再写 any ... 拦截器原来 reject 一个裸对象 `{ error, data }`，没有类型也没有类型守卫，于是 46 处 `catch (err: any)` 直接读 `err.data` / `err.error` —— 代码 bug 抛出的 TypeError 也按 接口错误读，弹出来的是 undefined 或英文。 - utils/api.ts：reject 改成 `ApiError extends Error`，字段名沿用 error（错误码）/ data（文案），存量读法语义不变；加 isApiError / errorCode / errorMessage。 errorMessage 对非接口错误一律用 fallback，不把 TypeError 的英文甩给学生 - 46 处 catch 全部换掉 any（45 处接口错误 + pythonSyntaxCheck 里 Skulpt 的错误对象） - 断网等没有响应体的情况，文案从英文 "Request failed" 换成「网络异常，请检查网络后重试」 浏览器实跑核过：登录密码错误仍显示「用户名或密码不正确」（错误码分支）、 接口错误 reject 出来是 ApiError、网络不通时拿到中文文案、非接口错误走 fallback。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 15:12:40 +08:00
xuyueandClaude Opus 5.5	6406794971	refactor(AI): 学情统计查询从 routes/ai.ts 挪到 services/learning-stats.ts ... routes/ai.ts 1149 行里约六成是 buildSolved / buildDetail / buildDuration 这些查询 构造器，它们不碰 Context，只是查询。挪出去之后 route 文件剩 585 行，只管 「鉴权 → 取参 → 调统计 → 回包」和 AI 调用本身；targetUser / throttleAi 依赖 Context，留在 route 里。 纯搬移，函数体一行没改。实跑核过：同一个用户的 /ai/detail、/ai/duration（按月、 按周）、/ai/solved、/ai/heatmap 五个响应，改前改后逐字节一致。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 15:09:21 +08:00
xuyueandClaude Opus 5.5	925cecb389	refactor(题目): 新建 / 复制题目收成 validateProblem、insertProblem、copyProblem ... admin/problem.ts 里四处 insert(schema.problem) 其实是两对重复： - 新建公开题 / 新建比赛题：公共校验 + SQL 展示数据 + 插入 + 写标签，逐行一样， 只差 contestId。编辑题目那条也抄了同一段校验。收成 validateProblem（校验 + 展示数据）和 insertProblem（插入 + 标签，一个事务）。比赛题当初就是抄漏了 sqlDisplay，现在三条路径只有一份 - 比赛题转公开 / 从公开题库拉进比赛：复制整行 + 统计清零 + 复制标签，收成 copyProblem 顺带 db/index.ts 加 DbOrTx 类型，四处 `tx as unknown as typeof db` 去掉。 唯一的行为差异：编辑题目时 SQL 展示数据的生成挪到了题号查重之前（和新建一致）， 两项同时出错时报的是前一个。 实跑核过：新建公开题、编辑、重复题号 409、新建比赛题、比赛题转公开（不可见、 标签跟过去）、从公开题库拉进比赛（可见、标签跟过去），SQL 题测试点缺失时照样拦下。 测试数据已删。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 15:07:13 +08:00
xuyueandClaude Opus 5.5	f2ca34fd4b	refactor(api): 请求体解析收成 readJson / parseBody ... 54 处 handler 都手写同一段： const parsed = X.safeParse(await c.req.json().catch(() => null)) if (!parsed.success) return failure(c, 400, "invalid-request", ...) 漏写 .catch 就是一个畸形请求打出 500。 - http.ts 加 readJson（读 + 校验）和 parseBody（再加上 400）。parseBody 不给 message 时回 zod 的第一条 issue —— 后台表单原来就是这么写的，fallback 文案 「Invalid payload」/「参数错误」只在 issues 为空时才用得上，实际走不到 - 51 处换成 parseBody；另 3 处失败时带别的错误码或和路径参数一起判，换成 readJson - 错误码、状态码、文案、判断顺序都不变 实跑核过：非 JSON 请求体回原来的固定文案，公告标题为空回 zod issue。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 15:04:19 +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 Opus 5.5	09030240b8	fix(AI): 流式调用加空闲超时、客户端断开即停上游、错误原因不下发 ... - streamChat 加 45 秒空闲超时（每收到一块重新计时，不掐长回答），原来 provider 卡住这条请求就永远挂着 - 加 cancel()：客户端断开时 abort 上游 fetch，原来会把 provider 的回答读完白烧 token， 还把「客户端走了」记成 AI 失败；现在留痕写「客户端已断开」 - 推给前端的 error 事件改成固定中文文案（缺 AI_KEY 时是「AI 功能未开启」）。原来 error.message 原样下发，里面可能是 provider 的 HTTP 响应体或数据库报错； 真实原因只进 console.error 和 onError 留痕 用假 provider 实跑核过：正常流式、客户端 1 秒断开时上游被取消、provider 500 时 客户端只拿到固定文案（响应体只在日志里）、provider 挂住 45 秒后收到 error + end。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 15:01:43 +08:00
xuyueandClaude Opus 5.5	04c0ccd304	fix(AI): Bun.serve 空闲超时调到 60 秒，AI 流不再在 10 秒静默后被掐断 ... Bun.serve 默认 idleTimeout 是 10 秒：连接上 10 秒没有字节往来就直接断开，不报任何错。 AI 的两条 SSE 都会静默超过 10 秒 —— streamWhole（AI 提示）在 produce 期间每 15 秒 才发一次心跳，一次生成加过滤重生成常常超过 10 秒；streamChat 等首 token 也常过 10 秒。 学生看到的就是「AI 提示生成失败」。 对齐反代链上最短的一环（NPM proxy_read_timeout 60s）。实测：provider 挂住时原来 10 秒整连接被断、客户端收不到 error 事件；改后按 streamChat 自己的 45 秒空闲超时收尾。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 15:01:43 +08:00
xuyueandClaude Opus 5.5	b38ad8ccee	feat(配置): 启动时用 zod 一次解析环境变量，有错拒绝启动 ... 原来是 `Number(env ?? 默认值)` 散写：JUDGE_CONCURRENCY=two 得到 NaN 照样起； DATABASE_URL 漏配就静默连上开发库的默认账号；AI_KEY 缺了要等第一次 AI 调用才报错。 - config.ts 一张 envSchema 覆盖全部变量，失败时列出所有问题后 exit 1 - 编译形态（线上）下 DATABASE_URL / REDIS_URL / JUDGE_SERVER_TOKEN 必须显式给， dev 默认值指向本机 5433 / 6380，放进容器里只会连不上或连错 - 空字符串按未设置处理（compose 的 ${X:-} 展开就是空串） - AI_KEY 为空启动时告警（AI 是可选功能，不退出） - db/index.ts 改读 config.databaseUrl；flowchart/run.ts 的 provider / model 改读 config 实跑核过：非法值被列出并拒绝启动；编译产物在仓库外无 env 时报三项必填， 给齐后 /health 正常；dev 的 serve / worker 照常起。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 14:53:51 +08:00
xuyueandClaude Opus 5.5	ca0dbbf0c5	fix(登录态): 退出和换人登录时整页重载，不留上一个人的数据 ... signOut 只清了 profile 和 localStorage，AI 分析、学情小结等 store 还在内存里。 机房一台机器轮着用，下一个学生登进来就能看到上一个人的 AI 分析。 - 主动退出：router.replace 换成 window.location.replace("/") - 被动下线（会话过期、别的标签页登出）仍然原地弹登录框，学生正在写的代码不丢； getMyProfile 记住本页最后一个登录的用户，登进来的换了人就整页重载 挨个 store 去 reset 迟早漏一个，重载一次最彻底。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 14:51:52 +08:00
xuyueandClaude Opus 5.5	fb240d4254	feat(限流): 登录、注册、比赛密码防爆破 ... 三处原来都不限次数。学生初始密码弱，/classes/:name/usernames 又能公开列出整班 用户名，等于现成的撞库名单。 services/throttling.ts 加固定窗口计数（INCR + EXPIRE NX，锁定时长就是剩余 TTL）， 何时计数由调用方决定： - 登录按用户名 15 分钟 10 次失败，成功清零；按 IP 15 分钟 100 次失败，成功不清零 （否则拿自己的号登一次就能重置）。机房一个班共用出口 IP，所以 IP 那道放得宽 - 注册按 IP 每小时 100 个成功注册 - 比赛密码按「人 × 比赛」10 分钟 10 次失败 - IP 取 X-Real-IP：api 端口不对外，Caddy 用 {client_ip} 覆盖写入，可信 前端登录、注册、比赛密码三处按新错误码给中文提示。 本机实跑核过：第 11 次错误登录被拦、成功清零（用户名大小写不敏感）、同 IP 换 100 个用户名被拦且别的 IP 不受影响、比赛密码第 11 次被拦。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 14:51:52 +08:00
xuyueandClaude Opus 5.5	5813981bb1	fix(部署): Redis 强制口令，外接形态部署前实测 ... 会话存在 Redis 里（session:<token> → 用户 id），能连上它就能伪造任意用户包括超管的 登录态。旧栈起的 oj-redis 发布在 0.0.0.0:5446、不带口令，2026-09-27 从公网实测 PING 得通。 - compose.debian.yml：REDIS_URL 用 ${REDIS_PASSWORD:?} 带上口令，缺了直接报错； 自带数据形态的 oj-redis 加 --requirepass，端口只发布在 127.0.0.1 - deploy.sh：外接形态下实测「不带口令连不上、带 docker/.env 的口令连得上」， 任一条不满足就中止部署 - clear-sessions.sh：从 docker/.env 读口令走 REDISCLI_AUTH；口令为空时不带 -e （空的 REDISCLI_AUTH 会发一条 AUTH ""，实测会报一行 AUTH failed） - compose.dev.yml：三个端口只绑 127.0.0.1 - docs/deploy.md 加「Redis 口令」一节：给旧栈 redis 加口令的一次性步骤 旧栈那份 compose 不在本仓库，线上 redis 的口令要照手册在服务器上手工加； 加之前 deploy.sh 会一直拦着。机房的 redis 不发布端口，不需要口令。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 14:51:52 +08:00
xuyueandClaude Opus 5.5	9d271942aa	feat(AI 提示): 题面补上输入输出说明和样例，HTML 去标签 ... 两段（诊断 / 生成提示）原来只喂 description，而且是 HTML 原文：模型拿不到输出格式 要求，「输出格式不对」这类最常见的 WA 基本看不出来。 - problemBrief：描述 + 输入说明 + 输出说明 + 最多 3 组样例，末尾点明判题逐字比对。 全是学生看得到的内容，两段都放；标准答案和测试点仍只进诊断 - plainText：去标签、段落 / <br> 换行、表格单元格补空格、解码命名和数字实体 （&#039; 这类带前导零的也认），图片留「[图片]」占位；样例原样不去空白 - 阶梯 prompt 版本 3 / 4 → 5 / 6，旧常量标停用保留；编译失败那一档（1 / 2）不动 用 2026-09-14 的生产备份核过：962 道题的题面无残留标签 / 实体、无裸 `<`。 另有 341 道题面带图片、模型看不到，本次未处理。 Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>	2026-09-27 14:28:21 +08:00
xuyueandClaude Opus 5.5	22fc8d63e2	feat(AI 提示): 阶梯延到 L3 思路 / L4 示例 ... - 契约 HINT_LEVELS 加两级，HINT_MAX_LEVEL 2 → 4。前端的等级标签和「再多一点提示」 按钮本来就跟着契约和 canEscalate 走，不用改 - L3 分步骤讲思路（中文伪代码），沿用 L0～L2 的零代码规则 - L4 是阶梯上唯一放开代码的一级，上限两行：过滤不再「出现代码就拦」，而是把代码块 非空行、摊平进正文的类代码行、过长的行内代码合起来数，超过 KEY_LINES_MAX 才拦； 没闭合的围栏按开到结尾算。重生成措辞和兜底话术按级补齐 - prompt 版本沿用 3 / 4：LEVEL_COMMON 拆成三句再拼回，L0～L2 的 system 逐字未变 （已对照改前逐字核过），新两级靠 ai_hint.level 区分。不需要迁移 老师按班级 / 作业设最高等级拆到 2e，未做。 Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>	2026-09-23 09:20:24 +08:00
xuyueandClaude Opus 5	b16e11e85d	fix(题目推荐): 已 AC 过滤下推 SQL、难度按语义排序、难度标签渲染 ... 相似题目推荐（GET /problems/:displayId/similar）三个 bug： - 排除已 AC 的题发生在 limit(5) 之后，候选被筛掉几条就少几条，甚至清零让整块 不渲染。而这个接口只在刚 AC 或连挂三次时才调用，正是最容易全中的时候。 （老栈是 .exclude(...) 在切片之前，重写时引入的回归） - order by difficulty 是 text 字典序，High < Low < Mid，「由易到难」实际是最难的 先上。改成显式 case 排名，并加上共享标签数作为第一排序键、id 兜稳定序。 - 前端 ref<any[]> 盖住了类型错误：getSimilarProblems 已过 filterResult，难度是 中文，模板却在比 'Low' / 'High' 再查 DIFFICULTY 表，结果每条推荐都渲染成黄色 的「中等」。 顺带：比赛题不再发这个请求（接口只在公开题库按 displayId 找，撞号会在比赛中把 题库列给学生）；多余的 id in (子查询) 换成 join 中间表。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-09-22 09:24:46 +08:00
xuyueandClaude Opus 5	954797a9a5	feat(AI 提示): 提示分级（L0 反问 / L1 定位 / L2 概念）与输出后过滤 ... 提示不再一上来就把话说完。等级记在「学生 × 题目」上，没有单独的表 —— 它就是 ai_hint.level 的历史，当前等级 = 这道题上（最近一次 AC 之后）给过的最高一级。 阶梯（services/hint-level.ts） - 只有学生点「再多一点提示」才升级（请求带 more），不带就按当前等级再生成一次 - 升一级要先再交一次：锚点是「这一级是**什么时候**开出来的」，也就是这一级最早那条 提示的 ai_hint.create_time，必须有比这个时刻更新的提交才准 +1。锚点不能用提示所在 那条提交的时间 —— 端点谁的提交 id 都认（只校验归属），拿一条老提交去要提示，锚点 就退回到那条老提交的时间，连点两下 more 就能从 L0 爬到 L2，一次新提交都不用交 - AC 之后清零；编译失败自成一档（level = -1），既不消耗也不推进阶梯 - HINT_MIN_FAILURES 3 → 1：门槛的活由阶梯接走了，第一次失败只开放 L0，而 L0 只反问、 什么都不泄露，拦着它没有意义 - canEscalate 由后端算好在 done 事件里给，前端不自己推阶梯 输出后过滤（services/hint-filter.ts） - 「不要给代码」写在 prompt 里只是软约束，模型忍不住一次就把这一级的意义废掉了。 所以整段生成、过滤通过才推给前端，逐字显示改由前端模拟 —— 边流式边过滤做不到， 发现违规时内容已经在学生屏幕上了 - 判定只用客观、低误报的信号：代码块、过长的行内代码、整行不含中文的类代码行、 和标准答案重合 3 行以上、L0 一句问句都没有 - 违规就重生成一次，只重一次，再不过发写死的兜底话术。重试措辞按档分叉：编译档本来 就允许给片段，对它说「不要出现任何代码」等于用阶梯的标准把这一档也砍了 - 两次都留痕（filter_attempt / filter_blocked / filter_reason），7.5 的输出过滤触发率 就是从这三列出来的 services/ai.ts 加 streamWhole：事件形状和 streamChat 一样，前端不分叉。produce 期间 每 15 秒发一行 SSE 注释当心跳 —— 这条流中间有一大段静默（诊断 20s + 生成 60s + 重生成 60s，最坏 140 秒），而 NPM / nginx 的 proxy_read_timeout 默认 60 秒，超了学生 看到「请求失败」，后端却还在烧第二次调用，那条提示照样落库、照样把等级推上去。 prompt 版本另开 3 / 4（阶梯上每一级都换了 system），编译档仍走 1 / 2 的单段式基线， 两批数据不混在一起。迁移 0021 给 ai_hint 加四列，都可空、不带默认值，已有的行留 null 表示「分级上线前」。 实跑 - 阶梯：在 dev 库上用真实行驱动 decideHintLevel。正常路径 S1→S2→S3 走出 L0→L1→L2， 同级连点 more 不升，AC 之后回 L0，编译档给 L-1 且不推进阶梯。把旧锚点规则复刻出来 跑同一组数据做对照：只拿最老那条提交反复 POST，旧规则 L0→L1→L2（零新提交）， 新规则钉死在 L0，正常路径两者行为一致 - 过滤：起假 AI 服务端走完整条链路。L1 摊平代码→重生成后合规（attempt 2 / 未拦）， L0 两次都甩代码块→兜底话术（blocked，reason 两条相连），编译档抄标程→命中「和标准 答案重合 3 行」且追加的是分叉后的措辞 - streamWhole：produce 拖 16.5 秒收到 1 条心跳；同一份流喂给前端 consumeJSONEventStream 只解析出 delta + done（注释行被静默跳过，前端零改动）；中途 cancel 断开后 produce 跑完不抛 - api / web typecheck、check:routes、fmt 全过 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-09-21 19:03:21 -06:00
xuyueandClaude Opus 5	8b4d8899f9	feat(判题机): 自建镜像升级工具链，语言收敛到 C / C++ / Python ... 上游 QingdaoU/JudgeServer 停更在 2024-04（registry 上的 latest 和 1.6.1 是同一份 镜像，编译器停在 gcc-13），没有新版可拉，所以自己重编。docker/judge/ 是只改工具链 的 Dockerfile 分叉，server/ 和 Judger/ 从上游固定 commit b28aa56 拉，一行没动。 镜像 oj2-judge-2（不在任何 registry 上：本机 build.sh --save → scp → docker load） - gcc/g++ 13 → 14.2，Python 3.12 → 3.13.5，都是 trixie 默认 - Go / JDK / Node 整套删掉：前端的题目语言复选框从来只给 C / C++ / Python / SQL， 12 万条提交里 Java 44 条、Golang 15、JavaScript 3，全是很早以前的 - 体积 1.1GB → 433MB；默认走清华源，构建 12 分钟 → 40 秒（--no-mirror 换回官方） - deploy.sh 加一道自检：镜像不在本机就中止，并打印该跑的三条命令 C 的编译参数加三个 -Wno-error（implicit-function-declaration / int-conversion / incompatible-pointer-types）：gcc-14 把它们从 warning 提成了 error，而 -w 压不住。 语言值统一成 Python（迁移 0019 / 0020） - 0019：Python3（104527 条提交）与 Python2（3 条）并成 Python，一并改掉 937 道题的 languages、75 个 template 键、15 个 ast_rules 键、257 条 answers、1235 个用户的 成就指标 _languages（languages_used 重算，总和 1928 → 1925，少的 3 个是同时用过 两种 Python 的人） - 0020：把 Java / JavaScript / Golang 从 84 道题的可选语言里摘掉 —— 不摘的话那些题 的语言下拉还能选 Java，提交必 SYSTEM_ERROR - 契约新增 normalizeLanguage() 别名表，判题侧一律走 judgeConfigFor()：旧客户端 localStorage 里的 Python3、迁移前排进队列的任务都还能判；协作的语言归一也走它， 否则上线那一刻学生页面里的 Python3 会静默落到 C - 回滚要连数据一起回，只滚代码会让所有 Python 提交变 SYSTEM_ERROR 实跑 - 判题冒烟 docker/judge/smoke.ts 13 条全过：三种语言、六种状态码、gcc 宽松度 - 拿备份里的真实代码逐文件比对新旧镜像的编译结果，0 差异：C 提交 1951 份 （1725 过 / 226 CE）、C++ 882 份、Python 2000 份、20 篇 C 教程的 93 个代码块。 不加那三个 -Wno-error 的话，C 有 26 份会从能过变成 CE - 迁移在灌了 12.4 万行真实数据的一次性库里跑过：0 残留、没有题目被清空； dev 库用真正的执行器跑通 - check:ast 56 个 target 全过，前后端 typecheck 均 0 顺带记下一个升级之前就有的坑（现在随 Go 一起消失，写在 README 里）：GOCACHE 指向 容器的 tmpfs，判题机重启后第一次 Go 提交是冷构建，Go 1.22 要 5.6 秒 CPU、超过 3 秒 的编译预算，于是重启后第一个交 Go 的学生必吃一次 CE，后面的人缓存热了又都正常。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-20 06:24:05 -06:00
xuyue	a872e8365b	fix	2026-09-19 07:10:49 -06:00
xuyueandClaude Opus 5	b4c0f89291	fix(个人主页): 总共学习天数改为有提交的天数 ... 原来是首末提交之间跨了多久，现在按东八区日期对提交去重计数，比赛提交也算。 首末提交时间仍只看比赛外的提交，口径不变。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-19 07:07:57 -06:00
xuyueandClaude Opus 5	06ad6745b7	feat(AI 提示): 两段式提示——先诊断出错误标签，再生成提示 ... AI 时代 OJ 设计的 2b。标准答案能让提示准得多，但不能进生成提示的 prompt （学生代码里一段注释就能把它套走），所以拆成两段： - 诊断：看得到标准答案、第一个没过的测试点、带行号的学生代码；出参只允许 { tag, lines, confidence }，safeParse 过闸、多余字段剥掉，没有自由文本通道 - 生成提示：看不到标准答案和测试点原文，只多一句「问题定位：X，大约在第 a 行」 - 诊断失败（20 秒超时、不是 JSON、校验不过）退回单段式；同一条提交复用诊断； 编译失败不诊断 - 契约新增 HINT_ERROR_TAGS（13 个，落库值，只增不改）与 hintDiagnosisSchema - 迁移 0018：ai_hint 加 diagnosis / diagnosis_error 两列 - 单段式 prompt 原样搬进 services/hint-diagnosis.ts，记版本 1；两段式记版本 2 - completeChat 支持 JSON 模式和自定义超时，现有调用不受影响 - 开关 AI_HINT_DIAGNOSE 默认关（2a 的基线还在攒），两套生产 compose 透传 实跑（一次性库 + 本地假 LLM）：开关关时请求与 2a 逐字节相同；开时正常 / 复用 / 坏 JSON / 非法标签 / 行号越界 / 超时 / 编译失败七种场景符合预期； 12 次模型请求里诊断全都带标准答案和测试点，生成全都不带。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-19 06:56:38 -06:00
xuyueandClaude Opus 5	47d8f46bdb	feat(AI 提示): 提示落库并收集学生评价，落进 ai_hint ... AI 时代 OJ 设计的 2a：先把现有提示记下来，为后面的分级和两段式诊断攒对照数据。 提示本身的行为不变，发给模型的 prompt 一字未改。 - 迁移 0017 建 ai_hint：模型、prompt 版本、内容、错误、耗时、学生评价； 成功和失败都记（失败率是 AI 悄悄变差时最先动的数）。挂在 submission 上 CASCADE - streamChat 第三个参数改成 { onComplete, onError }：onComplete 的返回值并进 done 事件，提示 id 由此带回前端；班级学情分析那处调用同步改写，行为不变 - 落库失败只记日志，不影响学生拿到提示 - 新增 POST /ai/hint/:id/feedback：只能评自己的提示（别人的一律 404），可以改票 - 前端提示生成完出「有帮助 / 没帮助」，选中的高亮；后端没存上时不出按钮 - 实跑：本地假 LLM 验证成功 / provider 断开 / 缺 AI_KEY 三条路径的落库， 评价接口六种请求，浏览器里按钮出现、改票、重复点不发请求 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-19 06:00:10 -06:00
xuyueandClaude Opus 5	a0ef204bd2	feat(提交): 采集编辑过程信号，落进 submission_trace ... AI 时代 OJ 设计的第 1 步：给「可信 AC」和学情分析攒数据，本身不判任何事。 - 契约：提交请求加可选的 trace（活跃时长、键入/粘贴/删除字符数、切后台次数等， 只有计数、不含按键内容）；写成 .optional().catch(undefined)，坏了就当没带， 不让附带数据把提交挡成 400 - 迁移 0016 建 submission_trace，与 submission 一对一、CASCADE；since_prev_ms 由服务端在同一条 INSERT 里算（排掉自身），bigint —— 实测已有 44 天的间隔，int4 装不下 - 后端写 trace 失败只记日志，不影响提交 - 前端 oj/problem/utils/editTrace.ts 是模块单例（扩展对象不能过 Pinia 的响应式代理）， 只数带 userEvent 的事务：格式化回写 / 载入草稿 / 协作对方的改动天然排除； closeBrackets 越过右括号时是原样替换，按 no-op 跳过。比赛编辑器同样挂上 - 实跑：后端四种请求、前端浏览器里键入/粘贴/删除/setCode 回写/切后台/提交后清零， 计数与预期逐项一致 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-19 05:46:55 -06:00
xuyueandClaude Sonnet 5	20a6ddc79c	feat(自学): 重做学生端页面与教师端学情概览 ... 学生端：目录 + 居中限宽正文 + 可收起的示例代码栏；目录改成三态圆点， 顶部加总进度；上一课/下一课栏桌面端固定在底部。 教师端：汇总卡片、学生状态标签与筛选（未开始/7 天没学/只读不练等）、 最后学习补「N 天前」、按练习表加「没人一次对/多数人卡住」提示。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>	2026-09-19 05:07:37 -06:00
xuyueandClaude Sonnet 5	c228b164cf	refactor(提交): 教师统计路由拆出 submission-statistics.ts，check:routes 支持嵌套挂载 ... - submission.ts 1416 行降到 751 行；统计三条路由拆成子路由，挂在原位置， 仍排在 /submissions/:id 之前 - check-route-shadowing 原来只认 index.ts 直接挂载，拆分后漏检 3 条（178→175）； 现在按挂载位置展开嵌套的 .route()，恢复 178 条、无遮蔽 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>	2026-09-19 04:40:30 -06: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	f90d01338e	feat(自学情况): 按学生加姓名/学号搜索，后端补稳定排序 ... 搜索是纯前端过滤（整表本来就一次拉完），和班级筛选可以叠加。 学生查询原来没有 orderBy，前端默认按「已读」升序排之后，同分的一大批 （尤其一堆 0）落回聚合的任意顺序，刷新一次换一个样；按班级、学号兜底。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-17 02:23:01 -06:00
xuyue	3cc2be77a9	fix	2026-09-17 02:12:04 -06:00
xuyue	905ba2ee03	fix	2026-09-17 02:07:52 -06:00
xuyueandClaude Opus 5	a8de8f3932	feat(排名): 本周进步榜移到全服 Top100 右边，左 2/3 右 1/3 ... 两张榜分开上下放的时候，谁也看不见谁：上面那张是历史全部 AC 的总榜，名次几乎不动； 下面那张的分母只有这一周。并排摆在同一屏里，「总榜追不上」和「这周还能进前十」 才是一眼对照出来的。桌面 cols=3、Top100 占 2 栏，移动端退回 cols=1 上下堆叠。 周榜宽度从整屏缩到 1/3，列跟着收：列头去掉「本周」前缀（卡片标题已经写着）， 宽度压到 70/120min/100/90，用户名加 ellipsis tooltip —— 1280 那一档也不出横向滚动条。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-17 02:03:04 -06:00
xuyueandClaude Opus 5	24af385f33	feat(排名): 加本周进步榜，按本周首次 AC 数排，每周一清零 ... 存量榜（/rankings/users、班级榜）排的都是 user_profile 的 AC 总数，名次几乎不动， 中位学生看一眼就知道追不上 —— 榜单在那批人身上是负反馈。这张榜的分母换成「这一周」， 每周一 0:00（东八区）清零，谁都可能进前十。 口径是**本周首次 AC 的题目数**，不是「本周 AC 过的去重题数」：后者把上周就做出来的题 重交一遍也算成绩，一分钟能刷满一屏。靠 NOT EXISTS 排掉本周之前已通过的 (user, problem) 对，四个条件正好是 submission_public_metrics_idx 的全部列。 - time.ts 加 weekStart()：localWeekday 的 0 是周日，要先折成 7，否则周日单独成一周 - GET /rankings/weekly?scope=global|class，入榜人群与全服榜一致（教师/超管不参与） - 前端默认落在本班 —— 全服周榜上中位学生仍然看不到自己，班内 30 人那张才有答案 - 本周一题没做出来时 me 是 null，footer 那句「做出 1 题就能上榜」照样出现： 它是说给还没上榜的人听的，而那正是最需要被推一把的一批 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-17 01:53:37 -06:00
xuyueandClaude Opus 5	ad858ed864	feat(提交列表): 代码详情弹框支持方向键翻阅，到头自动翻页 ... 老师看一个班的提交原来得「点开 → 看 → 关掉 → 点下一行」，现在弹框开着就能 用 ↑↓（←→ 等价）切上一条/下一条，Esc 关闭。 - 只在 showLink 为真的行之间走，跳到看不了的行只会得到空弹框 - 走到本页头尾自动翻页续上：向下落到下一页第一条，向上落到上一页最后一条。 翻页是异步的，先记 pendingJump，等 listSubmissions() 回来再开； 整页都看不了代码时保持原来那条不动，给一句提示 - 弹框没开不接管方向键，焦点在输入框里也不抢 - SubmissionDetail 加 :key="submissionID" —— 它只在 onMounted 拉一次代码， 不换 key 切过去还是上一条的代码 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-16 19:26:51 -06: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	ed56a209ea	chore(格式): Prettier 统一到全仓，后端和契约一次性格式化 ... 原来只有 `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	e600fd24cf	feat(提交列表): 今日提交数旁加「统计」按钮，弹框给今天的提交统计 ... 筛到今天之后标签旁边出现「统计」，弹框里是全站今天的提交概况：总提交 / 正确 / 判题中 / 正确率 / 参与人数，外加按钟点的 24 格分布、按语言、按判题结果，以及 今天最热的 10 道题。 新接口 GET /submissions/today-statistics，公开、只出聚合数，口径和那颗标签一致 （东八区今天 + 非比赛提交）： - 钟点分桶走 time.ts 的 localTime()。`extract(hour from create_time)` 按会话时区 算，容器是 UTC，整张分布图会左移 8 小时； - 正确率的分母摘掉未判完的条数，正确数含 AST_CHECK_FAILED； - 热门题只算 visible 的题目 —— 这个接口不需要登录，不能拿它探未发布题目的标题； 「提交列表对学生全开」关掉时这张表整个不下发，跟提交列表同一个开关（数字照给， 否则标签说 21、弹框说 0）。 前端组件异步加载，不进本路由的关键路径；小时分布是纯 CSS 柱状图，没有引 chart.js。 柱子和基线取 useThemeVars()，深浅色都跟着走，「现在」那一格是基线上一段主色刻度。 流程图那档不给这颗按钮 —— 流程图提交在另一张表、只有 AI 评级没有判题状态。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-16 08:23:45 -06:00
xuyueandClaude Opus 5	5eee13fe81	chore: 删掉两个跑完的一次性订正脚本，recount 留着 ... fix-achievement-hours 订正的是时区丢失那两周误发的「夜猫子」「早起的鸟儿」， 2026-09-14 已跑完（修正 148 行 · 撤回 60 条），根因修在代码里之后不会再产生； backfill-problemsets 补的三笔题单历史欠账也已结清，进度记账现在在判题这一路。 两个子命令、两条 npm 脚本一并去掉，services/problemset.ts 的 badgeHolderDiff 只服务于补发脚本，删完 0 处引用，一起清掉。 recount 留着 —— 反范式计数列会被重判、删提交带偏，是会复发的漂移， 补一条 npm 脚本（原来只有子命令）。 docs/timezone.md 里那节改成「账已平、脚本已删」，但保住那条教训： unlockAchievements 是纯阈值比较，只删 user_achievement 不修 metrics 的话， 学生下次提交就把同一个成就原样再发一次。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-16 08:03:57 -06:00
xuyueandClaude Opus 5	6fdc3c588e	chore(开发环境): 本机库改成靠迁移自举，db:migrate 换成线上同一个执行器 ... compose.dev.yml 不再把 schema dump 挂成 initdb：0000 就是完整的建表迁移， 起完库 bun run db:migrate 从 0000 自举即可。实测两条路子跑出来的结构一致 —— 空库自举 16 条迁移 vs 灌 dump + 打基线 + 跑迁移，pg_dump --schema-only 逐行零差异（1981 行）。docs/specs/schema.sql 与 sample-data.sql 随之删掉， 前者的内容已经在 0000_crazy_gateway.sql 里。 db:migrate 原来是 drizzle-kit migrate，和线上 oj2-api migrate 不是同一个 执行器：drizzle 那个所有迁移共用一个事务、跑不了 CREATE INDEX CONCURRENTLY， 对已打基线的库还会从 0000 撞表回滚且 exit 1 不打印任何错误。现在两边都走 db/migrate.ts。DATABASE_URL 从根目录 .env 读（--env-file），仓库里不留连接串。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-16 08:03:57 -06:00
xuyueandClaude Opus 5	a8408c0bb5	docs: 文档整理，CLAUDE.md 瘦身一半，删掉重写期已完成的 22 份阶段产物 ... CLAUDE.md 从 490 行降到 228 行：只留日常要当场记住的约束，展开拆成五份专题 文档 —— docs/deploy.md（部署与备份恢复）、database.md（迁移执行器、基线、 drizzle-kit 的坑）、timezone.md（时区口径与那次成就订正）、contract.md （出参不 parse 的四次故障）、ast-rules.md（AST 规则与 C++ 的调用形态）。 删掉的是阶段 0–5 那批一次性产物：4 份实施计划、10 份评审/核验/修复报告、 endpoint-inventory.md（110 端点是 2026-08 的快照，现在 363 条路由）、 docs/spikes/ 的 spike 与提取脚本（结论早已落进代码）。phase5 切换手册删之前 先把仍然有效的部分提炼进 docs/deploy.md：拓扑、deploy.sh、部署后验证清单、 NPM 那两个不能关的开关、pg_dumpall 恢复的两个坑、镜像体积；演练报告与回滚 两节随旧栈下线一并作废。 两份设计文档保留，补上状态行说明它们是「当初为什么这么定」而不是现状。 apps/web/CLAUDE.md 顺手订正过期内容：PUBLIC_OJ_URL / PUBLIC_WS_URL 两个变量 早已不存在（baseURL 写死 /api，dev 走 vite proxy、线上由 Caddy 同源伺服）， store 与 composable 清单补齐到与目录一致。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-16 08:03:26 -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	688005c081	perf(流程图): 列表裁掉整行 select、count 去掉 join，统计面板的数值全下推 SQL ... 流程图提交量涨上去之后，先扛不住的是教师统计面板：它一条不带 limit 的 select 把整个时间窗的行拉进内存再用 JS 算，词云那个 3000 条上限是在 JS 里截的，行早就 全回来了。列表那边则是 `select({ flowchart: 整行, problem: 整行 })`，把 mermaid_code、flowchart_data、三个 AI 文本列和整张题目表一起拉回来，响应一个 都用不到（快照实测流程图行均 4.9KB、题目行均 2.2KB，10 行一页白拉 ~70KB， limit=250 时 1.7MB）。 - 列表改成白名单列 flowchartListColumns，对齐 submission 那边的 submissionListColumns（那边同样刻意不取 code / info）。 - 题号 / 用户名筛选先解析成 flowchart_submission 自己的列，count 因此一个 join 都不用挂，回得到最小索引上的 index-only scan；筛条件落在驱动表上，规划器也走 得上 flowchart_user_time_idx / flowchart_problem_time_idx。 - 统计面板拆成五条各自和行数脱钩的查询：数值聚合、等级分布、各项平均分 （jsonb_each + group by）、词云原料（order by ... limit 3000）、谁没做。 每项满分改从词云那批行里顺手取，省掉一次 21 万行的排序。 - matchedUsers() 从 submission.ts 挪进 helpers.ts，两条统计共用。 拿生产快照（2134 条）复制一份、另插三行脏数据（标量 jsonb、数组 jsonb、分数和 满分写成字符串），新旧两版各跑 24 个请求组合：23 个逐字节一致；剩下 1 个只是三行 create_time 完全相同的记录先后不同 —— 既有的不确定性（ORDER BY create_time 不是 全序），留给后面的 keyset 分页一并解决。 把表灌到 5.3 万 / 21.3 万行实测（HTTP 端到端，5 次取最好，旧 → 新）： 列表 limit=10 35 → 4 ms | 56 → 8 ms 列表 limit=250 36 → 5 ms | 54 → 8 ms 列表 offset=5万 108 → 39 ms | 57 → 45 ms 列表 按班级 33 → 4 ms | 53 → 8 ms 统计 全部时段 288 → 187 ms | 1169 → 704 ms 统计 一个班 143 → 43 ms | 388 → 129 ms 统计 一道题 94 → 194 ms | 339 → 277 ms 「统计 一道题」在 5 万行量级是退步的：那个筛选命中全表 23% 的行，PG 侧的 jsonb 算子比「原样输出让 Bun 去 parse」更费 CPU，要到 21 万行才反超。它跟的是筛出来的 行数、不跟总量走，200ms 的教师面板可以接受，没有再调。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-15 22:19:21 -06:00
xuyueandClaude Opus 5	ed3b2cf6de	feat(课堂求助): 教师协作弹框左侧直接显示题面 ... 原来弹框里只有编辑器，要看题得点「打开题面」另开标签页来回切。 现在左右分栏（可拖动）：左侧只读题面（描述、输入输出、例子、提示， SQL 题显示数据表与期望结果），右侧协作编辑器。 不复用 ProblemContent：它读写全局 problemStore，老师接单时正开着 的题目页会被换掉题面，测试按钮跑的也是老师自己的代码。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-15 08:48:40 -06:00
xuyue	4189c59162	update	2026-09-14 08:39:58 -06:00
xuyueandClaude Opus 5	cc51e305cf	refactor(时区): 常量收进契约、SQL 统一走 localTime，去掉会话时区与 TZ 兜底 ... - TIME_ZONE / TIME_ZONE_OFFSET_MINUTES 移到 packages/contract/src/time.ts， 前后端共用一份，不再各写一遍靠注释对齐。 - apps/api/src/time.ts 新增 localTime(列)，替换散落 7 处的 `at time zone ${TIME_ZONE_SQL}`；ac-trend 的 where 复用同一个 year 表达式。 - /problems/:displayId/yearly-ac 漏写了时区、按 UTC 切年，被会话时区兜底掩盖； 改为按东八区切（只影响每年 12-31 北京 0–8 点的提交归年）。 - 删掉数据库连接的 TimeZone 和 Dockerfile 的 TZ：正确代码不依赖它们， 它们只会在线上掩盖漏写处、让 dev 与线上答案不同。 - time.ts：calendarDayYearsAgo/pad 并入 shiftMonthsByCalendar，startOfCalendarDay 并入 todayStart，localWeekday 改用 getUTCDay，删掉历史叙述注释。 - 前端 zonedParts 改为固定偏移 + getUTC*（与后端、日期选择器同一写法）， 去掉 Intl formatToParts；10 万次 299ms → 11ms。zonedYear 去掉按浏览器时区的兜底。 - 两份 CLAUDE.md 同步；n-date-picker 那条过时说明改成现用法。 验证：新旧「近两年起点」21359 个时刻 0 差异、localWeekday 0 差异、 前端固定偏移与 Intl 在 America/New_York 下 47821 个时刻 0 差异； localTime 在 select/group by/where 复用可用；fix-achievement-hours 预演仍为 148 / 60。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01K1d8B3f4SXJwDvUY625eQd	2026-09-14 06:06:52 -06:00
xuyueandClaude Opus 5	3921c496cb	fix(成就): 后台补发成就后重算已解锁数并接着判「奖杯收藏家」；recount 订正存量 ... rescanAchievement 只插 user_achievement、加 unlock_count，不重算 achievement_unlocked_count，也不做元成就的第二轮判定（旧 rescan_achievement 原样如此）。判题结算只在「这次有新解锁」时才重算，所以被补发的人计数会一直停在 旧值。2026-09-07 一次补发之后 269 人少算，其中 10 人实际够 15 个却没拿到 「奖杯收藏家」。 - 新增 refreshUnlockedCount：一条 SQL 按 user_achievement 重算，只 jsonb_set 这一个键、只写值变了的行。rescanAchievement 补发非白金成就后调用它，再补发元成就。 - recount 同时核对已解锁数与元成就漏发，--apply 先改计数再补发，复核同一份口径。 用 09-14 生产备份实跑：recount 订正 269 人、补发 10 条，复核通过、重跑无差异， 其余指标 0 行被动；模拟调低阈值补发 1504 条，「奖杯收藏家」随之 65 → 95， 与预先算出的跨线人数一致。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01K1d8B3f4SXJwDvUY625eQd	2026-09-14 05:55:38 -06:00
xuyueandClaude Opus 5	f6995c841b	ops(成就): 加 fix-achievement-hours，订正时区丢失期间误发的「夜猫子」「早起的鸟儿」 ... OJ2 上线到时区修复之间，成就的小时键按 UTC 判定：UTC 的 0–5 点 / 5–7 点是北京 的上午 9–13 点 / 下午 1–3 点，上课时间的提交被记成熬夜和早起。Django 时代的存量 本来就是东八区口径（已用生产备份做判别性核对），出问题的只有这两周的增量。 脚本按东八区重算两个小时指标（只合并这两个键，不整体覆盖 metrics）→ 撤回不达标 的 → 补发达标却没发的 → 同步 unlock_count → 校正已解锁数与「奖杯收藏家」连锁。 默认只读预演，--apply 落库后自动复核，幂等。 用 db_backup_2026_09_14_18_17_37.sql 实跑：修正 148 行、撤回 60 条（47 + 13， 50 人）、补发 0、连锁 0，其余指标 0 行被动。必须先部署时区修复再跑。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01K1d8B3f4SXJwDvUY625eQd	2026-09-14 05:55:27 -06:00
xuyueandClaude Opus 5	4c0c38445c	fix(时区): 日历口径收回东八区，读出的时刻统一成 ISO 并保留微秒 ... 旧栈 Django 按 Asia/Shanghai 算日历，OJ2 重写时这个锚点丢了：容器和数据库会话 都是 UTC，于是「今日提交」在北京时间 0–8 点是空的，「凌晨/早起提交次数」整体偏 8 小时，热力图、AC 趋势年份、近两年活跃人数也各按进程时区切。 - 新增 apps/api/src/time.ts 作为唯一锚点（固定 +8 偏移，不依赖进程 TZ / tzdata）， todayStart、成就小时/日期键、热力图、月份平移、年份夹逼全部改走它； SQL 里按日历切的一律显式 at time zone。 - db/index.ts：连接会话时区设为东八区（兜底）；给 timestamptz(1184) 挂 parser， 读出统一成 ISO 8601 UTC，撤掉为拿 PG 文本形状写的 ::text。parser 保留微秒 —— 生产库 12.3 万条提交几乎全带微秒，截成毫秒会让翻页分界行和班级 AC 排名的 <= min(create_time) 把自己排除（翻页每页丢一条、排名少 1）。 - 前端 parseTime/zonedParts/zonedYear 按 Asia/Shanghai 渲染，n-date-picker 做 toPickerValue/fromPickerValue 平移，站内不再按浏览器时区取时间部件。 - Dockerfile 设 TZ=Asia/Shanghai 作为第二道兜底。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01K1d8B3f4SXJwDvUY625eQd	2026-09-14 05:55:17 -06:00
xuyueandClaude Opus 5	6e63866cc9	perf(提交列表): 按用户名、题号筛选走索引，不再扫全表 ... 用户名筛选：user_id 先查成字面列表，不再把子查询夹在 OR 里（那样整条 OR 不可索引）， 加 trigram 索引接住 ilike '%x%'；翻页先圈出匹配行再排序取页，避开规划器顺着时间索引 倒扫、边扫边滤的计划。快照上查一个班 70~107ms → 5~14ms；匹配 9.5 万条的年级前缀 从 34ms 变成 70~90ms，实际不这么查。 题号筛选：先解析成 problem.id，加 (problem_id, create_time, id) 部分索引。老题和 不存在的题号不再倒扫大半张表（34~67ms → 4ms），题号筛选也能走游标深翻页， count 不再 join problem。 迁移 0015 装 pg_trgm（官方镜像自带 contrib，trusted 扩展）。39 个筛选组合的响应 与改动前逐字节一致。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Xg91q3JsunDE7EYoi9G3i2	2026-09-13 23:47:24 -06:00
xuyue	fe4fc46243	fix	2026-09-13 23:40:58 -06:00
xuyue	271123179a	fix	2026-09-13 19:29:45 -06:00
xuyueandClaude Opus 5	9132901cc7	feat(提交结果): 没通过时显示「通过 x/y 个测试点」；编译失败不等三次就能用 AI 分析 ... 学生拿不到 info（每个点带 output_md5，只给管理员），测试点表格从来只有管理员看得见， 学生这边只有一句「答案错误」—— 从 2/8 交到 6/8 的人，感受是连输五次。 - 提交详情新增 caseSummary，后端从 info 数出通过数下发，不放开原文。 比赛提交、SQL 题（被杀的测试点会 break，total 偏小）、无逐点结果时为 null - 结果面板标题缀上通过数并加进度条，提交详情页标题同步；一个都没过时不缀 - POST /ai/hint 对编译失败跳过失败次数门槛，throttleAi 照旧；前端显示条件同口径 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013TecwAowmYcoNZRheSyTgH	2026-09-13 07:25:00 -06:00
xuyue	a833819679	fix(统计面板): 班级选择不再记本地，别让上一个人的班悄悄留在框里 ... 提交统计弹框里的「班级或用户」原来点过「统计」就永久写进 localStorage （statisticsClass），下次打开自动带上。机房一台电脑对一个班，下课换班或者 换个人坐这台机器时，上一个人查的班还留在选择框里，老师没注意就按了「统计」， 看到的整个是别人的班。 改成不存也不读，每次打开都从空的开始 —— 宁可多选一次。登录框的 LOGIN_CLASS 不动，那记的是这台机器的身份，不是一次临时查询。 STORAGE_KEY.STATISTICS_CLASS 随之没有调用方，一并删掉。	2026-09-10 20:57:34 -06:00
xuyueandClaude Opus 5	2b07040aee	refactor(时段): 两份手抄的选项列表与五份 "weeks:1" 解析收成一处 ... 时段选项的 value 是 `<date-fns 单位>:<数量>`，把它解成 Duration 的那段 `split(":")` 在**五个组件里各写了一遍**（提交统计、流程图统计、AI 分析页、榜单页、班级对比页）， 每份的兜底还都不一样；选项列表也抄了好几份： - 两个统计面板逐字相同地拼「10/20/30 分钟 + DURATION_OPTIONS + 全部时段」； - rank/list.vue 和 class/pk.vue 各手写了同样的五条长时段，pk.vue 里还留着一句 「与 rank/list.vue 保持一致」的注释 —— 靠注释同步的东西迟早不同步。 现在：`PANEL_DURATION_OPTIONS`（面板用，含分钟级和 all）、`LONG_DURATION_OPTIONS` （榜单/班级对比用，从 DURATION_OPTIONS 派生）、`durationFromValue()`（唯一解析）。 各站点自己的兜底保留在原处，那部分本来就该各不相同。 ## 行为零变化，逐条比对过 把改动前各处手写的列表原样取出来和新的比：面板 12 条、榜单 5 条、班级对比 6 条， 标签与取值逐条一致；11 个时段值的解析结果与旧的内联写法逐个相同。 唯一的差异在 `all`：旧写法产出 `{all: NaN}`，新写法回 null。**两边都到不了** —— 三处用到 subOptions 的地方全在 `query.duration === "all" ? … : …` 的 else 分支里， 三元短路，all 时根本不求值。逐处确认过。 ## 实跑 - 榜单页：下拉 5 条顺序正确；切一周内，请求从 start=2026-08-10（months:1） 变成 start=2026-09-03（weeks:1），正好差 7 天； - 班级对比页：下拉 6 条含「全部时间」；两个班 PK，全部时间和一个月内都正常出结果； - 提交统计面板：默认 minutes:10，统计请求的 start 正好比 end 早 10 分钟。 另：ChartJS.register 那 15 处**没有动**。逐个列出来看，它们注册的是各自需要的那一套， 不是同一份重复（真正逐字相同的只有 4 个 Bar 图和 2 个 Line 图），而且组件各自声明依赖 正是 chart.js 该用的方式 —— 没用到的控制器不会进包，忘了注册会当场抛 `"bar" is not a registered controller`，是响的不是静默的。集中注册只会把懒加载的图表 代码推进首屏，为省 6 处重复不值得。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012j1vgeDqay8wKCh8dPgPcH	2026-09-10 20:28:33 -06:00
xuyueandClaude Opus 5	8eae4bea7b	feat(统计面板): 展开一个学生后按题目分组，每道题画一条「状态轨迹」 ... 老师展开一个学生，原来看到的是一排 12 位十六进制的提交编号按钮。编号本身没有信息量， 而一节课里学生常在好几道题之间来回跳，那一排看不出他到底卡在哪一道。 现在一道题一行：题号、标题、交了几次、过没过，后面跟一排按时间**从早到晚**的小方块， 颜色就是判题状态（绿=通过 红=答错 黄=编译失败/超时 灰=判题中）。 「八绿一红一绿」和「五黄到底」一眼分得开。 - **排序按老师的用法来**：没过的排前面，其中交得越多越靠前 —— 卡得最久的那道顶到眼前； 已通过的沉底，它们只是「做完了」。 - 鼠标悬停出「状态 · 时间 · 提交号」，点击照旧打开提交详情。 - 「语法未过」(ast_check_failed) 算做出来了，和表格上「已解决」那一列口径一致。 - 方块用内联样式而不是 class：它们是 h() 出来、挂在 NDataTable 展开槽里渲染的， <style scoped> 能不能盖到并不确定。色值沿用 Naive 的语义色，和 ExerciseMatch.vue 一致。 为此 GET /submissions/statistics/items 多带三个字段（problem / problemTitle / createTime）—— 原来只有 id 和 result，分组和悬停都无从谈起。innerJoin problem 不会漏行： submission.problem_id 是 NOT NULL 且外键 NO ACTION，题目删不掉。 ## 验证 起全栈在浏览器里真点过（提交列表 → 数据统计 → 提交记录 → 展开 student）： - 五道题各成一行，顺序是 1005(5次未过) → 1006(4次) → 1020(1次) → 1018(1次) → 1004(10次已通过)，符合「没过的在前、交得多的在前、已过的沉底」； - 现造一条「先错后对」：轨迹读出来是 绿绿绿绿绿绿绿绿红绿，新交的 WA→AC 落在末尾， 确认是从早到晚而不是倒序； - 悬停取到「编译失败 · 09-02 22:03:14 · 9f02da4c5f01」。 tsc、check:routes、vue-tsc、vite build、单二进制编译均通过。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012j1vgeDqay8wKCh8dPgPcH	2026-09-10 20:09:09 -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	eda1eb7eee	chore(题单): 删掉客户端自报进度的 PUT /problem-set-progress ... 这个端点是「AC 之后前端回调一下，把进度写进题单」那套设计的残留，早就被服务端记账 取代了 —— SubmitCode.vue 里留着当时的说明：客户端那条路只认路由参数里的那一个题单 （从普通题库入口做出同一道题不计进度），网络一抖、页面提前关掉进度就静默丢失； 现在判完之后由 judge/run.ts → services/problemset.ts 的 recordSolvedProblem 记账， 而且记进所有已加入且包含这道题的题单。 上一个提交删掉前端最后一个调用方 updateProblemSetProgress 之后，它就彻底没人打了。 留着的代价不只是死代码：那是一条**学生可以自己写进度**的写入口。 删之前逐个核过： - 前端零引用（唯一的 wrapper 已在上个提交删掉）； - recomputeProgress 还有 POST 那条在用，保留；computeProgress / eligibleForBadge / updateAchievementsForProblemSet / publishAchievementNotification 在别处都有调用方； - 它往 problemset_submission 写的那一笔，services/problemset.ts:260 做的是一模一样的 去重后插入，不会因此少写。 顺带清掉因此变成孤儿的四个 import 和契约里的 updateProblemSetProgressRequestSchema 与 UpdateProblemSetProgressRequest。 ## 验证 起服务实跑： - PUT /api/problem-set-progress 现在 404； - 保留的 POST（加入题单）仍然 201，progress 行照常由 recomputeProgress 建出来； - 服务端那条替代路径端到端跑通：新建题单 → 加入题目 1004 → 学生加入 → 交一发 AC， 判完后 problemset_progress 自动变成 completed=1/total=1/100%/得分 10， problemset_submission 也落了一行 —— 全程没有任何客户端回调。 tsc、check:routes、vue-tsc、单二进制编译均通过；测试题单已清理。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012j1vgeDqay8wKCh8dPgPcH	2026-09-10 19:42:17 -06:00
xuyueandClaude Opus 5	79bfd28b07	chore: 删掉 369 行没有任何调用方的代码 ... ## 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	91712b482d	fix(AST): f-string 规则从上线起就没生效过；加 check:ast 把这类静默错判变成机器检查 ... ## check:ast 判题机拿 target 的 node 去比 tree-sitter 节点类型，**对不上不报错**：collectNodes 一个 都收不到，于是「必须使用 X」永远失败、「不能使用 X」永远通过，两头不报错，只有学生 受着。上一个提交把两张表合成一张，杜绝了「漏配」，但「配错」照样静默 —— 所以加一个 检查，逐个 target 去问语法：这个节点类型你到底有没有。 bun run --filter '@oj2/api' check:ast 升级 tree-sitter-* 之后必须跑：语法改节点名是常事，后果全静默。它只验节点类型存在， 不验语义对不对（把 while_loop 配成 for_statement 这种两个都存在，机器看不出来）。 ## 它抓出来的那个 56 个 target 里坏了一个：Python3 的 f_string 一直配的是 format_string，而这个版本的 tree-sitter-python **根本没有这种节点** —— f-string 是一个 string，靠 string_start 为 f" 和内部的 interpolation 子节点来认。也就是说「不能使用 f-string」这条规则从上线起 就一直判成通过，「必须使用 f-string」一直判成失败。 改成 interpolation。实测：带占位符的 f-string（单双引号都有）命中，而 % 格式化、 .format()、普通字符串、字符串拼接都不误伤。代价是 f"abc" 这种没有占位符的 f-string 认不出来 —— 它确实不含 interpolation，但没占位符的 f-string 本来也没意义，比起原来 「一个都认不出来」是严格的改善。这条写在表里的注释上了。 ## 验证 给题目 1004 配「必须有 for 循环 + 不能用 f-string」两条规则实跑： - 有 for、用了 f-string → 修复前 ACCEPTED(0)，修复后 AST_CHECK_FAILED(10)， ast_results 为「必须使用 for 循环/通过」「不能使用 f-string/不通过」； - 有 for、不用 f-string → ACCEPTED(0)； - check:ast 修复前 exit 1 并指出这一条，修复后 56 个全过、exit 0。 tsc、check:routes、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:33:19 -06:00
xuyueandClaude Opus 5	a6ba5cdf07	refactor(AST): 两张 target 表合成一张，加节点类型漏配在结构上不再可能 ... 契约的 AST_NODE_TARGETS_BY_LANGUAGE 是 target → 中文名，judge/ast.ts 的 mappings 是 target → tree-sitter 节点类型，同一批键分在两个包里，靠一句「两边必须同增同减」的注释 维持。只加一边是静默错判：老师给 C 题选到只有 Python 有的 list_comprehension，判题机 拿裸名去比节点类型，C 的语法树里永远不存在它，于是「必须使用列表推导式」永远失败、 「不能使用 f-string」永远通过，两头都不报错，只有学生受着。 现在一个 target 一条 { label, node }：label 给后台下拉和题目页，node 给判题机。加 target 而漏配节点类型在结构上就不可能了。judge/ast.ts 的 mappings 整张删掉，解析统一走契约的 astTargetNodeType()（节点查 node，运算符查运算符表 —— 那张表的值本身就是要比的 token， 判题机原来抄的 and→&& 三条取值逐个相同，纯属重复）。 顺带把同一份数据的四份拷贝收成一份：C 的 14 条原来在契约和判题机里各抄了两遍 （C 一份、C++ 一份），现在 C++ 逐条引用 C_NODE_TARGETS；运算符表的 C++ 改成 { ...C_OPERATOR_TARGETS, "<<", ">>" }。C++ 那几条仍逐条列出而不是 spread，是为了保住 下拉框的显示顺序（C++ 独有的几条插在中间）。 ## 验证 行为零变化，是逐个 target 机械比对过的：把 HEAD 版的两张表原样取出来，对三种语言的 全部 target 比对「label / 运算符文案 / tree-sitter 解析结果 / 下拉框顺序」四项 —— C 37 个、C++ 47 个、Python3 43 个，全部一致，键集与顺序也一致。 实跑：给题目 1004 配两条 Python3 规则（必须有 for 循环、不能用 f-string），交一发没有 for 循环的正确答案，判成 AST_CHECK_FAILED(10)，statistic_info.ast_results 为 「必须使用 for 循环 / 不通过」「不能使用 f-string / 通过」—— label 与 node 两半都走到了。 再交一发带 for 循环的，判成 ACCEPTED(0)。 tsc、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:30:35 -06:00
xuyueandClaude Opus 5	8520192a98	refactor(前端): websocket 合并三层继承与三份重复 composable，803 → 660 行 ... ## 删掉的 - **六个从没人传过的配置项。** 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
xuyueandClaude Opus 5	ab47e71d6f	refactor(契约): 出参不再 parse，后台老题详情和站内信页不再 500 ... ## 出参改 satisfies 出参是后端自己刚拼出来的字面量，TS 编译期已经验过；再 xxxSchema.parse({...}) 一遍 拿不到任何新信息，唯一可能失败的输入是库里的历史数据，而失败的代价是 500。136 处 全部撤掉，撤的时候当场炸出两个一直存在的线上故障： - 后台打开任何一道没编辑过的题都是 500 —— problem.last_update_time 是全库唯一可空 的列（961 道题里 470 道是 NULL），而 adminProblemSchema.lastUpdateTime 写的是 z.string()； - 收到过站内信的人打开消息页全是 500 —— embeddedSubmissionSchema 从 submissionDetailSchema 继承了 problemDisplayId 却没 omit，路由只填了同义的 problem；列表为空时才碰巧不炸，所以一直没人报。 两个都是读出侧校验自己造出来的故障，不是它拦住的故障。 ## 校验责任挪回写入侧 - db/schema.ts：枚举型的列和几个形状确定的 JSONB 挂 .$type<>()（submission.result / .language、problem.difficulty / .languages / .template / .astRules / .sqlConfig / .sqlDisplay、achievement.rarity / .operator、exercise.type、reaction.type、 tutorial.type、problemset.difficulty / .status、flowchart_submission.status、 problemset_badge.condition_type、acm_contest_rank.submission_info）。只影响 TS、 不产生 SQL，断言逐列拿根目录那份生产备份核过全量数据。 - createProblemRequestSchema.languages 收窄成 problemLanguageSchema，兑现 problem.languages 列上的断言。 - 新增 routes/helpers.ts 的 asFilterValue()：query 筛选值（result / language / difficulty / status）要和收窄过的列比较时做纯类型交接，不加校验 —— 在这儿拦一道 会把「筛出空列表」变成「筛条件被忽略、返回全部」。 - 判题产物（submission.info / statistic_info / exercise.data）照旧放行，形状真相 在判题机那边；judge/sql、flowchart/run、events.ts 里对自家产物的 parse 一并撤掉。 - 仍然 parse 的只有 judge/events.ts 的 parseSubmissionEvent —— 从 Redis 收回来的 报文是真边界，失败返回 null 而不是 500。 顺带清掉两处重复的真相：stringArray 原本在 routes/helpers.ts、routes/problem.ts、 routes/submission.ts 各有一份拷贝，5 个调用点全部只作用于 problem.languages，列有类型后 三份一起删；routes/site.ts 里和契约同名同形的本地 interface Quote 也删了 —— loadSentences 读入时已经逐字段守过，那处 parse 同样是多余的。 ## 文档 CLAUDE.md 那一节从「契约收紧要挑地方」改写成「出参不 parse，用 satisfies」，写明 三处写入侧闸门（入参 safeParse 58 处、列上 $type、语义校验函数）；apps/web/CLAUDE.md 同步 —— 现在收紧字段的后果落在 tsc 编译期，但契约形状仍要对得上存量数据。 ## 验证 - 生产备份全量：12.4 万条提交的 result 全在 -2..6,10、961 道题的 languages 均为合法 数组、10050 条榜单条目形状全对，无一例外； - tsc -p apps/api 与 vue-tsc --noEmit 均 exit 0；check:routes 检查 177 条路由，无遮蔽； 前端 build、单二进制编译并在仓库目录之外启动均通过； - 实跑 40+ 端点（学生端 / 后台 / AI / 榜单 / 题目回写往返），以及一次完整比赛 e2e： 建比赛 → 复制题目 → 错解 → 正解，把 judge/run.ts 榜单写入的三个分支全走到 （error_number 0→1、is_first_ac + ac_time 671、totalTime 1871 = 671 + 1×20×60）， 后台核查页的勾选与 404 分支一并验过，测试数据已清理； - 两个 500 用抓到的真实响应对着改动前的契约复验：lastUpdateTime 收到 null、 problemDisplayId 收到 undefined，改动后同样两个响应均通过。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012j1vgeDqay8wKCh8dPgPcH	2026-09-10 18:14:05 -06:00
xuyueandClaude Opus 5	b9a80d62bc	docs(CLAUDE.md): 合并顶部叠着的更正块，订正前端验证方式，补上契约收紧的边界 ... ## 顶部 两层引用块套着一段「2026-09-10 更正」，说的是同一件事的两个版本（7 张表已删 → 其实还剩一张）。合成一段现状：旧栈不可逆下线、唯一退路是备份恢复、漏网那张 django_migrations 由 0014 补删。考古过程留在迁移文件的注释里，这里不重复。27 行 → 14 行。 ## 常用检查 `cd apps/web && bun run build` 后面那句「vite 不做类型检查，构建即验证」是错的： vite 确实不做类型检查，但**构建也不是验证**。补上 `bun run type-check`，并写明两条 会静默通过的假路子 —— `vue-tsc --noEmit -p tsconfig.json` 检查 0 个文件（那个 tsconfig 是 files: [] + references 的壳，0.2 秒跑完就是信号）、`vite build` 不看类型。 后端也改成 `bun run --filter '@oj2/api' typecheck`（脚本本来就有）。 ## 新增「契约收紧要挑地方」 前一个 commit 的教训值得留在这儿：契约 schema 后端也在读路径上 parse，收紧字段 等于给历史数据加闸，对不上要么 500（exerciseSchema）、要么静默塌成 {}（info， 9163/124192 条）。JSONB 原文的形状真相在写入侧，闸就设在那里；要收紧先拿生产备份 跑全量，重点看空值不是键集合。AST 规则的 astRulesError() 本来就是同一个道理。 ## apps/web/CLAUDE.md Commands 段还是 ojnext 时代的 npm start / npm fmt，全部换成 bun 并补上 type-check 的坑。Module Pattern 写的 `views/` 这一层实际不存在（页面组件直接放模块根下）， api.ts 也不按模块分（学生端 oj/api.ts、后台 admin/api.ts、跨端 shared/api.ts）。 工作区根目录的 CLAUDE.md / AGENTS.md 同样折叠了那段更正、订正了类型检查命令 （那两份不在 git 里）。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012j1vgeDqay8wKCh8dPgPcH	2026-09-10 04:57:34 -06:00
xuyueandClaude Opus 5	7d15e6aeaa	refactor(契约): 判题产物退回不校验，练一练的形状闸挪到写入侧，运行时闸门收回三处 ... 前四轮把契约当成运行时闸门铺开，复盘下来三块里只有一块是赚的：类型收拢成一份 （语言联合、Problem/Message/ContestRank 的重复派生）留着；另外两块退回来。 ## 判题产物：读出侧不再校验 judgeCaseResultSchema 按采样键集收紧的结果，用根目录那份生产备份全量跑了一遍： 124192 条提交里 9163 条对不上，**RE 8480/8480、TLE 338/338+26、MLE 1/1 全中**， 另有 270 条 WA、47 条 AC。原因不是键集合，是空值和 SQL 链路： - 沙箱在非正常退出的测试点上写 `output_md5: null`，契约写的是 z.string()； - SQL 判题（judge/sql/engine.ts 的 CaseResult）根本没有 `output` 键； - SQL 通过的测试点 `error_message` 是 null，契约写的是 z.string().optional()。 更糟的是失败方式：`info` 是 `union([完整形状, z.object({})])`，对不上的一律落进 第二支被剥成 `{}` 且 parse 成功 —— 管理员详情页的测试点表格**静默消失**，无日志。 JSONB 的形状真相在写入侧（判题机），读出侧再校验一遍只会在两边分叉时丢数据。 所以 `info` 回到 z.unknown()，形状改用 JudgeInfo / JudgeCaseResult 两个 TS 类型 描述（按判题机实际写的形状，不是采样出来的），取值处由 submissionCaseResults() 做唯一需要的运行时判断：有没有 data 数组。statisticInfo 换成 looseObject —— 所有键可选、不剥未知键，对任何对象都不会失败，它的作用是给类型不是当闸门。 ## 练一练：形状闸从读路径挪到写路径 exerciseSchema 的 superRefine 挂在读路径上，而这个 schema 后端也在 parse （routes/content.ts），等于一行脏数据就能让整条学生练习列表 500。同时写入侧的 exerciseDataError **一次都没查过 question**，两边严紧度不一致，脏数据进得来出不去。 exerciseDataByType 保留，改由 exerciseDataError 在写入前查，错误信息按字段翻成 中文给老师看；读路径回到不校验。 ## 运行时闸门收回三处 contract() 从 41 个端点收回到题目详情 / 提交详情 / 用户资料 —— 原本就写了 .parse() 的那三条。留着的理由是「别抛错」（原来 parse 抛 ZodError 会白屏、 后面的 as 又让校验白做），不是校验：前后端同仓、共享同一份 schema，字段漂移 tsc 已经抓了。闸门本身也瘦掉了没人读的 window.__OJ2_CONTRACT_DRIFT__ 那套簿记。 ## 验证 - 生产备份全量：124192 条提交过 submissionDetailSchema / submissionListItemSchema 零失败，其中 112144 条能拿到测试点明细（另外 12048 条本来就是 data:null）； 151 道练习读路径 151/151、写入闸 151/151（老师改旧题不会被新闸挡）； - 反向验证写入闸：缺题干的排序题被拒并给出「题干的格式不对」； - 本地实跑：种一条生产形状的 RE 提交（output_md5: null），管理员详情接口原样 返回 info.data（改之前是 {}）；库里塞一行没有 options 的 mcq，学生端练习列表 照常返回两条而不是 500； - vue-tsc / tsc -p apps/api 均 exit 0，vite build 通过，check:routes 无遮蔽。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012j1vgeDqay8wKCh8dPgPcH	2026-09-10 04:53:28 -06:00