@your-scope/dsh-quest-mascot

A whale-girl companion for the DeepSeek Harness (dsh) web UI — she sprawls on your composer, changes costume with the agent mode, and reacts to task progress. DeepSeek Harness Web UI 的鲸鱼娘伙伴插件——趴在输入框上，跟着模式换装，陪你打工。

Screenshots / 截图见仓库根 README：https://github.com/Horizon215/dsh-plugins

English

Features

Four costumes, one whale girl — she auto-follows the session's agent preset: standard = classic whale 🐳, PTC = geek whale 🤓, minimal = plain whale 🤍, cordis = starry whale 🔮. Custom presets fall back to the classic look. Right-click her to pin a costume per mode or return to auto
Sprawls ON the composer — pressed onto the input card's top edge, always in view; only her own body is clickable, everything else stays click-through
Reacts to your quest live — driven by the session event stream: planning 📋 → reading 📖 → thinking 💭 → working 🔨 → done 🎉 / stuck 😵‍💫, with a live bubble narrating step count and elapsed time
Pettable — single pat: blush + hearts; keep patting for combo easter eggs (7-hit combo sets off fireworks 🎆); double-click for a spin; hover wiggle. Fully keyboard reachable (Enter/Space to pat, focus ring included)
Dozes off — after 1/5/15 min (your choice) of idleness she falls asleep on the spot; one click wakes her
Quiet mode — silences ambient bubbles and pat voices; her face and status keep working
Ambient spout bubbles — when idle she slowly rotates quest reports (steps · ≈cost · elapsed), today's tally, tips and per-persona quips (four distinct voices)
Teams up with dsh-token-stats — reads its price config (localStorage contract, read-only) to report estimated costs; falls back to token counts without it
Settings section — "打工伙伴" panel: per-mode costume selects, quiet mode, doze delay
Polite — bilingual (zh/en follows UI locale), honors prefers-reduced-motion, all state in memory, nothing uploaded

Install

From source (npm package coming soon):

git clone https://github.com/Horizon215/dsh-plugins.git
cd dsh-plugins
pnpm install && pnpm build
dsh plugin --profile web add file:./packages/quest-mascot

Restart dsh web. The package declares dsh.bundle, so it joins the profile automatically — no config edits.

Notes

Requires dsh ≥ 0.1.0-rc.5 (verified on rc.5 / rc.6), web UI only
All state is in-memory; a page reload re-folds from the session log — nothing is uploaded
44 hand-directed frames (4 personas × 11 states), AI-generated (Seedream) then machine-cut to transparent PNGs, inlined at native 512px as lossless WebP data URLs (~5.8 MiB, pixel-identical to the masters) — one self-contained bundle, sharpness first
Costume & persona config lives in localStorage (dsh.quest-mascot.config.v1), sanitized on every read

Uninstall

dsh plugin --profile web remove @your-scope/dsh-quest-mascot

中文

功能

四套皮肤，同一只鲸 —— 跟随会话模式自动换装：标准=经典鲸 🐳、PTC=极客鲸 🤓、极简=素素鲸 🤍、创造=星光鲸 🔮；自定义 preset 回落经典鲸。右键可给某个模式钉死皮肤或恢复跟随
趴在输入框上 —— 身体压着输入卡片上沿，常驻可见；只有她自己的身体可点，其余区域全部点击穿透
跟着任务实时变脸 —— 由会话事件流驱动：规划 📋 → 阅读 📖 → 思考 💭 → 打工 🔨 → 收工 🎉 / 卡住晕圈，泡泡实时播报步骤数和耗时
摸头杀 —— 单击脸红冒爱心；连击有彩蛋（7 连击放烟花庆祝 🎆）；双击转圈圈；悬停歪头。键盘完全可达（Enter/空格摸头，带焦点环）
打瞌睡 —— 闲置 1/5/15 分钟（可调）就地睡着，点一下唤醒
安静模式 —— 关闭环境泡泡和摸头语音；表情和状态照常
闲置吐泡泡 —— 上轮战报（步数 · ≈成本 · 用时）、今日累计、小贴士、四套性格各不相同的俏皮话轮换
与 dsh-token-stats 联动 —— 读它的价格配置（localStorage 契约，只读）播报估算成本；没装则回退为 token 计数
设置页「打工伙伴」 —— 逐模式皮肤下拉、安静模式、打瞌睡延迟
懂礼貌 —— 中英双语跟随界面语言、尊重 reduced-motion、全部状态在内存、无任何上传

安装

从源码安装（npm 包稍后发布）：

git clone https://github.com/Horizon215/dsh-plugins.git
cd dsh-plugins
pnpm install && pnpm build
dsh plugin --profile web add file:./packages/quest-mascot

重启 dsh web。包内声明了 dsh.bundle，会自动加入 profile，无需改配置。

说明

需要 dsh ≥ 0.1.0-rc.5（已在 rc.5 / rc.6 验证），仅 Web UI
全部状态都在内存里，刷新页面会从会话日志重新折叠——没有任何数据上传
44 帧美术（4 角色 × 11 状态）为 AI 生成（Seedream）后机器抠图，512px 原尺寸以无损 WebP 内联（约 5.8 MiB，与母图像素级一致）——自包含单文件，清晰度优先
皮肤与偏好存在 localStorage（dsh.quest-mascot.config.v1），每次读取都做消毒回退

卸载

dsh plugin --profile web remove @your-scope/dsh-quest-mascot