dsh-mobile-glass:DSH Web 移动端适配插件

在 DSH Web 的实际使用中,移动端的适配往往需要针对特定组件(侧栏、输入框、头部)进行大量手动调整。现有的布局在窄屏设备上容易导致交互不便或视觉错位。针对这一场景,dsh-mobile-glass 插件提供了一套移动端专用的交互方案,旨在通过代码层面的覆盖,在不影响桌面端体验的前提下,优化移动端的操作手感。

这是什么

该插件是 DeepSeek Harness (DSH) 的一个 Web 移动端适配插件,由 YiRan0 维护。它专门针对 ≤1023px 的屏幕尺寸设计,通过覆盖特定的 DOM 结构与 CSS 样式,实现聊天页在上、侧栏在下的 reveal 抽屉交互,同时修复移动端特有的输入框与头部布局问题。其设计原则是桌面端(≥1024px)零影响。

核心功能

侧栏与抽屉

移除底部导航,改为顶部悬浮玻璃汉堡菜单打开侧栏。侧栏作为底层 static(不参与动画),聊天列通过 translateX 右移实现 reveal 效果。

拖动手势

采用 setPointerCapture 配合 rAF 节流、方向锁定与速度/位移吸附机制。当拖拽命中横向可滚动元素(如宽表格、代码块)时,会自动让位原生横向滚动,保证文本可读性。

自适应输入框

右侧气泡与输入框圆角自适应。未聚焦时居中紧凑,聚焦时展开全宽并抬升至约 2.5 行高度,失焦平滑缩回。内容增多时自动增高。发送键与模型选择器在同一行,过渡动画时长 0.32s。

设置面板与头部清理

设置面板采用底部卡片上滑覆盖的方式呈现。头部区域进行清理,隐藏 session-log、tabs、标题对齐,以及侧栏自带 toggle 和 better-sidebar 按钮,释放移动端顶部空间。

PWA 支持

插件自带 Service Worker 和增强 Manifest。通过 Host 侧的 webServer 精确路由提供 SW 文件与 Manifest,不修改 DSH vendor 文件,升级无冲突。

安装与启用

在 DSH 项目目录下执行以下命令安装:

dsh plugin --profile web add github:YiRan0/dsh-mobile-glass

安装完成后,重启 dsh web 进度可生效。

典型用法

安装后插件自动适配移动端,无需额外配置。在移动端浏览器中打开,即可体验优化后的抽屉交互、手势滑动与自适应输入框布局。

适用场景与注意

该插件适合需要在 DSH Web 上获得原生移动端体验的开发者或用户。

注意事项:
1. 真机拖拽偶发抖动,疑为侧栏 backdrop-filter 实时模糊导致,目前尚未完全解决。
2. 卸载插件后,浏览器中已注册的 Service Worker 会保留,需手动清除一次:DevTools → Application → Service Workers → Unregister(或清除站点数据)。
3. 插件以当前 DSH 进程权限运行,使用前建议检查源码与许可证。

总结

dsh-mobile-glass 通过精细的 DOM 操作与 CSS 变换,解决了 DSH Web 在移动端的布局痛点,实现了 reveal 抽屉、自适应输入框与手势交互的统一。作为一款零桌面影响的移动端适配方案,它降低了手动编写移动端 CSS 的成本。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜