Merge remote-tracking branch 'origin/master' into ji

frontend-web/src/core/auth/external-login.ts

@@ -51,7 +51,14 @@ export function readExternalLoginParams(): Required<ExternalLoginParams> {
   }
 }
 
-/** 把 ``theme`` query 值映射成 ThemeContext 的 ``'dark' | 'light'`` */
+/**
+ * 把外部(URL query / 无界 props)的 ``theme`` 值映射成 ThemeContext 的
+ * ``'dark' | 'light'``。已知取值:
+ *   - ``dark-blue`` → 深色
+ *   - ``red``       → 浅色(当前默认红白主题)
+ *   - ``blue``      → 暂无该主题,先用浅色代替(命中 else 分支)
+ * 其余/缺省同样回退浅色。将来若新增 blue 主题,在此扩展映射即可。
+ */
 export function resolveThemeFromQuery(themeParam: string | null | undefined): "dark" | "light" {
   return themeParam === "dark-blue" ? "dark" : "light";
 }