01
裁判名单库
referee-s06-r12按角色分开存放主哨与助理裁判档案，每场指派同时挂到对应轮次，正查反查都能走通。
- 档案总量
- 312 人
- 主哨 / 助理
- 148 / 164
- 现役在册
- 186 人
- 层级
- 杯赛层 · 联赛层
CATALOG / 目录 · 01
六类赛事数据
按目录逐项检索
星空体育把可长期引用的结构化数据拆成六个目录：从裁判名单与指派记录，到青训梯队外援名额、杯赛签表与首发轮换对照，再到红黄牌累积台账与修订公告。每个目录都写明字段口径、覆盖范围、更新节奏和版本号，方便按需核对与标注来源。
02 / 目录总览
六个目录，覆盖从名单到修订
每一条目录后面都跟着覆盖范围与一句话用途，右侧固定显示该目录当前的版本号。点击左侧索引可直接跳到对应条目。
02
指派与轮次对照
appoint-s06-r31把每场指派按轮次排开，同一轮内可横向比对主哨与两名助理的搭配，用于赛前核对与赛后复盘。
- 记录总量
- 4,180 场
- 赛季跨度
- 5 个完整赛季 + 当前赛季
- 每场裁判
- 1 主哨 + 2 助理
- 排序依据
- 轮次先后
03
星空体育青训梯队外援名额核对表
youth-foreign-s06-r08按赛季注册窗口逐队核对，五项字段固定填写，避免同一支梯队在窗口内出现两套名额口径。
- 梯队数量
- 14 支
- 年龄组
- U13 / U15 / U17 / U19
- 核对字段
- 5 项
- 核对节点
- 每个注册窗口
04
杯赛签表与首发轮换对照
cup-bracket-s06-r16签表推进到八强阶段，每个节点绑定该场首发记录，用来看一支球队在不同轮次的首发变动幅度。
- 参赛球队
- 32 支
- 已录场次
- 48 场
- 阶段
- 资格轮 → 八强
- 对照内容
- 签表节点 + 首发轮换
05
红黄牌累积与停赛台账
cards-s06-r27以上海业余足球的当轮赛后统计为准，逐轮累加黄牌，红牌单场计罚，并标出因此触发的停赛人次。
- 覆盖球队
- 96 支
- 小组数
- 6 个
- 常规阶段
- 11 轮
- 统计口径
- 当轮赛后
06
数据修订与更正公告
revision-s06-r37每一次数字变动都留痕：改了什么、影响了哪个目录、修订序号走到第几位，都能在这里查到。
- 公告总量
- 37 条
- 差错率
- 0.02% 以内
- 对应字段
- 版本号 + 修订序号
- 公开时机
- 复核通过后即时
03 / 字段与口径
每个目录的字段，写在同一个口径上
字段名与单位全站统一。看到同一个字段名，含义不会因为页面不同而变化。
F-01
名单与指派字段
角色、层级、状态三类字段互不混用，保证一场比赛的三个执法位次可被单独检索。
| 字段 | 口径 | 类型 |
|---|---|---|
| 主哨 | 每场标注 1 名，记录其在杯赛层或联赛层的执法场次 | 角色枚举 |
| 助理裁判 | 每场固定标注 2 名，与主哨同一批次发布 | 角色枚举 |
| 层级归属 | 每场挂到杯赛层或联赛层的具体轮次，不跨层合并 | 层级枚举 |
| 档案状态 | 现役在册，或标注为历史执法记录，两者不重复计数 | 状态枚举 |
| 场次计数 | 按指派记录累加，杯赛与联赛分别统计后再合计 | 整数 |
F-02
外援名额的五项核对字段
每个注册窗口对 14 支梯队逐队填写同样五项，缺一项即视为未完成核对。
| 字段 | 口径 | 类型 |
|---|---|---|
| 注册状态 | 该外援在本窗口是否已完成注册 | 状态枚举 |
| 名额占用 | 该梯队当前已使用的外援名额数量 | 整数 |
| 年龄组归属 | U13、U15、U17、U19 四组之一 | 分组枚举 |
| 出场资格 | 该外援在本赛季是否具备出场资格 | 布尔 |
| 窗口截止时间 | 以相对时点标注本注册窗口的关闭位置 | 时间 |
F-03
杯赛签表首发轮换对照的字段
签表节点与首发记录逐场绑定，轮次推进路径可直接从节点序列读出。
| 字段 | 口径 | 类型 |
|---|---|---|
| 签表节点 | 资格轮、后续各轮直至八强的节点标识 | 节点枚举 |
| 晋级路径 | 一支球队自资格轮起的连续节点序列 | 序列 |
| 首发变动数 | 该场首发相较同队上一场的变动人数 | 整数 |
| 对照场次 | 签表节点与首发记录一一绑定，不附加比分信息 | 关联 |
F-04
红黄牌与停赛字段
统计以当轮赛后汇总为准，属于赛后口径，不是比赛进行中的实时数据。
| 字段 | 口径 | 类型 |
|---|---|---|
| 黄牌累积 | 逐轮累加，触发停赛的临界值按赛事规程执行 | 整数 |
| 红牌 | 单场计罚，不跨轮结转 | 整数 |
| 停赛人次 | 因累计黄牌或红牌触发停赛的人次 | 整数 |
| 语义色 | 黄牌使用裁判黄，停赛与更正标记使用裁判红 | 语义标记 |
04 / 更新频率
什么时候刷新，看触发事件
每一类数据都由一个明确的赛事事件触发刷新，时间描述使用相对时点，不用固定日期。
| 目录 | 触发事件 | 刷新节奏 | 版本号 |
|---|---|---|---|
| 裁判名单库 | 每轮赛后 | 2 小时内刷新档案与指派 | referee-s06-r12 |
| 指派与轮次对照 | 每轮赛后 | 与名单库同批次刷新 | appoint-s06-r31 |
| 青训梯队外援名额核对表 | 注册窗口关闭 | 24 小时内刷新逐队核对结果 | youth-foreign-s06-r08 |
| 杯赛签表与首发轮换对照 | 抽签完成后 | 即时刷新签表与对应首发记录 | cup-bracket-s06-r16 |
| 红黄牌累积与停赛台账 | 当轮赛后统计完成 | 统计完成后刷新台账与停赛人次 | cards-s06-r27 |
| 数据修订与更正公告 | 差错复核通过 | 随修订即时公开 | revision-s06-r37 |
05 / 覆盖范围
杯赛层与联赛层，撑起全部数据
六个目录共用同一个分层基础。展开下面两个面板，可以看到每一层各自覆盖的场次、球队与年龄组。
- 参赛球队32 支
- 已录场次48 场
- 阶段跨度资格轮 → 八强
- 对照内容签表节点 + 首发轮换
- 组别分工4 个组别各自归档指派
- 轮次组织逐轮排布，同轮可横向比对
- 联动数据红黄牌与停赛按同一批轮次组织
- 312裁判档案人数
- 4,180指派记录场次
- 14青训梯队支数
- 96业余足球覆盖球队
06 / 版本与修订
版本号怎么读，修订怎么查
版本号由目录名、赛季与修订序号三段拼成。修订序号只在该目录内部递增，因此看到序号变大，就说明这个目录被改过。
- 裁判名单库 referee-s06-r12
- 指派与轮次对照 appoint-s06-r31
- 青训梯队外援名额核对表 youth-foreign-s06-r08
- 杯赛签表与首发轮换对照 cup-bracket-s06-r16
- 红黄牌累积与停赛台账 cards-s06-r27
- 数据修订与更正公告 revision-s06-r37
07 / 引用规范
引用时请带上来源与版本
目录数据可以自由引用，但需要标注来源页面路径与当时的版本号，方便读者回到同一份数字上。
01 写法
在表格、脚注或图注后注明来源页面与版本号，例如「数据来源：数据目录 /catalog/，版本 cup-bracket-s06-r16」。
02 时效
所有数字都是赛后统计口径，不构成实时比分或结果预告。跨轮次引用时，请说明数据截止到哪一轮或哪个注册窗口。
03 边界
目录不提供赛事结果预测，也不包含任何竞猜或投注内容。使用范围与责任边界的完整说明见 使用条款。
发现数字与实际记录不符，或者需要确认某条数据能否用于出版物，可通过 咨询通道 提交核对请求，或回到 首页 从站点数据版本号进入相关目录。