refactor(契约): 前端 60 个写请求的请求体接上契约类型，前后端对不上编译期就报

- 前端 oj/api.ts、admin/api.ts、shared/api.ts 的 post / put 请求体一律 `satisfies XxxRequest`，
  只在编译期检查，不加运行时校验（和「只在三处挂运行时闸门」的规矩一致）
- 契约里的 XxxRequest 从 z.infer 改成 z.input：请求类型描述的是「客户端可以发什么」，
  带默认值的字段可以不传。后端从不用这些类型（它用 parse 出来的 data），不受影响
- 补了四个漏导出的请求类型（比赛题目排序、题单题目排序、标签分类、检查用户名）
- 接上之后对不上的几处：编辑用户的角色和题目权限经 toAdminType / toProblemPermission
  收窄，导入用户的行改成四元组，练习题数据改成 Record，格式化的语言只收后端认的四种
  （isFormatLanguage）。出题页和成就的请求体是「表单校验兜底、出站补默认值」，
  用 Partial<…> 只核键名和值的类型

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

apps/web/src/admin/api.ts

@@ -1,3 +1,44 @@
+import { toAdminType, toProblemPermission } from "@oj2/contract"
+import type {
+  AddContestProblemRequest,
+  AddProblemsToSetRequest,
+  BatchProblemTagRequest,
+  BatchProblemVisibleRequest,
+  CheckUsernamesRequest,
+  CreateAchievementRequest,
+  CreateAnnouncementRequest,
+  CreateContestRequest,
+  CreateExerciseRequest,
+  CreateProblemRequest,
+  CreateProblemSetBadgeRequest,
+  CreateProblemSetRequest,
+  CreateTutorialRequest,
+  GenerateFlowchartRequest,
+  GenerateSqlTestCaseRequest,
+  ImportUsersRequest,
+  MakeProblemPublicRequest,
+  RenameTagRequest,
+  RenameTutorialProjectRequest,
+  ReorderContestProblemsRequest,
+  ReorderProblemSetProblemsRequest,
+  ReorderTutorialsRequest,
+  SetTagCategoryRequest,
+  SetTutorialProblemsRequest,
+  SetTutorialVisibilityRequest,
+  SqlPreviewRequest,
+  UpdateAchievementRequest,
+  UpdateAcmHelperRequest,
+  UpdateAnnouncementRequest,
+  UpdateContestRequest,
+  UpdateExerciseRequest,
+  UpdateProblemInSetRequest,
+  UpdateProblemRequest,
+  UpdateProblemSetBadgeRequest,
+  UpdateProblemSetRequest,
+  UpdateTutorialRequest,
+  UpdateUserRequest,
+  UpdateWebsiteConfigRequest,
+} from "@oj2/contract"
 import api from "utils/api"
 import { toAdminProblemRow } from "admin/transforms"
 import type {
@@ -101,7 +142,7 @@ export function batchSetProblemVisible(problemIds: number[], visible: boolean) {
   return api.post<{ problemCount: number }>("admin/problems/batch-visible", {
     problemIds,
     visible,
-  })
+  } satisfies BatchProblemVisibleRequest)
 }
 
 // 比赛「从题库中选择」用：列所有可见的公开题，不只是自己创建的
@@ -129,7 +170,7 @@ export function deleteContestProblem(id: number) {
 export function editProblem(problem: AdminProblem | BlankProblem) {
   return api.put<AdminProblem>(
     `admin/problems/${(problem as AdminProblem).id}`,
-    toProblemBody(problem),
+    toProblemBody(problem) satisfies Partial<UpdateProblemRequest>,
   )
 }
 
@@ -140,7 +181,7 @@ export function toggleProblemVisible(problemID: number) {
 export function generateFlowchartFromPythonCode(python: string) {
   return api.post<{ doc: Record<string, unknown> }>("admin/problems/flowchart", {
     python,
-  })
+  } satisfies GenerateFlowchartRequest)
 }
 
 export function getProblem(id: string | number) {
@@ -153,11 +194,13 @@ export function getTagAdminList(keyword = "") {
 }
 
 export function renameTag(id: number, name: string) {
-  return api.put<RenameTagResponse>(`admin/problem-tags/${id}`, { name })
+  return api.put<RenameTagResponse>(`admin/problem-tags/${id}`, { name } satisfies RenameTagRequest)
 }
 
 export function setTagCategory(id: number, category: TagCategory) {
-  return api.put<null>(`admin/problem-tags/${id}/category`, { category })
+  return api.put<null>(`admin/problem-tags/${id}/category`, {
+    category,
+  } satisfies SetTagCategoryRequest)
 }
 
 export function deleteTag(id: number) {
@@ -173,7 +216,7 @@ export function batchTagProblems(
     problemIds,
     tagNames,
     action,
-  })
+  } satisfies BatchProblemTagRequest)
 }
 
 // 用户排名（后台版，无 100 名上限；公开榜单是 oj/api.ts 的 getRank）
@@ -209,20 +252,23 @@ export function getUserList(
 
 /** 批量建号之前查重：这些用户名哪些已经有了 */
 export function checkUsernames(usernames: string[]) {
-  return api.post<CheckUsernamesResponse>("admin/users/check", { usernames })
+  return api.post<CheckUsernamesResponse>("admin/users/check", {
+    usernames,
+  } satisfies CheckUsernamesRequest)
 }
 
 // 编辑用户
 export function editUser(user: AdminUserForm) {
   return api.put<AdminUser>(`admin/users/${user.id}`, {
     username: user.username,
-    email: user.email,
-    adminType: user.adminType,
-    problemPermission: user.problemPermission,
+    // 库里 email 没有空的（2026-10 核过），响应类型是 nullable 只因为列可空
+    email: user.email ?? "",
+    adminType: toAdminType(user.adminType),
+    problemPermission: toProblemPermission(user.problemPermission),
     realName: user.realName ?? null,
     isDisabled: user.isDisabled,
     password: user.password ?? "",
-  })
+  } satisfies UpdateUserRequest)
 }
 
 // 重置用户密码，返回新密码
@@ -233,8 +279,10 @@ export async function resetPassword(userID: number) {
 
 // 导入用户
 /** 批量建号。addedClasses：这批里的新班级，后端已经顺手加进了班级列表 */
-export function importUsers(users: string[][]) {
-  return api.post<{ imported: number; addedClasses: string[] }>("admin/users", { users })
+export function importUsers(users: ImportUsersRequest["users"]) {
+  return api.post<{ imported: number; addedClasses: string[] }>("admin/users", {
+    users,
+  } satisfies ImportUsersRequest)
 }
 
 // 批量删除用户
@@ -282,7 +330,7 @@ export function previewSQLTestcase(data: {
   /** 是不是题面上展示的那组（第 1 组）：增删改题只有它必须改到行 */
   shown: boolean
 }) {
-  return api.post<SqlDisplay>("admin/sql-test-cases/preview", data)
+  return api.post<SqlDisplay>("admin/sql-test-cases/preview", data satisfies SqlPreviewRequest)
 }
 
 // 回显已上传的 SQL 测试点脚本内容（按 1.sql, 2.sql... 排序）
@@ -292,7 +340,10 @@ export function getSQLTestcaseScripts(problemId: number) {
 
 // AI 根据标准答案生成一个 SQL 测试点初始化脚本
 export function generateSQLTestcase(data: { refSql: string; mode: "query" | "modify" }) {
-  return api.post<GenerateSqlTestCaseResponse>("admin/sql-test-cases/generate", data)
+  return api.post<GenerateSqlTestCaseResponse>(
+    "admin/sql-test-cases/generate",
+    data satisfies GenerateSqlTestCaseRequest,
+  )
 }
 
 // 编程题出题页：读回已有测试点的原文（太大的只给数量和大小）
@@ -302,12 +353,15 @@ export function getTestCaseFiles(problemId: number) {
 
 // 拿标准答案自测语法要求
 export function checkAstRules(data: AstCheckRequest) {
-  return api.post<AstCheckResponse>("admin/ast-check", data)
+  return api.post<AstCheckResponse>("admin/ast-check", data satisfies AstCheckRequest)
 }
 
 // AI 按题面和标准答案想几组测试输入（输出由标准答案跑）
 export function generateTestInputs(data: GenerateTestInputsRequest) {
-  return api.post<GenerateTestInputsResponse>("admin/test-inputs/generate", data)
+  return api.post<GenerateTestInputsResponse>(
+    "admin/test-inputs/generate",
+    data satisfies GenerateTestInputsRequest,
+  )
 }
 
 /** 出站补默认值。字段名两边已经一致，不再做键名转换 */
@@ -346,14 +400,17 @@ function toProblemBody(problem: AdminProblem | BlankProblem) {
 }
 
 export function createProblem(problem: BlankProblem) {
-  return api.post<AdminProblem>("admin/problems", toProblemBody(problem))
+  return api.post<AdminProblem>(
+    "admin/problems",
+    toProblemBody(problem) satisfies Partial<CreateProblemRequest>,
+  )
 }
 
 export function createContestProblem(problem: BlankProblem) {
   // contestId 由 detail.vue 在提交前写进 problem 对象
   return api.post<AdminProblem>(
     `admin/contests/${problem.contestId}/problems`,
-    toProblemBody(problem),
+    toProblemBody(problem) satisfies Partial<CreateProblemRequest>,
   )
 }
 
@@ -371,13 +428,16 @@ function toContestBody(contest: AdminContest | BlankContest) {
 }
 
 export function createContest(contest: BlankContest) {
-  return api.post<AdminContest>("admin/contests", toContestBody(contest))
+  return api.post<AdminContest>(
+    "admin/contests",
+    toContestBody(contest) satisfies CreateContestRequest,
+  )
 }
 
 export function editContest(contest: AdminContest | BlankContest) {
   return api.put<AdminContest>(
     `admin/contests/${(contest as AdminContest).id}`,
-    toContestBody(contest),
+    toContestBody(contest) satisfies UpdateContestRequest,
   )
 }
 
@@ -393,12 +453,14 @@ export function addProblemForContest(contestID: string, problemID: number, displ
   return api.post<AdminProblem>(`admin/contests/${contestID}/problems/from-public`, {
     problemId: problemID,
     displayId: displayID,
-  })
+  } satisfies AddContestProblemRequest)
 }
 
 /** 比赛题按这个顺序重新编号 1、2、3…（要给全这场比赛的题） */
 export function reorderContestProblems(contestID: string, problemIds: number[]) {
-  return api.put(`admin/contests/${contestID}/problems/order`, { problemIds })
+  return api.put(`admin/contests/${contestID}/problems/order`, {
+    problemIds,
+  } satisfies ReorderContestProblemsRequest)
 }
 
 export function getWebsite() {
@@ -406,7 +468,7 @@ export function getWebsite() {
 }
 
 export function editWebsite(data: WebsiteConfig) {
-  return api.post<WebsiteConfig>("admin/website", data)
+  return api.post<WebsiteConfig>("admin/website", data satisfies UpdateWebsiteConfigRequest)
 }
 
 export function listInvalidTestcases() {
@@ -441,12 +503,18 @@ export function deleteAnnouncement(id: number) {
 
 export function editAnnouncement(announcement: AnnouncementEdit) {
   const { id, ...body } = announcement
-  return api.put<AdminAnnouncement>(`admin/announcements/${id}`, body)
+  return api.put<AdminAnnouncement>(
+    `admin/announcements/${id}`,
+    body satisfies UpdateAnnouncementRequest,
+  )
 }
 
 export function createAnnouncement(announcement: AnnouncementEdit) {
   const { id: _id, ...body } = announcement
-  return api.post<AdminAnnouncement>("admin/announcements", body)
+  return api.post<AdminAnnouncement>(
+    "admin/announcements",
+    body satisfies CreateAnnouncementRequest,
+  )
 }
 
 export function getTutorialList() {
@@ -470,15 +538,20 @@ function toTutorialBody(data: TutorialEdit) {
 }
 
 export function createTutorial(data: TutorialEdit) {
-  return api.post<Tutorial>("admin/tutorials", toTutorialBody(data))
+  return api.post<Tutorial>("admin/tutorials", toTutorialBody(data) satisfies CreateTutorialRequest)
 }
 
 export function updateTutorial(data: TutorialEdit) {
-  return api.put<Tutorial>(`admin/tutorials/${data.id}`, toTutorialBody(data))
+  return api.put<Tutorial>(
+    `admin/tutorials/${data.id}`,
+    toTutorialBody(data) satisfies UpdateTutorialRequest,
+  )
 }
 
 export function setTutorialProblems(id: number, problemIds: number[]) {
-  return api.put<Tutorial>(`admin/tutorials/${id}/problems`, { problemIds })
+  return api.put<Tutorial>(`admin/tutorials/${id}/problems`, {
+    problemIds,
+  } satisfies SetTutorialProblemsRequest)
 }
 
 export function getTutorialProblemCandidates(keyword: string) {
@@ -488,11 +561,15 @@ export function getTutorialProblemCandidates(keyword: string) {
 }
 
 export function reorderTutorials(ids: number[]) {
-  return api.put<null>("admin/tutorial-order", { ids })
+  return api.put<null>("admin/tutorial-order", { ids } satisfies ReorderTutorialsRequest)
 }
 
 export function renameTutorialProject(type: "python" | "c", from: string, to: string) {
-  return api.put<null>("admin/tutorial-projects", { type, from, to })
+  return api.put<null>("admin/tutorial-projects", {
+    type,
+    from,
+    to,
+  } satisfies RenameTutorialProjectRequest)
 }
 
 export function deleteTutorial(id: number) {
@@ -500,7 +577,9 @@ export function deleteTutorial(id: number) {
 }
 
 export function setTutorialVisibility(id: number, isPublic: boolean) {
-  return api.put<Tutorial>(`admin/tutorials/${id}/visibility`, { isPublic })
+  return api.put<Tutorial>(`admin/tutorials/${id}/visibility`, {
+    isPublic,
+  } satisfies SetTutorialVisibilityRequest)
 }
 
 export function getAdminExercises(tutorialId: number) {
@@ -510,16 +589,16 @@ export function getAdminExercises(tutorialId: number) {
 export async function createExercise(data: {
   tutorialId: number
   type: ExerciseType
-  data: object
+  data: Record<string, unknown>
   order: number
 }) {
-  return api.post<Exercise>("admin/exercises", data)
+  return api.post<Exercise>("admin/exercises", data satisfies CreateExerciseRequest)
 }
 
 export async function updateExercise(data: {
   id: number
   type: ExerciseType
-  data: object
+  data: Record<string, unknown>
   order: number
   resetAttempts: boolean
 }) {
@@ -528,7 +607,7 @@ export async function updateExercise(data: {
     data: data.data,
     order: data.order,
     resetAttempts: data.resetAttempts,
-  })
+  } satisfies UpdateExerciseRequest)
 }
 
 export function deleteExercise(id: number) {
@@ -539,7 +618,7 @@ export function deleteExercise(id: number) {
 export function makeProblemPublic(id: number, displayId: string) {
   return api.post<AdminProblem>(`admin/problems/${id}/make-public`, {
     displayId,
-  })
+  } satisfies MakeProblemPublicRequest)
 }
 
 // 比赛辅助检查
@@ -553,7 +632,7 @@ export function updateACMHelperChecked(
     rankId: rank_id,
     problemId: problem_id,
     checked,
-  })
+  } satisfies UpdateAcmHelperRequest)
 }
 
 // 题单管理 API
@@ -576,11 +655,14 @@ export interface ProblemSetBody {
 }
 
 export function createProblemSet(data: ProblemSetBody) {
-  return api.post<AdminProblemSet>("admin/problem-sets", data)
+  return api.post<AdminProblemSet>("admin/problem-sets", data satisfies CreateProblemSetRequest)
 }
 
 export function editProblemSet(id: number, data: ProblemSetBody) {
-  return api.put<AdminProblemSet>(`admin/problem-sets/${id}`, data)
+  return api.put<AdminProblemSet>(
+    `admin/problem-sets/${id}`,
+    data satisfies UpdateProblemSetRequest,
+  )
 }
 
 export function deleteProblemSet(id: number) {
@@ -600,15 +682,19 @@ export function getProblemSetProblems(problemSetId: number) {
 export function addProblemsToSet(problemSetId: number, problemIds: string[]) {
   return api.post<AddProblemsToSetResult>(`admin/problem-sets/${problemSetId}/problems`, {
     problemIds,
-  })
+  } satisfies AddProblemsToSetRequest)
 }
 
 export function setProblemRequired(problemSetId: number, itemId: number, isRequired: boolean) {
-  return api.put(`admin/problem-sets/${problemSetId}/problems/${itemId}`, { isRequired })
+  return api.put(`admin/problem-sets/${problemSetId}/problems/${itemId}`, {
+    isRequired,
+  } satisfies UpdateProblemInSetRequest)
 }
 
 export function reorderProblemSetProblems(problemSetId: number, ids: number[]) {
-  return api.put(`admin/problem-sets/${problemSetId}/problems/order`, { ids })
+  return api.put(`admin/problem-sets/${problemSetId}/problems/order`, {
+    ids,
+  } satisfies ReorderProblemSetProblemsRequest)
 }
 
 export function removeProblemFromSet(problemSetId: number, itemId: number) {
@@ -629,11 +715,17 @@ export interface BadgeBody {
 }
 
 export function createProblemSetBadge(problemSetId: number, data: BadgeBody) {
-  return api.post<AdminProblemSetBadge>(`admin/problem-sets/${problemSetId}/badges`, data)
+  return api.post<AdminProblemSetBadge>(
+    `admin/problem-sets/${problemSetId}/badges`,
+    data satisfies CreateProblemSetBadgeRequest,
+  )
 }
 
 export function editProblemSetBadge(problemSetId: number, badgeId: number, data: BadgeBody) {
-  return api.put<AdminProblemSetBadge>(`admin/problem-sets/${problemSetId}/badges/${badgeId}`, data)
+  return api.put<AdminProblemSetBadge>(
+    `admin/problem-sets/${problemSetId}/badges/${badgeId}`,
+    data satisfies UpdateProblemSetBadgeRequest,
+  )
 }
 
 export function deleteProblemSetBadge(problemSetId: number, badgeId: number) {
@@ -728,11 +820,17 @@ export function getMetricOptions() {
 }
 
 export function createAchievement(data: Partial<AdminAchievement>) {
-  return api.post<AdminAchievement>("admin/achievements", toAchievementBody(data))
+  return api.post<AdminAchievement>(
+    "admin/achievements",
+    toAchievementBody(data) satisfies Partial<CreateAchievementRequest>,
+  )
 }
 
 export function updateAchievement(data: Partial<AdminAchievement>) {
-  return api.put<AdminAchievement>(`admin/achievements/${data.id}`, toAchievementBody(data))
+  return api.put<AdminAchievement>(
+    `admin/achievements/${data.id}`,
+    toAchievementBody(data) satisfies Partial<UpdateAchievementRequest>,
+  )
 }
 
 export function deleteAchievement(id: number) {

apps/web/src/admin/user/generate.vue

@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import type { ImportUsersRequest } from "@oj2/contract"
 import { downloadAccountsCsv } from "./accountsCsv"
 import PageHeader from "admin/components/PageHeader.vue"
 import { classLabel } from "utils/classes"
@@ -127,7 +128,7 @@ async function submit() {
   // 占位邮箱必须全站唯一：注册、编辑用户、导入三条路都查重。每批一段随机后缀错开，
   // 同一个班分两批导也不会撞。这个地址不发给任何人，纯占位
   const batch = Math.random().toString(36).slice(2, 8)
-  const payload = rows.value.map((row, i) => [
+  const payload: ImportUsersRequest["users"] = rows.value.map((row, i) => [
     row.username,
     row.password,
     `${prefix.value || "user"}.${batch}.${i + 1}@example.com`,

apps/web/src/admin/user/list.vue

@@ -13,7 +13,7 @@ import UserNameCell from "./components/UserNameCell.vue"
 import PasswordCell from "./components/PasswordCell.vue"
 import { PROBLEM_PERMISSION, USER_TYPE } from "utils/constants"
 import { useRouteQuery } from "@vueuse/router"
-import { NO_CLASS, STUDENT_ROLES } from "@oj2/contract"
+import { NO_CLASS, STUDENT_ROLES, type ImportUsersRequest } from "@oj2/contract"
 import { downloadAccountsCsv } from "./accountsCsv"
 import { classLabel, groupClassOptions } from "utils/classes"
 import { useConfigStore } from "shared/store/config"
@@ -338,7 +338,7 @@ async function handleEditUser() {
   // 其余业务错误（比如班级号位数不对）不接住就什么都不显示
   try {
     if (create.value) {
-      const newUser = [
+      const newUser: ImportUsersRequest["users"] = [
         [
           userEditing.value.username,
           password.value,

apps/web/src/oj/achievement/api.ts

@@ -1,3 +1,4 @@
+import type { MarkAchievementsRead } from "@oj2/contract"
 import api from "utils/api"
 import type { AchievementList, PendingAchievement } from "utils/types"
 
@@ -12,5 +13,5 @@ export function getPendingAchievements() {
 }
 
 export function markAchievementsRead(ids: number[]) {
-  return api.post("achievements/pending/read", { ids })
+  return api.post("achievements/pending/read", { ids } satisfies MarkAchievementsRead)
 }

apps/web/src/oj/api.ts

@@ -1,3 +1,14 @@
+import type {
+  ClassLessonRequest,
+  ContestPasswordRequest,
+  CreateFlowchartRequest,
+  CreateSubmissionRequest,
+  FormatCodeRequest,
+  JoinProblemSetRequest,
+  RankHiddenRequest,
+  SetReactionRequest,
+  UpdateProfileRequest,
+} from "@oj2/contract"
 import {
   type AiAnalysisRecord,
   type LearningPeriod,
@@ -144,21 +155,20 @@ export async function getSubmission(id: string, attempts = false): Promise<Submi
 }
 
 export function submitCode(data: SubmitCodePayload) {
-  return api.post<CreateSubmissionResponse>("submissions", data)
+  return api.post<CreateSubmissionResponse>("submissions", data satisfies CreateSubmissionRequest)
 }
 
-export function formatCode(data: { code: string; language: string; problemId: number }) {
-  const languages: Record<string, string> = {
-    Python: "python",
-    C: "c",
-    "C++": "cpp",
-    SQL: "sql",
-  }
+/** 后端格式化认的四种（ruff / clang-format / sqlparse），别的语言提交前不格式化 */
+export function isFormatLanguage(value: string): value is FormatCodeRequest["language"] {
+  return ["python", "c", "cpp", "sql"].includes(value)
+}
+
+export function formatCode(data: FormatCodeRequest & { problemId: number }) {
   return api.post<FormatCodeResponse>("code/format", {
     code: data.code,
-    language: languages[data.language] ?? data.language.toLowerCase(),
+    language: data.language,
     problemId: data.problemId,
-  })
+  } satisfies FormatCodeRequest)
 }
 
 export function getSubmissions(params: Partial<SubmissionListPayload>) {
@@ -262,7 +272,7 @@ export function getWeeklyChampions(className?: string) {
 
 /** 老师把学生设成不计入排名 / 恢复 */
 export function setRankHidden(userId: number, hidden: boolean) {
-  return api.put<null>(`rankings/hidden/${userId}`, { hidden })
+  return api.put<null>(`rankings/hidden/${userId}`, { hidden } satisfies RankHiddenRequest)
 }
 
 /** 老师清空一个学生的个性签名 */
@@ -294,7 +304,11 @@ export function setClassLesson(
   problemDisplayIds: string[],
   language: LessonLanguage | null,
 ) {
-  return api.put<null>("classroom/lesson", { className, problemDisplayIds, language })
+  return api.put<null>("classroom/lesson", {
+    className,
+    problemDisplayIds,
+    language,
+  } satisfies ClassLessonRequest)
 }
 
 /** 我的知识点地图（只有自己的，不能查别人） */
@@ -350,7 +364,7 @@ export function getContestAccess(id: string) {
 export function checkContestPassword(contestID: string, password: string) {
   return api.post<boolean>(`contests/${encodeURIComponent(contestID)}/access`, {
     password,
-  })
+  } satisfies ContestPasswordRequest)
 }
 
 export async function getContestProblems(contestID: string) {
@@ -375,7 +389,7 @@ export function uploadAvatar(file: File) {
 }
 
 export function updateProfile(data: { realName?: string; mood?: string }) {
-  return api.put<Profile>("me/profile", data)
+  return api.put<Profile>("me/profile", data satisfies UpdateProfileRequest)
 }
 
 export function getAnnouncementList(offset = 0, limit = 10) {
@@ -393,7 +407,9 @@ export function getReaction(problemID: number) {
 }
 
 export function setReaction(problemID: number, type: ReactionKey) {
-  return api.post<ReactionState>(`problems/${problemID}/reaction`, { type })
+  return api.post<ReactionState>(`problems/${problemID}/reaction`, {
+    type,
+  } satisfies SetReactionRequest)
 }
 
 /** 个人主页那一页的数据：做对的题、四个时间、本班第几、成就，本人和老师多拿知识点和没做对的题 */
@@ -450,7 +466,7 @@ export function submitFlowchart(data: {
   mermaidCode: string
   flowchartData: Record<string, unknown> // 压缩之后的，元数据太长了
 }) {
-  return api.post<CreateFlowchartResponse>("flowcharts", data)
+  return api.post<CreateFlowchartResponse>("flowcharts", data satisfies CreateFlowchartRequest)
 }
 
 export function getFlowchartSubmission(id: string) {
@@ -507,7 +523,7 @@ export function getProblemSetProblems(problemSetId: number) {
 }
 
 export function joinProblemSet(problemSetId: number) {
-  return api.post("problem-set-progress", { problemSetId })
+  return api.post("problem-set-progress", { problemSetId } satisfies JoinProblemSetRequest)
 }
 
 export function getUserBadges(username?: string) {

apps/web/src/oj/store/submission.ts

@@ -1,6 +1,6 @@
 import { defineStore } from "pinia"
 import { errorCode, errorMessage } from "utils/api"
-import { formatCode, submitCode } from "oj/api"
+import { formatCode, isFormatLanguage, submitCode } from "oj/api"
 import { useCodeStore } from "oj/store/code"
 import { useProblemStore } from "oj/store/problem"
 import { useSubmissionMonitor } from "oj/problem/composables/useSubmissionMonitor"
@@ -106,7 +106,7 @@ export const useSubmissionStore = defineStore("submission", () => {
     //    Python 在格式化之前先由服务端的 CPython 查一遍语法，有错就不提交；
     //    C / C++ 先在判题机上编一遍，编不过就原样交（格式化会把错的几行并成一行）
     const formatLang = LANGUAGE_FORMAT_VALUE[codeStore.code.language]
-    if (["python", "c", "cpp", "sql"].includes(formatLang)) {
+    if (isFormatLanguage(formatLang)) {
       isFormatting.value = true
       try {
         const res = await formatCode({

apps/web/src/shared/api.ts

@@ -1,14 +1,15 @@
+import type { LoginRequest, RegisterRequest } from "@oj2/contract"
 import type { Quote, WebsiteConfig } from "@oj2/contract"
 import api from "utils/api"
 import { contractDeferred } from "utils/contract"
 import type { Profile, Tag } from "utils/types"
 
 export function login(data: { username: string; password: string }) {
-  return api.post("auth/login", data)
+  return api.post("auth/login", data satisfies LoginRequest)
 }
 
 export function signup(data: { username: string; email: string; password: string }) {
-  return api.post("users", data)
+  return api.post("users", data satisfies RegisterRequest)
 }
 
 export function logout() {