feat(ui): wire seamColor from bootstrap config to CSS custom properties (fixes #56068)

liuhao1024 · liuhao1024 · commit 0cdfafd7f512 · 2026-06-14T19:18:02.000+08:00
diff --git a/src/gateway/control-ui-contract.ts b/src/gateway/control-ui-contract.ts
@@ -20,4 +20,5 @@ export type ControlUiBootstrapConfig = {
   embedSandbox?: ControlUiEmbedSandboxMode;
   allowExternalEmbedUrls?: boolean;
   chatMessageMaxWidth?: string;
+  seamColor?: string;
 };
diff --git a/src/gateway/control-ui.ts b/src/gateway/control-ui.ts
@@ -979,6 +979,7 @@ export async function handleControlUiHttpRequest(
             : "scripts",
       allowExternalEmbedUrls: config?.gateway?.controlUi?.allowExternalEmbedUrls === true,
       chatMessageMaxWidth: config?.gateway?.controlUi?.chatMessageMaxWidth,
+      seamColor: config?.ui?.seamColor,
     } satisfies ControlUiBootstrapConfig);
     return true;
   }
diff --git a/ui/src/ui/controllers/control-ui-bootstrap.ts b/ui/src/ui/controllers/control-ui-bootstrap.ts
@@ -136,7 +136,33 @@ export async function loadControlUiBootstrapConfig(
       typeof parsed.chatMessageMaxWidth === "string" && parsed.chatMessageMaxWidth.trim()
         ? parsed.chatMessageMaxWidth
         : null;
+    if (typeof parsed.seamColor === "string" && parsed.seamColor) {
+      applySeamColor(parsed.seamColor);
+    }
   } catch {
     // Ignore bootstrap failures; UI will update identity after connecting.
   }
 }
+
+function applySeamColor(hex: string): void {
+  const root = document.documentElement;
+  root.style.setProperty("--accent", hex);
+  root.style.setProperty("--accent-muted", hex);
+  root.style.setProperty("--primary", hex);
+  root.style.setProperty(
+    "--accent-subtle",
+    `color-mix(in srgb, ${hex} 12%, transparent)`,
+  );
+  root.style.setProperty(
+    "--accent-glow",
+    `color-mix(in srgb, ${hex} 20%, transparent)`,
+  );
+  try {
+    root.style.setProperty(
+      "--accent-hover",
+      `oklch(from ${hex} calc(l + 0.1) c h)`,
+    );
+  } catch {
+    /* relative color syntax not supported */
+  }
+}

Original file line number	Diff line number	Diff line change
`@@ -979,6 +979,7 @@ export async function handleControlUiHttpRequest(`
`979`	`979`	`: "scripts",`
`980`	`980`	`allowExternalEmbedUrls: config?.gateway?.controlUi?.allowExternalEmbedUrls === true,`
`981`	`981`	`chatMessageMaxWidth: config?.gateway?.controlUi?.chatMessageMaxWidth,`
	`982`	`+ seamColor: config?.ui?.seamColor,`
`982`	`983`	`} satisfies ControlUiBootstrapConfig);`
`983`	`984`	`return true;`
`984`	`985`	`}`