🎬 dsh-bili-miniplay
在 DeepSeek Harness (DSH) 里悬浮看片的 B 站小窗（跨平台版） — 边 coding 边刷视频，专注摸鱼，快乐加倍 🐟
⚠️ 本项目是 pyf2818/dsh-bili-widget 的跨平台分叉（fork）。
原版仅支持 Windows 桌面应用（依赖 curl.exe / powershell.exe / cwd C:\），在 macOS/Linux 上会「fetch 失败: http 502」。
本分叉把 Host 端网络层改为 Node 原生 fetch，不再依赖任何外部子进程，因此 macOS / Linux / Windows 通用。
原版版权归原作者所有，本分叉按其 MIT 许可分发并在 LICENSE 中保留归属。功能、UI、接口设计均源自原版。
✨ 为什么值得装
在 DSH 里挂一个 永远置顶、可拖动缩放、自动连播 的 B 站小窗。写代码写累了，随手点开一个视频边听边写；摸鱼看番也不会被打扰——窗口永远在最上层，全屏也不丢。
📸 截图
主界面
主界面
在 DSH 里悬浮一个 B 站小窗，推荐 / 热门 / 排行 / 精选 / 关注 / AI 六个频道，列表内直接播放，无缝切换。
观看历史
观看历史
自动记录观看历史，本地持久化存储，重启 DSH 不丢失。
迷你模式
迷你模式
一键最小化到悬浮球，视频继续后台播放；点击悬浮球恢复窗口，进度完整保留。
快捷键面板
快捷键面板
快捷键一目了然：←/→ 上下曲、M 迷你、N 专注、Esc 返回/关闭。
🚀 功能一览
🎯 内容发现
| 能力 | 说明 |
|---|
| 6 大频道 | 推荐 / 热门 / 排行 / 精选 / 关注 / AI，45 个话题 chip 快速切入 |
| 搜索 | 支持视频/番剧/UP主/影视，BV/av 号直达，搜索历史持久化 |
| ⭐ 关注 UP 主 | 一键关注，专属频道聚合你关注的 UP 主视频，追更不迷路 |
🎮 播放体验
| 能力 | 说明 |
|---|
| 自动连播 | 播完自动切下一个，或单集重播，无缝摸鱼 |
| 迷你 / 专注模式 | 迷你小窗仅 300×180，专注模式纯播放器 |
| ➖ 窗口最小化 | 一键最小化到悬浮球，视频继续播放，点球恢复 |
| 悬浮球 | 可拖动、可点击，点开/收起窗口不打断播放 |
🛠 工程细节
| 能力 | 说明 |
|---|
| 💾 数据持久化 | 关注列表 + 观看历史存服务端文件，重启 DSH 不丢失 |
| 已看标记 | 播放过的视频自动打「已看」，不重复追 |
| 骨架屏 + 重试 | 加载动画、错误重试按钮，体验顺滑 |
| 🔐 可选 B 站登录 | 默认匿名即可看；扫码登录后解锁登录可见内容，token 存在 DSH credentials（密钥/~/.dsh），不进 git 仓库 |
| 快捷键 | ←/→ 上一个/下一个 / M 迷你 / N 专注 / Esc 返回 |
🔐 可选登录（B 站账号）
默认匿名即可浏览、搜索和播放绝大多数公开视频。若想解锁"登录可见"内容或进一步降低搜索被限的概率，可扫码登录：
- 点击小窗顶部工具栏的 登录（未登录）/ 已登录（已登录）按钮，用 B 站 App 扫二维码即可。
- 登录态安全存进 DSH
credentials（底层走系统密钥库；无该服务时回退到 ~/.dsh/bili-data/login.json）。两个位置都在 git 仓库之外，代码里零硬编码密钥。
- 支持退出登录；登录状态只在本机使用，不会上传或写入本仓库。
📦 安装
方式一：DSH 内直接说（推荐）
在 DSH 对话里输入：
请安装 https://github.com/Suguyun/dsh-bili-miniplay 这个插件
DSH 会自动完成安装，重启后即可在侧边栏找到「B站」。
方式二：手动安装
在你的 DSH profile 的 package.json 中添加：
{
"dependencies": {
"@dsh-external/dsh-bili-miniplay": "github:Suguyun/dsh-bili-miniplay"
},
"dsh": {
"profile": {
"bundles": [
"@dsh-external/dsh-bili-miniplay"
]
}
}
}
然后 pnpm install 并重启 DSH。
⌨️ 快捷键
在窗口标题栏点击 ? 按钮，随时可以查看这份快捷键表。
| 按键 | 功能 |
|---|
← / → | 播放上一个 / 下一个 |
M | 切换迷你模式 |
N | 切换专注模式 |
Esc | 返回上一页 / 关闭 |
标题栏 — | 最小化到悬浮球（视频继续播放，点球恢复） |
🖥 环境要求
- macOS / Linux / Windows 通用 —— Host 端改用 Node 原生
fetch，不再依赖 curl.exe / powershell.exe
- DSH 桌面应用（web profile）
🤝 参与贡献
欢迎 PR！有想法可以在 Issues 提。
- 想加新频道 / 新话题？
- 想要弹幕同步？
- 想优化搜索接口的抗反爬策略？
📄 许可证
MIT — 保留原版 pyf2818/dsh-bili-widget 的版权归属。
