The Operator Plane

**SDK 刻意不包含的部分。**项目和环境的生命周期、部署与 rollback、计费、组织和用户管理、集群路由，都归管理面板、CLI 和 MCP 接口负责，不属于游戏代码。唯一刻意的例外是 Schema 即代码：schema 是面向开发者的接口，所以放在 SDK 里。

一个模型，两个平面

	SDK 平面	运营平面
入口	游戏代码	控制面板、CLI、MCP
包含	房间 · 实体 · 玩家 · 商业 · 排行榜	项目与环境 · 部署与 rollback · 计费 · 组织和用户管理 · 集群路由
工作方式	声明、hook、事件、操作	面板自己的界面

两者共用一个模型：你推送的声明（declaration），就是面板展示的那一份。不跨越这条线的是权限：游戏代码不能部署、不能计费，也不能迁移租户。

每个 SDK 接口（每个模块，以及声明在实体上的预设）在控制面板里都有面向运营方（operator）的对应部分，同样的声明在那里从另一侧查看和编辑：

SDK 接口	运营方看到的内容
Schema 即代码 / Data & Subscriptions	实体、迁移、记录浏览器、已保存的视图、导入/导出
Entity	状态机、逐实例检查
Entity Presets	掉落表，技能、属性和投射物的定义，世界物件预设，全部可在线调整
Access & Roles	角色矩阵：角色 × 操作、行过滤、字段掩码
Extensibility	带覆盖的场景链、解析后的顺序、调用追踪
Rooms	整个集群：房间、tick 健康状况、分配、排空状态
Matchmaking	队列、处理中的匹配票据、条件放宽曲线
Catalog & Commerce	商品目录、商店排期、收据、退款
Leaderboards	周期、记录修正（留有审计）、提交频率
Auth & Players	提供方、会话、封禁、认证场景
Files & UGC	资源、UGC 审核队列、配额
Analytics	仪表盘、转发器、数据接入延迟
Map	地图和障碍物集合、运行中的实例
Visibility / Collision / Locomotion / Prediction & Lag Comp	按房间调参：规则、响应对、时间窗口、按主体数据包的开销
Groups / Messaging	群组浏览器、模板、审核过滤器、排期
Bots	配置档、补位配额、机器人大脑端点
Inventory / Profile	持有物与转移记录、视图与所拥有的实体集合

**设计规则。**每项 SDK 能力在面板上都有对应界面，live-ops 因此能看到它；面板上的每个界面背后也都有一项 SDK 能力。模块同时交付这两半，无论在哪一侧编写声明，两侧看到的都是同一个模型。

一条声明的旅程：schema-author 编写它，playserv push 把它推送上去，panel 为 operator 展示它，调整后的参数直接作用到已经在运行的房间（room）。

面板展示的一切，工具也都能访问：平台提供 MCP 接口（与面板使用同一套 API），所以 AI 智能体和脚本可以操作项目（project）——初始化、schema、记录、玩家、部署——并与其他任何主体（actor）一样遵循同一套访问模型。