dsh-ccx：爲 DeepSeek Harness 桌面版換上動態背景

前言¶

DeepSeek Harness（DSH）桌面版默認界面較單調，長期使用容易產生視覺疲勞。靜態壁紙雖然簡單，但無法隨時間或交互變化；更換主題又需要修改宿主樣式，侵入性強且難以維護。

下面介紹一個 DSH 插件，通過複用上游場景渲染器並適配 DSH 桌面版，讓界面背景從靜態變爲動態，同時保持界面可讀性與交互一致性。

這是什麼¶

dsh-ccx 是一個爲 DeepSeek Harness 桌面版提供的主題與背景插件，由維護者 Witherwithwinter 開發，分類爲模型推理。它不改變 DSH 的核心邏輯，而是通過注入頁面與 Cordis 插件半邊，爲 DSH 提供動態場景渲染、壁紙視頻庫、UI 表面透明與 Appearance 設置面板的復刻。

核心功能¶

10 種動態場景¶

插件內置 10 種 1:1 來自上游 Rice-dog/code-codex 的場景渲染器，全部 MIT 許可，原樣分發：

銀河光場 Milky Way：旋轉星系 + 五色調色板 + 開場動畫
輝光地平線 Glow Horizon：地平線輝光，方向四選、滾輪慣性
層巒 Layered Mountain：視差山脊 + 日照着色，渲染比例可調
雲穹 Heavenly Cloud：雲層穹頂，三檔渲染質量
極光電離層 Aurora：極光簾 + 電離層波動
黑洞 Black Hole：吸積盤/光線/渲染器分組，影院/透鏡/餘燼三預設
雲列車 Cloud Train：列車車窗視角的雲海，三染色可調
粒子成像 Particle Image：把圖片採樣成 56 萬粒子，支持本地圖庫、自動輪播、鼠標交互、開場匯聚
像素雕塑 Pixel Sculpt：WebGL2 實例化浮雕方塊，圖片高度場 + 指針漣漪，自帶完整參數面板
閃爍方塊 Blinking Squares：方塊矩陣閃爍波紋，方向四選、鍵盤隨機波紋

壁紙 / 視頻素材庫¶

支持導入圖片或 MP4/WebM，提供三種適配模式：鋪滿、完整顯示、平鋪。壁紙與場景互斥切換，實時生效。

實時生效¶

所有參數調整直接推給運行中的渲染器，不重建舞臺、不重播開場動畫。全部狀態落宿主 state.json，多窗口 / 重啓後一致；場景參數只存增量，渲染器內嵌默認值始終是真值。

UI Surface Opacity¶

通過通配透明讓界面底色讓位給背景，四個分區獨立滑桿調節不透明度：會話側欄、對話區、消息輸入區、右側欄。額外提供背景壓暗與模糊。停用後輸入框恢復原生樣式，圓角交界的缺口自動補齊，輸入卡片周邊的原生陰影與座位漸變一併清理。DSH 自己的設置頁不受影響——設置面板保持宿主原生樣式，背景照常透出。

Appearance 面板¶

左下角齒輪彈出 Appearance 面板，包含 12 張外觀卡片（10 場景 + 壁紙 + 表面蒙版）與場景設置 popover，結構對齊上游 code-codex 0.5.7 真實 UI。啓用某外觀時已打開的設置面板自動關閉。

安裝與啓用¶

插件要求 DeepSeek Harness 桌面版（當前驗證版本 0.2.1-rc.2+）。倉庫自帶構建產物 lib/，所有安裝方式都不需要本地構建。

方法 A：讓 DSH 安裝 npm 包¶

在 DSH 桌面版的會話裏直接讓它安裝：

安裝 npm 包 dsh-ccx

DSH 的 plugin_manager 會解析包的 dsh.bundle 元數據並裝配進 desktop profile。裝完重啓 DSH 桌面版生效。

方法 B：GitHub 源碼¶

安裝 github:Witherwithwinter/dsh-ccx

同樣重啓生效。

方法 C：手工編輯 profile¶

編輯 ~/.dsh/profiles/desktop/package.json：

{
  "dependencies": {
    "dsh-ccx": "^0.8.9"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "dsh-ccx"
      ]
    }
  }
}

然後在 profile 目錄裏 pnpm install，重啓 DSH 桌面版。

桌面 profile 沒有 web 端的 patchReload: live 熱裝配，改配置、升級插件都需要重啓 DSH。

典型用法¶

安裝後，左下角齒輪 ⚙ 彈出 Appearance 面板。從卡片中選擇場景（如層巒、銀河光場）或壁紙，通過設置 popover 調整參數（渲染比例、方向、染色等）。在 Appearance 面板或設置頁中調節 UI Surface Opacity 滑桿，讓不同區域透明化。所有變更實時反映，無需刷新或重建場景。

適用場景與注意¶

適合希望在 DSH 桌面版擁有動態背景、個性化主題，同時保持界面交互一致性的用戶。

注意：插件以當前 DSH 進程權限運行，安裝前建議閱讀源碼與許可證。場景渲染器與設置面板復刻上游 code-codex 與 DSH 真實 UI，本項目與 DeepSeek、code-codex 均無隸屬或背書關係。

已知限制¶

原生菜單欄（應用 / 編輯）不參與透明化：它是 Electron 非客戶區，頁面 CSS、bundle 進程、desktop-host 都不可達——背景從窗口內容區頂部開始，不含 OS 菜單條。需要 DSH 本體配合（不設應用菜單或 win.setMenu(null)）。
窗口完全遮擋 / 最小化到托盤時場景暫停渲染：Chromium 原生遮擋檢測讓頁面進入 hidden，渲染器停幀；窗口恢復可見即繼續。剛喚出的一瞬可能看到合成殘影，屬顯示層暫態。
Particle Image 首次啓用需要圖庫：默認圖庫自動播種到 IndexedDB；若「圖庫未就緒」，重啓一次 DSH 讓播種完成即可。
Pixel Sculpt 的設置在未啓用時也可調（實時寫入並持久化，下次啓用生效），「暫停動畫」開關僅在場景啓用中可用。
變形曲線以數值行呈現，未實現上游的曲線編輯器；開機恢復的上架過渡動畫未移植。
web 端 DSH 未適配、未測試。

生態背景¶

DSH 理念是「一切皆插件」，社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。

結尾¶

dsh-ccx 通過複用上游場景渲染器並適配 DSH 桌面版，爲用戶提供了一套可即時生效、可精細控制的動態背景與界面透明化方案。如需進一步瞭解或查看源碼，可訪問其目錄頁與 GitHub 倉庫。