前言¶
如果只在電腦或平板上操作 DeepSeek Harness（DSH），原生 Web Shell 的三欄界面已經夠用。但如果在手機上查看會話、發起任務，或者等待 agent 完成後回來取結果，界面會有幾個具體摩擦：側邊欄和詳情面板在窄屏上不好操作，輸入區與手機鍵盤的配合不夠直接，Web 頁面也不能直接安裝爲獨立入口並接收任務完成通知。
下面介紹 dsh-ui-mobile。它是 DeepSeek Harness Web Shell 的客戶端插件，只在 768px 以下啓用移動端適配；電腦與平板繼續使用原生 Harness 三欄界面。
這是什麼¶
dsh-ui-mobile 的一句話定位是：DeepSeek Harness Web shell 的移動端插件，提供 off-canvas sidebar/details drawers、bottom nav bar，以及 touch-first responsive sheet。
當前倉庫路徑爲 jasondu/dsh-ui-mobile，許可證爲 MIT。它屬於 DSH 插件生態中的客戶端插件，不是獨立 Web 應用，也不是一個可以脫離 Harness 運行的完整 Web 服務。安裝後，它依賴一個運行中的 DeepSeek Harness Web Shell。
核心功能¶
1、移動端佈局：插件在 768px 以下啓用，桌面與平板佈局保持原樣。
2、抽屜式側邊欄與詳情面板：側邊欄和詳情面板從屏幕兩側滑出，適合手機觸控。
3、底部導航欄：提供 bottom nav bar，適合移動端查看常用入口。
4、PWA 安裝：插件提供 manifest、圖標、Service Worker、啓動骨架和安裝引導，可以把頁面添加到主屏幕後獨立啓動。
5、Web Push 任務完成通知：在已安裝的 PWA 中，可以在 agent 成功完成時收到通知；通知僅在成功完成時發送。
6、手機輸入區優化：輸入框固定在可視區底部，鍵盤主操作顯示爲“發送”。
7、邊界：插件不復制 Shell，也不修改 Harness 源碼；不改變模型請求、系統提示詞、工具 schema 或會話內容。KV Cache 影響：無，本插件不參與請求組裝。
安裝與啓用¶
先確認已經有一個運行中的 DeepSeek Harness Web Shell，並確定要安裝到的 DSH profile。然後執行安裝命令：
dsh plugin --profile <profile> add dsh-ui-mobile
其中 <profile> 替換爲實際使用的 DSH profile。安裝完成後，在手機瀏覽器訪問該 Web Shell；當窗口寬度低於 768px 時，會看到移動端佈局。
注意：插件以當前 dsh 進程權限運行。安裝前應先檢查源碼、依賴行爲與許可證；本插件許可證爲 MIT，但這不替代對具體運行環境和權限的審覈。
典型用法¶
下面列出一組可在手機上驗證的操作。
1、打開側邊欄：點左上菜單，或從屏幕最左側 24px 向右滑。
2、關閉側邊欄：點菜單或抽屜外的暗色區域。
3、發送消息：手機鍵盤顯示“發送”；按回車沿用 Harness 的正常發送流程。
4、Android Chrome / Edge：瀏覽器可安裝時會顯示一次性安裝引導；點“安裝”使用瀏覽器原生流程。
5、iOS Safari：引導提示“分享 → 添加到主屏幕”。
6、訂閱任務完成通知：在已安裝的 PWA 中點按“開啓任務完成通知”並授予系統權限即可訂閱。
啓用任務完成通知的注意事項¶
任務完成通知需要 HTTPS、有效 VAPID 配置和用戶授權。啓用前需要爲 Web 服務設置 VAPID 和訂閱存儲路徑；三項 VAPID 環境變量需同時設置。
其中，DSH_WEB_PUSH_VAPID_SUBJECT 必須是有效郵箱或真實 https:// URL，不能使用 .invalid 佔位域名。私鑰與訂閱文件不可提交到倉庫，文件權限應爲 0600。iOS 需要 iOS 16.4 或更高版本。
已知限制¶
- 抽屜是 CSS 驅動的固定寬度面板，手機端不支持拖拽調寬。
- 側邊欄支持左邊緣滑入；關閉操作爲點遮罩或菜單，不支持滑動關閉。
- 插件只在 768px 以下啓用，桌面與平板佈局保持原樣。
- 本包是客戶端插件，不是獨立 Web 應用；需要一個運行中的 DeepSeek Harness Web Shell。
結尾¶
dsh-ui-mobile 解決的是把 DeepSeek Harness Web Shell 放到手機上後的日常操作問題：抽屜式導航、底部導航、PWA 安裝、輸入區適配，以及 agent 成功完成後的系統通知。它不改變模型請求、系統提示詞、工具 schema 或會話內容，也不參與請求組裝。
相關地址：
上述目錄頁是獨立站點，不與 DeepSeek / 幻方構成官方從屬關係。
