前言¶
在手機上用瀏覽器打開 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 並重啓。
典型用法與驗收¶
- 在目標 profile 執行上述
add dsh-mobile-shell,重啓 harness 後啓動 Web UI。 - 將瀏覽器或 WebView 寬度保持在 1023px 及以下,覈對頂欄、抽屜、輸入卡與設置全屏是否符合預期。
- 若使用 dsh-android,安裝 1.4.0 APK 後在 App 內打開同一 profile 的 Web UI,驗證附件彈層與
DSHNative提供的最近照片等區域。 - 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