前言¶
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 仓库。
