前言¶
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 用戶，建議直接安裝此插件以獲得更穩定的手勢交互體驗。
