DeepWhale Minimal Theme
A minimal theme plugin for the DeepSeek Harness Web UI. It preserves the default layout, typography, and interactions while adding a restrained deep-blue accent and a draggable whale-girl mascot above the account status in the lower-left sidebar.
Features
- Automatically follows the Harness light, dark, and system appearance settings
- Lets you drag the mascot anywhere in the window and remembers its position in the current browser
- Double-clicks the mascot to restore its default lower-left position
- Uses a clean transparent character asset without glow or drop-shadow effects
- Hides the mascot on narrow screens and scales it down in short windows
- Respects
prefers-reduced-motion
- Embeds the image during the build, with no remote asset requests at runtime
- Restores the stock interface when the plugin is removed
Local Development
Node.js 22.18+ or 24+ is required.
npm install
npm run check
Install the local checkout into the DeepSeek Harness Web profile:
dsh plugin --profile web add .
dsh web
Packaging
npm pack
The generated .tgz package can be installed directly for testing:
dsh plugin --profile web add ./dsh-deepwhale-minimal-theme-0.1.2.tgz
Publishing on GitHub
The repository includes a CI workflow. Run the following checks before pushing to GitHub:
npm ci
npm run check
npm pack --dry-run
Before publishing to npm, replace the package name, repository URL, and author information in package.json with your own values, then run npm publish.
Compatibility
This plugin uses the DeepSeek Harness dsh.client manifest and shell.overlay slot. Harness is still under active development, so future releases may require updates if the slot API changes.
License
The source code is available under the MIT License. See NOTICE for the artwork notice and attribution requirements. Do not publish the image assets until you have confirmed that you have the right to distribute both the supplied source image and its derivative.
