装饰

docs/components/danmaku-overlay.md

@@ -17,6 +17,8 @@
 | `themeId`                | 主题 ID     | 选择已安装的完整视觉主题   |
 | `fontFamily`             | 字体 ID     | `song`、`fang-song`、`kai` |
 | `fontBrightness`         | 70–180%     | 只调整文字亮度             |
+| `viewerColor`            | `#RRGGBB`   | 可选的用户昵称颜色覆盖     |
+| `danmakuColor`           | `#RRGGBB`   | 可选的弹幕正文颜色覆盖     |
 | `fontScale`              | 50–300%     | 展开与收缩字号的统一比例   |
 | `maxVisible`             | 1–12        | 同时保留的消息卡数量       |
 | `collapseAfterSeconds`   | 2–120 秒    | 最新卡从展开态切换到紧凑态 |
@@ -30,13 +32,13 @@
 | `show*`                  | boolean     | 控制各事件类别订阅         |
 
 后端的 `OverlaySettings::sanitize` 是最终边界。控制台 range
-input 只改善交互，不能取代服务端校验。字体 ID 只映射到前端预先注册的安全字体栈，不接受任意 CSS；OBS 设备缺少首选字体时会依次回退到可用衬线字体。
+input 只改善交互，不能取代服务端校验。字体 ID 只映射到前端预先注册的安全字体栈，不接受任意 CSS；OBS 设备缺少首选字体时会依次回退到可用衬线字体。颜色覆盖同样只接受六位十六进制颜色；留空时使用主题色，切换主题后会自动采用新主题的配色。
 
 ## 主题
 
 主题同时封装配色、花纹素材、装饰变体、粒子组合与动画名称。当前内置主题为
 `jade-scroll`（“青玉花卷”）与
-`moonlit-water`（“静夜曲水”）。后者不绘制卡片底色或外框，只保留青黛、米金衬线文字、细金分隔线与少量花星微光；控制台仍以选择框呈现，新增主题后无需改变设置交互或卡片队列。
+`moonlit-water`（“静夜曲水”）。后者不绘制卡片底色、外框或消息分隔线，只保留青黛、米金衬线文字、少量花星微光以及组件上下共享的透明古风细边；控制台仍以选择框呈现，新增主题后无需改变设置交互或卡片队列。
 
 增加主题时需要同步完成三处注册：
 

docs/components/gift-menu.md

@@ -25,10 +25,11 @@ schema 没有提供盲盒原始 ID/名称，因此这类事件可以按实际电
 
 ## OBS 行为
 
-每行横向展示图标、触发条件与主播自定义说明。行数、行高、中文字体、文字亮度、文字比例、滚动速度、高亮时长和动效强度均可调整。仅当内容超过实际视口高度时滚动；渲染器复制三组菜单并在等价位置间无缝归一化，实现最后一行之后紧接第一行。
+每行横向展示图标、触发条件与主播自定义说明。行数、行高、中文字体、文字亮度、文字比例、高亮时长和动效强度均可调整。`jade-banquet`
+仅在内容超过实际视口高度时滚动；渲染器复制三组菜单并在等价位置间无缝归一化，实现最后一行之后紧接第一行。
 
-命中时浏览器选择距离当前滚动位置最近的匹配副本，将它平滑对齐到视口第一行、暂停自动滚动并播放流金渐变与星花粒子。触发用户名称作为整行前景居中显示，覆盖原礼物图标和说明，并允许长名称换行。滚动器保留亚像素余量，低速设置也保持线性。低性能模式和系统减少动态效果偏好会关闭装饰粒子。舰长、提督和总督使用随前端打包的透明图标。
+命中时，青玉主题选择距离当前滚动位置最近的匹配副本，将它平滑对齐到视口第一行并暂停自动滚动；静夜主题则以匹配项为新一页的第一行。两种主题都会播放流金渐变与星花粒子。触发用户名称作为整行前景居中显示，覆盖原礼物图标和说明，并允许长名称换行。青玉滚动器保留亚像素余量，低速设置也保持线性。低性能模式和系统减少动态效果偏好会关闭装饰粒子及分页过渡。舰长、提督和总督使用随前端打包的透明图标。
 
 `jade-banquet`
-复用仓库内已有且记录许可的花枝 SVG。`moonlit-water`（“静夜曲水”）提供另一种完全透明的排版：行项目没有卡片底色或外框，只以青黛、米金文字和细金线区分，触发时以水纹扫光高亮。新增主题必须在
+复用仓库内已有且记录许可的花枝 SVG。`moonlit-water`（“静夜曲水”）提供另一种完全透明的分页排版，并与弹幕姬、点歌姬共享透明古风上下细边：每页行数和换页间隔可调，不进行纵向滚动；换页时旧内容从左向右渐隐，同时新内容沿相同方向淡入。礼物触发会以该条目为第一页首行，并以水纹扫光高亮。新增主题必须在
 `giftMenuThemes.ts` 注册稳定 ID、资源键和局部 CSS 变量。

docs/components/song-request.md

@@ -13,15 +13,15 @@
 
 ## 设置
 
-`themeId`、`fontFamily`、`fontBrightness`、`fontScale`、`scrollSpeedPixelsPerSecond` 和
-`edgePauseSeconds` 控制 OBS 外观与往返滚动。`maxQueueSize`、`maxRequestsPerViewer` 与
+`themeId`、`fontFamily`、`fontBrightness`、`requesterColor`、`songTitleColor`、`fontScale`、`scrollSpeedPixelsPerSecond`
+和 `edgePauseSeconds` 控制 OBS 外观与往返滚动。`maxQueueSize`、`maxRequestsPerViewer` 与
 `requestCooldownSeconds` 是可选防刷限制；值 `0` 表示不限制。
 
-`moonlit-water`（“静夜曲水”）与弹幕姬共享主题 ID：当前歌曲和待唱项会变为完全透明的衬线文字清单，以米金细线区分层级，不会在 OBS 上产生面板背景。
+`moonlit-water`（“静夜曲水”）与弹幕姬共享主题 ID：当前歌曲使用圆形音符、演唱状态、大号歌名、紧凑评分和弱化音频柱，待唱区按“点歌用户、歌名”两行显示。它不绘制卡片或面板背景，只用米金文字、青色微光、共享的上下古风细边和一条弱分隔线建立层级。用户和歌名颜色均可覆盖主题默认值。
 
 ## OBS 与管理
 
 OBS 顶部固定显示当前歌曲、点歌用户、平均分和评分人数，下面保存全部待唱横条。列表超过实际浏览器源高度时从顶部滚到底部，再返回顶部；布局不假设固定分辨率。
 
-控制台的“打开点歌统计”进入会话保护页面。它每两秒刷新完整活动队列和近期历史；页面隐藏时停止轮询。管理者可以置顶或取消待唱项，也可以完成或取消当前歌曲。所有 REST 查询都从会话取得 owner，并由 PostgreSQL
+控制台的“打开点歌统计”进入会话保护页面。它每两秒刷新完整活动队列和近期历史；页面隐藏时停止轮询。管理者可以置顶或取消待唱项，也可以完成、取消当前歌曲，或在确认后一次性将全部活动歌曲标记为已取消。清空操作保留历史与评分，并以一个 revision 原子广播。所有 REST 查询都从会话取得 owner，并由 PostgreSQL
 RLS 再次限制组件归属。

docs/protocol.md

@@ -102,8 +102,9 @@ close 结束连接。
 3. `song.queue.snapshot.end`：提交该快照。
 
 后续 `song.queue.changed` 携带连续 revision，`operation` 为 `added`、`promoted`、
-`completed`、`cancelled` 或
-`rating-updated`。客户端发现 revision 缺口必须重连取得新快照，不能猜测缺失队列状态。
+`completed`、`cancelled`、`cleared` 或
+`rating-updated`。客户端发现 revision 缺口必须重连取得新快照，不能猜测缺失队列状态。 `cleared`
+表示当前歌曲与全部待唱项已在同一事务中取消，客户端必须立即清空活动投影。
 
 礼物目录价格的原始单位是人民币的千分之一。`gift.totalPrice` 保留该整数单位，`gift.priceCny`
 是供展示使用的人民币数值。