dshmobile-plugin

by zdx8637-gitdog

0 开发与运行时github收录于 08-21

通过自建中继从手机访问 DSH(WSS 由你自己的 TLS 终止代理提供):含桥接守护与扫码登录的 bundle 插件、原生 Android 应用,并支持服务端设备吊销。

Phone access to DSH over a self-hosted relay (WSS via your own TLS-terminating proxy): bundle plugin with bridge supervisor and QR login, a native Android app, and server-side device revocation.

安装

dsh plugin --profile web add github:zdx8637-gitdog/dshmobile#path:/plugins/dshmobile-plugin

GitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试

安装与环境配置指引、插件开发教程见 DSH 中文社区文档 ↗

安装即在你的机器上以你的权限运行第三方代码——它可读写文件、使用凭据、访问网络,DSH 的工具审批不会为插件代码加沙箱。「检测到 manifest」仅代表发现 dsh.bundle / dsh.plugin 清单,不构成兼容性或安全审查;安装前请审阅源码,不熟悉的插件先在不含密钥的环境试用。

预览截图

dshmobile-plugin 截图dshmobile-plugin 截图dshmobile-plugin 截图dshmobile-plugin 截图

README

目录

开箱即用的手机远程桥接:一条命令安装,无需任何网络配置、无需本地补丁, 重启 dsh 后左侧栏即出现常驻二维码面板(跨平台,DSH 升级免疫)。

  • 常驻二维码(Web 左侧栏底部箭头弹窗):与登录态无关,永远可扫—— · 电脑已登录 → 手机(哪怕未登录)扫码直接登录同账号; · 电脑未登录 → 手机(已登录)扫码授权,电脑自动登录;
  • bridge 子进程守护:账号密码模式或手机授权 token 模式(无密码直连,401 自动刷新);
  • 手机端一码三用:微信扫=下载 App、相机扫=跳 App 配对、App 内扫=直接登录/授权。

安装

npx -y @deepseek-ai/dsh plugin --profile web add @zdx8637/dshmobile-bridge@latest
# 重启 dsh 后,Web 左侧栏底部出现 ▶ 箭头,点开即配置面板

前置:本机需要 pnpm(dsh plugin 子命令依赖它;corepack enable 或 npm i -g pnpm)。

手机 App:扫描面板二维码 → 落地页下载 APK(或从 发布页获取)。

免补丁:面板走本地通道

DSH 0.1.0-rc.6 默认不向浏览器暴露第三方 settings 命名空间(上游标注为 deferred work)。本插件不依赖该通道:面板与宿主通过 127.0.0.1:17653 的本地 HTTP 通信(轮询状态 + 下发动作,CORS 仅放行本机来源),因此

  • 一条命令安装即用,无需任何本地补丁;
  • Windows/macOS/Linux 通用;
  • DSH 升级不受影响(历史版本 0.1.0-beta.3 及更早需要 scripts/expose-settings-namespace.ps1 补丁,已废弃)。

relay 说明

插件默认连接 https://www.deepseek-claudex.cn(作者自营 relay:账号注册、 设备管理、消息路由均走该服务器)。也可自建:见主仓库 dshmobile 的 relay/ 目录与 dsh-remote/docs/04-operations.md,然后在面板里把 relay 地址改成你自己的。

开发

npm install
node scripts/build.mjs                  # 产出 lib/index.js + lib/client.js
node scripts/smoke-host.mjs <u> <p>     # 账号密码模式冒烟
node scripts/smoke-grant.mjs <u> <p>    # 手机授权模式冒烟

完整三端(手机 App / relay / 协议)见主仓库 zdx8637-gitdog/dshmobile。

License

MIT

原始 README: https://github.com/zdx8637-gitdog/dshmobile/blob/main/plugins/dshmobile-plugin/README.md ↗