cindyguyuehu123/dsh-mobile 预览 preview

cindyguyuehu123/dsh-mobile

使用DeepSeek Harness于你的iPhone/iPad:局域网反向代理,iOS PWA(添加到主屏幕)Chrome浏览器,以及适用于Web GUI的触控/移动端CSS。

Project Overview项目介绍

dsh-mobile is a native plugin built specifically for DeepSeek Harness that enables access to the DSH web interface from iPhones and iPads on the same local network. It works around the default DSH restriction that only allows access from 127.0.0.1, by creating a reverse proxy that rewrites request headers to pass DSH's trust check for both HTTP and WebSocket connections. It can be installed automatically via the official DSH plugin command, or installed manually by cloning the repo, adding a link dependency, and registering it in your DSH profile's cordis.patch.yml. After installation and a restart of DSH, the plugin will output a local network URL and a QR code you can scan with your mobile device.

Once your mobile device loads the DSH page in Safari, you can add it to your iOS home screen, which turns it into a PWA that opens fullscreen just like a native app. The plugin adapts the DSH interface for touch interaction: it disables double tap zoom, adds safe area padding for iPhone notch and home indicator, and ensures the input field stays above the on-screen keyboard when you type. It includes a dedicated QR code page on the desktop that makes scanning even easier for larger screens. It is designed for DSH users who want to check or continue their agent conversations while away from their desktop computer.

This project is released under the permissive MIT open-source license, so you can use or modify it freely for personal or commercial projects. You must apply the included required patch for the UUID generation bug that breaks connections from non-secure contexts like remote LAN IP addresses. All patches are backed up in the repository, so you can re-apply them after upgrading your main DeepSeek Harness installation. It only works on the same local network, and you should never enable it on untrusted public networks because any device on the network can access your DSH instance.

dsh-mobile 是专为 DeepSeek Harness 开发的原生插件,用于让 DSH 的 Web 界面能在 iPhone 和 iPad 上正常访问使用。它通过启动一个监听所有网卡的反向代理,转发移动端请求到本地回环的 DSH 服务,绕过了上游默认只允许本地访问的限制。插件还提供了 iOS PWA 封装、触屏交互适配和扫码访问页面,给用户接近原生应用的使用体验。

安装完成后,插件会在 DSH 启动时输出局域网访问地址和二维码,用户只需要让手机连接同一 Wi-Fi,扫描二维码即可在 Safari 中打开 DSH 界面,之后可以通过 Safari 的分享菜单把 DSH 添加到主屏幕,后续就能像打开原生 App 一样从主屏幕直接启动。它适合需要在移动设备上随时查看或操作 DSH 会话的用户。

本插件采用 MIT 许可证开源,使用前需要注意,开启后同一局域网内所有设备都能访问你的 DSH 实例,因此只能在可信任的私人网络中使用。需要对安全上下文 UUID 打一个必须的补丁,才能让移动端连接正常工作,补丁文件已随仓库备份,升级 DSH 后重新应用即可。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 6 stars - very few users, little community feedback星标只有 6,几乎没人在用,遇到问题缺少社区反馈
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 https://github.com/cindyguyuehu123/dsh-mobile.git

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

READMEREADME

dsh-mobile

English

让 DeepSeek Harness Web GUI 在 iPhone / iPad 上也能用:局域网反向代理 + iOS PWA(添加到主屏幕)+ 触屏适配。

DeepSeek Harness 的 Web GUI 默认只监听 127.0.0.1(上游出于安全刻意禁止 --host 0.0.0.0)。本插件为它补齐手机端体验:

  • 📱 局域网访问 —— 插件自己起一个 0.0.0.0 反向代理,把手机/iPad 的请求转发给回环服务,并改写 Host/Origin 通过 /api 信任栅栏(HTTP 与 WebSocket 升级都支持)。启动时打印局域网地址和终端二维码。
  • 🍎 iOS PWA 外壳 —— 注入 apple-mobile-web-app-capable、viewport-fit=cover、apple-touch-icon 等元信息,程序化生成 PNG 图标,增强 manifest.webmanifest。Safari「添加到主屏幕」后像原生 App 一样全屏打开,带独立图标。
  • 👆 触屏适配 —— 注入移动端 CSS:输入框 ≥16px 防 iOS 聚焦缩放、touch-action: manipulation 去掉双击缩放延迟、iPhone 刘海/Home 指示条安全区留白、软键盘弹出时把输入区抬到键盘上方(visualViewport 监测)、消息操作按钮增大点按目标。
  • 🔳 /mobile 扫码页 —— 桌面浏览器打开 http://127.0.0.1:3080/mobile 显示大二维码 + 步骤说明,手机相机一扫即开。

⚠️ 安全警告(必读)

启用本插件后,同一局域网内的所有设备都能访问你的 Harness,并且可以完全驱动它——包括执行代码的工具。 这不是瑕疵,是"手机能用"的前提。请务必:

  • 只在你自己信任的网络(如家里 Wi-Fi)开启;
  • 连接公共/陌生 Wi-Fi 时,从 cordis.patch.yml 移除 mobile 行(或临时把行注释掉)再重启;
  • 可选:用 allow 配置只放行指定手机 IP(见下文)。

🔧 harness 源码补丁(按需,不依赖 dsh-webchatlike)

dsh-mobile 本身完全不依赖 dsh-webchatlike——没装 webchatlike 的原版 harness 也能用移动版。补丁按需应用:

补丁 必需? 说明
安全上下文 UUID ✅ 必须 上游 bug: mintRpcId() 用 crypto.randomUUID,该 API 只在安全上下文可用。http://127.0.0.1 是可信源(本机正常),但手机经局域网 IP 访问时不是安全上下文,randomUUID 为 undefined → 每个 RPC 抛错 → 连接握手失败 → 手机端一直转圈白屏。打在上游原版文件上,与 webchatlike 无关
webchatlike 折叠回退 ⚪ 仅配合 webchatlike 修 webchatlike 的版本家族折叠在移动端失效(全新浏览器没有 localStorage 记录)。没装 webchatlike 就不需要——原版没有折叠功能,所有会话本来就独立显示

补丁 1:安全上下文 UUID(必须,与 webchatlike 无关)

文件 改动
packages/host/apiproxy/src/fetch/client.ts mintRpcId() 改用 crypto.getRandomValues 生成 v4 UUID(核心修复)
packages/client/ui-conversation/src/client/service.ts 附件草稿 id 同样替换
packages/llm/llm/src/message.ts 消息 id 同样替换
cd /path/to/deepseek-harness
pnpm run build:lib:client   # 客户端 bundle 会被运行中的 GUI 自动热替换

补丁均已备份在 harness-patches/,升级 harness 后重新应用即可。

补丁 2:webchatlike 折叠回退(可选,仅当你也用 dsh-webchatlike)

packages/client/ui-workspace/src/client/tree.ts、WorkspaceBrowser.tsx、index.ts——同样备份在 harness-patches/。

从 GitHub 安装

仓库地址:github.com/cindyguyuehu123/dsh-mobile(已发布,lib/ 构建产物随仓库分发)

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

← 上一个 Prev dsh-subagent-profile 下一个 Next dsh-custom-brand →