前言¶
在 DeepSeek Harness（DSH）的使用中，界面外觀通常由默認設置或手動設置固定。如果需要根據當前會話的模型切換背景，dsh-background-by-model 提供了一種基於規則的自動化方案。
基本介紹¶
該插件是一個外觀類插件，屬於“趣味換裝”類別，由開發者 HarmlessFunny 維護。它通過維護一個有序的模型規則列表，在切換模型時自動應用對應的背景設置。插件的核心價值在於將背景的切換邏輯與模型選擇綁定，實現了界面風格的動態跟隨。
功能詳解¶
模型規則匹配¶
插件基於規則列表工作，列表中的每條規則包含一個匹配字符串和一組完整的背景設置。系統會按順序掃描當前會話的模型名稱（合併 provider、model id 和 display name），找到第一個匹配的規則（不區分大小寫）。如果沒有匹配項，則使用第一條規則作爲默認背景。
規則與圖片配置¶
- 規則獨立配置：每條規則可以獨立設置圖片的透明度、亮度和模糊度。
- 圖片獨立設置：規則下的每張圖片可以擁有獨立的佈局模式、邊框和主題色。
- 數據存儲：所有配置數據存儲在磁盤（
~/.dsh/.dsh-background-by-model-data/），而非瀏覽器 localStorage。
輪播與切換效果¶
- 圖片輪播：每條規則內的圖片支持輪播，可自定義時長（5秒至24小時）和順序（順序播放或隨機）。注意：輪播功能默認關閉，僅在當前激活規則下生效。
- 全局切換效果：支持四種全局切換效果：淡入（默認）、瞬間、縮放和滑動。可設置動畫時長，支持標準、線性、ease-out 等緩動函數。
節日背景¶
提供中秋和國慶的節日背景切換功能。節日背景默認關閉，支持農曆日期判斷（基於 Asia/Shanghai 時區）。節日壁紙需聯網下載，不支持自定義替換。
規則管理¶
支持規則的導入與導出，便於配置的保存和遷移。
安裝與啓用¶
通過 DeepSeek Harness 的插件目錄進行安裝：
# 在 DSH 環境中通過目錄鏈接安裝
# 目錄地址：https://www.skillhub.cn/plugins/HarmlessFunny/dsh-background-by-model
啓用後，插件會自動監聽模型切換事件並應用相應的背景設置。
使用示例¶
- 定義匹配規則：在配置頁添加規則，設置匹配字符串（例如 “deepseek”），並上傳對應的背景圖片。
- 調整視覺效果：爲每張圖片設置獨立的佈局、邊框和主題色，或在規則級別調整透明度、亮度和模糊。
- 配置輪播：在規則編輯器中開啓輪播功能，設置圖片切換時長和順序。
- 設置全局效果：在配置頁選擇全局切換效果（如淡入或縮放）和動畫時長。
- 啓用節日背景：在配置頁開啓節日背景功能（推薦配置），插件會在特定日期自動切換壁紙。
注意事項¶
- 版本變更：v0.3.0 爲破壞性版本，移除了視頻壁紙、生成背景以及單一的全局主題色設置。
- 減少運動模式：系統的“減少運動”設置會阻止動畫播放，而不是縮短動畫時長。
- 輪播限制：輪播功能默認關閉，且僅在當前激活的規則下生效。
- 節日壁紙：節日壁紙依賴聯網下載，不支持本地自定義替換。
- 匹配順序：規則按順序匹配，第一條規則爲默認規則（fallback）。
- 依賴要求：需確保 DSH 版本滿足
>=0.2.1-alpha.2。
結語¶
dsh-background-by-model 通過規則驅動的機制，爲 DSH 用戶提供了精細化的模型級外觀管理能力。無論是通過輪播增加動態感，還是通過節日背景增添儀式感，都能在不修改核心代碼的情況下實現個性化定製。
