rdsh-gateway 0.8.5 → 0.8.6

package/dist/index.d.ts

@@ -10,7 +10,7 @@ export type { SessionPayload } from "./session.ts";
 export { PairManager } from "./pair.ts";
 export { startGateway } from "./server.ts";
 export type { GatewayOptions, RunningGateway } from "./server.ts";
-export { findDsh, spawnDsh, exchangeDshSessionCookie, detectDshVersion, compareDshVersions, dshVersionWarning, DSH_COMPAT_MIN, DSH_COMPAT_MAX } from "./spawn-dsh.ts";
+export { findDsh, spawnDsh, dshSpawnEnv, RDSH_REMOTE_TTY, checkRemotePickerGraph, remotePickerWarning, exchangeDshSessionCookie, detectDshVersion, compareDshVersions, dshVersionWarning, DSH_COMPAT_MIN, DSH_COMPAT_MAX } from "./spawn-dsh.ts";
 export type { SpawnedDsh } from "./spawn-dsh.ts";
 export { forwardHttp, createUpgradeProxy, rewriteHeadersForDsh } from "./proxy.ts";
 export type { ProxyTarget } from "./proxy.ts";

package/dist/index.js

@@ -7,7 +7,7 @@ export { serve } from "./serve.js";
 export { SessionManager, SESSION_COOKIE, sessionTokenFromCookie } from "./session.js";
 export { PairManager } from "./pair.js";
 export { startGateway } from "./server.js";
-export { findDsh, spawnDsh, exchangeDshSessionCookie, detectDshVersion, compareDshVersions, dshVersionWarning, DSH_COMPAT_MIN, DSH_COMPAT_MAX } from "./spawn-dsh.js";
+export { findDsh, spawnDsh, dshSpawnEnv, RDSH_REMOTE_TTY, checkRemotePickerGraph, remotePickerWarning, exchangeDshSessionCookie, detectDshVersion, compareDshVersions, dshVersionWarning, DSH_COMPAT_MIN, DSH_COMPAT_MAX } from "./spawn-dsh.js";
 export { forwardHttp, createUpgradeProxy, rewriteHeadersForDsh } from "./proxy.js";
 export { loadConfig, normalizeConfig, resolveConfigPath, saveConfig, DEFAULT_HOST_CONFIG_PATH } from "./config.js";
 export { hashPassword, verifyPassword, UserManager } from "./auth.js";

package/dist/join.js

@@ -14,7 +14,7 @@ import { request as httpsRequest } from "node:https";
 import { hostname as osHostname } from "node:os";
 import { WebSocket } from "ws";
 import { FrameParser, FRAME_TYPE, encodeFrame, jsonPayload, parseJsonPayload, FLAG_E2E, MAX_PAYLOAD_LENGTH } from "rdsh-tunnel";
-import { findDsh, spawnDsh, exchangeDshSessionCookie, detectDshVersion, dshVersionWarning } from "./spawn-dsh.js";
+import { findDsh, spawnDsh, exchangeDshSessionCookie, detectDshVersion, dshVersionWarning, checkRemotePickerGraph, remotePickerWarning } from "./spawn-dsh.js";
 import { rewriteHeadersForDsh } from "./proxy.js";
 import { clearPersistedToken, persistToken, readPersistedToken } from "./token-store.js";
 import { decodeBody, encodeBody, firstEncoding } from "./http-encoding.js";
@@ -905,6 +905,10 @@ export async function join(opts) {
             console.warn("rdsh join: dsh 0.1.2+ 会话 cookie 换发失败——远程访问将返回 401。");
         }
     }
+    // 自检：目录选择器必须是浏览器内形态（否则远端浏览器只会看到弹在宿主屏幕上的原生对话框）
+    if ((await checkRemotePickerGraph(dsh.port, dshAuthCookieHeader)) === false) {
+        console.warn(`\n⚠  ${remotePickerWarning()}\n`);
+    }
     // 解析 host token（含证书自动检测 + 持久化）；进程重启后复用，避免重复配对。
     const { token, insecure, name } = await registerJoin(opts);
     console.log(`rdsh join: dsh web on 127.0.0.1:${dsh.port}`);

package/dist/serve.js

@@ -3,7 +3,7 @@
  */
 import { networkInterfaces } from "node:os";
 import { startGateway } from "./server.js";
-import { findDsh, spawnDsh, exchangeDshSessionCookie, detectDshVersion, dshVersionWarning } from "./spawn-dsh.js";
+import { findDsh, spawnDsh, exchangeDshSessionCookie, detectDshVersion, dshVersionWarning, checkRemotePickerGraph, remotePickerWarning } from "./spawn-dsh.js";
 import { loadConfig, resolveConfigPath } from "./config.js";
 import { UserManager } from "./auth.js";
 import { loadTls } from "./tls.js";
@@ -39,6 +39,10 @@ export async function serve(opts) {
             console.warn("rdsh: dsh 0.1.2+ 会话 cookie 换发失败——远程访问将返回 401（请确认 dsh web 已就绪或暂用 dsh@0.1.1-rc.2）。");
         }
     }
+    // 自检：目录选择器必须是浏览器内形态（否则远端浏览器只会看到弹在宿主屏幕上的原生对话框）
+    if ((await checkRemotePickerGraph(dsh.port, dshAuthCookieHeader)) === false) {
+        console.warn(`\n⚠  ${remotePickerWarning()}\n`);
+    }
     // TLS 决策：有 tls.cert/key → https；无 → http（behindProxy 或 pair/none）。
     // password + http + 非反代 → server.ts 安全约束拒绝启动（需自行提供证书）。
     const tlsMaterial = await loadTls(config.tls, config.behindProxy);

package/dist/spawn-dsh.d.ts

@@ -16,6 +16,27 @@ export interface SpawnedDsh {
  * 找不到返回 null。
  */
 export declare function findDsh(override?: string): string | null;
+/**
+ * 注入给 dsh 的「远端操作者」信号值。用可读字面量而非 `/dev/...`：
+ * 让 `env` 里一眼看出这是 rdsh 注入的，而不是真实终端路径。
+ */
+export declare const RDSH_REMOTE_TTY = "rdsh-remote";
+/**
+ * 构造 spawn dsh 时的环境：保证 dsh 把目录选择器解析为 **browse**（浏览器内目录浏览器）。
+ *
+ * 事实依据（doc/fix/20260917-remote-workspace-picker/discussion.md F2/F4/F8）：
+ * `@deepseek-ai/dsh-host-directory-picker-auto` 在 boot 时读 `SSH_CONNECTION`/`SSH_TTY`
+ * （仅继承进程层，非空即可）——「操作者看不到宿主显示」正是 rdsh 的场景（等价于
+ * SSH 端口转发下的无人值守宿主）。不注入它，宿主是 macOS/Windows/带 DISPLAY 的 Linux
+ * 时会解析成 `native`，原生对话框弹在宿主屏幕上、远端浏览器无法操作。
+ *
+ * 只设 `SSH_TTY`：`SSH_CONNECTION` 有固定 `"ip port ip port"` 格式，写假值会误导解析它的工具。
+ * 用户真的在 SSH 会话里启动时（已有非空信号）保持原值不动。
+ *
+ * ⚠️ 这是上游启发式的输入：上游若改变判定信号，本注入会静默失效（spawn 后自检见
+ * `checkRemotePickerGraph` 与 doc/fix/20260917-remote-workspace-picker/solution.md §6）。
+ */
+export declare function dshSpawnEnv(base?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
 /**
  * spawn `dsh web --port 0 --no-open` 并等待其报告监听端口。
  * 就绪后把 dsh 的 stdout/stderr 透传到本进程。
@@ -29,6 +50,22 @@ export declare function spawnDsh(dshPath: string): Promise<SpawnedDsh>;
  * 返回 cookie 的 `name=value` 段（不含属性）；换发失败/超时/无 cookie → null（调用方降级）。
  */
 export declare function exchangeDshSessionCookie(port: number, token: string, timeoutMs?: number): Promise<string | null>;
+/**
+ * 自检：spawn 出的 dsh 是否真的把目录选择器解析成了 **browse**。
+ *
+ * 方法（与 doc/fix/20260917-remote-workspace-picker 的验证手段一致）：取一次首页，
+ * 在注入的 boot graph 里找浏览器内选择器的客户端模块 —— 在 → 远端浏览器可用；
+ * 不在 → 选择器是 `native`（原生对话框弹在宿主屏幕上）。
+ *
+ * @returns `true`（已挂载 browse）/ `false`（确认未挂载）/ `null`（无法判定：网络、鉴权、超限）
+ * 只有 `false` 才值得告警；`null` 静默，避免噪声。
+ */
+export declare function checkRemotePickerGraph(port: number, cookieHeader?: string | null, timeoutMs?: number): Promise<boolean | null>;
+/**
+ * 自检失败（确认未挂载浏览器内选择器）时的告警文案。
+ * 零文档导向：说清后果 + 直接给动作。
+ */
+export declare function remotePickerWarning(): string;
 /** 探测 dsh 版本号（`dsh --version` 输出如 `0.1.2-rc.1`）；失败/不可解析 → null。 */
 export declare function detectDshVersion(dshPath: string, timeoutMs?: number): Promise<string | null>;
 /**

package/dist/spawn-dsh.js

@@ -42,6 +42,32 @@ export function findDsh(override) {
     }
     return null;
 }
+/**
+ * 注入给 dsh 的「远端操作者」信号值。用可读字面量而非 `/dev/...`：
+ * 让 `env` 里一眼看出这是 rdsh 注入的，而不是真实终端路径。
+ */
+export const RDSH_REMOTE_TTY = "rdsh-remote";
+/**
+ * 构造 spawn dsh 时的环境：保证 dsh 把目录选择器解析为 **browse**（浏览器内目录浏览器）。
+ *
+ * 事实依据（doc/fix/20260917-remote-workspace-picker/discussion.md F2/F4/F8）：
+ * `@deepseek-ai/dsh-host-directory-picker-auto` 在 boot 时读 `SSH_CONNECTION`/`SSH_TTY`
+ * （仅继承进程层，非空即可）——「操作者看不到宿主显示」正是 rdsh 的场景（等价于
+ * SSH 端口转发下的无人值守宿主）。不注入它，宿主是 macOS/Windows/带 DISPLAY 的 Linux
+ * 时会解析成 `native`，原生对话框弹在宿主屏幕上、远端浏览器无法操作。
+ *
+ * 只设 `SSH_TTY`：`SSH_CONNECTION` 有固定 `"ip port ip port"` 格式，写假值会误导解析它的工具。
+ * 用户真的在 SSH 会话里启动时（已有非空信号）保持原值不动。
+ *
+ * ⚠️ 这是上游启发式的输入：上游若改变判定信号，本注入会静默失效（spawn 后自检见
+ * `checkRemotePickerGraph` 与 doc/fix/20260917-remote-workspace-picker/solution.md §6）。
+ */
+export function dshSpawnEnv(base = process.env) {
+    const hasSignal = (base.SSH_TTY ?? "") !== "" || (base.SSH_CONNECTION ?? "") !== "";
+    if (hasSignal)
+        return { ...base };
+    return { ...base, SSH_TTY: RDSH_REMOTE_TTY };
+}
 /**
  * spawn `dsh web --port 0 --no-open` 并等待其报告监听端口。
  * 就绪后把 dsh 的 stdout/stderr 透传到本进程。
@@ -51,6 +77,7 @@ export function spawnDsh(dshPath) {
     return new Promise((resolve, reject) => {
         const child = spawn(dshPath, ["web", "--port", "0", "--no-open"], {
             stdio: ["ignore", "pipe", "pipe"],
+            env: dshSpawnEnv(),
         });
         let stderrBuf = "";
         const timeout = setTimeout(() => {
@@ -124,6 +151,66 @@ export function exchangeDshSessionCookie(port, token, timeoutMs = EXCHANGE_TIMEO
         });
     });
 }
+const GRAPH_CHECK_TIMEOUT_MS = 5_000;
+const MAX_GRAPH_BYTES = 512 * 1024;
+/** boot graph 里浏览器内目录选择器的客户端模块标识（命中即说明 picker = browse）。 */
+const BROWSE_PICKER_MODULE = "@deepseek-ai/dsh-client-ui-directory-picker-browse";
+/**
+ * 自检：spawn 出的 dsh 是否真的把目录选择器解析成了 **browse**。
+ *
+ * 方法（与 doc/fix/20260917-remote-workspace-picker 的验证手段一致）：取一次首页，
+ * 在注入的 boot graph 里找浏览器内选择器的客户端模块 —— 在 → 远端浏览器可用；
+ * 不在 → 选择器是 `native`（原生对话框弹在宿主屏幕上）。
+ *
+ * @returns `true`（已挂载 browse）/ `false`（确认未挂载）/ `null`（无法判定：网络、鉴权、超限）
+ * 只有 `false` 才值得告警；`null` 静默，避免噪声。
+ */
+export function checkRemotePickerGraph(port, cookieHeader = null, timeoutMs = GRAPH_CHECK_TIMEOUT_MS) {
+    return new Promise((resolve) => {
+        const headers = { Host: `127.0.0.1:${port}` };
+        if (cookieHeader !== null)
+            headers.Cookie = cookieHeader;
+        let settled = false;
+        const finish = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(value);
+        };
+        const req = get({ host: "127.0.0.1", port, path: "/", headers }, (res) => {
+            if (res.statusCode !== 200) {
+                res.resume();
+                finish(null);
+                return;
+            }
+            let body = "";
+            res.setEncoding("utf8");
+            res.on("data", (chunk) => {
+                body += chunk;
+                if (body.length > MAX_GRAPH_BYTES) {
+                    req.destroy();
+                    finish(null);
+                }
+            });
+            res.on("end", () => finish(body.includes(BROWSE_PICKER_MODULE)));
+            res.on("error", () => finish(null));
+        });
+        req.on("error", () => finish(null));
+        req.setTimeout(timeoutMs, () => {
+            req.destroy();
+            finish(null);
+        });
+    });
+}
+/**
+ * 自检失败（确认未挂载浏览器内选择器）时的告警文案。
+ * 零文档导向：说清后果 + 直接给动作。
+ */
+export function remotePickerWarning() {
+    return ("rdsh: 远端浏览器的目录选择器不是浏览器内目录浏览器（很可能是宿主原生对话框，远端无法操作）。" +
+        "若装了 dsh-web-remote 插件，请检查 profile 的 cordis.patch.yml 是否被其它 patch 层覆盖（目录选择器只允许一个 pin 通道）。" +
+        "否则可能是 dsh 版本变更导致远端信号失效——升级 remote-dsh：npm i -g remote-dsh@latest。");
+}
 /** 探测 dsh 版本号（`dsh --version` 输出如 `0.1.2-rc.1`）；失败/不可解析 → null。 */
 export function detectDshVersion(dshPath, timeoutMs = VERSION_TIMEOUT_MS) {
     return new Promise((resolve) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rdsh-gateway",
-  "version": "0.8.5",
+  "version": "0.8.6",
   "description": "rdsh host-side component: LAN auth gateway + outbound tunnel endpoint (spawns dsh web)",
   "license": "MIT",
   "type": "module",