前言¶
DeepSeek Harness (DSH) Web GUI 默認基於桌面端交互邏輯開發。在 iPad 或移動設備上使用時，WebKit 渲染引擎與觸控手勢管線容易產生衝突，導致會話列表滑動卡頓、側邊欄因屏幕臨界值誤摺疊、以及切換會話時系統軟鍵盤誤彈等問題。
dsh-plugin-mobile-touch 是一個專爲解決這些觸控痛點而設計的插件。它通過攔截原生事件與重寫觸控邏輯，在 iPadOS 15+ 環境下提供更接近原生應用的交互體驗。
核心功能¶
該插件主要包含以下能力：
- 智能硬件感知：自動識別觸控屏環境（
pointer: coarse），僅在觸控設備上激活，桌面端鼠標操作零開銷。 - 獨佔式樹狀列表觸控引擎：重寫會話列表的觸控事件處理，確保 100% 毫秒級滑動響應。
- 軟鍵盤智能防誤彈守衛：攔截非意圖的輸入框聚焦，僅在用戶直接點擊輸入框時允許系統鍵盤彈出。
- iPad 平板大屏側邊欄常駐守護：鎖定側邊欄展開狀態，防止屏幕分辨率臨界值（如 1024px）引起的意外摺疊。
- 精準原生滾動條渲染：修正滾動條顯示比例與遮擋問題。
- 全域自動自適應：優化後的觸控邏輯適用於後續安裝的所有新 UI 插件。
安裝與啓用¶
安裝前請確保本地已安裝 Node.js 環境且 DSH 版本滿足依賴要求。
1. 通過 npm 安裝
# 安裝插件依賴
npm install -D @anonyjcy/dsh-plugin-mobile-touch
2. 通過 CLI 掛載到 DSH Profile
# 一鍵掛載到默認 Web Profile
npx @anonyjcy/dsh-plugin-mobile-touch install
# 檢查安裝狀態與健康度
node bin/cli.js status
注意事項¶
- 依賴環境：插件依賴
@deepseek-ai/cordis版本>= 3.0.0。 - 平臺限制：僅在觸控屏設備上激活，桌面端不會加載相關邏輯。
- 許可證：項目基於 MIT License 開源。
- 源碼審查：由於涉及對原生 DOM 和事件鏈的攔截，建議在安裝前確認源碼邏輯符合預期。
資源¶
- GitHub 倉庫: https://github.com/AnonyJcy/dsh-plugin-mobile-touch
- DSH 社區目錄: https://www.skillhub.cn/plugins/AnonyJcy/dsh-plugin-mobile-touch
