前言¶
長時間在 DSH Web 客戶端裏寫 Harness、調會話時，界面往往是默認主題：背景單一、側邊欄與會話區樣式不可分、也很難在不影響閱讀的前提下加裝飾圖。改客戶端本體不現實，在 DSH「一切皆插件」的思路下，更合適的是裝一個只動外觀、配置留在本地的主題插件。下面介紹社區維護的 Aurora 主題（pmqzienbcka/dsh-theme-aurora），它針對 Web 客戶端提供背景圖、壓暗、模糊、毛玻璃、字體與圓角，並支持在頁面上自由擺放、變換的圖片層。
這是什麼¶
dsh-theme-aurora 是給 DSH Web 客戶端用的外觀插件：背景圖、壓暗、毛玻璃、字體、圓角，以及可拖動、縮放、旋轉、翻轉的圖片層。維護者爲 pmqzienbcka，源碼與說明見 GitHub 倉庫；社區目錄頁爲 SkillHub 條目（獨立站點，與 DeepSeek / 幻方無官方從屬關係）。當前 package 版本爲 1.0.3，許可爲 MIT。
插件在 Host 側通過 Cordis patch 注入客戶端模塊（依賴 @deepseek-ai/dsh-client-ui-theme），Client 側 immediately: true，安裝後可在設置裏改外觀，無需改 Harness 業務代碼。
核心功能¶
背景與壓暗¶
- 背景圖片：會話頁與側邊欄可分別設置；縮放方式支持填充、適應、拉伸、平鋪、居中五種。未單獨設置側邊欄圖片時，一張圖可連續鋪滿整個窗口（含標題欄）。
- 整體壓暗：0–100%，100% 爲純黑。
- 模糊度：背景圖可單獨加模糊（0–40px），不影響文字清晰度（修改模糊度並點「應用」會重新生成顯示副本，屬預烘焙方式）。
毛玻璃¶
側邊欄與會話頂欄各自獨立開關、各自獨立模糊度，便於只虛化某一區域而不動全局。
字體與圓角¶
- 字體：正文/代碼字體可在設置頁選擇（Host 通過本地路由讀取本機已裝字體）、調整字號與文字顏色。字號會按比例縮放側邊欄文字（側邊欄以 14px 爲基準，範圍爲基準的 75%–160%）。
- 圓角：整體縮放界面圓角，範圍 40%–200%。
圖片層¶
可添加任意張圖片，在頁面上直接操作：
- 拖動位置；拖右下角縮放；拖左上角旋轉（靠近 0°、±90°、180° 自動吸附）。
- 左下角 ⇄ 水平翻轉；× 刪除。
- 「變換 · 全部復位」可一次清掉所有旋轉與翻轉。
圖片層只在窗口最大化（或全屏）時顯示，繪製在背景之上、會話內容之下；窗口縮小時隱藏但配置保留。位置按會話列的比例保存，收起/展開側邊欄或改變窗口大小時會跟着佈局移動；貼着右邊界（或越過右邊界）的圖片改爲右對齊，收起側邊欄時保持原位。添加圖片後會自動進入佈局模式，點底部「應用佈局」保存並退出。
安裝與啓用¶
README 未給出固定 CLI 安裝字符串；應從 SkillHub 目錄頁 或倉庫說明按 DSH 插件慣例安裝，安裝前請自行審閱 源碼 與 MIT 許可證。插件以當前 DSH 進程權限運行，僅信任來源明確的包。
啓用後，在客戶端 設置 → 主題外觀 中調整各項，改動點 「應用」 生效。
典型用法¶
- 安裝插件並打開 DSH Web 客戶端。
- 進入 設置 → 主題外觀，爲會話區、側邊欄分別選背景圖與縮放方式；按需打開壓暗、背景模糊、毛玻璃開關。
- 調整正文字體、代碼字體、字號、文字顏色與整體圓角，點 「應用」。
- 若需要裝飾圖：添加圖片層，在最大化窗口下拖動、縮放、旋轉或翻轉，完成後點 「應用佈局」 保存。
配置與圖片均留在本機：配置在瀏覽器 localStorage，圖片原始字節在 IndexedDB（不上傳、不重編碼）。Host 側僅提供 GET /aurora/fonts 供設置頁拉取本機字體列表，不接受外部請求、不寫入文件、不聯網。
適用場景與注意¶
適合：長期在 Web 客戶端工作、希望會話區與側邊欄視覺分離、或需要在界面裏放貼紙/水印式裝飾（且不改動 Harness 邏輯）的開發者。
已知限制（來自倉庫 README）：
- 字體枚舉依賴 Windows 字體目錄；非 Windows 會回退到內置常用字體列表。
- 側邊欄字號按測量結果逐元素縮放，行高與圖標不跟隨；字號極端時側邊欄可能顯得緊湊。
- 圖片層寬度爲固定像素，窗口很窄時位置會收攏，必要時被夾回可視邊緣；右對齊圖片只釘住右邊，比窗口還寬時左側可能被推出可視區。
結尾¶
dsh-theme-aurora 把 DSH Web 客戶端的外觀拆成可保存、可復現的配置項，並在最大化窗口下提供可佈局的圖片層，適合作爲本地主題方案而不是改客戶端本體。進一步瞭解或安裝請查看 SkillHub 目錄 與 GitHub：pmqzienbcka/dsh-theme-aurora。
