前言¶
在 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 搜索。
