前言¶
DeepSeek Harness(DSH)的 Web 殼默認用一套語義化設計令牌(--dsw-*)驅動淺色與深色外觀。若只想換視覺氣質、又不想改佈局或寫 host 配置,常見做法是手調 CSS 或零散覆蓋變量,維護成本高,且很難保證對話區、側欄在兩種外觀下仍可讀。
下面介紹的 dsh-theme-leshan 由維護者 John-20260101 發佈,歸類爲社區目錄中的「趣味換裝」。它把三張樂山題材攝影當作整頁背景,用同一套令牌引擎從每套皮膚的六個輸入色推導出殼層所需的 119 個 --dsw-* 別名,並分別提供淺色與深色調色板;在應用內切換皮膚即可,明暗仍由殼自身的 Appearance 決定。
這是什麼¶
dsh-theme-leshan 是一個面向 DeepSeek Harness Web GUI 的小型主題包:三張攝影皮膚 三江夜(River Night)、凌雲晚照(Lingyun Dusk)、峨眉夜霧(Emei Mist),對應岷江·青衣江·大渡河藍調、凌雲崖壁晚鐘、峨眉冷霧月色等畫面。每張照片即頁面底圖;插件不寫入 host 設置文檔、不新增網絡請求(壁紙通過插件白名單路由提供,無 webServer 時回退爲 wash,界面仍可用)。
當前 package 版本爲 0.1.2,許可證 MIT;與 DeepSeek Harness Web 0.2.0-rc.1 … 0.2.x 對齊(dsh.bundle + dsh.client)。瀏覽器需支持 color-mix()(Chromium 111+、Safari 16.2+)。
三套皮膚與可讀性¶
每套皮膚爲每種外觀聲明六個輸入色,引擎按統一語義規則推導令牌並做對比度測量。README 中給出的正文對比度示例如下(完整表見倉庫 docs/palettes.md):
| 皮膚 | 強調色(淺 / 深) | 正文對比度(淺 / 深) |
|---|---|---|
| 三江夜 River Night | #A9552F / #C97A50 |
15.4:1 / 15.9:1 |
| 凌雲晚照 Lingyun Dusk | #8A6320 / #D3A961 |
15.4:1 / 16.5:1 |
| 峨眉夜霧 Emei Mist | #25618F / #7FB2E8 |
16.1:1 / 15.7:1 |
壁紙以原生分辨率經殼層 cover 裁剪;文件名爲 leshan-sanjiang-1448x1086.jpg、leshan-lingyun-1536x1024.jpg、leshan-emei-1536x1024.jpg,由 /dsh-theme-leshan/wallpapers/<file> 提供(精確文件白名單、不可變緩存與 HEAD/304 行爲見 README)。
核心功能¶
經過上面的定位,插件實際做三件事:
- 令牌層。 加載時調用
ctx.theme.overrideTokens('dsh-theme-leshan', layer),將每個--dsw-*映射爲{ light, dark };換膚替換該層,卸載插件則移除。無 theme 服務時回退爲帶相同取值的 scoped 樣式表。 - 壁紙層。 插件樣式表在
<body>與對話列[data-conversation-region="chat"]上繪製當前照片,並用與外觀綁定的 scrim(淺色約 0.86→0.90、深色約 0.74→0.82)保證面板呈磨砂 plate 效果,不改動佈局。 - 皮膚切換條。 Shadow DOM 面板(右下角 Leshan 藥丸),鍵盤可達;隨插件卸載而移除。
安裝與啓用¶
官方 README 給出三種添加方式;預構建 tarball 無需本地 build,推薦第一種。
# prebuilt tarball, no build step (recommended)
dsh plugin --profile desktop add https://github.com/John-20260101/dsh-theme-leshan/releases/latest/download/dsh-theme-leshan.tgz
# or straight from the GitHub source
dsh plugin --profile desktop add github:John-20260101/dsh-theme-leshan
# local development: this folder is already a loadable bundle
dsh plugin --profile desktop add /path/to/dsh-theme-leshan
桌面端也可在 插件 → 添加插件 中粘貼上述地址或本地目錄,啓用後若殼提示則重載窗口。包體爲常規 bundle(package.json 聲明 dsh.bundle 與 cordis.patch.yml),client.js 已預構建,無需額外編譯步驟。
插件以當前 DSH 進程權限運行;安裝前請自行查看倉庫源碼與 MIT 許可證,確認可接受其僅覆蓋主題與壁紙、不讀寫 host 配置的行爲。
典型用法¶
- 安裝並啓用插件後,點擊窗口右下角的 Leshan 藥丸,或按 Alt+K 在三套皮膚間循環切換。
- 當前皮膚保存在瀏覽器本地:
localStorage鍵dsh.theme.leshan.skin;不同瀏覽器可各自選擇。 - 界面中的「隱藏此鈕」會隱藏藥丸(鍵
dsh.theme.leshan.rail);Alt+K 仍可用,清除該鍵可恢復按鈕。 - 淺色/深色仍在殼的 Appearance 中切換;Leshan 提供兩套調色板,不會覆蓋你的明暗偏好。
適用場景與注意¶
- 適合:長期在官方 Desktop 或
dsh web中使用 DSH、希望用攝影背景統一側欄與對話區氣質、又依賴殼原生令牌體系的開發者或日常用戶。 - 注意:依賴 DSH 0.2.x 與 Web 平臺;無 theme 服務時仍有 fallback,但壁紙路由依賴插件 host 能力。社區目錄頁(SkillHub)與 GitHub 爲獨立信息源,與 DeepSeek / 幻方無官方從屬關係。
鏈接¶
- 社區目錄:https://www.skillhub.cn/plugins/John-20260101/dsh-theme-leshan
- 源碼與文檔:https://github.com/John-20260101/dsh-theme-leshan(含中文說明
README.zh.md、主題文檔docs/themes.md、調色板docs/palettes.md)
若你已在用 DSH 的插件生態,把 dsh-theme-leshan 當作「照片即頁面、一套引擎六套調色板」的換裝包即可:安裝、啓用、用 Leshan 或 Alt+K 切換,明暗仍交給殼本身。