@local/dsh-audio-rail
DSH Web GUI 会话右侧快捷跳转锚点（turn rail）随音乐律动：宿主侧 WASAPI 环回采集 + FFT 频段经 SSE 推送，浏览器侧驱动锚点短条伸缩，宛如旋转 90° 的频谱柱。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Lingwuxin/dsh-audio-rail#f9ee105ad6177cd78d02296593c9a256334cc785
Audio Rail 以 @local/dsh-audio-rail 发布，当前版本为 1.0.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
中文 | English
让 DSH Web GUI 会话页面右侧的「快捷跳转锚点」（turn rail）随系统正在播放的音乐律动——像把频谱可视化的柱形旋转了 90°。
兼容性声明：当前版本（v1.0.1）仅针对 dsh v0.1.7-rc.2 适配验证。本插件依赖
dsh-client-ui-chat的 TurnNavigator DOM 契约（_marks容器内的_mark按钮、data-index排序、固定 20px 短条、scaleX 状态系数）；DSH 升级若再次重构该组件，视觉效果可能失效（采集与 SSE 音频管线不受影响）。不同版本请自查该组件结构。
GitHub 会剥离手写 <video> 标签，所以用 GIF 内联自动循环播放；有声完整版见 demo1.mp4。
┌─ bin/AudioRailCapture.exe ─┐ stdout JSON ┌─ index.js (host) ─┐ SSE ┌─ client.js (browser) ─┐
│ WASAPI 环回采集默认渲染端点 │ ───────────────▶ │ /audio-rail/events │ ───────▶ │ 每个锚点绑定一个频段， │
│ FFT → 12 个对数频段 @30fps │ │ /audio-rail/status │ │ scaleX 伸缩 ::before │
└────────────────────────────┘ └────────────────────┘ └────────────────────────┘
src/AudioRailCapture.cs（csc.exe 编译，零依赖单文件）以环回模式捕获默认渲染端点的系统混音（WASAPI shared mode + AUDCLNT_STREAMFLAGS_LOOPBACK），FFT 后归约为 12 个对数分布频段（45 Hz–16 kHz）。归一化采用「约 1 秒滑窗均值」为基准的相对动态映射（-9/+17 dB 窗口）：持续内容停在中线、鼓点瞬态上冲、弱奏回落，不会像峰值跟踪那样一直顶格。约 30 fps 输出 JSON 行，静默时输出衰减到 0。index.js 注册 /audio-rail/events（SSE）与 /audio-rail/status。有订阅者才启动采集进程，最后一个订阅者断开 15 秒后停止；崩溃按指数退避重启（设备热插拔 exit 3 可恢复）。client.js 注入一条 CSS 规则，把锚点短条（.…_mark::before）的 transform 变为 translateY(-50%) scaleX(var(--dsh-audio-rail-scale, .6))；EventSource 接收频段帧，rAF 循环内对每个锚点做攻击/释放平滑后写入 CSS 变量。宿主的短条为固定 20px、以 scaleX 表达状态长度（.4 未加载 / .6 默认 / .9 预览 / 1 当前），插件把音频脉冲乘在宿主状态系数之上（上限 26px），状态样式完全保留。低音在底部锚点。尊重 prefers-reduced-motion（此时完全不启用）。克隆后先编译采集器（build.cmd 调用 Windows 自带的 .NET Framework csc.exe，无需安装任何依赖）：
build.cmd
然后在 DeepSeek Harness 会话里让 agent 安装 bundle，或手动：
dsh plugin --profile web add link:<本仓库克隆路径>
安装后浏览器页面自动热加载，无需刷新。
IMMDevice::Activate 对 IID_IAudioClient 返回 E_NOINTERFACE，因此 helper 按 IAudioClient3 → IAudioClient2 → IAudioClient1 顺序探测，并且设备以下的 COM 调用全部走原始 vtable 委托（避开该运行时对 Activate 封送抛 InvalidCastException 的问题）。| 文件 | 作用 |
|---|---|
index.js | Host 半面：路由 + 采集进程生命周期 |
client.js | 浏览器半面：样式注入 + SSE + rAF 动画 |
src/AudioRailCapture.cs | WASAPI 环回采集 + FFT（C#5，csc.exe 可编译） |
build.cmd | 采集器一键编译脚本（调用系统自带 csc.exe） |
bin/AudioRailCapture.exe | 采集器编译产物（不随仓库分发，由 build.cmd 生成，.gitignore 忽略） |
docs/demo1.gif | 效果演示（README 内联播放） |
docs/demo1.mp4 | 效果演示完整视频 |
cordis.patch.yml | bundle 补丁，插入 ui-dsh-audio-rail 行 |