在 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 仓库。