yuyu520fish/dsh-fishtank

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