前言¶

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 倉庫。