@mrrisega/dsh-remote 0.3.9 → 0.4.1

package/clients/dsh-remote/dsh-bridge.mjs

@@ -95,6 +95,22 @@ function saveLocalConfig(cfg) {
   }
 }
 
+/**
+ * Harness 浏览器会话 Cookie(由 dsh-remote-ui 插件在进程内换取后写入
+ * <relayDir>/.harness-cookie.json)。新版 dsh web(0.1.2+)对每个请求校验该 Cookie,
+ * 不带则 401 → 手机端白页;bridge 对所有上游 HTTP/WS 请求自动携带,让手机表现为已授权浏览器。
+ */
+const HARNESS_COOKIE_FILE = ".harness-cookie.json";
+function harnessCookieOf() {
+  try {
+    const p = path.join(path.dirname(CONFIG_PATH), HARNESS_COOKIE_FILE);
+    const j = JSON.parse(fs.readFileSync(p, "utf8"));
+    return j && typeof j.cookie === "string" && j.cookie ? j.cookie : "";
+  } catch {
+    return "";
+  }
+}
+
 /**
  * 解析稳定 deviceId:优先级 env DSH_BRIDGE_DEVICE_ID > argv[2] > 配置 device_id > 生成。
  * 生成格式 dev-<12hex> 并持久化到 .dsh-config.json,保证每台 Mac 重启后 id 不变。
@@ -257,6 +273,8 @@ export function buildWsHeaders(headers) {
   const up = new URL(UPSTREAM);
   const out = sanitizeRequestHeaders(headers);
   out.Host = up.host; // e.g. "127.0.0.1:3080"
+  const ck = harnessCookieOf(); // 新版 dsh web 的浏览器会话 Cookie
+  if (ck) out.Cookie = ck;
   return out;
 }
 
@@ -335,7 +353,10 @@ async function doHttp(method, path, reqHeaders, body, isB64) {
   const safe = safePath(path);
   if (safe === null) throw new Error("非法路径");
   const url = `${UPSTREAM}${safe}`;
-  const init = { method, headers: sanitizeRequestHeaders(reqHeaders) };
+  const reqHdrs = sanitizeRequestHeaders(reqHeaders);
+  const ck = harnessCookieOf(); // 新版 dsh web 的浏览器会话 Cookie(否则 401 白页)
+  if (ck) reqHdrs.Cookie = ck;
+  const init = { method, headers: reqHdrs };
   if (body !== undefined && body !== null && body !== "") {
     // 新协议 http 帧的 body 一律 base64;旧协议 body 是原始文本
     init.body = isB64 ? Buffer.from(String(body), "base64") : String(body);

package/dsh-setup.mjs

@@ -99,6 +99,19 @@ function deriveTunnelUrl(apiUrl) {
   return apiUrl.replace(/\/relay-api\/?$/, "").replace(/^https/, "wss");
 }
 
+/**
+ * 模式归一化（SaaS 权威）：清掉自建残留(local_key/假 tunnel_url)，api_url 与
+ * tunnel_url 一律按云端权威地址重算。防止"切过自建后又登云端"时残留配置把
+ * bridge 带到错误服务器（此前手机永远看不到设备的根因之一）。
+ */
+function applySaaSMode(cfg) {
+  delete cfg.local_key;
+  delete cfg.server; // 旧字段兜底
+  cfg.api_url = String(cfg.api_url || DEFAULT_API).replace(/\/+$/, "");
+  cfg.tunnel_url = deriveTunnelUrl(cfg.api_url);
+  return cfg;
+}
+
 /** 归一化自建服务器地址：缺省补 wss://，去掉末尾 / */
 function normalizeTunnelUrl(raw) {
   let u = String(raw || "").trim().replace(/\/+$/, "");
@@ -239,9 +252,7 @@ function serveSettings() {
             return send(400, JSON.stringify({ ok: false, message: "SaaS 模式需要手机号与密码" }), "application/json");
           }
           cfg.phone = body.phone; cfg.password = body.password;
-          delete cfg.local_key;
-          cfg.api_url = body.api_url || cfg.api_url || DEFAULT_API;
-          if (!cfg.tunnel_url) cfg.tunnel_url = deriveTunnelUrl(cfg.api_url);
+          applySaaSMode(cfg); // 清自建残留,api/tunnel 权威重算
         }
         // 自动获取服务端下发的 bridge_secret（device-login 共享密钥，一键安装开箱即用）
         if (!cfg.bridge_secret && !cfg.local_key) {
@@ -328,7 +339,7 @@ async function runBridge() {
     // 每次循环重读配置：设置页登录/切换模式后无需重启守护即可生效
     cfg = loadConfig();
     const saas = Boolean((cfg.phone || cfg.email) && cfg.password);
-    const local = Boolean(cfg.local_key);
+    let local = Boolean(cfg.local_key);
     if (!saas && !local) {
       if (!warnedNoLogin) {
         warnedNoLogin = true;
@@ -341,9 +352,13 @@ async function runBridge() {
       console.log("⚠️ 自建模式缺少服务器地址：请用 `dsh-remote setup --server wss://host:port --key <密钥>` 重新配置。");
       return;
     }
-    if (saas && !cfg.tunnel_url) {
-      cfg.tunnel_url = deriveTunnelUrl(cfg.api_url || DEFAULT_API);
+    if (saas) {
+      // SaaS 权威归一化：清掉任何自建残留，tunnel/api 始终指向云端地址
+      applySaaSMode(cfg);
+      local = false;
       saveConfig(cfg);
+    } else if (local && !cfg.tunnel_url) {
+      cfg.tunnel_url = deriveTunnelUrl(cfg.api_url || DEFAULT_API);
     }
     const apiUrl = saas ? (cfg.api_url || DEFAULT_API) : "";
 
@@ -458,7 +473,8 @@ async function setup(argv) {
     console.log(`   手机端: 打开 ${cfg.tunnel_url.replace(/^ws/, "https")}/app/ ，用访问密钥登录即可。`);
   } else {
     console.log(`   远程控制地址: ${pub.app_url || DEFAULT_APP_URL}`);
-    console.log(`   下一步: 运行 \`dsh-remote settings\` 打开设置页，用手机号+密码登录（或注册）。`);
+    console.log(`   下一步（小白/无需任何命令）: 打开 dsh web → 设置 → 「远程控制」→ 注册/登录手机号即可。`);
+    console.log(`   若你是从 DeepSeek App/插件市场 安装：请【完全退出并重开 App】（或刷新 profile），插件即生效。`);
     console.log(`   登录后 bridge 会自动启动，手机端即可看到本机。`);
   }
   if (svc.path) console.log(`   自启动服务: ${svc.path}`);
@@ -652,7 +668,8 @@ async function pluginCmd(argv) {
     : "✅ node_modules/dsh-remote-ui 已就绪");
 
   console.log(`✅ 插件安装完成。配置目录: ${CONFIG_DIR}`);
-  console.log("   重启 dsh web（或重开 profile）后，在「设置 → 远程控制」查看面板。");
+  console.log("   打开 dsh web → 设置 → 「远程控制」，注册/登录手机号即可（无需任何命令）。");
+  console.log("   若从 DeepSeek App/插件市场 安装：请完全退出并重开 App 让插件生效。");
 }
 
 // ---------- main ----------

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrisega/dsh-remote",
-  "version": "0.3.9",
+  "version": "0.4.1",
   "description": "手机远程控制 DeepSeek Harness · Remote control DeepSeek Harness (dsh web) from any phone browser — 100% 全功能 App 级体验：发消息、看工具执行、审批权限、改设置、管凭据，含特权操作，免内网穿透。一条命令安装 npx @mrrisega/dsh-remote。Mobile remote control for DSH, self-host or SaaS, no server needed on LAN.",
   "keywords": [
     "deepseek-harness",

package/packages/dsh-remote-ui/lib/index.js

@@ -106,6 +106,95 @@ function saveConfig(relayDir, cfg) {
   }
 }
 
+/**
+ * SaaS 模式权威归一化（与 dsh-setup.mjs 同规则）：
+ * 清除自建残留(local_key/假 tunnel_url)，api_url 与 tunnel_url 一律按云端权威地址重算。
+ * 解决“切过自建(填了假地址)后，再登/重装云端账号仍连错服务器、手机看不到设备”的残留配置问题。
+ */
+function applySaaSMode(cfg) {
+  delete cfg.local_key;
+  delete cfg.server;
+  cfg.api_url = String(cfg.api_url || DEFAULT_API).replace(/\/+$/, "");
+  cfg.tunnel_url = cfg.api_url.replace(/\/relay-api\/?$/, "").replace(/^https/, "wss");
+  return cfg;
+}
+
+// ---------- Harness 浏览器会话代持(0.1.2-rc.1+ 的 ?token 鉴权) ----------
+
+/**
+ * 新版 dsh web(0.1.2-rc.1+)启动会打印带 ?token= 的 URL,并只给"换到了会话 Cookie"的浏览器放行,
+ * 其余请求一律 401(手机经隧道因此白页)。本插件与 Harness 同进程:
+ *  - 通过 ctx.connection 服务拿到本进程 launch token(authenticatedUrl 自带 token);
+ *  - 在本地向 /?token=… 发起 token 交换,捕获下发的 dsh-auth-* 会话 Cookie;
+ *  - 写入 <relayDir>/.harness-cookie.json,bridge 上游转发时自动携带,让手机表现为已授权浏览器。
+ * 老版本(无该鉴权)下 connection 服务没有 authenticatedUrl → 静默跳过,行为不变。
+ */
+const HARNESS_COOKIE_FILE = ".harness-cookie.json";
+const HARNESS_AUTH_RETRY_MS = 3000;
+const HARNESS_AUTH_RETRY_MAX = 20; // 最多约 60s 等 connection 服务就绪
+const HARNESS_AUTH_REFRESH_MS = 6 * 3600 * 1000;
+
+/** 读取响应里的 set-cookie(兼容 getSetCookie / get 两种实现)。 */
+function setCookieOf(res) {
+  try {
+    if (typeof res.headers.getSetCookie === "function") return res.headers.getSetCookie().join("; ");
+  } catch { /* ignore */ }
+  return res.headers.get("set-cookie") || "";
+}
+
+async function mintHarnessCookie(ctx, relayDir) {
+  try {
+    const port = ctx.webServer?.port;
+    if (!port) return false;
+    // 不能把 "connection" 写进 inject(0.1.1 无该服务会拖死激活),只能运行时 try 获取
+    let holder;
+    try { holder = ctx.get("connection"); } catch { holder = void 0; }
+    if (!holder && ctx.connection !== void 0) { try { holder = ctx.connection; } catch { /* ignore */ } }
+    const svc = holder && typeof holder.authenticatedUrl === "function"
+      ? holder
+      : holder && holder.connection && typeof holder.connection.authenticatedUrl === "function"
+        ? holder.connection
+        : null;
+    if (!svc) return false; // 老版本无浏览器鉴权 → 无需 cookie
+    const tokenUrl = svc.authenticatedUrl(`http://127.0.0.1:${port}`);
+    const res = await fetch(tokenUrl, { redirect: "manual", signal: AbortSignal.timeout(6000) });
+    const cookie = setCookieOf(res).split(";")[0].trim();
+    if (!cookie || !cookie.startsWith("dsh-auth-")) return false;
+    const out = { authority: `127.0.0.1:${port}`, cookie, mintedAt: Date.now() };
+    mkdirSync(dirname(configPathOf(relayDir)), { recursive: true });
+    writeFileSync(join(relayDir, HARNESS_COOKIE_FILE), JSON.stringify(out, null, 2), { mode: 0o600 });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/** 后台调度:启动重试直到换取成功,成功后每 6h 刷新(与插件生命周期同进退)。 */
+function scheduleHarnessMint(ctx, relayDir) {
+  let succeeded = false;
+  let retries = 0;
+  const attempt = async () => {
+    if (succeeded) return;
+    if (await mintHarnessCookie(ctx, relayDir)) succeeded = true;
+  };
+  const bootIv = setInterval(() => {
+    if (succeeded || ++retries > HARNESS_AUTH_RETRY_MAX) {
+      clearInterval(bootIv);
+      return;
+    }
+    void attempt();
+  }, HARNESS_AUTH_RETRY_MS);
+  bootIv.unref?.();
+  const refreshIv = setInterval(() => {
+    void mintHarnessCookie(ctx, relayDir).catch(() => {});
+  }, HARNESS_AUTH_REFRESH_MS);
+  refreshIv.unref?.();
+  return () => {
+    clearInterval(bootIv);
+    clearInterval(refreshIv);
+  };
+}
+
 // ---------- bridge 服务状态 / 启停（launchctl，macOS） ----------
 
 function launchAgentPath() {
@@ -524,14 +613,8 @@ function registerRoutes(ctx, relayDir) {
             delete cfg.device_private_key;
             delete cfg.device_public_key;
           }
-          // 切回 SaaS:仅当此前是自建模式(local_key)才清理本地隧道/API 地址;
-          // 正常 SaaS 用户的 tunnel_url 是核心配置(wss://公网域名),绝不能删
-          const wasLocal = Boolean(cfg.local_key);
-          delete cfg.local_key;
-          if (wasLocal) {
-            if (cfg.tunnel_url) delete cfg.tunnel_url;
-            if (cfg.api_url) delete cfg.api_url;
-          }
+          // SaaS 权威归一化：清除自建残留(local_key/假 tunnel_url)，api/tunnel 一律按云端重算
+          applySaaSMode(cfg);
         }
         saveConfig(relayDir, cfg);
         const bridgeRestart = startBridge(relayDir);
@@ -729,5 +812,7 @@ function registerRoutes(ctx, relayDir) {
 export function apply(ctx, config = {}) {
   const relayDir = config.relayDir || process.env.DSH_RELAY_DIR || DEFAULT_RELAY_DIR;
   ctx.effect(() => registerRoutes(ctx, relayDir), "dsh-remote-ui: /dsh-remote routes");
+  // 0.1.2-rc.1+ 浏览器会话代持：换取 Harness 会话 Cookie 供 bridge 上游携带（手机点设备不再 401 白页）
+  ctx.effect(() => scheduleHarnessMint(ctx, relayDir), "dsh-remote-ui: harness browser-session mint");
   ctx.logger?.info?.(`dsh-remote-ui: /dsh-remote routes ready (relayDir=${relayDir})`);
 }