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
羽毛球分组比赛记分
小程序二维码

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

小夜