前言¶

如果只想調整 DeepSeek Harness web 的外觀，又不希望改動業務組件，DSH 插件方式提供了一條路徑：在 profile 中安裝主題插件，讓 dsh web 加載一套外觀。

dsh-neu-theme 是 Lhy723 維護的 MIT 主題插件，爲 DeepSeek Harness web 提供輕擬物（Neumorphism）表面效果。DSH 生態強調“一切皆插件”，社區目錄是獨立站點，與 DeepSeek、幻方沒有官方從屬關係。

插件定位¶

dsh-neu-theme 是 DeepSeek Harness web 的輕擬物主題。

它向內置 ThemeRuntime 註冊兩個主題：

• neu-light
• neu-dark

兩套配色分別是奶油淺色和墨藍深色，用於呈現柔和的浮起與凹陷表面。

核心功能¶

光照與可見表面¶

插件在可見表面上繪製環境光，包括頂部光暈與角落填充。

這種方式不只改變文檔底色，而是把光感落在畫布、側邊欄、details column 等可見區域上。

陰影與代碼塊¶

插件使用三層陰影：

• contact
• cast
• top-edge highlight

同時使用 145° gloss 漸變，併爲代碼塊提供背光內壁。

顆粒紋理¶

插件使用內聯 SVG feTurbulence 添加細灰度顆粒紋理。

紋理覆蓋以下區域：

• 畫布
• 側邊欄
• details column
• 代碼塊

磨砂玻璃效果¶

composer 膠囊及以下彈出組件採用磨砂玻璃效果：

• 權限菜單
• 模型菜單
• 上下文面板

微交互¶

微交互受以下媒體查詢控制：

@media (prefers-reduced-motion: no-preference)

設置項¶

插件在 Settings → General 中提供 Neumorphism picker，可選項爲：

• Default
• Neu Light
• Neu Dark

選擇會通過 Host settings 持久化。

選擇 Default，或沒有保存皮膚時，保持 dsh 原生文檔外觀。

安裝與啓用¶

安裝到 web profile¶

官方安裝命令：

dsh plugin --profile web add dsh-neu-theme

這條命令會把 dsh-neu-theme 安裝到 web profile。

如果需要手工安裝，可以先進入 web profile 目錄：

cd ~/.dsh/profiles/web
pnpm add dsh-neu-theme

加入 bundles 並重啓¶

安裝後，在 profile 的 package.json 中把 "dsh-neu-theme" 加入 dsh.profile.bundles，然後重啓 dsh web。

示例片段：

{
  "dsh": {
    "profile": {
      "bundles": [
        "dsh-neu-theme"
      ]
    }
  }
}

版本與依賴要求¶

Host-backed settings path 需要 DSH Web Host 0.1.1-rc.2 或更新版本。

遠程瀏覽器無法訪問 loopback settings API，因此其選擇按設計保持 process-local。

package.json 對 react、@deepseek-ai/cordis 及多個 DSH 客戶端包聲明瞭 peerDependencies 版本約束，並依賴：

@deepseek-ai/schemastery ^3.18.1

典型用法¶

1、安裝插件：

dsh plugin --profile web add dsh-neu-theme

2、在 profile 的 package.json 中把 "dsh-neu-theme" 加入 dsh.profile.bundles。

3、重啓 dsh web。

4、進入 Settings → General → Neumorphism theme，選擇：

• Default
• Neu Light
• Neu Dark

選擇 Default 後，插件不注入樣式表、不設置 body 屬性，保留原生顏色和陰影。

開發與檢查¶

倉庫提供構建與檢查腳本：

npm run build
npm run check

適用場景與注意¶

適合以下使用者：

• 使用 DeepSeek Harness web，並希望切換奶油淺色或墨藍深色輕擬物外觀。
• 希望通過插件方式改變外觀，而不是修改業務組件。
• 希望在需要時切回 Default，保留 dsh 原生文檔外觀。

使用前注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• 如果使用 Host-backed settings path，確認 DSH Web Host 版本不低於 0.1.1-rc.2。
• 許可證爲 MIT。

鏈接¶

GitHub：

https://github.com/Lhy723/dsh-neu-theme

本介紹未提供已覈實的目錄頁地址。