概览
@huanlin/dsh-plugin-better-sidebar-plugin-audio
源码级技术说明为 dsh-better-sidebar 提供音频预览：可缩放的波形播放器（点击/拖拽定位、A-B 循环、倍速、声道切换）与实时频谱（柱状/折线/瀑布），由插件自带的 HTTP Range 媒体路由支撑（任意大小、边播边播、可拖动进度）。 | Audio preview for dsh-better-sidebar: a zoomable waveform player (click/drag seek, A-B loop, playback rate, channel switch) plus a live spectrum view (bars/line/waterfall), backed by the plugin's own HTTP Range media route (any size, seekable streaming).收起技术说明
为 dsh-better-sidebar 提供音频预览：可缩放的波形播放器（点击/拖拽定位、A-B 循环、倍速、声道切换）与实时频谱（柱状/折线/瀑布），由插件自带的 HTTP Range 媒体路由支撑（任意大小、边播边播、可拖动进度）。 | Audio preview for dsh-better-sidebar: a zoomable waveform player (click/drag seek, A-B loop, playback rate, channel switch) plus a live spectrum view (bars/line/waterfall), backed by the plugin's own HTTP Range media route (any size, seekable streaming).
README / ZH
插件文档
目录摘要
为 dsh-better-sidebar 提供音频预览：可缩放的波形播放器（点击/拖拽定位、A-B 循环、倍速、声道切换）与实时频谱（柱状/折线/瀑布），由插件自带的 HTTP Range 媒体路由支撑（任意大小、边播边播、可拖动进度）。 | Audio preview for dsh-better-sidebar: a zoomable waveform player (click/drag seek, A-B loop, playback rate, channel switch) plus a live spectrum view (bars/line/waterfall), backed by the plugin's own HTTP Range media route (any size, seekable streaming).
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义；完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **wma / amr**：Chromium 系浏览器没有解码器。插件会明确提示「解码失败」，播放也会失败——这是浏览器能力边界，不是渲染问题。 - 解码始终自动进行；只有超过 30 分钟的文件才跳过解码（仅流式播放），此时会明确说明原因，而不是留一个要你点的按钮。 - 频谱图按视窗重算（列数 = 画布像素、频段上限 512、mel 轴、最近邻绘制），细节随缩放增长；只有整曲一屏时受画布像素数约束。 - 单声道视图深放大时停留在裁剪的整曲 4000 列包络上（逐声道 PCM 不保留，只有下混单声道保留）；mix 视图无此限制。 - 频谱需要 Web Audio；不可用（或被策略禁用）时只提示并停用频谱，波形与播放不受影响。 - 视图状态（缩放、选区、声道、频谱风格、主视图）不跨标签页持久化——关掉再开回到默认全曲波形。