dsh-remote-hub 0.4.0 → 0.4.2

package/README.md

@@ -19,16 +19,16 @@ Kotlin/Compose 直连 DSH 自带的 HTTP API + WebSocket 网关。
 
 ## 下载手机端 App
 
-**DSH Remote v4.21.0** · Android 8.0 (API 26) 及以上 · 2.8 MB
+**DSH Remote v4.21.2** · Android 8.0 (API 26) 及以上 · 2.8 MB
 
-[⬇️ 下载 APK](https://github.com/liaoguogang-hub/dsh-remote-public/releases/download/v4.21.0/DSH-Remote-v4.21.0.apk) ·
+[⬇️ 下载 APK](https://github.com/liaoguogang-hub/dsh-remote-public/releases/download/v4.21.2/DSH-Remote-v4.21.2.apk) ·
 [全部版本](https://github.com/liaoguogang-hub/dsh-remote-public/releases)
 
 安装后应用名「DSH Remote」，包名 `com.dsh.remote.ngrok`（可与作者的 `DSH` 自用版共存）。
 手机端不通过 npm 分发——npm 包 `dsh-remote-hub` 是电脑侧的 DSH 插件，两者配合使用：
 
 ```
-电脑：dsh plugin --profile desktop add dsh-remote-hub   → 起桥接 / 开隧道 / 签 Cookie
+电脑：dsh plugin --profile desktop add dsh-remote-hub@0.4.2 → 起桥接 / 开隧道 / 签 Cookie
 手机：装上面这个 APK → 填电脑给出的地址与 Cookie → 连接
 ```
 
@@ -184,8 +184,8 @@ node mint.mjs "127.0.0.1:1815" 30              # 签发 30 天 Cookie
 ```bash
 # 从 NPM 安装（推荐，会出现在 DSH 内的「插件中心」）
 # https://www.npmjs.com/package/dsh-remote-hub
-dsh plugin --profile desktop add dsh-remote-hub
-dsh plugin --profile web add dsh-remote-hub      # web profile 同样可用
+dsh plugin --profile desktop add dsh-remote-hub@0.4.2
+dsh plugin --profile web add dsh-remote-hub@0.4.2      # web profile 同样可用
 
 # 或直接从本仓库源码安装（不经过 NPM）
 dsh plugin --profile web add github:liaoguogang-hub/dsh-remote-public
@@ -222,6 +222,10 @@ dsh-remote start      # 不开 DSH 也能单独前台跑（Ctrl+C 退出）
 > 公网隧道受网络影响：`api.trycloudflare.com` 不可达时插件会跳过公网、只给局域网地址，
 > 并在 `status.json` 里写明原因，不会假装成功。
 
+> **安装时必须带版本号**（如 `@0.4.1`）。pnpm 11 默认开启 `minimumReleaseAge` 安全策略，
+> 新发布的版本在一段时间内不会被 `@latest` 解析到，会**回退安装到很旧的版本**（0.1.0 没有扫码配对，
+> 表现就是「扫码页打不开」）。显式写版本号可绕过该策略。
+
 ### 装完之后
 
 插件随 DSH 启动自动工作，**不需要手动跑 connect.cmd**；装的时候没有提示是正常的，日志里会出现：
@@ -238,7 +242,7 @@ dsh-remote: ready — 手机端扫码：dsh-remote qr（或浏览器打开 http:
 ### 升级插件（重要：必须完全重启 DSH）
 
 ```bash
-dsh plugin --profile desktop add dsh-remote-hub     # 或 --profile web
+dsh plugin --profile desktop add dsh-remote-hub@0.4.2     # 或 --profile web
 ```
 
 **升级后请完全退出 DSH 再重新打开，不要只靠插件热重载。** 原因是旧版本的桥接监听可能不会被热重载回收，
@@ -313,3 +317,7 @@ dsh-remote qr
 | GET | `/_dsh-remote/pair` | 配对页（二维码 HTML） |
 | GET | `/_dsh-remote/pair.svg` | 只要二维码 SVG |
 | POST | `/_dsh-remote/pair/redeem` | `{code}` → `{url, cookie}`；用过即失效 |
+
+---
+
+发版流程（版本号约定、tag 命名、发布 checklist、踩过的坑）：见 [RELEASING.md](RELEASING.md)

package/bin/dsh-remote.mjs

@@ -5,7 +5,7 @@
  *   dsh-remote status      show LAN URL, public URL, cookie and upstream port
  *   dsh-remote connect     print the two lines to paste into the phone
  *   dsh-remote cookie      print only the cookie
- *   dsh-remote start [--open] [--public-url=URL]  run the supervisor; --open 打印地址并打开配对页
+ *   dsh-remote start [--open] [--restart] [--public-url=URL]  --restart 会先停掉配置不同的旧桥接
  *   dsh-remote stop        ask a foreground `start` to stop (best effort, via status file)
  *   dsh-remote doctor      check every prerequisite in one pass
  *   dsh-remote qr          open the pairing page (QR) in the default browser
@@ -23,6 +23,7 @@ import { credentialsPath, mintCookie, readSigningSecret } from '../lib/cookie.js
 import { listeningPorts, probePort } from '../lib/discover.js'
 import { findCloudflared, findNgrok } from '../lib/tunnel.js'
 import { CONNECT_FILE, STATUS_FILE, readStatus, start } from '../lib/supervisor.js'
+import { version as VERSION } from '../lib/index.js'
 
 const args = process.argv.slice(2)
 const command = args[0] || 'status'
@@ -42,6 +43,7 @@ function printStatus() {
   const remaining = status.cookieExpiresAt ? Math.round((status.cookieExpiresAt - Date.now()) / 86400000) : null
   console.log('')
   console.log('  DSH Remote 状态')
+  console.log(`  插件版本     v${VERSION}`)
   console.log('  ' + '-'.repeat(52))
   console.log(`  局域网地址   ${status.lan?.url ?? '(未检测到局域网 IP)'}`)
   console.log(`  公网地址     ${status.public?.url ?? `无（${status.public?.note ?? '未开启'}）`}`)
@@ -58,6 +60,7 @@ function printStatus() {
   } else if (status.error) {
     console.log(`  错误   ${status.error}`)
   }
+  console.log(`  ✔ 插件版本        v${VERSION}`)
   console.log('  ' + '-'.repeat(52))
   console.log('')
 }
@@ -260,9 +263,26 @@ async function main() {
       break
     case 'start': {
       const wantOpen = process.argv.includes('--open')
+      const wantRestart = process.argv.includes('--restart')
       // --public-url=https://relay.example  advertises a self-hosted relay in the QR payload.
       const publicArg = process.argv.find((a) => a.startsWith('--public-url='))
       const publicUrl = publicArg ? publicArg.slice('--public-url='.length) : process.env.DSH_REMOTE_PUBLIC_URL || ''
+      // A launcher that carries its own transport config must not silently adopt a bridge started
+      // with different config (that is how a public launcher ended up advertising a self-use relay).
+      if (wantRestart) {
+        const live = await bridgeHealthy(Number(process.env.DSH_REMOTE_PORT || 6300))
+        const mismatch = live && (live.relay || null) !== (publicUrl || null)
+        if (mismatch && live.pid) {
+          console.log(`已有桥接配置不同（relay=${live.relay ?? '无'}），先停止它（PID ${live.pid}）再按当前配置启动`)
+          try {
+            process.kill(Number(live.pid))
+          } catch (err) {
+            console.log(`停止失败：${err.message}`)
+          }
+          await new Promise((r) => setTimeout(r, 1200))
+        }
+      }
+
       let handle
       try {
         handle = await start({ publicUrl, log: (m) => console.log(m) })

package/lib/bridge.js

@@ -68,7 +68,7 @@ function trimSessionList(body) {
  * @param {(msg: string) => void} [options.log]
  * @returns {Promise<{close: () => Promise<void>, port: number}>}
  */
-export function startBridge({ listenPort, authority, upstream, pairing = null, log = () => {} }) {
+export function startBridge({ listenPort, authority, upstream, pairing = null, relayUrl = null, log = () => {} }) {
   const forward = (req, res, attempt = 0) =>
     new Promise((resolve) => {
       upstream.resolve(attempt > 0).then((port) => {
@@ -155,6 +155,10 @@ export function startBridge({ listenPort, authority, upstream, pairing = null, l
       const body = JSON.stringify({
         ok: true,
         service: 'dsh-remote-bridge',
+        pid: process.pid,
+        // Whether this bridge advertises a self-hosted relay; a launcher that expects none must not
+        // adopt a bridge that has one, or the public app would show the self-use relay.
+        relay: relayUrl || null,
         // A bridge built before pairing existed has no such route; callers use this flag to decide
         // whether an already-listening port can be adopted or must be bypassed.
         pairing: pairing != null,

package/lib/index.js

@@ -16,7 +16,7 @@ import { start } from './supervisor.js'
 
 export const name = 'dsh-remote-hub'
 
-export const version = '0.4.0'
+export const version = '0.4.2'
 
 /** No host services are required: the plugin only needs Node builtins. */
 export const inject = []
@@ -56,7 +56,7 @@ export function apply(ctx, config = {}) {
         // Make the next step discoverable from the log: after installing the plugin there is no
         // other place telling the user how to get the phone connected.
         log(
-          `dsh-remote: ready — 手机端扫码：dsh-remote qr（或浏览器打开 http://127.0.0.1:${started.status.bridgePort}/_dsh-remote/pair）；` +
+          `dsh-remote: ready (v${version}) — 手机端扫码：dsh-remote qr（或浏览器打开 http://127.0.0.1:${started.status.bridgePort}/_dsh-remote/pair）；` +
             '不想装插件时也可以直接双击仓库里的 connect.cmd',
         )
       }

package/lib/supervisor.js

@@ -274,6 +274,10 @@ export async function start(config = {}) {
   const lanUrlsFor = (bridgePort) =>
     lanAddresses().map((address) => `http://${address}:${bridgePort}`)
 
+  // The self-hosted relay (if configured) and the auto tunnel are reported SEPARATELY: a self-use
+  // setup wants both (relay for 4G, ngrok as a second path), and the phone decides which to use.
+  const relayUrl = String(publicUrl || '').trim().replace(/\/+$/, '') || null
+
   let bridgeInstance = null
   const actualBridgePort = () => (bridgeInstance ? bridgeInstance.port : Number(port) || 6300)
 
@@ -312,6 +316,7 @@ export async function start(config = {}) {
       authority,
       upstream: discovery,
       pairing,
+      relayUrl,
       log,
     })
   } catch (err) {
@@ -337,7 +342,13 @@ export async function start(config = {}) {
         authority: existing.authority ?? authority,
         upstreamPort: existing.upstreamPort ?? null,
         lan: { ip, url: ip ? `http://${ip}:${livePort}` : null },
-        public: prev.public ?? { url: null, kind: 'none', note: 'served by an existing bridge' },
+        // Never inherit the previous run's public address: it may describe a different transport
+        // (e.g. a self-use relay) than the launcher that is running now.
+        public: existing.relay
+          ? { url: existing.relay, kind: 'relay' }
+          : { url: null, kind: 'none', note: 'served by an existing bridge' },
+        relay: existing.relay ? { url: existing.relay } : null,
+        tunnel: null,
         cookie: prev.cookie ?? null,
         cookieExpiresAt: prev.cookieExpiresAt ?? null,
         pairing: { url: prev.public?.url ?? (ip ? `http://${ip}:${livePort}` : null), page: '/_dsh-remote/pair' },
@@ -405,9 +416,6 @@ export async function start(config = {}) {
     },
   })
 
-  // The self-hosted relay (if configured) and the auto tunnel are reported SEPARATELY: a self-use
-  // setup wants both (relay for 4G, ngrok as a second path), and the phone decides which to use.
-  const relayUrl = String(publicUrl || '').trim().replace(/\/+$/, '') || null
   lastPublicUrl = relayUrl ?? tunnel.publicUrl
   let relayReachable = null
   if (relayUrl) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-remote-hub",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "DSH 插件：把电脑上的 DeepSeek Harness 变成手机可访问的服务——起桥接、自动开隧道（ngrok / cloudflared）、签发 30 天 Cookie，并输出地址与凭据，配合 DSH Remote Android App 使用。",
   "type": "module",
   "main": "lib/index.js",