前言¶
DeepSeek Harness（DSH）的 Web GUI 自帶淺色、深色與跟隨系統幾套官方主題，配色走 --dsw-* 設計令牌。若你日常開發或調試智能體時長時間盯着界面，默認主題未必閤眼；社區裏也有透明 UI、自定義 CSS 等做法，但要麼只改局部，要麼需要自行維護樣式。
下面介紹維護者 NoNameLeGo 發佈的 dsh-catppuccin-theme（npm 包名 @nonamelego/dsh-catppuccin）。它把 Catppuccin 的 Latte、Frappé、Macchiato、Mocha 四套色板註冊進 DSH 官方主題系統，並可選開啓玻璃質感（Glassmorphism）皮膚；同一包還覆蓋 Web GUI、dsh web、DSH Desktop 與 dsh-TUI 終端配色。
這是什麼¶
dsh-catppuccin-theme 是 DeepSeek Harness 的主題類插件，分類爲「趣味換裝」。維護者 NoNameLeGo，源碼託管於 GitHub，當前 npm 版本 0.4.0，許可證 MIT，GitHub 星標約 18。
它解決兩件事：一是把界面全量映射到 Catppuccin 色板（不只改強調色）；二是在設置裏提供可開關、可調參數的磨砂玻璃皮膚，頂欄、側邊欄、輸入框等區域可呈現玻璃卡片效果，配色隨當前 Catppuccin 主題自動切換。
核心功能¶
四套 Catppuccin 主題¶
插件內置 Catppuccin 官方四主題：
- Latte（淺色）
- Frappé、Macchiato、Mocha（深色）
接入 DSH 官方主題系統，與內置淺色 / 深色 / 跟隨系統平級。選擇會寫入本地偏好，重啓後自動恢復。選「跟隨系統」會回退到啓用 Catppuccin 之前的官方主題偏好，而非強制重置。
全界面配色與設置入口¶
插件重映射 --dsw-* 令牌階梯，覆蓋 Web 界面主要區域。安裝並重啓後，在 設置 → 常規 → 外觀 下方會出現 Catppuccin 行，用於一鍵切換上述四套主題。
玻璃質感（Glassmorphism）¶
在 Catppuccin 主題 下方有 玻璃質感 設置：
- 總開關：開啓後頂欄、側邊欄、輸入框、統計行、軌跡視圖、聊天氣泡、新會話按鈕變爲磨砂玻璃；關閉即還原原生界面。
- 模式：雲母效果（懸浮磨砂卡片）或 兼容模式（保持原版排版，僅換材質）。
- 預設：清透 / 標準 / 磨砂三檔；也可調節玻璃模糊度（0–40 px）、磨砂度（0–100%）、背景亮度。
- 玻璃顏色跟隨當前 Catppuccin 主題；頁面上下邊緣有漸變模糊，摺疊側邊欄可呈現懸浮玻璃效果。
dsh-TUI 終端主題¶
同一 npm 包含 TUI 主題同步邏輯。安裝到 dsh-tui profile 後，啓動時會將四套主題 JSON 同步到 ~/.dsh-tui/themes/（Windows 爲 %USERPROFILE%\.dsh-tui\themes\）。在 dsh-TUI 內可用 /theme 選擇 Catppuccin Latte / Frappé / Macchiato / Mocha，或 /theme catppuccin-mocha 直接切換。
其他能力¶
- 中英文雙語文案，跟隨系統語言。
- 設置 → 常規 中 檢查 Catppuccin 插件更新：對比 npm 最新版，發現新版時給出可複製的升級命令（profile 名自動探測）。
- 已爲 Web GUI 安裝且
~/.dsh-tui/themes/已存在時，Web 端啓動也會同步 TUI 主題，通常無需重複安裝。
安裝與啓用¶
插件以 DSH profile 爲單位安裝。dsh plugin 會把包裝進對應 profile 的 bundles，裝完需重啓對應進程。
Web GUI（推薦 npm）¶
面向 dsh web 的 Web GUI，在終端執行：
dsh plugin --profile web add @nonamelego/dsh-catppuccin
裝完重啓 dsh web 即可。其他 profile 將命令中的 web 換成 profile 名（例如 headless）。
DSH Desktop¶
桌面版默認 profile 爲 desktop：
dsh plugin --profile desktop add @nonamelego/dsh-catppuccin
在 DSH 終端中運行；若托盤裏選了別的 profile，換成對應名字。裝完重啓 DSH Desktop 生效。
從 GitHub 倉庫安裝¶
npm 不可用或需跟蹤源碼時：
dsh plugin --profile web add https://github.com/NoNameLeGo/dsh-catppuccin-theme
Desktop 同理，把 web 換成 desktop。從 git 安裝時，若 pnpm 提示構建腳本受限，按提示在 profile 的 pnpm-workspace.yaml 的 allowBuilds 中加入對應包後重跑。
dsh-TUI¶
dsh plugin --profile dsh-tui add @nonamelego/dsh-catppuccin
或：
dsh plugin --profile dsh-tui add https://github.com/NoNameLeGo/dsh-catppuccin-theme
裝完啓動 dsh --profile dsh-tui，用 /theme 切換 Catppuccin 主題。也可手動複製包內 themes/*.json 到 ~/.dsh-tui/themes/，但不會隨版本自動更新；catppuccin-*.json 同步時會被覆蓋，自定義請改名另存。
典型用法¶
切換 Catppuccin 主題¶
- 打開 Web GUI（默認
http://127.0.0.1:3080），或在 DSH Desktop 中打開桌面應用。 - 進入 設置 → 常規。
- 在 外觀 下方 Catppuccin 行選擇 Latte、Frappé、Macchiato 或 Mocha。
- 界面即時換色；偏好自動保存，下次啓動恢復。
開啓並調節玻璃質感¶
- 仍在 設置 → 常規，找到 Catppuccin 主題 下方的 玻璃質感。
- 打開總開關，按需選 雲母效果 或 兼容模式。
- 先用 清透 / 標準 / 磨砂 預設，再用滑條微調模糊度、磨砂度與背景亮度。
- 切換 Catppuccin 主題時，玻璃配色同步變化；關閉總開關即回到原生界面。
檢查插件更新¶
在 玻璃質感 下方點擊 檢查更新。若 npm 上有新版本，界面會顯示版本號並提供可複製升級命令；本地 link: / file: / git 安裝時會提示改用 git pull 或重新構建。
dsh-TUI 中切換主題¶
安裝 dsh-tui profile 後：
dsh --profile dsh-tui
在 TUI 內執行 /theme，選擇 Catppuccin 系列，或：
/theme catppuccin-mocha
TUI 主題只管 TUI 內部配色；終端背景仍由你所用終端決定，可配合 Catppuccin 終端主題以獲得一致觀感。
適用場景與注意¶
適合誰
- 長時間使用 DSH Web GUI 或 Desktop，希望界面統一到 Catppuccin 配色。
- 需要在淺色 Latte 與深色 Mocha 等風格間快速切換，且希望偏好持久化。
- 喜歡磨砂玻璃視覺，又不想單獨維護 CSS 或透明 UI 插件。
- 同時使用 dsh-TUI，希望終端內配色與 Web 端同一套 Catppuccin 色板。
使用前請注意
- DSH 插件在 當前 dsh 進程的權限與環境中運行。安裝前建議閱讀 GitHub 倉庫 源碼與 MIT 許可證，確認符合你的安全與合規要求。
- 社區目錄 SkillHub 插件頁 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；安裝命令以 README 與 npm 包爲準。
- 若 外觀 區域看不到 Catppuccin 行，常見原因是插件未正確加入 profile bundles 或未重啓
dsh web/ Desktop；可檢查dsh plugin list與 profile 配置。 - TUI 側
catppuccin-*.json由插件同步覆蓋；有自定義需求請另存文件名。
結尾¶
dsh-catppuccin-theme 把 Catppuccin 四套主題和可選玻璃質感接進 DSH 官方外觀體系，Web、Desktop、TUI 一條安裝路徑即可覆蓋。若你正在找「裝完就能換整套配色、還能調磨砂玻璃」的主題插件，可以從此處入手。
