dsh-remote-cpolar — DSH 手机远程访问插件

让手机（出门在外）通过浏览器远程使用你电脑上的 DeepSeek Harness，并可远程查看/控制电脑屏幕（鼠标移动、点击、键盘输入）。内置本地代理 + 桌面配置面板 + 手机端历史加载优化。

v1.3.0 起不再依赖 cpolar：任意内网穿透工具（cpolar / frp / ngrok / natapp 等）把公网 URL 转发到本机 127.0.0.1:8090 即可使用。

一、功能特性

远程使用 Harness

手机浏览器（移动数据）远程操作电脑上的 Harness：对话、查看工作区、跑工具
内置本地代理（随 dsh web 自动启动），自动解决远程访问的权限问题
手机端自动优化：打开大历史会话只加载最近几条，向上滚动加载更多

远程屏幕（查看 + 控制）

实时查看电脑屏幕（三档画质可切换：流畅⚡绿 / 标清⚡⚡黄 / 高清⚡⚡⚡红）
鼠标控制：拖动移动、轻点点击、右键（长按或右键菜单）
放大模式：精确操控（拖动平移画面、轻点精确定位）
键盘输入：文字框输入发送（中文/英文/数字均可）+ ⏎ 回车键 + ⌫ 退格键
辅助窗口机制：窗口全部最小化后鼠标仍可移动（自动激活屏幕外的透明辅助窗口解锁）
⌂ 恢复/最小化切换：点一次恢复所有最小化窗口，再点一次最小化所有
分辨率持久化：重启后鼠标位置立即准确，无需手动纠正

桌面配置面板（电脑浏览器左下角）

填写穿透公网 URL → 生成二维码 → 手机扫码直达
远程控制开关、画面压缩开关
面板可拖动，不遮挡 Harness 界面
自动检测并显示"手机访问域名"，确认隧道已通

二、原理

手机(浏览器) → 任意穿透工具公网URL (隧道自己的认证) → 穿透隧道 → 127.0.0.1:8090
    → (插件内置代理: 改写Host/Origin伪装本机) → 127.0.0.1:3080 (dsh web)
    → /remote-* 路由 → 127.0.0.1:8092 (截屏/输入 worker)

穿透工具负责"公网可达"，插件负责"让 dsh 把远程请求当本机请求"。插件与穿透工具解耦——任何能把公网 URL 转发到 127.0.0.1:8090 的工具都适用。

三、安装（电脑端，一次性）

前提

已安装 DeepSeek Harness（dsh）并成功运行过 dsh web
已安装 Node.js

1. 安装插件（一条命令，整套齐全）

dsh plugin --profile web add dsh-remote-cpolar

dsh-remote-cpolar：远程访问（代理+面板+远程屏幕+历史优化）
dsh-browser-polyfill（自动随依赖安装）：老手机浏览器兼容（修复 AbortSignal 报错、放宽超时）

重启 dsh web 后生效。可选插件：dsh-voice-input-cn（电脑语音输入）、dsh-tool-name-zh（工具卡片中文）。

2. 准备内网穿透隧道（任意工具均可）

核心要求：公网 URL 转发到本机 127.0.0.1:8090。

以 cpolar 为例（国内速度快，推荐）

注册：https://dashboard.cpolar.com/signup
下载安装客户端：https://www.cpolar.com/download
浏览器访问 http://127.0.0.1:9200 登录，复制认证 Token，命令行执行：
```
C:\Program Files\cpolar\cpolar.exe authtoken <你的Token>
```
创建隧道：http://127.0.0.1:9200 → 「隧道」→「创建隧道」：

字段	填写
隧道类型	HTTP
本地地址	127.0.0.1:8090（关键）
Http Auth	必须填：用户名:密码（如 `dsh:你的密码`），这是唯一安全门
Host 头域	留空

创建后记下公网 URL（形如 https://xxxxx.cpolar.top）。

用 frp / ngrok / natapp 等

把公网地址的本地转发端口设为 8090 即可，其余按工具文档操作。隧道自带认证（如有）由工具负责，插件无需配置。

⚠️ 务必设置隧道认证（Http Auth 等）！ 不设 = 你的电脑对公网完全裸奔，任何人拿到 URL 就能完全控制你的电脑。

3. 启动 dsh web

dsh web

一键启动（推荐）：把下面内容存为 远程一键启动.bat（纯英文，避免乱码），以后双击即可（含 cpolar 自启）：

@echo off
for /f "tokens=5" %%a in ('netstat -ano ^| findstr ":3080" ^| findstr "LISTENING"') do (taskkill /F /PID %%a >nul 2>&1)
timeout /t 2 >nul
start "DSH Web" cmd /k "dsh web"
tasklist /FI "IMAGENAME eq cpolar.exe" | findstr /I "cpolar.exe" >nul || start "cpolar" cmd /k ""C:\Program Files\cpolar\cpolar.exe" start-all -daemon=off -dashboard=on"
echo ALL STARTED. Phone: https://你的cpolar域名
pause

4. 配置远程面板（电脑浏览器）

电脑浏览器打开 http://127.0.0.1:3080
左下角「📡 远程访问」面板（可拖动，按住标题栏移动）
填入：访问地址（你的穿透工具公网 URL）→ 保存 → 显示二维码
面板提示"穿透地址需绑定本机 127.0.0.1:8090"，确认隧道配置正确

用户名/密码无需在面板填写——隧道认证由手机浏览器访问时按穿透工具的配置输入。

四、手机使用

手机开移动数据（或任意网络）
打开你的公网 URL（或扫电脑面板的二维码）
若隧道设置了认证，浏览器会提示输入（穿透工具的账号密码）
进入界面即可使用

手机端查看/控制屏幕

点手机页面上的「🖥 看电脑屏幕」进入远程屏幕
左侧工具栏：画质切换 ⚡（三档循环）、放大 🔍、恢复/最小化 ⌂、键盘 ⌨、关闭 ✖
移动鼠标：不放大时拖动（松手后桌面鼠标到达终点）；轻点 = 点击
放大模式：拖动平移画面（内容跟随手指），轻点 = 精确定位点击
键盘：点 ⌨ 弹出输入框 → 输入文字发送（中文可用）→ ⏎ 发回车 / ⌫ 发退格
手机端不显示配置面板（配置在电脑端做）

五、安全须知（务必读）

隧道认证是唯一安全门，必须设置，用强密码
不用时在穿透工具后台暂停隧道
二维码显示在电脑屏幕上，别截图外发
免费版公网 URL 是随机的：隧道重连后可能变化，变化后更新面板地址和一键启动脚本里的网址

六、常见问题

问题	解决
手机打不开网址	确认隧道在运行；确认隧道转发端口是 8090；确认面板地址是最新公网 URL
面板显示"等待手机访问…"	手机访问一次后自动显示实际域名，确认隧道已通
远程屏幕黑屏/不更新	检查画质档位（流畅更稳定）；网络慢时用流畅模式
鼠标位置不准	重启后首次已自动纠正；确认手机页面是最新版（清除浏览器缓存）
最小化窗口后鼠标不动	已内置辅助窗口自动解锁；若仍异常请重启 dsh
中文输入乱码	文字走剪贴板发送，若异常检查手机输入法是否输出正确字符
免费版 URL 变了	重新获取公网 URL 更新面板和启动脚本

dsh-remote-cpolar

Cài đặt

Mã nguồn

Thẻ

Readme