DeepSeek Harness 插件：dsh-ambience（界面氛圍）

前言¶

DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。在開發或使用過程中，單一的界面和默認音效可能無法滿足個性化需求。如果需要爲客戶端環境增加視覺背景和音頻控制能力，可以使用 dsh-ambience。該插件通過在 localStorage 中持久化設置，實現了界面氛圍的本地化定製。

插件定位¶

dsh-ambience 是一個由 Hyna-hla 維護的純客戶端插件，旨在爲 DSH 提供自定義的背景圖片與背景音樂播放功能。其核心價值在於不干擾前端 UI，同時提供完整的音頻處理能力。項目採用 MIT 許可證。

核心功能¶

插件主要包含以下能力：

• 背景圖片
  支持導入 JPG、PNG 或 WebP 格式。背景圖具備淡化效果，包括透明度調節、模糊處理以及呼吸淡化動畫。圖片層爲半透明，不會遮擋前端 UI 內容。
• 背景音樂
  支持導入 FLAC、MP3、WAV 或 M4A 格式音頻。音量控制範圍在 0% 至 200% 之間。播放列表支持循環和隨機模式。
• 音頻處理
  內置 10 段均衡器，支持預設、預放大以及旁路功能。
• 控制面板
  右下角設有懸浮條，點擊可展開設置面板。

安裝與啓用¶

該插件需要手動將構建產物放入 DSH 的 profile 目錄中，並通過配置文件註冊。

1. 拷入文件
   將構建產物拷入 profile 的 node_modules\dsh-ambience 目錄（或通過 file: 依賴方式引入）。確保目錄結構完整。

2. 註冊插件
   編輯 profile 下的 cordis.patch.yml 文件，添加如下配置：

    - insert:
        - id: dsh-ambience
          name: dsh-ambience

3. 重啓加載
   重啓 DeepSeek Harness 進程。插件會在啓動時通過 window.__ModuleLoader__.load 握手機制加載單文件客戶端 bundle。

技術細節與注意事項¶

• 運行機制
  這是一個純客戶端插件，Host 僅提供 stub。插件運行在 Web 平臺，注入了 slots 和 theme，並立即執行。
• 依賴關係
  依賴項包括 @deepseek-ai/cordis 和 react（可選）。
• 配置持久化
  用戶在面板中的設置會自動保存至 localStorage，鍵名爲 dsh-ambience:v1。
• 源碼審查
  在安裝前，建議檢查源碼與許可證。雖然項目使用 MIT 許可證，但作爲本地插件，確認其行爲符合預期是必要的。

總結¶

dsh-ambience 爲 DeepSeek Harness 提供了基礎的視覺和聽覺環境定製能力。通過合理的背景設置和均衡器調節，可以改善長時間使用的體驗。更多細節可參考 GitHub 倉庫。