前言¶

DeepSeek Harness（DSH）的 Web 端界面由宿主主題與組件樣式決定，換皮往往要改構建或硬編碼 CSS，宿主一 rebuild 選擇器就容易失效。若你希望在不改對話渲染邏輯的前提下，用預設皮膚、本地字體和可調背景把界面調成可讀、可持久、可離線使用的樣子，社區插件 dsh-simple-ui（倉庫 Trouvaille-xx/dsh-Simple-UI）就是面向這件事的外觀 bundle。下面按定位、能力、安裝與用法說明它做什麼、怎麼用，以及需要注意的限制。

這是什麼¶

dsh-simple-ui 由維護者 Trouvaille-xx 發佈，在 SkillHub 等社區目錄中歸類爲 趣味換裝。它不改變 DSH 的核心對話流程，而是在瀏覽器側爲 DSH Web 客戶端提供工業風預設、圓角、背景媒體（靜圖 / 動圖 / 視頻）、品牌色與中英文字體棧；配置寫在 localStorage 與 IndexedDB，刷新與重啓後仍保留，且不請求 CDN 或網絡字體，首屏與離線場景下界面仍可正常渲染。

核心功能¶

設置頁分爲四個標籤：Style / Background / Colors / Fonts。

Style（風格與圓角）¶

提供八套預設：[CC]、Apple silver、deep-space terminal、neon purple、Night City 2077、red-and-white、newspaper、sketch。圓角支持 sharp / small / standard / large / extra-large，另有 0–240% 滑塊（100% 爲宿主原生比例，按比例作用於 --dsw-radius-* 與窗口內容圓角）。

Background（背景與可讀性）¶

支持靜圖、GIF / APNG、MP4 / WebM 視頻；媒體存入 IndexedDB，不受 localStorage 配額限制，帶開關、清除與恢復默認。視頻默認靜音、循環、自動播放，標籤頁隱藏時暫停。

文件夾輪播：可選本地文件夾爲圖源，按文件名自然排序，間隔 5–300 秒可調，支持上一張 / 下一張；文件夾內視頻會跳過。最多保留 80 張圖、合計 200 MB，超出部分會提示丟棄；輪播狀態、當前頁與間隔在重載後保持。

可讀性：scrim（0–100%）控制畫面上方的遮罩；panel opacity（0–100%）控制側欄與對話區宿主表面色對背景的遮蓋程度；scrim tone 可跟隨主題或強制淺 / 深。遮罩按佈局單元施加一次，避免嵌套把圖片埋掉；對話框與設置面板保持不透明。Background 標籤中的 Check 可報告匹配的宿主容器數量、宿主表面色、媒體層與 html 背景是否就緒。

Colors / Fonts¶

Colors：品牌 / 強調 / 中性 / 文本四行，首格爲自由取色，其餘爲色板。Fonts：中文與英文字體分開配置，字體棧本地優先並帶同風格回退，避免中文缺字成 tofu。

與宿主的關係¶

顏色通過 DSH 真實主題 API（theme.overrideTokens）應用，不重寫宿主組件、不替換對話渲染器。選擇器匹配 CSS Module 的 local-name 後綴（如 [class*="_centerCol"]、[class*="_sidebarCol"]），容器級 token 覆蓋，避免在 bundle 裏寫死構建 hash，以降低宿主 rebuild 後皮膚失效的概率。

持久化與隱私¶

設置鍵爲 localStorage 的 dsh-simple-ui.preset.v1（含上次打開的標籤）；背景庫爲 IndexedDB 數據庫 dsh-simple-ui。舊版寫在 localStorage 的背景會自動遷移。插件不存儲或渲染 API Key，不把皮膚與背景發到模型或會話，不序列化 live Host 對象。

安裝與啓用¶

安裝後入口在 Settings → 外觀皮膚 (Appearance)。README 給出四種方式，均使用 DSH 內置安裝流程，不要手寫 profile 的 package.json 或 cordis.patch.yml。

方式一：讓智能體執行（README 示例版本爲 v1.2.0）

Install dsh-simple-ui with plugin_manager install_bundle, target =
git+https://github.com/Trouvaille-xx/dsh-Simple-UI.git#v1.2.0

方式二：插件市場

在 Settings → Plugins → Discover 添加索引源：

https://raw.githubusercontent.com/Trouvaille-xx/dsh-Simple-UI/main/market/index.json

搜索 “Simple UI” 一鍵安裝。若無法訪問 GitHub，可在同一 URL 前加 https://gh-proxy.com/。

方式三：離線包

從 Releases 下載 dsh-simple-ui-<version>.zip，解壓後將文件夾絕對路徑交給 plugin_manager 的 install_bundle（或使用 .tgz 配合 pnpm add file:<path>）。

方式四：本地目錄

plugin_manager install_bundle, target = <absolute path to this directory>

安裝後重啓 DSH，以便 manifest（圖標、顯示名）被加載，再打開 Settings → 外觀皮膚。

倉庫 package.json 當前版本爲 1.4.1，許可證 MIT。選用發佈包或 git 標籤時，以你實際安裝的 revision 爲準。

典型用法¶

調背景可讀性¶

插件只能調節 scrim 與面板 veil，選錯圖再調參也難讀。README 建議：背景宜暗、柔和、留白多；高亮、繁雜的照片會吞掉文字。常見組合是暗色宿主主題 + 偏暗 scrim；panel 約 65–80%，scrim 約 35–55%。若要更多露出底圖，應同時降低 panel 並提高 scrim；只降 panel 容易再度不可讀。

需要 AI 出圖時，README 給出一組可複用的英文提示（16:9、2560×1440 及以上、低對比深色盤等），可按需改寫主題詞後使用。

排錯背景不顯示¶

在 Background 標籤點 Check，查看匹配容器數是否爲 0。若爲 0，可能是 DSH 重命名了 CSS Module 局部類名，需要等待插件更新。

適用場景與注意¶

適合希望在同一臺機器上長期定製 DSH Web 外觀、需要離線可用、又不想 fork 宿主的前端開發者或個人用戶。與「一切皆插件」的 DSH 生態一致，SkillHub 等目錄是社區站點，與 DeepSeek / 幻方無官方從屬關係。

安裝前建議自行查看源碼與 MIT 許可證。插件以當前 DSH 進程在瀏覽器中執行的權限運行；背景與皮膚數據留在本機，但不等於可以跳過你對第三方倉庫的信任判斷。

已知限制（摘自 README）：IndexedDB 不可用（如部分隱私模式）時，背景僅當前會話有效，頁面會說明；視頻背景在低端設備上可能增加 GPU/CPU 佔用；宿主大幅改動 DOM/CSS Module 命名時，需插件跟進。

結尾¶

dsh-simple-ui 把工業風預設、圓角、本地字體、IndexedDB 背景與 theme.overrideTokens 着色收進一個 Web 外觀 bundle，強調離線、持久與儘量抗宿主 rebuild。社區目錄頁：https://www.skillhub.cn/plugins/Trouvaille-xx/dsh-Simple-UI；源碼與完整說明：https://github.com/Trouvaille-xx/dsh-Simple-UI。