导读

本页是 d&f算法网 的完整使用文档,共三册:学生使用手册(注册、做题、训练、比赛、工具)、管理员手册(题库、比赛、配置、运维)、API 接口文档(面向开发者,含全站 150 条路由表)。

  • 新生请按顺序读:注册与登录 → 做题与判题 → 训练路线。
  • 答疑互助群:QQ 879670443(提问前先看讨论区《提问的智慧》);训练播报群:QQ 1128735782(AC 实时播报、每日榜单、比赛战报)。
  • 站内每一页右上角搜索框可搜题库;帮助页入口在页脚「使用文档」链接。

登录与注册(学生册 · 一)

一个邮箱地址,验证码直达

点击任意页面的「登录/注册」,都会进入 /reg 单页流程——没有密码,靠邮箱验证码直达:

  1. 输入邮箱 → 点「获取验证码」→ 邮箱收到 6 位数字(5 分钟内有效,输错 5 次作废;单邮箱 60 秒 1 次,同 IP 每小时 20 次)。
  2. 输入验证码 → 系统自动判断:已注册则直接登录进入 return 页;未注册则出现用户名栏,填完即完成注册并自动登录、跳转入门路线。
  3. 也支持 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)11Hack 成功
4超出内存限制(MLE)20/21/22判题中 / 编译中 / 已取到(判题机已领取任务;远程题在此停留较久)
5输出超出限制31格式错误(多/少空格换行等)
6运行时错误(RE,崩溃/越界)32/33Hack 成功 / 失败
  • 时间按 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 榜。

工作台与错题本(学生册 · 五)

  • 训练工作台:登录后自动汇总你在各条训练路线的章节进度、AC 率与最近提交,是每天打开的第一个页面。
  • 错题本:每次 WA 会自动收录;补题 AC 后自动标记「已解决」,也可手动更新/移除。刷错题 > 刷新题。
  • 工作台与错题本仅登录用户可见(未登录访问会先跳登录)。

积分 · 商店 · 徽章(学生册 · 六)

  • 赚积分:每道题首次 AC 按题目难度入账 1~10 分(难度 1 题=1 分,难度 10 题=10 分;远程题同算)。
  • 积分商店:用积分兑换站内徽章,兑换即永久持有;积分流水可查每一笔进出。
  • 我的徽章:选择一枚「佩戴」后,你的提交记录旁会展示徽章。
  • 徽章由管理员上架定价,新徽章上架会在讨论区公告。

个人设置与排名(学生册 · 七)

偏好设置(/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/loginuname/password/rememberme[/tfa];错误 403、成功 302(UI 已门控管理员,引擎保留)
POST/reg/codemail/purpose(auto|reg|login)——发 6 位验证码(auto 按注册状态分流;响应含 registered;限速 60s/邮箱、20 次/时 IP)
POST/reg/completemail/code/uname[/password]——验证码注册并自动登录(无密码=账号不可用密码登录)
POST/reg/loginmail/code——验证码免密登录
POST/p/:pid/submitlang/code[/tid];multipart 文件字段名必须叫 file;302 → /record/:rid
GET/record/:rid提交详情(实时 ws 刷新)
GET/ranking · /ratingRP 榜 / Rating 榜
GET/workbench/data · /mistakes/data工作台 / 错题本数据 JSON(需登录)
POST/shop/redeem积分兑换徽章

JSON API(可直接 GET)

接口返回
/api/rating/statsRating 统计
/api/rating/user/:uid单用户 Rating
/api/user/:uid/info用户聚合信息

全量 HTTP 路由表(API 册 · 三)

共 150 条,由已部署源码静态扫描生成。列:路径 / 方法(含 operation 子操作)/ 声明权限 / 处理器 / 说明。

Hydro 核心(102)

路径方法权限处理器说明
/p/category/:categoryGETProblemCategoryCompatHandler旧版分类链接兼容
/contest/createDELETE/GET;POST(op=Delete|Update)ContestEditHandler建赛(operation=update + 12 字段)
/contestGETPERM_VIEW_CONTESTContestListHandler比赛列表
/contest/:tidGET;POST(op=Attend|EarlyEnd|Subscribe)PERM_VIEW_CONTESTContestDetailHandler比赛详情 / 报名(attend) / 提前离场(early_end) / 删除(delete)
/contest/:tid/problemsGET;POST(op=Clarification)PERM_VIEW_CONTESTContestProblemListHandler赛内题单
/contest/:tid/editDELETE/GET;POST(op=Delete|Update)PERM_VIEW_CONTESTContestEditHandler编辑比赛(operation=update)
/contest/:tid/printGET/POST;POST(op=AllocatePrintTask|GetPrintTask|Print|UpdatePrintTask)PERM_VIEW_CONTESTContestPrintHandler现场打印
/contest/:tid/api/printing/teamGET/POST;POST(op=AllocatePrintTask|GetPrintTask|Print|UpdatePrintTask)PERM_VIEW_CONTESTContestPrintHandler打印 API
/contest/:tid/managementDELETE/GET/POST/PUT;POST(op=DeleteFiles|SetScore|UploadFile)ContestManagementHandler比赛管理面板
/contest/:tid/clarificationGET;POST(op=Clarification)ContestClarificationHandler选手提问/答疑
/contest/:tid/codeGETPERM_VIEW_CONTESTContestCodeHandler代码互看(allowViewCode)
/contest/:tid/file/:type/:filenameGETPERM_VIEW_CONTESTContestFileDownloadHandler比赛附件下载
/contest/:tid/userGET;POST(op=AddUser|Rank|RemoveUser|Resume)PERM_VIEW_CONTESTContestUserHandler比赛用户管理
/contest/:tid/balloonGET;POST(op=Done|SetColor)PERM_VIEW_CONTESTContestBalloonHandler气球(现场赛)
/discussGETPERM_VIEW_DISCUSSIONDiscussionMainHandler讨论区
/discuss/:didGET/POST;POST(op=DeleteReply|DeleteTailReply|EditReply|EditTailReply|Reaction|Reply|SetLock|Star|TailReply)DiscussionDetailHandler帖子详情
/discuss/:did/editDELETE/GET;POST(op=Delete|Update)DiscussionEditHandler编辑帖子
/discuss/:did/rawGETDiscussionRawHandler帖子原文(编辑器用)
/discuss/:did/:drid/rawGETDiscussionRawHandler回复原文
/discuss/:did/:drid/:drrid/rawGETDiscussionRawHandler楼中楼原文
/discuss/:type/:nameGETDiscussionNodeHandler节点内列表
/discuss/:type/:name/createGET/POSTPRIV_USER_PROFILEDiscussionCreateHandler发帖(title/content/pin/highlight)
/rankingGETPERM_VIEW_RANKINGDomainRankHandler域 RP 排行榜
/domain/dashboardDELETE/GET;POST(op=Delete|InitDiscussionNode)DomainDashboardHandler域仪表盘
/domain/editGET/POSTDomainEditHandler域设置(name/bulletin/avatar/langs)
/domain/userGET/POST;POST(op=Kick|SetUsers)DomainUserHandler域成员管理(operation=set_users)
/domain/permissionGET/POSTDomainPermissionHandler域权限矩阵
/domain/roleGET;POST(op=Add|Delete)DomainRoleHandler角色定义
/domain/groupGET;POST(op=Del|Update)DomainUserGroupHandler小组管理
/domain/join_applicationsGET/POSTDomainJoinApplicationsHandler入域申请
/domain/joinGET/POSTPRIV_USER_PROFILEDomainJoinHandler加入域(target=system)
/domain/searchGETPRIV_USER_PROFILEDomainSearchHandler域搜索
/GETHomeHandler原生首页(本站被 Caddy 落地页遮蔽)
/home/securityDELETE/GET;POST(op=ChangeMail|ChangePassword|DeleteAllTokens|DeleteToken|DisableAuthn|DisableTfa|EnableAuthn|EnableTfa|LinkAccount|Register|UnlinkAccount)PRIV_USER_PROFILEHomeSecurityHandler安全设置(TOTP/通行密钥)
/home/changeMail/:codeDELETE/GETPRIV_USER_PROFILEUserChangemailWithCodeHandler邮箱变更确认
/home/settings/:categoryGET/POSTPRIV_USER_PROFILEHomeSettingsHandler偏好设置(资料/显示名/主题)
/home/avatarPOST/PUTPRIV_USER_PROFILEHomeAvatarHandler头像设置
/home/domainGET;POST(op=Leave|Star)PRIV_USER_PROFILEHomeDomainHandler我的域
/home/domain/createGET/POSTPRIV_CREATE_DOMAINHomeDomainCreateHandler创建域
/home/messagesDELETE/GET;POST(op=DeleteMessage|Send)PRIV_USER_PROFILEHomeMessagesHandler站内信
/homeworkGETPERM_VIEW_HOMEWORKHomeworkMainHandler作业赛制(本站未启用)
/homework/createDELETE/GET;POST(op=Delete|Update)HomeworkEditHandler建作业赛
/homework/:tidGET;POST(op=Attend)PERM_VIEW_HOMEWORKHomeworkDetailHandler作业详情
/homework/:tid/codeGET/POSTPERM_VIEW_HOMEWORKContestCodeHandler作业代码
/homework/:tid/editDELETE/GET;POST(op=Delete|Update)HomeworkEditHandler编辑作业
/homework/:tid/fileDELETE/GET/POST/PUT;POST(op=DeleteFiles|UploadFile)PERM_VIEW_HOMEWORKHomeworkFilesHandler作业附件
/homework/:tid/file/:type/:filenameGET/POSTPERM_VIEW_HOMEWORKContestFileDownloadHandler作业附件下载
/problem/import/hydroGET/POSTPERM_CREATE_PROBLEMProblemImportHydroHandlerhydro.ac 官方包导题
/judge/filesGET/POSTPRIV_JUDGEJudgeFilesDownloadHandler判题机拉取测试数据(PRIV_JUDGE)
/judge/uploadPOSTPRIV_JUDGEJudgeFileUpdateHandler判题机回传文件(PRIV_JUDGE)
/manageGETSystemMainHandler管理首页
/manage/dashboardGET;POST(op=Restart)SystemDashboardHandler控制面板
/manage/scriptGET/POSTSystemScriptHandlerCLI 脚本运行中心
/manage/settingGET/POSTSystemSettingHandler系统设置 per-key(boolean 用 'on')
/manage/configGET/POSTSystemConfigHandlerConfig YAML(整体替换)
/manage/userimportGET/POSTSystemUserImportHandler批量导入用户
/manage/userprivGET/POSTSystemUserPrivHandler全局权限位调整
/language/:langGETSwitchLanguageHandler切换语言
/fileDELETE/GET/POST/PUT;POST(op=DeleteFiles|UploadFile)FilesHandler用户文件列表/管理
/file/:uid/:filenameGETFSDownloadHandler用户文件下载
/storageGETStorageHandler存储桶管理
/account/:uidGETPRIV_EDIT_SYSTEMSwitchAccountHandler管理员切换账号
/heap-snapshotPOSTPRIV_EDIT_SYSTEMHeapSnapshotHandlerV8 堆快照
/pDELETE/GET;POST(op=Copy|Delete|Hide|Unhide)PERM_VIEW_PROBLEMProblemMainHandler题库(搜索/难度/标签筛选)
/problem/randomGETPERM_VIEW_PROBLEMProblemRandomHandler随机一题
/p/:pidDELETE/GET;POST(op=Delete|Rejudge|Star)ProblemDetailHandler题目页
/p/:pid/submitGET/POST/PUTPERM_SUBMIT_PROBLEMProblemSubmitHandler提交(lang/code[/tid])
/p/:pid/hack/:ridGET/POST/PUTPERM_SUBMIT_PROBLEMProblemHackHandlerHack 提交
/p/:pid/editGET/POSTProblemEditHandler题面编辑
/p/:pid/configGETProblemConfigHandler判题配置(时间/内存/checker)
/p/:pid/filesGET/POST;POST(op=DeleteFiles|GenerateTestdata|GetLinks|RenameFiles|UploadFile)PERM_VIEW_PROBLEMProblemFilesHandler测试数据管理页
/p/:pid/file/:filenameGETProblemFileDownloadHandler题目附件(302 签名 URL)
/p/:pid/solutionDELETE/GET;POST(op=DeleteReply|DeleteSolution|Downvote|EditReply|EditSolution|Reply|Submit|Upvote)PERM_VIEW_PROBLEMProblemSolutionHandler题解列表
/p/:pid/solution/:sidDELETE/GET;POST(op=DeleteReply|DeleteSolution|Downvote|EditReply|EditSolution|Reply|Submit|Upvote)PERM_VIEW_PROBLEMProblemSolutionHandler题解详情
/p/:pid/solution/:psid/rawGETPERM_VIEW_PROBLEMProblemSolutionRawHandler题解原文
/p/:pid/solution/:psid/:psrid/rawGETPERM_VIEW_PROBLEMProblemSolutionRawHandler题解回复原文
/p/:pid/statGETPERM_VIEW_PROBLEMProblemStatisticsHandler题目提交统计
/problem/createGET/POSTPERM_CREATE_PROBLEMProblemCreateHandler创建题目
/recordGETRecordListHandler提交记录列表(?uidOrName 筛选;匿名登录墙)
/record/:ridGET/POST;POST(op=Cancel|Judge|Rejudge)RecordDetailHandler记录详情 / 重判(operation=rejudge)
/statusGETStatusHandler实例状态页
/status/updatePOSTStatusUpdateHandler状态刷新
/trainingDELETE/GETPERM_VIEW_TRAININGTrainingMainHandler训练计划列表
/training/createGET/POSTTrainingEditHandler建训练计划(title/content/description/dag/pin)
/training/:tidDELETE/GET;POST(op=Delete|Enroll)PERM_VIEW_TRAININGTrainingDetailHandler计划详情(章节 DAG)
/training/:tid/editGET/POSTTrainingEditHandler编辑计划
/training/:tid/fileDELETE/GET/POST/PUT;POST(op=DeleteFiles|UploadFile)PERM_VIEW_TRAININGTrainingFilesHandler计划附件
/training/:tid/file/:filenameGETPERM_VIEW_TRAININGTrainingFileDownloadHandler计划附件下载
/loginDELETE/GET/POSTUserLoginHandler密码登录(uname/password;403/302)
/oauth/:type/loginGETOauthHandlerOAuth 跳转(type=github)
/user/sudoDELETE/GET/POSTPRIV_USER_PROFILEUserSudoHandler激活 sudo(password)
/user/tfaGETUserTFAHandler两步验证
/user/webauthnDELETE/GET/POSTUserWebauthnHandler通行密钥
/oauth/:type/callbackGETOauthCallbackHandlerOAuth 回调
/registerGET/POSTPRIV_REGISTER_USERUserRegisterHandler注册第一步(mail)
/register/:codeDELETE/GET/POSTPRIV_REGISTER_USERUserRegisterWithCodeHandler注册第二步(uname/password)
/logoutGET/POSTPRIV_USER_PROFILEUserLogoutHandler登出
/lostpassGET/POSTUserLostPassHandler忘记密码(mail;防枚举)
/lostpass/:codeDELETE/GET/POSTUserLostPassWithCodeHandler重置密码
/user/deletePOSTPRIV_USER_PROFILEUserDeleteHandler注销账号
/user/:uidGETUserDetailHandler用户主页
/contestmodeGET;POST(op=Reset)PRIV_EDIT_SYSTEMContestModeHandler比赛模式开关

官方 UI (ui-default)(9)

路径方法权限处理器说明
/manage/config/schema.jsonGETPRIV_EDIT_SYSTEMSystemConfigSchemaHandler配置 Schema JSON
/wiki/helpGETWikiHelpHandler本帮助页
/wiki/aboutGETWikiAboutHandler关于页(实验室介绍)
/set_theme/:themeGETSetThemeHandler切换主题(light/dark)
/legacyGETLegacyModeHandler旧版兼容入口
/markdownPOSTMarkdownHandlerMarkdown 渲染(预览)
/mediaGET/POSTRichMediaHandler媒体代理/上传
/lazy/:version/:nameGET/POSTUiConstantsHandler版本化前端资源(7 天缓存)
/resource/:version/:nameGET/POSTUiConstantsHandler版本化资源(7 天缓存)

官方插件 (fps-importer)(1)

路径方法权限处理器说明
/problem/import/fpsGET/POSTPERM_CREATE_PROBLEMFpsProblemImportHandlerFPS 包导题(丢 spj/不查重/zip 坑)

自研插件 swpu-regcode(4)

路径方法权限处理器说明
/regGETRegPageHandler一站式注册/登录页(tab=reg|login|pwd&return=)
/reg/codeGET/POSTRegCodeHandler发验证码(mail/purpose)
/reg/completeGET/POSTPRIV_REGISTER_USERRegCompleteHandler验证码注册(mail/code/uname/password)
/reg/loginGET/POSTCodeLoginHandler验证码免密登录(mail/code)

自研插件 swpu-train(7)

路径方法权限处理器说明
/workbenchGETPRIV_USER_PROFILEWorkbenchPageHandler训练工作台页
/workbench/dataGETPRIV_USER_PROFILEWorkbenchDataHandler工作台数据 JSON
/mistakesGETPRIV_USER_PROFILEMistakesPageHandler错题本页
/mistakes/dataGETPRIV_USER_PROFILEMistakesDataHandler错题列表 JSON
/mistakes/updatePOSTPRIV_USER_PROFILEMistakesUpdateHandler更新错题状态
/mistakes/removePOSTPRIV_USER_PROFILEMistakesRemoveHandler移除错题
/mistakes/syncPOSTPRIV_USER_PROFILEMistakesSyncHandler从 record 同步错题

自研插件 swpu-shop(5)

路径方法权限处理器说明
/shopGETShopPageHandler积分商店页
/shop/redeemGET/POSTPRIV_USER_PROFILEShopRedeemHandler积分兑换徽章
/shop/historyGETPRIV_USER_PROFILEShopHistoryHandler积分流水 JSON
/manage/shopGETPRIV_MANAGE_ALL_DOMAINShopManageHandler商店管理/定价
/manage/shopGET/POSTPRIV_MANAGE_ALL_DOMAINShopManageSaveHandler商店管理/定价

社区插件 user-management(2)

路径方法权限处理器说明
/manage/usersGETPRIV_EDIT_SYSTEMUserManageMainHandler用户管理列表
/manage/users/:uidGET/POST;POST(op=Ban|Edit|ResetPassword|SetPriv|Unban)PRIV_EDIT_SYSTEMUserManageDetailHandler用户详情/编辑(operation=edit 改名)

社区插件 rating-system(8)

路径方法权限处理器说明
/ratingGETPERM_VIEW_RANKINGRatingListHandlerRating 榜
/user/:uid/ratingGETUserRatingHandler用户 Rating 页
/manage/ratingGET;POST(op=UpdateRating)PRIV_EDIT_SYSTEMRatingManageHandlerRating 管理/CSV 导入
/manage/user-ratingGET/POST;POST(op=InitializeAll|InitializeUser|ModifyContest|RemoveContest)PRIV_EDIT_SYSTEMUserRatingManageHandler用户 Rating 调整
/manage/rating/contestGET;POST(op=ImportContest|RevertLast)PRIV_EDIT_SYSTEMContestRatingComputeHandler比赛 Rating 计算
/api/rating/statsGETPERM_VIEW_RANKINGRatingStatsHandlerRating 统计 JSON
/api/rating/user/:uidGETRatingUserApiHandler用户 Rating JSON
/api/user/:uid/infoGETUserInfoApiHandler用户聚合信息 JSON

社区插件 badge(5)

路径方法权限处理器说明
/manage/badgeGETPRIV_MANAGE_ALL_DOMAINBadgeManageHandler徽章管理
/badge/addGET;POST(op=Add)PRIV_MANAGE_ALL_DOMAINBadgeAddHandler新建徽章
/badge/:id/editGET;POST(op=Delete|Update)PRIV_MANAGE_ALL_DOMAINBadgeEditHandler编辑徽章
/badge/:idGETBadgeDetailHandler徽章详情
/mybadgeGET;POST(op=Enable|Reset)PRIV_USER_PROFILEUserBadgeManageHandler我的徽章(持有/佩戴)

官方中继 hydroac-client(7)

路径方法权限处理器说明
/lsp-setGET/POSTPRIV_EDIT_SYSTEMt4LSP 订阅主机设置(host)
/contest/:tid/hydroac-simGET/POSTMm比赛代码相似度榜
/hydroac/sim_code/:ridGET/POSTi4相似度代码查看
/manage/hydroac-simGET/POSTPRIV_EDIT_SYSTEMeysim OAuth 管理
/manage/luogu-apiGET/POSTPRIV_EDIT_SYSTEMe_洛谷 API 中转配置
/problem/quickimportGET/POSTPERM_CREATE_PROBLEMrE从 hydro.ac 快速拉题
/manage/official-addonGET/POSTPRIV_EDIT_SYSTEMoE官方插件管理

WebSocket 与网关层(API 册 · 四)

WebSocket 接口

路径鉴权说明
/websocket网关令牌头通用事件网关(多实例事件总线)
/record-conn(域前缀可用)会话记录列表实时状态推送
/record-detail-conn会话单条记录详情实时流(判题输出)
/judge/connPRIV_JUDGE判题机注册/心跳/取任务
/manage/check-connPRIV_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 打缓存头
真实 IPtrusted_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 后重放(见部署手册),或联系站长。