前言¶

DSH 以插件方式扩展 Web 界面能力。日常使用 DSH Web 时，agent 的空闲、思考、调用工具、报错和完成不一定有足够直观的视觉反馈。nzl153/dsh-pet-whale 是一个 Web 桌宠插件，用一只小鲸鱼随 agent 状态切换动画，把当前状态放到页面角落。

这是什么¶

仓库标识为 nzl153/dsh-pet-whale，维护者为 nzl153。它的定位是：桌宠小鲸鱼，随 agent 状态切换动画的 DeepSeek Harness Web 桌宠插件（官方轮廓版）。许可证为 MIT，要求 DSH >=0.1.0-rc.6（web profile）。

核心功能¶

状态反馈¶

• 状态机：idle / think / working / celebrate / error / disappointed / wait
• 回合语义：有工具显示 working，无工具显示 think 深潜

交互与展示¶

• 单击戳戳、双击 360° 翻滚、拖拽移动并记忆位置、右键菜单
• WebAudio 合成六种音效，右键可关
• 7 套预设色板换肤：主题蓝 / 陶土 / 深海蓝 / 抹茶绿 / 樱粉 / 墨灰 / 夜黑
• 跟随 DSH 亮/暗主题自动切换样式
• 中文 / English 两套完整文案，接入 DSH 官方 locale 服务自动跟随
• 隐藏到右下角并可召回，小按钮随 agent 状态变色
• 页面切到后台自动暂停动画、音效和思考流
• prefers-reduced-motion 下自动降级为静态显示

安装与启用¶

要求：

DSH >=0.1.0-rc.6（web profile）

本地目录安装：

dsh plugin --profile web add link:/path/to/pet-whale

git 直装：

dsh plugin --profile web add "github:<user>/pet-whale#main"

安装命令包含占位符：link:/path/to/pet-whale 需要替换为实际本地路径，github:<user>/pet-whale#main 需要替换为实际 GitHub 用户。

装完重启 dsh web；client 半改动硬刷新（Ctrl+F5）。

典型用法¶

在线预览：

https://nzl153.github.io/dsh-pet-whale/preview.html

构建与测试：

pnpm install
pnpm typecheck
pnpm build
pnpm test

适用场景与注意¶

适合想在 DSH Web 页面中增加 agent 状态视觉反馈的人，例如通过小鲸鱼动画、音效、色板、隐藏召回和文案状态了解当前 agent 在做什么。

注意：

• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• 安装命令含占位路径/用户，需要按实际环境替换。
• 可选系统通知默认关，开启时才申请权限。
• 小按钮位置、隐藏状态、部分偏好使用 localStorage 记忆。
• 鲸鱼轮廓使用 DeepSeek 官方 FishLogo 路径（品牌素材，使用请注明出处）。
• patches/ 为个人自用 DSH 界面定制补丁，不是本插件组成部分。
• 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。

结尾¶

nzl153/dsh-pet-whale 把 agent 状态、交互、换肤、隐藏召回、多语言和无障碍降级放在一个轻量桌宠里，作为 DSH Web 的状态反馈扩展使用。

目录页：https://www.skillhub.cn/plugins/nzl153/dsh-pet-whale

GitHub：https://github.com/nzl153/dsh-pet-whale