dsh-mobile-xc
v0.6.16
Published
DSH Web 移动端 UI 适配集大成插件:overlay 抽屉、安全区、canary 防升级失效;<=1023px 生效,桌面零影响。
Maintainers
Readme
dsh-mobile-xc
DSH Web 移动端 UI 完美适配插件 —— 整合多个移动端插件的最优设计,为 DeepSeek Harness 提供原生的移动端体验。
DSH 0.2.2 适配(
>=0.1.7-rc.1,0.2.2-rc.1 实测):0.2.2 在 <768px 引入 vendor 原生抽屉 (frame[data-sidebar-drawer]),插件已整体让位并改用语义类锚定(详见 CHANGELOG 0.6.9)。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 等
- vendor 原生抽屉让位(DSH ≥ 0.2.2):<768px 时 vendor 自带
data-sidebar-drawer抽屉 (侧栏浮层 + drawerMask + leadingSeat 汉堡),插件自动停用自己的抽屉/遮罩/汉堡与列布局, 只保留安全区与键盘契约,避免双汉堡/双遮罩与移动端白屏
📲 PWA 支持
- 官方黑鲸鱼图标:使用 DSH 官方 favicon
- 离线可用:Service Worker 预缓存关键资源
- 可安装:支持添加到主屏幕
🎯 断点设计
| 断点 | 行为 | |------|------| | ≤1023px | 移动端适配激活 | | <768px | DSH ≥ 0.2.2 走 vendor 原生抽屉,插件让位(仅保留安全区/键盘契约) | | 768–1023px | 插件 overlay 抽屉接管(44px 汉堡 + scrim) | | ≥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.2.2-rc.1 | ✅ 32 条 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 # 构建产物