A whale-girl pet on the bottom-right corner of the DSH Web interface. Animations switch based on chat activity. Pat and feed to increase intimacy and level up. Features include naming, dragging, hiding, and summoning.
- Language
- TypeScript
- License
- Apache-2.0
- Branch
- main
Install
$ dsh plugin --profile web add @captain1275/dsh-petRun the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial
Install via your agent
Install the DeepSeek Harness plugin CAPTAIN1275/dsh-ui-web/packages/dsh-pet for me: review the repository at https://github.com/CAPTAIN1275/dsh-ui-web first, then run the install command and verify the plugin loads successfully.
Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.
One-Line Description
Raise a whale girl pet in the bottom-right corner of the DeepSeek Harness Web interface: she automatically switches animations when the model is thinking, waiting, using tools, or completed. You can pet her, feed her, rename her, and drag her around. Affinity grows from a baby whale all the way to "Deep Sea Bond."
Core Features
- Follows model conversation state to switch animations: "working" when thinking/calling tools, idle when waiting, jumping celebration when completed, breathing when idle
- Two interaction types: pet (10s cooldown, +1 affinity) and feed (30s cooldown, +5 affinity, -1 fish snack) with real-time bubble feedback
- 4-level affinity system: Baby Whale → Companion → Best Friend → Deep Sea Bond (100 points max), with "Level Up!" popup on tier advancement
- Fish snack economy: +1 for every 3 model turns completed, +1 naturally every 30 minutes, 20 max inventory
- Custom naming (1-20 characters), floating panel for feed/rename/hide, drag to reposition (position persisted), "Summon {name}" button appears in input area when hidden
- Global floating layer: always stays in bottom-right even outside session lifecycle (new session empty screen), not dependent on any specific session or UI slot
Technical Implementation
- Languages: TypeScript (with JSX) + Node.js (host half) + React 18 (browser half)
- Key Dependencies:
@deepseek-ai/cordis(plugin framework),@deepseek-ai/dsh-host-webserver(mount/api/pet/*and/pet/whale/*routes),@deepseek-ai/dsh-client-runtime+@deepseek-ai/dsh-client-ui-settings(browser half + settings card),schemastery(DSH settings schema validation), React 18 (injected by DSH shell) - Architecture Pattern: Dual-half cordis bundle.
src/index.tsis the host half, exportsname='pet'with cordisapply: constructPetServiceto listen tosession/event(turn/start, step/start, tool/call, turn/end dispatch to five phases: idle/waiting/thinking/tool/done), register settings section namedpetviainstallSettingsSection, mount routes based on enabled state.src/client/index.tsis the browser half,createRoot → document.bodyglobally mounts floating layer, polls/api/pet/stateevery 800ms, combined withvisibilitychangeto immediately fetch when tab returns to foreground, register i18n dictionary and mount settings card toweb-ui.plugin.itemslot - Entry Files: Host half at
packages/dsh-pet/src/index.ts, browser half atpackages/dsh-pet/src/client/index.ts, bundle declaration inpackages/dsh-pet/cordis.patch.yml:8-10(insertsid: pet), browser dependency injection inpackages/dsh-pet/package.json:37-49
Use Cases
Users who spend long periods running model tasks on DSH Web and want some companionship: the whale girl works at your feet when the model is thinking, jumps to celebrate when completed, and affinity naturally grows with usage time and work turns. Also suitable for those who want to add some "raising" feel to the DSH interface without complex configuration—just install and use. Disable, hide, and rename are all directly accessible in settings.
Prerequisites & Compatibility
| Dependency | Minimum Version | Description |
|---|---|---|
| DSH Host | 0.1.0-rc.6+ | peerDependencies locked to @deepseek-ai/dsh-* ^0.1.0-rc.6; runtime only depends on 4 browser-side @deepseek-ai/dsh-client-* packages |
| Node.js | ^22.19.0 or >=24.0.0 | Explicitly required in engines.node field |
| Platform | web (DSH browser side) | Package has dsh.client.platform: "web", no desktop/terminal adaptation |
| Native Modules | None | Runtime only imports clsx + schemastery (pure JS); CSS Modules inlined by lightningcss as <style data-plugin> |
| React | ^18.2.0 | peerDependency, injected by DSH shell |
Installation
dsh plugin --profile web add github:CAPTAIN1275/dsh-ui-web/packages/dsh-pet
Configuration Options
| Config | Type | Description | Default |
|---|---|---|---|
| Enable Pet (enabled) | Toggle | Master switch for plugin: when disabled, floating layer, polling, and API routes all stop | On |
| Show Pet (visible) | Toggle | Whether to display floating layer on screen; when hidden, "Summon {name}" button appears in chat input area | On |
| Size | Number (32-512, px) | Pet display size, equals single frame height of sprite sheet | 160 |
| Right Offset | Number (0-10000, px) | Horizontal offset from viewport right edge (real-time sync during drag) | 24 |
| Bottom Offset | Number (0-10000, px) | Vertical offset from viewport bottom edge (real-time sync during drag) | 20 |
| Name | String (1-20 characters) | Pet's display name, appears in floating panel and "Summon {name}" button | "鲸鱼娘" |
| Pet Cooldown | Internal constant (affinity.petCooldownMs) | Minimum interval between pets, adjustable in source | 10000 ms |
| Feed Cooldown | Internal constant (affinity.feedCooldownMs) | Minimum interval between feeds, adjustable in source | 30000 ms |
| Fish Snack Cap | Internal constant (treats.maxTreats) | Hard inventory cap | 20 |
| Affinity Cap | Internal constant (affinity.AFFINITY_MAX) | Cap on cumulative affinity points | 100 |
Note: Cooldown times, fish snack economy parameters, and affinity cap are constants built into source code in
affinity.ts/treats.ts. Default values work fine for regular users; if adjustment is needed, host can override viaaffinity/treatsfields inPetConfig.
FAQ
Q: I don't see the pet in the bottom-right after installation. What should I do?
A: First confirm you've restarted dsh web—cordis bundle injection only takes effect on host startup. If it still doesn't show, open the browser console to check for pet.state transport error, then go to Settings → Plugin Config → Pet and turn on "Enable Pet".
Q: Pet/feed isn't responding. Is it broken?
A: Most likely on cooldown. Clicking pet within 10 seconds or feed within 30 seconds will cause the whale girl to bubble "Already petted enough today" or "I'm full", and it won't work again until cooldown ends. Feed may also be rejected if fish snack inventory is zero.
Q: How do I replenish fish snacks when they're all used up?
A: No direct recharge. Two supply paths: +1 for every 3 model turns completed, +1 naturally every 30 minutes. Stops at 20, but affinity still grows slowly over time (+1 point every 30 minutes).
Q: Will I lose affinity and fish snacks when uninstalling the plugin?
A: No. All state (name, affinity, inventory, position, custom) is written to $DSH_HOME/pet.json (default ~/.dsh/pet.json). Uninstalling the plugin won't delete this file, and progress automatically restores upon reinstall.
Q: Can I swap to my own character or add multiple pets?
A: Not supported in current version. This plugin only has the built-in whale girl; there's no multi-pet registry or custom sprite sheet deployment mechanism. To change the character, you need to directly modify the sprite geometry definitions in spritesheet.ts and the sprite assets in source code.
Q: I can't see the pet config card in settings. What happened?
A: This means the current DSH version hasn't exposed the pet settings namespace to the settings page (some deployments limit WEB_SETTINGS_NAMESPACES whitelist). In this case, you can directly edit $DSH_HOME/settings.yaml, or add pet to the whitelist in dsh-host-apiproxy and restart.
Q: Can I rename the pet? Is there a length limit?
A: Yes, directly through the "Rename" entry in the floating panel, 1-20 characters, cannot be all whitespace. After renaming, both the summon button and floating panel will display the new name.
Difficulty Level
Beginner — Install and use immediately, zero config startup; optional advanced settings (size, position, naming) are all accessible in the settings card with a few clicks, no need to touch code or config files.
Known Issues & Limitations
- The
failedanimation already occupies a row (row 5) in the 9-state sprite sheet contract, but current rc.6 has no DSH event source to trigger it—model failures behave the same as idle - Plugin depends on rc.6's
session/event(turn/start, step/start, tool/call, turn/end) to derive animation phases; if host version is below rc.6 or session events are missing, the pet will stay in idle - When
pet.jsonfile is corrupted, the plugin silently falls back to default values and continues running; user's affinity, name, inventory, and position will be lost but no error is shown packages/dsh-pet/package.jsondeclares"license": "Apache-2.0", but subpackageLICENSEfiles are BSD-3-Clause—license metadata inconsistency; use repository rootLICENSEas the authoritative source- Browser half outputs
console.logandconsole.warndebug logs during apply and mount, which creates noise in production use scenarios
基于 zhu1090093659/dsh-web-ui(Apache-2.0)开发的 DeepSeek Harness(DSH)Web UI 插件套件。全套 22 个包已发布到 npm(
@captain1275/*)。
DSH Web UI 全家桶为 DeepSeek Harness 的 Web 界面提供一系列插件与皮肤:极光毛玻璃皮肤、任务看板、 SSH 运维、右侧文件/变更面板、Git 图谱、移动端远程控制、DeepSeek 娘看板娘(养成系)、实时令牌统计, 以及皮肤中心。所有插件既可独立安装,也可通过聚合包一次装齐。
极光 Aurora 皮肤效果(沉浸光感 / 深色 / 浅色)



特性
极光(Aurora)皮肤(支持动态背景)
- 毛玻璃输入框:高斯模糊(backdrop-filter 30px)+ 半透明玻璃底 + 细边框 + 内高光
- 自定义背景:URL / 本地图片 / 动图(GIF/WebP)/ 视频(mp4/webm) / 透明度 / 模糊调节,
深浅两套极光渐变;视频背景支持静音开关、本地文件持久化(存
~/.dsh/skin-aurora-media/,刷新不丢) - 仿Claude Code推理等级滑块:点击模型菜单的「推理等级」弹出 Effort 滑块面板——无极拖动、松手吸附、 WebGL 火焰跟随、OFF/MAX 刻度、Low/Medium/High/Ultracode 状态

- 用户消息气泡毛玻璃:与输入框统一的玻璃质感
DeepSeek 看板娘(养成系)
- 图片资源(社区同人资源,codex-pet-DeepSeek-girl)
- 养成系统:亲密度 4 级成长(幼鲸 / 伙伴 / 挚友 / 深海羁绊)、升级庆祝气泡、进度条、 Token 零食经济、使用时长成长(每 30 分钟 +1)
- 待机随机气泡:空闲时随机说话(live2d 风格文案)
- 摸头 / 喂食 / 改名 / 拖动,召唤按钮(live2d 同款贴边滑出)
Skill 人格设定
- 设置「人格设定」:开关启用/禁用常驻人格,编辑技能名、描述与人格正文
- 一键生效:保存后写入用户级技能
~/.dsh/skills/catgirl-rp/SKILL.md,DSH 技能系统实时加载, 所有新对话自动以该人格回应(含语气、动作表达、互动规则) - 内置猫娘人格:默认提供「小咪」猫娘人格(常驻生效、好感度系统、模式切换指令),可自由改写
- 可临时退出:对话中说「退出角色扮演模式」即切回普通助手,说「进入角色扮演模式」恢复

用量看板
- 彩色统计卡:累计 token、调用次数、缓存命中、估算费用(按 DeepSeek 官方定价)
- 近 14 天趋势:每日 token 消耗柱状图
- 模型分布:各 provider/model 用量环形图 + 图例
- 会话排行:Top 20 会话(标题 / 模型 / 调用数 / token / 费用)
- 自动记录:对话时自动采集 token 用量(会话快照替换语义,不双计),存
~/.dsh/usage.json - 侧边栏入口:彩色柱状按钮打开全屏看板
功能插件
| 插件 | 功能 |
|---|---|
| dsh-task-board | 侧边栏任务看板:多列 kanban、真实执行(驱动 agent 会话)、定时执行(cron) |
| dsh-ssh | SSH 运维:主机管理、远程执行、SFTP 传输、隧道、集群并发、Web 终端 |
| dsh-aionui-panel | 右侧「预览 / 文件 / 变更」面板:文件树、多格式预览、git 操作、文件拖拽 |
| dsh-git-graph | 会话头部 git 分支选择器 + 提交图 |
| dsh-live-stats | 实时 token 估算与生成速度 |
| dsh-full-stats | 完整统计行:覆盖官方统计(不省略)+ 运行状态指示 + 自定义状态文本(含替换官方 Deep diving...) |
| dsh-usage-dashboard | 用量看板:彩色统计卡 / 近 14 天趋势 / 模型分布 / 会话排行 / 费用估算 |
| dsh-web-ui-settings | 设置页「Web UI 插件」配置组 + 「人格设定」+「关于」版权页 |
| dsh-web-ui-all | 聚合包:一键安装全部插件 |
皮肤中心
10 套皮肤(ths / xp / blue-fantasy / dragon-heir / minecraft / miku / trading / whale-song / aurora / skin-center),支持皮肤启用互斥管理与一键切换。
其余皮肤(ths / xp / blue-fantasy / dragon-heir / minecraft / miku / trading / whale-song) 为上游 dsh-web-ui 自带皮肤。
安装
方式一:npm(推荐,已发布)
# 在 DSH profile 目录(~/.dsh/profiles/web)安装聚合包
npm install @captain1275/[email protected]
然后在 profile 的 package.json 里把 @captain1275/dsh-web-ui-all 加入
dsh.profile.bundles:
{
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"@captain1275/dsh-client-ui-skin-aurora",
"@captain1275/dsh-full-stats",
"@captain1275/dsh-web-ui-all"
]
}
}
}
重启 DSH 即生效。
方式二:从源码(开发)
git clone <your-repo-url> dsh-web-ui
cd dsh-web-ui
pnpm install
pnpm -r build
# 把本地包链接进 profile(junction)
node scripts/link-profile.mjs
开发
- 构建:
pnpm -r build(或pnpm --filter <package> build) - 新增皮肤:参考
packages/skins/aurora(skin.json+src/client+cordis.patch.yml), 然后用node scripts/skin-center-bundles重新生成注册表 - 聚合包 patch:编辑
packages/dsh-web-ui-all/aggregate.yml后node scripts/aggregate.mjs - 皮肤资产同步:
node packages/dsh-skins/build.mjs
目录结构
packages/
├─ dsh-task-board / dsh-ssh / dsh-aionui-panel / dsh-git-graph
├─ dsh-pet / dsh-live-stats / dsh-full-stats
├─ dsh-web-ui-settings / dsh-web-ui-all / dsh-skins
└─ skins/ # 皮肤源码(aurora、miku、ths 等)
scripts/ # 构建 / 注册表 / 链接工具
shared/ # 共享构建预设(tsdown.client.ts)
版权与许可
- 主体代码:zhu1090093659/dsh-web-ui,Apache-2.0
- 增强优化:@captain1275
- DeepSeek 娘精灵图:xpy12367/codex-pet-DeepSeek-girl, 社区同人资源,版权归原作者
- 人形图标:Font Awesome 6.7.2,CC BY 4.0
- 样式参考:live2d-widget(GPL-3.0,仅参考视觉风格,未搬用代码)
- 商标:DeepSeek 及其相关标识均为 DeepSeek 官方资产;本插件为社区开发者独立维护的非官方同人项目, 不代表 DeepSeek 官方立场。
Read the usage guide →
Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.
Listing badge
[](https://deepseek-plugin.org/plugins/CAPTAIN1275/dsh-ui-web/packages/dsh-pet)Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.