Introduction

If you are using the DeepSeek Harness (DSH) Web Workspace and need to step away briefly to do a short task without wanting to interrupt the running Agent, you can limit the action to a small panel.

dsh-whale-arcade is a community-maintained DSH plugin. It mounts into DSH’s shell.overlay, providing five browser-local games. A whale launcher remains permanently docked in the bottom-right corner, and the panel occupies only a corner of the workspace.

What is it

  • Plugin Name: dsh-whale-arcade
  • Maintainer: jitengfei
  • License: MIT
  • Position: Community-maintained floating whale arcade for DeepSeek Harness with five browser-local games
  • Mounting Method: Auto-mount, no manual Harness configuration required

It does not solve a development tool problem, but rather a brief waiting issue within the DSH Web Workspace: open a game, close the panel to continue working, and the Agent does not need to be paused.

Core Features

  1. Whale launcher permanently docked in the bottom-right corner. Opens to the game directory and panel.

  2. The panel occupies only a corner of the workspace. Pauses and preserves the current game session when the window is closed, without interrupting the Agent.

  3. Includes five games:

  • Whale Wave
  • Blue Whale Treasure
  • Whale Coast Run
  • Ocean Gomoku
  • Tidebound Ruins

  1. All five games support Start, Pause, Resume, and Restart.

  2. The three scoring games will save Top 10 leaderboards in the current browser origin. Tied scores are sorted by active play time and achievement time.

  3. Gomoku and Tidebound Ruins do not save leaderboards. Their board, stage, run-only upgrades, and selected difficulty only exist during the period the game is mounted. Closing the panel pauses and preserves the state; returning to the directory or refreshing resets these states.

  4. Manual pause, closing the panel, and hiding the browser tab do not count towards play time.

Installation and Usage

Before installation, ensure DeepSeek Harness can be started via dsh web and pnpm is available.

Install the pre-built plugin from npm below, then start DSH Web:

dsh plugin --profile web add dsh-whale-arcade
dsh web

If dsh web is already running, stop the old process first, then restart it, and refresh the browser. A whale launcher appearing in the bottom right indicates the plugin has been mounted.

If you haven’t installed the global dsh but are running DSH via npx, you can use the following commands:

npx @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web add dsh-whale-arcade
npx @deepseek-ai/dsh@0.1.0-rc.6 web

The current code has been installed and runs against DeepSeek Harness 0.1.0-rc.6. DSH is still a developer preview, and future versions may introduce incompatible changes.

Update and Removal

Update plugin:

dsh plugin --profile web update dsh-whale-arcade

Remove plugin:

dsh plugin --profile web remove dsh-whale-arcade

After updating or removing, if dsh web is running, the process needs to be restarted.

Installation from Source

Before installing from source, confirm the environment meets development requirements: Node.js 22.x branch (22.19+) or 24+, and pnpm 11.7.0.

First, clone the repository:

git clone https://github.com/jitengfei/dsh-whale-arcade.git

After entering the repository, follow the repository instructions to complete dependency installation and checks, then install the plugin from the current directory:

dsh plugin --profile web add .
dsh web

Use Cases and Notes

dsh-whale-arcade is suitable for DSH Web users to play short local mini-games in the workspace. It is not a cloud service and will not sync leaderboards remotely; the Top 10 for the three scoring games is only saved in the current browser origin.

Please note the following points:

  • The plugin mounts as a DSH Web plugin to shell.overlay and runs with the permissions of the current dsh process. You should inspect the source code, dependencies, and MIT license before installing.
  • Leaderboards are only valid in the current browser origin, not global or cross-device leaderboards.
  • The state of Gomoku and Tidebound Ruins is only preserved while mounted; closing the panel pauses, while refreshing or returning to the directory resets it.
  • Manual pause, closing the panel, and hiding the browser tab do not count towards play time.
  • DeepSeek Harness is still a developer preview. The current code has been installed and runs against 0.1.0-rc.6, and future DSH versions may introduce incompatible changes.
  • Third-party packages cannot inject games into already built plugins at runtime. If you wish to add games, you must follow the repository’s development workflow and rebuild.

Closing

The value of dsh-whale-arcade is specific: providing a browser game panel in the corner of the DSH Web Workspace that doesn’t enter the main flow and doesn’t interrupt the Agent. Installation, pause, resume, and restart are all designed around the “short wait” scenario.

  • GitHub: https://github.com/jitengfei/dsh-whale-arcade
  • Community Directory: You can search for dsh-whale-arcade in the DeepSeek Harness Community Directory; this introduction does not provide a fixed directory page URL. The Community Directory is an independent site and is not equivalent to the official app store.