DeepSeek Harness (DSH) 的 Web 界面在設計上偏向通用，在移動設備或 PWA 場景下可能存在交互冗餘。dsh-mobile-ui 插件提供了一套移動優先的界面重構方案，將現有的 Web UI 修改爲更接近原生應用的體驗。
插件概況¶
- 名稱：dsh-mobile-ui
- 所有者：Canary-Builds
- 分類：客戶端
- 許可證：MIT
該插件通過 Cordis 架構注入 CSS 樣式和 PWA Manifest，在不修改核心代碼的情況下，改變 Web 界面的佈局和交互邏輯。
核心功能¶
側邊欄優化¶
側邊欄採用應用風格設計：
- 可摺疊圖標欄：摺疊後隱藏 56px 的圖標欄，聊天區域佔據全屏寬度。
- 浮動鯨魚啓動器：在側邊欄第一列的頭部中央顯示主題跟隨的鯨魚圖標。點擊可展開側邊欄，以全屏覆蓋層的形式覆蓋聊天區域，而非推開內容。
- 自動收起：從會話列表打開會話時，側邊欄會自動收起。
頂部欄與控制¶
- 全寬頂部欄：頂部欄寬度鋪滿。
- 模式芯片：顯示當前代理預設模式（如 STD, PTC, MIN, CTR），支持中英文。
- 日誌導出：右側提供會話日誌導出按鈕。
設置界面¶
- 全屏設置表：設置面板鋪滿全屏，無邊距和圓角。
- 圖標導航：導航欄摺疊爲僅圖標模式，保留無障礙標籤。
PWA 支持¶
- 插件提供獨立的 PWA Manifest，設置
display: standalone，使界面能像原生應用窗口一樣安裝和運行。
安裝與啓用¶
確保環境滿足以下條件：
- Node.js 22.19+
- DeepSeek Harness (DSH)
安裝插件到 Web 配置文件：
dsh plugin --profile web add @canary-builds/dsh-mobile-ui
安裝完成後，重啓 DSH 並刷新瀏覽器即可生效。
典型用法¶
遷移自 Splash 插件¶
如果之前安裝了 dsh-plugin-splash，需要先移除再安裝：
dsh plugin --profile web remove dsh-plugin-splash
dsh plugin --profile web add @canary-builds/dsh-mobile-ui
如果安裝過過渡包 @canary-builds/dsh-wpa，請先移除它：
dsh plugin --profile web remove @canary-builds/dsh-wpa
代碼測試¶
插件包含測試腳本，可在本地運行：
npm test
npm run test:package
注意事項與兼容性¶
- 桌面瀏覽器：桌面瀏覽器標籤頁中的 UI 保持原樣（Stock UI），樣式和交互僅對觸摸設備生效。
- 版本依賴：CSS 類哈希是構建特定的，插件針對 DSH 0.1.1-rc.x 版本編寫。如果 DSH 升級導致類名哈希變化，功能可能失效（不會報錯，只是不生效）。
- 衝突規避：不要與
dsh-plugin-splash或@canary-builds/dsh-wpa同時加載，兩者擁有相同的 UI 行爲和路由。 - 重置方式：禁用該插件行可完全恢復所有樣式、插槽和路由。
生態背景¶
DeepSeek Harness 採用「一切皆插件」的理念。社區目錄 skillhub.cn 提供了插件索引，與 DeepSeek 或幻方官方無從屬關係。
