dsh-remote-desktop

dsh-remote-desktop 安装使用手册

DSH 手机远程访问 + 远程桌面插件 让手机（出门在外）通过浏览器远程使用电脑上的 DeepSeek Harness，并可远程查看/控制电脑屏幕。

一、这个插件能做什么

功能	说明
📱 远程使用 Harness	手机浏览器操作电脑上的 DeepSeek Harness：对话、查看工作区、运行工具
🖥 远程屏幕	实时查看电脑屏幕画面
🖱 远程控制	拖动移动鼠标、轻点点击、右键、放大精确定位
⌨ 远程键盘	输入文字（中文/英文/数字）、发送回车、发送退格
⚡ 三档画质	流畅（最快）/ 标清 / 高清（最清晰），可随时切换
🗜 压缩开关	网络慢时开启压缩提高流畅度
📁 文件传输	手机浏览电脑目录、上传文件到电脑、下载文件到手机
📦 多选打包下载	多选文件 → 选择「打包成 zip」或「逐个单独下载」
📱 安卓 APP	内置安卓 APK，面板可扫码下载安装（WebView 包装，支持远程访问/上传/下载）
🖱 鼠标按钮	查看屏幕工具栏新增鼠标按钮：单击=左键点击，双击=左键双击（在光标当前位置）
🔒 防锁屏开关	面板一键开关：开启后电脑保持唤醒不锁屏，远程操控畅通（详见六点五节）
🔍 锁屏状态显示	面板按钮实时显示电脑锁屏状态（未锁屏/已锁屏），每 3 秒同步
📷 APK 扫码填地址	手机 App 设置界面可扫电脑面板的地址二维码，自动填入访问地址
⚙ APK 恢复能力	连接失败/404 时显示原生错误界面 + 返回设置按钮，不再卡死
🧹 历史优化	手机打开大会话只加载最近几条，向上滚动加载更多

二、准备工作

需要两台设备

• 电脑：安装 DeepSeek Harness（dsh）的 Windows 电脑（插件在电脑端安装）
• 手机：任何有浏览器的手机（安卓/苹果均可）

电脑端前提

• 已安装 DeepSeek Harness 并成功运行过 dsh web
• 已安装 Node.js ≥ 22.12（推荐 24 LTS；dsh 的 commander 15 要求 22.12+，插件随 dsh 运行故同样要求）
  • 检查版本：命令行执行 node -v（应为 v22.12.0 或更高）
• 一个内网穿透工具（免费即可，如 cpolar/frp/ngrok/natapp 等）

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

第 1 步：检查 dsh 是否已安装

打开命令行（CMD 或 PowerShell），执行：

dsh --version

• 有版本号输出 → dsh 已安装，跳过第 1 步，直接进入第 2 步安装插件（无需 npm install）

• 提示"不是内部或外部命令" → dsh 未安装，执行：

  npm install -g @deepseek-ai/dsh
  

  需要 Node.js ≥ 22.12（检查：node -v）。安装 dsh 需要管理员权限（npm 全局安装）。

第 2 步：安装插件

dsh plugin --profile web add dsh-remote-desktop

安装完成后重启 dsh web：

dsh web

插件会自动安装配套依赖 dsh-browser-polyfill（老手机浏览器兼容）。

第 3 步（可选但推荐）：安装解锁服务

插件包含一个 Windows 解锁服务（用于锁屏状态检测和防锁屏功能）。它需要手动安装一次（Windows 服务需要管理员权限，插件无法自动注册）：

C:\Users\Public\dsh-plugins\dsh-remote-desktop\lib\install-unlock-service.bat

双击 → UAC 提示「是」→ 自动：复制 exe 到 System32 → 注册服务 DSHRemoteUnlock（LocalSystem，开机自启）→ 启动。

验证：命令行执行 sc query DSHRemoteUnlock，应显示 STATE: 4 RUNNING。

⚠️ 更新插件版本后：解锁服务需要重新运行一次上面的 bat（服务 exe 需要更新到新版）。

不装解锁服务的后果：远程屏幕/控制/文件传输正常，但锁屏状态检测不可用（面板不显示锁屏状态）、防锁屏的锁屏状态显示失效。

四、配置内网穿透（关键步骤）

核心要求：让穿透工具把公网 URL 转发到本机 127.0.0.1:8090。

方式 A：使用 cpolar（推荐，国内速度快，免费）

• 注册账号：打开 https://dashboard.cpolar.com/signup 注册（邮箱+密码）

• 下载安装客户端：打开 https://www.cpolar.com/download 下载 Windows 安装包并安装

• 登录并获取 Token：

  • 浏览器打开 **http://127.0.0.1:9200**（cpolar 管理界面）
  • 用注册的账号登录
  • 左侧「验证」→ 复制认证 Token
  • 命令行执行：C:\Program Files\cpolar\cpolar.exe authtoken <你的Token>

• 创建隧道：

  • cpolar 管理界面（http://127.0.0.1:9200）→ 左侧「隧道」→「创建隧道」
  • 按下表填写：

  配置项	填写
  隧道类型	HTTP
  本地地址	127.0.0.1:8090 ⚠️必须
  Http Auth	必须填：用户名:密码（如 dsh:你的强密码）
  Host 头域	留空
  Disable keep	不开启

• 记下公网 URL：创建成功后，隧道列表会显示一个公网地址（形如 https://xxxxx.cpolar.top），记下来。

方式 B：使用 frp / ngrok / natapp 等任意工具

• 用该工具建立隧道，本地转发端口填 8090
• 其余按该工具的文档操作
• 工具的认证（如有）按工具配置

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

五、配置远程面板（电脑浏览器，一次完成）

• 电脑浏览器打开 http://127.0.0.1:3080
• 左下角找到「📡 远程访问」面板（按住标题可拖动，不挡界面）
• 在「访问地址」输入框填入你的穿透公网 URL（如 https://xxxxx.cpolar.top）
• 点「保存并显示二维码」
• 确认面板提示「穿透地址需绑定本机 127.0.0.1:8090」符合你的隧道配置

面板只填地址即可。隧道认证（用户名/密码）由手机浏览器访问时按穿透工具配置输入。

六、手机使用

6.1 远程使用 Harness

• 手机开移动数据（或任何网络）
• 打开电脑面板上的公网 URL（或扫码）
• 若隧道设置了认证，浏览器弹出登录框 → 输入穿透工具配置的用户名/密码
• 进入界面即可像本地一样使用 Harness

6.2 远程查看/控制屏幕

• 手机页面点「🖥 看电脑屏幕」进入远程屏幕

• 左侧工具栏说明：

  按钮	功能
  ⚡（绿/黄/红）	画质切换：流畅 → 标清 → 高清（循环）
  🔍	放大模式（精确操控）
  ⌂	恢复所有最小化窗口（再点一次最小化所有）
  ⌨	弹出键盘输入框
  ✖	关闭并返回

• 移动鼠标：不放大时，手指拖动 → 松手后桌面鼠标到达终点；轻点 = 左键点击

• 右键：长按（或浏览器右键菜单）

• 放大模式：拖动平移画面（内容跟随手指），轻点 = 精确定位点击

• 键盘输入：

  • 点「⌨」弹出输入框
  • 输入文字（中文/英文/数字均可）→ 点「⏎」发送文字
  • 「⏎」在输入框为空时 = 发送回车键
  • 「⌫」= 发送退格键（删除远程光标前的字符）

• 窗口最小化后鼠标仍可移动：插件内置屏幕外辅助窗口自动解锁

6.3 文件传输（📁 侧边栏按钮）

手机页面侧边栏（放大镜搜索按钮下方）有「💻 看电脑屏幕」和「📁 文件传输」两个图标按钮。

• 点「📁」打开文件浏览器：
  • 顶部导航：⬆ 返回上级 / 分区盘快捷（C: D:…）/ 🖥 桌面快捷 / ✖ 关闭
  • 目录列表：📁 文件夹（点击进入）、📄 文件（点击选中）
• 下载到手机：
  • 点选文件（可多选，选中变蓝）→ 点「⬇ 下载」
  • 单选：直接下载（保持原名）
  • 多选：弹窗选择「📦 打包成 zip 下载」或「📄 逐个单独下载」
• 上传到电脑：点「⬆ 上传」→ 选择手机文件（可多选）→ 自动上传到当前目录
• 🔄 刷新当前目录

6.4 手机端小贴士

• 手机端不显示配置面板（配置在电脑端做）
• 中文语音输入：用手机输入法的语音（点输入框 → 键盘麦克风 → 说话）
• 网络慢时用「流畅」画质

六点五、🔒 防锁屏功能（v1.6.0 新增）

是什么

一个手动开关：开启后电脑保持唤醒、不会自动锁屏，手机随时可以远程操控（不需要解锁）。 这是为解决「电脑锁屏后无法远程解锁（Windows 安全限制，详见下文）」而提供的预防方案。

为什么需要它

Windows 锁屏界面（密码/PIN 输入框）只接受真实硬件输入，拒绝所有软件注入的鼠标/键盘事件 （这是 Windows 的安全机制，TeamViewer 等工具是靠安装内核驱动才做到的）。因此：

• 电脑未锁屏时：远程操控完全正常（移动鼠标/点击/键盘/文件传输）
• 电脑已锁屏时：手机只能查看锁屏画面，无法远程输入密码解锁

→ 所以如果你要出门、又希望随时远程操控电脑，出门前打开「防锁屏」即可。

使用方法

• 电脑浏览器打开 harness 页面（http://127.0.0.1:3080）
• 左下角「📡 远程访问」面板中，找到 「🔒 防锁屏」按钮（远程控制/压缩按钮下方）
• 点击切换，按钮颜色和文字实时反映状态：

按钮显示	状态	含义
🔓 防锁屏开 · 电脑不会锁（绿色）	已开启	电脑保持唤醒、不锁屏（即使显示器关闭）
🔒 电脑已锁屏 · 需本地解锁（红色）	已锁屏	电脑当前处于锁屏状态，需到电脑前解锁
🔒 防锁屏关 · 未锁屏（灰色）	已关闭	正常锁屏行为（默认，办公室安全）

• 开启后自动执行：

• 保持系统+显示器唤醒（阻止休眠/关屏 → 不会自动锁屏）
• 关闭屏幕保护程序锁定（ScreenSaverIsSecure=0）
• 电源设置：唤醒不需要密码（CONSOLELOCK=0）

• 回到办公室后，点回「🔒 防锁屏关」恢复正常锁屏（以上设置自动还原）。

⚠️ 注意事项

• 防锁屏开启时不要手动按 Win+L（仍会锁屏，且无法远程解锁）
• 防锁屏只是「避免锁屏」，不是「远程解锁」——锁屏后远程仍无法解锁
• 锁屏状态下手机查看屏幕会显示「🔒 电脑已锁屏」+ 只读预览 + 「← 返回」按钮（回到 harness 主页）

七、安全须知（务必读）

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

八、常见问题

问题	解决办法
手机打不开网址	1. 确认隧道在运行 2. 确认转发端口是 8090 3. 确认面板地址是最新公网 URL
打开网址提示 404 / 无法访问	隧道可能已重连（免费版 URL 会变），重新获取公网 URL
用 http:// 地址访问、会话空白	建议用 https:// 地址；或在穿透工具开启"http 重定向至 https"（cpolar 后台 redirect_https），http 会自动跳转 https 后一切正常
面板显示「等待手机访问…」	手机访问一次后自动显示实际域名，确认隧道已通
远程屏幕黑屏 / 画面不动	切换画质档位；网络慢用流畅模式；确认手机页面是最新版（清缓存）
鼠标点击位置不准	重启 dsh 后已自动纠正分辨率；若仍不准，切换一次画质即可
最小化窗口后鼠标不动	已内置自动解锁；若异常请重启 dsh
中文输入乱码	文字走剪贴板发送，确认手机输入法输出正常
电脑锁屏后手机无法输入密码解锁	Windows 安全限制：锁屏只接受真实硬件输入。出门前用「🔒 防锁屏」避免锁屏（见六点五节）
查看屏幕时鼠标指针自动漂移	已修复（v1.6.0）：唤醒显示器的 1px 移动改为移动后移回，净位移为 0
手机 App 下载文件提示 Not a file URI	已修复（v1.6.0）：下载目标改为逐级兜底（MediaStore → 公开目录 → 应用专属）
卸载插件	dsh plugin --profile web remove dsh-remote-desktop