# 洛星瓷直播弹幕姬

运行前复制带注释的 `config.toml.example` 为 `config.toml`，填入 CookieCloud、设置数据库和访问密钥，然后执行：

```sh
cp config.toml.example config.toml
docker compose up --build -d
```

应用配置遵循 `blivedm_rs` 的 TOML/`--config` 形式；Compose 会以只读方式将 `config.toml` 挂载到容器并传入 `--config /app/config.toml`。配置段及字段说明直接写在 [config.toml.example](config.toml.example) 的注释中。

应用容器使用 host 网络并监听 `9719`。它通过 `[database].url` 连接 PostgreSQL，仅用于持久化 OBS 弹幕姬设置。应用会自动创建所需表；`[connection].room_id`、CookieCloud Key/UUID 与密码均为必填配置。

服务端已迁移为 Rust/Axum，并使用 [`blivedm_rs`](https://github.com/isomoes/blivedm_rs) 发布的 `blivedm` crate 建立 Bilibili 认证弹幕连接；不再使用 Node 服务端或 `@laplace.live/ws`。为确保 UID、礼物价格和上游事件 ID 不会被库的简化消息结构丢弃，项目在 `vendor/blivedm` 固定了一个仅保留原始 JSON 的小补丁。应用从 CookieCloud 获取 Bilibili Cookie（必须包含 `SESSDATA`），用于获取认证 UID、直播间网关与 WebSocket 鉴权包。

## OBS 弹幕姬

镜像会在构建阶段编译 `apps/overlay`，最终由 Rust/Axum **同域托管**：

- `/obs?token=你的_OBS_访问令牌`：透明背景的 OBS 浏览器源。它没有固定画布，按浏览器源的实际宽高自动在窄侧栏、常规卡片和低高度模式之间切换。
- `/control`：管理员控制台。使用 `admin.password` 登录后可改标题、字号、事件类别、最大条数、自动收缩、卷轴展开时长、动效、每卡粒子数量与速度、低性能模式和礼物高亮阈值；保存会实时广播给已打开的 OBS 源。

控制台的“复制 OBS 地址”会生成含只读令牌的完整地址。该令牌仅能订阅 `/ws`，不能访问管理或写入接口。常用 OBS 浏览器源尺寸可从 `360×600`、`440×760` 或 `600×1080` 开始；可按实际版面自由拖拽缩放，不会出现 1920×1080 的固定画布留白。

每张消息卡片都会从六套花纹组合中稳定选取一套，轮换使用对称花枝、横向自然藤纹和雏菊花簇，并改变上下、左右、镜像、配色与局部背景；连续的新卡会主动避开相同款式，礼物连击更新则保持原样式不跳动。透明消息墙本身不铺设全局装饰背景。粒子数量与速度可在控制台调整；窄尺寸会自动减少粒子，低性能模式会关闭动态粒子。花边 SVG 已本地打包，来源和公版/CC0 许可记录在 `apps/overlay/public/assets/NOTICE.md`，OBS 运行时不会访问素材站点。

后端会在启动时、之后每十分钟调用 Bilibili 的无需 Cookie 礼物面板接口缓存礼物图片、GIF、币种和价格。目录刷新失败时保留上一次成功缓存；缺失目录条目会安全降级为直播事件自带的名称与价格。

直播弹幕中的普通混排表情和整条大表情会作为安全的文字/图片分段通过 WebSocket 推送。消息自带的图片地址优先；服务还会使用 CookieCloud 的 `SESSDATA` 刷新直播间表情目录，在消息只提供表情唯一标识时补齐图片。图片加载失败时前端会退回原始表情文字。

刷新间隔和请求超时可通过 `[gifts]` 调整。`[overlay]` 与 `[overlay.events]` 是某个直播间第一次运行时的展示默认值；在 `/control` 保存后，数据库中的设置优先，因此更新 TOML 不会覆盖管理员已经调好的 OBS 样式。若希望重新采用 TOML 默认值，可删除该房间在 `overlay_settings` 表中的记录后重启。