102 Commits

Include renames

Author	SHA1	Message	Date
xuyueandClaude Opus 5.5	921990285c	feat(统计): 统计能按「一节课」列了——哪天哪个班几点到几点、来了几人、错得最多的题，选什么时间段都有 ... 原来这些只有「今日统计」里有、而且只看今天；老师那一版并进统计之后，今日统计接口只留学生版。 课按「隔 30 分钟切开、一段里有一道题 5 人以上做过」切，26计算机0班 9 月 29 日是 14:04–15:38， 不再被课后两次零星提交拖成 14:04–18:42。统计接口多给一份结果分布，数字行画结果条用。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-30 09:23:53 +08:00
xuyueandClaude Opus 5.5	13051926cf	fix(统计): 按班级列的时候零星一两个人补做的班排在最前，改成交过的人多的在前 ... 题目页「各班做得怎样」和数据统计「按班级汇总」一起改，两边顺序一致。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-30 00:59:41 +08:00
xuyueandClaude Opus 5.5	50d8e072ac	fix(题目页): 统计页签的各班表和数据统计「按班级汇总」对不上，改成同一个口径 ... 原来题目页写 13/26（做对/交过）、数据统计写 13/58（做完/班级人数），列的班也不一样， 老师点过去看到的数「变了」。现在两边都是：只算学生，做完/班级人数、交了没对、没交、 正确率、最近一次，按最近一次排。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-30 00:56:35 +08:00
xuyueandClaude Opus 5.5	db493cebe4	fix(题目页): 统计页签的老师版回到讲这道题本身，各班只列一张表，不选班、不列人名 ... 按人看谁没做对是提交页「数据统计」的活；表里点一个班就去那边看。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-30 00:50:01 +08:00
xuyueandClaude Opus 5.5	2fddf4a011	feat(提交列表): 今日统计重做——老师看今天哪几个班上了课、几点到几点、错得最多的题；学生版从简 ... - 老师：各班上课时段画在一条 7–20 点的时间轴上（点班级名去数据统计），有班正在上课时引去课堂看板 - 错得最多的题带班级、没过的原因、做对 x/y 人；底部一根全站结果条，语言只有一种时缩成一句 - 学生：你今天交了几次做对几道 + 今天大家都在做（按人数，带去做 / 接着做） - 标题栏写「截至几点」、判题中几条；打开时把按钮上的数一起更新（原来只在进页面时拉一次） Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-30 00:47:51 +08:00
xuyueandClaude Opus 5.5	99319fdcc5	feat(题目页): 「统计」页签重做——学生看难不难、几次做对、常错在哪，老师按班看谁没做对 ... - 全部按人算：原来的「通过数」是 AC 条数、「通过率」按提交算；击败用户、饼图、历年 AC 率去掉 - 错得最多的那种给一句该怎么办（都指向「运行例子」），自己交了 3 次以上还没对再多一张卡 - 老师选一个班：做对 / 交了没对（次数、最后结果）/ 没交；班里错得和全站不一样时点出来 - 题库入口工具栏的「课堂统计」并进这里（题单没有页签，按钮留着） - 新接口 /problems/:id/stats（按内部题号，比赛题不再查到同号公开题），删掉 beat-count、yearly-ac Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-30 00:39:57 +08:00
xuyueandClaude Opus 5.5	91d9c9c6d7	feat(首页): 登录后不再弹「登录速报」，上次来做了什么、哪道还没做对放进首页，带「接着做」 ... - 新接口 /me/last-visit：上次登录到这次登录之间的题库提交，不调 AI（原来要同步等模型最长 60 秒弹框才出来） - 班里今天在做时让位给班里卡，只在卡底留一句；班里那天就是上次来那天时两张卡合成一张 - 第一次登录说「欢迎来到判题狗」，隔了 30 天以上说「好久不见」 - 删掉弹框、store 和 /ai/login-summary Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-30 00:28:14 +08:00
xuyueandClaude Opus 5.5	5f9743efe0	feat(提交列表): 右栏名字旁多一个「只看这个班」，不在班级列表里的老班也能筛出来 ... Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-30 00:00:38 +08:00
xuyueandClaude Opus 5.5	923516ad36	fix(课堂看板): 这节课整班在画流程图时，点格子、点名字进到的是一片空的代码提交列表 ... 看板格子的次数原来是代码和流程图加在一起的，链接却总是去代码那边；名字链接看的「今天交过」 还把比赛提交算了进去。现在格子分开给代码 / 流程图次数、学生分开给今天交过代码 / 画过流程图， 只画了流程图的跳到提交列表的「流程图」那边。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-29 19:02:33 +08:00
xuyueandClaude Opus 5.5	52bf2d6111	feat(提交列表): 题号填错一道时顶上提示「没有这道题」；← → 也能翻上一条下一条 ... - 列表接口回带查不到的题号（公开列表只认公开题，比赛列表只认本场的题）， 一次填好几道时打错的那道原来被悄悄忽略 - 方向键恢复成四个都能翻（9 月加的时候就是这样，老师已经用惯了） Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-29 18:58:31 +08:00
xuyueandClaude Opus 5.5	26c8d65e89	fix(判题/统计): 老师重判一次题目提交数就多一；统计选 231 班会把 2311、2312 班也算进来 ... - 重判带上原来的结果，落库只做差量：提交数不变、旧结果那一格减一新结果加一， 通过数按新旧结果调整（原来重判当新提交记账，连点三次就多三）。重判时一起清掉 info， 判题中那几秒不再按旧结果显示「通过 2/3」 - 三个统计接口加 className，按 class_name 精确匹配（原来拼 ks231 做包含匹配） - 流程图统计查几道题时要每道都拿到 A/S 才算完成；「每人最好的一次」截断时有标记， 题号上限 20 道和代码统计一致；流程图列表支持按整名匹配用户 - 删掉统计弹框走后没人用的展开行明细接口，以及每次都白算的「语法未过题数」「最近一次错在哪」 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	ea480d5e0c	feat(提交列表): 老师也能重新判题；列表能按班级、一次按几道题筛，还带「通过几个测试点」 ... - 重新判题从只放超管改成老师及以上：前端一直给老师亮着按钮，点了只会「权限不足」 - /submissions、/flowcharts 加 className（user.class_name 精确匹配），题号可以一次填几道 - 列表每行带 caseSummary，口径和详情一致，在库里数完只回两个数 - 新增 GET /classroom/lesson：提交列表「这节课」按钮用，班级和题的取法同课堂看板 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-29 11:08:49 +08:00
xuyueandClaude Opus 5.5	eb32676de4	feat(题目): 「运行例子」「自己输入」改用和提交同一台判题机——例子上跑出什么样，提交在这几个例子上就是什么样 ... 原来试运行走另一台 Judge0：C 是 GCC 9、编译参数也不一样，Python 的语法错误回来的是运行错误， 没有题目的时间内存限制和代码模板，例子上的结果常和提交对不上。现在走本站判题机 （POST /trial-runs），同一套编译命令、这道题的限制和模板，对不对也由判题机比。 - 不落库、不算提交、不进判题队列：api 进程里自己排队，全站同时 TRIAL_CONCURRENCY 批 （服务器 2、机房 4），每人最多两批，排满或等超过 30 秒就请学生过一会儿再点 - 死循环不停打印时判题机回包会很大，超过 16MB 就掐断，告诉学生输出太多、停不下来 - Python 语法错误用和提交一样的说明：第几行、中文标点标红、一键换成英文 - 运行时错误和提交用同一个解析，说清楚第几行、为什么（下标越界、int() 转换失败、段错误……）； 比赛里照旧只给按结果码的那一句 - 语法没过、服务没跑成时，标题不再说「N 个例子没对上」 - 后台「生成测试点」一并迁过来，编译警告不会再写进 .out；Judge0 的地址和调用全部删掉 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-29 08:09:44 +08:00
xuyueandClaude Opus 5.5	83b6b7a81a	fix(题目): 修掉代码审查查出的几处问题——流程图拿到的徽章不弹、点评弹窗读失败时关不掉等 ... - 流程图画到 A / S 拿到的题单徽章、成就原来不弹：流程图那条 WebSocket 只认评分完成 / 失败， 成就消息被丢掉了，要等下次换路由拉 pending 才出来 - 强制点评弹窗读不出点评、或者一直交不上时，「下一题 / 继续」按钮也给出来：原来弹窗关不掉， 只能按浏览器后退；拦下换题时就记上「继续」，按钮文字不会写错 - 「放回编辑器」走正常的换语言路子（画流程图时切回代码编辑器、读那门语言的草稿）； 这道题已经不收的语言（0020 摘掉的 Java / JS / Go）置灰，只能复制 - 举着手时刚交对、1.5 秒内点下一题：原来「确定要换题吗」要问两遍（点评完再问一次）， 现在同意过的那个地址不再问 - 课堂看板上评分中、评失败的流程图不再算「尝试过」，和学生的课堂条一个口径； 新加的流程图查询和其他查询并行，不再多等一轮数据库 - 课堂条的数据只认最后发出的那次请求：进页面那次后到的话会把刚做完的那道盖回「没做」 - 「A / S 算做完」收进契约，前后端只留一份；协作中老师的判断统一用 useTeacherCollab； 几处放错位置、说法过时的注释 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-28 19:35:07 +08:00
xuyueandClaude Opus 5.5	972dac3776	feat(题目): 答错时说清楚「输出了什么、应该是什么」，交对后给相似题，零碎几处对齐设计 ... - 答案错误里「格式和内容都不一样」那一类（样例上错的 44%）：原来只说「对照一下，找找 从哪里开始不一样」，现在是「你的程序输出了「E」，正确的是「D」。拿例子 2 的输入「60」， 一行一行走一遍你的程序，看它走进了哪个分支」；多行的说第几行开始不一样 - 不在这节课里的题交对之后，结果页签里给「再练几道相似的」（原来只在题面最底下） - 提交前自动排版改了代码的，结果上面提一句「编辑器里的代码也跟着变了，按 Ctrl+Z 能撤回」 - 交对之后「提交」降成描边按钮，「下一题」是唯一的主按钮 - 「重置代码」先确认（原来点一下就把代码和本地草稿一起清掉了） - AI 提示的档位写「第 1 档 · 反问」，不写「L0 反问」 - 成就弹窗从右下角挪到右上角，别和结果、点评弹窗叠在一起 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-28 18:39:05 +08:00
xuyueandClaude Opus 5.5	3fe3caa944	feat(流程图): 流程图画到 A / S 算这道题做完——题单进度、课堂条都认；加入题单之前画的图先藏起来 ... - 流程图评到 A 或 S，记进所有已加入、且包含这道题的题单（和判题那一路同一个口径，不看从哪个 入口交的），徽章和题单类成就照样推送。原来题单进度只在判代码时记，流程图作业在题单里永远是 「没做」。流程图提交的 id 进不了 problemset_submission（外键指向代码提交表），所以只写 progress_detail —— 解锁旧提交的那道闸看的也是它 - 课堂条（/me/class-activity）的 myStatus：流程图 A / S 也算 accepted，评完的非 A/S 算 tried - 题单防抄闸门补到流程图上：加入题单之前画的图，对本人藏起来（列表 showLink、详情 404、 current / history 不数它），规则和代码提交同一份（problemSetJoinTimes 挪进 services/problemset）。 原来加入之前画到 A 的那张图点一下就能载回画布、交上去就是 A - 新增 GET /problems/:id/flowchart/scores：一次给出自己评完的每一次的分数和等级，外加被藏起来 的次数（原来 history 一次只给一条，看分数走势得一页一页翻） - 「A/S 算过关」和按分数定等级收进 flowchart/grade.ts；判题那边的记账 + 通知抽成 recordSolvedAndNotify，两条路共用 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-28 17:56:35 +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	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	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
xuyue	d25b5dbe6d	update	2026-09-27 19:36:28 +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	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	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	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
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	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	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	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	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	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	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	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
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	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	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	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
xuyue	684f2d29a5	feat(契约): 练一练的内容按题型收进契约，7 个题型组件不再裸读 data ... `Exercise*.vue` 七个组件直接读 `data.question` / `data.options` / `data.lines`， 而契约里 `data` 是 `Record<string, unknown>`（后端不校验）、前端只做了类型收窄 —— 也就是说这条路径**从来没有在运行时被看过一眼**，结构对不上时渲染期才炸。 现在 exerciseSchema 用 superRefine 按外层 `type` 分派到对应的内容形状， 外层与 data 对不上也会被抓住（`type: "mcq"` 配 `{question, code}` 会在渲染 mcq 组件时炸在 `data.options`）。七个题型的键集按生产库实测确定。 **这个 schema 后端也在 parse**（routes/content.ts 的 `exerciseSchema.parse`）， 所以收紧它同时是一道服务端闸门：坏数据会让练习列表 500。因此先用生产全量 数据核验：151/151 通过，且反向验证确认能抓住题型与 data 不匹配的情况。 `getExercises` 另加了一层逐题型校验，让前端也能把内层分歧记进 `__OJ2_CONTRACT_DRIFT__`；`z.infer` 拿不到判别联合（superRefine 无法把校验 结果反映到推断类型上），所以类型上仍需一次经过 unknown 的断言 —— 它不掩盖 未经检查的分歧，因为运行时那一步已经做过。 顺带补上 getFlowchartSubmission 的闸门；被守卫端点达到 41 个。 验证：vue-tsc 与 tsc -p apps/api 均 exit 0；vite build 通过；check:routes 无遮蔽。	2026-09-10 04:28:26 -06:00