API 参考 / capability 包：服务、状态与游玩访问

StoryContext

触发剧情时传入的上下文，向剧情侧说明「是谁触发的」。由调用方实现并传给 StoryAccess.trigger。

方法速览

方法	用途
`source()`	触发来源标识

java

public interface StoryContext {

    String source();
}

签名：

java

String source();

行为：触发来源标识（如 "miss"），宿主把它透传为剧情场景的 source 参数。返回 null（或整个上下文为 null）时宿主回退为 "mod"。

示例：

java

story.trigger("story_miss", () -> "miss");

线程：宿主在触发调用线程读取一次，勿依赖后续修改。

稳定性：2.0 起冻结：2.x 内只增不破。