产品化改造：完善本地集成与启动体验

qimingclaw/crates/agent-electron-client/src/renderer/services/utils/sessionUrl.test.ts

@@ -3,6 +3,7 @@ import {
   buildRedirectUrl,
   buildNewSessionUrl,
   buildChatSessionUrl,
+  normalizeLocalBackendRedirect,
   syncSessionCookie,
   syncCookieAndGetRedirectUrl,
   syncCookieAndGetNewSessionUrl,
@@ -87,6 +88,51 @@ describe("buildChatSessionUrl", () => {
   });
 });
 
+describe("normalizeLocalBackendRedirect", () => {
+  it("normalizes local redirects that lost protocol and port", () => {
+    expect(
+      normalizeLocalBackendRedirect(
+        "https://localhost/home/chat/5/26?hideMenu=true",
+        "http://localhost:18081/api/sandbox/config/redirect/6?hideMenu=true",
+      ),
+    ).toBe("http://localhost:18081/home/chat/5/26?hideMenu=true");
+  });
+
+  it("normalizes localhost and 127.0.0.1 mismatches to the configured backend", () => {
+    expect(
+      normalizeLocalBackendRedirect(
+        "https://localhost/home/chat/5/26?hideMenu=true",
+        "http://127.0.0.1:18081/api/sandbox/config/redirect/6?hideMenu=true",
+      ),
+    ).toBe("http://127.0.0.1:18081/home/chat/5/26?hideMenu=true");
+  });
+
+  it("does not rewrite already-correct local redirects", () => {
+    expect(
+      normalizeLocalBackendRedirect(
+        "http://localhost:18081/home/chat/5/26?hideMenu=true",
+        "http://localhost:18081/api/sandbox/config/redirect/6?hideMenu=true",
+      ),
+    ).toBeNull();
+  });
+
+  it("does not rewrite remote domains", () => {
+    expect(
+      normalizeLocalBackendRedirect(
+        "https://example.com/home/chat/5/26?hideMenu=true",
+        "https://example.com/api/sandbox/config/redirect/6?hideMenu=true",
+      ),
+    ).toBeNull();
+  });
+
+  it("returns null for invalid URLs", () => {
+    expect(normalizeLocalBackendRedirect("not-url", "http://localhost:18081"))
+      .toBeNull();
+    expect(normalizeLocalBackendRedirect("https://localhost", "not-url"))
+      .toBeNull();
+  });
+});
+
 describe("syncSessionCookie", () => {
   it("不设 domain 和 secure，由主进程根据 URL scheme 判断", async () => {
     await syncSessionCookie("https://app.example.com:8080/path", "tok123");

qimingclaw/crates/agent-electron-client/src/renderer/services/utils/sessionUrl.ts

@@ -66,6 +66,46 @@ export function buildChatSessionUrl(domain: string, sessionId: string): string {
   return `${normalizedDomain}/api/sandbox/config/redirect/chat/${sessionId}?hideMenu=true`;
 }
 
+function isLocalBackendHost(hostname: string): boolean {
+  return hostname === "localhost" || hostname === "127.0.0.1";
+}
+
+/**
+ * Some local backend builds redirect `http://localhost:18081/...` to
+ * `https://localhost/...`, losing both the protocol and port. Normalize only
+ * that local-only case so embedded webviews keep using the configured backend.
+ */
+export function normalizeLocalBackendRedirect(
+  redirectUrl: string,
+  expectedBackendUrl: string,
+): string | null {
+  try {
+    const redirect = new URL(redirectUrl);
+    const expected = new URL(expectedBackendUrl);
+
+    if (
+      !isLocalBackendHost(expected.hostname) ||
+      !isLocalBackendHost(redirect.hostname)
+    ) {
+      return null;
+    }
+
+    if (
+      redirect.protocol === expected.protocol &&
+      redirect.port === expected.port
+    ) {
+      return null;
+    }
+
+    redirect.protocol = expected.protocol;
+    redirect.host = expected.host;
+    const normalized = redirect.toString();
+    return normalized === redirectUrl ? null : normalized;
+  } catch {
+    return null;
+  }
+}
+
 export async function syncSessionCookie(
   domain: string,
   token: string,