dsh-status-rotator

dsh plugin --profile web add dsh-status-rotator

dsh-status-rotator

Give DSH's running status your own voice: custom phrases, typewriter output, day/night gradients, danmaku and an optional animated whale tail. Ships 1483 phrases, 14 theme packs; choose which packs to enable.

English | [中文](./README_ZH.md) · [Effects](#effect-preview) · [Install](#installation) · [Reference](#feature-overview) · [Changelog](./CHANGELOG.md)




A DeepSeek Harness (DSH) client plugin that replaces Deep diving... / 深度求索中... with editable phrases while preserving the host's elapsed-time clock.

Effect preview

Status text and light/dark gradients

Phrase rotation · Typewriter · Light/dark gradients · Official whale-tail sway. Captured from the actual plugin in a minimal DSH host, using sample phrases and an enlarged status row. Static preview.

Whale-tail animations

Reading left to right, top to bottom: Official sway → Flipping tail → Sway → Twist. Official sway uses its recommended 4-second cycle; the other three use 0.5 cycles/s. The icon containers stay fixed while the contours deform. Static comparison.

These actions ship in v0.35.0. Under Appearance → Whale tail, enable both Keep the whale tail and Tail motion, then choose the flipping tail, 24-frame sway, 36-frame twist, 150-frame official original sway, or random switching. Existing configurations without animation keep the flipping tail.

Choice · Behavior

Official sway · 150-frame action, recommended speed one cycle every 4 seconds

Flipping tail / Sway / Twist · Fixed speed or estimated tok/s; default level 3 tops out at 1.5 cycles/s

Random switching · Select an action pool shared by timed switching and optional tool-call triggers

Speed presets have 2–5 levels; custom tok/s maximums range from 1–10 cycles/s. The official action keeps its recommended speed unless you disable that option.

[Speed settings, action pools and tool-call triggers](#whale-tail-settings).

Appearance themes and danmaku

Classic / Neon / Terminal / Candy / Glitch set the font, glow, animation and gradient together. Pick a theme, then adjust its individual options. [Theme parameters](#appearance-themes).

Danmaku supports scrolling, top and bottom placement. Optional hover-pause, click-to-copy, phase colors and adaptive density are available in Settings. This is a captured frame with enlarged text and higher opacity for readability. [Danmaku parameters](#danmaku).

Installation

Install from npm through the Desktop plugin manager, or use dsh plugin add for Web. Restart the corresponding host after the first install.

Desktop npm walkthrough

DSH Desktop can install directly from npm without cloning this repository. The screenshots below show DSH Desktop 0.2.0-rc.2 with a Chinese interface; layouts may differ between host versions.

1. Open DSH Desktop, select Plugins (插件) in the sidebar, then click Add plugin (添加插件) at the top right.

2. Enter this in the Package name or address (包名或地址) field:

   dsh-status-rotator

Choose an Install source (安装源) suitable for your network. The screenshot uses the Mainland China mirror. Click Install (安装); Desktop downloads the npm package and registers the plugin.

3. Wait for installation to finish. Find dsh-status-rotator under Installed (已安装) and confirm that its enable switch is on. Follow any restart prompt; if the settings page has not appeared, fully exit Desktop, including its tray process, and reopen it.

4. Open the account menu at the bottom left, then Settings → Status Texts (设置 → 状态文案). Choose packs or edit phrases. For tail motion, enable Keep the whale tail and Tail motion under Appearance → Whale tail. Settings save automatically; start a new turn to see the status line.

<details>

<summary>Install the npm package from the command line</summary>

dsh plugin --profile desktop add dsh-status-rotator

Restart DSH Desktop afterward. Desktop uses the desktop profile; if your terminal cannot find `d

…(truncated)