Plugin directory / UI & Skins / dsh-remote-qr-button
dsh-remote-qr-button
Verified · install-tested on dsh huaxiren6
What it does
Floating phone-pairing QR button for the DSH WebUI. Companion UI for dsh-remote-link.
Works — verified, early-stage project
Floating phone-pairing QR button for the DSH WebUI. Companion UI for dsh-remote-link. It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
📱 DSH-QrPairing
DeepSeek Harness WebUI 手机配对二维码悬浮按钮
在 DSH WebUI 右下角添加一个悬浮按钮，点击即可在应用内打开手机配对二维码，无需另开浏览器标签页。
简介
本插件是 dsh-remote-link 的配套 UI：配对页（/qr）由 remote-link 网关提供，本插件只负责把入口放进桌面端 WebUI。
- 仅当从
127.0.0.1/localhost访问时显示按钮 - 点击弹出应用内浮层，展示配对二维码
- 未安装 dsh-remote-link 时显示「未检测到网关」提示，而不是死链
安装
先装 dsh-remote-link，再装本插件。
dsh plugin --profile web add github:BotonJ/dsh-remote-link
dsh plugin --profile web add dsh-remote-qr-button
工作原理
- Host 端（
lib/index.js）：注册两个同源路由——配置探针GET /dsh-remote-qr-button/config（实时读取remoteLinkGateway服务的端口、短码与 TTL，无硬编码端口）和 PNG 代理GET /dsh-remote-qr-button/qr.png（从网关取实时配对图）。 - Client 端（
lib/client.js）：点击时请求探针，以同源<img>渲染二维码，同时显示 6 位短码与倒计时（每 5 秒轮询）。
二维码用 <img> 而非 <iframe>：Electron 桌面窗口会拦截跨源子框架导航，iframe 指向 http://127.0.0.1:<port>/qr 会渲染为空白。同源代理让浮层在浏览器和桌面端都能正常工作。
按钮 id（dsh-remote-qr-button）与 dsh-remote-link 代理注入的一致，两者互斥：先挂载者生效，另一个跳过。本插件覆盖直接访问 127.0.0.1:3080 的 WebUI 页面。
目录结构
dsh-remote-qr-button/
lib/index.js # host 端：配置探针路由
lib/client.js # client 端：悬浮按钮 + 浮层
cordis.patch.yml # bundle 补丁，插入插件条目
License
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install dsh-remote-qr-button for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:huaxiren6/dsh-remote-qr-buttonHeadless (CLI) profile:
dsh plugin --profile headless add github:huaxiren6/dsh-remote-qr-buttonTest report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/dsh-remote-qr-button/)<a href="https://dshbase.com/plugins/dsh-remote-qr-button/"><img src="https://dshbase.com/badges/dsh-remote-qr-button.svg" alt="dshbase install-tested"></a>