API 参考 / 事件系统

HostCommandEvent

宿主事实转播：宿主终端执行了一条命令。它与宿主内核私有事件同一点同步转译到模组总线。

方法速览

方法	用途
`command()`	命令文本

java

public String command();

行为：返回宿主终端执行的命令文本（与宿主私有事件同一字符串），原样转播。不要假设命令集合固定。

示例：

java

ctx.eventBus().subscribe(HostCommandEvent.class, event -> {
    if ("secret".equals(event.command())) {
        unlockHiddenOverlay();
    }
});

java

public class HostCommandEvent extends Event {
    public HostCommandEvent(String command);
    public String command();
}

行为核验：命令已进入宿主执行流程，转播不提供干预面，不可取消。低频事件，无性能压力。

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