125 Commits

Include renames

Author	SHA1	Message	Date
xuyueandClaude Opus 5.5	ee66cef367	feat(课堂): 只画了流程图的学生也算来上过课、做完了题——推断这节课的题、班上几人做完、最近来了几次都认流程图 ... 原来课堂那边只有「我的状态」和看板格子认流程图 A/S，其余统计只数代码提交： 全班画流程图的那节课推断不出题，课堂条和看板都是空的；只画了图的学生在看板上 「最近来了 0 次」。现在代码提交和流程图提交合成一张表来数，口径统一： 流程图 A/S 算做完，交过流程图（含评分中、评失败）算做过。 - 推断这节课的题、「班上 M 人做完」、最近几节课是哪几天 - 看板「最近来了几次」、最后提交时间、各题尝试次数 - 看板没选班时猜正在上课的班 - 班级对比、个人资料的通过数不在这次范围，仍然只数代码 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-29 00:06:54 +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	b4afcbd47f	chore(流程图): 注明 flowchart/current、history 两个接口为什么还留着、什么时候可以删 ... Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-28 18:50:05 +08:00
xuyueandClaude Opus 5.5	b5d2f1589e	feat(课堂看板): 流程图画到 A / S 在老师的看板上也算做完，只画了图的学生不再显示「没开始」 ... 和学生首页的课堂条同一个口径：格子的状态、做对的时间、尝试次数都把流程图提交算进去； 「最后一次提交」也算上今天画的图。有的题这节课整个班都在画流程图，原来看板上是满屏「没开始」 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-28 18:42:53 +08:00
xuyueandClaude Opus 5.5	0c2ff68e9b	feat(协作): 老师协作时右栏顶上一条协作条，结果页签先摆学生最近一次交的，抽屉变成「他的提交」 ... - 协作条：「正在帮 谁 · 语言 · 看他交过什么 ↗ · 结束协作」，从工具栏里挪出来，一眼看得出 编辑器里是学生的代码。「看他交过什么」带上学生用户名、开新标签（原来只带题号，还得再筛一遍） - 老师接单后「结果」页签原来是空的：现在摆学生在这道题上最近一次交的结果，可刷新； 不给 AI 提示（那是按登录的人自己的失败次数解锁的） - 抽屉「我的提交」在协作中变成「他的提交」，列的是学生的提交，只能复制、不能放回编辑器 （放回去会经协作通道直接盖掉学生正在写的代码），也不显示老师自己的排名 - 学生排队求助中、或者老师正在帮他时换题：先确认一句。换题会断开协作 / 撤掉举手， 原来一点「下一题」就把正在帮他的老师踢出去了 - 求助按钮文案：「举手求助」→「已举手 · 前面 2 人」→「某某 老师在帮你」 - 提交列表加 exactUsername=1：用户名精确匹配。原来只有「包含」，ks24a1 会把 ks24a10 的提交 也捞进来 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-28 18:28:53 +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	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
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	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	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	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	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	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	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
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	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 Opus 5	f90d01338e	feat(自学情况): 按学生加姓名/学号搜索，后端补稳定排序 ... 搜索是纯前端过滤（整表本来就一次拉完），和班级筛选可以叠加。 学生查询原来没有 orderBy，前端默认按「已读」升序排之后，同分的一大批 （尤其一堆 0）落回聚合的任意顺序，刷新一次换一个样；按班级、学号兜底。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-17 02:23:01 -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	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	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	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
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	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	26b23aa7c0	fix(统计): 「提交记录」列出所有交过的人，不再只有做完的 ... 统计面板那张表原来只给 `isDone` 为真的人，于是一次没对的学生连同他的提交 在面板里根本不存在——tab 却叫「提交记录」，看起来就像统计只认成功的提交。 - `data` 改成给窗口里交过东西的全部人，每行带 `done`；「完成人数」和完成度 跟着 `done` 数，不是 `data.length`，两个数字口径不变。 - 表格加「完成」列区分两种人；展开行拉的仍是那个人的全部提交（items 接口 本来就不按结果过滤），对错都在里面。 - 「交了没全对」那一栏原来无条件按花名册取，不填班级/用户名时花名册为空、 整栏跟着空掉，这批人两栏都不在。改成没有花名册时退回「有提交但没做完的 全部普通学生」，教师和禁用账号仍然排除；全站视图里保留完整用户名不剥班级 前缀。「还没交」那一栏没有花名册是真算不出来，仍然为空。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PZbWEaPCnGvmdfNFpPFNGb	2026-09-08 23:52:34 -06:00
xuyueandClaude Opus 5	6bef55904f	fix(题目分析): 「卡住的题」只看公共题，别把比赛题也算进来 ... 这条查询原来一个 where 都没有，比赛题一起进榜。隔壁 ac-trend 在同一个文件、同一块 面板，isNull(contestId) 写得明明白白，所以判定是漏写而不是口径选择。 比赛题的题号是每场比赛各自从 1 开始编的（快照里 61 道不同的题都叫「1」、61 道叫 「2」），一旦挤进前 40，那一行显示的题号会指向一道根本不存在的公共题。眼下还没 发生：前 40 的门槛是 97 人卡住，比赛题最多的一道是 59 人 —— 但两个班一起考的场次 有 95 人，撞上一道难题就够得着。 对公共题的数字没有任何影响：比赛提交挂的是比赛自己的 problem 行（快照实测两个方向 的交叉都是 0 条），公共题那一行本来就只统计自己的提交。实跑接口逐行比对，改前改后 前 40 集合完全一致，只有三处并列名次的先后不同 —— 那是这条查询本来就没有确定性 tiebreaker，并列的题在两次刷新之间也会自己换位置。 顺带能用上 0013 的 submission_public_metrics_idx：183ms / 18646 buffers → 80ms / 788。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KqjE6qPo67fqVDKn6Bx7yd	2026-09-08 18:30:05 -06:00
xuyueandClaude Opus 5	64ad6139f5	fix(后台用户): 删账号前拦住还有提交的人，改名回填按 user_id ... 两处都是「提交与用户的归属」在写路径上没维护住。 删账号：处理器那段注释早就点到了 submission.user_id 没有外键、全连坐会留下孤儿行， 但只把它当成「不改成 CASCADE」的理由，没有加对应的检查。结果是报错文案里写着 「该用户还有提交、题目等历史数据」，而提交恰恰是唯一拦不住的那一类 —— 只交过题、 没拿过成就没进过题单没参加过比赛的学生照样删得掉。 生产快照实测复现：删 id=1454（李若菡，13 条提交）返回 200 deleted:1，用户没了、 13 条提交留在库里，孤儿总数从 935 涨到 948。那 935 条就是这么攒出来的（28 个已删 账号）。线上今天还有 5 个这样能删的学生。 补一次提交查询把它拦下来，和 delete 放同一个事务里免得中间正好交了一发。文案一个 字没改 —— 它本来就是对的，缺的是兑现它的代码。混批删除整批回滚，干净的那个也留着。 存量 935 条不动：四条读路径现在都用 leftJoin 兜住了，列表显示冻结的名字、不出死链， 统计按 user_id 聚合他们本来就不在花名册里。加外键得先清历史数据，收益只有「以后 不再产生」，而那一半这次已经解决了。 改名回填：条件从「等于旧用户名」改成按 user_id。前者只改得动当前正好还等于旧名的 行，一个已经漂移过的账号再改一次名，更早那批仍然改不动 —— 库里 726 条挂着旧名字的 提交就是旧栈时代这么留下的，之后每次改名都从它身边绕过去。实测拿 user 2039 验过： user 表叫 ks248吴紫妍、13 条提交挂着 ks24数媒1班ks吴紫妍，老写法一行都匹配不上， 改成按 user_id 之后一次拉平。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KqjE6qPo67fqVDKn6Bx7yd	2026-09-08 18:29:19 -06:00
xuyueandClaude Opus 5	a89eed7bdd	fix(提交统计): 按 user_id 归属提交，不再按提交时冻结的用户名 ... submission.username 是提交那一刻的快照。教师统计全程拿它当主键用 —— ilike 过滤、 group by、再拿结果去 user 表 join 班级 —— 学生改名之后旧提交还挂着旧名字，一条都 匹配不上。 生产快照实测（2026-09-08）：24 级数媒两个班改成编号制用户名之后，查 ks249 旧口径 0 条、新口径 7 条，整个班 48 人全掉进「一条没交」；查 ks248 是 20 条 / 54 条， 13 个人的成绩查不出来。ks248林依晨那 8 条提交原来一条看不到，人在「一条没交」栏， 现在落到「交了没完成」并带出最后一次失败在 1082 题。 四条路径一起改： - /submissions/statistics 的过滤、聚合、花名册全部改按 user_id，用户名从 user 表 join 出来。已删号的学生 user 表里没有行，退回提交里冻结的名字（personCount 那句兜底就是给这种情况的） - /submissions/statistics/items 展开行先把用户名解析成 user_id - /submissions 和 /contests/:id/submissions 的用户名筛选取并集：user_id 匹配到的 账号，加上按冻结用户名匹配的（已删号的 28 个账号只剩这一份名字，顺带「按记得的 旧名字搜」也还查得到）。列表显示的名字改成当前用户名，否则筛 ks248 出来一堆写着 ks24数媒1班ks的行，看着像筛错了 - /rankings/activity 同样按 user_id 分组。这条眼下是预防性的：改过名又有 AC 记录的 4 个人只有 1~2 题，够不到前 10，但真上榜会显示旧名字或被拆成两条 顺带把统计接口的四次全表扫换成索引扫：ilike 走不了索引，换成 user_id in (...) 之后单条 18448 → 537 buffers，整个接口查一个班 120~250ms → 10ms 上下。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KqjE6qPo67fqVDKn6Bx7yd	2026-09-08 18:29:02 -06:00
xuyueandClaude Opus 5	9c5a1d551d	perf(教师统计): 展开行的明细改成按需拉，统计响应不再背着 4.9 万行没人看的数据 ... 上一版把明细收成「只取有 AC 的人、每人最近 50 条」，拿生产快照（12.4 万条提交） 实测下来只从 105631 行降到 49108 行 —— 2.1 倍，不是一个数量级。原因是绝大多数人 本来就不到 50 条，每人截断那道闸在真实分布上基本没咬到，最坏情况响应体仍有 ~2.4MB。 真正的问题是形状不对：表格一次只展开一行（updateExpandedRowKeys 只留最后一个 key）， 却给 1900 个人各准备了一份。所以明细整个从统计响应里拿掉，改成展开时按需拉： - 新端点 `GET /submissions/statistics/items`，要用户名 + 同一套时间窗和题号。 用户名这里是**精确匹配**，不是统计接口那种 ilike —— 那边填 ks251 要圈出整个班， 这边是「点开的这一行是谁」。上限 200 条，多取一条来判断 truncated，被截断时 展开行里说明「只显示最近 200 条」，免得老师以为这人就交了这么多。 - 时间窗和题号抽成共用的 statisticsScope，两个接口必须同一个范围，否则展开行 看到的是另一个窗口的数据。 - 前端按人缓存，收起再展开不重拉；每次重新统计（含 15 秒自动刷新）清缓存， 并把当前展开着的那一行重拉一遍 —— 展开行跟着一起活着，不然刷新之后上面的数 变了、下面的明细还是老的。 - 去重放在 loadItems 里：点一行会同时走 rowProps 的 onClick 和表格的 update:expanded-row-keys，两边都想拉，改之前真发出了两条一模一样的请求。 顺带把 submissionItems 从 submissionStatisticsUserSchema 里删掉。 生产快照上的验证（12.4 万条提交 / 1956 用户 / 961 题，恢复进一次性容器跑完即删）： - 最坏情况（全部时段 + 不填条件）少搬 49108 行，约 2.4MB - 真实课堂量级（最忙的一小时：583 条提交 / 81 人）四条查询分别是 主聚合 45ms、明细 6.5ms、语法未过 2.4ms、最近错因 <1ms - 「已解决」那条口径修正的实际影响：13.3% 的「人×题」有重复 AC，同一题最多 AC 45 次； 按人看最夸张的是 419 条 AC 其实只有 38 道题 - 语法要求的题 15 道、result=10 共 57 条，其中「最后也没改对」的 18 个人×题 —— 角标会出现，但稀有 浏览器实跑：展开前不发明细请求；展开后 1 条、12 个按钮；收起 +0、再展开 +0（走缓存）； 自动刷新时统计与明细 1:1 配对、间隔 15 秒，没有重复请求。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KqjE6qPo67fqVDKn6Bx7yd	2026-09-08 05:43:32 -06:00
xuyueandClaude Opus 5	f66bafafaf	feat(教师统计): 提交统计面板返修 —— 统计口径、未完成分两栏、多题、自动刷新 ... 排查这个面板时发现的一串问题和缺口，一起修掉。改动集中在 `GET /submissions/statistics` 和 `StatisticsPanel.vue`，两边互相咬着， 拆不成独立的 commit。 **「已解决」数的不是题数**（真在显示错数字）。`count(*) filter (accepted)` 按用户名分组、没有 distinct problem_id，同一道题重复 AC 会重复计数。查单道题时 看不出来，老师查「这节课全班」时「已解决 5」可能是同一道题交了 5 次。新增 `solvedCount = count(distinct problem_id) filter (accepted)`，表格那一列换成它； `acceptedCount` 保留，正确率的分子仍然是提交条数。 **正确率把判题中的算进了分母**。PENDING / JUDGING 进分母不进分子，全班同时交卷的 那几秒正确率凭空掉一截 —— 而老师盯着看的就是这个数。分母改成判完的条数， `UNJUDGED_RESULTS` 提到 judge/status.ts 共用。总提交仍是全部条数（交了就算交过， 否则人数口径会跟着变，正在判的学生会掉进「没交」名单），另外下发 `judgingCount`， 非零时面板多显示一块「判题中」，三个数字才对得上。 **「未完成」实际是「一次没交」**。做了但一次没对的学生既不在「完成人数」也不在 未完成名单，等于从屏幕上消失 —— 而那恰恰是最该去看一眼的人。新增 `dataAttempted`，未完成栏拆成「还没交」/「交了没对」两组，tab 计数是两者之和。 请假隐藏对两组同时生效：他们同样占着班级人数这个分母，只藏一半会把完成度算错。 **点名字能看到错在哪**。`dataAttempted` 带上最近一条提交的题号、状态和 `statistic_info.err_info`（截断 400 字），点名字弹出来，还能一步跳到代码。 老师不用再切到提交列表、翻到这个人、点开代码。 **支持一次查几道题**。题号框接受 `1001,1005,1010`（中英文逗号、分号、空格都当 分隔符，投影前手敲不该因为打了全角逗号就查不出来），有一个题号不存在就整体 404。 **完成 = 这几道全解决**；只填一道时和原来完全等价，不填题号时退回「至少做出一道」。 差一道的人落在「交了没全对」里，名字后面缀 `2/3题`。 **零提交时整块面板消失**。判空条件是 `count.total > 0`，可一节课刚开始一条提交都 没有、后端已经把整份花名册当作「未完成」返回了 —— 最该看名单的时刻反而只显示 「暂无数据」。流程图那边更彻底：`/flowcharts/statistics` 的零提交分支把 `dataUnaccepted` 写死成空数组，名单压根没下发。 **面板不会自己刷新**。打开是空的、要点一次按钮，拿到的是那一刻的快照。改成打开即查 + 每 15 秒滚动重查，页面切到后台就停，关掉面板随组件卸载停掉。上一次没回来就跳过 这一次。班级从手打 `ks251` 换成下拉（选项来自网站配置的 class_list，和登录框同一份）， 保留自由输入，查过的班级记进 localStorage 下次带上 —— 机房电脑一台对一个班。 **明细查询没有 LIMIT**。展开行用的 submissionItems 原来把窗口内**全部**提交捞进内存 再原样序列化，「全部时段 + 不填条件」就是十几万条。改成只取有 AC 的人、每人最近 50 条， 截断用窗口函数发生在数据库侧；表格「提交数」仍是真实总数。 **顺带**：`personRate` 前端从来没读过（完成度是前端按「减掉请假人数的分母」自己算的）， 从契约里删掉；「语法未过」的题数单列出来（AST_CHECK_FAILED 全站仍然算通过，口径没动， 只是让老师看得见谁是绕过语法要求做出来的，那批人教学上没达标）。 实跑验证（dev 全栈 + 浏览器）： - 已解决：student 两条 AC 都在题号 5 上 —— 改前显示 2，改后显示 1 - 正确率：临时把两条改成 PENDING/JUDGING，12 条提交 2 条通过 —— 16.67% → 20%， 面板多出「判题中 2」，表格显示「12（2 条判题中）」 - 未完成两栏：student2 没交、student 交了 12 次没对，请假隐藏 student 后 班级人数 2→1、tab 2→1、出现「恢复 1 位」 - 错因弹层：点 student 弹出「最近一次：1020 · 编译失败 / Test case not found / 看代码」 - 多题：`1004` 完成 1 人；`1004,1005` 完成 0 人、交了没全对 student 1/2题 8次； 全角逗号同上；`1004,9999` 报 `Problem 9999 does not exist` - 自动刷新：打开即发请求，之后 04:44:22 → 04:44:36 → 04:44:51 → 04:45:06 每 15 秒 一次且窗口跟着滚；关掉面板后 20 秒请求数不再增长 - 班级下拉：选「25计算机1班」→ ks251，重开面板自动带上并立刻查 tsc / vue-tsc / check:routes 全过。验证用的 dev 库改动已还原。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KqjE6qPo67fqVDKn6Bx7yd	2026-09-08 05:20:51 -06:00
xuyueandClaude Opus 5	6a438872b9	feat(排行榜): 页头显示当前在线人数，在线绿点只给老师 ... 新增匿名可读的 GET /api/site/online，一条 ZCOUNT 让 Redis 自己数， 不拉成员、也不写（清理过期成员留给后台列表，匿名接口不带写操作）。 榜单页进页面拉一次，为 0 时不显示。 /rankings/users 的 isOnline 是三态：null 表示「这个调用方不该知道」， 只有老师及以上拿到 true/false。写成普通 boolean 的话学生看到的 false 和真的离线分不开，等于默认把每个人的在线状态摊给全校同学看。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017xu912Rv5JUUuy6MqMcQW2	2026-09-07 19:36:12 -06:00
xuyueandClaude Opus 5	856b7a280e	feat(后台用户): 新增「在线优先」排序，列表直接显示在线标记 ... 在线状态库里没有、会话也判定不了 —— session 的 TTL 是 7 天且每次请求续期， 「有会话」只说明这人一周内来过。新开一个 Redis sorted set（auth/presence.ts） 记最后活动时间，5 分钟内有活动算在线。 写入全搭在已有的 pipeline 上，不多一趟往返：登录、每个带鉴权请求的续期、 以及 touchSession —— 只挂着 WebSocket 不发请求的人靠最后这条，sweepSessions 每 60 秒一轮，所以窗口取 5 分钟，明显大于那个间隔。登出、改密码、禁用账号 会立刻把人摘掉；过期成员在后台读列表时顺手清理（整个 key 不能设 TTL， ZADD 不重置 key 的 TTL，到期会把还在线的人一起抹掉）。 排序 orderBy=-online 先捞在线 id，SQL 里 case when 分两档，档内继续按 最近登录排；没人在线时那个 case 恒等于 1，直接省掉。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017xu912Rv5JUUuy6MqMcQW2	2026-09-07 19:30:45 -06:00