2.2 KiB
song_request 点歌姬
每个账户自动拥有一个初始 song_request
实例，也可以再创建同类型的命名实例。每个实例拥有独立设置、OBS 地址、队列、历史和 revision，但共享账户的固定直播监听；删除实例会同时删除该实例的队列历史。组件只订阅规范化的
live.danmaku；业务状态由 PostgreSQL 保存，不依赖 OBS 是否在线。
弹幕命令
点歌<歌名>或点歌 <歌名>：命令与歌名之间的空格可有可无；合并首尾和连续空白，接受 1–80 字自由文本。当前或待唱队列中已有大小写不敏感的同名歌曲时忽略。
首首点歌立即成为当前歌曲。完成或取消当前歌曲时，队首自动接替；置顶待唱项只把它移动为下一首，不打断当前歌曲。完成或取消后的歌名可以再次点播。
设置
themeId、fontFamily、fontBrightness、requesterColor、songTitleColor、fontScale、decorationLineWeight、scrollSpeedPixelsPerSecond
和 edgePauseSeconds 控制 OBS 外观与往返滚动。maxQueueSize、maxRequestsPerViewer 与
requestCooldownSeconds 是可选防刷限制；值 0 表示不限制。
moonlit-water（“静夜曲水”）与弹幕姬共享主题 ID：当前歌曲使用圆形音符、演唱状态、大号歌名和弱化音频柱，待唱区按“点歌用户、歌名”两行显示。它不绘制卡片或面板背景，只用米金文字、青色微光、共享的上下古风细边和一条弱分隔线建立层级。用户和歌名颜色均可覆盖主题默认值。
OBS 与管理
OBS 顶部固定显示当前歌曲和点歌用户，下面保存全部待唱横条。列表超过实际浏览器源高度时从顶部滚到底部，再返回顶部；布局不假设固定分辨率。
控制台的“打开点歌统计”进入会话保护页面。它每两秒刷新完整活动队列和近期历史；页面隐藏时停止轮询。管理者可以置顶或取消待唱项，也可以完成、取消当前歌曲，或在确认后一次性将全部活动歌曲标记为已取消。清空操作保留历史，并以一个 revision 原子广播。所有 REST 查询都从会话取得 owner，并由 PostgreSQL RLS 再次限制组件归属。