前言¶
DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。在实际开发或交互场景中，若需要将系统音频转化为可视化的视觉反馈，现有的方案往往较为繁琐。dsh-audio-visualizer 是为此类需求提供的插件方案。
是什么¶
这是一个为 DeepSeek Harness (dsh web / DSH Desktop) 提供的系统音频驱动 UI 可视化插件。由用户 caesarjue 维护。它主要解决如何在应用界面中实时展示音频数据，并增强视觉体验。
核心功能¶
- 48-band 拖拽频谱芯片：一个 118×24 像素的悬浮组件，实时绘制 48 色的彩虹频谱，跟随系统音频输出跳动。
- Bass Glow 辉光效果：窗口边框会根据低音强度产生辉光（扩散范围 10-56px），色相随低频部分变化。
- 内存级 FFT 分析：使用 Web Audio
AnalyserNode进行分析，音频数据仅在当前进程内存中流转，不会录制、存储或上传。 - 交互记忆：点击频谱组件可切换显示状态，插件会自动记忆组件的位置。
安装与启用¶
在终端中执行以下命令进行安装。
dsh web
dsh plugin --profile web add dsh-audio-visualizer
DSH Desktop
dsh plugin --profile desktop add dsh-audio-visualizer
DSH Desktop 版本需要额外的本地补丁才能获取系统音频循环回环权限。
使用示例¶
dsh web
安装后，点击频谱组件，在弹出的选择器中选择“Entire screen”，并勾选“Share system audio”。出于浏览器安全模型限制，每次启动可能都需要手动确认。
DSH Desktop
安装完成后，运行一次本地补丁脚本 ./patch/install-patch.sh。补丁完成后，可视化效果将随应用自动启动，无需手动操作。
适用场景与注意¶
- 系统要求：需 macOS 14.2+，并在系统设置中授予“屏幕录制”和“音频捕获”权限。
- 浏览器版本：Web 版本需使用 Chrome/Chromium 141+。
- 版本依赖：已测试环境为 DSH Desktop 2.0.5+ (Electron 43) 和 dsh web 0.1.5+。
- 隐私说明：插件采用内存级处理，不涉及音频文件的持久化存储。
- 开源协议：MIT License。
结尾¶
该插件为 DSH 生态提供了轻量级的音频可视化能力，适合需要音频反馈或增强视觉表现力的场景。源码与目录见下方链接。
