dsh-whale-pulse
Verifieddsh-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 的聊天区右侧有一列竖着的小刻度(轮次轨道),点一下能跳到某一轮对话。 本插件把它变成一块「声波屏」:读取电脑当前的音频输出,算出 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\ 做三件事:
package.json的dependencies加一行:"dsh-whale-pulse": "link:../../plugins/dsh-whale-pulse"同一个文件里
dsh.profile.bundles数组加一行"dsh-whale-pulse";建一个 junction:
New-Item -ItemType Junction ` -Path "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-whale-pulse" ` -Target "$env:USERPROFILE\.dsh\plugins\dsh-whale-pulse"重启 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)。