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 功能。本插件由社區維護，旨在提升本地開發與調試的便利性。