前言¶
如果只在电脑或平板上操作 DeepSeek Harness（DSH），原生 Web Shell 的三栏界面已经够用。但如果在手机上查看会话、发起任务，或者等待 agent 完成后回来取结果，界面会有几个具体摩擦：侧边栏和详情面板在窄屏上不好操作，输入区与手机键盘的配合不够直接，Web 页面也不能直接安装为独立入口并接收任务完成通知。
下面介绍 dsh-ui-mobile。它是 DeepSeek Harness Web Shell 的客户端插件，只在 768px 以下启用移动端适配；电脑与平板继续使用原生 Harness 三栏界面。
这是什么¶
dsh-ui-mobile 的一句话定位是：DeepSeek Harness Web shell 的移动端插件，提供 off-canvas sidebar/details drawers、bottom nav bar，以及 touch-first responsive sheet。
当前仓库路径为 jasondu/dsh-ui-mobile，许可证为 MIT。它属于 DSH 插件生态中的客户端插件，不是独立 Web 应用，也不是一个可以脱离 Harness 运行的完整 Web 服务。安装后，它依赖一个运行中的 DeepSeek Harness Web Shell。
核心功能¶
1、移动端布局：插件在 768px 以下启用，桌面与平板布局保持原样。
2、抽屉式侧边栏与详情面板：侧边栏和详情面板从屏幕两侧滑出，适合手机触控。
3、底部导航栏：提供 bottom nav bar，适合移动端查看常用入口。
4、PWA 安装：插件提供 manifest、图标、Service Worker、启动骨架和安装引导，可以把页面添加到主屏幕后独立启动。
5、Web Push 任务完成通知：在已安装的 PWA 中，可以在 agent 成功完成时收到通知；通知仅在成功完成时发送。
6、手机输入区优化：输入框固定在可视区底部，键盘主操作显示为“发送”。
7、边界：插件不复制 Shell，也不修改 Harness 源码；不改变模型请求、系统提示词、工具 schema 或会话内容。KV Cache 影响：无，本插件不参与请求组装。
安装与启用¶
先确认已经有一个运行中的 DeepSeek Harness Web Shell，并确定要安装到的 DSH profile。然后执行安装命令：
dsh plugin --profile <profile> add dsh-ui-mobile
其中 <profile> 替换为实际使用的 DSH profile。安装完成后，在手机浏览器访问该 Web Shell；当窗口宽度低于 768px 时，会看到移动端布局。
注意：插件以当前 dsh 进程权限运行。安装前应先检查源码、依赖行为与许可证；本插件许可证为 MIT，但这不替代对具体运行环境和权限的审核。
典型用法¶
下面列出一组可在手机上验证的操作。
1、打开侧边栏：点左上菜单，或从屏幕最左侧 24px 向右滑。
2、关闭侧边栏：点菜单或抽屉外的暗色区域。
3、发送消息：手机键盘显示“发送”；按回车沿用 Harness 的正常发送流程。
4、Android Chrome / Edge：浏览器可安装时会显示一次性安装引导；点“安装”使用浏览器原生流程。
5、iOS Safari：引导提示“分享 → 添加到主屏幕”。
6、订阅任务完成通知：在已安装的 PWA 中点按“开启任务完成通知”并授予系统权限即可订阅。
启用任务完成通知的注意事项¶
任务完成通知需要 HTTPS、有效 VAPID 配置和用户授权。启用前需要为 Web 服务设置 VAPID 和订阅存储路径；三项 VAPID 环境变量需同时设置。
其中，DSH_WEB_PUSH_VAPID_SUBJECT 必须是有效邮箱或真实 https:// URL，不能使用 .invalid 占位域名。私钥与订阅文件不可提交到仓库，文件权限应为 0600。iOS 需要 iOS 16.4 或更高版本。
已知限制¶
- 抽屉是 CSS 驱动的固定宽度面板，手机端不支持拖拽调宽。
- 侧边栏支持左边缘滑入；关闭操作为点遮罩或菜单，不支持滑动关闭。
- 插件只在 768px 以下启用，桌面与平板布局保持原样。
- 本包是客户端插件，不是独立 Web 应用；需要一个运行中的 DeepSeek Harness Web Shell。
结尾¶
dsh-ui-mobile 解决的是把 DeepSeek Harness Web Shell 放到手机上后的日常操作问题：抽屉式导航、底部导航、PWA 安装、输入区适配，以及 agent 成功完成后的系统通知。它不改变模型请求、系统提示词、工具 schema 或会话内容，也不参与请求组装。
相关地址：
上述目录页是独立站点，不与 DeepSeek / 幻方构成官方从属关系。
