前言¶
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 生態提供了輕量級的音頻可視化能力，適合需要音頻反饋或增強視覺表現力的場景。源碼與目錄見下方鏈接。
