前言¶
在手机上用浏览器打开 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