dsh-dafeiyu: A Windows Desktop Companion for DeepSeek Harness
qcytsn/dsh-dafeiyu
Desktop-native BigFish companion for DeepSeek Harness, showing real Agent status always on top.
Keep DeepSeek Harness Agent status on the Windows desktop as a transparent, always-on-top pet, so you can track real progress even when switching windows.
dsh plugin --profile web add github:qcytsn/dsh-dafeiyu- Category
- Entertainment
- Platform
- DSH-Plugin
- Author
- qcytsn
- Distribution
- Plugin
dsh-dafeiyu Key Features
dsh-dafeiyu Repository
dsh-dafeiyu Repo Summary
DSH BigFish is a desktop companion plugin (DSH plugin) for DeepSeek Harness, maintained by QCYTSN under the MIT license, designed for Windows 10/11 x64. It solves the problem of not being able to see the real working status of the DSH Agent when you are working in VS Code, a browser, or a file manager. BigFish stays on the desktop as a transparent, borderless, always-on-top native window, enabled by the DSH plugin and starting/exiting together with DSH, without needing a separate Helper or Python installation. It does not read the screen or monitor other applications; it only responds to real DSH Agent events, displaying project name, current phase, real todo progress, and distinguishing states like thinking, working, waiting, completed, and error, each with corresponding actions and natural copy.
What core features does the DSH BigFish DSH plugin support?
Core features include: always-on-top display of real DSH status; status card showing project directory name, current phase (e.g., analysis, implementation, verification), current todo, and real progress (e.g., 3/5 steps completed); drag support; click/double-click to trigger short interactions like head pat or poke; right-click menu to adjust size, bubble size, reduce motion, hide for this session, or close for this session. When multiple DSH sessions run simultaneously, it prioritizes the top-level task needing attention: waiting > error > working > thinking > idle. Settings include enable BigFish, character size (70%–140%), bubble size (80%–120%), activity level, reduce motion, and respond to sub-agents (default off).
How to install the DSH BigFish DSH plugin?
Before installation, fully exit the DSH Host (not just close the browser tab). In PowerShell, navigate to your DSH installation directory, then run the following command to install the current Alpha version:
cd D:\DSH
pnpm exec dsh plugin --profile web add dsh-dafeiyu@alpha
If your system can directly use the global dsh command, you can also run dsh plugin --profile web add dsh-dafeiyu@alpha. An alternative is to download the .tgz package from GitHub Releases (do not extract it), then in the DSH directory run pnpm exec dsh plugin --profile web add "C:\Users\you\Downloads\dsh-dafeiyu-<version>.tgz". After installation, start the DSH WebUI; the plugin is enabled by default and BigFish will be launched automatically.
How to use the DSH BigFish DSH plugin?
No extra steps are needed after installation: start DSH, start a project task, and BigFish will switch actions and status cards based on real DSH events. You can switch to other windows and continue working; BigFish remains on top of the desktop. When the DSH Host truly exits, BigFish exits automatically. The status card may show the project directory name, current phase, current todo, real progress (e.g., 3/5 steps completed), and waiting, completed, or error prompts. BigFish does not monitor VS Code, browsers, or other applications, nor does it take screenshots; only DSH Agent events can change its working state.
How to update the DSH BigFish DSH plugin?
After new commits appear in the GitHub repository, installed plugins do not change automatically. After a new release, fully exit DSH, then update the npm Alpha package:
cd D:\DSH
pnpm exec dsh plugin --profile web update dsh-dafeiyu@alpha
You can also re-run the install command, which will resolve the new version pointed to by the alpha tag. Users who installed via GitHub Release can download the new .tgz and overwrite install. All methods replace the plugin and its bundled Windows Helper, while preserving DSH saved settings.
Which DeepSeek Harness versions and platforms are compatible with DSH BigFish?
The current version is 0.1.0-alpha.7, a Windows MVP Alpha. System requirements: Windows 10/11 x64, a working DeepSeek Harness WebUI, and DSH CLI with plugin --profile web command. Regular users do not need to install Python, PySide6, or run dsh-dafeiyu-helper.exe separately; the Windows Helper is included in the release package. The current Alpha version's settings and desktop status copy are in Simplified Chinese.