前言¶

在使用 DeepSeek Harness 時，界面通常較爲單調。dsh-background-swapper 作爲一個插件，解決了將個人照片設爲 Harness 背景、管理圖片庫以及精細調整界面透明度和特效的問題。

功能概覽¶

該插件由 DevTarlow 維護，採用 MIT 許可證。核心價值在於提供了一套完整的背景管理方案，包括照片上傳、庫管理、預設效果以及界面透明度的精細調節。

• 設置背景與庫管理：支持拖拽上傳或選擇文件，上傳後可重命名或刪除。照片以縮略圖形式展示在「Recent」中，點擊即可切換。
• 預設效果：提供 Wallpaper、Glass、Solid 三種預設，一鍵調整背景、元素和側邊欄的不透明度平衡。
• 精細調節：通過背景不透明度、元素不透明度、側邊欄不透明度三個滑塊控制界面與背景的融合；支持 Tint（色調）和 Blur（模糊）效果。
• 保存自定義外觀：調整滿意後可點擊「Save current」保存當前組合，後續可隨時調用。
• 關閉背景：可隨時關閉背景顯示，界面恢復默認。

安裝與啓用¶

1. 在 Harness 左側邊欄打開 Plugins。
2. 點擊 Install。
3. 粘貼倉庫地址：

    https://github.com/DevTarlow/dsh-background-swapper

4. 安裝並刷新頁面。

如果從本地安裝，也可以直接克隆倉庫並將文件夾路徑填入安裝對話框。

典型用法¶

1. 點擊左側邊欄設置上方的 Swap Background 打開面板。
2. 在「Add a photo」區域拖入圖片或點擊「Choose file」，輸入名稱後點擊 Save。
3. 在「Appearance」區域選擇預設（如 Glass），然後手動拖動滑塊微調。
4. 調整滿意後，點擊 Save current，輸入名稱保存該外觀。
5. 在「Recent」列表中點擊縮略圖切換當前照片，或點擊 Turn off 清除背景。

數據存儲與配置¶

• 存儲位置：照片與配置文件存儲在 Harness 數據目錄下：

    ~/.dsh/storages/background-swapper/
    ├── index.json      (包含名稱、當前照片、滑塊設置及自定義外觀)
    └── images/         (照片文件)

*注意：跨瀏覽器同步的前提是 Harness 數據目錄相同。*

• 配置項：插件讀取 cordis.patch.yml 中的以下配置：
  • pageSize: Recent 分頁數量（默認 6）。
  • maxImageBytes: 最大上傳文件大小（默認 16MB）。
  • maxDimension: 最大圖片邊長（默認 2560px）。
  • dataDir: 自定義存儲目錄（默認爲空，使用上述路徑）。

總結¶

如果你需要在 Harness 中打造個性化的工作臺背景，或者需要統一管理多張壁紙並配合不同的界面風格，該插件提供了直接可行的方案。更多細節與源碼可在 GitHub 查看：https://github.com/DevTarlow/dsh-background-swapper