dsh-whale-voice

鲸声 · DSH Whale Voice

兼容 DeepSeek Harness 的非官方社区扩展。 基于官方语音输入模块的 MIT 代码修改，提供录音交互修复与海洋动态皮肤。项目由社区独立维护，与 DeepSeek 无隶属关系，也未经官方背书或品牌授权。

效果与功能

• 点击桌面、切换窗口或最小化窗口，录音继续进行。
• 录音时按 Enter（含小键盘 Enter）或点击原有发送箭头，停止录音、转写并发送；停止按钮只转写到草稿。
• 转写等待中连按 Enter 不会重复发送或提前发送旧草稿；中文输入法选字、其他输入框和弹窗中的 Enter 不触发语音发送。
• 海水从右向左铺开。海面波峰、波谷随麦克风音量变化，声音变化向左传播。
• 小鲸鱼按自己的节奏向左游泳、摇尾巴和轻轻晃动；音量控制海面。
• 海水铺满录音条后，太阳升起，光影渐暖，泡泡和水生植物出现。
• 两端圆角覆盖完整，支持窄窗口、高分辨率显示与无 WebGL 的动画回退。

以下图片来自模拟音频的界面测试，不包含真实聊天内容：

轻声：

大声（相同动画时刻，鲸鱼动作相同）：

当前支持范围

当前发布的是 Windows 桌面版补丁，会修改已安装应用的两个客户端模块，并非能直接加入插件管理器的独立插件。仅适配 0.2.0-rc.2 中已校验的模块构建；版本或代码哈希不匹配时拒绝修改。官方更新可能覆盖补丁。

仓库不包含官方完整应用、app.asar、用户配置或录音数据。安装器从你自己的应用中读取原始模块，在本机构建，并保留文件大小、偏移和 ASAR 完整性校验。

安装

需要 Node.js 22 或更高版本，以及一个受支持的 DeepSeek Harness 桌面安装。先下载本仓库或 Release 中的源码包，解压后打开终端：

npm ci --omit=dev

从系统托盘 完全退出 DeepSeek Harness；仅关闭窗口可能只是隐藏应用。将下面的示例路径替换为你自己的应用路径：

node scripts/install.cjs "D:\Apps\DSH\resources\app.asar"

安装器先检查版本、原始模块哈希和全包完整性，再在应用 resources/whale-voice-backups 目录生成备份与恢复记录。应用仍在运行时拒绝安装。安装完成后重新打开应用。

如果应用版本或模块哈希不匹配，请停止安装并提交版本信息。不要手动删除检查条件来强行安装。

从 0.1.0 升级

先从托盘完全退出 DSH。使用 0.1.0 安装时生成的恢复记录，运行原有的 scripts/restore.cjs 恢复到受支持的原始模块，再按上面的安装步骤安装 0.1.1。不要直接把新安装器指向已经装过海洋皮肤的归档，版本或哈希检查会拒绝覆盖。

恢复记录示例为 D:\Apps\DSH\resources\whale-voice-backups\installation-时间戳.json。请使用你自己的记录；如果记录丢失、应用已更新或恢复检查不通过，请停止升级，重新安装官方受支持的版本后再安装本补丁。不要上传恢复记录或备份。

撤销

从托盘完全退出应用，用安装时生成的本机恢复记录路径执行：

node scripts/restore.cjs "D:\Apps\DSH\resources\whale-voice-backups\installation-时间戳.json"

恢复脚本检查备份哈希和当前安装哈希。如果应用已经更新或再次修改，会拒绝覆盖。恢复记录包含本机安装路径，请不要上传它或整个备份目录。

隐私

海洋渲染器只读取录音器已有的 RMS 音量数据；图片、着色器和动画资源在本机内嵌，不增加皮肤联网请求、遥测或聊天日志。

语音转写仍使用 DSH 中配置的识别服务。服务可能上传音频进行识别，取决于你的服务配置；本项目不保证整个语音链路离线。详见 PRIVACY.md。

报告问题时请去掉密钥、账号、个人路径、聊天记录和真实录音；优先提供可复现步骤、应用版本和脱敏截图。

开发与验证

npm ci
npm test
npm run check:privacy
node scripts/build.cjs "D:\Apps\DSH\resources\app.asar"
npm run test:voice
npx playwright install chromium
npm run test:browser

构建输入需要是支持的原始版本，或者只安装了本项目早期语音修复的版本。已经装过海水皮肤的模块不作为原始输入。构建产物与测试报告在忽略的 build/ 中。

语音回归测试使用模拟录音和识别结果；界面测试使用真实 React 模块与模拟音量，不访问真实麦克风或发送模型消息。0.1.1 预发布验证包含 25 项语音回归检查、19 项浏览器集成检查，以及 14 项归档与工具检查。安装后的模块还在 Electron 44 中通过了同样的 25 项语音回归检查。

来源、许可证与品牌

• 上游：deepseek-ai/deepseek-harness，MIT，Copyright (c) 2026 DeepSeek。
• 修改的模块：@deepseek-ai/dsh-experimental-client-ui-voice-input 与 @deepseek-ai/dsh-client-ui-conversation。
• 本项目代码与海洋背景资源按 MIT 发布；素材来源与第三方许可见 NOTICE.md。
• 鲸鱼轮廓在本机构建时从已安装 UI 组件中读取，本仓库不单独分发官方 Logo 矢量文件。预览图片展示的是该本地集成效果。
• DeepSeek 的名称、Logo 和商标归各自权利人所有。MIT 代码许可证不授予商标权。请遵守上游 品牌素材使用规范，不得暗示官方合作、授权或背书。

如需将品牌动画用于独立产品标识或宣传，请先确认相应权利；“非官方”声明不能代替所需授权。