dsh-bilibili
常驻 DSH Web 界面右下角的哔哩哔哩小组件：扫码登录 → 推荐流 → 站内播放。
一个 DSH 插件（bundle）。浏览器不直连 B 站（其 API 不发 CORS 头），所有出网请求都由插件的 Host 半侧代理。
功能
| |
|---|
| 🔐 扫码登录 | 面板内生成二维码，手机 B 站 App 扫码即登录；也可手动粘贴 SESSDATA |
| 👤 登录态常驻右下角 | 收起态圆形入口直接显示你的头像 |
| 🎬 推荐流 | 登录后主页为 B 站推荐视频，2 列卡片（封面 / 时长 / UP 主 / 播放量） |
| 🔁 换一批 / 刷新 | 换一批走下一批；刷新重载当前视图。Host 侧带批次缓存与下一批预取，常态下瞬间返回 |
| 🔍 搜索 | 顶部搜索框，回车或点「搜索」提交（接口需 wbi 签名） |
| 🕘 历史 | 阅读观看历史（游标分页） |
| ⭐ 收藏 | 读取「默认收藏夹」（分页） |
| ▶️ 站内播放 | 点卡片在面板内播放，支持拖动进度与续播；中键/Ctrl+点击仍在新标签打开 B 站 |
界面
┌─────────────────────────────────────┐
│ [头像] 昵称 [退出] [×] │
├─────────────────────────────────────┤
│ [ 搜索 B 站视频… ] [搜索] │
│ 为你推荐 [历史][收藏][换一批][刷新] │
├─────────────────────────────────────┤
│ 卡片 卡片 │
│ 卡片 卡片 │
└─────────────────────────────────────┘
- 历史 / 收藏 是可切换的 chip，高亮表示当前视图，再点一次回到推荐。
- 非「推荐」视图下，换一批 自动变成 下一页；刷新 始终重载当前视图。
- 右上角
× 收起为右下角圆形入口；入口显示头像表示已登录。
安装
# 1. 放进 DSH profile（示例：web）
cd ~/.dsh/profiles/web
pnpm add /path/to/dsh-bilibili # 或以 link: 依赖登记
# 2. cordis.patch.yml 追加
- insert:
- id: dsh-bilibili
name: dsh-bilibili
# 3. 重启
setsid bash ~/.dsh/restart-dsh.sh </dev/null >/dev/null 2>&1 & # 或你自己的重启方式
Host 半侧代码只在 DSH 启动时加载。 改动 index.js 后禁用/启用插件不会生效（只会从缓存的模块重放 apply），必须重启。client.js 会随 dsh-client-hmr 热更新。
登录
方式一：扫码（推荐）
点开面板 → 出现二维码 → 手机哔哩哔哩 App 扫码 → 手机点确认。成功后凭据由 Host 校验并落盘。
方式二：粘贴 Cookie
面板右下角「改为手动粘贴 Cookie」→ 从浏览器 F12 复制 SESSDATA 的值，或直接整行 Cookie → 保存。
凭据存放在：
<DSH_HOME>/dsh-bilibili/session.json # 权限 0600，目录 0700
只保留 SESSDATA / bili_jct / DedeUserID / DedeUserID__ckMd5 / sid / buvid3 / buvid4 / b_nut，
先经 nav 校验通过才写入，从不回传浏览器、不写日志。
⚠️ 代价与风险
SESSDATA 等同于该账号的完整登录权限。落盘意味着这台机器能冒充该账号。- 属于非官方接口。B 站可能对该账号限流或风控，建议使用小号。
- 凭据约数月过期，失效后面板会提示重新导入。
架构
client.js Client 半侧：shell.overlay 槽位，渲染面板；只请求本包的同源路由
index.js Host 半侧：持有凭据、出网、转发视频流
| 路由 | 作用 |
|---|
GET/POST/DELETE /dsh-bilibili/session | 登录态读取 / 校验并保存 / 退出 |
GET /dsh-bilibili/login/qrcode | 生成二维码（返回模块矩阵，前端画 SVG） |
GET /dsh-bilibili/login/poll | 轮询扫码状态，成功后收 Set-Cookie 并落盘 |
GET /dsh-bilibili/feed?cursor= | 推荐流（登录则个性化） |
GET /dsh-bilibili/library/{history,fav,search} | 历史 / 默认收藏夹 / 搜索 |
GET /dsh-bilibili/play?bvid=&cid= | 解析播放地址（cid 可省，会自动补齐） |
GET /dsh-bilibili/media?u= | Range-aware 视频流代理 |
三个必须知道的实现约束
- 视频流必须代理。 实测 CDN 只认 bilibili 的
Referer：带它 206，不带或外来 403。所以 <video> 指向本包的
media 路由，由 Host 带着正确头部转发。
- 媒体代理必须做背压。
res.write() 返回 false 时要 await drain。浏览器缓冲够了会主动暂停读，
若仍按 CDN 速度拉取，整个视频会堆进 DSH 进程内存（实测单个 447MB 视频涨 140MB），
GC 压力会让播放和整个界面一起卡。修好后暂停期间从 CDN 的拉取会收敛到 0。
- 搜索必须 wbi 签名。 不签名会返回
412。签名 = 排序 + 转义 + wts + md5(query + mixin) 的 w_rid，
密钥从 nav 的 wbi_img 推导，缓存 6 小时。
已知限制
- 只读「默认收藏夹」，不能切换其他收藏夹。
- 仅支持视频（
archive）。番剧 / 直播 / 动态不出现在历史里。
- 播放清晰度固定
qn=64（720p，mp4 durl）；未做清晰度切换。
- 未实现：投币、点赞、弹幕、评论区、稍后再看。
- 面板宽度 380px，信息密度按此调校。
目录结构
dsh-bilibili/
├── package.json # bundle 清单：dsh.bundle.patch + dsh.client
├── cordis.patch.yml # 插入插件行
├── index.js # Host 半侧（登录 / 流 / 播放 / 搜索 / 历史 / 收藏）
├── client.js # Client 半侧（面板 / 二维码 / 卡片 / 播放器）
├── icon.svg # 插件管理器图标
├── locale/{en,zh}.json # 插件显示名称与描述
└── node_modules/ # 仅 qrcode-generator（零依赖）
依赖
qrcode-generator（MIT，零依赖）— 二维码编码。
仅使用其 ESM 默认导出；注意它的 stringToBytes 默认是 latin1，本插件用 TextEncoder 覆盖以保证字节正确。
License
MIT © 2026 CloudWoR
