Skip to content

dsh-whale-pulse

Verified

dsh-whale-pulse · v1.8.6 · MIT · Web UI

大肥鱼音律:让聊天区右侧的轮次轨道跟着电脑正在播放的声音一起律动(宿主侧 WASAPI loopback,不录制、不上传)。

Install

dsh plugin add dsh-whale-pulse

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

dsh-whale-pulse icon

dsh-whale-pulse · 大肥鱼音律

让 DeepSeek Harness 的轮次轨道,跟着电脑正在播放的声音一起律动。

简体中文 · 更新日志 · 反馈问题

License Platform DSH Version

目录

🌟 它是什么

DSH 的聊天区右侧有一列竖着的小刻度(轮次轨道),点一下能跳到某一轮对话。 本插件把它变成一块「声波屏」:读取电脑当前的音频输出,算出 16 段频谱, 再驱动每根刻度的长度、厚度、颜色和辉光。

  • Windows 上由宿主侧 WASAPI loopback 采集(OBS 同款做法),不是浏览器录音接口;
  • macOS 上由 ScreenCaptureKit 原生抓取系统音频,首次启动自动编译;
  • 默认抓整个输出设备,Windows 上也可以只抓某一个应用(process loopback);
  • 只算音量和频谱,不录音、不落盘、不上传。

✨ 功能

  • 每根刻度独立伸缩,像一道沿轨道流动的声波
  • 两种形状:海浪(随时间流动)/ 山峰(静止钟形,中间高两边低)
  • 按应用抓取:只跟 QQ 音乐、Chrome、游戏等某个应用的声音律动(Windows)
  • macOS 原生采集:ScreenCaptureKit,不需要 ffmpeg / BlackHole
  • 彩虹流光 / 单色,任意取色
  • 浮动幅度、低谷幅度、高峰幅度、流速、外圈泛光、最长长度全部可调
  • 上冲快、回落慢;间奏/换气不掉,暂停才安静
  • 完全静音时保留一层很轻的底波浪

🖼️ 效果预览

设置 → 鱼的耳机(可调项一览)

设置页

聊天区右侧的轮次轨道(跟着音乐起伏)

轨道律动

🌐 兼容环境

系统 状态 说明
Windows 10/11 ✅ 完整支持 WASAPI + PowerShell,系统自带 .NET Framework 4.x
macOS 13+ ✅ 原生支持 ScreenCaptureKit 直接抓系统音频,首次启动自动编译,不需要 ffmpeg / BlackHole
Linux ❌ 暂不支持 PulseAudio monitor source 需要额外配置

Windows 上按应用抓取需要 Windows 10 2004(Build 19041)以上。

macOS 需要 Xcode 命令行工具(xcode-select --install)来编译原生采集器;如果编译不可用,会自动回退到 ffmpeg + BlackHole 方案(brew install ffmpeg blackhole-2ch)。

macOS 首次运行时,系统会请求「屏幕录制」权限,允许后重启一次插件即可。

💻 安装

方式一:从插件市场安装(推荐)

编辑 <DSH_HOME>\profiles\desktop\cordis.patch.yml,把市场的索引指向本仓库(国内用 jsDelivr 镜像,海外用 GitHub 原址,二选一):

- id: plugin-market
  name: "@deepseek-ai/dsh-plugin-market"
  config:
    indexes:
      # 国内:jsDelivr CDN
      - https://cdn.jsdelivr.net/gh/XiaTian-606/dsh-whale-pulse@main/market-index.json
      # 海外 / 备用:GitHub 原址
      # - https://raw.githubusercontent.com/XiaTian-606/dsh-whale-pulse/main/market-index.json

重启 DSH,打开 设置 → 插件市场(Discover),搜索「鱼的耳机」点安装即可。

[!NOTE] 市场索引里的安装源已经切到 npm([email protected]),国内会走 npm 镜像,比从 GitHub 拉稳很多。

方式二:npm 安装(推荐,最快)

npm i dsh-whale-pulse
# 或
pnpm add dsh-whale-pulse

然后把 "dsh-whale-pulse" 加进 dsh.profile.bundles,重启 DSH。

国内网络可以用镜像:

npm i dsh-whale-pulse --registry=https://registry.npmmirror.com

方式三:手动安装(开发 / 自用)

源码放 <DSH_HOME>\plugins\dsh-whale-pulse\(<DSH_HOME> 一般是 C:\Users\<你>\.dsh), 然后在 <DSH_HOME>\profiles\desktop\ 做三件事:

  1. package.json 的 dependencies 加一行:

    "dsh-whale-pulse": "link:../../plugins/dsh-whale-pulse"
    
  2. 同一个文件里 dsh.profile.bundles 数组加一行 "dsh-whale-pulse";

  3. 建一个 junction:

    New-Item -ItemType Junction `
      -Path "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-whale-pulse" `
      -Target "$env:USERPROFILE\.dsh\plugins\dsh-whale-pulse"
    
  4. 重启 DSH(宿主注入表和客户端模块都在启动时收集一次,刷新页面不够)。

方式四:从源码安装(git)

cd "$env:USERPROFILE\.dsh\profiles\desktop"
pnpm add github:XiaTian-606/dsh-whale-pulse

然后把 "dsh-whale-pulse" 加进 dsh.profile.bundles,重启 DSH。

⚙️ 设置

设置 → 鱼的耳机:

项 范围 说明
启用律动 开 / 关 总开关
音频来源 默认设备 / 指定应用 指定应用走 process loopback,列表每 10 秒自动刷新
浮动幅度 0~400% 刻度对音量的响应强度
低谷幅度 0~60% 静音/暂停时刻度保留的长度
高峰幅度 35~100% 最响时刻度能到的最大长度
形状 海浪 / 山峰 海浪随时间流动;山峰是静止钟形
流速 0.3x~3x 波形沿轨道滚动的速度(仅海浪)
颜色模式 彩虹 / 单色 彩虹按刻度序号铺色相;单色用取色器
主色 任意颜色 单色直接用;彩虹从它的色相开始铺
外圈泛光 0~200% 刻度外面那层包围光晕
最长长度 12~300px 刻度最多向右延伸多远
  • 律动配置存在浏览器 localStorage 的 dsh.whale-pulse.v1;
  • 音频来源存在宿主侧 <DSH_HOME>/whale-pulse-config.json,重启后保持。

🏗️ 架构

宿主(Electron / Node)
  ├─ runtime/probe.ps1        PowerShell + NAudio 常驻采集器
  │     ├─ 默认设备模式:WASAPI loopback
  │     ├─ 应用模式:-TargetPid <pid>,走 process loopback
  │     └─ 每 50ms 输出一行 JSON:{"peak":…,"rms":…,"bands":[16 段]}
  ├─ runtime/sessions.ps1     枚举有窗口/在出声的应用
  ├─ /dsh-whale-pulse/level    页面轮询电平
  ├─ /dsh-whale-pulse/processes 应用列表
  ├─ /dsh-whale-pulse/config   切换音频来源
  └─ /dsh-whale-pulse/report   页面诊断上报

浏览器
  ├─ lib/client.js           客户端插件:注册「设置 → 鱼的耳机」页
  └─ runtime/pulse.js/css    找轨道、轮询电平、写 CSS 变量

❓ 常见问题

现象 处理
设置里没有「鱼的耳机」 客户端 bundle 没被加载,确认 package.json 有 dsh.client,并重启 DSH
轨道没反应 看 <DSH_HOME>/whale-pulse-host.log 有没有 probe ready;确认有声音在播放
刻度被截断 调大「最长长度」,容器宽度会跟着走
完全不亮 系统「减少动画」(prefers-reduced-motion)开着时律动会被禁用
换应用后没反应 等 10 秒自动刷新,或点「刷新」;应用 PID 变了要重新选
多声卡 / 虚拟声卡机器上「默认输出设备」没反应或者只有底噪 见下面「多声卡说明」

🔊 多声卡 / 虚拟声卡说明

设备级 loopback 抓的是输出端点(endpoint),不是「你的耳朵」听的那个混音结果。

  • 装了 FxSound、Voicemeeter、VB-Audio、声卡虚拟通道之类的机器上,默认端点可能是静音端点,于是整机模式只能读到底噪;
  • 这种机器请优先用「指定应用」模式(process loopback 直接跟进程走,不经过端点),实测更稳;
  • 如果一定要整机模式,先在系统「声音设置」里确认默认输出设备确实是你在听的那个。

感谢社区反馈:多声卡机器上整机模式容易读到静音底噪,单应用模式才是首选。

🔧 开发

# 语法自检
node --check lib/index.js
node --check lib/client.js
node --check runtime/pulse.js

# 采集器单独测
powershell -File runtime/probe.ps1
powershell -File runtime/probe.ps1 -TargetPid 1234

# 应用列表
powershell -File runtime/sessions.ps1
  • 改宿主/运行时后重启 DSH;只改 lib/client.js 可以刷新页面;
  • 宿主日志在 <DSH_HOME>/whale-pulse-host.log。

[!TIP] 改 .ps1 时别用 Set-Content 覆盖:PowerShell 5.1 读无 BOM 的 UTF-8 中文脚本会乱码,文件要保留 UTF-8 BOM。

🗺️ 路线图

  • 效果截图与宣传视频
  • macOS 原生采集(ScreenCaptureKit)
  • 更细的频谱分段(16 → 32)
  • 跟随系统主题自动切换配色
  • Linux 支持(PulseAudio monitor)

🤝 参与贡献

见 CONTRIBUTING.md。Bug 与想法走 issue,PR 请保持改动聚焦。

📄 许可

MIT,详见 LICENSE。

随包分发的 NAudio 1.10.0 同样是 MIT(Copyright © Mark Heath & Contributors)。