在 DSH Web 模式下,移動端佈局常面臨抽屜導航遮擋、劉海屏內容溢出及輸入框排版錯亂等問題。dsh-mobile-xc 旨在解決這些移動端適配痛點,爲 Web 模式提供原生的移動端體驗。
插件定位¶
這是一個 DSH Web 移動端 UI 適配插件。它覆蓋了移動端抽屜導航、Safe Area 適配和 PWA 支持等基礎問題。由維護者 xchannel1987 提供,採用 MIT 許可證。
核心功能¶
- 移動端抽屜導航:支持 Overlay 抽屜、手勢滑動打開/關閉、Escape 鍵關閉、對話右側輪次導航、頁頭橫向滑動。
- 玻璃卡片設計:提供 Glassmorphism 風格,支持 FLIP 動畫,觸控熱區爲 44px。
- Safe Area 全覆蓋:適配劉海屏、底部手勢條,支持動態視口
dvh單位。 - 智能兼容系統:檢測版本失配,提供軟告警、兜底降級及第三方插件兼容。
- PWA 支持:提供官方圖標、離線可用能力及可安裝特性。
- 斷點設計:在 <=1023px 下激活移動端適配,>=1024px 保持桌面模式。
安裝與啓用¶
使用 DSH CLI 進行安裝:
dsh plugin --profile web add dsh-mobile-xc
安裝後需要重啓 DSH 才能生效。DSH 版本需 >= 0.1.7-rc.1。
典型用法¶
插件支持以下配置項:
swipeEnabled: 是否開啓從屏幕左邊緣右滑打開工作區抽屜。dshmarketNavFix: 窄屏下是否保留設置導航,防止市場頁死路。pwaEnabled: 是否開啓 PWA 離線緩存。drawerRefresh: 是否在側欄底部提供手動刷新入口。headerScroll: 頁頭標題與 PTC/用量徽標溢出時是否支持橫向滑動。turnRail: 對話右側輪次刻度條是否支持點擊預覽與跳轉。
適用場景與注意¶
本插件以當前 DSH 進程的權限運行,安裝前建議檢查源碼與許可證。依賴項包含 @deepseek-ai/schemastery。
總結¶
該插件整合了多種移動端適配方案,適合需要在 Web 模式下獲得移動端體驗的開發者。更多詳情與反饋請訪問:插件目錄 或 GitHub 倉庫。