feat: add light/dark theme to exchange instances with hub SSO sync

Co-authored-by: Cursor <cursoragent@cursor.com>

hub_bridge.py

@@ -28,6 +28,46 @@ from hub_sso import (
 )
 
 
+def _merge_query_into_path(path: str, **params: str) -> str:
+    from urllib.parse import parse_qsl, urlencode, urlsplit, urlunsplit
+
+    split = urlsplit(path or "/")
+    q = list(parse_qsl(split.query, keep_blank_values=True))
+    keys = {k for k, _ in q}
+    for k, v in params.items():
+        if not v or k in keys:
+            continue
+        q.append((k, str(v)))
+    return urlunsplit((split.scheme, split.netloc, split.path, urlencode(q), split.fragment))
+
+
+def install_instance_theme_static(app) -> None:
+    """仓库根 static/instance_theme.* 供四所页面共用。"""
+    import os
+
+    from flask import Response, send_file
+
+    repo_static = os.path.join(os.path.dirname(os.path.abspath(__file__)), "static")
+    assets = {
+        "instance_theme.js": "application/javascript; charset=utf-8",
+        "instance_theme.css": "text/css; charset=utf-8",
+    }
+
+    for name, mime in assets.items():
+        path = os.path.join(repo_static, name)
+
+        def _view(p=path, m=mime):
+            if not os.path.isfile(p):
+                return Response("not found", status=404, mimetype="text/plain; charset=utf-8")
+            return send_file(p, mimetype=m)
+
+        app.add_url_rule(
+            f"/static/{name}",
+            endpoint=f"repo_static_{name.replace('.', '_')}",
+            view_func=_view,
+        )
+
+
 def _hub_auth_required(f):
     @wraps(f)
     def wrapped(*args, **kwargs):
@@ -149,6 +189,7 @@ def install_on_app(
     }
     install_hub_embed_headers(app)
     configure_hub_embed_session(app)
+    install_instance_theme_static(app)
     register_hub_routes(app)
 
 
@@ -421,11 +462,22 @@ def register_hub_routes(app):
             if _sso_wants_embed_auth() and request.is_secure:
                 boot = mint_hub_embed_bootstrap(ex, next_path)
                 if boot:
-                    q = urlencode({"t": boot, "next": next_path, "embed": "1"})
-                    return redirect(f"/hub-embed-auth?{q}")
+                    from urllib.parse import urlencode as _ue
+
+                    qdict = {"t": boot, "next": next_path, "embed": "1"}
+                    ht0 = (request.args.get("hub_theme") or "").strip().lower()
+                    if ht0 in ("light", "dark"):
+                        qdict["hub_theme"] = ht0
+                    return redirect(f"/hub-embed-auth?{_ue(qdict)}")
             session["logged_in"] = True
             session.modified = True
-            return redirect(next_path)
+            dest = next_path
+            if request.args.get("embed", "").strip().lower() in ("1", "true", "yes", "on"):
+                dest = _merge_query_into_path(dest, embed="1")
+            ht = (request.args.get("hub_theme") or "").strip().lower()
+            if ht in ("light", "dark"):
+                dest = _merge_query_into_path(dest, hub_theme=ht)
+            return redirect(dest)
         hint = err or "校验失败"
         flash(
             f"中控 SSO 未生效（{hint}）。"
@@ -449,7 +501,13 @@ def register_hub_routes(app):
         if ok:
             session["logged_in"] = True
             session.modified = True
-            return redirect(next_path)
+            dest = next_path
+            if request.args.get("embed", "").strip().lower() in ("1", "true", "yes", "on"):
+                dest = _merge_query_into_path(dest, embed="1")
+            ht = (request.args.get("hub_theme") or "").strip().lower()
+            if ht in ("light", "dark"):
+                dest = _merge_query_into_path(dest, hub_theme=ht)
+            return redirect(dest)
         hint = err or "校验失败"
         flash(f"iframe 登录未生效（{hint}）。可点本地导航工具栏「实例免密」重试。")
         return redirect("/login")