前言¶

DeepSeek Harness（DSH）的 Web 客戶端默認界面偏功能向，若你希望在不改業務邏輯的前提下，給輸入區、側欄控件和模型選擇器統一一層半透明「液態玻璃」材質，並附帶 Dynamic Island、開場動畫等視覺細節，社區插件 dsh-apple-liquid-glass 走的就是這條路：通過 Cordis patch 注入樣式與少量前端邏輯，所有開關集中在 Settings → Liquid Glass，聊天主界面不掛浮動按鈕。

下面介紹插件定位、能力邊界、安裝方式與典型配置。

這是什麼¶

維護者 tianyuec11-design 在 GitHub 開源的 dsh-apple-liquid-glass（當前包版本 0.4.3，MIT 許可證）面向 DSH Web（dsh.client.platform: web），要求宿主 DSH >= 0.2.1-0。README 註明預覽環境爲 DSH 0.2.1-rc.5 web profile。

一句話定位：爲 composer、側欄控件、模型選擇器、發送按鈕等表面施加 Apple 風格的 liquid-glass 材質；composer 頂邊與兩側有淡藍色流動光暈（輸入時暫停）；頂部 Dynamic Island 整合會話頭信息與設置入口；開場 hello 按筆畫順序顯現；切換模型時在模型觸發器上方出現緊湊粒子球。頁面背景、消息氣泡、原 header、模型下拉菜單本體不在本版材質範圍內。

社區目錄 SkillHub 插件頁 將其歸類爲 趣味換裝；GitHub 星標數爲 3（以目錄線索爲準，安裝前可在倉庫頁自行覈對）。

核心功能¶

玻璃強度與分表面開關¶

在 Settings → Liquid Glass 中：

• Glass intensity：0–100% 滑塊，預設 Off / Light / Mid / Strong 對應 0 / 35 / 65 / 100，實時生效並自動保存。
• Surfaces：四個獨立開關，默認全開——composer 卡片、側欄控件、模型選擇器、發送按鈕。關閉某一表面會立刻恢復該處原生樣式，其餘仍保持玻璃；0% 會移除所有表面覆蓋，但四個開關狀態仍保留。composer 頂/側藍色光暈歸屬 Composer card 開關。

配置按瀏覽器寫入 localStorage，鍵名 dsh-apple-liquid-glass.settings.v1。

Composer 邊緣光暈¶

玻璃開啓時，composer 頂邊與兩側有藍色漸變光暈；約 2px 條帶加 1.5px 模糊，可見厚度控制在約 1.5mm 以內。鍵入、按鍵或 IME 組合輸入會立即凍結流動，末次輸入約 1.1s 後恢復。強度 0% 或對應表面關閉時光暈消失。

Dynamic Island¶

composer 列頂部居中、距頂約 1cm 的深藍玻璃膠囊（收起約 5cm × 1cm）。收起時無文字，僅左側約 0.6cm 處狀態點：DSH 思考/生成中爲紅，空閒爲綠。點擊展開後可看到會話標題、模式、對話/軌跡標籤、時間、餘額、上下文佔用，以及進入 Liquid Glass 設置的快捷入口；展開時原 header 臨時隱藏，點外部或按 Esc 收起。

開場動畫（Opening animation）¶

獨立開關。開啓後先預覽一次，之後每個 DSH 窗口會話播放一次（同標籤刷新不重複）。Apple 活動風格的手寫小寫 hello，按 h → e → l → l → o 筆畫順序在半透明舞臺顯現，約 5–7 秒，點擊任意處或 Esc 可跳過。系統 prefers-reduced-motion 時改爲靜態 hello 約 2 秒。

模型切換粒子球¶

用戶通過模型選擇器切換到不同模型後，模型觸發器上方自動出現約 1/6 尺寸的藍色粒子球（96px 畫布），流動 5s、淡出 5s，透明且不攔截指針；僅粒子遮擋，周圍 UI 仍可用。需在近期與模型選擇器交互且標籤確實變化時觸發；減少動效模式下會縮短。

實現要點（摘自 README）¶

純 CSS 材質、小型 DOM 控制器、React 設置區塊與 2D canvas 粒子層，無第三方運行時依賴。composer 的 backdrop-filter 放在 ::before 僞元素上，避免固定定位彈層成爲 backdrop 根；藍色光暈在 ::after 上通過 background-position 動畫實現。

安裝與啓用¶

插件以當前 DSH 進程權限運行；安裝前建議瀏覽倉庫源碼與 MIT 許可證。DSH Desktop 自帶包管理；CLI 路徑下 dsh plugin 需要 pnpm 在 PATH 中。

DSH Desktop（推薦從 GitHub 安裝）¶

1. 側欄打開 Plugins。
2. 點擊 Add plugin / +，選擇 Install a third-party plugin。
3. 粘貼倉庫 URL：

https://github.com/tianyuec11-design/dsh-apple-liquid-glass

4. 安裝後 Enable，刷新頁面（或按宿主提示重啓）。
5. 左下角賬戶菜單 → Settings → Liquid Glass，調節強度與 Opening animation。

dsh web 命令行¶

dsh plugin --profile web add 'github:tianyuec11-design/dsh-apple-liquid-glass'

安裝後重啓 dsh web。

固定版本 Release 包¶

https://github.com/tianyuec11-design/dsh-apple-liquid-glass/releases/download/v0.4.3/dsh-apple-liquid-glass-0.4.3.tgz

README 說明：dshmarket 的 Themes 標籤只列目錄內主題；從 GitHub 安裝的主題出現在 Installed plugins，仍是完整 bundle 主題，可正常啓用/禁用。

本地目錄或自構建 tgz（開發）¶

Desktop：第三方插件安裝處粘貼本地絕對路徑，例如 C:\path\to\dsh-apple-liquid-glass，安裝 → Enable → 刷新。

本地 dsh web：

dsh plugin --profile web add "C:\path\to\dsh-apple-liquid-glass"

自構建：node scripts/build.mjs 與 npm pack 後，通過插件管理器安裝生成的 dsh-apple-liquid-glass-0.4.3.tgz。

典型用法¶

先做安裝與啓用，再打開 Settings → Liquid Glass：

1. 用強度滑塊或 Off / Light / Mid / Strong 預設調整整體玻璃感；需要完全關閉材質時設爲 0%（分表面開關狀態仍保留）。
2. 在 Surfaces 中按需關閉 composer、側欄、模型選擇器或發送按鈕中的任意一項，對比原生與玻璃混排效果。
3. 打開 Opening animation 體驗開場 hello；若不需要動效，關閉該開關即可。
4. 點擊頂部 Dynamic Island 展開，查看會話元數據並從島內向 Liquid Glass 設置跳轉。

聊天區域無插件專屬浮動按鈕；日常操作均在設置頁完成。

適用場景與注意¶

適合長期在 DSH Web / Desktop Web 配置 下工作、希望界面統一 glassmorphism 風格且保留細粒度表面控制的開發者。Dynamic Island 與粒子效果會增加 DOM/canvas 層，低性能設備或強依賴「減少動效」的系統設置時，應優先關 Opening animation 或降低強度。

本插件不修改頁面背景與消息區視覺；與宿主 DSH 版本不匹配時，以 package.json 中 dsh.engines.dsh: ">=0.2.1-0" 爲準。社區目錄 SkillHub 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係，安裝來源以 GitHub 倉庫 README 爲準。

結尾¶

dsh-apple-liquid-glass 把 Apple 風格的 liquid glass、Dynamic Island、筆畫序 hello 和模型切換粒子球收進「設置頁驅動」的主題插件，適合在 DSH「一切皆插件」的生態裏做 Web 端趣味換裝。

• 目錄頁：https://www.skillhub.cn/plugins/tianyuec11-design/dsh-apple-liquid-glass
• 源碼與文檔：https://github.com/tianyuec11-design/dsh-apple-liquid-glass