2.8 KiB
problems
负责题目逻辑身份、不可变版本、导入、标签、限制、发布状态与测试工件元数据。
跨模块通过 public.py 的不可变判题投影；大文件存取通过 infra/artifacts 的适配器。
公开题面/显式样例与隐藏输入/答案分别授权。公开 API 不返回工件摘要或存储路径。
uv run --locked kf-problems <directory> 导入并发布一个新版本。目录必须属于当前操作账号，
权限 0700；problem.json 遵循 import_format.py，只引用该目录下的单层普通文件名。
不解压归档、不跟随链接、不读取任意路径、不执行导入内容。默认清单可由 --manifest 指定。
要求配置 KF_OJ_ARTIFACT_ROOT 和可信 KF_OJ_JUDGE_ADMISSION JSON；同一准入配置应交付给节点，
不能由题目放宽。结构示例来自共享 judge-admission.valid.json，不是当前宿主隔离验收证明。
v1 清单固定 C17/C++20、工具链/镜像版本、精确字节比较、编译/运行/整个作业预算，并声明按序
测试点 {key,input_file,expected_file} 和最多十对公开样例 {input_file,output_file}。
题面以 statement_file 读取 UTF-8。每份样例至多 64 KiB，响应采用 base64 保留二进制数据。
同一 slug 受事务锁保护，每次发布递增 revision；发布后题面、限额、样例、测试点不可修改。
旧评测继续绑定旧版本；当前列表指向新版本。工件先持久化，再在同一事务建立引用和发布。
GET /api/v1/problems 以 slug 游标分页（after / limit，最多 100 项），
GET /api/v1/problems/versions/{uuid} 读取已发布版本。禁用逻辑题目时其版本对公开读取不可用。
内部判题投影仅供授权应用编排使用；外部 Worker 读取由 submissions 的有效租约端口控制。
v2 使用 schema_version: 2 与 language_configurations，每个配置包含 language、
完整 toolchain 身份、compile_limits、run_limits 和 job_wall_time_us。
可分别声明 c17、cpp20、python313、java21；不再同时提供 v1 顶层工具链或预算。
所有语言按可信节点配置准入，缺失能力/错误补丁版本/镜像摘要/过宽预算在发布前拒绝。
judge.admission.example.json 的镜像摘要为占位值，使用前替换为管理员制作镜像的实际摘要。
公开题面仅显示固定语言、版本、入口与预算，不公布宿主镜像路径和隐藏工件。
导入同一 slug 的 v2 版本保持原 v1 版本与提交不变。已有提交按其保存的协议版本解析， 不能重新序列化旧 canonical 数据来补入新字段。Java 使用 Main.java 与默认包 Main； Python 使用 main.py。每个新版本的语言集合独立，浏览器不得为旧版本补开新语言。