API 参考 / spi 包：游戏模式、谱面扩展与内容

ChartParseContext

谱面解析上下文，extensions 段解析时传入 ChartExtensionParser.parse，只在该次解析期间有效。

方法速览

方法	用途
`chartJson()`	谱面 JSON 顶层对象
`totalLanes()`	谱面总轨道数

签名：

java

JsonObject chartJson();

行为：返回谱面 JSON 的顶层对象（可读取 title / bpm / lanes / 其他 extensions 段等）。对象由宿主持有并继续用于后续解析，请只读访问、不要修改或长期保存引用。

示例：

java

int lanes = ctx.chartJson().get("lanes").getAsInt();

签名：

java

int totalLanes();

行为：返回谱面声明的总轨道数（与 chartJson().get("lanes") 同源，已按宿主默认值解析）。

示例：

java

int lanes = ctx.totalLanes();

java

public interface ChartParseContext {

    JsonObject chartJson();

    int totalLanes();
}

线程：源码未声明额外线程约束；仅在谱面解析调用栈内同步使用。

生命周期阶段：仅解析期（ChartExtensionParser.parse 内）有效，不要保存引用。

稳定性：2.0 起冻结：2.x 内只增不破（禁止删签名/改签名/改语义）。