dsh-bg-skin：DSH 界面背景皮膚插件

前言¶

DeepSeek Harness (DSH) 的核心架構基於插件化。對於習慣自定義界面風格的開發者或用戶，默認的白色背景往往顯得單調。dsh-bg-skin 插件旨在解決這一痛點，將 DSH 界面的白色背景替換爲本地圖片，並提供自動回退機制，確保在任何情況下界面都不會露白。

插件介紹¶

這是一個將 DSH 界面背景替換爲圖片的趣味換裝插件。由 jinzhengen964-cmyk 維護。它提供了一張默認圖片 (assets/ds.jpeg)，並允許通過配置覆蓋，同時具備亮/暗模式底色兜底和 AI 輸出卡片不透明等特性。

核心功能¶

• 默認皮膚：默認使用倉庫自帶的 assets/ds.jpeg，安裝後無需配置即可生效。
• 覆蓋與回退：支持在 cordis.patch.yml 中配置 imagePath。若配置的圖片不存在或不可讀，插件會自動回退到內置圖片，保證界面可用。
• 佈局與顯示：圖片按視口寬度的 50% 居中顯示，且固定不隨滾動。
• 可讀性保障：AI 輸出消息卡片設置爲完全不透明，配合亮/暗模式底色兜底，確保文字在任何背景下清晰可見。
• 技術實現：純 JavaScript 實現，零依賴，無構建步驟。圖片實時讀取，修改圖片或路徑無需重啓 dsh web。

安裝與啓用¶

前置要求：已安裝 DSH (dsh web)，環境需滿足 Node.js ≥ 20。

執行以下命令安裝：

dsh plugin --profile web add github:jinzhengen964-cmyk/dsh-bg-skin

安裝完成後，重啓 dsh web 並在瀏覽器中硬刷新（Ctrl+Shift+R）即可看到效果。

典型用法¶

1. 默認使用：安裝後默認使用 assets/ds.jpeg，無需任何操作。
2. 自定義圖片：在 ~/.dsh/profiles/web/cordis.patch.yml 中配置 imagePath。

    - id: bg-skin
      name: 'dsh-bg-skin'
      config:
        imagePath: 'C:/path/to/photo.jpg'

支持絕對路徑，或相對於 `dsh web` 工作目錄的相對路徑。

3. 回退機制：刪除配置的圖片文件，或將其設置爲不可讀，插件會自動回退到默認皮膚。
4. 卸載：使用卸載命令移除插件。

dsh plugin --profile web remove dsh-bg-skin

注意事項¶

• 版本要求：Node.js ≥ 20。
• 包管理器：使用 pnpm 時，如果遇到構建腳本攔截，需在 ~/.dsh/profiles/web 目錄下運行 pnpm approve-builds --all（本插件無原生依賴，通常無需此操作）。
• 開發調試：修改代碼後需重啓 dsh web 才能生效。
• 路徑支持：配置圖片路徑時，支持相對路徑。

結語¶

該插件通過極簡的配置實現界面個性化，同時保證了系統的健壯性。如需查看更多細節或提交反饋，可訪問其 GitHub 倉庫或技能庫目錄頁。

• GitHub: https://github.com/jinzhengen964-cmyk/dsh-bg-skin
• 目錄頁: https://www.skillhub.cn/plugins/jinzhengen964-cmyk/dsh-bg-skin