鲸鱼小宠 z15692312501/deepseek-haeness-pet

DeepSeek Harness 鲸鱼小宠物

一个 DeepSeek Harness Web GUI 的浮动鲸鱼吉祥物 —— 灵感来自 DeepSeek 鲸鱼 logo 和 Codex 的「宠物」—— 实时展示智能体当前在做什么。

一个 DeepSeek Harness Web GUI 的浮动鲸鱼小宠物（参考 DeepSeek 鲸鱼 logo 与 Codex 的宠物功能），实时展示当前智能体 / 工具的执行状态。

（把运行截图放到 docs/demo.png 展示效果）

⚠️ 先看这里

这不是一个可以独立使用的 npm 包。 它是为 DeepSeek Harness monorepo 写的插件：依赖 harness 内部的 @deepseek-ai/ workspace 包与构建管线（tsc + tsdown + Typert Remote 代码生成）。要用它，你得把这两个包拷进 harness 仓库，接入 composition，然后重新构建 —— 见下文「集成步骤」。

它不是一个可以 npm install 直接用的独立包。 这是为 DeepSeek Harness monorepo 写的插件：依赖 harness 内部的 @deepseek-ai/ workspace 包与构建管线（tsc + tsdown + Typert Remote 代码生成）。使用方式是把它拷进 harness 仓库、接入 composition 并重新构建，见下文「集成步骤」。

功能

一只小蓝鲸浮在 GUI 角落，反映智能体循环的状态：

| 状态 | 行为 | 状态说明 |
| idle | 缓慢呼吸，气泡显示 空闲中 · 待命中 | 空闲：缓慢浮动 |
| thinking | 加快上下浮动 + 蓝色脉冲，思考中… | 思考中：加速浮动 + 蓝色脉冲点 |
| running a tool | 喷水 + 绿色脉冲，正在执行 <tool> · <arg> | 执行工具：喷水动画 + 绿色脉冲点 |

点击鲸鱼可展开「最近活动」日志，可拖拽移动位置；配色随 GUI 明暗主题自适应，走的是 --dsw-alias-* 设计 token。

点击鲸鱼可展开「最近活动」日志，可拖拽移动位置；配色随 GUI 明暗主题自适应。

架构

两个包，按 Harness 的 host/client 边界拆分：

| 包 | 平面 | 职责 |
| @deepseek-ai/dsh-pet | Host | 监听 agent/status、tools/pre-execute、tools/result，维护当前状态与活动环形缓冲，通过 @Remote('state') 暴露只读快照。 |
| @deepseek-ai/dsh-client-ui-pet | Client | dsh.client 插件，在 shell.overlay 浮动层画鲸鱼，约每 700ms 轮询 ctx.remote.pet.state()。 |

| 包 | 平面 | 职责 |
| @deepseek-ai/dsh-pet | Host | 监听 agent/status、tools/pre-execute、tools/result，维护当前状态与活动环形缓冲，通过 @Remote('state') 暴露只读快照。 |
| @deepseek-ai/dsh-client-ui-pet | Client | dsh.client 插件，在 shell.overlay 浮动层画鲸鱼，约每 700ms 轮询 ctx.remote.pet.state()。 |

目录结构

packages/
├── pet/pet/ → host service, copies to <harness>/packages/pet/pet/
└── client/ui-pet/ → client UI, copies to <harness>/packages/client/ui-pet/

集成步骤

把这两个包拷进 DeepSeek Harness 仓库，然后接入 composition、project references、路径映射和 Remote 装配。完整的有序清单在 docs/INTEGRATION.md —— 这份清单是实际把构建跑通之后总结出来的，照着做就行。
把两个包拷进 DeepSeek Harness 仓库，然后依次接入 composition、project references、路径映射、Remote 装配。完整步骤见 docs/INTEGRATION.md——它是实测构建通过后整理出来的，请按步骤来。

Quick sketch（速览）:

1. 把 packages/pet/pet 和 packages/client/ui-pet 拷进 harness 仓库。
2. 在 packages/bundle/web-app/cordis.patch.yml 里加上 pet + ui-pet 两行，同时在那个 bundle 的 package.json dependencies 里镜像一份（漏掉这一步就是经典的 ERR_MODULE_NOT_FOUND）。
3. 注册 project references、dsh-pet 路径映射和 remote.pet 装配（见 INTEGRATION.md）。
4. pnpm install → pnpm run build → 重启 dsh web → 刷新。

Compatibility / 兼容性

Built and verified against the DeepSeek Harness revision it was developed on. Because the integration touches the harness's explicit reference/manifest lists, the exact line positions may drift across harness versions — treat the steps as a guide and reconcile against the files in your checkout.

在与开发时同版本的 DeepSeek Harness 上构建并验证通过。因为集成要改 harness 的显式引用清单，不同版本的行位置可能变化——请以你本地 harness 的文件为准做对齐。

License / 授权

MIT — same as the DeepSeek Harness itself.