Big Fat Fish Girl for DeepSeek Harness
Big Fat Fish Girl is a desktop pet for DeepSeek Harness. She stays above other apps in a
transparent window while Harness is minimized and follows work across all chats. She shows
current activity, tool use, requests, completion and errors.
Clicking her brings Harness forward on its last-open chat, not a specific session.
Features
- Tool activity: scenes for reading, editing, commands and general work, with distinct
commentary for browsing and search. Tool names and arguments are not sent to the browser.
- Requests: pending requests take priority over other animations.
- Token usage: displays provider-reported input and output counts after completion when
available. It does not estimate costs or balances.
- Idle behavior: cursor gaze, hover reactions, random animations, sleep and occasional
horizontal movement. Each behavior can be disabled in Harness settings.
- Long runs: an optional snack animation can appear after 3–5 minutes of continuous work.
- Languages: English by default, with Russian and Simplified Chinese available in settings.
- Character: DeepSeek Chan (Big Fat Fish Girl) is the only bundled skin.
- Reduced motion: uses a stable frame for each state and disables transitions.
DeepSeek Chan animation frames from all five shipped atlases
Generated from every shipped DeepSeek Chan atlas by node scripts/build-preview.mjs.
Requirements
- DeepSeek Harness 0.2.0-rc.2 (the event contract is verified against it — see
docs/HARNESS-CONTRACT-v0.2.0-rc.2.md).
- A Harness profile with the web interface, such as
web or desktop.
- Runtime dependency:
@deepseek-ai/schemastery.
See it move
These captioned loops are rendered from the shipped DeepSeek Chan art by
node scripts/build-preview.mjs; the atlas overview above includes every animation sheet.
What she says
These samples were captured from the running preview with npm run preview:lines.
English — default:
Russian:
Simplified Chinese:
The amber bubble is Harness's own approval colour, used when she needs you or is changing
something. A quiet moment has no line at all — the last frame above.
Install
Download the plugin .tgz and the separate macOS app from the same
GitHub release. You can also build
the app from that release's source tag.
The plugin package contains runtime code and sprite atlases, without demo GIFs, screenshots,
source art or build tools. Install the .tgz, not GitHub's larger Source code archive.
Follow the macOS install guide
for both routes, checksums, Gatekeeper and post-install verification.
Settings
Settings live in Harness's Settings panel, in the Big Fat Fish Girl section
(size and opacity are sliders — the pet changes as you drag); the same values are also
editable from the Plugins panel's Configure form. The pet carries no menu or panel of its
own, and the position is the only thing kept per window.
| Setting | What it does |
|---|
| Size / Opacity | 88–172 px and 0.35–1 |
| Reduce motion | Freezes to each state's readable anchor frame and stops transitions |
| React to hover | On/off for the cursor reactions |
| Random antics | On/off for the spontaneous idle actions |
| Snacks | On/off for the snack after long work |
| Token count display | On/off for provider-reported counts after a completed job |
| Wandering | On/off for the autonomous strolls |
| Language | English by default; Russian and Simplified Chinese are also available |
For state aggregation and priority details, see docs/ARCHITECTURE.md.
Desktop shell
For shell startup and bridge details, see desktop/README.md. Build and
platform information is in desktop/tauri/README.md.
Development
Node.js 22 or newer is required for development. Install dependencies and run the checks:
npm install
npm run check
npm run build
npm run build:desktop
node preview/server.mjs
npm run preview:art regenerates the art previews. Install its pinned Pillow version with
python3 -m pip install --requirement scripts/preview-requirements.txt. See preview/README.md for
the local playground, docs/ARCHITECTURE.md for the module map, and
docs/adding-an-animation.md to add an animation.
Editable PNGs and original pose boards live on the separate art-source branch. Normal builds,
tests and previews use the committed runtime atlases and do not download source art. See the
art source guide only if you want to rebuild the atlases.
Known limitations
- The tested macOS desktop build is arm64; Intel is untested.
- Windows builds are untested. Linux builds are not available.
- The pet stays above ordinary windows; full-screen coverage is not promised.
- Settings are per profile. Installing the plugin into two profiles gives you two
independent pets; the pet's window position is the only thing kept per browser window.
- Token counts are provider-reported or omitted. The plugin does not estimate money;
cost, balance and remaining-quota APIs are not part of the verified Harness contract.
- Other Harness versions are not certified. The event contract is verified against
0.2.0-rc.2. The 0.2.1 startup-origin fix does not verify that version's full event contract.
Privacy
- The plugin makes no outbound requests and sends no telemetry.
- It keeps transient session IDs and status changes in memory. It never reads prompt text,
responses, tool arguments or session titles.
- For navigation, the plugin sends an opaque ID for the session with an open request or task.
The ID contains no content, and the host accepts it only while that session is open.
- Provider-reported input and output token counts are summed per task and sent as numbers
only; model names, message IDs and content are not sent with them.
- Display preferences stay in the Harness profile; only the pet's window position is stored
in browser local storage.
- See the verified Harness contract for event details.
Issues and feature requests: GitHub Issues.
License
Code: Unlicense, dedicated to the public domain.
Character artwork: not covered by the code dedication; reuse terms are not granted here — see ASSET_LICENSE.md.
