B站直播弹幕浮层

简体中文 | English

在 DSH Web 界面里以常驻浮层显示 B 站直播间弹幕。浮层切换页面时不会卸载，可以一边干活一边看弹幕。

功能

• 实时弹幕，断线自动重连；实时连接不可用时自动回退到历史拉取
• 同时监控多个直播间，每个房间一个独立浮窗
• B站小电视圆形入口，聚合显示整体连接状态和最新弹幕，点击展开菜单管理全部直播间，并可以直接重新打开这台浏览器连接过的直播间
• 浮窗标题显示直播间真实标题，双击可以临时改名
• 可以拖动浮窗右下角调整大小，也可以把浮窗最小化为标题栏或收回悬浮球，都不会中断监控
• 房间未开播时先显示「当前房间未开播」，点「查看弹幕」才展开内容并解锁输入框
• 显示在线人数，可以发弹幕，所有配置项都能在插件设置页里改

安装

dsh plugin --profile web add github:Mooling0602/dsh-bili-danmaku-overlay

安装完成后重启 dsh。包内自带 cordis.patch.yml，dsh 会自己把插件插入 bundle。也带有构建好的 JavaScript，所以安装过程不需要编译。

之后打开插件设置页，把 defaultRoom 设成要监听的直播间号即可。

卸载：

dsh plugin --profile web remove dsh-bili-danmaku-overlay

配置登录凭据

[!NOTE] 登录凭据保存在 dsh 宿主机上，而不是浏览器本地缓存。

确保你所使用的 dsh 实例只属于你自己，否则不建议使用本插件！

有两种登录方式，任选其一即可。推荐直接扫码登录。

第一种是在插件里扫码登录。当插件没有可用的凭据时，悬浮球菜单会显示相关报错，点击后弹窗里可以扫码登录。获取的登录态将保存在 ~/.dsh/bili-danmaku-overlay/credential.json，文件只有你自己可读，并且所有 profile 共用，因此只需扫一次而不是每个 profile 扫一次。扫码登录会自行续期，不需要你反复操作。

第二种是在 ~/.dsh/.credentials.yaml 里放 SESSDATA 和 bili_jct，由你自己维护。

refs:
  BILIBILI_SESSDATA: <你的 SESSDATA>
  BILIBILI_JCT: <你的 bili_jct>

取值方式：浏览器登录 B 站后打开开发者工具 -> Application -> Cookies -> https://www.bilibili.com，然后找到并复制这两个值。

只看弹幕只需 SESSDATA，发弹幕还需要 bili_jct。

这份凭据的有效期较短，且不续期，需要频繁维护。不想维护的话，用扫码登录更省事。

两种凭据都存在时由 preferCustomCredential 决定用哪个，默认开启表示优先用你手写的那份，扫码登录作为回退。关掉它则优先用扫码登录，例如手写的那份属于你已经不想再用的账号。

插件设置

所有配置项都能在插件设置页里改，修改后即时生效。

选项	默认值	说明
defaultRoom	空	默认直播间号，留空则每次手动输入
autoConnect	false	页面加载后自动连接默认直播间
historyLimit	200	浮窗最多保留的弹幕条数
historyFetch	50	每次拉取的历史条数
pollMinMs	100	历史轮询的最快间隔，出错时自动退避到更慢
statsIntervalMs	60000	在线人数刷新间隔
heartbeatMs	30000	弹幕服务器心跳间隔
showEnterMessages	true	显示「进入直播间」消息
showSuperChat	true	显示醒目留言
requestTimeoutMs	12000	接口请求超时
checkCredentialOnLoad	true	页面加载时检查登录凭据，不可用时弹窗说明；仅在自动连接开启时生效
preferCustomCredential	true	优先使用 dsh refs 中的凭据而不是扫码登录获得的登录态；首选不可用时改用另一个

前端设置

配置页里的「前端设置」只保存在当前浏览器，不写入 dsh 配置，拖动滑块即时生效。

选项	范围	默认值
悬浮球大小	32–96px	48px
窗口内缩放（DPI）	50–300%	100%
弹幕窗口大小	240–720 × 180–760px	320×300px

弹幕窗口的大小直接拖动窗口右下角调整，最小化的窗口只显示标题栏，不受影响。

「窗口内缩放」改变弹幕窗口里文字、间距和按钮的大小，也作用于悬浮球点开后的「正在监控弹幕的直播间」列表，但不影响窗口本身的大小，两者可以分开调。100% 表示跟随当前页面的浏览器缩放；数值过大或过小时设置页会给出提示，但仍然可以保存。

「前端设置」右上角的重置按钮会把悬浮球大小、窗口内缩放和弹幕窗口大小一起还原成默认值，没有改动时该按钮不可用。

说明

• 在线人数是真实观看人数，不是 B 站某些接口返回的人气值。
• 鼠标移到窗口左上角的状态点上，可以看到未开播、连接失败、正在查看历史弹幕、已连接这些具体状态。

开发

源码是 TypeScript，index.js 和 client.js 是构建产物。

npm run build
npm run typecheck

改完 src/ 后重新构建。client.js 刷新页面即可生效；index.js 是 Host 侧，需要重启 dsh。

许可证

MIT