前言¶
DeepSeek Harness (DSH) 采取插件化生态策略。在桌面端操作之外，有时需要从手机端快速查看状态或进行简单控制。dsh-mobile-remote 是一个社区维护的插件，它通过在 Web 设置页面增加“远程控制”面板，实现了局域网及外网下的手机远程操控。
核心功能¶
该插件提供了一套完整的移动端远程控制解决方案：
- 连接与控制：设置页内置扫码连接二维码，支持一键开启/关闭远程控制（支持热重载，无需重启服务）。
- 设备统计：实时统计当前在线的设备数量。
- 图片上传：优化手机端体验，支持通过系统图库或文件选择器上传图片（用于 DeepSeek 的视觉模型）。
- 远程访问密码门禁：提供安全防护。本地访问和局域网访问免密，外网访问需密码。密码使用 scrypt 哈希和随机盐存储在本地（
~/.dsh/plugins/dsh-mobile-remote/config.），不依赖后端 relay。 - 遥测数据：丰富的设备数据展示，支持展开查看 OS、浏览器、屏幕、CPU、内存等详情。
- 状态检测：真实的外网隧道状态检测（通过 frpc 日志验证，非假在线状态）。
- 性能优化：优化远程加载速度，通过增加 frpc 连接池解决外网访问卡顿问题。
- 纯 CLI 支持：纯 CLI 用户无需安装桌面应用即可使用远程控制功能。
安装与启用¶
安装插件¶
使用以下命令安装插件：
dsh plugin --profile web add @feiyang666/dsh-mobile-remote
启动与配置¶
安装后，启动 DSH（桌面应用或命令行），打开 http://127.0.0.1:3080 进入设置 -> 远程控制，开启远程控制开关。
使用步骤¶
- 启动服务：确保电脑端已启动 DSH。
- 开启控制：在 Web 界面的“远程控制”页面开启开关。
- 连接设备：确保手机和电脑连接同一 Wi-Fi，使用手机浏览器扫描生成的二维码或打开局域网 URL。
- 操作与交互：在手机端即可查看桌面数据并发送消息进行控制。
纯 CLI 启动方式¶
如果仅使用命令行，可以通过 --patch 参数启用远程控制，无需安装桌面应用：
dsh --profile web --patch remote-control.patch.yml
或者在启动后，通过 Web 界面的设置页手动开启。
注意事项¶
- 密码安全：远程访问密码存储在本地，仅用于外网访问验证，不依赖后端 relay 服务。
- 依赖要求：需要安装
dsh-update-server并更新相关文件，才能显示完整的隧道统计信息。 - 通用性：插件支持任意 frp/tunneling 解决方案（包括自建 relay），密码门禁直接生效。
- 安全限制：官方 CLI 默认限制
--host 0.0.0.0以保证安全，该插件通过修改cordis.patch.yml或--patch参数实现绕过，请确保仅在受信任的网络环境下使用。
