前言¶
DeepSeek Harness（DSH）的 Web 端通常在桌面浏览器里完成登录与配置。若要在手机上打开同一套已部署的 DSH 实例，常见做法是复制链接、手动输入地址，或依赖各环境自建的跳转方式，步骤多且容易配错对外可达的 HTTPS 地址。
下面介绍社区插件 dsh-qr-phone-login（维护者 yoggu，分类 admin-security）：在 DSH Web 中增加 Plugins → QR phone login 页面，已登录用户可展示二维码，手机扫码后通过 DSH 的 launch-token 机制在同一安装实例上完成登录。插件不负责 HTTPS、DNS、Tailscale 或反向代理，只在你已能对外提供 HTTPS 的前提下，把「手机如何连到这台 DSH」做成可复现的流程。
这是什么¶
dsh-qr-phone-login 面向已在 DSH Web 中登录的用户：在管理界面生成二维码，二维码指向你配置的 public HTTPS origin，手机扫码即可打开同一 DSH 并完成登录。README 中的定位是：在 Harness 已配置的公网 HTTPS origin 上，实现 QR-code phone login。
插件以 MIT 许可发布，当前资料中的版本为 v0.1.4；界面文案、说明与 Host 状态/错误信息为英文，无插件级语言切换。
核心功能¶
经 README 核实，插件目前提供的能力包括：
- Web 管理页：在 DSH Web 的 Plugins 菜单下增加 QR phone login 入口。
- 二维码展示：已登录用户可在该页显示 QR 码，编码内容依赖 DSH 的 launch-token 机制，用于在手机端打开同一安装并完成登录。
- publicOrigin 配置：在插件页设置
publicOrigin，值为手机实际访问的 HTTPS 源（例如https://dsh.example.com），不含路径或查询参数。 - 安全边界说明：生成 QR 的 SVG 路由受 DSH 现有浏览器认证与 Origin 校验保护；launch token 不会写入插件配置，但 token 在进程内可复用直至 DSH 进程重启。
安装与启用¶
安装前请确认运行环境与 package.json 中的要求一致：Node >= 22.19.0，DSH 引擎 ^0.1.5-rc.2 || ^0.2.0-rc.1；实际使用的 profile 若不是 web，安装与卸载命令中的 --profile web 应改为你正在运行的 profile。
官方推荐从 GitHub 带标签的 release 安装：
dsh plugin --profile web add 'https://github.com/yoggu/dsh-qr-phone-login.git#v0.1.4'
若使用本地源码目录链接（需保持 checkout 存在），README 给出的流程为：检出 v0.1.4、pnpm install 后执行 dsh plugin --profile web add "link:$(pwd)"（路径以你本机为准）。
安装后如有需要，重启 DSH Web 并刷新页面。卸载命令：
dsh plugin --profile web remove dsh-qr-phone-login
典型用法¶
- 完成插件安装，确保手机能通过 HTTPS 访问你的 DSH 对外地址（插件不代为配置证书或代理）。
- 在桌面浏览器登录 DSH Web，进入 Plugins → QR phone login。
- 将 publicOrigin 设为手机浏览器实际使用的 origin，例如
https://dsh.example.com。 - 在私密环境下展示二维码，用手机扫码打开并完成登录。
README 强调：手机必须能访问你所配置的 origin；若 origin 与真实对外服务不一致，扫码后无法连到预期实例。
适用场景与注意¶
适合：你已部署可信任的 DSH Web，且具备稳定的公网或内网 HTTPS 入口；需要在个人或团队可控环境中，快速把已登录桌面会话「延伸」到手机，而不反复手工拼 URL。
安全（务必阅读 README）：
- 任何看到或拍到二维码的人，都可能以相同权限登录；勿分享截图、日志或 SVG 响应。
- QR 中的 token 在 DSH 进程重启前可重复使用；若泄露，应重启 DSH 以轮换 token，并按 DSH 能力单独撤销仍有效的登录会话（默认 cookie 有效期可达 30 天）。
- 插件以当前 DSH 进程权限运行；安装前请自行审阅源码与 MIT 许可证，仅用于你信任的安装与用户。
DSH 生态强调「一切皆插件」；社区目录站点 SkillHub 与 DeepSeek / 幻方无官方从属关系，本文所述安装与行为均以插件仓库 README 为准。
链接¶
- 目录页：https://www.skillhub.cn/plugins/yoggu/dsh-qr-phone-login
- GitHub：https://github.com/yoggu/dsh-qr-phone-login
经过上面的步骤，你可以在已有 HTTPS 入口的前提下，用一张受控展示的二维码，把手机登录到与桌面相同的 DSH 实例；使用前请把 publicOrigin 配对真实对外地址，并遵守 README 中的安全提示。
