Holiday Preview

预发布通道：节日分支功能

仅预发布通道有本页内容。 main 上的稳定版没有下列字段和参数（合入稳定版后本页会并入 HTTP-API）；对接方请按「字段缺失 = 不支持」处理。

项	值
发布形式	GitHub Pre-release，tag v<版本>-preview_<代号>，见 全部 Release
源码分支	preview/*（未合入 main）
适配游戏	SCP:SL Steam holiday 测试分支（14.2.8 起）
基线	包含当前稳定版的全部内容

自动更新不会推送本版本，需要请手动下载，且只建议在测试服使用。

---

数据口：GET /get_sl_data 新增字段

字段	说明
game_version	游戏版本串
active_holiday	当前节日：None / Christmas / Halloween / AprilFools

控制面：/control/player/data 新增字段

字段	说明
effects	当前生效的效果数组：name / intensity / duration（0 = 无限期）/ time_left / classification / door_permissions
temporary_bypass	active / intensity / level（none / scp_override（强度 1）/ all（强度 ≥2））/ time_left / grants_door_access（本服游戏版本中该效果是否参与开门判定，节日分支为 true）
effect_door_permissions	所有生效效果提供的开门权限合集（DoorPermissionFlags，如 None / ScpOverride / All）

节日分支的开门判定顺序为「效果 → 角色 → 手持物品」，任一效果给出足够权限即放行。

控制面：/control/player/effects 新增参数

字段	说明
effect_intensity	可选，0-255，默认 1（与旧行为一致）；0 = 关闭该效果；超出范围 → 400

curl -s -X POST "http://<host>:8081/control/player/effects" \
  -H "Authorization: Bearer YOUR_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"2","effect":"TemporaryBypass","effect_intensity":2,"effect_duration":30}'

上例给 2 号玩家 30 秒全部门权限。ACL 与审计沿用原端点（admin 默认开放、duty 默认拒绝，写入 control_log）。

更新检查

预发布构建（InformationalVersion 含 preview 等标记）在同版本号的正式版发布后也会提示更新（例如 x.y.z-preview → x.y.z）；正式版构建行为不变。

已知限制

• 编译引用节日分支的 Assembly-CSharp.dll，无法用正式版游戏的程序集编译。设计上在正式版游戏上运行时缺少新成员会自动回落（effects 改读 AllEffects 中已启用的项），但未实测。
• 带 TemporaryBypass 的真人开门未实测（假人无法开门）。

问题请 开 Issue 并注明插件版本（含 preview）和游戏版本。