dsh-ui-mobile

中文 | English

把 DeepSeek Harness 变成一套真正适合在手机上持续使用的工作台：侧栏可单手操作、输入区不会被键盘挤走、可安装为独立 App，并能在 agent 成功完成后主动提醒你回来查看结果。

dsh-ui-mobile 是 DeepSeek Harness Web Shell 的移动端插件。它不重写会话界面，而是在手机宽度下把现有三栏 Shell 转换为更适合触控、PWA 安装和任务完成通知的体验；桌面与平板布局保持原样。

为什么安装

如果你会通过手机查看或发起 Harness 任务，这个插件解决的是高频摩擦，而不是只换一套样式：

• 添加到桌面，获得类 App 体验：把 Web GUI 添加到主屏幕后，可从图标独立启动、没有浏览器地址栏；agent 成功完成时还能收到系统推送，不必反复打开页面确认。
• 手机上也能高效操作：边缘滑动、抽屉导航、新会话菜单和键盘“发送”让核心操作无需放大、缩小或寻找小控件。
• 不牺牲桌面工作流：改动只在 768px 以下启用，电脑与平板继续使用原生 Harness 三栏界面。
• 安装后即可用：插件自带 PWA、Service Worker 和 Web Push 路由，不需要维护 Harness 的 fork 或额外改 Web 源码。

适合需要在移动端跟进长任务、外出时临时发起任务，或希望把 Harness 作为桌面图标中的轻量工作 App、把任务完成提醒交给系统通知的使用者。

你会得到什么

• 手机端抽屉导航：侧边栏与详情面板从屏幕两侧滑出；轻点遮罩、点菜单或从左侧边缘右滑都能管理侧边栏。
• 连续的会话入口：普通会话和空白新会话都提供左上菜单；抽屉打开后会覆盖按钮，避免层级冲突。
• 更适合手机的输入区：输入框固定在可视区底部，防止 iOS 缩放；隐藏 Session log 下载，将 Access mode 放到工具栏最右侧；键盘主操作显示为“发送”。
• 独立 PWA：添加到主屏幕后，从桌面图标启动即获得无地址栏的类 App 体验；插件提供 manifest、图标、Service Worker、启动骨架和安装引导，无需修改 Harness Web 源码。
• 任务完成通知：已安装的 PWA 可在 agent 成功完成时收到 Web Push 通知；通知只在成功完成时发送。

安装

需要一个运行中的 DeepSeek Harness Web Shell。本包是客户端插件，不是独立 Web 应用。

# 从 npm 安装到某个 DSH profile
dsh plugin --profile <profile> add dsh-ui-mobile

# 或从当前仓库 / GitHub 安装
dsh plugin --profile <profile> add github:jasondu/dsh-ui-mobile

插件自带 cordis.patch.yml：它会禁用宿主内置的 ui-mobile，再挂载本插件，以避免两个 PWA 路由和两套移动端样式同时生效。通常不需要手动编辑宿主的 patch 文件。

@deepseek-ai/dsh-client-* 是运行时 peer dependencies。应在拥有相应 Harness 依赖的 DSH Web 环境中安装本插件。

手机上的使用方式

| 场景 | 操作 | | --- | --- | | 打开侧边栏 | 点左上菜单，或从屏幕最左侧 24px 向右滑。 | | 关闭侧边栏 | 点菜单或抽屉外的暗色区域。 | | 新开会话 | 空白会话顶部同样保留菜单入口。 | | 发送消息 | 手机键盘显示“发送”；按回车沿用 Harness 的正常发送流程。 | | 使用桌面 | 宽度达到 768px 后恢复 Harness 原始三栏布局。 |

侧边栏在手机上使用紧凑宽度 min(78vw, 300px)，列表保持可读，同时保留足够的遮罩关闭区域。

安装到主屏幕（PWA）

插件的宿主部分会在服务页面时注入 manifest 与 iOS PWA 标签，并通过 /pwa/ 提供图标、manifest 和 Service Worker。

• Android Chrome / Edge：浏览器可安装时会显示一次性安装引导；点“安装”使用浏览器原生流程。
• iOS Safari：引导提示“分享 → 添加到主屏幕”。关闭后不会在该浏览器中再次自动显示。
• 从主屏幕启动：以独立 PWA 运行，不显示浏览器地址栏；普通 Safari 访问仍保留浏览器外壳，这是平台行为。

任务完成 Web Push

插件只在 agent 成功完成时（turn/end，reason.kind: completed）发送通知。为 Web 服务设置 VAPID 和订阅存储路径；私钥与订阅文件不可提交到仓库。

# 三项同时设置；首次运行时将其写入 DSH_WEB_PUSH_VAPID_PATH。
DSH_WEB_PUSH_VAPID_SUBJECT=mailto:[email protected]
DSH_WEB_PUSH_VAPID_PUBLIC_KEY=<base64url-public-key>
DSH_WEB_PUSH_VAPID_PRIVATE_KEY=<base64url-private-key>

# 后续启动只需保留此路径；文件权限应为 0600。
DSH_WEB_PUSH_VAPID_PATH=/var/lib/dsh/vapid.json
DSH_WEB_PUSH_STORE_PATH=/var/lib/dsh/push-subscriptions.json

在已安装的 PWA 中点按“开启任务完成通知”并授予系统权限即可订阅。iOS 需要 iOS 16.4 或更高版本；DSH_WEB_PUSH_VAPID_SUBJECT 必须是有效邮箱或真实 https:// URL，不能使用 .invalid 占位域名。

架构边界

插件通过 Harness 已公开的 slot、服务与稳定 data-* 属性组合功能：它不复制 Shell，也不修改 Harness 源码。移动端控制器读取现有 AppFrame 状态，响应式样式只针对插件标记的属性；PWA 与 Web Push 路由由插件的 node 部分提供。

模型体验

移动布局、PWA 和通知不改变模型请求、系统提示词、工具 schema 或会话内容。Web Push 仅在宿主已判定 agent 成功完成后向已订阅设备发送事件。

KV Cache 影响

无。本插件不参与请求组装。

已知限制

• 抽屉是 CSS 驱动的固定宽度面板，手机端不支持拖拽调宽。
• 侧边栏支持左边缘滑入；关闭操作为点遮罩或菜单，不支持滑动关闭。
• PWA 安装与键盘“发送”文案受浏览器和系统版本控制；插件提供的是标准 Web 平台提示。
• 任务完成通知需要 HTTPS、有效 VAPID 配置和用户授权。

开发与发布

pnpm install
pnpm bundle
pnpm test

推送 v* 标签会触发 GitHub Actions：安装依赖、构建、运行 publint，再发布到 npm。正式版本使用 latest，预发布版本使用 next。

License

MIT — see LICENSE.