前言¶
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)仍可能因哈希漂移局部降級,但不影響對話可用性。
安裝與啓用¶
系統要求¶
- 已安裝 DeepSeek Harness,且
dsh web能正常啓動。 - 機器上有 pnpm(
dsh plugin內部使用;可用 Node.js 的 corepack 啓用)。 - 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