更新点歌和弹幕微调

README.md

@@ -1,7 +1,7 @@
 # 多用户直播组件服务
 
 这是一个多用户 Rust/Axum 直播组件后端。目前内建 `danmaku_overlay` 弹幕姬、`song_request` 点歌姬、
-`gift_effect` 全屏礼物特效与 `gift_menu`
+`gift_effect` 全屏礼物特效、`guard_effect` 大航海特效与 `gift_menu`
 礼物菜单，后端已经按“直播源 → 强类型事件 → 组件实例”的方式拆分。镜像构建阶段会编译 React 前端，运行时由 Rust 同域托管控制台和 OBS 页面。
 
 直播连接使用相邻目录中的 [`libilibili`](https://github.com/feliscafra/libilibili)
@@ -21,6 +21,7 @@ adapter 只负责把强类型 Bilibili 命令转换成稳定的领域事件。cr
 - [`danmaku_overlay` 弹幕姬](docs/components/danmaku-overlay.md)
 - [`song_request` 点歌姬](docs/components/song-request.md)
 - [`gift_effect` 全屏礼物特效](docs/components/gift-effect.md)
+- [`guard_effect` 大航海特效](docs/components/guard-effect.md)
 - [`gift_menu` 礼物菜单](docs/components/gift-menu.md)
 - [WebSocket 实时协议](docs/protocol.md)
 - [租户、Secret 与部署安全](docs/security.md)
@@ -72,7 +73,7 @@ Compose 将 `config.toml` 只读挂载到 `/app/config.toml`，应用通过 `--c
 `[database].url`
 指向 PostgreSQL。应用启动时自动执行版本化迁移，数据库保存账户、一次性邀请码、TOTP 注册状态、可撤销会话、恢复码摘要、用户直播源、组件设置、OBS 令牌摘要和审计记录。租户表同时使用 owner 复合外键与 PostgreSQL
 RLS 约束，HTTP
-API 也始终从当前会话取得 owner，客户端不能自行指定其他用户。点歌队列、评分和完整历史同样保存在租户隔离表中。账户语言偏好也保存在强制 RLS 的
+API 也始终从当前会话取得 owner，客户端不能自行指定其他用户。点歌队列和完整历史同样保存在租户隔离表中。账户语言偏好也保存在强制 RLS 的
 `account_preferences` 表中。
 
 `security.data_encryption_key` 必须是独立生成并妥善备份的 32 字节 Base64 密钥。TOTP
@@ -211,12 +212,16 @@ fragment，不会随最初的 HTTP 请求发送到 Nginx；OBS 页面随后通
 `/api/v1/components/<publicId>/stream` 完成认证。令牌只带 `events:subscribe`
 权限，不能调用管理或写入接口；轮换后旧令牌立即失效。
 
-每个账户会自动拥有不可删除的点歌姬、全屏礼物特效和礼物菜单组件。观众发送 `点歌 歌名` 加入队列，发送
-`打分 1-5`
-为当前歌曲评分；主播可从组件设置打开独立统计窗口，置顶、完成或取消队列项。点歌状态和评分持久化在 PostgreSQL，即使 OBS 未连接也不会丢失。
+每个账户会自动拥有不可删除的点歌姬、全屏礼物特效、大航海特效和礼物菜单组件。观众发送 `点歌歌名` 或
+`点歌 歌名`
+加入队列；主播可从组件设置打开独立统计窗口，置顶、完成或取消队列项。点歌状态与历史持久化在 PostgreSQL，即使 OBS 未连接也不会丢失。
 
-礼物特效组件在透明全屏浏览器源中展示从左向右飞行的礼物流星，并按礼物原始价值选择数量、尺寸和速度；舰长、提督和总督事件会临时覆盖一层不透明星河庆祝画面。所有档位参数、拖尾、星数、持续时间和低性能模式均可在控制台调整。该组件只订阅一次性
-`live.gift` 与 `live.guard.buy`，不会把连击更新重复播放为新礼物。
+礼物特效组件在透明全屏浏览器源中展示从左向右飞行的礼物流星，并按礼物原始价值选择数量、尺寸和速度。该组件只订阅一次性
+`live.gift`，不会接收大航海事件，也不会把连击更新重复播放为新礼物。密集礼物在每个 OBS 礼物组件中按有界 FIFO 逐个播放，当前动画结束前不会叠加下一笔特效。
+
+大航海特效是独立的 `guard_effect` 组件，只订阅
+`live.guard.buy`。舰长、提督和总督分别播放独立视频，或按主题展示月下星光庆祝；它拥有自己的实例、设置、OBS
+token 和 WebSocket 通道。连续上舰事件同样按有界 FIFO 逐个完整播放，不会覆盖正在播放的视频。
 
 礼物菜单读取账户当前直播间的礼物目录与图标，可把指定礼物、舰长/提督/总督或指定礼物单价映射为自定义直播内容。OBS 以横排行无限循环展示，实际投喂命中时自动定位、暂停并播放渐变星花高亮。