前言¶
在 DeepSeek Harness（DSH）里跑智能体时，界面往往只有对话流本身：助手回复以文字为主，缺少一个常驻、可互动的视觉载体。若希望在不引入外部 3D 资源的前提下，给 Web 端挂一个与 DeepSeek 品牌气质相近的伴侣，并在助手输出时自动朗读、附带节奏反馈，就需要一个前后端一体的 DSH 插件。dsh-plugin-whale（Makesupper/dsh-plugin-whale）走的就是这条路线：基于 dsh-plugin 架构，在 Web 平台注入客户端 UI，监听会话事件并驱动前端能力。
这是什么¶
dsh-plugin-whale 是 Makesupper 维护的开源 DSH 插件（MIT License，当前 package 版本 0.1.0），分类为趣味换装。它提供程序化 3D「深度求索鲸鱼娘」舞台、对 LLM 助手回复的即时 Web Speech 朗读，以及朗读期间可配置的电子木鱼/清磬伴奏。插件入口为 ./lib/index.js，并通过 cordis.patch.yml 与 DSH 客户端槽位（@deepseek-ai/dsh-client-ui-slots）集成；dsh.client.immediately 为 true，面向 Web 平台加载。
社区目录页：https://www.skillhub.cn/plugins/Makesupper/dsh-plugin-whale（独立社区站点，与 DeepSeek / 幻方无官方从属关系）。源码：https://github.com/Makesupper/dsh-plugin-whale。
核心功能¶
3D 鲸鱼娘舞台（WhaleStage3D）¶
内置零外部依赖的程序化 3D 模型，包含 3D 透视投影、呼吸起伏、双马尾鳍与鲸尾摆动、眨眼，以及随语音变化的口型同步；另有伴奏迷你木鱼与深海声呐水波纹效果。同时预留外部 .glb / .gltf 挂载槽，可在不替换整套舞台逻辑的情况下换模型。
LLM 回复语音朗读（完全替换模式）¶
监听 DSH session/event 中的 assistant/message，自动清洗 Markdown 与代码块，按自然句切分后推入实时语音队列，由前端 Web Speech API 朗读。该模式在 README 中描述为「完全替换模式」，即由插件接管助手消息的朗读流程，而非仅做装饰性提示音。
木鱼伴奏与互动¶
当鲸鱼娘开始朗读 LLM 回复时，按设定节拍自动敲击电子木鱼/清磬并积攒功德；朗读结束后自动停止。默认节拍为 1200ms；面板可在 600ms / 900ms / 1200ms / 1800ms 间切换。也支持手动点击互动，以及常驻伴奏开关。
安装与启用¶
资料中未给出形如 dsh plugin add … 的固定 shell 安装命令。SkillHub 目录页提供「发送给 DeepSeek Harness 安装」指引，表述为：请安装 DSH 插件 Makesupper/dsh-plugin-whale（页面正文在此处有进一步说明，安装前建议在 Harness 中按社区指引完成插件拉取与启用）。
安装前请自行阅读 GitHub 仓库源码与 MIT 许可证；插件以当前 DSH 进程权限运行，会监听会话事件并在浏览器侧使用 Web Speech，启用前确认环境与隐私策略可接受。
本地开发与自测时，可在克隆后的仓库目录执行构建与测试（见下文「构建与测试」），这与在 Harness 中安装社区插件是两条路径，按需选择。
典型用法¶
构建与测试¶
在插件源码根目录：
cd dsh-plugin-whale
npm test
pretest 会先执行 npm run build，再运行 node --test tests/whale.test.js。
切换外部 3D 模型¶
方式一：挂件设置面板
- 点击挂件下方「⚙ 鲸鱼设置」。
- 进入「🧊 3D模型」。
- 填入
.glb/.gltf模型地址并保存。
方式二：前端事件
window.dispatchEvent(new CustomEvent('dsh-whale:load-model', {
detail: { url: '/path/to/deepseek-whale.glb' }
}))
上述 url 需指向 Harness Web 端可访问的模型路径。
适用场景与注意¶
适合希望在 DSH Web 界面增加趣味换装、可视化伴侣，并让助手长回复以语音形式呈现的场景。朗读依赖浏览器 Web Speech API，不同浏览器与系统语音包差异会导致音色与可用性不一致；3D 与动画在前端渲染，需注意页面性能与窗口尺寸。
插件会处理 assistant/message 内容并触发朗读与木鱼逻辑，请勿在不可信 Harness 环境中盲目安装。星标与社区元数据以目录页为准（当前 GitHub 星标为 0）；版本以 package.json 为准（0.1.0）。
结尾¶
dsh-plugin-whale 把 3D 伴侣、会话驱动的 TTS 与木鱼节奏收进一个 DSH 插件包，适合作为 Web 端 Harness 的轻量趣味增强。进一步说明与安装入口见 SkillHub 目录页 https://www.skillhub.cn/plugins/Makesupper/dsh-plugin-whale ，实现细节与许可证见 https://github.com/Makesupper/dsh-plugin-whale 。
