xchannel1987/dsh-mobile-xc

中文 | English

DSH Web 移动端 UI 完美适配插件 —— 整合多个移动端插件的最优设计，为 DeepSeek Harness 提供原生的移动端体验。

DSH 0.1.7 兼容（>=0.1.7-rc.1）：设置入口现在位于新版「插件页」（Plugins 页）的 dsh-mobile-xc 包内（plugins.bundle.config，与 modsearch / 官方 subagent 同款机制）； 旧版「设置 → 插件」入口已随 0.1.7 设置系统重构移除。

✨ 核心特性

📱 移动端抽屉导航

• Overlay 抽屉：侧边栏以覆盖层形式滑出，不影响主内容区
• Scrim 遮罩：点击遮罩关闭抽屉，符合移动端交互习惯
• 手势支持：支持滑动打开/关闭抽屉（可配置）
• Escape 键关闭：键盘用户友好
• 轮次导航：对话右侧轮次刻度条，平时淡显，点击先预览轮次内容、再点同一刻度跳转
• 页头横向滑动：窄屏页头保持单行，会话名与 PTC/用量徽标溢出时可左右滑动，右缘渐隐提示、滑到尽头自动撤除

🎨 玻璃卡片设计

• Glassmorphism 风格：现代毛玻璃视觉效果
• 一行输入框：移动端输入区紧凑布局
• FLIP 动画：流畅的状态切换动画
• 44px 触控热区：符合移动端交互标准

📐 Safe Area 全覆盖

• 刘海屏适配：正确处理 iPhone X 等机型的安全区域
• 底部手势条：避免内容被手势条遮挡
• 动态视口：支持 dvh 单位，键盘弹出时自动调整

🔄 智能兼容系统

• 版本失配检测：自动检测 DSH 版本兼容性
• 软告警机制：兼容问题不阻塞使用，仅提示
• 兜底降级：极端情况下自动降级，保证可用
• 第三方插件兼容：已适配 dshmarket、dsh-better-sidebar 等

📲 PWA 支持

• 官方黑鲸鱼图标：使用 DSH 官方 favicon
• 离线可用：Service Worker 预缓存关键资源
• 可安装：支持添加到主屏幕

🎯 断点设计

断点	行为
≤1023px	移动端适配激活
≥1024px	桌面模式，零影响

与 DSH 内置 SIDEBAR_AUTO_COLLAPSE=1024 对齐，无缝切换。

📦 安装

# 使用 DSH CLI
dsh plugin --profile web add dsh-mobile-xc

# 或使用 npm
npm install dsh-mobile-xc

安装后重启 DSH 即可生效。

⚙️ 配置

插件可通过 DSH 设置 → 「移动端 UI」分区进行配置：

选项	类型	默认值	说明
swipeEnabled	boolean	true	从屏幕左边缘右滑打开工作区抽屉
dshmarketNavFix	boolean	true	窄屏保留设置导航，防止市场页死路
pwaEnabled	boolean	true	PWA 离线缓存
drawerRefresh	boolean	false	侧栏底部刷新入口（PWA 无下拉刷新时的手动刷新）
headerScroll	boolean	true	页头标题与 PTC/用量徽标保持单行，溢出左右滑动
turnRail	boolean	true	对话右侧轮次刻度条：平时淡显，点击预览轮次、再点同一刻度跳转

🔗 兼容性矩阵

包	验证版本	状态
DSH (vendor)	0.1.1-rc.2	✅ 18 条 selector 映射
dshmarket	1.20.x	✅ 导航死路修复
dsh-better-sidebar	0.15.2	✅ 和平共存
dsh-token-usage	0.2.16	✅ 已注册兼容

🛠️ 开发

pnpm install
pnpm verify        # 类型检查 + lib 漂移检查
pnpm test          # 单元测试
pnpm build         # 构建产物

📄 许可证

MIT

🔗 链接

• GitHub
• npm
• 问题反馈