dsh-kaze-tachinu-theme:爲 DSH Web GUI 換上《起風了》天藍玻璃主題

前言

DeepSeek Harness(DSH)的 Web 界面默認是功能向的純色或漸變背景,長時間對着同一套視覺,對日常用 dsh web 調試智能體、跑會話的開發者來說缺少一點「留在界面裏」的動機。社區裏有人用插件只改配色,有人用皮膚中心試穿;若你希望在不改 DSH 源碼的前提下,把整頁換成電影感壁紙、毛玻璃表面和統一的天藍交互色,dsh-kaze-tachinu-theme 就是面向 Web profile 的一條標準 bundle 安裝路徑。下面介紹它是什麼、改動了哪些界面元素,以及如何安裝、更新與卸載。

這是什麼

dsh-kaze-tachinu-theme(倉庫 suuuuunamei/dsh-kaze-tachinu-theme)是維護者 suuuuunamei 發佈的 DSH 插件,分類爲 趣味換裝。它將宮崎駿動畫《起風了》(風立ちぬ / The Wind Rises)的視覺語言映射到 DSH Web GUI:菜穗子在山坡寫生的電影壁紙墊底,界面表面改爲半透明毛玻璃,交互色統一爲天藍 #1C96B5,側邊欄與首頁 hero 使用自繪紅翼飛機矢量徽標,輸入區重繪爲雲海藍玻璃膠囊,佔位文案按界面語言替換。

它是一個標準的 dsh 插件包:通過 dsh plugin --profile web add 裝進 profile,隨 DSH 啓動常駐,不修改 DSH 源碼;卸載後頁面可完全還原。SkillHub 目錄頁:https://www.skillhub.cn/plugins/suuuuunamei/dsh-kaze-tachinu-theme。許可證爲 MIT(見倉庫 package.json 與 README 徽章)。

維度 原生 DSH Web 本主題
背景 純色 / 純色漸變 晴空電影壁紙 + 全局模糊遮罩
界面表面 不透明分層 半透明毛玻璃(backdrop-filter)
品牌標識 DSH 默認 自繪紅翼飛機徽標(展開 + 摺疊紙飛機)
交互色 默認 天藍 #1C96B5
安裝 — 一條 dsh plugin --profile web add
還原 — 卸載即還原

核心功能

天藍玻璃擬態與 token 覆蓋

主題通過官方 theme.overrideTokens API 疊加約 60 項 design token:背景層半透明以露出壁紙,邊框爲低飽和天藍描邊,懸停/激活/選中態統一爲天藍系,錯誤/成功/警告等狀態色微調以適配深色玻璃。亮色與暗色模式共用同一套視覺。完整 token 清單見倉庫 docs/theme-tokens.md。

壁紙、徽標與靜態路由

壁紙由插件宿主半區以 /kaze-tachinu/current.jpg 提供(包內 assets/current.jpg),併疊加輕微深色漸變以保證文字可讀。側邊欄展開態顯示橫向徽標(紅翼飛機 + The Wind Rises 字標),摺疊態顯示紙飛機字母標記;首頁 hero 標題替換爲居中大尺寸徽標。SVG 與壁紙均爲包內資產,由宿主路由按包內路徑解析。

輸入卡、佔位文案與會話統計

輸入卡重繪爲雲海藍玻璃膠囊。佔位文案按界面語言自動替換,並同步 Lexical 輸入框的 data-placeholder、aria-label 與可見佔位層;宿主重渲染後由 MutationObserver 補寫。中文界面輸入框統一爲「風立ちぬ——讓想法隨風飄去」;英文輸入框爲「風立ちぬ。いざ生きめやも。」;若宿主提供獨立的「新會話描述」輸入框,英文爲 Kaze Tachinu — let your thoughts ride the wind。

composer 區的會話統計行(如「20 輪 · 185 步 | LLM …」)重繪爲居中輕玻璃膠囊。消息列底部增加 40px 漸變淡出蒙版:主題將滾動視口下沉到純消息列,避免蒙版裁切輸入框。全局滾動條統一爲天藍玻璃風格(Chromium 係爲主,Firefox 有 scrollbar-color 兜底)。

抗哈希漂移(v2)

DSH 前端組件類名帶構建期哈希,升級後類名會變。自 v2 起,消息滾動、底部漸隱與統計欄膠囊不再在 CSS 裏硬綁這些哈希類,而由瀏覽器半區運行時引擎用穩定屬性(如 [data-conversation-scroll]、[data-slot="conversation.session]")與類名後綴定位 DOM,成功後打上 data-kaze-scroll、data-kaze-scroll-inner、data-kaze-stats 等標記;定位失敗則不動手,保留原生滾動與默認外觀。純裝飾區域(hero、側邊欄品牌、輸入卡內 hint)仍可能因哈希漂移局部降級,但不影響對話可用性。

安裝與啓用

系統要求

  1. 已安裝 DeepSeek Harness,且 dsh web 能正常啓動。
  2. 機器上有 pnpm(dsh plugin 內部使用;可用 Node.js 的 corepack 啓用)。
  3. DSH Desktop 用戶:profile 位於 %APPDATA%/dsh-desktop/harness/profiles/;命令行環境需將 DSH_HOME 指向對應 harness 目錄。

README 建議主題大量使用 backdrop-filter 與滾動條定製,優先使用 Microsoft Edge 或 Google Chrome;Firefox 下滾動條、漸變蒙版等效果可能不完整。

發佈版安裝

先執行安裝命令,再重啓 Web 界面:

dsh plugin --profile web add dsh-kaze-tachinu-theme
dsh web

也可從 GitHub 安裝:

dsh plugin --profile web add github:suuuuunamei/dsh-kaze-tachinu-theme
dsh web

壁紙出現、側邊欄徽標替換生效,即表示安裝成功。插件隨 DSH 啓動常駐,無需每次重裝。

更新與卸載

更新:

dsh plugin --profile web update dsh-kaze-tachinu-theme
dsh web

卸載:

dsh plugin --profile web remove dsh-kaze-tachinu-theme
dsh web

暫時關閉(不卸載):編輯 profile 的 package.json,從 dsh.profile.bundles 數組中刪除 "dsh-kaze-tachinu-theme" 一行後重啓;加回該行再重啓即可恢復。

典型用法與可選通道

驗證運行時標記

在任一會話的「對話」頁籤打開後,於瀏覽器 Console 運行 README 中的探測腳本,預期輸出爲 kaze-scroll根=1 | 內層=1 | 統計欄=1 | conv-scroll=2(或 README 所述的 1 / 1 / 1 / 2 含義一致):

console.log('kaze-scroll根=', document.querySelectorAll('[data-kaze-scroll]').length,
  '| 內層=', document.querySelectorAll('[data-kaze-scroll-inner]').length,
  '| 統計欄=', document.querySelectorAll('[data-kaze-stats]').length,
  '| conv-scroll=', document.querySelectorAll('[data-conversation-scroll]').length);

若滾動相關標記全爲 0,需對照 README「常見問題」排查是否加載了舊版 client 或引擎未生效。

皮膚中心(與插件二選一)

若使用 dsh-web-ui 的皮膚中心,可將倉庫 skin/kaze-tachinu/ 整目錄複製到 ~/.dsh/skins/kaze-tachinu/(DSH Desktop 爲 %APPDATA%/dsh-desktop/harness/skins/kaze-tachinu/),刷新後在「設置 → 皮膚中心」試穿或切換。說明:手工投放的皮膚不帶經市場溯源的 hooks.mjs 行爲增強(滾動下沉、佔位文案、統計欄標記等);壁紙、配色、徽標、玻璃樣式仍可用。經 dsh plugin 安裝爲功能全量。兩條通道共享 v2 抗漂移引擎代碼,擇一即可。

本地開發與自定義

未發佈到 npm 時,可用本地路徑安裝(改代碼後需按 README 刷新快照或改用 link:):

dsh plugin --profile web add file:/絕對路徑/dsh-kaze-tachinu-theme
# 或
dsh plugin --profile web add link:/絕對路徑/dsh-kaze-tachinu-theme

換壁紙:替換包內 assets/current.jpg 後瀏覽器強刷(Ctrl+F5)。換徽標:替換 assets/logo/ 下 SVG。換佔位文案或調色:修改 bundle/client.js、skin/kaze-tachinu/hooks.mjs 或 token 表(見 docs/theme-tokens.md)後重啓並強刷。

適用場景與注意

適合誰: 長期在瀏覽器裏使用 DSH Web、希望界面有統一電影壁紙與玻璃擬態、又願意接受插件隨 DSH 進程加載的開發者。不適合必須在 Firefox 下獲得與 Chrome 完全一致滾動條與蒙版效果的環境。

安全與信任: 插件以當前 dsh 進程的權限運行,會向 Web 頁面注入 client 半區腳本、在宿主側註冊 /kaze-tachinu/* 靜態路由。安裝前應閱讀倉庫源碼與 MIT 許可證,並確認維護者與來源(GitHub suuuuunamei/dsh-kaze-tachinu-theme)。SkillHub 等爲社區目錄站點,與 DeepSeek / 幻方無官方從屬關係;星標等元數據以目錄與倉庫頁面爲準(當前線索爲 GitHub 1 stars)。

已知限制(摘要): 裝飾性 CSS 仍依賴少量哈希類名,DSH 大版本升級後可能出現局部視覺降級;Firefox 部分效果打折。裝完無變化時,確認命令含 --profile web、強刷瀏覽器,並查看 dsh web 日誌是否出現 [kaze-tachinu-theme] host half active。

結尾

經過上面的步驟,dsh-kaze-tachinu-theme 把 DSH Web GUI 從默認分層界面換成《起風了》主題的天藍玻璃與電影壁紙,並通過 v2 運行時標記降低前端哈希漂移對對話滾動的影響。需要一鍵裝進 profile 時用 dsh plugin --profile web add;只想試視覺、走皮膚中心時按 README 複製 skin/kaze-tachinu/ 即可。

  • 目錄頁:https://www.skillhub.cn/plugins/suuuuunamei/dsh-kaze-tachinu-theme
  • GitHub:https://github.com/suuuuunamei/dsh-kaze-tachinu-theme
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜