像素鲸鱼状态伴侣yoke233/dsh-pixel-whale

dsh-pixel-whale 会在 DeepSeek Harness Web 的 Deep diving... 状态前紧挨着添加一只小巧的动画点云鲸鱼。它随运行中的回合出现，在 UI 重新挂载时跟随状态，并在回合结束时离开。

在 DSH Web 中查看效果

此截图由生产浏览器包渲染。在动态效果中，鲸鱼的大头保持沉稳，而身体弯曲，尾巴和鳍回弹，小型气泡场景在循环之间轮换。它的像素使用克制的蓝色调色板与稳定的颜色——动感来自身体，而非闪烁的点。

安装

dsh plugin --profile web add github:yoke233/dsh-pixel-whale

首次安装后重启 DSH Web。鲸鱼会在回合运行时自动出现；无需配置任何命令或设置。

安装程序可能会报告 DSH 和 React 包的 peer-dependency 警告。这些包由 DSH Web 宿主提供；以 Done 结束的完整安装是预期结果。

工作原理

1. 插件通过 DSH 会话作用域的 conversation.input.dock 生命周期挂载。
2. useSession 提供权威的运行状态。
3. 一个作用域化的 MutationObserver 跟随当前会话的状态行。
4. 一个 React portal 将鲸鱼放置在 Deep diving... 之前，并在回合停止或插件卸载时清理它。

DSH 目前未在其私有回合状态组件内公开公共 Slot，因此这个小型 DOM 适配器被有意隔离到单个选择器和单个当前会话观察器。它不会替换状态文本或写入会话数据。

设计细节

- 紧凑： 以 36 × 26px 渲染，并保持在状态行上。
- 状态感知： 仅在当前会话运行时可见。
- 平静的动态： 稳定的像素颜色、克制的呼吸、更大的身体和尾巴运动。
- 无障碍： 遵循 prefers-reduced-motion。
- 仅限 Web： 不改变提示词、工具、模型请求或宿主行为。

开发

pnpm install
pnpm check

pnpm check 运行 TypeScript 验证、动态与 DOM 生命周期测试，然后构建宿主和浏览器入口。发布包完全由已发布的 npm 依赖构建，并且仅包含生成的 lib 输出、bundle patch、README 和许可证。

兼容性
- DeepSeek Harness 包：^0.1.0-rc.6
- Node.js：^22.19.0 || >=24
- 界面：DSH Web

状态行选择器遵循当前的 DSH Web 标记。如果 DSH 之后公开专用的回合状态 Slot，适配器可以迁移到该 Slot，而无需更改动画引擎。

许可证

MIT