MIT 协议的 DSH 桌面宠物插件，以官方 bundle 形式通过 `dsh plugin --profile web add` 安装，渲染在 DSH Web 界面右下角。
DSH 适配
兼容
作者声明
安全审计
未审计
最后核验
2026-08-21
许可证
MIT
01它能帮你完成什么？
Add a persistent desktop pet companion to the DeepSeek Harness Web GUI
A draggable, feedable, playable pet floating bottom-right, with animated states that react to sessions, tasks and approvals
DSH Web GUI users who want a fun resident companion while running agent sessions
Grow a companion that accrues seniority across your DSH usage
Seniority levels, titles and memories accumulated from completed tasks, sessions and companionship time
Long-term DeepSeek Harness users who want their usage history reflected in a companion
Keep the whale girl resident on your OS desktop, outside the browser
A standalone companion app (Node engine + Tauri shell) that stays on the desktop, connected to a local or remote DSH
Users who want the pet on their OS desktop instead of the DSH web page
02如何接入 DeepSeek Harness？
前置条件
- DeepSeek Harness (dsh) with the web profile — the plugin is managed via `dsh plugin --profile web`
- Optional desktop companion: Node ≥18 and Rust (cargo) for the Tauri rendering shell
安装步骤
- 01
Run `dsh plugin --profile web add "github:vlln/whale-girl#main"` (single-line git source, build artifacts committed)
$ dsh plugin --profile web add "github:vlln/whale-girl#main"
- 02
Alternative sources: `dsh plugin --profile web add whale-girl@0.1.0` (npm) or `dsh plugin --profile web add <path-to-whale-girl>` (local directory)
$ dsh plugin --profile web add whale-girl@0.1.0
- 03
Restart web — bundle layers compose at startup
- 04
Optional desktop companion: `npm install -g whale-girl-desktop`, run `whale-girl-desktop --headless` or build the Tauri shell via `cargo build --release` in `src-tauri`
$ npm install -g whale-girl-desktop
- 05
Update via `dsh plugin --profile web update whale-girl` (or switch the git ref), then restart
$ dsh plugin --profile web update whale-girl
验证接入成功
- After restarting web, the pet appears bottom-right: click for its menu (🍗 feed / 🎾 play), drag to move, hover for the status bar (seniority level / task count / recent shared memories)
03DSH 适配与能力边界
Official DSH bundle plugin installed via the `dsh plugin --profile web` CLI and rendered inside the DSH Web GUI
Event-driven pet state machine
DSH session / task events (task done, failure, approval, new session, idle ≥60s)→15 animated states — celebrate, error, disappointed, joy, eat, play, drag, walk, sleep, wake, welcome, think, working, wait, idle
Accrual-based growth (seniority, titles, memories)
Completed tasks, sessions and companionship time→Seniority levels, titles and shared memories shown in the hover status bar
XP / title thresholds are sealed and not configurable, to protect the accumulation ledgerLive configuration & character switching
`whale-girl:` section in `<dshHome>/settings.yaml` (or the settings UI); `whale-girl:character` in localStorage→Size / opacity / wandering / sleep toggles applied live without restart; cycling between characters
Setting `enabled: false` disables the in-page pet while a desktop companion runsStandalone desktop companion (optional)
whale-girl's public endpoints (`/state`, `/events`, `/presence`, `/interact`, `/config`, `/assets`)→Transparent always-on-top desktop pet connected to a local or remote DSH (Tauri v2 shell ~12MB, legacy Electron shell kept)
Not installed via `dsh plugin` — enabled manually (npm global install + cargo build)The in-page pet hides while the companion runs (presence contract) and returns after exit/crash (TTL 45s)
04适合谁？何时不该用？
适合
- DSH Web GUI users who want a fun resident companion while running agent sessions
- Long-term DeepSeek Harness users who want their usage history reflected in a companion
- Users who want the pet on their OS desktop instead of the DSH web page
不适合
- The optional desktop companion requires Node ≥18 plus Rust (cargo), and the first Tauri build takes about 5–15 minutes; it is not installed via `dsh plugin`.
05兼容性、维护与安全提示
- The optional desktop companion requires Node ≥18 plus Rust (cargo), and the first Tauri build takes about 5–15 minutes; it is not installed via `dsh plugin`.
- Growth semantics (XP and title thresholds) are sealed and not configurable — changing them would break the accumulation ledger.
- The in-page pet lives only in the DSH Web GUI and is hidden on onboarding pages; while the desktop companion runs, the in-page pet hides (presence contract).
MIT · actively maintained (last push 2026-08-18)
06常见问题
如何把 whale-girl 安装到 DeepSeek Harness？
它是通过官方 profile 管理的官方 bundle 插件：运行 `dsh plugin --profile web add "github:vlln/whale-girl#main"`（也支持 npm 源 `whale-girl@0.1.0` 或本地目录），然后重启 web。bundle 层在启动时组合完成后，宠物就会出现在右下角。
它是 DSH 原生插件还是 MCP 服务？
两者都不是——它采用官方 bundle 插件格式（根 `package.json` 中的 `dsh.bundle` + `dsh.client`），直接渲染在 DSH Web 界面内部，不依赖 MCP。
桌面常驻版需要什么前置条件？
桌面版是可选的，不通过 `dsh plugin` 安装：需要 Node ≥18 和 Rust（cargo）来构建 Tauri 壳（首次构建约 5–15 分钟）。它调用 whale-girl 的公开接口，默认连接本地 3080 端口的 DSH，也可用 `WHALE_GIRL_BASE_URL` 指向远程 DSH。
成长数据从哪里来？可以自定义成长规则吗？
资历等级、称号和记忆来自已完成任务、会话与陪伴时长的积累。XP 与称号阈值被刻意封存、不可配置，因为改动它们会破坏积累账本。
如何调整宠物大小、透明度或闲逛行为？
编辑 `<dshHome>/settings.yaml` 中的 `whale-girl:` 小节（或用设置界面），修改即时生效、无需重启。角色可通过 🎭 按钮或 localStorage 里的 `whale-girl:character` 切换。
07相关的 DSH 工作流
dsh-pet
作者 pc2005-cloud
DSH 桌面宠物：一行命令装好即用的透明动画小桌宠，支持多开、大小位置随心配置；还内置 DIY 素材链，能用 AI 视频自造专属宠物
dsh-dafeiyu
作者 qcytsn
DeepSeek Harness 的桌面原生大飞鱼陪伴插件，实时展示智能体状态，Windows 上置顶显示。
dsh-tavern
作者 flizzywine
基于 DeepSeek Harness（DSH）的 SillyTavern 类文字游戏 Agent，支持候选项生成、对话式人物卡编辑、剧本模式与素材抽取。
dsh-kun-like-pet
作者 liyupi
Kun Like 桌宠 —— DeepSeek Harness 桌面宠物插件：右下角小坤宠随 Agent 工作状态切换 9 种动作，任务完成播放「你干嘛~哎哟」
08数据与来源
Official **bundle plugin** (`dsh.bundle` + `dsh.client` in root `package.json`), managed via the official profile:
dsh plugin --profile web add "github:vlln/whale-girl#main" # single-line git source (build artifacts committed)
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-08-21。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。