dsh-rail-equalizer

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# dsh-rail-equalizer

让 DSH 的**「轮次导航」导轨**（聊天右侧那根刻度条）跟着**系统正在播放的声音**实时律动。

> 放音乐、放视频、打游戏 —— 只要声音是从这台电脑的默认播放设备出来的，导轨就会跟着动。
> **不需要任何授权、不弹任何窗口、不碰麦克风、不录屏**，戴耳机照样工作。

![轮次导航跟着系统声音律动](assets/screenshot-1.png)

![侧栏里的「律动」开关](assets/screenshot-2.png)

> **仅 Windows。** 音频采集层依赖 WASAPI。英文说明见 [README.en.md](README.en.md)。

---

## 它是怎么拿到声音的

这是本插件唯一"重"的地方，值得说清楚。

浏览器的 `getDisplayMedia`（屏幕共享）**做不到"一次授权"** —— 这是 Chrome/Edge 刻意的安全设计：每次调用都必须重新选一次共享目标，权限不做持久化，没有任何 API 能绕过。而麦克风方案在**戴耳机**时完全无效。

所以本插件走的是**宿主端 WASAPI 回环**：DSH 的宿主进程（Node）通过 `koffi` 直接调用 Windows Core Audio 的 COM 接口，抓默认播放设备正在渲染的 PCM。

```
IMMDeviceEnumerator.GetDefaultAudioEndpoint(eRender)
  → IMMDevice.Activate(IAudioClient)
  → IAudioClient.Initialize(AUDCLNT_STREAMFLAGS_LOOPBACK)
  → IAudioClient.GetService(IAudioCaptureClient)
  → 轮询 GetBuffer / ReleaseBuffer
```

和 **OBS 抓桌面音频是同一个机制**。它不是"录音"，是在读系统混音器已经把声音交给声卡的那份数据，所以：

- 没有任何"权限"概念需要向谁申请
- 耳机 / 音箱 / HDMI / 虚拟声卡，抓的都是**默认播放设备**（你在系统里切输出，它跟着切）
- 只读，不写入、不改变音量、不影响任何正在播放的程序
- 音频数据**只在内存里过一遍算电平，不出这台电脑、不落盘**

`koffi` 通过 `optionalDependencies`（`@koromix/koffi-win32-x64`）分发**预编译二进制**，装包即用，不需要 Visual Studio / node-gyp / 任何编译工具链。

## 它是怎么做到"不动原组件"的

官方导轨由 `@deepseek-ai/dsh-client-ui-chat` 渲染。本插件**没有** patch、没有 fork、没有替换它的任何代码或组件。

浏览器半只做四件事：

| 做什么 | 具体 |
|---|---|
| 打一个标记 | 往导轨的 `` 上加 `data-dsh-eq` 属性 |
| 注入一张样式表 | 一个 `