前言¶
DeepSeek Harness(DSH)的 Web 界面默認是純色或漸變背景、不透明分層,品牌標識與輸入框樣式也相對固定。如果你長期在 dsh web 裏工作,界面觀感往往缺少一點個性化空間。
社區裏已有不少主題類插件,做法各不相同。下面介紹的 dsh-kimino-theme 走另一條路:以新海誠電影《你的名字。》(Kimi no Na wa)爲視覺母題,用電影壁紙墊底、彗星藍玻璃擬態覆蓋全界面,並通過官方 theme.overrideTokens API 與組件樣式補丁完成換膚。它由維護者 niiang 發佈,在 GitHub 上約 20 stars,歸類爲「趣味換裝」。
這是什麼¶
dsh-kimino-theme 是一個標準的 DSH 插件包:一條 dsh plugin 命令裝進 web profile,隨 DSH 啓動常駐,不修改任何 DSH 源碼;卸載後頁面完全還原。
核心變化包括:
- 背景:電影壁紙 + 全局模糊遮罩,替代原生純色/漸變
- 界面表面:半透明毛玻璃(
backdrop-filter),交互色統一爲彗星藍(#93C5FD) - 品牌標識:側邊欄與首頁標題替換爲電影 Logo(展開態 + 摺疊態)
- 輸入卡:藏藍玻璃膠囊,佔位文案主題化
- 滾動條:全局藍紫玻璃細滾動條
- 消息列底部:40px 漸變淡出蒙版
代碼以 MIT 授權;assets/ 中的壁紙與 Logo 素材源自電影宣傳物料,倉庫聲明僅作個人桌面美化之用。
核心功能¶
彗星藍玻璃擬態¶
主題通過 theme.overrideTokens API 疊加約 60 項 design token 覆蓋:背景層半透明化、邊框換成低飽和藍描邊、交互態統一爲彗星藍系、狀態色微調至與深色玻璃協調。亮色與暗色模式共用同一套視覺。
壁紙與 Logo¶
壁紙由插件宿主半區以 /kimino-bg/current.jpg 路由提供(包內 assets/current.jpg),疊加輕微深色漸變保證文字可讀性。側邊欄展開態顯示橫向電影 Logo,摺疊態顯示字母標記;首頁 hero 標題替換爲居中大尺寸 Logo。
輸入卡與佔位文案¶
輸入卡重繪爲藏藍玻璃膠囊,佔位文案按界面語言自動替換:
| 界面語言 | 輸入框 | 新會話描述 |
|---|---|---|
| 中文 | 黃昏之時,我在這裏等你。 |
君の名は。想構建怎樣的世界? |
| 英文 | 黃昏の時、私はここにいるよ。 |
君の名は。どんな世界を構築する? |
消息滾動與統一滾動條¶
消息列底部 40px 平滑淡出,輸入框零裁切;同時修復了「回到底部」按鈕不出現的問題。全局滾動條統一爲藍紫玻璃風格,按 Chromium 內核瀏覽器打磨。
安裝與啓用¶
系統要求¶
- 已安裝 DeepSeek Harness,
dsh web可正常啓動 - 機器上有 pnpm(
dsh plugin內部使用;Node.js 自帶的 corepack 可提供)
安裝¶
dsh plugin --profile web add github:niiang/dsh-kimino-theme
dsh web # 重啓 DSH 生效
壁紙出現、側邊欄 Logo 變化,即安裝成功。安裝後隨 DSH 啓動常駐,無需每次重裝。
更新與卸載¶
更新:
dsh plugin --profile web update dsh-kimino-theme
dsh web # 重啓生效
卸載:
dsh plugin --profile web remove dsh-kimino-theme
dsh web # 重啓後頁面完全還原
暫時關閉(不卸載)¶
編輯 ~/.dsh/profiles/web/package.json,刪掉 dsh.profile.bundles 數組中的 "dsh-kimino-theme" 一行,重啓 dsh web 即關閉;加回該行再重啓即恢復。
典型用法¶
皮膚中心方式(可選)¶
若使用 dsh-web-ui 的皮膚中心(skin-center),可改以皮膚包形式安裝:把倉庫 skin/kimino/ 整個目錄拷到 ~/.dsh/skins/kimino/,刷新頁面即出現在「設置 → 皮膚中心」,支持試穿、一鍵切換、互斥管理。
說明:手工投放的皮膚因皮膚中心的溯源安全門不帶 hooks.mjs 行爲增強(佔位文案、滾動優化)——壁紙、配色、Logo、玻璃樣式等視覺完整;經 dsh plugin 安裝則功能全量。兩種方式二選一。
自定義壁紙與 Logo¶
需本地克隆並改用 link: 安裝:
git clone https://github.com/niiang/dsh-kimino-theme <你的目錄>
dsh plugin --profile web add link:<你的目錄的絕對路徑>
dsh web
換壁紙:替換克隆目錄中的 assets/current.jpg(保持文件名不變),瀏覽器強刷(Ctrl+F5)即可。
換 Logo:替換 assets/logo/ 下的兩個 SVG,強刷生效。
調色:顏色集中在 bundle/client.js 的 token 覆蓋與組件樣式兩處,改完重啓 dsh web 並強刷。
適用場景與注意¶
適合誰: 長期在 DSH Web GUI 中工作的開發者,希望在不改源碼的前提下給界面換一套完整視覺主題;偏好《你的名字。》彗星藍玻璃風格的使用者。
瀏覽器建議: 主題大量使用 backdrop-filter 毛玻璃、滾動條定製與 CSS 蒙版,推薦使用 Microsoft Edge 或 Google Chrome;Firefox 下部分顯示效果不兼容(滾動條、漸變蒙版等可能打折)。
權限與安全: 插件以當前 dsh 進程權限運行,安裝前建議檢查源碼與許可證。本倉庫代碼爲 MIT;壁紙與 Logo 素材版權歸原權利方所有。
已知限制:
- 消息滾動、側邊欄 Logo 替換、輸入卡高亮等處的選擇器依賴 DSH 前端構建期哈希類名,DSH 大版本升級後可能需要跟隨更新
- 主題強制深色玻璃視覺,亮色模式不做單獨適配
- 壁紙與 Logo 路由緩存 1 小時,替換素材後需強刷瀏覽器
- token 層是疊加式的,建議同一時間只啓用一個主題類插件
裝完沒變化? 確認命令裏帶 --profile web;瀏覽器 Ctrl+F5 強刷;查看 dsh web 啓動日誌有沒有 [kimino-theme] host half active。
結尾¶
dsh-kimino-theme 把 DSH Web GUI 變成《你的名字。》的模樣:一條命令安裝,卸載即還原,適合想給日常開發界面換膚、又不願動 DSH 源碼的場景。