独立的 DSH 手机远程插件:在手机上连正在跑 dsh web 的那台宿主,发文字和文件。
宿主可以是 macOS / Windows / Linux 桌面,也可以是无 GUI 的云主机。不修改 @linxin666/dsh-web-all。
dsh plugin --profile web add github:JackAIStudio/dsh-mobile-plus装完后重启 dsh web,侧栏底部「设置」右侧才会出现手机远程图标。不要去杀正在跑的宿主进程;告诉正在用它的人,让他们自己重启。
配对页只允许 本机 loopback 打开(pair/issue 同样)。这是安全边界,不是「只能在个人电脑上用」。
- 桌面:点侧栏手机远程图标,或在这台宿主的浏览器打开
http://127.0.0.1:<dsh端口>/mp/setup。 - 云主机:先 SSH 把
dsh web端口打回你笔记本的127.0.0.1,再打开上面的配对页。 - 扫码或打开链接。一次性令牌(二维码 / 配对链接)2 小时内有效;任一端配对成功后另一条链接立刻失效。
- 配对成功后,设备 cookie
mp_device有效期 1 年(每次打开/mp/会续期)。设备在服务端 7 天无访问 才会被忘掉。 - 进入工作区 → 会话 → 聊天。回形针可传相册或文件(单文件 20MB,一次最多 5 个),文件落到该工作区的
.dsh-mobile-inbox/,会话里只带宿主上的真实路径。
未配置公网地址时,二维码只指向本机 127.0.0.1。手机要从公网连上,必须自己配 publicBaseUrl。
插件不内置任何中转。把你自己的域名、反代或云主机地址写进宿主配置:
- id: dsh-mobile-plus
config:
publicBaseUrl: https://dsh.example.com常见两种宿主:
| 宿主 | 配对页怎么开 | publicBaseUrl |
|---|---|---|
| 桌面 Mac / Windows | 本机浏览器直接开 loopback | 可选。要给 4G 手机用时,填你自己的反代 / 隧道 |
| 云主机 Linux | SSH 把端口打回 127.0.0.1 再开 | 填这台云自己的 HTTPS 域名。云上的 DSH 就是宿主,不必再套别人的中转 |
改配置或插件代码后需要重启 dsh web。
到手机浏览器里打开 /mp/ 也能用。但安卓上不建议「添加到桌面」成独立窗口:小米浏览器把这种独立窗口开在 PWAActivity 里,那个外壳没有实现 WebView 的 onShowFileChooser,回形针点了没反应,拍照也拿不到摄像头。详见下一节。
小米浏览器把网页「装成 App」后跑在独立窗口里,那个窗口不是普通标签页:
| 同一页面 | 附件按钮 | 摄像头 |
|---|---|---|
| 普通浏览器标签页 | 正常弹选择器 | 可用 |
| 桌面图标独立窗口 | 点了没反应 | NotAllowedError |
原因是 Android 要求宿主 App 实现 WebView 的两个钩子,而小米浏览器的独立窗口两个都没实现:
onShowFileChooser—— 没有它,<input type="file">点下去只触发 click,系统选择器永远不出现;onPermissionRequest—— 没有它,getUserMedia直接拒绝。
这不是页面代码的问题:在独立窗口里,连一个页面上可见的原生 <input type="file"> 用手直接点也毫无反应。Chrome/Edge 的 PWA 没这个毛病,是小米这个外壳的缺陷。
android/ 下是本插件自带的壳,只做一件事:实现上面两个钩子。回形针会给出 拍照 / 相册 / 文件 三个来源,跟手机上别处一致。
它不打包前端——页面照样从宿主加载,所以改 public/ 后刷新前端页面即生效(设置 → 刷新前端页面;debug 包可用 chrome://inspect)。
cd android
./gradlew :app:assembleDebug # 默认指向 https://dev.mac.followjack.cn/mp/
# 或指定你自己的地址
./gradlew :app:assembleDebug -PdshUrl=https://dsh.example.com/mp/
adb install -r app/build/outputs/apk/debug/app-debug.apk装完就不必再用浏览器的桌面图标了。下拉是「看更早的消息」,刷新在设置里;要换宿主地址:
adb shell am start -n com.jackai.dshmobile/.MainActivity -e url https://your-host/mp/小米的 USB 安装 若拦着 adb install,在 设置 → 更多设置 → 开发者选项 里打开,并留意弹出的「USB 安装提示」。
配对成功的手机接近这台宿主上的 DSH:列目录、建工作区、读写会话、跑斜杠命令、上传文件、看账户额度。把它当成第二块屏幕,而不是「只能发一句聊天」。
setup/pair/issue/pair/stop/pair/revoke仅 loopback。- 设备 cookie 和界面上的设备 id 分开;未配对的公网请求拿不到设备列表。
- 公网请走 HTTPS。不要把未加固的
dsh web端口直接暴露到互联网。 - 额度接口只在宿主 loopback 上读 DeepSeek / Grok / Gemini 插件,密钥不进手机。
Apache License 2.0。二维码编码来自 Nayuki qrcodegen(MIT),见 NOTICE。