前言¶
DeepSeek Harness（DSH）把对话壳、扩展点和插件打包在一起，开发者可以在官方 UI 插槽里加视觉层，而不必 fork 整套前端。若你希望在写提示、跑智能体的同时，用系统正在播放的音乐驱动界面律动，并在输入框附近显示同步歌词，单独写浏览器脚本或改主题往往对不上 SMTC 进度和真实音频。下面介绍社区插件 摸鲸鱼（dsh-plugin-moyu，维护者 TYWIM），它面向 DSH 提供 Windows 下的音乐律动与歌词显示；小说阅读、可独立配置的多功能模式在 README 中标注为规划中、尚未实现。
这是什么¶
摸鲸鱼 是面向 DeepSeek Harness 的摸鱼工具箱（目录分类：趣味换装）。当前已实现的能力集中在 Windows：宿主侧通过常驻 PowerShell 媒体桥采集 SMTC「正在播放」信息、WASAPI 系统回环音频与 48 频段 FFT，解析歌词后经本机 GET /moyu/stream（SSE）推给浏览器；浏览器侧在 DSH 官方插槽里渲染，不替换 DSH 自带 UI。非 Windows 平台（process.platform !== 'win32'）插件保持休眠，不启动媒体桥。
插件版本为 0.1.0（package.json），要求 DSH >=0.2.1-rc.2、Node ^22.19.0 || >=24.0.0，许可证 MIT。GitHub 仓库：TYWIM/dsh-plugin-moyu；社区目录页：SkillHub · dsh-plugin-moyu（独立社区站点，与 DeepSeek / 幻方无官方从属关系）。
显示位置与两种模式¶
全部 UI 走官方插槽，便于与 DSH 布局共存：
| 内容 | 插槽 |
|---|---|
| 火焰 / 频谱律动 + 顶部歌词 | conversation.input.dock |
| 摸鲸模式底部歌词条 | conversation.composer.dock |
| 鲸鱼按钮（设置面板） | conversation.input.right |
| 标题旁歌词胶囊 | conversation.session.header.actions |
| 左右侧边歌词 | shell.overlay |
正常模式：输入框正上方一条柔和极光带（由 48 频段真实回环频谱驱动），可切换「频谱」细条或「两者」；歌词默认叠在光带上方。律动强度可选 平缓（频段分组、较慢回落）或 动感（默认，直接使用 48 频段）；连续插值可减轻跳动，但会带来一定延迟。效果由音频驱动，并非自动节拍识别。
摸鲸模式：律动完全隐藏，歌词缩到输入框下方状态栏；滚轮在「信息 / 歌词」之间切换；标题胶囊与侧边歌词同时收起。
歌词与配色¶
歌词来源：本地 .lrc（按歌名/歌手匹配）、网易云、LRCLIB。歌名和歌手来自 SMTC；联网时会向相关服务发送歌名和歌手，结果（含歌词）缓存在 $DSH_HOME/dsh-plugin-moyu/cache。切换来源或关闭联网不会自动清除旧缓存，使用前请自行评估隐私与歌词版权。
设置面板中可配置歌词位置（顶部 / 左侧 / 右侧 / 标题旁 / 底部条）、开关、字号 9~24 px、颜色（跟随主题或自选）。配色支持 RGB 流转 或 色标（默认，1~8 色渐变，含 8 套预设）。偏好保存在浏览器 localStorage（键名 dsh-plugin-moyu:prefs:v4）。
宿主配置¶
在 cordis.patch.yml 的 config 中可调整媒体桥与歌词策略：
- id: moyu
config:
lyricsDirs: ['D:/Music/lyrics'] # 本地 .lrc 目录，按「歌名/歌手」匹配
onlineLyrics: true # 允许请求网易云 / LRCLIB；会发送歌名和歌手
sourceOrder: auto # auto | local | online
intervalMs: 100 # 媒体桥采样间隔（毫秒）
auto 模式下即使找到本地歌词，也可能仍请求网易云。面板里还可调「歌词偏移」，用于部分不更新 SMTC Position 的播放器（README 举例汽水音乐）导致的长时进度外推误差。
安装与启用¶
DSH 生态强调「一切皆插件」；本插件在 SkillHub 目录页提供「发送给 DeepSeek Harness 安装」说明，插件标识为 TYWIM/dsh-plugin-moyu，按该页原文复制给 DSH 或按你环境中的插件安装流程操作即可。资料中未给出独立的 shell 安装命令，请勿自行拼接未在文档出现的 CLI。插件以当前 DSH 进程权限运行，安装前应阅读 GitHub 源码 与 MIT 许可证。
典型用法¶
- 在 Windows 上安装并启用插件，确认本机 DSH 版本满足
>=0.2.1-rc.2。 - 用系统默认支持 SMTC 的播放器播放音乐；必要时在
lyricsDirs放置本地 LRC，或开启onlineLyrics并设置sourceOrder。 - 点击输入框右侧 鲸鱼按钮 打开设置：选择正常 / 摸鲸模式、律动样式与强度、歌词位置与配色。
- 摸鲸模式下在输入框下方歌词条上用滚轮切换「信息 ⇄ 歌词」。
经过上面的步骤，对话界面会在官方插槽中显示律动与歌词，而不接管 DSH 核心 UI。
适用场景与已知限制¶
适合在 Windows 上长时间使用 DSH、并希望用真实系统音频做轻量视觉反馈、同时本机查看歌词的开发者。不适合需要 macOS / Linux 媒体桥、或依赖精确节拍检测的场景。
README 列出的限制包括：仅 Windows 启动媒体桥；WASAPI 回环与 FFT 加平滑会带来延迟；歌词仅供本机显示，勿批量抓取或再分发。若播放器长时间不更新 SMTC 进度且循环播放，歌词可能对不齐，需用面板偏移修正。
结尾¶
摸鲸鱼把 Windows 媒体桥、歌词解析与 DSH 官方插槽接在一起，在当前版本里专注音乐律动与歌词展示；后续规划中的小说阅读等功能以仓库 README 更新为准。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库。
