前言¶

DeepSeek Harness（DSH）的插件生态强调「一切皆插件」。如果你希望从 iPhone / iPad 上操作本机运行的 DeepSeek Harness Web GUI，但又不想绕过本机回环服务，dsh-mobile 提供了一个可落地的方案：通过局域网反向代理、iOS PWA 外壳和移动端 CSS，让同一局域网内的手机或平板访问 Harness Web GUI。

下面介绍它是什么、能做什么、怎么安装启用，以及需要注意的安全边界。

这是什么¶

dsh-mobile 是一个 DSH 客户端插件，仓库为 cindyguyuehu123/dsh-mobile，许可证为 MIT。

它解决的核心问题是：在 iPhone / iPad 上使用 DeepSeek Harness Web GUI。具体包括三类能力：

• 通过局域网反向代理访问本机 Harness Web GUI；
• 注入 iOS PWA 元信息，支持 Safari「添加到主屏幕」；
• 注入移动端 CSS，处理触屏、安全区、输入缩放和软键盘相关体验。

核心能力¶

局域网反向代理¶

插件会启动一个 0.0.0.0 反向代理，把来自 iPhone / iPad 的请求转发给本机 Harness 回环服务。

它会转发 HTTP 与 WebSocket 请求，并改写 Host / Origin，使手机端流量能进入 Harness Web GUI 的可信访问路径。

iOS PWA 外壳¶

插件会注入 iOS PWA 相关元信息，并生成 PNG 图标。

在 Safari 中打开后，可以通过：

分享 → 添加到主屏幕

把 Harness Web GUI 添加到 iPhone / iPad 主屏幕，之后从主屏幕图标进入。

移动端 CSS 适配¶

插件会注入移动端 CSS，主要处理：

• iOS 输入框聚焦缩放；
• touch-action 相关触屏行为；
• iPhone / iPad 安全区；
• 软键盘弹出时的输入区域表现。

/mobile 扫码页¶

桌面浏览器可以打开：

http://127.0.0.1:3080/mobile

页面会显示大二维码，用于从桌面端获取手机端访问入口。

可选 IP 限制¶

插件支持可选 allow 配置，用于限制可访问的客户端 IP。

安全上下文 UUID 补丁¶

插件提供 harness 安全上下文 UUID 补丁，用于修复手机端 randomUUID 不可用问题。

如果后续升级 harness，需要重新应用已备份的补丁。

安装与启用¶

先使用官方插件命令安装：

dsh plugin --profile web add https://github.com/cindyguyuehu123/dsh-mobile.git

该命令会安装到 web profile。

如果需要在 cordis.patch.yml 中启用移动端能力，可以使用 mobile 行配置 lanPort 或 allow。例如：

- insert:
    - id: mobile
      name: 'dsh-mobile'
      config:
        lanPort: 3080
        allow: []

这里的 config 用于配置代理端口和允许访问的客户端 IP。具体 IP 应填写你信任网络内的设备地址。

修改插件加载相关配置后，需要重启 dsh web。

典型用法¶

先在桌面端和手机端完成连接：

1、让手机或 iPad 连接与 Harness 相同的 Wi-Fi。

2、在桌面浏览器打开：

http://127.0.0.1:3080/mobile

3、查看页面上的大二维码，或在手机端访问对应的局域网地址。

4、在 Safari 中打开后，通过：

分享 → 添加到主屏幕

把 Harness Web GUI 加入主屏幕。

之后从 iPhone / iPad 主屏幕进入，即可访问同一局域网内的 Harness Web GUI。

适用场景与注意¶

这个插件适合在自己的受控网络内使用，例如家庭 Wi-Fi 或自己管理的内网。

启用后，同一局域网内的设备可以完全驱动 Harness，包括可执行代码的工具。因此它只建议在自己信任的网络中开启。

如果你连接到公共网络或陌生 Wi-Fi，建议先移除或注释 cordis.patch.yml 中的 mobile 行，再重启 dsh web：

# - insert:
#     - id: mobile
#       name: 'dsh-mobile'

插件会随当前 dsh 进程运行，安装前建议先查看仓库源码与 MIT 许可证。

它只能在同一局域网内访问，或者在你自行打通的路由内访问。如果手机走蜂窝网络，无法直连运行 Harness 的电脑。

macOS 首次监听 0.0.0.0 时，系统防火墙可能会询问是否允许 Node.js 接受传入连接。如果你确认只在本机可控网络使用，可以选择允许。

如果你修改了插件的 host 半，需要重启 dsh web。如果升级了 harness，需要重新应用已备份的补丁。

链接¶

• 目录页：https://www.skillhub.cn/plugins/cindyguyuehu123/dsh-mobile
• GitHub：https://github.com/cindyguyuehu123/dsh-mobile