前言¶
DeepSeek Harness（DSH）的 Web UI 默認面向桌面寬屏設計：側欄常駐、彈窗居中、輸入區一行排開多個控件。在電腦上用瀏覽器開 dsh web 沒問題；換成手機豎屏，側欄佔寬度、設置彈窗難點、權限膠囊和模型名擠在一起，會話體驗會明顯變差。
社區裏有人 fork 做移動端補丁，但維護分散、和官方 UI 迭代容易脫節。下面介紹 dsh-web-mobile（GitHub：mexiaosqwq/dsh-web-mobile，維護者 mexiaosqwq）：它是 DSH Web UI 的移動端適配插件，目標很明確——窄屏好用，寬屏儘量不打擾原有佈局。
這是什麼¶
dsh-web-mobile（npm 包名 @dsh-external/dsh-mobile-nav）屬於 DSH 生態中的客戶端類插件，通過 Cordis patch 與客戶端腳本注入，在 Web profile 下改寫 DSH Web UI 的導航與佈局行爲。
它不替換 DSH 本體，也不改會話邏輯；主要解決手機、平板豎屏下的可用性問題。桌面端（視口寬度 ≥1024px）設計上爲 no-op，不影響你現有的寬屏工作流。
核心功能¶
窄屏佈局改造¶
手機豎屏下，插件把桌面側欄收進 overlay 抽屜，會話區佔滿寬度；點會話行後抽屜自動收起。設置、文件樹、預覽等彈窗改爲底部 sheet，更適合觸屏操作。
輸入區在窄屏下做了防重疊處理：權限膠囊、模型名、切換菜單固定尺寸釘位，避免發送按鈕、加號、上下文按鈕被擠壓漂移。狀態欄方面處理了劉海安全區、深/淺主題，並保留宿主 maximum-scale，頁面縮放行爲與官方一致。
平板與桌面分界¶
視口在 768–1023px 時限寬居中；≥1024px 不啓用移動端改造。這樣既覆蓋平板豎屏，又避免在桌面端引入多餘樣式。
大 JSON 響應壓縮（Unreleased）¶
宿主半加載階段對 Node http.ServerResponse 打補丁：對 ≥4KB 的 JSON 響應，按客戶端 Accept-Encoding 自動 gzip 或 brotli 壓縮（brotli 優先）。小體積 JSON、非 JSON 響應原樣透傳，SSE 流不受影響。該能力移植自社區 fork wzxmt-zhc/dsh-web-mobile v2.5.0。
診斷模式¶
URL 加 ?mobile-nav-debug=1 可顯示懸浮診斷條，查看視口、浮層狀態與 JS 錯誤，便於排查移動端佈局問題。
兼容插件¶
README 列出的已驗證兼容組合包括：
- dsh-web-ui — 0.1.20
- dshmarket — v1.20.2
- dsh-usage-stats — 0.2.10
- dsh-genui — 0.9.1
- dsh-meme — v0.1.39
近期版本（如 v2.1.1）還針對 dshmarket 移動端 UI、Agent preset 模式菜單、插件市場導航等做了適配修復。
安裝與啓用¶
從 GitHub 一行安裝（官方 README 命令）：
dsh plugin --profile web add github:mexiaosqwq/dsh-web-mobile
倉庫自帶構建產物，無需 allowBuilds 攔截。安裝完成後重啓 dsh web 生效。
本地開發或調試時，可鏈接本地目錄：
dsh plugin --profile web add link:/path/to/dsh-web-mobile
典型用法¶
日常移動端訪問¶
- 按上文命令安裝插件並重啓
dsh web。 - 在手機瀏覽器打開 DSH Web 地址（與桌面同一服務）。
- 豎屏下側欄默認收起；點菜單按鈕打開抽屜瀏覽會話列表，選中會話後抽屜自動關閉。
- 設置、文件樹、預覽從底部 sheet 彈出，按觸屏習慣操作即可。
排查佈局問題¶
頁面 URL 追加調試參數：
?mobile-nav-debug=1
觀察懸浮診斷條中的視口尺寸、浮層開關狀態；若出現 JS 錯誤，診斷條會一併顯示。
從源碼構建¶
需要改源碼時，在倉庫根目錄執行：
pnpm install
pnpm build
lib/ 與源碼同步入庫；改動後需重新構建再提交。倉庫還提供 pnpm verify（類型檢查）、pnpm run smoke:cdp（CDP 迴歸門禁）等腳本。
適用場景與注意¶
適合誰
- 經常在手機或平板豎屏上查看、切換 DSH 會話的開發者。
- 已安裝 dshmarket、dsh-meme 等 Web 客戶端插件，希望在窄屏下保持可用佈局的用戶。
- 需要在移動網絡下加載大體積會話 JSON、關注加載速度的場景（Unreleased 壓縮能力）。
使用前注意
- 插件隨當前
dsh web進程運行，具備該進程權限；安裝前建議閱讀 GitHub 倉庫 源碼與 MIT 許可證。 - 插件面向 Web profile；安裝命令需帶
--profile web。 - 社區目錄 SkillHub 插件頁 與 GitHub 爲獨立信息源，與 DeepSeek / 幻方無官方從屬關係；版本與兼容信息以倉庫 README 爲準。
- 當前 package.json 版本爲 2.1.1；大 JSON 壓縮等功能在 Unreleased 變更中，升級後留意 release 說明。
結尾¶
dsh-web-mobile 把 DSH Web UI 的側欄、彈窗、輸入區和安全區適配到移動端，並在寬屏下保持 no-op，不額外干擾桌面體驗。若你希望在手機上也能順暢管理 DSH 會話，可以按官方命令安裝試用。
