feat(avatar): 默认头像轮接入（YschTheme sync 件 + 顶栏三态头像）

- src/utils/avatar.ts + src/components/UserAvatar.vue：YschTheme 默认头像轮 sync 下发公共源（取值链 URL > yh-avatar > yh-avatar-sch-default > text）
- layout.vue：顶栏 img 头像换 UserAvatar 三态组件（placement=brand，size=28）；头像/姓名点击统一跳 UserHome 设置页「个人信息」pane（原 /v/userinfo 已下线语义）
- theme.ts/ThemeSwitcher.vue：sync 刷新至 20261006-2013-75c1d10（theme.ts 仅版本戳；ThemeSwitcher 与源仓逐字节一致）
- auto-imports.d.ts：UserAvatar 组件自动登记
当前分支 feat/flow-embed（avatar 轮独立于流程嵌入工作，随分支推送时机一并处理）

src/utils/theme.ts

@@ -1,5 +1,5 @@
 /**
- * 本文件由 YschTheme scripts/gen-theme.mjs 从 assets-src/pc/theme-core.js 生成（版本 20260929-1112-1b1724d），勿手改。
+ * 本文件由 YschTheme scripts/gen-theme.mjs 从 assets-src/pc/theme-core.js 生成（版本 20261006-2013-75c1d10），勿手改。
  * 分发方式：YschTheme `npm run sync` 拷进各端 src/utils/theme.ts（与 ThemeSwitcher.vue 配套，MD5 对齐报告）。
  * 运行时档位类名由 /static/js/yh-theme-init.js 在 <head> 内先行挂好，本模块只负责读写与切换。
  */
@@ -25,6 +25,9 @@ export const THEME_NAMES: readonly ThemeName[] = ["blue", "ocean", "ink", "viole
 
 export const THEME_STORAGE_KEY = "yh-theme";
 
+/* 学校默认档存储键（UserHome 登录时写入；值格式与 yh-theme 完全相同，仅无"用户自选"语义） */
+export const SCHOOL_DEFAULT_STORAGE_KEY = "yh-theme-sch-default";
+
 export const DEFAULT_THEME_STATE: ThemeState = {
   theme: "blue",
   sideDeep: true,
@@ -49,6 +52,75 @@ export function parseThemeState(raw: string | null): ThemeState {
   }
 }
 
+/** 严格读取：四字段全部合法才返回状态，否则 null（合成链"值非法→回落下一级"用；用户键仍走宽松解析保现状） */
+function readThemeStateOrNull(raw: string | null): ThemeState | null {
+  if (!raw) return null;
+  try {
+    const o = JSON.parse(raw);
+    if (!o || typeof o !== "object") return null;
+    if (!THEME_NAMES.includes(o.theme)) return null;
+    if (typeof o.sideDeep !== "boolean" || typeof o.gradOn !== "boolean" || typeof o.sideFollow !== "boolean") return null;
+    return { theme: o.theme, sideDeep: o.sideDeep, gradOn: o.gradOn, sideFollow: o.sideFollow };
+  } catch {
+    return null;
+  }
+}
+
+/** URL 覆盖参数（?yh-theme= / ?yh-side=deep|light / ?yh-grad=on|off）：仅预览/排障用，
+    非法值忽略（对应字段不覆盖），且只影响"读哪一档"、绝不写回 localStorage。 */
+function readThemeOverrides(): { theme?: ThemeName; sideDeep?: boolean; gradOn?: boolean } | null {
+  let out = null;
+  try {
+    const search = (globalThis.location && globalThis.location.search) || "";
+    const get = (name) => {
+      const m = new RegExp("[?&]" + name + "=([^&]*)").exec(search);
+      return m ? decodeURIComponent(m[1]) : null;
+    };
+    const t = get("yh-theme");
+    if (t && THEME_NAMES.includes(t)) {
+      out = out || {};
+      out.theme = t;
+    }
+    const s = get("yh-side");
+    if (s === "deep" || s === "light") {
+      out = out || {};
+      out.sideDeep = s === "deep";
+    }
+    const g = get("yh-grad");
+    if (g === "on" || g === "off") {
+      out = out || {};
+      out.gradOn = g === "on";
+    }
+  } catch {
+    /* 无 location 环境（测试/SSR）：无覆盖 */
+  }
+  return out;
+}
+
+/**
+ * 生效档合成（唯一实现，init 启动段与 UserHome theme.ts 共用）：
+ *   URL 覆盖 > localStorage["yh-theme"]（用户自选，存在即用——宽松修补，与历史行为一致）
+ *   > localStorage["yh-theme-sch-default"]（学校默认，整体合法才生效）
+ *   > DEFAULT_THEME_STATE。
+ * 键不存在/解析失败/值非法均静默回落，不报错不阻塞首帧。
+ */
+export function resolveEffectiveThemeState(storage: StorageLike | undefined = globalThis.localStorage): ThemeState {
+  let state = null;
+  if (storage) {
+    const userRaw = storage.getItem(THEME_STORAGE_KEY);
+    if (userRaw) state = parseThemeState(userRaw);
+    if (!state) state = readThemeStateOrNull(storage.getItem(SCHOOL_DEFAULT_STORAGE_KEY));
+  }
+  if (!state) state = { ...DEFAULT_THEME_STATE };
+  const ov = readThemeOverrides();
+  if (ov) {
+    if (ov.theme) state = { ...state, theme: ov.theme };
+    if (ov.sideDeep != null) state = { ...state, sideDeep: ov.sideDeep };
+    if (ov.gradOn != null) state = { ...state, gradOn: ov.gradOn };
+  }
+  return state;
+}
+
 export function loadThemeState(storage: StorageLike | undefined = globalThis.localStorage): ThemeState {
   if (!storage) return { ...DEFAULT_THEME_STATE };
   return parseThemeState(storage.getItem(THEME_STORAGE_KEY));