dsh-remote-qr-button：DSH WebUI 手机配对悬浮入口

在 DeepSeek Harness (DSH) 的 WebUI 中进行手机配对时，通常需要手动访问特定端口或打开新的浏览器标签页。dsh-remote-qr-button 插件在 WebUI 右下角添加了一个悬浮入口，点击即可在应用内直接唤起配对流程，无需切换窗口。

这是什么¶

本插件是 dsh-remote-link 的配套 UI 组件。它不提供配对服务本身，而是负责在桌面端 WebUI 中提供配对二维码的展示入口。

核心功能¶

1. 悬浮入口：在 DSH WebUI 右下角添加悬浮按钮。
2. 应用内唤起：点击按钮后，在应用内弹出一个浮层，展示手机配对二维码。
3. 环境检测：仅当从 127.0.0.1 或 localhost 访问 WebUI 时显示按钮；若未安装 dsh-remote-link，会显示“未检测到网关”提示，而不是死链。

安装与启用¶

安装前请确保已安装 dsh-remote-link 插件。

dsh plugin --profile web add dsh-remote-qr-button

典型用法¶

1. 确保系统已安装并运行 dsh-remote-link。
2. 从本地地址（127.0.0.1 或 localhost）访问 DSH WebUI。
3. 点击右下角出现的悬浮按钮。
4. 在弹出的浮层中查看二维码及配对短码。

适用场景与注意¶

• Electron 兼容性：由于 Electron 桌面窗口会拦截跨源子框架导航，直接使用 <iframe> 指向本地端口会导致空白。本插件使用同源 <img> 标签渲染二维码，确保在浏览器和桌面端都能正常显示。
• 互斥逻辑：本插件与 dsh-remote-link 注入的按钮共享同一个 ID。如果在同一进程中先挂载了其中之一，另一个会跳过挂载，以避免重复渲染。
• 访问限制：该插件仅覆盖直接访问 127.0.0.1:3080 的 WebUI 页面，且仅在这些本地访问下生效。

生态背景¶

DSH 的插件化架构允许开发者扩展 WebUI 功能。本插件由社区维护，旨在提升本地开发与调试的便利性。