前言¶
DeepSeek Harness（DSH）的 Web GUI 默认是纯色或主题背景。若你长时间在 Harness 里写代码、调 Agent，又习惯开着 B 站直播或某个视频当「环境音 + 画面」，通常要在浏览器另开标签页，聊天窗口和画面分屏，占用注意力。
dsh-bili-wallpaper 是社区插件，由 st21a1 维护，分类为「趣味换装」。它把 B 站直播间实时画面 或 任意视频 铺在聊天界面背后，并在 设置 → B站背景 里完成来源、清晰度、模糊与遮罩等调节。运行时依赖已随 npm 包 vendor，不会再拉任何 npm 包。
这是什么¶
一句话：DeepSeek Harness 插件，在 desktop / web profile 下，用扫码登录你自己的 B 站账号，粘贴直播或视频地址，选清晰度，让画面在 Web GUI 背后播放，并支持模糊、压暗遮罩、面板半透明等调节。
- 目录页：skillhub.cn/plugins/st21a1/dsh-bili-wallpaper
- 源码与文档：github.com/st21a1/dsh-bili-wallpaper
- 当前 npm 版本（资料）：
0.3.0，许可证 MIT
插件声明硬依赖 webServer；tui / headless 没有 Web GUI，装了也不会有画面。
核心功能¶
下面按 README 已列能力归纳，不展开未在资料中出现的行为。
| 能力 | 说明 |
|---|---|
| 直播背景 | 直播间链接或房号（如 https://live.bilibili.com/6 或 6），实时画面在聊天背后 |
| 视频背景 | 视频链接、BV 号或 av 号；支持分 P |
| 扫码登录 | 设置页内二维码，手机 B 站扫一扫；登录后直播可选「原画」 |
| 清晰度 | 「自动」取当前能拿到的最好一档；也可手动指定原画 / 蓝光 / 超清等 |
| 画面调节 | 铺满 / 完整、背景模糊、压暗遮罩、面板不透明度、静音 / 音量 / 播放速度 |
| 省电 | 切到后台自动暂停（可关） |
| 半透明 UI | 面板、侧栏、气泡变为可透出背景的玻璃面，文字仍可读 |
| 开播自愈 | 直播地址过期或下播后重开，会自动重新解析 |
| 视频播完 | 下一 P（默认）/ 循环 / 停最后一帧 / 关闭背景 |
| 分 P 与进度 | 多 P 切换；视频可拖进度条；同一视频同一 P 可记住上次进度 |
Host 端必须做媒体代理：B 站 CDN 不带正确 Referer 会 403；HLS 清单需改写；代理 URL 带进程内 HMAC 签名。网络仅访问 B 站 API、登录域与 CDN；凭证存 $DSH_HOME/bili-wallpaper/，不上传第三方，无遥测。
安装与启用¶
推荐从 npm 安装（Web 版 Harness）：
dsh plugin --profile web add dsh-bili-wallpaper
桌面版把 --profile web 换成 --profile desktop。包地址：npmjs.com/package/dsh-bili-wallpaper。
README 还给出从 GitHub 安装的方式：
dsh plugin --profile web add github:st21a1/dsh-bili-wallpaper
装完后按官方步骤：
- 重启 Harness（Host 半端
index.js需重启才加载） - 打开 设置 → B站背景
- 粘贴直播或视频地址，点「使用这个来源」
- 需要原画时点「扫码登录」
只改 client.js 对应源码时，刷新页面即可（client HMR），不必重启 Host。
卸载示例（资料为 desktop profile）：
dsh plugin --profile desktop remove dsh-bili-wallpaper
配置与登录凭证仍在 $DSH_HOME/bili-wallpaper/，卸载不会自动删除。
典型用法¶
设置页分五块：开启背景 / 来源 / 清晰度 / 画面 / 账号。
- 开启背景后，在「来源」填入直播间 URL、房号，或视频 URL、
BV/av（可分 P 选择）。 - 「清晰度」选「自动」或手动档位；未登录时视频一般最高 720P、直播一般「超清」，「原画」需登录。
- 「画面」里调模糊、遮罩、面板透明度、音量与播放速度；视频可用进度条与分 P 切换。
- 遇浏览器拦截有声自动播放时，插件会先静音并在页面提示，点一下即可恢复。
与 dsh-plugin-wallpaper-engine 功能重叠：两个都开时会提示，建议只开一个。
适用场景与注意¶
适合谁：长期在 DSH Web GUI（dsh web 或 Desktop）里工作，希望背景是自有 B 站账号可访问的直播或视频，且愿意在本地保存扫码凭证的用户。
环境与兼容（来自 README）：
| 项 | 要求 |
|---|---|
| DeepSeek Harness | ^0.2.0-rc.1（开发与验证于 0.2.1-rc.3） |
| Node.js | >=22.12.0 |
| 浏览器 | 支持 MediaSource Extensions 的现代浏览器 |
已知限制（节选）：直播只走 HLS；仅 FLV 的直播间会明确报暂不支持。视频走 durl（MP4），被切成多段的只播放第一段。直播无进度条。若出现 B 站风控码 -351，README 建议按「退出登录 → 重登 → 等待 / 换网」顺序排查，而非反复改地址。
安全与信任：插件以当前 DSH 进程权限运行，会读写 $DSH_HOME/bili-wallpaper/ 下的配置与凭证。安装前请自行查看 GitHub 仓库 源码与 MIT 许可证。本插件与哔哩哔哩官方无关，仅供个人本地使用，须遵守 B 站用户协议与相关法律法规。
社区目录 SkillHub 独立于 DeepSeek / 幻方，并非官方应用商店；DSH 生态理念是「一切皆插件」，是否安装由你自行判断。
结尾¶
dsh-bili-wallpaper 把 B 站直播与点播收进 Harness 同一窗口：扫码登录、选清晰度、调模糊与遮罩，聊天背后即是画面。需要细节、更新日志与 Issue，见 GitHub 仓库 与 SkillHub 目录页。
