dsh-mobile-xc

dsh plugin --profile web add dsh-mobile-xc

dsh-mobile-xc





[中文](README.md) | [English](README_EN.md)

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](LICENSE)

🔗 链接

• GitHub
• npm
• 问题反馈