前言¶
DeepSeek Harness 是一個以插件化爲核心的系統,但其默認界面設計基於桌面端的三欄佈局。在手機或窄視口下打開時,這種佈局會導致導航混亂,且官方設置面板並不適配移動端操作習慣。dsh-ui-mobile-layout 插件通過客戶端樣式重排與覆蓋層疊加,將桌面三欄在窄視口下重排爲單欄,並將官方設置面板改造成符合手機原生習慣的兩級導航界面。該插件由 RyzeZhou 維護,遵循 MIT 協議。
核心功能¶
- 手機單欄佈局:在窄視口下,導航欄收爲左側抽屜,對話區佔滿整屏,無需在三列間左右橫跳。
- 手機原生設置界面:設置面板全屏化,呈現“設置 → 條目列表 → 具體設置頁”的二級導航結構。
- 大觸控目標:頂部返回鍵、列表條目均爲 ≥44px 觸控區,適應手指操作。
安裝與啓用¶
安裝該插件需要手動將包複製到本地實例目錄,並在配置文件中登記依賴與 bundle。具體步驟如下:
- 將包複製到
<profile>/node_modules/dsh-ui-mobile-layout。 - 在
profile/package.json的dependencies中添加:
"dsh-ui-mobile-layout": "file:./node_modules/dsh-ui-mobile-layout"
- 在
dsh.profile.bundles數組中添加"dsh-ui-mobile-layout"。 - 重啓該實例,並驗證 HTTP 200 與插件在 boot graph 中。
安裝並重啓後即自動生效,無需任何開關。
使用方法¶
- 使用手機(或 DevTools 窄視口)打開 DSH。
- 左側抽屜:從屏幕左緣滑出(或點左上菜單按鈕)。
- 點設置入口進入全屏設置列表。
- 點任意條目進入該條目具體設置頁(標題 = 條目名)。
- 使用左箭頭返回:詳情頁回到列表頁,列表頁關閉設置。
注意事項¶
- 依賴環境:本插件在自帶官方基礎插件(shell / ui-settings-general / ui-layout 等)的環境實測可用。
- 插件衝突:可能與其他做移動端樣式重排的插件、重寫/替換官方設置面板或使用極高 z-index 全屏浮層的插件衝突。遇到衝突時建議在獨立實例中逐個驗證。
- 版本回歸:升級 DeepSeek Harness 後需要回歸測試,因爲官方 SettingsRoot 的 nav/content/close 結構若變化,可能需要輕微適配。
- 運行形態:本插件的真實運行形態是 client bundle 插件(責任在瀏覽器端),並不修改/替換官方任何 slot 的佔用者。