dsh-phone-remote：用手機控制 DSH 桌面版裏的 Agent

前言¶

DSH 桌面版自帶的控制台默認只監聽本機地址，手機無法直接訪問。dsh-phone-remote 插件在電腦上啓動一個僅服務手機訪問的小網頁，讓你通過手機控制正在運行的 Agent，並將輸出實時推回手機，隨時能叫停。

核心功能¶

根據已覈實的事實，該插件主要解決以下需求：
* 會話管理：看會話列表，選會話繼續聊，新建會話（可指定工作目錄）。
* 指令執行：發指令，Agent 真的在電腦上執行。
* 文件交互：傳文件給 Agent，把產出下回手機。
* 實時反饋：實時看輸出，隨時叫停。

安裝¶

安裝該插件需要 DSH 桌面版環境。安裝完成後，必須重啓 DSH 桌面版才能生效。

安裝命令¶

使用官方提供的命令行工具安裝：

dsh plugin --profile desktop add github:wlxyxykj/dsh-phone-remote

驗證安裝¶

重啓 DSH 桌面版後，在「設置 → 插件」中應能看到 dsh-phone-remote 處於啓用狀態。同時，電腦上會自動啓動一個本地控制台。

使用方法¶

第 1 步：打開控制台¶

在電腦瀏覽器中打開控制台地址：

http://127.0.0.1:8790/

該頁面只允許本機訪問，用於展示二維碼和訪問口令。

第 2 步：手機掃碼連接¶

手機連接與電腦相同的 Wi-Fi，使用相機掃描控制台上的二維碼，即可直接進入手機頁面。鏈接中已包含訪問口令，無需手動輸入。

第 3 步：指揮 Agent¶

在手機頁面底部輸入指令，點擊發送。Agent 在電腦上執行，輸出實時推送到手機。運行中的按鈕會變成 ■，點擊可停止當前回合。

第 4 步：文件傳輸¶

• 傳文件給 Agent：在手機頁面底部點擊 📎 上傳文件（單個最大 25MB），文件會寫入當前會話工作目錄下的 .phone-uploads/ 文件夾。
• 把產出下回手機：Agent 執行完成後，手機頁面上會出現下載卡片，點擊即可保存到手機。

配置與安全¶

基礎配置¶

• 端口：默認端口爲 8790。如果端口被佔用，插件會自動嘗試下一個端口（8791 等），具體端口以控制台/日誌顯示爲準。
• 默認策略：遠程會話的默認 approvalPolicy 爲 never，意味着發指令時會直接執行，無需額外授權確認。

安全建議¶

• 傳輸方式：目前採用明文 HTTP 傳輸。出於安全考慮，建議在需要遠程訪問時使用 Tailscale 等加密隧道工具。
• 訪問控制：插件支持 IP 白名單設置，建議在配置中限制允許訪問的 IP 段。

升級 / 卸載¶

• 升級：使用同樣的 dsh plugin add 命令即可覆蓋安裝。
• 卸載：在 DSH 設置中關閉插件，或通過命令行移除。

總結¶

dsh-phone-remote 是一個實用的小工具，解決了 DSH 桌面版在移動端訪問受限的問題。通過簡單的安裝和配置，開發者可以在手機上隨時接管電腦上的 Agent，進行指令交互和文件管理。