33 Commits

Include renames

Author	SHA1	Message	Date
xuyueandClaude Opus 5.5	aa7e0a6eb8	feat(看板娘): 接上全班进度、难度、提示、知识点、排名等数据，说的话更贴每个人 ... - 题目页：这节课同班做对的人多就说「全班已经 N 个人做对了」、都卡着就安慰、第一个做对的夸一句； 通过率不到三成的题错了说「本来就难」、高于七成的说「再看看题」；AI 提示开了没用就提一句； 做对了还有挑战就问敢不敢；流程图分低、拿 S 各有话 - 常点「太难了」的学生错了换软话；这周交得多、例子跑得少的念一句；卡住却从不举手的劝举手； 这周要提示多的劝先自己想 - 首页（这节课没要做的时）每次戳随机说一件：知识点差几道升级、周榜差几道超过前一名、 今天明天的比赛、三天内的新公告；两周以上没来说「好久不见」，只说一回 - 排名页第一名、差前一名几道；成就页差一点的；自学没全对的练一练；专题差最后一道拿奖章 - 运行例子、自己输入、举手也记进 mascot_event（trial、help），GET /mascot/profile 多给「太难了」次数和这一周交、跑例子、举手、要提示的次数 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-11-03 16:33:35 +08:00
xuyueandClaude Opus 5.5	ef3c53c671	feat(看板娘): 点她会按页面说一句傲娇的话，再给两三个能直接办事的按钮 ... - 她从不主动开口，点一下才冒气泡；比赛里不弹。台词 326 句（shared/mascot/lines.ts）， 口吻照「小鲸鱼」角色卡，学校里舍掉英文、粗口，「用户」改叫「同学」 - 按情况换话：题目页分没写、没交、例子没对上/对上、答错、编译错误、运行出错、超时、 错很多次、做对、一次就对、终于对了、以前做过；首页、题目列表、提交、专题、自学、排名等各有一组 - 按钮真的去办：运行例子、我错在哪（切到结果里出错的那一段）、举手、输题号、随便来一道、 下一道、选题…… - 老师也看得到：有学生举手时任何页面先说这件事；首页、课堂任务、统计、题目页各有一组 - 页面用 useMascotGuide 告诉她现在的情况（shared/mascot/guide.ts），以后按学生行为调整也接在这一层 - 修：连点时像卡住了（快点时按压过渡来不及显示，改成每下播一遍压扁回弹）； 一打开从左上角飞到右下角；去掉单击的摆动 设计稿与台词表：https://claude.ai/artifact/Qz2zPCfq2zCrqmxyms1UGx Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-11-03 16:12:23 +08:00
xuyueandClaude Opus 5.5	1b703d13ae	style(专题): 「题单」改名「专题」，顶栏、列表、详情、后台、成就说法统一 ... 只改界面文字和注释：网址 /problemset、接口、表名、字段名都不动，老链接照常能打开。 设计稿页名「题单重设计」和已执行的迁移文件保留原样。 线上 3 个成就（题单收藏家 / 入门 / 通关）已同步改名。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-11-03 00:12:18 +08:00
xuyueandClaude Opus 5.5	48590eee60	refactor(目录): 目录名对上界面上的名字，自学的「一课」不再也叫 lesson ... - 后台课堂任务 admin/lesson → admin/task（/admin/task），和前台 oj/task 对上 - 后台首页 admin/setting/home.vue → admin/home/，设置 → admin/config/ - 卡点分析、年度趋势从 admin/problem 搬到 admin/analytics（/admin/analytics/stuck|trend），和菜单的「学情分析」、后端 analytics.ts 对上 - 首页 dashboard.vue / TeacherHome.vue → student.vue / teacher.vue；自学首页 home.vue → index.vue，看一课 index.vue → tutorial.vue - lesson 只表示课堂上的一节：自学那边改叫 tutorial（oj/learn/lesson.ts → utils.ts、isLessonDone → isTutorialDone、Lesson*.vue → Tutorial*.vue、自学情况的 lessons 字段 → tutorials） - 旧地址不留跳转 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-11-02 22:59:43 +08:00
xuyueandClaude Opus 5.5	37e971b6b4	refactor(判题机): 换成 go-judge，空闲内存从几百 MB 降到 16 MB ... 原来的 JudgeServer 按核数起 gunicorn worker、每份提交再按核数开进程池，空闲内存跟着核数走 （2 核 52MB、16 核 305MB）。换成 go-judge 后空闲 16MB，同一批提交判题中 80–100MB（原来约 370MB）。 go-judge 只管在沙箱里跑命令，编译、逐点运行、比对输出、定状态码搬到 judge/sandbox.ts， 口径逐条照搬 JudgeServer，出参形状不变。拿生产库真实提交新旧逐点对比：C 2000 份 1989 一致、 C++ 891 份 890 一致、Python 2000 份全一致；不一致的是 system("pause")（现在不再判运行时错误）、 未定义行为、endl 死循环打印（运行时错误变运行超时），见 docker/judge/README.md。 - 判题容器改成 privileged（go-judge 要自己建 cgroup），镜像 oj2-judge-3 - 心跳改由 worker 每 5 秒问判题机 /version 代记，删掉 /api/judge-server/heartbeat - 前端统一用 stripJudgePath 去掉判题机工作目录（新的 /w/ 和旧的 /judger/run/） - 提交前编译检查只编译不运行 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-26 15:03:57 +08:00
xuyueandClaude Opus 5.5	195069450f	style(格式化): 改成单引号、一行最长 160，全仓重新格式化 ... Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-26 13:52:24 +08:00
xuyueandClaude Opus 5.5	e8a20d12f9	refactor(前端): shared / utils 不再 import oj 和 admin 下的任何东西 ... 依赖方向原来是反的：顶栏、登录框、举手列表这些 shared 组件从 oj/ 里拿东西。 - 跨端的接口挪进 shared/api.ts（按 apps/web/CLAUDE.md 的分法）：学生端题目列表、 出题人列表、这节课的题、待弹的成就 - 这节课的 store → shared/store/lesson.ts；头像 RankAvatar → shared/components - 纯函数挪进 utils/：举手列表的错法归类 errorKind、它依赖的答案错误分类 wrongAnswer 和 Python 报错翻译 pythonError、题目列表行的 toProblemRow - 只有后台在用的出题人下拉 AuthorSelect 挪回 admin/components 纯搬家。首页、题目列表、题目页、排名、课堂看板、后台题目列表打开无报错， 顶栏题号框敲 1001 回车直达题目页。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-16 15:11:21 +08:00
xuyueandClaude Opus 5.5	0ffc405a20	feat(前台): 各页直达后台对应功能——编辑这一课、新建比赛、编辑这条公告…… ... 题目页「编辑题目」从只给超管放宽到有权改这道题的人（含学生管理员改自己出的题）； 题目、比赛、题单列表加「新建」；自学首页加「自学情况」「管理教程」，课文加「编辑这一课」； 公告加「编辑这条」「发公告」；成就加「管理成就」；智能分析加「AI 报告」，看某个学生时 带着用户名过去直接筛到他。按钮统一走 shared/components/AdminLink.vue。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-15 14:02:29 +08:00
xuyueandClaude Opus 5.5	395be1a19b	fix(自学): 手机上代码折行看着像另起了一行，改回整行横着滑 ... 正文的代码块、填空、排序、找错四处都不折行了，和桌面一样。排序和找错是整组一起滑， 每行卡片一样宽（= 最长那行）。题目页编辑器的折行不动。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-15 13:39:27 +08:00
xuyueandClaude Opus 5.5	a5d5c39411	fix(手机): 收起键盘后「提交」按钮不回来；比赛领奖台第一名被挤出屏幕；iPhone 点输入框整页放大 ... - 题目页：安卓按返回键收键盘时编辑器不失焦，符号键一直贴底、「运行例子 / 提交」不回来。 改成看键盘真弹着没有（可视视口变矮），不只看焦点 - 比赛排名：结束后的领奖台三块共 646px，手机上第一名被切掉、第三名看不见；改成平分一行 - iPhone：点 14/15px 的输入框和代码编辑器，Safari 会整页放大且不缩回；只给 iOS 加 maximum-scale=1 - 登录：手机上选完班不再自动聚焦搜索框（键盘弹出来盖住半张名单） - 题单：窄屏上题目拆成两张没标题的卡片，像分了两组；放不下两栏时合成一张 - 「中等」在题目页是蓝色、在题目列表是橙色，统一成橙色 - 零碎：自学四列表格在 360 宽上收窄格子；统计「错得最多的题」表头不再挤成竖排； 「第 N 名」「14 道」不再把最后一个字甩到下一行 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-15 12:36:33 +08:00
xuyueandClaude Opus 5.5	90ce1ab0f5	fix(手机): 点开提交、班级详情、自学目录这类整屏的东西，按返回直接退出了整页，现在是先关掉它 ... - 提交列表：手机上点开一条，地址带上 ?id=，返回键就是关详情回到列表；刷新、转发链接 也还停在这一条；上一条 / 下一条、翻页、滚动位置都在；详情里点「只看他」先关详情再筛选 - 看板讲错误、排名班级详情、自学目录、题目页底部抽屉：手机上按返回只关它（useBackClose）； 在自学目录里选一课，返回是回到上一课，不多一站 - 分页列表（提交、题目、比赛、后台几个列表）用浏览器后退翻回前一页时会多压一条历史， 前进的记录被冲掉、返回要多按一次 —— 电脑上也是，一起修了 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-15 11:55:30 +08:00
xuyueandClaude Opus 5.5	7e68e11371	feat(题目页): 手机上写代码顺手多了：键盘上面多一排常用符号（括号、引号、冒号、缩进…点一下就进去，括号自动配对），代码字号改小、长行折行不再看不见右半截；输入输出说明上下排、例子不再被左边两列标签挤窄；题单里那条不再超出屏幕 ... Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-13 22:56:02 +08:00
xuyueandClaude Opus 5.5	3dbdc7cb1b	fix(自学): 手机上读课好读多了：长代码不再被截掉半行（折行接着缩进），表格不再一字一行，填空的注释不再折成像另一行代码、空也大了；往下读时底栏收起、读到课末不再有两个「下一课」；点下一课落在新课开头而不是末尾；输出预测不再把同一个问题问两遍 ... Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-13 22:40:39 +08:00
xuyueandClaude Opus 5.5	4c47e9389b	fix(自学): 手机上「代码排序」「分组」写明先点一下、再点去处，电脑上分组仍提示拖动 ... Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-13 22:27:23 +08:00
xuyueandClaude Opus 5.5	96a1c3808f	fix(自学): 手机上「代码排序」「分组」两种练一练拖不动、做不了，改成点一下选中、再点一下放下也行；填空不再被手机输入法把首字母改成大写 ... Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-13 22:24:59 +08:00
xuyueandClaude Opus 5.5	df3b4f0dfd	style(代码配色): 全站代码换成 Dracula 配色（亮色用官方浅色版 Alucard）；编辑器、题面和教程的代码块、练一练、提交详情的颜色一模一样了 ... 原来三套配色各管一块：编辑器是 smoothy / One Dark，正文代码块和练一练是仿 GitHub， 提交详情是 Naive 自带的，同一段 printf 在一课里就有两种颜色。现在静态代码也走编辑器 那套 lezer 解析器，颜色只在 shared/highlight.css 写一份，highlight.js 删掉。 填空题顺手修好：空会把语法搅乱，(humidity ____ 40) 被认成类型声明、humidity 染成类型色， 现在空里先填上答案再解析，答案不输出。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-13 19:49:20 +08:00
xuyueandClaude Opus 5.5	27210eac1b	feat(自学): C 教程里没写 main 的片段也能运行——上下套一层灰色的 main，灰的几行改不了；其余没 main 的片段不再给一按就报错的「运行」按钮 ... 教程正文里写 ```c main 的片段才套。套的行就在编辑器里，报错行号和看到的一致，复制出去是完整程序。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-13 19:20:45 +08:00
xuyueandClaude Opus 5.5	0e1784ba26	fix(自学): 练一练的填空框、拖拽卡片、连线项都没有边框，填空题看不出空在哪 ... 填空、排序、找错、连线、分组、输出预测六种题的边框和底色写的是 --n-border-color、 --n-color、--n-text-color-3。这几个变量只在 Naive 组件内部才有，自学重设计把外层换成 自己的卡片之后就全没了：边框整个消失，填空题只剩一个看不见的输入框。 换成 learn.css 里自学自己的变量，补了一个可操作控件用的深一档边框和次要文字色， 亮暗两套都有。代码字体原来只写了 Monaco，机房 Windows 没有，换成 --learn-code-font。 顺手把填空框的上下内边距去掉，几行之间不再贴在一起。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-12 14:07:04 +08:00
xuyueandClaude Opus 5.5	6f47ad8358	perf(Markdown): 题面、教程、AI 提示每次打开都去 unpkg.com 拉四个库，机房网络下又慢又不稳 ... md-editor-v3 的 MdPreview 不管正文里有没有代码、公式，都会从 unpkg.com 加载 highlight.js、katex、mermaid、echarts（mermaid 还是另一份 11.x）。而我们只用到最基础的 Markdown：题面 95% 是富文本存的 HTML，教程是标题、表格、图片，AI 输出是标题、列表、 表格、少量代码块，库里一处公式、mermaid 都没有。 - 显示：新组件 shared/components/Markdown.vue，直接用 markdown-it，代码高亮走本地的 highlight.js（和练一练共用 shared/highlight.ts，补了 C++ / SQL）。9 处 MdPreview 全换掉。 正文默认 16px，教程也统一成 16px。 - 编辑：后台教程编辑器换成项目已有的 CodeMirror，加一排格式按钮；图片可以按按钮选、 粘贴、拖进来，都是先上传再插入。md-editor-v3 从依赖里删掉。 - AI 生成的内容（AI 提示、AI 分析、班级报告）不再放行原生 HTML：学生能在代码里诱导 AI 吐出 <img onerror>，老师在后台一打开就执行。库里 1196 条 AI 输出没有一个 HTML 标签，关掉不影响显示。题面、教程照旧放行。 - 长英文改成在单词之间折行，原来 break-all 会把 "I live" 断成 "I l / ive"。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-12 14:02:54 +08:00
xuyueandClaude Opus 5.5	9e23d28f62	fix(自学): 教程代码块输入框空着就运行，报错说成「input() 用的次数超过了输入的行数」 ... Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-12 10:55:45 +08:00
xuyueandClaude Opus 5.5	401c1bef7c	fix(自学): 上一课 / 下一课下面空出一大截；学习目标里的加粗显示成两对星号 ... Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-12 10:41:24 +08:00
xuyueandClaude Opus 5.5	845e41c060	feat(自学): 自学重做——首页课程地图、读一课按项目分目录、代码块就地运行、学完给题做 ... - 顶栏「自学」进新的自学首页 /learn：接着学（按服务端记录，不再串到上一个学生）+ 按项目分组的课程地图 - 读一课：左边目录按项目折叠，正文加宽，右边本课大纲带练一练标记；去掉了不能运行的示例代码栏 - 正文里的代码块能改能运行，报错用题目页那套中文解释；读输入的代码出输入框 - 课末：练一练做到几道 → 学完了 → 老师挑的几道题（必会标出来）→ 下一课 - 练一练统一成绿色提交、结果一行字；手机版目录从底部弹出 - 后台：教程列表按项目分组拖动排序，编辑页左写右看、练一练插到光标处、挑相关题； 自学情况改成方块格 + 还没打开过的名单 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-12 09:40:34 +08:00
xuyueandClaude Opus 5.5	ad2e4a34a2	style(顶栏): 机房 1280 宽的屏上顶栏不再折成两行——菜单改成纯文字，「后台」挪到右边 ... Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-29 08:26:43 +08:00
xuyue	d25b5dbe6d	update	2026-09-27 19:36:28 +08:00
xuyueandClaude Opus 5.5	572a818d49	style: 按 Oxfmt 重新格式化 ... 换格式化器带来的差异，只有 5 个文件：长联合类型改成每项一行、以 | 开头。 和上一个提交分开，方便 blame 时跳过（git blame --ignore-rev）。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 15:37:23 +08:00
xuyueandClaude Opus 5	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 Sonnet 5	20a6ddc79c	feat(自学): 重做学生端页面与教师端学情概览 ... 学生端：目录 + 居中限宽正文 + 可收起的示例代码栏；目录改成三态圆点， 顶部加总进度；上一课/下一课栏桌面端固定在底部。 教师端：汇总卡片、学生状态标签与筛选（未开始/7 天没学/只读不练等）、 最后学习补「N 天前」、按练习表加「没人一次对/多数人卡住」提示。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>	2026-09-19 05:07: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	286487acf3	fix(自学): 少于三分钟的不算已读 ... 原来只要打开过（viewCount > 0）就记成已读，于是「点开看一眼就退」和「认真读完」 在老师那张表上长得一模一样，「已读 17/17」并不说明他学了。加一道 3 分钟的门槛 —— 按最短的一课定的下限，读不完还翻不动的课文，扫一眼是到不了这个数的。 阈值 TUTORIAL_READ_SECONDS 放在 contract 里，前后端共用一个数：学生端目录的 ✓、 后台「按学生」的已读课数、「按课程」的读过人数，三处口径必须一致，各写各的迟早分叉。 **累计时长故意不卡**。时长记的是真实停留，不满三分钟的秒数照样算进去，于是 「已读 0 课、累计 25 分钟」成为一种能看见的状态 —— 他翻了很多课，每课都没读满。 这正是这道门槛想让老师看见的东西，把时长一起滤掉反而把信息删了。 「按课程」的人均时长跟着改了分子：分母是读满三分钟的人，分子就得是同一批人的时长， 否则拿全部时长去除达标人数，人均会被翻一眼就走的人凭空抬高。 顺带修掉「✓ 已读 · -」：心跳 15 秒一跳，点开就走会落在 0 秒上，而 readableDuration(0) 返回的是 "-"。新口径下打勾要求 ≥180 秒，这个组合不可能再出现；打开过但没读满的 显示灰色的「读了 N 分钟」，记是记下了，只是还没到「已读」。 后台筛选栏上方写了一行口径说明，免得老师对着「已读 0 课 / 累计 25 分钟」猜是不是坏了。 本机实跑：student 读 A 课 500 秒、B 课 60 秒 → 已读 1/2、累计 560 秒； A 课「读过 2 人、累计 700、人均 350」，B 课「读过 0 人、累计 60、人均 0」。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013rpSKCNpVcMhTFhw21YiL7	2026-09-02 20:37:30 -06:00
xuyueandClaude Opus 5	bd84599174	feat(自学): 教程和练一练都留痕，老师能看到谁学了多少 ... 自学模块以前一个字节都不落库：读到第几课只存在浏览器的 localStorage 里， 练一练的对错是组件内的一个 ref，刷新即失忆。老师能看到的只有「谁交了题」。 现在两张新表： * tutorial_progress —— 一个学生 × 一课，记打开次数和累计停留秒数 * exercise_attempt —— 一个学生 × 一道练习，记试了几次、错了几次、 第几次做对的、最后一次做错时填的什么 都存聚合不存流水。练习那张表尤其明显：流水会随着学生反复点提交无限长， 而多出来的行回答不了任何新问题 ——「他第 3 次和第 5 次都选了 B」对老师 没有意义，「他试了 7 次才对」有。 停留时长只在页面可见、且十分钟内有过操作时才计。机房的电脑经常开着页面 就走了，不设这道闸的话「停留时长」会变成「电脑开机时长」，老师看到的 数字全是假的。换课、切标签页、关窗口都会先把攒着的秒数冲给**离开的那一课**。 练一练的对错仍然是前端判的：答案本来就随题面一起下发到浏览器，后端再判 一遍也挡不住任何人，只是重复实现七套判题。所以这是教学观察数据，不是成绩。 `last_wrong_answer` 存的是前端拼好的一句人话（「选了 C」「顺序 3-1-2」）， 不是原始作答结构 —— 七种题型形状各不相同，存结构就得在后台按题型各写一套 渲染，而老师要看的只是他错在哪。 顺带修掉预测输出题的一个老问题：它的 `submitted` 一旦为真就不再收回，而 `allCorrect` 是跟着输入实时算的，于是学生错一次之后把答案改对，界面直接 跳成「输出正确！」、提交按钮同时禁用，submit() 再也执行不到 —— 这道题 **永远不会被记成做对**。排序/连线/找错/分组四种题本来就在交互处把 submitted 置回 false，只有这里漏了，按同一套补上。 学生端：目录每课显示「✓ 已读 · 11 分钟」和「练一练 3/5」。教程保持免登录 可读，未登录只是不留痕，并明说一句。 老师端：后台新开「自学情况」（教师及以上可进），三个 tab —— 按学生（默认把读得最少的排在最前，这张表要回答的是谁还没开始）、 按练习（每道题的正确率、一次做对几人、做对的人平均试几次；展开看逐人明细 和他们最后错在哪）、按课程。班级框填 3-4 位是具体班级，1-2 位当年级前缀。 外键用了库级 CASCADE，和 Django 建的那批 NO ACTION 不同：删教程、删用户 不必再记得回来手工清子表。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GW5ef6C2kRW8Ru27ghCaUu	2026-09-01 08:54:27 -06:00
xuyueandClaude Opus 5	0b7b08f2cc	refactor(前端): 去掉 { error, data } 信封，api2 改名 api ... 信封是 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
xuyue	ae1fb329b5	feat(阶段1): 搬入 ojnext 为 apps/web，未改业务代码	2026-08-06 21:18:16 -06:00