更新点歌和弹幕微调

docs/protocol.md

@@ -50,7 +50,8 @@ close 结束连接。
 `component.language.updated`，payload 为 `{ "language": "en-US" }`；新连接以认证帧为准。
 
 设置快照中的 `themeId` 是稳定的主题标识。弹幕姬与点歌姬支持 `jade-scroll` 和
-`moonlit-water`；礼物特效支持 `jade-starfall` 和 `moonlit-water`；礼物菜单支持 `jade-banquet` 和
+`moonlit-water`；礼物特效与大航海特效分别支持 `jade-starfall` 和 `moonlit-water`；礼物菜单支持
+`jade-banquet` 和
 `moonlit-water`。消费者应把未知主题降级为自身默认主题，不能因主题发布顺序不同而中断实时消息。
 
 ## 版本化事件信封
@@ -105,8 +106,8 @@ close 结束连接。
 3. `song.queue.snapshot.end`：提交该快照。
 
 后续 `song.queue.changed` 携带连续 revision，`operation` 为 `added`、`promoted`、
-`completed`、`cancelled`、`cleared` 或
-`rating-updated`。客户端发现 revision 缺口必须重连取得新快照，不能猜测缺失队列状态。 `cleared`
+`completed`、`cancelled` 或
+`cleared`。客户端发现 revision 缺口必须重连取得新快照，不能猜测缺失队列状态。 `cleared`
 表示当前歌曲与全部待唱项已在同一事务中取消，客户端必须立即清空活动投影。
 
 礼物目录价格的原始单位是人民币的千分之一。`gift.totalPrice` 保留该整数单位，`gift.priceCny`
@@ -115,11 +116,17 @@ close 结束连接。
 `live.gift` 与 `live.gift.combo` 不是两笔礼物。需要持久化计数的组件通常只消费
 `live.gift`；连击事件用于更新同一张视觉卡片。
 
-`gift_effect` 只订阅 `live.gift` 与 `live.guard.buy`。礼物档位由 sanitized settings 中的
+`gift_effect` 只订阅 `live.gift`，不会收到 `live.guard.buy`。礼物档位由 sanitized settings 中的
 `highValueThreshold` 和 `featuredValueThreshold` 决定；浏览器使用 `gift.imageUrl` 或
 `gift.animationUrl`
 作为流星主体，图片失效时必须使用本地星光占位。该组件不维护状态快照，重连后只展示新到达的实时事件。
 
+`guard_effect` 只订阅
+`live.guard.buy`。舰长、提督和总督事件进入该组件独立的广播通道；它不接收普通礼物或礼物连击，也不维护状态快照。
+
+`gift_effect` 与 `guard_effect`
+的浏览器渲染器分别维护有界 FIFO，并且每次只播放一个 active 特效。动画完成后按到达顺序推进下一项；这个队列仅用于 OBS 视觉节流，不是可靠业务队列，也不会在重连后恢复。
+
 `gift_menu` 同样只消费一次性 `live.gift` 与 `live.guard.buy`。命中配置后投影为
 `gift-menu.triggered`，payload 包含 `itemIds`、`viewer` 和
 `sourceEventId`。一个特定礼物和一个同价电池规则可以同时命中多个菜单项；客户端应全部高亮，并滚动到第一个匹配项。未命中的投喂不会进入该组件通道。