DeepSeek Harness (DSH) 强调“一切皆插件”的架构，允许用户根据需求定制开发环境。在 DSH Web 界面中，模型推理时的状态通常仅显示 “Deep diving…” 等文字。为了在等待过程中提供更生动的视觉反馈，dsh-pixel-whale 插件应运而生。
插件定位¶
dsh-pixel-whale 是一个 Web 专用插件，由开发者 yoke233 维护。它为 DSH Web 添加了一个紧凑的、动画化的点云鲸鱼，该鲸鱼出现在 “Deep diving…” 状态之前。它不会改变提示、工具或模型请求，仅对界面进行视觉增强。
核心功能¶
- 视觉呈现：在 “Deep diving…” 状态前渲染一个 36x26px 的动画点云鲸鱼。
- 状态跟随：鲸鱼会跟随状态，在 UI 重新挂载时保持显示，在轮次结束时消失。
- 运动特性：采用平静的运动风格，像素颜色稳定，包含受控的呼吸效果和身体摆动。
- 可访问性：遵循
prefers-reduced-motion系统设置，为需要减少动画的用户提供支持。 - 作用范围：仅限 Web 平台，不修改任何提示词、工具调用或模型请求。
安装与启用¶
安装过程非常直接，只需一条命令：
dsh plugin --profile web add github:yoke233/dsh-pixel-whale
安装完成后，需要重启 DSH Web。在运行对话轮次时，鲸鱼会自动出现在 “Deep diving…” 之前。安装过程中可能会出现关于 DSH 和 React 的 peer-dependency 警告，这是正常的，因为 DSH Web 会提供这些运行时依赖。
实现机制¶
由于 DSH 目前未在私有轮次状态组件中暴露公共 Slot，该插件通过一个特定的 DOM 适配器实现。它使用 MutationObserver 跟踪当前对话的状态行，并利用 React Portal 将鲸鱼组件注入到指定位置。这种设计确保了鲸鱼仅作为视觉元素存在，不写入会话数据，也不替换状态文本。
注意事项¶
- 平台限制：此插件目前仅支持 DSH Web。
- 依赖警告：安装时出现的 peer-dependency 警告是预期的，不影响使用。
- 安全性：在安装前，建议检查源代码和许可证（MIT）。
总结¶
dsh-pixel-whale 提供了一种低侵入性的方式来增强 DSH Web 的交互体验。如果你正在寻找一种稳定、平静的像素动画来替代枯燥的文字状态提示，可以参考其 GitHub 仓库 或 插件目录 进行了解。
