前言¶

DeepSeek Harness（DSH）采用插件化架构。这个插件用于在局域网内将 Android 手机与 DSH Host 建立连接，提供远程控制或访问 Web 界面的能力。

插件定位¶

名称：w2112515/dsh-remote-host
维护者：w2112515
功能：将 Android 手机作为 DSH 客户端接入。它通过 Noise 协议进行安全连接，提供命令执行、提示词/停止词 Admission 控制，以及配对设置功能。

安装与启用¶

确保系统已安装官方 dsh 0.1.1-rc.2+ 和 Node.js。

1. 克隆仓库：

    git clone --branch v0.2.2 https://github.com/w2112515/dsh-remote-host.git
    cd dsh-remote-host

2. 配置网络绑定：

    sh scripts/setup.sh --bind YOUR_PUBLIC_IP    # 仅限局域网时，省略 --bind

3. 启动服务：

    sh scripts/start.sh
    node scripts/invite.mjs

Windows 系统可使用 PowerShell 脚本：

.\scripts\setup.ps1 --bind YOUR_PUBLIC_IP
.\scripts\start.ps1

典型用法¶

1. 生成配对凭证：在 Host 机器上运行 node scripts/invite.mjs，系统会打印一个 dsh-remote:// URI 和终端二维码。
2. 手机端配对：在 Android 手机上侧载对应的 APK (版本 0.2.0)，扫描 URI 或输入八位数字码完成配对。
3. 访问设置页面：从其他电脑访问浏览器设置页面时，需建立 SSH 隧道：

    ssh -L 3180:127.0.0.1:3180 HOST

然后访问 `http://127.0.0.1:3180` -> **Settings** -> **Mobile access**。

注意事项¶

• 安全限制：不要将 DSH Web 置于公网域名下；切勿使用 --bind 0.0.0.0。家庭机器应绑定单播 IPv4 或仅使用局域网。
• Windows 兼容性：Windows 版本没有 iroh 二进制文件，但局域网或公网 IPv4 绑定依然可用。
• 配对备份：首次启动后生成的 $DSH_HOME/remote-host-security.bin 文件必须备份。丢失该文件后，所有手机必须重新配对。
• 权限说明：该插件以当前 DSH 进程的权限运行，安装前请检查源码与许可证。

结语¶

该插件为 DSH 生态提供了手机端接入能力。更多细节与源码可参考 GitHub 仓库。