dsh-fishtank
A small fish for DeepSeek Harness. It has its own memory, mood, relationships,
quiet thoughts and a diary — and it remembers you between sessions.
Install it, talk to it, come back tomorrow. It is not a chatbot wrapper: the
fish is the data. Everything it knows lives in one JSON file you can export,
back up and carry to another machine.
Install
From the plugin market (Discover) or directly from this repository — both
install the same bundle. The package declares dsh.bundle, so the plugin
manager can install it from source:
https://github.com/yuyu520fish/dsh-fishtank
The bundle ships both halves: a Host plugin (the fish, its data and timers)
and a Web client (the tank page and its sidebar icon). After installation,
reload the page and click 鱼缸 in the left sidebar.
What it does
- Talks — replies in character, short, never breaks into assistant-speak.
- Remembers — facts it is told, with the mood and reason of the moment they
were said, plus the date ("next Friday" becomes an actual date).
- Feels — a mood and an energy value that move with how it is treated and
how much it has been talking.
- Knows people — a warmth score per person, grown by conversation.
- Thinks alone — after ~25 quiet minutes it may produce a private thought;
in the evening it reflects on the day and writes its diary.
- Remembers being kicked/logged out — it will not pretend nothing happened.
Tools
| Tool | Purpose |
|---|
fishtank_talk | Say something to the fish (text, optional from). |
fishtank_status | Directory, mood, counters. |
fishtank_export | The whole fish as portable JSON. |
fishtank_import | Restore a fish from fishtank_export output. |
Page
The Web half adds a real tank page: status row, conversation bubbles, an input
box, and the last whisper / diary line. It talks to the Host over two
same-origin routes (/fishtank/state, /fishtank/talk).
Data
One file, default ~/.dsh/fishtank/default/fish.json:
mood, energy, facts[], people{}, whispers[], reflections[], diary[],
self, history[], thought{}, reflect{}
fishtank_export produces { v, exportedAt, fish }; fishtank_import accepts
it back, replacing the current fish. Keep the export — the fish is the data.
Config
All optional:
| Key | Default | Meaning |
|---|
fishFile | ~/.dsh/fishtank/default/fish.json | Where the fish lives |
provider | deepseek-account | LLM provider id |
model | deepseek-flash | Model id |
ownerName | 主人 | What its human is called |
License
MIT
