DeepSeek Harness 的插件生態允許用戶擴展功能。對於習慣於深度定製界面的用戶，HelloAI Theme 插件提供了現成的配色方案與編輯工具。
插件簡介¶
HelloAI Theme 是 DeepSeek Harness 的主題插件，旨在解決默認界面無法滿足個性化需求的問題。它由開發者 hello-heyongping 維護，採用 MIT 許可證。插件提供十款內置配色，並內置一個自建主題編輯器，支持創建、引用、編輯、改名和刪除主題。
核心功能¶
該插件主要包含以下能力：
- 十款內置配色：包含兩套淺色主題（清晨、森綠）與八套低對比度深色主題，全部按照護眼低對比度設計。
- 自建主題編輯器：支持新建、引用、編輯、改名、刪除主題。交互採用就地展開模式，不彈出新窗口。
- 豐富的槽位調節：提供 13 個可調槽位，包括 6 項底色、3 項文字色、4 項強調與狀態色。支持系統取色器或直接輸入 Hex 值，不做顏色限制。
- 色彩傳導機制：修改強調色時，整族顏色（按鈕、懸停、派生檔）會一起重算，避免出現主色變了但按鈕顏色未變的情況。
- 升級傳導：用戶自建的主題僅存儲差異。當內置主題更新修正配色時，用戶主題也會自動受益。
- 樣式覆蓋：可選玻璃質感、代碼高亮風格、逐 token 覆蓋等能力。
- 首頁動效：可選首頁動效（whale / dragon / leap / cat / school），獨立開關。
安裝與啓用¶
安裝前請確認環境滿足以下條件：
- DeepSeek Harness 版本 ≥ 0.1.5-rc.1
- 使用
webprofile（桌面版與網頁版均屬於 web profile）
執行以下命令安裝插件：
dsh plugin --profile desktop add github:hello-heyongping/dsh-helloai-theme
安裝完成後，刷新頁面即可在「設置 → 通用」中看到「HelloAITheme 主題」選項。
使用步驟¶
- 打開 設置 → 通用，找到 HelloAITheme 主題。
- 點擊任意內置主題按鈕，立即切換並自動保存。
- 點擊 ＋ 添加主題，編輯器會在下方展開。
- 輸入主題名稱（最多 4 個字）、選擇基點主題、調整色板、保存。
- 若需編輯已有主題，點擊主題按鈕右上角的 ✎。
注意事項¶
- 命名限制：主題按鈕固定尺寸，名稱限 4 個字，輸入時會實時截斷。
- 數量限制：用戶主題上限爲 24 個。
- 數據存儲：數據存儲在設置文檔的
customThemes字段裏，同時鏡像一份到localStorage以支持多標籤頁同步。 - TUI 獨立性：插件提供的 TUI 主題文件位於
themes/*.json，由dsh-tui/themes目錄半塊同步到~/.dsh-tui/themes/，與本編輯器相互獨立。
總結¶
HelloAI Theme 插件爲 DeepSeek Harness 提供了一套完整的主題管理方案。它既可以通過內置主題快速換膚，也可以通過編輯器深度定製，且保證了配色的一致性與可維護性。
