前言¶
在 DSH Web 环境中配置远程访问配对通常需要手动操作。为了减少这一步骤，dsh-pair-quick 插件在设置页增加了一个「快速配对」入口，提供一键生成配对链接和二维码的能力。
插件简介¶
dsh-pair-quick 是由 dsh-publish 维护的客户端插件。它通过在 DSH Web 的设置界面中新增页面，实现远程访问配对链接的一键铸造与二维码展示。该插件仅提供界面和令牌生成功能，不涉及凭据的持久化存储。
核心功能¶
该插件包含以下功能：
* 新增设置页：在设置页增加「快速配对」页面。
* 一键铸造：点击按钮即可生成远程访问配对链接。
* 二维码展示：实时显示配对二维码，方便移动端扫描。
* 一次性令牌：生成的链接为一次性令牌，有效期约 10 分钟。
安装与启用¶
使用官方安装命令将插件添加到 Web 配置文件中：
dsh plugin --profile web add dsh-pair-quick
安装完成后，重启 dsh web 进程。在浏览器中打开设置页面，进入「快速配对」标签，点击「获取配对链接」，使用手机扫描生成的二维码即可完成配对。
注意事项¶
- 依赖检查：该插件依赖
remote-web-ui的/api/pair/issue接口。使用前需确保remote-web-ui已安装并正确配置了隧道/LAN 访问。 - 安全限制：配对链接的铸造端点仅允许回环地址（
127.0.0.1/::1）访问。来自局域网的请求会被拒绝并返回 403 错误。 - 有效期与隐私：配对链接是一次性令牌，有效时间约 10 分钟。插件不会在此处持久化任何凭据，符合最小权限原则。
结尾¶
dsh-pair-quick 简化了 DSH Web 端的配对流程，适合需要频繁进行远程访问配对的场景。
