摸鲸鱼 · dsh-plugin-moyu

面向 DeepSeek Harness 的摸鱼工具箱。目前提供 Windows 音乐律动与歌词显示；小说阅读和可独立配置的多功能模式仍在规划中，尚未实现。

• 宿主侧：常驻 PowerShell 媒体桥（SMTC 正在播放 + WASAPI 真实系统回环音频采集 + 48 频段 FFT 频谱分析）→ 解析歌词（本地 LRC / 网易云 / LRCLIB）→ 本机 GET /moyu/stream（SSE）。
• 浏览器侧：在官方插槽里渲染，不替换 DSH 自带 UI。

显示位置（全部走官方插槽）

内容	插槽
火焰 / 频谱律动 + 顶部歌词	conversation.input.dock（紧贴输入框上沿，宽度跟随输入框，两侧平滑淡出无硬边界）
摸鲸模式的底部歌词条（滚轮切「信息 ⇄ 歌词」）	conversation.composer.dock
鲸鱼按钮（设置面板入口）	conversation.input.right
标题旁歌词胶囊	conversation.session.header.actions
左右侧边歌词	shell.overlay

两种模式

• 正常模式：输入框正上方一条柔和极光带（顶部无实线、越往上越透明发散、底边贴着输入框、两侧无硬边界自然淡出、两侧保持低浮动，由 48 频段真实回环频谱驱动波澜起伏）；也可切「频谱」细条或「两者」。歌词默认叠在光带上方。
• 摸鲸模式：律动完全隐藏，歌词缩到输入框下方那一条状态栏，滚轮在「信息 / 歌词」之间切换；标题胶囊与侧边歌词同时收起。

正常模式的「律动强度」可选择平缓（频段分组、较慢回落）或动感（默认，直接使用 48 频段）。连续插值可减少更新间隔引起的跳动，但会带来一定延迟。两者均为音频驱动的视觉效果，并非自动节拍识别。

配置（cordis.patch.yml 的 config）

- id: moyu
  config:
    lyricsDirs: ['D:/Music/lyrics']   # 本地 .lrc 目录，按「歌名/歌手」匹配
    onlineLyrics: true                 # 允许请求网易云 / LRCLIB；会发送歌名和歌手
    sourceOrder: auto                  # auto | local | online
    intervalMs: 100                    # 媒体桥采样间隔（毫秒）

歌名和歌手来自 SMTC。当前实现先检查缓存；auto 模式下即使找到本地歌词，也可能请求网易云。联网时歌名和歌手会发送给相关服务，结果（含歌词）会缓存在 $DSH_HOME/dsh-plugin-moyu/cache；切换来源或关闭联网不会自动清除旧缓存。请在使用前自行评估隐私与歌词版权。

配色

设置面板「配色」有两种模式：

• RGB 流转：整条彩虹自动流动，颜色随节拍缓慢漂移。
• 色标（默认）：任意多个颜色混成一条渐变（1~8 个都行），点色标后在 色彩盘 上拖拽改色，+ 颜色 / − 删除 增删；上面一排是 8 套预设（肾上腺素 / 极光 / 日落 / 莓果 / 霓虹 / 冰川 / 樱花 / 赛博），点一下直接套用。

歌词

• 位置：顶部 / 左侧 / 右侧 / 标题旁 / 底部条
• 开关：显示歌词
• 字号：9~24 px
• 颜色：跟随主题 或自选颜色（取色器）

设置都存在浏览器 localStorage（dsh-plugin-moyu:prefs:v4）。

已知限制

• 仅 Windows（process.platform === 'win32' 才启动媒体桥），其它平台插件保持休眠。
• 音频律动基于 WASAPI 系统音频回环采集和 48 频段 FFT；更新间隔及平滑处理会带来延迟，响应速度取决于配置和运行环境。
• 有些播放器（例如汽水音乐）不更新 SMTC 的 Position，插件用 Position + (now - LastUpdatedTime) 外推；如果播放器长时间不更新进度且有循环播放，歌词可能对不齐，可在面板里调「歌词偏移」。
• 注意：歌词版权归权利人，仅供本机显示使用，不要批量抓取或再分发。