# 规则包（rules/）

本目录存放**可导入导出的积分规则包**，格式 YAML。

> ⚠️ 本目录下的规则包**不进版本库**（`.gitignore` 已排除 `rules/*`，仅保留本文件），因为可能包含赛事相关的敏感信息。

## 文件命名

`<赛事名>.yaml`

## 顶层字段

| 字段 | 说明 |
| --- | --- |
| `format` / `formatVersion` | 固定为 `scoreboard-rules` / `1` |
| `meta` | 规则包名称、code、版本、更新时间 |
| `standings` | 加权系数、tie-break、奖牌统计开关 |
| `profiles` | 积分模板（分值、录取名次、并列口径） |
| `recordBonus` | 破纪录档位与分值 |
| `manualAdjustment` | 人工调整开关 |
| `channelTemplates` | 按项目类型套用的计分通道 |
| `eventOverrides` | 单个项目的例外配置 |

## 导入导出

- 导出：管理端「规则」页 → 导出 YAML
- 导入：先预览差异，确认后写入并全量重算积分

详细定义见 [02-积分与排名规则](../devdocs/02-积分与排名规则.md) 第 7 节。