前言¶
DeepSeek Harness (DSH) 是用于智能体评测与评估的核心工具。在移动设备上使用其 Web 客户端时，常见的触摸交互问题包括工具提示残留、双击误触缩放以及触摸目标过小等。@oksure/dsh-client-ui-mobile-comfort 旨在通过 out-of-tree 插件的形式，修复这些原生 UI 在触摸设备上的缺陷，确保移动端操作符合直觉。
插件定位¶
这是一个针对 DSH Web 客户端的客户端插件，由维护者 oksure 提供。它通过注入响应式样式表和覆盖特定事件行为，专门解决移动端浏览器的六个典型触摸问题，且不影响桌面端的鼠标操作。
核心功能¶
该插件主要包含以下修复能力：
-
抑制幽灵工具提示
在 WebKit 浏览器中，点击侧边栏控件会触发mouseenter，但移动端无法触发mouseleave，导致工具提示气泡长期残留。插件通过 CSS 规则:not((hover: none) and (pointer: coarse))隐藏了这些悬停提示。 -
修复双击缩放歧义
原生 UI 未设置touch-action策略，导致 iOS Safari 快速双击时页面缩放而非点击。插件为交互元素设置touch-action: manipulation，既支持快速点击，又保留捏合缩放能力。 -
扩大触摸目标尺寸
将折叠侧边栏的控件和编辑器控件的最小尺寸从原值扩大到 44px，确保手指点击准确。 -
修复窄屏布局折叠
原生布局在窄屏下侧边栏占 56px，挤压对话区域。插件将对话区域设为全宽，侧边栏折叠时作为覆盖层悬浮在对话上方，点击背景即可关闭，且不会误触下方的控件。 -
抑制触摸悬停拦截
移除触摸事件被误判为悬停的路径，确保点击事件能被正确捕获。 -
扩展折叠会话组
侧边栏初始仅显示五个会话，插件在侧边栏展开时自动扩展显示更多会话，提升导航效率。
安装与启用¶
安装命令如下：
dsh plugin --profile web add file:/path/to/dsh-mobile-comfort
安装完成后，需重启配置文件以应用更改：
dsh web
兼容性与注意事项¶
- 环境要求：需要 Node.js 版本大于等于 22.0.0。
- DSH 版本：已验证兼容 DSH 0.1.5-rc.2 和 0.1.7-rc.2。
- 平台影响：桌面端鼠标指针不受影响，所有修复均基于
pointer媒体特征或touch-action属性生效。 - 根因：部分问题的根源在于上游依赖库
@deepseek-ai/dsh-client-ui-primitives，此插件作为临时补丁方案存在。
总结¶
该插件通过 CSS 注入和事件处理，在不改变桌面布局逻辑的前提下，解决了 DSH Web 客户端在移动端的一系列体验痛点。对于需要在手机或平板上频繁调试评测任务的 DSH 用户，建议直接安装此插件以获得更稳定的手势交互体验。
