前言¶
在 DSH Web 中，智能体的活动状态通常以文字呈现。如果你希望这些活动状态能跟随电脑当前正在输出的系统声音变化，又不要求插件逐个适配播放器，可以使用 skymecode/dsh-bgm。
dsh-bgm 直接装入 DSH 的 web profile，监听电脑正在输出的系统声音，而不是某个播放器。下面介绍它的定位、能力、安装方式和注意事项。
这是什么¶
skymecode/dsh-bgm 是面向 DSH Web 的跨平台系统音频节奏与音游氛围插件，由 skymecode 维护，许可证为 MIT。
已核实的 DSH 支持版本包括：
0.1.0-rc.80.1.1-rc.10.1.1-rc.2
其 package.json 声明版本为 0.1.2。
核心能力¶
系统音频感知¶
插件监听电脑正在输出的系统声音，与具体播放器无关。它获取默认输出设备的以下信号：
- RMS
- 低频
- 中频
- 高频
- 起音
活动行节奏¶
活动行会呈现连续 BPM 波面、方向变化与强弱分层。
音游反馈¶
插件提供预测音符、判定线、Combo、Score、Accuracy 等音游反馈。
氛围柱¶
宽屏留白处左右各 12 根 RGB 频谱柱。氛围柱固定为 24 个 DOM 节点，只改变 transform 与 opacity。
结算与奖励¶
回答完成且本轮产生判定时，会播放约 3.2 秒透明四幕结算。
得分或 PERFECT 到达里程碑时，会弹出卡牌奖励。
平台支持¶
- macOS：支持 Apple Silicon 与 Intel，最低 macOS 14.2；首次运行会请求系统音频录制权限。
- Windows：支持 Windows 10/11 x64；Release 内置自包含助手，不要求用户另装 .NET。
- Linux：当前没有系统回环采集助手，插件会安静地进入 unsupported 状态。
安装与启用¶
一键安装¶
dsh plugin --profile web add https://github.com/skymecode/dsh-bgm/releases/latest/download/dsh-bgm.tgz
然后启动官方 Web UI：
dsh web
播放任意系统声音，再发起一次对话。
确认挂载¶
dsh web --dump-config
输出中应出现：
# == dsh-bgm
name: dsh-bgm
固定版本安装¶
如果不想让 latest 后续指向新版本，可以使用固定版本：
dsh plugin --profile web add https://github.com/skymecode/dsh-bgm/releases/download/v0.1.2/dsh-bgm.tgz
卸载¶
dsh plugin --profile web remove dsh-bgm
校验下载包¶
如果下载了 Release 文件，可按 Release 中的 SHA256SUMS.txt 校验：
shasum -a 256 -c SHA256SUMS.txt
本地源码安装¶
如果需要从源码构建并安装，可使用以下步骤：
git clone https://github.com/skymecode/dsh-bgm.git
cd dsh-bgm
pnpm install
pnpm run typecheck
pnpm run build
dsh plugin --profile web add link:.
隐私与性能¶
- 原始 PCM 只存在于本机原生助手内存中，不录音、不落盘、不上传。
- 浏览器只收到压缩后的五个节奏数值和时间戳。
prefers-reduced-motion开启时会关闭主要动态效果。- 氛围柱固定为 24 个 DOM 节点，只改变
transform与opacity。
注意¶
- 插件会随当前
dsh进程加载；安装前建议检查仓库源码、MIT 许可证以及THIRD_PARTY_NOTICES.md中列出的第三方许可。 - Windows 音频助手使用 NAudio，第三方许可见
THIRD_PARTY_NOTICES.md。 - Linux 当前没有系统回环采集助手；如果你依赖系统音频采集，建议优先在 macOS 或 Windows x64 上验证。
- DSH 社区目录是独立站点，不等同于 DeepSeek 或幻方官方应用商店；本文仅基于仓库资料与已核实信息介绍。
结尾¶
dsh-bgm 的价值在于把系统音频节奏接到 DSH Web 的活动状态与音游反馈上，安装链路使用 DSH 插件通道。
GitHub 仓库：https://github.com/skymecode/dsh-bgm
如果在 DSH 社区目录中使用，可按插件名 dsh-bgm 搜索。
