dsh-mobile-shell:爲 DSH Web UI 提供 DeepSeek App 風格移動殼層

前言

在手機上用瀏覽器打開 DSH Web UI,常見問題是佈局仍偏桌面:左側常駐圖標欄佔寬、輸入區不像官方 App、附件與設置缺少全屏移動交互。若你已經在用 DeepSeek Harness 做智能體開發,又希望在窄屏上接近官方 DeepSeek App 的體驗,可以在 profile 里加裝純客戶端插件,而不改服務端邏輯。

下面介紹社區插件 dsh-mobile-shell(維護者 Htao-uu,MIT 許可,非官方)。它只在窄屏生效,把宿主界面整理成豎屏手機殼層;與 dsh-android 搭配時,還能用到原生相機、相冊、返回鍵等能力。

這是什麼

dsh-mobile-shell 的定位是:爲 DSH Web 界面提供接近官方 DeepSeek App 的豎屏手機殼層。README 明確說明本項目與 DeepSeek 無隸屬關係。

  • 分類:客戶端(DSH Web UI 插件)
  • 生效範圍:視口寬度 ≤1023px 時啓用;≥1024px 時插件不生效,桌面端佈局不受影響
  • 當前版本(package.json):0.7.5
  • 依賴:peer @deepseek-ai/cordis ^4.0.1;客戶端注入 @deepseek-ai/dsh-client-ui-layout,Node ≥20

插件正在快速迭代,README 提示存在 BUG 與體驗問題,可通過 GitHub Issues 反饋。

與 dsh-android 的搭配

單獨把 dsh-mobile-shell 裝進 DSH Web UI 也能工作,但 README 不建議單獨安裝(可能存在 BUG)。殼層本身只負責 Web 端移動 UI;原生相機/相冊、最近照片條、全屏 WebView、Android 返回鍵、內置運行時和完整設置頁適配,來自配套 App。

推薦組合(資料原文):

  • dsh-android 1.4.0 + dsh-mobile-shell 0.7.5+
  • 最新 APK:https://github.com/Htao-uu/dsh-android/releases/tag/v1.4.0

核心功能

以下能力均來自倉庫 README 的功能列表。

移動殼層與導航

  • 隱藏常駐左側圖標欄;頂欄提供菜單(☰)、右側詳情、新建會話入口
  • 左右抽屜均爲屏寬 80% 的 carousel 抽屜,主頁面 1:1 推移並淡出;支持全屏跟手拖動,按 50% 行程或 125px/s 速度判定開關,spring 收尾

輸入與附件

  • App 風格輸入卡:28px 圓角、輕陰影、圓形發送/停止按鈕、膠囊式權限/模型控件,輸入字號 16px
  • composer 的「+」打開底部附件彈層(拍照 / 相冊 / 文件,系統選擇器)
  • 「最近照片」依賴可選的 window.DSHNative;橋不存在、超時或無權限時該區域自動隱藏,其餘 DSH 功能不受影響。協議見倉庫 docs/ANDROID-BRIDGE.md

設置與返回棧

  • 全屏設置面板、返回箭頭、緊湊分組列表
  • Android 返回鍵順序:附件彈層 → 設置 → 右抽屜 → 左抽屜,再交給宿主默認行爲

安裝與啓用

安裝命令以 README 爲準:

dsh plugin --profile <profile> add dsh-mobile-shell
# 或在 DSH Web UI:設置 → 插件 → 添加插件 → dsh-mobile-shell
# 安裝後重啓一次 harness
dsh --profile <profile> web

本地開發可鏈接目錄(同樣來自 README):

dsh plugin --profile <profile> add link:/path/to/dsh-mobile-shell

若從源碼改 src/,需 npm run build,瀏覽器 bundle 在 lib/client.js;無 pnpm 時也可把倉庫複製到 <DSH_HOME>/profiles/<profile>/node_modules/dsh-mobile-shell 並重啓。

典型用法與驗收

  1. 在目標 profile 執行上述 add dsh-mobile-shell,重啓 harness 後啓動 Web UI。
  2. 將瀏覽器或 WebView 寬度保持在 1023px 及以下,覈對頂欄、抽屜、輸入卡與設置全屏是否符合預期。
  3. 若使用 dsh-android,安裝 1.4.0 APK 後在 App 內打開同一 profile 的 Web UI,驗證附件彈層與 DSHNative 提供的最近照片等區域。
  4. README 截圖基於獨立 demo profile(Test Workspace,360×780 CSS px),不含真實會話數據,可作 UI 對照。

更多流程與設計說明見倉庫 docs/WORKFLOW.md、docs/DESIGN.md、docs/GLOSSARY.md。

適用場景與注意

適合:經常在手機或窄屏 WebView 裏使用 DSH Web UI,希望界面接近官方 App,且願意配合 dsh-android 獲得完整移動能力。

注意:

  • 插件以當前 DSH 進程權限運行;安裝前請查看 GitHub 源碼 與 MIT 許可,保留版權聲明與作者署名 Htao-uu。
  • 社區目錄 skillhub.cn 插件頁 與 GitHub 爲獨立信息源,與 DeepSeek / 幻方無官方從屬關係。
  • 單獨 Web 插件安裝可能遇到 README 所述 BUG;生產環境更穩妥的是 dsh-android 1.4.0 + dsh-mobile-shell 0.7.5+ 組合。

結尾

dsh-mobile-shell 用純客戶端方式,在窄屏下重組 DSH Web UI 的導航、輸入、附件與設置,桌面寬屏零改動。需要原生能力時與 dsh-android 配套使用。

  • 目錄頁:https://www.skillhub.cn/plugins/Htao-uu/dsh-mobile-shell
  • 倉庫:https://github.com/Htao-uu/dsh-mobile-shell
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜