mervyn-teo/dsh-plugin-qr-connect ↗★ 0
dsh-plugin-qr-connect
DeepSeek Harness (DSH) dynamic Cordis plugin: a small sidebar button above Settings that shows a QR code of the web UI's LAN address so phones on the same network can connect.
安装
此插件尚未提供可验证的 bundle,或兼容性检查未通过。请先阅读仓库说明。 阅读完整 README ↗
说明文档
阅读完整 README ↗dsh-plugin-qr-connect
English | 中文
一个 DeepSeek Harness(DSH)动态 Cordis 插件:在侧边栏底部「设置」按钮上方添加一个 二维码按钮。它运行一个小型、 带鉴权的反向代理,让同一网络(或公网)上的手机扫码后安全地打开 Web UI。
功能
- 添加一个全宽按钮(
sidebar.footer.action,idqr-connect),堆叠在官方 「插件」按钮上方。 - 点击后打开一个淡入淡出的面板,显示 两个 二维码:
- 本地网络 —
http://:/?auth=。 - 公网 —
http://:/?auth=(蓝色)。
- 本地网络 —
- 反向代理(一个监听
0.0.0.0:的node子进程)校验密钥,签发会话 Cookie(默认 30 天),然后转发到回环 Web UI。 - 密钥默认每 30 秒轮换一次,二维码同步刷新(可配置,
0表示关闭自动刷新)。 - 点击二维码复制对应链接;公网二维码带有信息提示(悬浮显示「公网分享」)。
- 在 设置 → 插件 中提供 QR connect 配置卡片,可设置代理端口、会话时长、 刷新间隔。
- 通过 DSH 的 locale 服务支持英文与中文界面。
文件
| 文件 | 用途 |
|---|---|
host.js | Host 半边 —— cordis_define 中 code.host 的值。 |
client.js | Client 半边 —— cordis_define 中 code.client 的值。 |
package.json | 包元数据(dsh-plugin 关键字 + dsh 清单)。 |
加载方式
这是一个 动态 Cordis 插件:运行在 DSH 会话内,进程重启后不会保留。在 DSH
Web 界面(或由代理)通过 cordis_define / cordis_run 流程加载:
- 定义新插件,
code.host=host.js的完整内容,code.client=client.js的完整内容(idPrefix用qrconn即可,最终 ID 由宿主分配)。 - 运行返回的包,并在界面中批准 Client 半边。
这两个 .js 文件是动态运行器所需的 函数体(不是独立的 Node/浏览器模块),
请原样传入,不要 import。
依赖
- DSH 需要挂载 、、、 服务。