@zsy1126/dsh-rick-and-morty

Readme

# 🌀 Rick and Morty for dsh

English | [中文](README.zh.md)

> **Wubba lubba dub dub!** The Rick and Morty bundle for the [DeepSeek Harness (dsh)](https://github.com/deepseek-ai/deepseek-harness) web GUI: three theme skins plus a desktop pet that watches your agent work. One command to install, one plugin for everything.

![C-137 Portal dark theme](docs/screenshot-c137-dark.png)

## ✨ Features

### 🎨 Three theme skins

A full 76-token takeover of the GUI palette, switched from three cubes in Settings (they shadow the stock Light/Dark/System row; each cube's icon is the theme's real palette swatch):

| Theme | Scheme | Vibe |
|---|---|---|
| 🥼 **Lab Coat** | light | Rick's lab coat with deep portal-green accents |
| 🔵 **Meeseeks Blue** | light | Mr. Meeseeks' soothing blue world |
| 🌀 **C-137 Portal** | dark | Space-green black, fluorescent portal green, Morty-yellow warnings |

![Meeseeks Blue light theme](docs/screenshot-meeseeks-light.png)

### 🐾 The pet: summoned to keep you company

Six characters (live-switchable in Settings), and **it senses what your agent is doing**:

| Agent state | Pet reaction |
|---|---|
| Turn starts | Bobs faster, shouts its working line ("Working working working!") |
| Task completes | Happy jump + celebration line |
| Error | Head-shake + grumbling |
| **Waiting for your approval / question** | ⚠️ Alert mode: constant wiggling + yellow urgent bubble until you handle it |
| Idle | Slow breathing bob |

The cast: 🔵 Mr. Meeseeks (default) · 🥒 Pickle Rick · 🧈 Butter Robot · 🧪 Rick · 😰 Morty · 🌀 Portal

### 🎮 Interaction and progression

- **Drag** the pet anywhere; the drop position sticks
- **Pet** it with a click (+1 familiarity); clicks within 2s chain into a **combo** with a ×N badge, and five in a row triggers per-character combo lines ("*burp* Alright ALRIGHT — what am I, a cat?")
- **Progression panel** on bubble click — five familiarity levels (Stranger → Family), career titles by tasks completed together (Intern → Chief Engineer of C-137), and a timestamped adventure log
- **Hide** via the 💤 cube in Settings; picking any character brings it back
- **Bilingual** — every line and label follows the dsh language setting (中文/English)

![Settings: theme and pet rows](docs/screenshot-settings.png)

## 📦 Install

Requires the dsh web GUI (`>= 0.1.0-rc.6`). One command:

```sh
dsh plugin --profile web add @zsy1126/dsh-rick-and-morty
```

Restart `dsh web` and hard-refresh the browser. To remove:

```sh
dsh plugin --profile web remove @zsy1126/dsh-rick-and-morty
```

## ⚙️ Data and storage

Every preference and save lives in browser localStorage; nothing is uploaded:

| Key | Holds |
|---|---|
| `rick-and-morty-skin.light` | Light-slot look (labcoat / meeseeks) |
| `rick-and-morty-pet.character` | Pet character |
| `rick-and-morty-pet.hidden` | Hide flag |
| `rick-and-morty-pet.pos` | Drop position |
| `rick-and-morty-pet.save` | Familiarity / tasks / adventure log |

The light/dark preference itself rides dsh's own settings and persists across browsers.

## 🛠️ Development

```sh
git clone https://github.com/zsyayo112/dsh-rick-and-morty.git
cd dsh-rick-and-morty
pnpm install
pnpm build        # strict tsc + tsdown into lib/
dsh plugin --profile web add link:$(pwd)   # link-install into a local profile
```

Layout: `src/index.ts` is the empty node half (the Loader roster seat); the real body is `src/client/` — the theme token table (`tokens.ts`), the line tables (`*-locales.ts`), and the mood machine plus both settings-row registrations (`index.ts`). Every color, line, animation duration, and progression number traces 1:1 to a frozen design spec.

## ⚠️ Disclaimer

This is an **unofficial fan project**, unaffiliated with Adult Swim, Warner Bros. Discovery, or DeepSeek. *Rick and Morty* and its characters are © Adult Swim / Warner Bros. Discovery. The character images in this repository come from fan-shared assets and are **not covered by the MIT license**; they are included for personal, non-commercial use and will be removed on request by the rights holders. The code is released under [MIT](LICENSE).

## 🙏 Credits

- [deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) — the everything-is-a-plugin host, whose client plugins taught this one how to be packaged
- [@linxin666/dsh-pet](https://www.npmjs.com/package/@linxin666/dsh-pet) (the whale girl) — the community-plugin packaging trailblazer