联动

Capability 注册

Conversation 模块在宿主 Capability 注册表中注册以下能力：

方法	说明
`isInteracting(Player)`	返回玩家是否正在与 Conversation 模块交互（对话中、选择器已打开或电影序列播放中）

该能力由 ConversationService.isPlayerInteracting() 与 CinematicService.isPlaying() 组合实现。其他模块可通过此能力判断玩家是否处于对话 / 电影序列中，从而决定是否打断或排队等待。

Conversation 是 SubtitlePlayable Capability 的消费方，而非提供方。电影序列 subtitle 动作通过此能力播放 Announcer 字幕组（打字机效果）。

电影序列 arcartx_sound 动作通过此桥接播放 ArcartX 资源包自定义音效。

模块通过此桥接完成所有 UI 打开 / 关闭 / 发包操作，包括对话 UI、选择器 UI、letterbox UI。

使用场景：bridge.openUiAll() / bridge.closeUiAll() / bridge.sendPacketToAll() / bridge.registerUiCloseCallback()
降级行为：桥接不可用时 UI 无法打开，对话降级为无 UI 模式

按键注册由宿主 config.yml 的 keybinds 节统一管理，模块通过 registerKeybindHandler 注册回调：

按键回调返回 true 表示已消费，宿主不再传递给低优先级处理器。对话 UI 为 Menu 类型不接收全局按键，回复选择通过 UI 内点击或键盘 1-9 完成。

模块启动时向 Chemdah ConversationTheme 注册 ArcartXConversation 主题，替代 Chemdah 默认主题：

主题回调	处理逻辑
`onBegin(Session)`	委托 `onDisplay`，开始对话时渲染首屏
`onDisplay(Session, lines, canReply)`	调用 `ConversationService.display()` 渲染对话正文与回复列表
`onClose(Session)`	调用 `ConversationService.close()` 关闭对话 UI

事件	处理逻辑
`PluginReloadEvent.Conversation`	Chemdah 对话重载时重置运行状态并重新注册主题
`PlayerEvents.Released`	Chemdah 对话释放时清理玩家状态（严格按运行时类型过滤）

选择器确认 NPC 后，模块调用 TriggerAdyeshachKt.openConversation(entity, player, false) 打开 Chemdah 对话，由 Chemdah 驱动主题回调完成 UI 渲染。

模块通过 AdyeshachNpcBridgeAPI 桥接 Adyeshach NPC：

桥接方法	使用场景
`initialize()`	初始化 NPC 桥接
`findNearby(player, range)`	扫描附近 NPC（选择器候选来源）
`findByName(name)`	按名称查找 NPC（外观配置、电影序列 NPC 动作）
`applyModel(npc, modelId, scale)`	设置 NPC 模型
`applyDefaultState(npc, state, animation)`	设置持久默认动画状态
`applyAnimation(npc, animation, speed, transitionTime, keepTime)`	一次性播放动画

NPC 外观配置在模块启动时自动应用，支持重试机制（最多 30 次，每次间隔 10 tick），应对 NPC 尚未加载完成的情况。

电影序列的 15 种内置动作通过 CinematicActionContext 访问各桥接：

电影序列播放前通过 PlayerSnapshot.capture() 捕获玩家状态，结束后通过 restorePlayer() 恢复：