Preface¶

When developing in DSH, if you want to quickly check a Bilibili video, the common approach is to switch to a browser or system window. Window switching interrupts the current context, especially when the DSH interface already fills the screen, making it inconvenient to code and keep a video playing simultaneously.

pyf2818/dsh-bili-widget is a Bilibili floating widget plugin designed for DeepSeek Harness (DSH). It brings Bilibili browsing, playback, search, subscriptions, and watch history into a floating window within DSH. The window supports always-on-top mode, dragging and resizing, and preserves partial state after restarts.

What It Is¶

This is a DSH plugin, with the repository named pyf2818/dsh-bili-widget and the package named @dsh-external/dsh-bili-widget. The maintainer is pyf2818, and it is licensed under MIT.

The core problem it solves: within DSH, without switching away from the main window, you can open a persistent always-on-top Bilibili window for browsing channels, searching, subscribing, and continuously playing videos.

Core Features¶

Below are explanations in three parts: content entrances, playback window, and history & state.

Content Entrances¶

• Six channels: Recommended / Popular / Rankings / Featured / Subscriptions / AI
• 45 topic chips for quick access
• Search videos, anime, UP creators, and films
• Supports direct BV/av link navigation
• Persistent search history
• Follow UP creators and aggregate their videos

Playback Window¶

• Always-on-top window, draggable and resizable
• Auto-continuous playback
• Mini mode: 300×180
• Focus mode
• Minimize to a floating ball, video continues playing

History & State¶

• Watch history is recorded and persisted, surviving DSH restarts
• Watched markers: played videos are automatically marked
• Skeleton screen loading animations
• Error retry button

Installation and Enablement¶

Below are two installation methods.

Method One: Install via DSH Conversation¶

Enter the following in a DSH conversation:

Please install the plugin https://github.com/pyf2818/dsh-bili-widget

After completing the installation as prompted, restart DSH.

Method Two: Manually Modify the DSH Profile¶

Add the dependency to the package.json of the DSH profile and include the package name in dsh.profile.bundles. You can merge the following fields into the existing configuration:

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

Then, in the corresponding DSH profile directory, run:

pnpm install

Finally, restart DSH.

Typical Usage¶

1. Open the Bilibili floating window in DSH, and browse videos across the six channels: Recommended, Popular, Rankings, Featured, Subscriptions, and AI.
2. Use the search capability to find videos, anime, UP creators, and films, or enter a BV/av link for direct navigation.
3. Follow the UP creators you need and view the aggregated videos in the Subscriptions channel.
4. Use keyboard shortcuts during playback to control the window and playback state:

Applicable Scenarios and Notes¶

This is suitable for scenarios where DSH desktop application (web profile) is used on Windows. This plugin uses curl.exe / powershell.exe as network subprocesses.

The project is licensed under MIT. The plugin runs with the current dsh process privileges. Before installation, review the source code, dependencies, and license to confirm it meets your security requirements.

Reference Links¶

• GitHub: https://github.com/pyf2818/dsh-bili-widget
• Catalog page: https://www.skillhub.cn/plugins/pyf2818/dsh-bili-widget