导读
登录与注册(学生册 · 一)
一个邮箱地址,验证码直达
点击任意页面的「登录/注册」,都会进入 /reg 单页流程——没有密码,靠邮箱验证码直达:
- 输入邮箱 → 点「获取验证码」→ 邮箱收到 6 位数字(5 分钟内有效,输错 5 次作废;单邮箱 60 秒 1 次,同 IP 每小时 20 次)。
- 输入验证码 → 系统自动判断:已注册则直接登录进入
return页;未注册则出现用户名栏,填完即完成注册并自动登录、跳转入门路线。 - 也支持 GitHub 登录(登录页的 GitHub 按钮):授权后若是新用户会进入补全用户名步骤。
- 学生账号没有密码——邮箱验证码就是你的唯一登录凭证,请保管好注册邮箱。忘记密码不再适用(没有密码可忘);换绑邮箱请联系管理员。
- 用户名规则:3~31 个字符(或恰好 2 个汉字);注册后不能自行改名,找管理员走用户管理页改名。
- 注册后你已自动加入 system 域与 poj 域(排名生效的前提)。
- 页脚有「使用文档」(本页)和「随机一题」快捷链接。
做题与判题(学生册 · 二)
找题
- 题库:支持搜索和筛选,例如
?q=difficulty:1按难度 1~10 筛选,?q=category:动态规划按算法标签筛选;想随机刷题可访问/problem/random(页脚「随机一题」直达)。 - 题目页含题面、样例、提交记录与题解入口(
/p/题号/solution,做完再看题解是好习惯)。
提交
- 在题目页选择语言提交。本站 system 域开放语言:C (c)、C++17 (cc.cc17 / cc.cc17o2)、Python 3、Java。
- 远程评测题(POJ 域、一本通 ybtbas、深入浅出 srqc 系列)可选语言以题目页下拉框为准:srqc 深基系列只认 cc.cc17o2;POJ 认 c / cc.cc98 / java。
- 提交后跳转到记录详情页,判题实时刷新(状态行旁的实时通道);列表页同样实时。
判题状态一览(精确枚举)
| 状态码 | 含义 | 状态码 | 含义 |
|---|---|---|---|
| 0 | 等待中 | 7 | 编译错误(CE) |
| 1 | 答案正确(AC) | 8 | 系统错误(可申诉/重判) |
| 2 | 答案错误(WA) | 9 | 已取消 |
| 3 | 超出时间限制(TLE) | 11 | Hack 成功 |
| 4 | 超出内存限制(MLE) | 20/21/22 | 判题中 / 编译中 / 已取到(判题机已领取任务;远程题在此停留较久) |
| 5 | 输出超出限制 | 31 | 格式错误(多/少空格换行等) |
| 6 | 运行时错误(RE,崩溃/越界) | 32/33 | Hack 成功 / 失败 |
- 时间按 CPU 时间计;内存默认 256MB,题目 config 另行指定的以题目为准(本站绝大多数题为 512MB)。编译器版本与参数见 状态页。
- 远程题(POJ / ybtbas / srqc)由远端评测机判题,出结果稍慢,状态 22 表示已送达远端。
- 同一题重复 AC 不会重复计分/刷 RP;比赛中的提交与练习互不干扰。
输入输出约定
除非题目特别说明,一律从标准输入读、往标准输出写;行尾多余空格一般不敏感,但行数与换行必须一致。样例块就是判题数据的第一组,能过样例不等于 AC——请自己构造边界数据。
训练路线(学生册 · 三)
路线总览
| 路线 | 规模 | 适合阶段 |
|---|---|---|
| 【入门】一本通基础 396 题 | 8 章,难度 1→5 | 零基础第一站:语法 → 分支循环 → 函数递归 → 贪心 → 动规 → 数据结构 |
| 【蓝桥杯】真题训练 253 题 | 4 关,难度 3/5/6/7 | 备赛蓝桥杯:基础训练 → 算法训练 → 算法提高 → 历届真题 |
| 【进阶】XCPC 专题训练 108 题 | 9 章,难度 2→8 | 有基础后系统冲 ICPC/CCPC:前 4 章顺序解锁,5~8 章专题支线,第 9 章毕业关 |
| 八个算法专题(搜索/DP/图论/数据结构/数学/字符串/贪心构造/二分枚举) | 每专题 32 题、5 章难度分带 | 针对弱项专项补强,可随时并行开刷 |
解锁规则(重要)
- 章节是链式解锁:前一章「全部题目 AC」才点亮下一章(XCPC 的 5~8 章为并列支线,第 9 章需支线全通)。
- 章内点开题目 → 提交 → AC,返回路线页即可看到进度;工作台(见下)能看全部路线的整体完成度。
- 推荐路径:一本通入门 → 蓝桥杯(按比赛日程取舍)→ XCPC + 专题查漏。
入口:首页「训练路线」网格,或 /training 列表页。
比赛功能(学生册 · 四)
- 比赛列表:周末常设「海拔周赛」等校内赛;重要比赛会提前在讨论区公告。
- 报名:比赛详情页点「参加」(Attend)。未报名时无法在赛内提交。
- 赛内提交:从比赛题目页提交会自动带上比赛标识(tid);计分板实时更新。隐藏题在赛内以字母代号显示,不泄题面。
- 计分板:ACM 赛制按题数与罚时排名;比赛页可勾选「仅显示自己」。
- 提前离场:侧栏「提前结束」只结束你自己的比赛(此后不能再提交),不影响他人与榜单。
- 赛后:题目自动公开(autoHide 比赛);QQ 群会收到比赛终榜战报。
- Rating:校内 rated 赛的 Rating 变动显示在个人页(
/user/你的UID/rating)与 /rating 榜。
工作台与错题本(学生册 · 五)
积分 · 商店 · 徽章(学生册 · 六)
个人设置与排名(学生册 · 七)
偏好设置(/home/settings)
- 显示名(列表里显示「显示名 (用户名)」)、QQ 号(自动取 QQ 头像)、性别、简介、学校学号。
- 安全页建议开启 TOTP 两步验证(支持验证器 App 与通行密钥)。
- 主题切换:页脚「切换主题」一键在浅色/深色间切换;全站(含落地页)联动记忆你的选择;游客状态下不可切换。
RP 与排名
- 排行榜按 RP 排序:你对每道题的贡献 = min(得分,100) × 难度 / 100,全站汇总后经对数压缩(题越多边际越小);单道最简单题 AC 也有 1 点保底。
- 难度 1~10 由管理组标定,题目页可见;标签可按
category:筛选。 - 榜单每页 100 人,自己的行会高亮并带「你」徽章;翻页外也有置顶行显示你的位置。
QQ 机器人指令(学生册 · 八)
训练群 1128735782 内的机器人实时播报:AC 卡片(含耗时与算法标签、「全站第 N 人通过」)、每日累计榜 + 昨日榜(每天 0 点)、比赛实时战报与终榜,以及每周日 20:30 的 XCPC 赛程预告与重要赛事报名截止提醒。可用指令:
| 指令 | 作用 |
|---|---|
/绑定 用户名 | 把 QQ 与站内账号绑定(绑定后 AC 才会显示你的昵称/头像;换站内用户名需重新绑定) |
/oj排名 | 查询累计 AC 排行榜 |
/今日榜单 | 今天的实时做题榜(截至发出时刻) |
/最近提交 | 你(或指定绑定用户)的最近提交记录 |
/比赛排名 | 进行中/最近比赛的排名 |
/赛程 | XCPC 赛事日历(ICPC/CCPC/省赛等,进行中与即将到来,含报名截止) |
/oj状态 | 机器人与数据源健康状态 |
/oj帮助 | 指令列表 |
注:答疑群 879670443 同样可用这些指令(机器人还提供 AI 答疑)。隐藏题、比赛中的提交按规则过滤,不会泄题。
讨论区与求助(学生册 · 九)
- 讨论区节点:公告(训练计划/比赛通知)、云剪切板(贴代码求拍砖)、闲聊、问答(技术求助)。
- 发帖前读置顶《ACM 新生入门须知》《提问的智慧》;问调试问题时给全:题号、代码、判题信息、你试过什么。
- 《出题规范与数据制作教程》面向想给站里供题的同学——欢迎投稿原创题。
Markdown 速查(学生册 · 十)
题面、讨论区、个人简介、比赛说明都用 Markdown:
- 标题
# 一级~#### 四级;加粗、斜体、行内代码`code`。 - 公式:
$...$行内、$$...$$独立行(KaTeX,超长公式会被拆行显示)。 - 代码块:三反引号 + 语言名(c++/python/java…,代码高亮)。
- 列表
-/1.;引用>;链接[文字](地址);图片(讨论区可传附件)。 - 表格:
|列1|列2|换行后|---|---|再写数据行。
管理员手册(仅管理员可见)
管理员手册与后台接口速查仅对管理员账号展示——登录管理员账号后刷新本页即可查看,含账号与角色、题库维护、训练计划、比赛管理、判题排障、配置管理、部署备份安全七节。
架构与鉴权(API 册 · 一)
请求链路
浏览器 →(Cloudflare 可选)→ Caddy :443(TLS/HTTP3、缓存头、登录注册收敛改写、/user/3 封禁)→ hydrooj(127.0.0.1:8888,路由 → Handler → Model → MongoDB)→ hydrojudge(独立进程,经 /judge/files、/judge/upload 与 WebSocket /judge/conn 取任务回结果);远程题走出站中继 wss://ws.hydrooj.com(ybtbas/srqc)与 POJ 直连。
鉴权模型
- 会话:登录后种 HttpOnly Cookie
sid+sid.sig(JS 读不到,落地页登录态靠探测导航 DOM 判断)。 - 权限:
PERM_*为域级可配置权限(角色矩阵),PRIV_*为全局权限位(priv=-1 为超管)。全表「权限」列为路由声明值;未声明的按 Handler 内 checkPriv 运行时判定。 - 域前缀:几乎所有路由同时可经
/d/:domain访问(如/d/poj/p/P1000、/d/:domain/record-conn)。 - operation 分发:POST 请求在 body 带
operation=xxx时映射到 Handler 的postXxx方法(比赛建赛 405 问题的根因即漏带 operation)。 - sudo:敏感管理页要求 sudo 态——先 GET 一次目标页(写 sudoArgs)再
POST /user/sudo(password),1 小时有效。 - WebSocket 网关:
/websocket需要x-hydro-websocket-gateway头与system.websocket.secret比对;页面级 ws(record-conn 等)用会话 Cookie 鉴权。 - 服务号:判题机账号(PRIV_JUDGE)走 /judge/* 三件套;对外一切身份页面均不可见。
常用接口速查(API 册 · 二)
学生 / 前台
| 请求 | 接口 | 说明 |
|---|---|---|
| POST | /login | uname/password/rememberme[/tfa];错误 403、成功 302(UI 已门控管理员,引擎保留) |
| POST | /reg/code | mail/purpose(auto|reg|login)——发 6 位验证码(auto 按注册状态分流;响应含 registered;限速 60s/邮箱、20 次/时 IP) |
| POST | /reg/complete | mail/code/uname[/password]——验证码注册并自动登录(无密码=账号不可用密码登录) |
| POST | /reg/login | mail/code——验证码免密登录 |
| POST | /p/:pid/submit | lang/code[/tid];multipart 文件字段名必须叫 file;302 → /record/:rid |
| GET | /record/:rid | 提交详情(实时 ws 刷新) |
| GET | /ranking · /rating | RP 榜 / Rating 榜 |
| GET | /workbench/data · /mistakes/data | 工作台 / 错题本数据 JSON(需登录) |
| POST | /shop/redeem | 积分兑换徽章 |
JSON API(可直接 GET)
| 接口 | 返回 |
|---|---|
/api/rating/stats | Rating 统计 |
/api/rating/user/:uid | 单用户 Rating |
/api/user/:uid/info | 用户聚合信息 |
全量 HTTP 路由表(API 册 · 三)
共 150 条,由已部署源码静态扫描生成。列:路径 / 方法(含 operation 子操作)/ 声明权限 / 处理器 / 说明。
Hydro 核心(102)
| 路径 | 方法 | 权限 | 处理器 | 说明 |
|---|---|---|---|---|
/p/category/:category | GET | ProblemCategoryCompatHandler | 旧版分类链接兼容 | |
/contest/create | DELETE/GET;POST(op=Delete|Update) | ContestEditHandler | 建赛(operation=update + 12 字段) | |
/contest | GET | PERM_VIEW_CONTEST | ContestListHandler | 比赛列表 |
/contest/:tid | GET;POST(op=Attend|EarlyEnd|Subscribe) | PERM_VIEW_CONTEST | ContestDetailHandler | 比赛详情 / 报名(attend) / 提前离场(early_end) / 删除(delete) |
/contest/:tid/problems | GET;POST(op=Clarification) | PERM_VIEW_CONTEST | ContestProblemListHandler | 赛内题单 |
/contest/:tid/edit | DELETE/GET;POST(op=Delete|Update) | PERM_VIEW_CONTEST | ContestEditHandler | 编辑比赛(operation=update) |
/contest/:tid/print | GET/POST;POST(op=AllocatePrintTask|GetPrintTask|Print|UpdatePrintTask) | PERM_VIEW_CONTEST | ContestPrintHandler | 现场打印 |
/contest/:tid/api/printing/team | GET/POST;POST(op=AllocatePrintTask|GetPrintTask|Print|UpdatePrintTask) | PERM_VIEW_CONTEST | ContestPrintHandler | 打印 API |
/contest/:tid/management | DELETE/GET/POST/PUT;POST(op=DeleteFiles|SetScore|UploadFile) | ContestManagementHandler | 比赛管理面板 | |
/contest/:tid/clarification | GET;POST(op=Clarification) | ContestClarificationHandler | 选手提问/答疑 | |
/contest/:tid/code | GET | PERM_VIEW_CONTEST | ContestCodeHandler | 代码互看(allowViewCode) |
/contest/:tid/file/:type/:filename | GET | PERM_VIEW_CONTEST | ContestFileDownloadHandler | 比赛附件下载 |
/contest/:tid/user | GET;POST(op=AddUser|Rank|RemoveUser|Resume) | PERM_VIEW_CONTEST | ContestUserHandler | 比赛用户管理 |
/contest/:tid/balloon | GET;POST(op=Done|SetColor) | PERM_VIEW_CONTEST | ContestBalloonHandler | 气球(现场赛) |
/discuss | GET | PERM_VIEW_DISCUSSION | DiscussionMainHandler | 讨论区 |
/discuss/:did | GET/POST;POST(op=DeleteReply|DeleteTailReply|EditReply|EditTailReply|Reaction|Reply|SetLock|Star|TailReply) | DiscussionDetailHandler | 帖子详情 | |
/discuss/:did/edit | DELETE/GET;POST(op=Delete|Update) | DiscussionEditHandler | 编辑帖子 | |
/discuss/:did/raw | GET | DiscussionRawHandler | 帖子原文(编辑器用) | |
/discuss/:did/:drid/raw | GET | DiscussionRawHandler | 回复原文 | |
/discuss/:did/:drid/:drrid/raw | GET | DiscussionRawHandler | 楼中楼原文 | |
/discuss/:type/:name | GET | DiscussionNodeHandler | 节点内列表 | |
/discuss/:type/:name/create | GET/POST | PRIV_USER_PROFILE | DiscussionCreateHandler | 发帖(title/content/pin/highlight) |
/ranking | GET | PERM_VIEW_RANKING | DomainRankHandler | 域 RP 排行榜 |
/domain/dashboard | DELETE/GET;POST(op=Delete|InitDiscussionNode) | DomainDashboardHandler | 域仪表盘 | |
/domain/edit | GET/POST | DomainEditHandler | 域设置(name/bulletin/avatar/langs) | |
/domain/user | GET/POST;POST(op=Kick|SetUsers) | DomainUserHandler | 域成员管理(operation=set_users) | |
/domain/permission | GET/POST | DomainPermissionHandler | 域权限矩阵 | |
/domain/role | GET;POST(op=Add|Delete) | DomainRoleHandler | 角色定义 | |
/domain/group | GET;POST(op=Del|Update) | DomainUserGroupHandler | 小组管理 | |
/domain/join_applications | GET/POST | DomainJoinApplicationsHandler | 入域申请 | |
/domain/join | GET/POST | PRIV_USER_PROFILE | DomainJoinHandler | 加入域(target=system) |
/domain/search | GET | PRIV_USER_PROFILE | DomainSearchHandler | 域搜索 |
/ | GET | HomeHandler | 原生首页(本站被 Caddy 落地页遮蔽) | |
/home/security | DELETE/GET;POST(op=ChangeMail|ChangePassword|DeleteAllTokens|DeleteToken|DisableAuthn|DisableTfa|EnableAuthn|EnableTfa|LinkAccount|Register|UnlinkAccount) | PRIV_USER_PROFILE | HomeSecurityHandler | 安全设置(TOTP/通行密钥) |
/home/changeMail/:code | DELETE/GET | PRIV_USER_PROFILE | UserChangemailWithCodeHandler | 邮箱变更确认 |
/home/settings/:category | GET/POST | PRIV_USER_PROFILE | HomeSettingsHandler | 偏好设置(资料/显示名/主题) |
/home/avatar | POST/PUT | PRIV_USER_PROFILE | HomeAvatarHandler | 头像设置 |
/home/domain | GET;POST(op=Leave|Star) | PRIV_USER_PROFILE | HomeDomainHandler | 我的域 |
/home/domain/create | GET/POST | PRIV_CREATE_DOMAIN | HomeDomainCreateHandler | 创建域 |
/home/messages | DELETE/GET;POST(op=DeleteMessage|Send) | PRIV_USER_PROFILE | HomeMessagesHandler | 站内信 |
/homework | GET | PERM_VIEW_HOMEWORK | HomeworkMainHandler | 作业赛制(本站未启用) |
/homework/create | DELETE/GET;POST(op=Delete|Update) | HomeworkEditHandler | 建作业赛 | |
/homework/:tid | GET;POST(op=Attend) | PERM_VIEW_HOMEWORK | HomeworkDetailHandler | 作业详情 |
/homework/:tid/code | GET/POST | PERM_VIEW_HOMEWORK | ContestCodeHandler | 作业代码 |
/homework/:tid/edit | DELETE/GET;POST(op=Delete|Update) | HomeworkEditHandler | 编辑作业 | |
/homework/:tid/file | DELETE/GET/POST/PUT;POST(op=DeleteFiles|UploadFile) | PERM_VIEW_HOMEWORK | HomeworkFilesHandler | 作业附件 |
/homework/:tid/file/:type/:filename | GET/POST | PERM_VIEW_HOMEWORK | ContestFileDownloadHandler | 作业附件下载 |
/problem/import/hydro | GET/POST | PERM_CREATE_PROBLEM | ProblemImportHydroHandler | hydro.ac 官方包导题 |
/judge/files | GET/POST | PRIV_JUDGE | JudgeFilesDownloadHandler | 判题机拉取测试数据(PRIV_JUDGE) |
/judge/upload | POST | PRIV_JUDGE | JudgeFileUpdateHandler | 判题机回传文件(PRIV_JUDGE) |
/manage | GET | SystemMainHandler | 管理首页 | |
/manage/dashboard | GET;POST(op=Restart) | SystemDashboardHandler | 控制面板 | |
/manage/script | GET/POST | SystemScriptHandler | CLI 脚本运行中心 | |
/manage/setting | GET/POST | SystemSettingHandler | 系统设置 per-key(boolean 用 'on') | |
/manage/config | GET/POST | SystemConfigHandler | Config YAML(整体替换) | |
/manage/userimport | GET/POST | SystemUserImportHandler | 批量导入用户 | |
/manage/userpriv | GET/POST | SystemUserPrivHandler | 全局权限位调整 | |
/language/:lang | GET | SwitchLanguageHandler | 切换语言 | |
/file | DELETE/GET/POST/PUT;POST(op=DeleteFiles|UploadFile) | FilesHandler | 用户文件列表/管理 | |
/file/:uid/:filename | GET | FSDownloadHandler | 用户文件下载 | |
/storage | GET | StorageHandler | 存储桶管理 | |
/account/:uid | GET | PRIV_EDIT_SYSTEM | SwitchAccountHandler | 管理员切换账号 |
/heap-snapshot | POST | PRIV_EDIT_SYSTEM | HeapSnapshotHandler | V8 堆快照 |
/p | DELETE/GET;POST(op=Copy|Delete|Hide|Unhide) | PERM_VIEW_PROBLEM | ProblemMainHandler | 题库(搜索/难度/标签筛选) |
/problem/random | GET | PERM_VIEW_PROBLEM | ProblemRandomHandler | 随机一题 |
/p/:pid | DELETE/GET;POST(op=Delete|Rejudge|Star) | ProblemDetailHandler | 题目页 | |
/p/:pid/submit | GET/POST/PUT | PERM_SUBMIT_PROBLEM | ProblemSubmitHandler | 提交(lang/code[/tid]) |
/p/:pid/hack/:rid | GET/POST/PUT | PERM_SUBMIT_PROBLEM | ProblemHackHandler | Hack 提交 |
/p/:pid/edit | GET/POST | ProblemEditHandler | 题面编辑 | |
/p/:pid/config | GET | ProblemConfigHandler | 判题配置(时间/内存/checker) | |
/p/:pid/files | GET/POST;POST(op=DeleteFiles|GenerateTestdata|GetLinks|RenameFiles|UploadFile) | PERM_VIEW_PROBLEM | ProblemFilesHandler | 测试数据管理页 |
/p/:pid/file/:filename | GET | ProblemFileDownloadHandler | 题目附件(302 签名 URL) | |
/p/:pid/solution | DELETE/GET;POST(op=DeleteReply|DeleteSolution|Downvote|EditReply|EditSolution|Reply|Submit|Upvote) | PERM_VIEW_PROBLEM | ProblemSolutionHandler | 题解列表 |
/p/:pid/solution/:sid | DELETE/GET;POST(op=DeleteReply|DeleteSolution|Downvote|EditReply|EditSolution|Reply|Submit|Upvote) | PERM_VIEW_PROBLEM | ProblemSolutionHandler | 题解详情 |
/p/:pid/solution/:psid/raw | GET | PERM_VIEW_PROBLEM | ProblemSolutionRawHandler | 题解原文 |
/p/:pid/solution/:psid/:psrid/raw | GET | PERM_VIEW_PROBLEM | ProblemSolutionRawHandler | 题解回复原文 |
/p/:pid/stat | GET | PERM_VIEW_PROBLEM | ProblemStatisticsHandler | 题目提交统计 |
/problem/create | GET/POST | PERM_CREATE_PROBLEM | ProblemCreateHandler | 创建题目 |
/record | GET | RecordListHandler | 提交记录列表(?uidOrName 筛选;匿名登录墙) | |
/record/:rid | GET/POST;POST(op=Cancel|Judge|Rejudge) | RecordDetailHandler | 记录详情 / 重判(operation=rejudge) | |
/status | GET | StatusHandler | 实例状态页 | |
/status/update | POST | StatusUpdateHandler | 状态刷新 | |
/training | DELETE/GET | PERM_VIEW_TRAINING | TrainingMainHandler | 训练计划列表 |
/training/create | GET/POST | TrainingEditHandler | 建训练计划(title/content/description/dag/pin) | |
/training/:tid | DELETE/GET;POST(op=Delete|Enroll) | PERM_VIEW_TRAINING | TrainingDetailHandler | 计划详情(章节 DAG) |
/training/:tid/edit | GET/POST | TrainingEditHandler | 编辑计划 | |
/training/:tid/file | DELETE/GET/POST/PUT;POST(op=DeleteFiles|UploadFile) | PERM_VIEW_TRAINING | TrainingFilesHandler | 计划附件 |
/training/:tid/file/:filename | GET | PERM_VIEW_TRAINING | TrainingFileDownloadHandler | 计划附件下载 |
/login | DELETE/GET/POST | UserLoginHandler | 密码登录(uname/password;403/302) | |
/oauth/:type/login | GET | OauthHandler | OAuth 跳转(type=github) | |
/user/sudo | DELETE/GET/POST | PRIV_USER_PROFILE | UserSudoHandler | 激活 sudo(password) |
/user/tfa | GET | UserTFAHandler | 两步验证 | |
/user/webauthn | DELETE/GET/POST | UserWebauthnHandler | 通行密钥 | |
/oauth/:type/callback | GET | OauthCallbackHandler | OAuth 回调 | |
/register | GET/POST | PRIV_REGISTER_USER | UserRegisterHandler | 注册第一步(mail) |
/register/:code | DELETE/GET/POST | PRIV_REGISTER_USER | UserRegisterWithCodeHandler | 注册第二步(uname/password) |
/logout | GET/POST | PRIV_USER_PROFILE | UserLogoutHandler | 登出 |
/lostpass | GET/POST | UserLostPassHandler | 忘记密码(mail;防枚举) | |
/lostpass/:code | DELETE/GET/POST | UserLostPassWithCodeHandler | 重置密码 | |
/user/delete | POST | PRIV_USER_PROFILE | UserDeleteHandler | 注销账号 |
/user/:uid | GET | UserDetailHandler | 用户主页 | |
/contestmode | GET;POST(op=Reset) | PRIV_EDIT_SYSTEM | ContestModeHandler | 比赛模式开关 |
官方 UI (ui-default)(9)
| 路径 | 方法 | 权限 | 处理器 | 说明 |
|---|---|---|---|---|
/manage/config/schema.json | GET | PRIV_EDIT_SYSTEM | SystemConfigSchemaHandler | 配置 Schema JSON |
/wiki/help | GET | WikiHelpHandler | 本帮助页 | |
/wiki/about | GET | WikiAboutHandler | 关于页(实验室介绍) | |
/set_theme/:theme | GET | SetThemeHandler | 切换主题(light/dark) | |
/legacy | GET | LegacyModeHandler | 旧版兼容入口 | |
/markdown | POST | MarkdownHandler | Markdown 渲染(预览) | |
/media | GET/POST | RichMediaHandler | 媒体代理/上传 | |
/lazy/:version/:name | GET/POST | UiConstantsHandler | 版本化前端资源(7 天缓存) | |
/resource/:version/:name | GET/POST | UiConstantsHandler | 版本化资源(7 天缓存) |
官方插件 (fps-importer)(1)
| 路径 | 方法 | 权限 | 处理器 | 说明 |
|---|---|---|---|---|
/problem/import/fps | GET/POST | PERM_CREATE_PROBLEM | FpsProblemImportHandler | FPS 包导题(丢 spj/不查重/zip 坑) |
自研插件 swpu-regcode(4)
| 路径 | 方法 | 权限 | 处理器 | 说明 |
|---|---|---|---|---|
/reg | GET | RegPageHandler | 一站式注册/登录页(tab=reg|login|pwd&return=) | |
/reg/code | GET/POST | RegCodeHandler | 发验证码(mail/purpose) | |
/reg/complete | GET/POST | PRIV_REGISTER_USER | RegCompleteHandler | 验证码注册(mail/code/uname/password) |
/reg/login | GET/POST | CodeLoginHandler | 验证码免密登录(mail/code) |
自研插件 swpu-train(7)
| 路径 | 方法 | 权限 | 处理器 | 说明 |
|---|---|---|---|---|
/workbench | GET | PRIV_USER_PROFILE | WorkbenchPageHandler | 训练工作台页 |
/workbench/data | GET | PRIV_USER_PROFILE | WorkbenchDataHandler | 工作台数据 JSON |
/mistakes | GET | PRIV_USER_PROFILE | MistakesPageHandler | 错题本页 |
/mistakes/data | GET | PRIV_USER_PROFILE | MistakesDataHandler | 错题列表 JSON |
/mistakes/update | POST | PRIV_USER_PROFILE | MistakesUpdateHandler | 更新错题状态 |
/mistakes/remove | POST | PRIV_USER_PROFILE | MistakesRemoveHandler | 移除错题 |
/mistakes/sync | POST | PRIV_USER_PROFILE | MistakesSyncHandler | 从 record 同步错题 |
自研插件 swpu-shop(5)
| 路径 | 方法 | 权限 | 处理器 | 说明 |
|---|---|---|---|---|
/shop | GET | ShopPageHandler | 积分商店页 | |
/shop/redeem | GET/POST | PRIV_USER_PROFILE | ShopRedeemHandler | 积分兑换徽章 |
/shop/history | GET | PRIV_USER_PROFILE | ShopHistoryHandler | 积分流水 JSON |
/manage/shop | GET | PRIV_MANAGE_ALL_DOMAIN | ShopManageHandler | 商店管理/定价 |
/manage/shop | GET/POST | PRIV_MANAGE_ALL_DOMAIN | ShopManageSaveHandler | 商店管理/定价 |
社区插件 user-management(2)
| 路径 | 方法 | 权限 | 处理器 | 说明 |
|---|---|---|---|---|
/manage/users | GET | PRIV_EDIT_SYSTEM | UserManageMainHandler | 用户管理列表 |
/manage/users/:uid | GET/POST;POST(op=Ban|Edit|ResetPassword|SetPriv|Unban) | PRIV_EDIT_SYSTEM | UserManageDetailHandler | 用户详情/编辑(operation=edit 改名) |
社区插件 rating-system(8)
| 路径 | 方法 | 权限 | 处理器 | 说明 |
|---|---|---|---|---|
/rating | GET | PERM_VIEW_RANKING | RatingListHandler | Rating 榜 |
/user/:uid/rating | GET | UserRatingHandler | 用户 Rating 页 | |
/manage/rating | GET;POST(op=UpdateRating) | PRIV_EDIT_SYSTEM | RatingManageHandler | Rating 管理/CSV 导入 |
/manage/user-rating | GET/POST;POST(op=InitializeAll|InitializeUser|ModifyContest|RemoveContest) | PRIV_EDIT_SYSTEM | UserRatingManageHandler | 用户 Rating 调整 |
/manage/rating/contest | GET;POST(op=ImportContest|RevertLast) | PRIV_EDIT_SYSTEM | ContestRatingComputeHandler | 比赛 Rating 计算 |
/api/rating/stats | GET | PERM_VIEW_RANKING | RatingStatsHandler | Rating 统计 JSON |
/api/rating/user/:uid | GET | RatingUserApiHandler | 用户 Rating JSON | |
/api/user/:uid/info | GET | UserInfoApiHandler | 用户聚合信息 JSON |
社区插件 badge(5)
| 路径 | 方法 | 权限 | 处理器 | 说明 |
|---|---|---|---|---|
/manage/badge | GET | PRIV_MANAGE_ALL_DOMAIN | BadgeManageHandler | 徽章管理 |
/badge/add | GET;POST(op=Add) | PRIV_MANAGE_ALL_DOMAIN | BadgeAddHandler | 新建徽章 |
/badge/:id/edit | GET;POST(op=Delete|Update) | PRIV_MANAGE_ALL_DOMAIN | BadgeEditHandler | 编辑徽章 |
/badge/:id | GET | BadgeDetailHandler | 徽章详情 | |
/mybadge | GET;POST(op=Enable|Reset) | PRIV_USER_PROFILE | UserBadgeManageHandler | 我的徽章(持有/佩戴) |
官方中继 hydroac-client(7)
| 路径 | 方法 | 权限 | 处理器 | 说明 |
|---|---|---|---|---|
/lsp-set | GET/POST | PRIV_EDIT_SYSTEM | t4 | LSP 订阅主机设置(host) |
/contest/:tid/hydroac-sim | GET/POST | Mm | 比赛代码相似度榜 | |
/hydroac/sim_code/:rid | GET/POST | i4 | 相似度代码查看 | |
/manage/hydroac-sim | GET/POST | PRIV_EDIT_SYSTEM | ey | sim OAuth 管理 |
/manage/luogu-api | GET/POST | PRIV_EDIT_SYSTEM | e_ | 洛谷 API 中转配置 |
/problem/quickimport | GET/POST | PERM_CREATE_PROBLEM | rE | 从 hydro.ac 快速拉题 |
/manage/official-addon | GET/POST | PRIV_EDIT_SYSTEM | oE | 官方插件管理 |
WebSocket 与网关层(API 册 · 四)
WebSocket 接口
| 路径 | 鉴权 | 说明 |
|---|---|---|
/websocket | 网关令牌头 | 通用事件网关(多实例事件总线) |
/record-conn(域前缀可用) | 会话 | 记录列表实时状态推送 |
/record-detail-conn | 会话 | 单条记录详情实时流(判题输出) |
/judge/conn | PRIV_JUDGE | 判题机注册/心跳/取任务 |
/manage/check-conn | PRIV_EDIT_SYSTEM + sudo | 控制面板健康检查实时流 |
/realboard-conn | 现场赛权限 | onsite 投屏榜单推送 |
wss://ws.hydrooj.com/websocket | —(出站) | hydroac 远程判题中继(ybtbas/srqc),断线自动重连 |
wss://lsp.hydrooj.com | —(出站) | 在线 IDE 代码补全(lsp-set 配置) |
Caddy 网关规则(对接口行为的影响)
| 规则 | 行为 |
|---|---|
| 域名 | dfacm.website / www / swpuacm.xyz / www 同站(正式域名 dfacm.website);HTTP→308→HTTPS;HTTP/3(QUIC) 已开放 |
| 登录收敛 | GET /login(无 query)内部改写到 /reg?tab=pwd;POST /login 与带 query 的 GET 不受影响 |
| 注册收敛 | GET /register(无 query)302 → /reg |
| 服务号隐身 | /user/3 → 404 |
| 落地页 | / → /home.html(custom 资产清单直出;原生首页被遮蔽——倒计时挂件已随 countdown 插件一并移除) |
| 缓存 | 静态资源 7 天;theme css 10 分钟;custom 资产 1 小时;home.html 不缓存;仅 2xx 打缓存头 |
| 真实 IP | trusted_proxies=Cloudflare 段 + XFF 钉扎(@fromcf/@direct 分流) |
集成示例(API 册 · 五)
HTTP 提交一条代码(判题机/管理会话)
# 1. 登录拿会话(错误凭证返回 403,成功 302)
curl -s -c /tmp/cj -X POST https://dfacm.website/login \
--data-urlencode "uname=用户名" --data-urlencode "password=密码"
# 2. 提交(multipart 文件字段名必须是 file;code 用文本字段亦可)
curl -s -b /tmp/cj -X POST https://dfacm.website/p/5/submit \
-F "lang=cc.cc17o2" -F "[email protected]"
# 302 的 Location 即 /record/<rid>
重判一条记录
curl -s -b /tmp/cj -X POST https://dfacm.website/record/<rid> \
--data-urlencode "operation=rejudge" # 302 即受理
机器人 / 外部系统接入建议
- 播报类集成不走 HTTP:QQ 机器人用只读 Mongo 账号直连(15 秒增量水位 + 非终态近窗复查),登录墙零改动、不给 Web 层加压。
- 需要 JSON 的轻量集成用
/api/rating/*与/api/user/:uid/info。 - 批量抓页面务必限速:突发并发会触发 403(审计实测 16 并发过半被拦,降到 4 并发正常)。
- 比赛直播/终榜语义:带 tid 的提交与练习去重隔离;隐藏题只出字母代号。
本文档 2026-10-12 编制;全量路由表由已部署源码静态扫描生成(150 条 HTTP + 8 条 WS)。文档修订:改仓库 deploy/wiki-help/wiki_help.html 后重放(见部署手册),或联系站长。