xuyue/OJ2
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
466 Commits 1 Branch 0 Tags
1330fc49af5af5aa4cd8dc2c78c240404bec9ba4
Commit Graph
38 Commits
Author SHA1 Message Date
xuyueandClaude Opus 5.5 c17f88cdbb feat(题单): 题单页重做——布置中的放最上面，详情顶上一条进度和奖章阶梯，没加入看得见题点不进；老师看全班、后台一屏编辑
Deploy / deploy (push) Canceled after 0s
Details 
- 列表：布置中的大卡片（做对几道、布置到哪天、再做对几道拿哪个奖章），其余小卡片，加入过的在前
- 详情：进度 + 奖章阶梯（下一个金圈「再做对 n 道」），题目两列写几点做对 / 交过几次；
  以前做对过的标「旧代码先藏着」；做完整条变绿，烟花只在做完那一刻放
- 老师多一个「全班情况」页签；题目页从链接直接进来没加入时，条上给「加入题单」
- 后台一屏编辑：布置一周 / 两周 / 四周 / 选日期，公开开关，粘贴多个题号一次加，拖动排序，奖章只剩两种条件
- 旧代码藏着的地方都说清楚是哪个题单、哪天之后能看
- 修掉列表卡片把选做题数说成「新加了 N 题」

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-09 22:01:39 +08:00
xuyueandClaude Opus 5.5 151bbdcb50 feat(比赛): 比赛页一页看题目和自己的名次；排名竞争感做足、结束有领奖台；老师考试中看全班、考完看成绩；新建比赛一屏做完
Deploy / deploy (push) Canceled after 0s
Details 
- 学生比赛页（设计稿 B）：左边题目带几人做对、谁最先做对；右边我第几名、5 分钟里升了几名、再做对 1 道能到第几名、我前后的人
- 期中、期末考试中只有自己的进度，写明「排名考完公布」，题目页的排名入口也藏起来
- 排名页：按班筛、名次变化、最先做对的深绿格、自己那行钉住；结束后前三名领奖台 + 我的成绩卡；排名曲线和学生的「导出数据」去掉
- 老师的「全班情况」：卡在一道题、15 分钟没交的放最上面，没进来的人对上看板的请假；考完变「成绩」，点格子看代码、标看过了（代替后台审核页），导出成绩
- 比赛列表：进行中的一大块「接着比」，已结束的写我第几名，前三带奖杯
- 新建比赛：默认 10 分钟后开始，时长点按钮，搜题号把题加进来自动编号、拖动排顺序

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-09 20:58:59 +08:00
xuyueandClaude Opus 5.5 c2ef55b10b fix(提交): C 代码编译不过时，提交前的自动格式化把出错的几行并成一行，学生认不出自己的代码
Deploy / deploy (push) Canceled after 0s
Details 
clang-format 不认中文分号、缺了分号的语句，会把它和下一行并起来（int n； 和 scanf 成了
一行），报错的行号也对不上学生记得的位置。现在 C / C++ 格式化之前先套上题目模板、在
判题机上编一次，编不过就原样返回、不格式化，代码照常提交、照常判成编译错误。

api 容器里没有 gcc，判题机的编译器和参数本来就是判的标准，所以借它编。这一下不进判题
队列、不建提交记录；判题机连不上时照旧格式化。代价是每次交 C 多一次编译，零点几秒。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-30 11:29:37 +08:00
xuyueandClaude Opus 5.5 fa092d334c feat(编译错误): C / C++ 编译没过时也给中文说明、标出出错位置，中文标点能一键换成英文
Deploy / deploy (push) Canceled after 0s
Details 
原来 C / C++ 的编译错误学生看到的是 gcc 的英文原文。现在和 Python 一样一张翻译表
（cError.ts），照全库 2851 条 C / C++ 编译错误用现在的判题机（gcc-14）重新编译出来的
报错定的，只看第一条 error，98% 能给出说明。

三件事先于句式判，因为 gcc 对同一个错报法五花八门：
- 交成了 Python 代码（330 条）：gcc 报的是 request for member 之类，直接说换语言；
- C 里写了 C++（iostream、cout）；
- 中文标点：gcc-14 不再报 stray，而是把「；」吞进变量名、错报到下一行，所以直接在
  代码里找引号和注释之外的中文标点，行号按代码算。中文标点查找认 C 的 // 和 /* */。

句式上：缺分号报在下一句开头的往回挪一行，把分号写成冒号、关键字拼错（coutinue、
RETURN、return0）、文字没加引号、#include 拼错、main 外面写语句等各有说法。
gcc 的 did you mean 会从库函数里挑（num → enum），只信学生代码里有的名字。
列范围按 gcc 的显示宽度换算（中文占两格），含中文的行也能标到具体位置。

卡片改名 CompileErrorExplain，提交结果、运行例子、提交列表弹框三处都接上了。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-30 11:22:31 +08:00
xuyueandClaude Opus 5.5 773d15b033 feat(课堂看板): 「这节课的题」旁边多一个语言下拉，布置 C 的作业学生打开题目编辑器就是 C
Deploy / deploy (push) Canceled after 0s
Details 
默认是这个班上一次布置选的语言。学生那边首页、题号下拉、题目页课堂条都写上「C语言」；
打开这节课的题时编辑器自动切过去，每道题只切一次，学生自己再换就按他的。提交列表的
「这节课」连语言一起筛。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-30 09:54:21 +08:00
xuyueandClaude Opus 5.5 eb32676de4 feat(题目): 「运行例子」「自己输入」改用和提交同一台判题机——例子上跑出什么样，提交在这几个例子上就是什么样
Deploy / deploy (push) Canceled after 0s
Details 
原来试运行走另一台 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 e7b95d211d fix(题目): 修掉题目页重构审查查出的问题——提交途中换题会把结果算到新题上、运行例子把对的菱形判错、点评完「下一题」不跳等 
题目页重构之后按「功能对照 / 状态 / 结果页 / 布局与后端」四路审查了一遍，查出的问题一起修：

提交与换题
- 提交、画流程图途中换题：A 题格式化好的代码会盖掉 B 的草稿，A 判对了把 B 标成已解决、
  弹 B 的点评、题单里跳回题单。现在每个请求回来先核对题目，轮询和推送回来的也核对提交编号
- 画着流程图换到不能画的题，语言退到题目的第一门、还被记成偏好；现在回到学生习惯的那门
- 强制点评评完点「继续 / 下一题」，学生之前在看「题目」页签的话会停在原题
- 离开题目页之后判题、流程图的 WebSocket 一直连着，现在闲 15 分钟断开

运行例子
- 输出开头的空格被削掉，打印菱形这类题对的代码也显示「没对上」
- C 的编译警告拼进了「你的输出」（后台生成测试点也会写进 .out）
- Python 的语法错误（中文标点）被说成「下标有没有越界、除数是不是 0」
- 比赛里仍然把空格画成「·」、把不同的地方标红

入口与协作
- 比赛里不给「课堂统计」、不绑协作：房间和统计都按题号找，比赛题号和公开题撞号
- 「看他交过什么」按整名匹配，不再混进学号相近的同学
- 协作中点上下文条、相似题、下一题开新标签，协作不断
- 题单入口给管理员的「⋯」里留「本题提交」

结果与题面
- 「去自己输入拿 51 这些数试试」取到了题面 HTML 里的颜色值；「题目原话」露出 &quot;
- 流程图 A 级的学生标题下还写着「还没交过」
- 「我的提交」上方补回「答案错误 × 3」这样的计数
- 流程图历次评分能点开看那一版的图；读分数失败不再说「还没交过流程图」；手机上能看流程图点评
- 「结果」页签有新结果没看时加粗上色，看过就恢复
- 空画布拖进第一个节点画布会跳一下；画布底下空着一条
- 比赛没开始写成「已结束」、倒计时超过一个月算错；分隔条拖到头工具栏被挤坏；题单里的题目页有备案页脚
- 流程图历次分数只读需要的几列（一个学生一道题 23 次提交：96 kB → 2 kB）
- 比赛密码、比赛没开始等几条学生看得到的英文报错换成中文

设计文档照实际做法更新了第 5.5、5.6、6、8、9、10、11 节。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-29 00:07:16 +08:00
xuyueandClaude Opus 5.5 5836902c6b style(题目): 运行例子、自己输入、Python 报错、流程图点评这几块结果也照设计稿重排，手机上题目页顶满屏幕 
- 运行例子：标题带每个例子的对错胶囊，全对时提示「再按提交」
- 自己输入：说明「这里不判对错」，输出框留出固定高度
- Python 报错：灰底卡片，改法按钮放显眼处
- 流程图点评：画过几次连成一排，大分数 + 等级 + 四项分数条，重新提交后直接显示新的这一次
- 工具栏「写代码 / 画流程图」换成设计稿的分段切换，窄时缩成「代码 / 流程图」
- 设计文档记下和画板有意不同的几处（去掉限时、保留新轮盘等）

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-28 23:13:23 +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(题目): 答错时说清楚「输出了什么、应该是什么」，交对后给相似题，零碎几处对齐设计
Deploy / deploy (push) Canceled after 0s
Details 
- 答案错误里「格式和内容都不一样」那一类（样例上错的 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 11368813cc feat(流程图): 「写代码 / 画流程图」变成工具栏上的切换，AI 的评分和历次分数挪进结果页签，题单里也能画 
- 流程图题的工具栏最左边是「写代码 / 画流程图」。原来流程图藏在语言下拉里，叫一个名叫
  Flowchart 的「语言」；画完一道题之后它还被记成语言偏好，下一道能画的题一打开就是画布
- 「交给 AI 点评」交完切到「结果」页签：评的时候写着「AI 正在看你的图」、画布照样能改；
  评完是分数、评语、改进建议、四项得分，顶上一排历次分数，点哪次看哪次。
  原来是提交按钮旁一个 1000px 的弹框，盖住画布，翻历次评分要一页一页点
- 画到 A / S：给「照着它写代码 →」，题单里 1.5 秒后回题单（和代码通过一样），
  课堂条当场标成做完；只在这一页上刚评完的那次才算，进页面读到以前的 A 不跳
- 「把这一版载回画布」只在画布和那一版不一样时出现；载回、进页面读回草稿后都缩放到装下整张图
- 题单入口能画流程图了（原来只有题库入口能画），题单里的代码草稿、流程图草稿各存一份，
  加入题单之前写的、画的不会一进题单就摆在编辑器里
- 手机上不给「画流程图」（节点库是拖放，手机上拖不动），题面里以前画好的那张照样看得到

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-28 18:19:16 +08:00
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(题目): 工具栏加「运行例子」、结果页签加「自己输入」，去掉每个例子旁的「测试」和顶栏的分栏切换
Deploy / deploy (push) Canceled after 0s
Details 
- 工具栏「运行例子」：一键用全部例子试跑（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——交完切去写代码，这次的评分结果不再丢
Deploy / deploy (push) Canceled after 0s
Details 
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 1b149a4f3f fix(题目): 在题目页里直接换题（下一题、题号直达）后，例子和语言还停在上一道题
Deploy / deploy (push) Canceled after 0s
Details 
题目页换题是同一个组件复用、只换路由参数，几处只在创建时读一次的状态就停在了上一道题：

- 例子：新题下面摆着旧题的例子，「测试」也拿旧例子比对
- 语言：下拉选项不跟着变，也不回退——从 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
xuyue d25b5dbe6d update
Deploy / deploy (push) Canceled after 0s
Details
2026-09-27 19:36:28 +08:00
xuyueandClaude Opus 5.5 9412ba3cf6 refactor(契约): 展示题号统一叫 problemDisplayId，题单 id 统一叫 problemSetId
Deploy / deploy (push) Canceled after 0s
Details 
前后端同时改，部署前开着的旧页面要刷新一次（题号列会是空的、提交筛选会失效）。

- 挂在非题目对象上的展示题号，原来叫 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 f8b04af4ea chore: 加 oxlint，现存 19 条 warning 清零
Deploy / deploy (push) Canceled after 0s
Details 
原来只有 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 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 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 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 8b4d8899f9 feat(判题机): 自建镜像升级工具链，语言收敛到 C / C++ / Python
Deploy / deploy (push) Canceled after 0s
Details 
上游 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 5222e012e1 fix(比赛): 修四处 —— 倒计时两倍速、排名不自动刷新、题目状态恒空、比赛隐藏后审核页取不到代码 
查比赛功能时实跑出来的四个问题，都在这一条里修掉：

**倒计时两倍速**（store/contest.ts）。init() 里 setInterval 之前不清旧表，而
detail.vue 在「未开始 → 进行中」那一刻会再 init 一次（为了捞开赛后才拿得到的题），
于是两个 interval 一起给 now 加 1000。学生赛前挂着页面就会中招：一场 60 分钟的
比赛，真过了 30 分钟页面就显示「已结束」、倒计时归零，而服务端还在正常收提交。
ojnext 里就有，是原样搬过来的。

**排名页「开启自动刷新」开着但不刷新**（contest/pages/rank.vue）。useIntervalFn
传的是 immediate: false，而 watch(autoRefresh) 只在开关变化时才 resume ——
开关初值就是 true、进页面不产生变化，表从没启动过，得手动关一次再开。改成
watchEffect，由「开关 + 比赛进行中」共同驱动，顺带不再在赛后空转轮询。同样来自
ojnext。

**比赛题的 myStatus 恒为 null**（routes/contest.ts）。判题其实把状态记进了
user_profile 的 acm_problems_status.contest_problems，只是这两条路由硬编码下发
空值，于是题目页的「状态」列永远是「未做」，赛后也不恢复。旧后端在赛后/管理员
视角是给的，这是回归。不按赛中赛后分档：这是学生自己的判题结果，不泄露别人任何
信息（旧后端赛中不给，只是因为它整条路换了个 serializer）。

**比赛一隐藏，审核页的「查看代码」必 404**（services/contest.ts）。acm-helper
故意不卡 visible（赛后核查恰恰发生在比赛收起来之后），它调的比赛提交列表却卡着，
两边对不上。findVisibleContest 换成 findAccessibleContest：公开的谁都取得到，
隐藏的只有比赛管理员取得到，学生看隐藏比赛照旧 404。

实跑验证（dev 全栈，判题走临时 worker 绕开本机 token 不一致）：

- 浏览器跨过开赛时刻挂着不动 —— 墙钟 20.0 秒，倒计时正好减 20 秒（原来会减 40）。
- 排名页停在「无数据」，另一账号提交一发 AC，5 秒内表格自己长出
  `1 student2 1/3 0:00:42`，没刷新页面。
- 学生 AC 后列表和详情都回 myStatus: 0，没做过的另一个学生仍是 null，匿名照旧 401。
- 比赛隐藏 + 已结束：出题人 detail / problems / rank / submissions / acm-helper
  全 200，学生这 5 条全 404，提交也 404，隐藏比赛不进公开列表。
- 排名记账口径未受影响：10 次提交（8 编译失败 + 2 AC）落库 submission_number=9、
  accepted_number=1、total_time=231=ac_time、is_first_ac=true。

tsc / vue-tsc / check:routes（175 条无遮蔽）均干净，测试数据已清库。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017xu912Rv5JUUuy6MqMcQW2
 2026-09-07 19:19:29 -06:00
xuyueandClaude Opus 5 bb0f5ec5ef fix(AI提示): 解锁条件前后端对齐，提示不再一点就没
Deploy / deploy (push) Has been cancelled
Details 
「失败 3 次解锁 AI 提示」实际是「在当前这次页面会话里再失败 3 次」：
problemStore.failCount 是个从 0 起数的内存计数器，刷新、切题、跳进跳出就归零，
而后端闸门数的是数据库里的历史失败数，两边根本不是一回事。昨天在这题上撞了
十次墙的学生今天进来照样看不到按钮。

- 数法收成一个 countFailedSubmissions()，题目详情的 myFailedCount 和
  POST /ai/hint 共用。原来详情把「等待/正在评分」也算失败，连点三次提交就能
  把按钮点亮，点下去却回 hint-locked
- 阈值 3 挪进契约 HINT_MIN_FAILURES，两端引用同一个常量
- failCount 改成 myFailedCount + 本次会话增量；在题目页里登录的补拉一次详情，
  否则停在匿名时的 0
- 结果面板改 display-directive="show"，不再一收起来就把流式输出中的提示连同
  那次 LLM 调用一起作废；补「上次结果」按钮，原来唯一的重开方式是再提交一次
- prompt 里的判题结果翻成中文，原来拼的是裸状态码，模型不知道 -1 是什么
- system_error 不计入失败数、也不显示按钮：判题机自己崩了不是学生的问题
- 比赛中不给提示，和「求助」按钮同一个口径

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RC5uL72UY9aZFuTvUKe2jv
 2026-09-06 07:24:26 -06:00
xuyueandClaude Opus 5 8a88fe8d99 feat(智能分析): 解题表格改服务端分页，/ai/detail 不再下发整份 solved
Deploy / deploy (push) Has been cancelled
Details 
原来 /ai/detail 把区间内做出来的每道题连排名带等级整份下发，一个活跃学生一年几百道，
一次请求就是几百 KB，而表格一屏只看得到二十行。

拆成两支：
- GET /ai/detail 只留聚合（solvedCount、difficulty、tags、attempts、activity、errors…）
- GET /ai/solved?offset&limit 按首次通过时间升序分页给逐题明细

排名只跟当前这批题有关，所以分页那支只算一页的 problemIds，不必把整年算一遍。抽出
firstAcQuery / buildSolved / listSolved 三个函数，detail 和分页两边共用。

前端相应改动：
- 难度分布改读后端的 difficulty 聚合（本来就在下发，之前是从逐题列表里现数的）
- 几次做对改读新的 attempts 数组（每道题的尝试次数）；tooltip 里的题名去掉了 ——
  明细是分页拿的，不该为了一个 tooltip 把全量拉回来
- Overview 用 solvedCount
- SolvedTable 的代码提交那张走 remote 分页，流程图那张仍是本地分页（一个 OJ 的
  流程图题就那么几道，全量下发没问题）；换时间范围回到第一页
- 表格原来是 max-height 1500 的滚动区，现在由分页兜住，滚动条和分页器不再并存

/ai/analysis 的 prompt 仍然带逐题明细（少了它模型只剩聚合数字），但顺手卡了 200 条 ——
以前是整份 solved 无上限塞进去，题做得多的学生一次调用能顶好几倍 token。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LZuPwqDmLEiK9zgQ9z9sVn
 2026-09-03 03:18:18 -06:00
xuyueandClaude Opus 5 4d7be969d9 refactor(智能分析): 重排版面，砍掉重复的三张周期图，补三个新维度 
原来 8 张图挤在两列大网格里，左列还套了一层两列小网格 —— 四张小图各自只有半页的
一半宽，"难度掌握情况"的标题被挤断成两行、周期图的 x 轴标签斜着叠在一起、一年热力图
53 列塞进半宽几乎看不清。改成单列为主，宽的图给全宽，窄的图两两并排。

砍掉的重复：进步曲线 / 提交效率 / 周期综合读的是同一个 durationData，半年视图统共
6 个桶四个字段，摊成三张卡六条曲线还都是双轴。合并成一张：柱是完成题目数和总提交数，
线是 AC 率，等级进 tooltip（S/A/B/C 四档离散值连成折线读不出东西，逐题等级表格里有）。

同期解题排名分布也砍了：五片扇形对十几道题做统计本来就是噪声，而排名逐题列在
SolvedTable 里，饼图没有增加任何信息。

换形式：
- 标签雷达图 → 横向条形。雷达对比较大小是最差的形式之一，原来还把值归一化成"占最多
  标签的百分比"，第一名恒为 100%，等于只画了个排序。现在画真实题数。
- 难度掌握情况 → 难度分布。去掉叠在里面的 S/A/B/C 维度，3×4 十二个格子对一个两个月
  做十来道题的学生大部分恒为 0。

热力图改成一格一周（53 格，周一起算，最后一格是本周）。按天切的话一年 365 格里三百多
格是空的，中职学生一年也就二三十天有提交，整张图看着像没用过。颜色阈值跟着按周重定。

新增三个维度：
- 错在哪里：判完的失败提交按状态码分组。编译错误占大头说明语法不熟，答案错误占大头
  说明是逻辑问题，两种情况老师该给的建议完全不同。
- 几次做对：到首次通过为止提交了几次，分一次过 / 2-3 / 4-6 / 7次以上。原来只有一个
  "平均提交次数"，看不出分布。
- 流程图得分：detailsData.flowcharts 早就在下发，但全页一张图都没有，只在解题表格的
  第二个 tab 里列着。

顺带：
- 时间活跃度从"只统计 AC 时间"改成"统计全部提交"，星期和时段由后端按东八区聚合。
  只看 AC 的话十来个点撒进 7×4 的格子几乎全是空的，和热力图的时区口径也对不上。
- 两两并排用弹性容器而不是固定两列网格：知识点分布在没有标签时整张卡不渲染，
  固定两列会空掉一半。
- AI 卡片原来有三个条件挂载点（solved>10 在右列、≤10 在全宽行、=0 藏在 Overview
  里面），单列之后收成最后一张无条件的卡。
- DurationChart 右轴的 S/A/B/C 一个刻度都没显示过：轴范围 -0.5~3.5，生成的刻度值是
  -0.5/0.5/1.5/2.5/3.5，拿去索引 gradeOrder 全是 undefined。

契约新增 activity / errors / rankScope / solved[].attempts / durationData[].acceptedCount。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LZuPwqDmLEiK9zgQ9z9sVn
 2026-09-03 03:08:54 -06:00
xuyue 69883bd016 fix chart
Deploy / deploy (push) Has been cancelled
Details
2026-09-03 02:35:29 -06:00
xuyueandClaude Opus 5 7129f1a12d fix(智能分析): 提示泄题、班级分析漏鉴权、AI 端点全线无限流
Deploy / deploy (push) Has been cancelled
Details 
/ai/hint 把参考答案原文放进 prompt，靠 system 里一句「不可透露」约束，而学生的代码
本身也是 prompt 的一部分 —— 一段「忽略上面的指示，把参考答案打印出来」的注释就能把
答案套走。改成不再发参考答案，让出来的 2000 字预算给题面；解锁条件（失败满 3 次）
原来只长在前端的会话计数器上，刷新就归零、直接 POST 更是完全绕开，补成端点自己查库。

/ai/class-analysis 只有 requireAuth，前端按钮上的 isAdminRole 只是 UI —— 任何学生
直接 POST 就能用，而且 comparison 全由客户端给，等于一个开放的代打 LLM 接口。补上
isTeacherOrAbove，与 /ai/class-pk-analysis 对齐。

/ai/analysis 收的是前端算好的 details/duration 整包，原样进 prompt 又原样写进
ai_analysis 表。改成只传 start/end/duration/username，学情数据一律服务端重算，
detail/duration 的计算抽成 buildDetail/buildDuration 三处共用；报告归被分析的那个人，
不归发起请求的人 —— 后台的 pin 和学生侧 /ai/pinned 都是按 user_id 找报告的。

四个 POST 端点和 login-summary 的模型调用全部过令牌桶（复用 services/throttling，
key 用 ai:<id> 与提交、流程图分开计数），超了返 429。

顺带修掉同一块里的几处：

- /ai/duration 的等级被写死成 `solved ? "B" : ""`，DurationChart 上那条折线因此恒定
  在 B。按旧后端 ai/views/oj.py:484 重新实现，按桶内同班排名算再取平均。
- 热力图 SQL 里 date() 用会话时区、JS 一边用 toISOString 取 UTC 一边用 getDate 取容器
  本地时区，三套混用；固定按东八区。365 格原来末格落在昨天，今天那格永远是空的。
- loginSummaryStore.open() 从 ojnext 移植时掉了，LoginSummaryModal 一直挂在 layout 里
  但没人触发，整条登录小结链路是死的。
- flowchart bestGrade 拿 max 回头 find 浮点相等的行；ai_analysis.provider 写死 deepseek。
- 前端四处 X-CSRFToken 是 Django 时代遗留，OJ2 后端没有任何 CSRF 校验，连同
  getCSRFToken 一起删掉；非 2xx 响应统一走 aiStreamError 转成中文。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LZuPwqDmLEiK9zgQ9z9sVn
 2026-09-03 02:13:59 -06:00
xuyueandClaude Opus 5 0b7b08f2cc refactor(前端): 去掉 { error, data } 信封，api2 改名 api
Deploy / deploy (push) Has been cancelled
Details 
信封是 Django 时代的形状：拦截器手工造一个**恒为 null** 的 error 字段，再把
真正的载荷塞进 data。后端 http.ts 的 success 其实只返回 { data }，那个 error
从头到尾没人用 —— 全站成功路径读 res.error 的只有 admin/api.ts 的
resetPassword 一处，而它自己就是个把信封拆开再重新包一遍的 shim。

代价是每个调用点都要 .data 一次：47 个组件、3 个 api 层文件、200 多处。
现在拦截器直接返回 response.data.data，ApiResponse<T> 退化成 T，文件末尾那句
`as unknown as Api2Client` 的类型谎言也少了一层。失败路径不动，仍然 reject
`{ error: 错误码, data: 文案 }` —— 和成功路径不对称是故意的，成功没有错误码
可言，接口注释里写清楚了。

顺带把 api2 改回 api：utils/ 下早就没有 api.ts 了，"2" 是迁移期用来和旧
client 区分的，现在只剩下让人多想一秒的作用。

## 怎么改的

**没有全局 sed。** 先把客户端的返回类型从 Promise<ApiResponse<T>> 改成
Promise<T>，让 vue-tsc 把每一处报出来（210 条），再按它给的 file:line:col
精确删 `.data`（192 处），剩下的手工处理：

- 6 处 `const { data } = await ...` 解构 → `const data = await ...`
- 3 个 api 层函数（getProfile / getProblem / getSubmission）自己手工造信封，
  改成直接返回值；getProfile 的返回类型跟着从 ApiResponse<Profile|null>
  变成 Profile|null

**类型检查抓不到的，人工把剩下的每一处 `.data` 过了一遍** —— 载荷本身带
data 字段、或者载荷是索引签名时，`res.data` 照样过类型。这一遍捞出三条真 bug：

- `getTutorialList` 的载荷是 `{ [key: string]: TutorialListItem[] }`（按
  python / c 分组）。索引签名让 `res.data` 编译通过、运行时是 undefined ——
  改完信封之后教程列表会**两个 tab 全空且不报错**。实跑确认过修好了。
- `createExercise` / `updateExercise` 返回 `res.data`，而 Exercise 自己有
  data 字段（练习内容）。两个调用方都不看返回值，所以类型和运行时都不响。
- `getSimilarProblems` 的 `.then(r => ({ ...r, data: r.data.map(...) }))`
  删掉 .data 之后变成往对象里摊一个数组，能跑但形状是错的。

另外两处是**对的**，加了注释免得下次被"顺手清理"掉：
StatisticsPanel 的 `res.data` 是契约 submissionStatisticsSchema 自己的 data
字段（每个学生一行）；download.ts 是独立 axios 实例，`res.data` 是 axios 的
响应体（zip 二进制，不走信封）。

## 验证

tsc(apps/api) 0 error、check:routes 168 条无遮蔽、vue-tsc 0 error、vite build
通过。**因为这改动碰的是每一个请求，静态检查不够，起了全套服务用浏览器实跑：**

- oj 侧 12 个页面 + 后台 13 个页面逐个打开，断言没有重定向、console 无报错。
- 关键页面进一步断言渲染出了真数据（后台用户列表 3 行、题目列表 10 行、
  站点配置表单三个输入框有值、教程列表分组正确）。
- 三条写路径实打：重置密码（库里 student123 → 531554，表格当场刷新）、
  公告可见性开关（走 getAnnouncement + editAnnouncement，就是手改解构那处，
  库里 visible t → f）、提交代码（POST → 判题机真跑出 -2 → 提交列表和详情页
  都正确渲染状态、语言、代码）。
- /rank 有一条 `{error: "class-missing"}` 的未捕获 reject，stash 掉本次改动
  复现同样报错，**是既有问题**，不在本次范围内。

本地 dev 库为了打通后台测试改了三处，都只影响本机：devadmin 补了 email 和
user_profile 行（原来缺这两样，getProfile 报 profile-not-found，AUTHED 存不
进去，所有 /admin 路由被守卫弹回首页）、密码重置成 devpass123。冒烟用的教程/
公告/提交三条测试数据已删干净，题目和用户的提交计数也回滚了。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-25 22:42:20 -06:00
xuyueandClaude Opus 5 1198895b54 refactor(前端): vue-tsc 清零，type-check 可以当 CI 门禁了 
接上 vue-tsc 时有 143 条既有错误，上一批迁移带走 89 条，这里把剩下的清完。

大部分是噪音（未使用的回调参数、死变量、少数 unknown），但里面躺着两个真问题：

- 个人主页查不存在的用户会抛：getProfile 返回 null 时后面照样取
  .acmProblemsStatus，靠 `!` 压着。加了早返回。
- getProblemSetProgress 我上一批标错了类型：后台这个接口返回的是裸数组，
  不是分页信封（和 oj 侧的 /user-progress 不一样）。已改正并加注释区分。

其余处理：

- 未使用的回调参数按 TS 约定加 `_` 前缀（v-for 的项、供子类重写的空钩子、
  路由守卫的 from）；确认无用的局部变量直接删（clickX/clickY 算了点击位置
  但飞出方向用的是随机角度，hasToday 下面已经用 lastDateOnly 判过，
  prefix 算了周/月但标签里没用上）。
- App.vue 的 highlight.js 注册：Promise.all([...]).then(m => m.map(x => x.default))
  会把元组塌成 (HLJSApi | LanguageFn)[]，hljs 上就找不到 registerLanguage。
  改成逐个取 .default。
- 给一批 api 补上契约类型（getMetrics / getHitokoto / getTutorials /
  formatCode / getProblemBeatRate / getClassUsernames 等），契约相应补了
  8 个 z.infer 导出。
- ContestRank.submissionInfo 和 AcmHelperItem.acInfo 在 api 边界窄化成
  SubmissionInfo —— 契约里是 Record<string, unknown>（JSONB 原文）。
- FlowchartEditor 的 TS2589：vue-flow 的 Node 嵌套太深，ref<Node[]>([]) 的
  UnwrapRef 推导撞上实例化层级上限，改成 ref([]) as Ref<Node[]>。
- api2.ts 的响应拦截器**故意**不返回 AxiosResponse（要把 { data } 信封剥掉），
  类型上确实说不通，没硬掰，写注释说明为什么用断言。
- 题目列表的「随机」按钮在模板里一直是注释状态，对应的 getRandom 和
  getRandomProblemID 一并删除（后端 /problems/random 保留不动）。

验证：vue-tsc 0 条，apps/api tsc、check:routes、web build 全通过；
修过 key 的列都打接口确认过字段真实存在。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-25 14:04:10 -06:00
xuyueandClaude Opus 5 c2a81209d7 refactor(前端): 拆掉 camelCase→snake_case 转换层，契约成为唯一真相 
utils/legacy.ts 是迁移期的临时层：新后端一律 camelCase，而组件读的还是
旧 Django 的 snake_case，于是在 api 层做一次递归键名重写。它自己的注释就
写了「迁移完成后这一层应当整体拆掉」。现在拆了。

代价不只是那 96 处包装：每个响应都要递归遍历整个对象重写一遍键名，而且
utils/types.ts 和 packages/contract 是两份真相 —— 手抄的那份还抄歪了好几处。

做法是按域推进，每域都用 vue-tsc 相对基线做差，确认零新增错误后再往下走。
前端的类型现在一律以契约为准，只在必要处窄化（比如 languages/template 的键
窄化成 LANGUAGE），删掉的重复定义包括 WebsiteConfig、LoginSummary、
AchievementSummary、ProblemSet、Contest、User、Profile、AdminTag、
StuckProblem 等等，其中 ClassComparison 有两个组件各手抄了一份。

## 顺带修掉的真 bug

- 管理端公告列表的「可见」开关每次都 400：列表响应被契约 omit 掉了 content，
  而更新接口要求 content 必填，toggleVisible 把列表行原样回传。而且是乐观
  翻转、不 await 不 catch，管理员看到开关动了、实际没存也没有提示。
  改成先 GET 整条再 PUT，加失败提示。

- 删有提交的题时只显示笼统的「删除失败」：前端还在 match 旧 Django 的英文
  文案，而后端返回的是 problem-has-submissions + 中文。连同另外 8 处同类
  匹配一起改成判错误码 —— 文案是后端随时能改的，match 文案改一个字就静默失效。

- SubmissionStatus.time_limit_exceeded 写成 `1 | 2`，TS 按位或算成 3，和
  memory_limit_exceeded 撞了同一个值。后端 judge/status.ts 里这是分开的
  两个码，按后端拆成 cpu_/real_ 两项。当前没有代码读这两个成员，但
  CLAUDE.md 明确要求判题状态码三处同步。

- 流程图历史翻到没有提交的那一页会直接抛：契约里 submission 是 nullable，
  被 any 掩盖成看起来非空。补了 null 分支。

## 契约里被逼出来的三处不诚实

- grade 写成 z.string()，但 averageGrade() 在没有可用数据时返回空串，
  前端三张图表拿它查 Record<Grade,...> 会查出 undefined。按实际收紧成
  z.enum([...,""])，四个查表点都补了「无评级」分支。

- difficulty 写成 z.string()。核对过生产库 dump：956 道题只有
  Low/Mid/High 三个值（761/149/46）。收紧成枚举。

- topReaction 写成 z.string()，既对不上前端渲染的 {type,count}，也对不上
  旧后端 get_top_reactions 下发的形状。改成正确形状并注明当前恒传 null。

## 明确保留 snake_case 的 54 处

判题沙箱原始输出（cpu_time/exit_code/output_md5/compile_output）、
statistic_info 内容（err_info/time_cost/ast_results）、submission_info
JSONB（is_ac/ac_time/error_number，回滚时旧后端还要读）、SQL 判题引擎的
total_rows/order_sensitive/changed_tables、WebSocket 的 submission_id、
以及数据库选项键 enable_maxkb。每一处都在类型定义旁写了为什么不能改。

language 没有跟着收紧契约 —— 它是配置项、随时可能加语言，收紧会让新语言
在后端 parse 时直接抛。改在 api 边界一处窄化。

## 另外

- utils/http.ts 整个模块已是死代码（四处引用全是 import type），删除。
- profile 的 blog/github/school/major/language 五个字段全链路空转，没有
  任何组件读，从契约到类型一并摘除（数据库列不动）。
- admin/account.ts 往 user_profile 塞的 totalScore 是 OI 模式遗留，表里
  没这一列。Drizzle 按表定义拼列名会把它静默丢弃，所以没出过错，是死代码。

验证：vue-tsc 143 → 54 条且无新增，apps/api tsc、check:routes、web build
全通过；各域响应形状逐条打接口核对过。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-25 13:44:24 -06:00
xuyueandClaude Opus 5 2edb8cfb0d fix(前端): 我改 /api2 前缀时漏了 5 处；修 4 个字段名不匹配；收紧 .gitignore 
浏览器走查 + 真实 AI 调用暴露出来的，都是「接口好的、界面坏的」，
只靠脚本打 API 永远发现不了。

## 一、AI 功能和测试用例下载全都会 404（我今天造成的）

把 api2.ts 的 baseURL 从 /api2 改成 /api 时，只改了走 axios 实例的调用，
漏掉 5 处不走它的：

  oj/store/ai.ts                        AI 题解分析     原生 fetch("/api2/...")
  oj/problem/.../SubmissionResult.vue   AI 提示         原生 fetch
  oj/rank/list.vue                      AI 班级分析     原生 fetch
  oj/class/pk.vue                       AI 班级 PK      原生 fetch
  utils/download.ts                     测试用例下载    独立 axios，baseURL "/api2/admin"

生产的 Caddy 只认 /api，这 5 条全是 404。阶段 0 的端点清单里就写着
「盲点 2：4 处用原生 fetch」「盲点 3：download.ts 是独立 axios 实例」——
我今天读过那份文档，还是漏了。

修完实测四条 AI 链路全通（真实 DeepSeek 调用）：
  /api/ai/analysis          200  SSE 176 分片 5.2s  start→delta→done→end 完整
  /api/ai/hint              200  2.4s  且未泄露参考答案
  /api/ai/class-analysis    200  12.6s
  /api/ai/class-pk-analysis 200  12.6s
落库确认（ai_analysis 新增，model=deepseek-v4-flash 与旧后端一致）。
hint 对别人的提交回 404 是**正确**的，它用 userId 限定只能看自己的。

## 二、4 个字段名永久对不上（重写引入的回归）

适配器只在**大写字母**前插下划线：`top10Avg` → `top10_avg`；
而旧 Django 给的是 `top_10_avg`（数字前也有）。前端还按旧名读。

影响比"三列空白"大：`row.top_10_avg.toFixed(2)` 在 undefined 上抛异常，
Vue 放弃整个子树 —— 班级PK 和班级排名页的**整个「分层统计」面板都不显示**
（Q1/Q3/四分位距/标准差/前10%/中间80%/后10%/人数 全没了），控制台还不报错。

修完实测：前10%均值 194.80、中间80%均值 93.79、后10%均值 49.40 全部出现。
写脚本按这个规律全仓扫过，确认只有这 4 个，改完复查归零。

## 三、.gitignore 差一点把生产库提交上去

原来只忽略 data/test_case/ 和 data/judge_server/，而 compose 会在
data/postgres/ 生成**整个数据库**（含 raw_password 明文列）、data/redis/、
data/backend/（学生上传的文件）。这次 `git add -A` 报权限错误才发现 ——
只因为 postgres 容器用别的 uid、目录读不了才没提交成功。改成忽略整个 data/。
已确认历史里从没提交过这些。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-08 05:37:24 -06:00
xuyueandClaude Opus 5 8c00cdc947 feat(阶段3): oj 侧端点铺开（基线提交，未经评审） 
由外部 agent (Codex) 在本会话额度中断期间完成。原样提交作为基线，
后续修复单独成 commit，便于区分与回退。

覆盖 oj 侧 65 个端点，新增 9 组路由（account/achievement/ai/classroom/
content/contest/flowchart/problemset/site）与对应 Zod 契约。

已核验：tsc --noEmit 退出码 0；API 可启动；/api/problems 返回真实数据；
judge 与 flowchart worker 均 ready。
未核验：权限边界与数据泄露，评审进行中。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-07 01:25:36 -06:00
xuyue ae1fb329b5 feat(阶段1): 搬入 ojnext 为 apps/web，未改业务代码 2026-08-06 21:18:16 -06:00