前言¶

在 DSH 里做开发时，如果临时想查看 B 站视频，常见做法是切出到浏览器或系统窗口。窗口切换会打断当前上下文，尤其是在 DSH 界面已经铺满屏幕时，不方便一边写代码一边保留视频。

pyf2818/dsh-bili-widget 是一个面向 DeepSeek Harness (DSH) 的 B站浮窗插件。它把 B站浏览、播放、搜索、关注和观看历史放进 DSH 内的悬浮窗口中，窗口支持置顶、拖动缩放，并保留重启后的部分状态。

这是什么¶

这是一个 DSH 插件，仓库名为 pyf2818/dsh-bili-widget，包名为 @dsh-external/dsh-bili-widget。维护者是 pyf2818，许可证为 MIT。

它解决的核心问题是：在 DSH 里不需要切走主窗口，就能打开一个常驻上层的 B站小窗，用于浏览频道、搜索、关注和连续播放视频。

核心功能¶

下面按内容入口、播放窗口、历史与状态三部分说明。

内容入口¶

• 六个频道：推荐 / 热门 / 排行 / 精选 / 关注 / AI
• 45 个话题 chip，用于快速切入
• 搜索视频、番剧、UP主、影视
• 支持 BV/av 号直达
• 搜索历史持久化
• 关注 UP 主，并聚合关注 UP 主的视频

播放窗口¶

• 窗口置顶、可拖动缩放
• 自动连播
• 迷你模式：300×180
• 专注模式
• 窗口最小化到悬浮球，视频继续播放

历史与状态¶

• 观看历史记录并持久化，重启 DSH 不丢失
• 已看标记：播放过的视频自动标记
• 骨架屏加载动画
• 错误重试按钮

安装与启用¶

下面给出两种安装方式。

方式一：在 DSH 对话中安装¶

在 DSH 对话中输入：

请安装 https://github.com/pyf2818/dsh-bili-widget 这个插件

按这个提示完成安装后，重启 DSH。

方式二：手动修改 DSH profile¶

在 DSH profile 的 package.json 中增加依赖，并把包名加入 dsh.profile.bundles。可以在现有配置中合并以下字段：

{
  "dependencies": {
    "@dsh-external/dsh-bili-widget": "github:pyf2818/dsh-bili-widget"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@dsh-external/dsh-bili-widget"
      ]
    }
  }
}

然后在 DSH profile 对应目录执行：

pnpm install

最后重启 DSH。

典型用法¶

1. 打开 DSH 中的 B站悬浮窗，在推荐、热门、排行、精选、关注、AI 六个频道中浏览视频。
2. 使用搜索能力查找视频、番剧、UP主、影视，或输入 BV/av 号直达对应内容。
3. 关注需要的 UP 主，并在关注频道查看聚合后的视频。
4. 播放时使用快捷键控制窗口和播放状态：

适用场景与注意¶

适合在 Windows 上使用 DSH 桌面应用（web profile）的场景。该插件使用 curl.exe / powershell.exe 作为网络子进程。

项目许可证为 MIT。插件以当前 dsh 进程权限运行，安装前建议检查源码、依赖和许可证，确认它符合你的安全要求。

参考链接¶

• GitHub: https://github.com/pyf2818/dsh-bili-widget
• 目录页: https://www.skillhub.cn/plugins/pyf2818/dsh-bili-widget