跳到主内容

dsh-remote-web-ui 使用指南

为 dsh web 增加扫码配对式手机远程控制与自更新能力，扫码即在手机小屏独立界面操作工作区。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

deepseek-harness-desktop

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @linxin666/dsh-remote-web-ui

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • 可靠 Windows 启动：移除 PowerShell 5.1 -WindowStyle Hidden 与 Electron Node 模式的冲突，隐藏窗口仍由 spawn 的 windowsHide 处理；空旧补丁、状态订阅竞态和 IPC 错误不会再把启动页永久留在 8%。
  • 验证过的 Runtime 组合：内置 @deepseek-ai/dsh 0.1.0-rc.7、dshmarket 1.15.0、Web UI 聚合 0.2.3、兼容 rc.7 的 Codex Connect 与 dsh-live-stats 0.1.20，Stable 继续精确锁定而非追随 latest。
  • 托盘与后台自动化需显式选择：默认关闭仍会退出。选择“最小化到托盘并启用后台自动化”后，关闭主窗口才保留 Runtime 和到期任务；显式退出、更新、安全模式和崩溃路径一律完整停止。
  • Host 持久任务调度：Task Board 保存时区、cron 槽位、租约、misfire/running 策略和确定性运行键；启用后台自动化时通过真实 DSH Session 执行并回写 Task Run，Host 不可用时仍回退浏览器调度。
  • 可审计的扩展边界：扩展坞校验 dsh.compatibility 的版本、Desktop API、能力、Surface 与运行时证据，并在 profile 写入 desktop-plugins.lock.json。browser-safe SDK 不导入 Electron 或私有 DSH 模块；预览的外部打开仅传工作区根和相对路径，Host 验证后才交给系统。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后启动不正常，看不到手机图标？

提示默认 dsh web 绑定 127.0.0.1 时无法生成有效二维码；请用 dsh web --host 0.0.0.0 启动，或在插件设置里配置 publicBaseUrl / 开启 autoTunnel，否则面板会显示「此功能需要…」状态而非二维码。

关闭「局域网访问要求配对」后还会被断线吗？

不会，该开关只决定非本机 /api 请求是否必须带配对 Cookie。关闭后口令、状态、撤销、心跳这些行为都还在；只有 LAN 栅栏被绕过。

Quick Tunnel 启动后手机还是延迟几秒才收到新消息？

这是预期行为。Cloudflare Quick Tunnel 与 Tailscale Serve 默认不转发 SSE，手机端会自动回退到按短间隔轮询历史消息，SSE 恢复后立即恢复流式；要真正实时推送请用 Named Tunnel 或 TCP 端口转发。

自动更新能更新什么，不能更新什么？

面板只更新通过 npm 安装的 @linxin666/dsh-web-ui 全家桶（走 pnpm update / 失败回退 corepack pnpm / npx pnpm；Windows 走 cmd.exe 解析 .cmd shim）。若插件是 link 安装（开发模式），面板只提示当前版本并告诉你在仓库里 git pull，不会执行更新。

如何撤销已配对的手机？

在桌面面板点「停止」即可。当前令牌与所有绑定设备会话会立即被清空；下次点「刷新二维码」即可重新开始，所有还在「已连接」状态的手机会被同等撤销。

移动端聊天能否发送图片或附件？

面板提供文本输入与模型/权限选择；本插件描述未涉及图片/附件/工具调用确认等富交互，这些能力走宿主原生会话，手机端只负责文本对话与切换设置。

把电脑与手机切到 5GHz/2.4GHz 不同网段后还能用吗？

可以。地址选择器会列出机器所有非内部 IPv4 字面量（含虚拟适配器），任意可达的一段都能生成二维码；Tailscale 的 100.x 虚拟接口会自动出现在列表里。

是不是必须用 Cloudflare 隧道才能从外网访问？

不是。任何把公网地址转回本机 127.0.0.1:端口的隧道都行；只要在插件设置里填 publicBaseUrl，再在 dsh web 启动时加 --trusted-host 对应公网主机，二维码就能从公网扫码。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: >=0.1.0-rc.7
  • Node: >=22.19.0 || >=24.0.0
  • Platforms: macOS, Windows, Linux
  • Native modules: cloudflared

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则