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，进行指令交互和文件管理。