dsh-mobile

为 DSH 提供经设备配对的局域网 HTTPS 网关、可选远程通道（Tailscale Funnel、cpolar、cloudflared、自建 FRP、自有反向代理）、手机专用布局和 Android App，让可信手机访问电脑上的同一工作区与会话。

• DSH 版本组合（必需）：本页固定使用 DSH 0.2.0-rc.2 和 dsh-mobile 0.5.3。插件 peer 为 *，元数据不会拦截任何 DSH 版本，但作者只列出 0.1.7-alpha.2 至 0.2.0-rc.2 经过检查。52DSH 未在 rc.2 上运行验证。
• Node.js 与独立 web Profile（必需）：Node.js 需满足 ^22.19.0 或 >=24。在独立的 web Profile 和可丢弃的测试工作区中安装，不要直接连接生产目录。
• 可信局域网（必需）：只在家庭、办公室或自己的热点等可信网络中开启局域网访问。不要在路由器上做端口转发；Windows 防火墙规则对公用网络配置文件同样生效，在公共 Wi-Fi 下应关闭局域网访问。
• Android App 或手机浏览器（可选）：原生 App 仅支持 Android 10 及以上，请从作者 GitHub Release v0.5.3 下载，并核对随附的 SHA-256 文件。不安装 App 时，可在手机浏览器中打开配对链接；局域网私有证书首次访问会出现警告。不提供 iOS App。
• 远程通道账号或服务器（可选）：只有需要远程访问时才准备：Tailscale 账号、cpolar Authtoken、Cloudflare 账号与域名、自有 VPS 与 SSH 密钥，或已有的 HTTPS 反向代理，任选其一。远程访问默认关闭，不使用时不要开启。

本页命令固定使用 DSH 0.2.0-rc.2，与 npm 默认版本分别维护。切换 DSH 前核对本插件的兼容记录；新版 Session API 与格式变化见0.1.3-alpha.1 升级说明。源码审阅不等于运行验证。

下面的命令使用本站核验的 DSH 基线，并锁定插件版本或 Git commit，避免默认分支变化导致安装内容漂移。本站已核对安装目标，但尚未在你的系统和 Profile 中实际执行。

安装到

web Profile

DSH 基线

0.2.0-rc.2

安装来源

npm 预构建包（锁定版本）

固定目标

[email protected]

0.5.3 声明的 DSH 版本范围包含 0.2.0-rc.2，本页固定 DSH 0.2.0-rc.2。仅静态复核，未在本站运行验证。

• DSH 版本组合来源 1 ↗（外部链接，在新标签页打开）
• DSH 版本组合来源 2 ↗（外部链接，在新标签页打开）

1. 01
   检查 Node.js 与 pnpm

   DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上，并且 pnpm 必须已在 PATH 中。先运行：

   环境检查复制命令

   node --version && pnpm --version

2. 02
   安装到 Web Profile

   这条命令会把插件加入 web Profile，并在插件声明 DSH Bundle 时自动加入配置层。

   npm 预构建包（锁定版本）复制命令

   npx --yes @deepseek-ai/[email protected] plugin --profile web add [email protected]

3. 03
   确认 Bundle 已进入配置

   安装成功后先导出组合配置，不启动 Agent。输出中应能找到包名 dsh-mobile或对应 Bundle 层。

   检查配置复制命令

   npx --yes @deepseek-ai/[email protected] --profile web --dump-config

4. 04
   启动并完成最小验证

   启动 Web Profile 后，只测试一个与插件功能直接相关的最小任务，并检查日志、文件、网络和凭据访问是否符合预期。

   启动 DSH Web复制命令

   npx --yes @deepseek-ai/[email protected] web

npx --yes @deepseek-ai/[email protected] plugin --profile web remove dsh-mobile

$DSH_HOME/mobile-access/setup.json 与 tls/

setup 写入的网卡、Mobile HTTPS 端口（默认 3443）、DSH 上游端口，以及私有 CA、服务器证书和私钥，文件权限设为私有。

$DSH_HOME/mobile-access/control.json 与 devices.json

局域网访问的开关状态，以及已配对设备记录（只保存令牌的 SHA-256 摘要）；电脑端撤销设备时会删除对应记录。

$DSH_HOME/mobile-access/mobile.css、mobile.js、extensions/

/mobile 定制写入的位置。mobile.js 以配对页面的同源权限运行；extensions/<id>/host.mjs 会被自动加载，并以桌面用户权限运行。

$DSH_HOME/mobile-access/remote/

远程通道的状态：Tailscale 登录状态，以及 cpolar Authtoken、cloudflared 命名隧道令牌、FRP 共享 Token 等私有文件，还有按需下载的组件。

Profile 中 id 为 mobile-access 的 Loader 行 config

高级选项：excludedClientModules（精简手机启动包）、deviceTtlMs、sessionTtlMs、pairingTtlMs、maxDevices、maxBodyBytes（默认 160 MiB）。默认值即可使用。

npx --yes @deepseek-ai/[email protected] plugin --profile web add [email protected]
npx --yes @deepseek-ai/[email protected] plugin --profile web exec dsh-mobile setup
npx --yes @deepseek-ai/[email protected] --profile web --dump-config

npx --yes @deepseek-ai/[email protected] plugin --profile web exec dsh-mobile setup --address 192.168.x.x --port 3443

- id: directory-picker
  name: '@deepseek-ai/dsh-host-directory-picker-auto'
  disabled: true
- insert:
    - id: mobile-access
      name: dsh-mobile
      inject: [webServer, connection]
      config:
        initiallyEnabled: false
        listenHost: 127.0.0.1
        listenPort: 3443
        allowedCidrs: [127.0.0.0/8]
        tls:
          mode: disabled
    - id: dsh-ui-fixes
      name: dsh-mobile-question-fixes

excludedClientModules:
  - '@deepseek-ai/dsh-client-ui-sidebar-documentpreview'
  - '@deepseek-ai/dsh-client-ui-open-in-app'

1. 安装后重启 DSH。在左下角打开“移动访问 → 局域网”，确认面板显示的网卡和地址属于当前可信网络。插件市场安装或首次未运行 setup 时，也可以在面板里选择网卡、生成私有证书，然后重启一次 DSH。
2. 只在需要配对时点击“生成并复制密钥”，配对窗口默认 2 分钟、只能使用一次。配对完成后在设备列表中核对新设备名称，确认没有陌生设备。
3. 远程访问保持关闭。确实需要时只选择一种通道；cpolar、cloudflared、frpc 都会在确认后才下载。使用自有反向代理时，3444 后端只能留在可信私网，不要把 /api/mobile-access 管理路径转发到公网。
4. 第三方 WebSocket 路径只放行确认过的精确路径，不要使用“全部允许”。需要 HTTP iframe 的社区页面不要处理敏感内容。
5. 面板标题右侧的“更新插件”会把版本改为 npm 最新版，绕开 52DSH 审阅的 0.5.3。需要保持固定版本时不要点击；需要升级时先查看新版审阅记录。

1. 01
   确认 Profile 中有一条启用的 mobile-access（dsh-mobile）行和 dsh-ui-fixes 行，并且没有重复挂载。

   复制验证命令复制命令

   npx --yes @deepseek-ai/[email protected] --profile web --dump-config

   期望结果：出现 name 为 dsh-mobile 和 dsh-mobile-question-fixes 的 Loader 行，启动日志中没有插件预检或加载错误。

2. 02
   在同一局域网的手机上打开 App 或配对链接，用面板当前生成的密钥完成配对，然后打开一个可丢弃的测试会话。

   期望结果：手机能看到与电脑相同的工作区和会话列表；电脑端设备列表出现这台手机。

3. 03
   在电脑端撤销这台测试手机，再用手机刷新页面。

   期望结果：手机的在线会话断开，或提示配对已过期/电脑端已移除，需要重新配对才能进入。

4. 04
   关闭局域网访问后，用另一台未配对设备访问 https://<电脑局域网地址>:3443/。

   期望结果：连接被拒绝或只看到登录/配对页；未配对设备无法进入 DSH 会话。

• 在手机上打开可丢弃的测试工作区，只让 Agent 列出文件并解释项目结构，不批准写入或命令执行。
• 在 DSH 对话中输入 /mobile 并提出一个纯样式需求（例如调整强调色），确认只修改 mobile.css，手机端自动刷新。

局域网访问启用后，在所选网卡地址监听 HTTPS（默认 3443），来源限定为该网段；Windows 上会经 UAC 添加 LocalSubnet 入站规则（Profile 为 Any）。远程通道会把网关发布到公网。配对设备可以操作电脑上的 DSH，包括发送任务、批准工具和上传附件，还能浏览本机任意目录并读取 20 MiB 以内的图片。extensions 下的 host.mjs 以桌面用户权限运行，mobile.js 拥有配对页面的同源权限。

数据存储：电脑端：$DSH_HOME/mobile-access/ 保存 setup.json、control.json、devices.json（设备令牌摘要）、私有 CA 与证书私钥、mobile.css/mobile.js、extensions/，以及 remote/ 下的 Tailscale 登录状态、cpolar/cloudflared/FRP 令牌和下载的组件。会话在内存中保存，DSH 重启后失效。手机端：Android App 把设备令牌和私有 CA 加密存放在 Keystore；浏览器使用 HttpOnly 会话 Cookie 与 CSRF Cookie。远程通道服务商和 VPS 上的状态不在本机。

请注意：“源码已审阅”说明本站检查到的证据范围，不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

从 0.1.0-alpha.36 升级后手机无法连接

alpha 线与 0.5.x 之间跨越了 App 签名更换和多处协议变化，旧版 App 需要卸载后重新安装。应预期要重新运行 setup 并重新配对；不要为此关闭认证或开放端口。

手机提示输入另一插件的配对码

dsh-remote-web-ui 等其他远程插件使用独立授权。先在电脑端临时关闭另一插件的远程访问并刷新，再扫描 DSH Mobile 当前的二维码，不要交叉输入密钥。

切换网络后局域网访问不可用

日志提示 saved LAN interface is not connected 时，说明保存的网卡当前未连接，等它恢复或重新运行 setup 即可；DSH 本身会继续运行。

社区插件在手机端连接失败

打开连接诊断 → 第三方 WebSocket 路径，只放行这个插件实际被拦截的精确路径；放行不会绕过设备配对。

设置无法保存或报 profile reload requires the root Include entry

作者在 issue #132 中归因于全局 CLI 与 Profile 各自加载了一份 dsh-app-boot，不是 Mobile 本身的问题。核对实际运行的 DSH 命令和 Profile 版本，保持 Host/Origin 信任检查开启。