DeepSeek Harness (DSH) 採用插件化架構，允許開發者擴展或替換界面組件。dsh-theme-aurum 是一個針對 DSH Web profile 的主題插件，旨在通過覆蓋原生組件實現“金粉奢華”的視覺改造。該插件採用 loader 格式，零構建，所有能力運行在瀏覽器端。
核心功能¶
主題與佈局¶
插件使用 oklch 色彩空間定義淺色與深色雙色層。側欄底部提供與官方 preference 同步的“深色/淺色主題”一鍵切換功能。側欄採用圓角漸變卡片與柔影，摺疊態爲 56px 細條。
左側會話欄¶
插件遮蔽了 sidebar.workspaces。目錄頭包含“工作區”標籤、展開式搜索（金圈聚焦）及視圖菜單。支持分組摺疊，收合採用非線性動畫與 stagger 入場。會話行包含狀態槽（運行中/等待/完成）、金色調色板、懸停浮動菜單（重命名、分支、歸檔）及拖拽排序。品牌行保留官方鯨魚圖標與字標。
會話流¶
會話流採用右對齊金漸變用戶氣泡。正文使用襯線字體，上下文行包含 ◈ 符號。Reasoning 部分爲可摺疊的襯線斜體段落。支持 turn-tail、compress、retry、err 等尾部節點，並實現逐節點階梯入場動畫。
工具卡¶
插件全量接管 conversation.chat.node。針對 9 類工具進行特判，未知工具兜底使用官方圖標。工具卡呈現藥丸狀態，運行時具備金掃光效果，tool-kids 子調用支持縮進顯示。
輸入塢¶
輸入塢包含 todo 清單條（金→玫漸變進度）、實色輸入卡、金漸變發送按鈕。模式/模型菜單支持 mono 換皮。底部包含 ctx 圓環、構成面板及 c-stats 統計行。
全局浮層與響應式¶
主區 header 採用 sh-head 浮頭方案，包含絕對定位的漸變紗與同軸標題。全局浮層（新會話居中態、命令/工作區菜單、設置彈窗）均進行金色化處理。響應式支持 ≤820、≤640、≤480 三檔降密度佈局，覆蓋 360–1920 全檔，確保零橫向滾動。
兼容性與擴展¶
圖標一律使用 DSH 官方原版。插件保留官方註冊的全部槽位（priority:-1 遮蔽），停止運行即可還原官方 UI。插件提供 aurum.workspaces.menu-extra list 擴展槽，支持多插件共存。
安裝與啓用¶
在終端執行以下命令安裝插件：
# GitHub 安裝（推薦；建議固定到特定 commit）
dsh plugin --profile web add github:fengb3/dsh-theme-aurum#<commit-sha>
# 本地開發（Link 安裝，編輯即生效）
dsh plugin --profile web add <本倉庫路徑>
安裝後需重啓 dsh web，所有頁面將自動加載該主題。
開發與注意事項¶
插件基於 @deepseek-ai/dsh-client-ui-primitives 等官方依賴構建。
- Link 安裝機制：使用本地路徑安裝時，部署副本爲符號鏈接。修改代碼後必須重裝插件或重啓
dsh web才能生效（hot-reload 僅限已加載插件）。 - 腳本警告：執行
sync-deploy.ps1時會報 LINKED，禁止使用 Copy-Item 進行拷貝。 - 文件修改：修改
package.json、cordis.patch.yml或index.js後，需要執行上述重裝或重啓操作。 - 兼容性：插件要求 DSH Web 版本 >= 0.1.0-rc.6。
結語¶
dsh-theme-aurum 提供了一套從側欄、會話流到工具卡的全鏈路視覺接管方案，適合希望在 DSH Web 中統一視覺風格或進行界面定製的開發者。
