前言¶

DeepSeek Harness (DSH) 爲智能體開發者提供了強大的環境支持，但默認界面較爲單一。開發者往往希望爲 Agent 賦予更具個性的視覺呈現。Background Studio 旨在解決這一問題，爲 DSH 提供一套完整的自定義背景與動態壁紙系統，從簡單的圖片替換到複雜的 Wallpaper Engine 集成，均可實現。

它是什麼¶

這是一個由 Antiboday 維護的 DSH 插件，核心價值是將動態壁紙引擎引入 DeepSeek Harness。插件遵循 MIT 許可證，通過插件目錄和 GitHub 倉庫發佈。它不僅允許用戶修改應用背景，還支持導入 Wallpaper Engine 內容，並提供音頻可視化功能。

核心功能¶

該插件提供以下能力：

• 自定義背景與動態壁紙引擎：支持多種壁紙格式和渲染方式。
• Turn-navigator 音樂波形：當 DSH 播放音效或通知時，聊天側邊的導航條會隨音頻跳動。
• 四種背景模式：支持圖片、透明、毛玻璃和動畫四種模式，每種模式均可獨立配置。
• Wallpaper Engine 工作坊導入：支持直接掃描 Steam Workshop 內容文件夾，一鍵轉換壁紙。
• 主題氛圍提示：當壁紙與系統主題色衝突時，插件會提供調整建議。
• 全國際化支持：界面語言跟隨 DSH 系統設置。
• 隱私設計：所有路由被迴環圍欄限制，活動橋僅讀取回合元數據。

安裝與啓用¶

推薦使用 GitHub 標籤安裝。在 DSH 中執行以下命令：

github:antiboday/dsh-plugin-bg-studio#v0.4.2

如果命令行安裝失敗（提示供應鏈冷卻期相關錯誤），建議下載官方發佈的 .tgz 壓縮包，然後在 DSH 的“插件”菜單中選擇“從本地包安裝”，並指定壓縮包的絕對路徑。

典型用法¶

開發者可以通過創建壁紙 Bundle 來擴展功能。

編寫壁紙 Bundle¶

創建一個目錄，並在其中放入 manifest.json 和相應的資源文件。

manifest.json 示例：

{
  "format": "dsh-wallpaper/1",
  "name": "My Wallpaper",
  "description": "…",
  "author": "you",
  "type": "video",            // video | web | canvas | character
  "entry": "bg.mp4",          // video: file · web: html file · canvas: "scene:nebula"
  "tone": "dark",             // optional: dark | light
  "states": {                 // character only
    "idle": ["nap", "wag"],
    "busy": ["type"]
  }
}

Web 壁紙交互¶

網頁壁紙可以通過 window 消息接收 Agent 活動狀態。代碼示例：

window.addEventListener('message', (ev) => {
  const d = ev.data
  if (d?.source === 'dsh-bg-studio' && d?.type === 'activity') {
    // d.state: 'idle' | 'busy' | 'overloaded'
  }
})

角色 Bundle¶

對於角色動畫，需要配置 mascot.json 定義精靈圖幀，並將其與任務狀態機（idle, busy, overloaded）關聯。

注意事項¶

• 隱私與權限：插件運行在 DSH 進程權限下，所有路由被迴環圍欄限制，活動橋僅讀取回合元數據，不涉及會話內容。
• Turn-navigator 依賴：音樂波形功能需要 DSH 0.2.0-rc 及以上版本。
• 更新生效：修改配置或更新插件後，若行爲未變更，需完全退出 DSH（包括系統托盤）並重啓。
• 供應鏈冷卻期：若安裝失敗提示 ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION，可能是由於依賴包發佈未滿 24 小時，建議等待冷卻期過後重試。

結語¶

Background Studio 爲 DSH 提供了從靜態背景到動態壁紙的完整視覺定製方案。無論是簡單的圖片替換，還是複雜的 Wallpaper Engine 集成，該插件都能顯著提升 Agent 的個性化體驗。更多詳情請參考插件目錄頁或 GitHub 倉庫。