前言¶
DeepSeek Harness（DSH）採用「一切皆插件」的設計理念。在桌面端或 dsh web 界面進行日常開發、審批和文件管理時，有時需要通過手機處理事務。此插件提供了遠程訪問能力：手機掃碼後，經電腦確認，即可在手機瀏覽器中繼續電腦上的會話、處理審批、查看文件和管理設置。電腦端的桌面應用和 dsh web 界面保持不變。
核心功能¶
- 連接方式：支持「同一 Wi‑Fi」（局域網直連）和「任意網絡」（通過 Cloudflare Quick Tunnel 獲取臨時公網地址）兩種模式。
- 配對與安全：新設備掃碼後，必須在電腦上確認「允許連接」。配對二維碼有效期 5 分鐘。
- 設備管理：可查看已授權設備（顯示機型和連接方式）、重命名或撤銷單臺或全部設備。已授權設備與本機權限相同。
- 手機界面：提供獨立的移動端界面，支持淺色、深色和跟隨系統主題。支持會話管理、文件瀏覽與上傳、宿主設置、插件管理等操作。
- 會話與文件：支持新建、搜索、歸檔會話；選擇工作區、模型和 Agent；支持 Markdown、代碼、表格、圖片和附件；支持文件預覽和下載。
- 斷線提示：手機與電腦失去聯繫時，界面頂部會主動提示；恢復後自動重新讀取狀態。
- 自定義：支持自定義強調色（陶土橙、藍色、黑色）。
安裝與啓用¶
- DSH 桌面版：進入「插件 → 添加插件」，輸入
@copylee/dsh-remote-control，安裝後啓用。 - 命令行（
dsh web等其他 profile）：
dsh plugin --profile web add @copylee/dsh-remote-control@latest
- 系統要求：DSH 版本需 >= 0.2.0-rc.2，Node.js 22.19+ 或 24+。
典型用法¶
- 在 DSH 界面點擊左側欄底部的手機圖標，或打開 設置 → 遠程控制。
- 選擇連接方式（「同一 Wi‑Fi」或「任意網絡」），點擊「開啓遠程連接」。
- 用手機掃描屏幕上顯示的二維碼。
- 在電腦上確認配對請求（允許連接）。
- 手機進入遠程界面，即可進行會話管理、文件查看和設置操作。
適用場景與注意¶
- 適用場景：需要在手機上審批任務、查看不在桌面旁的文件，或在移動狀態下繼續電腦上的對話。
- 權限與安全：已授權的設備與本機權限相同，可管理設置、憑據和插件。請只批准自己信任的設備。
- 網絡與配對：
- 「同一 Wi‑Fi」使用 HTTP 協議，應只在可信網絡中使用。
- 「任意網絡」的 HTTPS 在 Cloudflare 邊緣終止，本插件不提供端到端加密。
- 配對後，「同一 Wi‑Fi」授權保存 30 天，「任意網絡」每次開啓會更換地址，需重新掃碼。
- 設備限制：最多保存 32 臺設備，最多等待 16 個配對請求。
結語¶
此插件通過獨立的移動端界面和安全的配對機制，爲 DSH 用戶提供了移動辦公的便利，同時保持了宿主環境的穩定性和一致性。詳細信息請參考 插件目錄 或 GitHub 倉庫。
