前言¶
在 DeepSeek Harness（DSH）的 Web 对话界面里，智能体阶段切换、流式输出和工具调用往往占满视线，聊天列侧的空白区域却很少有人利用。若你希望在不改后端、不增服务的前提下，给界面加一点可感知「当前在干什么」的视觉反馈，社区里有一条纯前端的路线：把宠物层叠在会话区域，让它跟着 agent 阶段和任务进度动。
下面介绍 Kingoff8 维护的 dsh-pixel-whale-pet（社区分类：趣味换装）。它在聊天区空白处游动，躲开消息文字和鼠标，并对思考、输出、工具调用等状态做出像素动画反应。
这是什么¶
dsh-pixel-whale-pet 是面向 DSH Web UI 的客户端插件：一只像素风小鲸鱼在会话列空闲区域游泳，根据智能体阶段与 todo 进度切换动作，偶尔喷水、戴耳机或在回合完成时放烟花。
- 维护者：Kingoff8
- 仓库：github.com/Kingoff8/dsh-pixel-whale-pet
- 目录页：skillhub.cn 插件条目
- 版本（package.json）：
1.1.0 - 许可证：MIT
- 运行方式：仅浏览器端；README 明确说明主机侧无服务、无工具依赖。
插件通过 package.json 中的 dsh.client 声明平台为 web，immediately: true，并向 @deepseek-ai/dsh-client-ui-conversation 注入脚本；bundle 使用 cordis.patch.yml。
核心功能¶
与智能体阶段同步¶
README 用状态表描述了各阶段对应行为（节选如下，完整列表见仓库说明）：
| 状态 | 触发时机（概要） | 表现 |
|---|---|---|
idle |
智能体空闲 | 慢游、摆尾、眨眼 |
thinking |
模型思考 | 思想云、口型与眨眼 |
writing |
流式输出 | 在笔记本上打字、代码行闪烁 |
tool |
工具执行 | 安全帽、电钻墙、火花与面板抖动 |
waiting |
等待确认或响应 | 感叹号气泡、挥鳍 |
done |
回合结束 | 跳跃、腮红、彩色烟花 |
error |
回合失败 | 灰云、雨滴、难过表情 |
sleeping |
长时间空闲 | 睡觉与 Zzz |
splash / music |
空闲时的「捣乱」 | 喷水柱、耳机与音符 |
此外还有 poke（点击）、drag（拖拽时夸张嘴型）、hop（撞墙弹跳）等交互态；快速逃开时带 is-fast 修饰（快速摆尾与气泡轨迹）。
躲开文字与指针¶
约每 160ms，小鲸鱼收集可见文本行与输入区（composer）的矩形，只在域外选目标；文字逼近或光标靠近时会溜进空闲角落。侧栏、缩放或 composer 尺寸变化时不瞬移，而是游过去；位置在刷新后仍会记住。
美术与构建¶
src/art.js：SVG 造型与各状态 CSS 动画src/engine.js：游动、避障、会话阶段监听scripts/build.mjs：将src/*.js打成根目录的client.js（仓库内已带构建产物）
角色美术致谢 Deepy 宠物/sprites 思路，来源 dsh-go。
安装与启用¶
插件是作为 DSH 配置文件 web 的 bundle 接入的，不是单独起一个后台进程。README 给出的步骤如下。
- 取得插件源码目录（按你一贯使用的 DSH 插件管理方式接入仓库路径即可；README 以 clone 为例说明要把该目录作为 bundle 挂到 web 配置，此处不展开具体 git 命令）。
- 在 web 配置里挂上 bundle，例如通过 DSH 插件管理器，或在
~/.dsh/profiles/web/package.json里用link:指到插件目录。 - 在对应 profile 里启用该插件条目。
- 刷新 Web UI 标签页。
根目录已有预构建的 client.js；若你改了 src/ 里的美术或引擎，在插件目录执行：
node scripts/build.mjs
然后再次刷新 Web UI。
说明：社区目录（SkillHub）与 DeepSeek、幻方无官方从属关系；安装前请自行浏览源码与 MIT 许可证。插件以当前 DSH 进程/浏览器页面的权限运行，与其它 DSH 插件相同，不应在未审阅的情况下盲目启用未知 bundle。
典型用法¶
日常开发中无需额外配置项或 API 调用：bundle 启用且 Web UI 加载 conversation 客户端后，小鲸鱼会自动出现在聊天列空白处，并随当前回合阶段变化。
你可做的交互包括：
- 点击小鲸鱼（
poke：爱心与 blush） - 用鼠标拖拽（
drag：夸张表情） - 观察长空闲后进入
drowsy/sleeping，以及回合完成时的done烟花
若界面语言需要与插件文案一致，仓库提供 locale/ 下 en、ru、zh 等 JSON 资源（随包导出）。
适用场景与注意¶
适合：长期在 DSH Web UI 里跑智能体、希望用轻量 overlay 感知阶段、又不愿部署额外服务的开发者或个人环境。
不太适合：只使用 CLI、无 Web conversation 界面的场景（本插件 dsh.client.platform 为 web）。
注意：
- 纯前端注入；不替代日志、指标或正式可观测性方案。
- 避障依赖 DOM 中文本与 composer 布局，复杂主题或全屏模式下手感可能与默认布局不同。
- 星标与社区热度会变动；以仓库 README 与
package.json为准。
结尾¶
dsh-pixel-whale-pet 把「智能体现在在哪个阶段」翻译成聊天区里一只会躲字、跟 todo、偶尔喷水放烟花的像素小鲸——零后端、MIT 协议，挂进 web profile 即可。
- 目录页：https://www.skillhub.cn/plugins/Kingoff8/dsh-pixel-whale-pet
- GitHub：https://github.com/Kingoff8/dsh-pixel-whale-pet
