jasondu/dsh-ui-mobile

DeepSeek Harness Web shell 的移动客户端插件:画布外侧边栏/详情抽屉、底部导航栏,以及 768px 以下触控优先的响应式布局。

Project Overview项目介绍

This is a native UI plugin built specifically for DeepSeek Harness Web Shell, designed to optimize Harness’ usability on mobile screen sizes. It does not rewrite Harness’ existing conversation interface, instead it adapts the original three-column desktop layout into a touch-friendly mobile structure only when the screen width is below 768px, leaving desktop and tablet layouts completely untouched. You can install the plugin via the DSH CLI, either from the public npm registry using dsh plugin --profile <profile> add dsh-ui-mobile, or directly from this GitHub repository with dsh plugin --profile <profile> add github:jasondu/dsh-ui-mobile.

The plugin targets users who need to check on running Harness tasks, start new tasks from their mobile devices when away from their desktop, or want a dedicated app-like experience with native system notifications for completed tasks. After installation, you can open the sidebar by swiping right from the left edge of the screen or tapping the menu button in the top left corner. The input box is fixed to the bottom of the viewport to avoid being pushed off-screen by the mobile keyboard, and all core interaction points are resized for comfortable one-handed use. No changes to Harness’ original source code are required, and the layout switches automatically based on screen size.

The plugin requires a working deployment of DeepSeek Harness Web Shell with the @deepseek-ai/dsh-client-* peer dependencies already installed. There are a few known limitations: you cannot drag to resize the sidebar width on mobile, and you cannot swipe to close the sidebar drawer. To get task completion notifications, you need an HTTPS-enabled site, a valid VAPID configuration, and explicit user permission to receive push alerts. The project is released under the open-source MIT license, so it is free to use, modify, and distribute for any purpose.

这是专为 DeepSeek Harness Web Shell 开发的原生移动端 UI 插件,针对手机屏幕使用场景优化了 Harness 的交互体验。它不会重写原有的会话界面,仅在屏幕宽度小于 768px 时把原生三栏布局转换为适合触控操作的移动端结构,桌面和平板布局保持原有样式不变。它支持将 Harness 添加为手机主屏幕的独立 PWA 应用,还能在智能体完成任务后主动推送通知提醒,可通过 DSH 命令行从 npm 或 GitHub 源码安装。

适合需要在移动端跟进长任务、外出时临时发起 Harness 任务,或是希望把 Harness 作为手机轻量工作应用、通过系统通知获取任务完成提醒的用户。使用时,侧边栏可通过左边缘右滑或点击左上角菜单打开,输入框固定在屏幕底部避免被键盘遮挡,新会话入口也适配了移动端触控操作。安装后无需修改 Harness 源码,开箱即可使用适配好的移动交互体验,布局会自动响应屏幕宽度切换。

本插件依赖已部署运行的 DeepSeek Harness Web Shell 环境,需要对应版本的 @deepseek-ai/dsh-client-* 依赖。已知限制包括不支持手机端拖拽调整侧边栏宽度、不支持滑动关闭抽屉,推送通知需要 HTTPS 环境和正确的 VAPID 配置。项目采用 MIT 许可证开源,免费供个人和商业使用,开发可通过 pnpm 安装依赖打包。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 5 stars - very few users, little community feedback星标只有 5,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-ui-mobile

把 jasondu/dsh-ui-mobile 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-ui-mobile

npm version License: MIT

中文 | 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 访问仍保留浏览器外壳,这是平台行为。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev DeepSeek_Prism 下一个 Next dsh-toolbox-web →