外观偏好异步补齐C：YschTheme sync 件更新（UserAvatar 监听 yh-appearance-updated 重读键 + theme.ts 版本戳 20261008-1831-d9db725）

- .logo-badge img 改动态 src：localStorage["yh-logo-url"]（yh-theme-init 异步补齐段写入）优先，本仓 yunhai-logo.svg 兜底，@error 回落兜底——绝无空 src/裂图
- mounted 读一次 + 监听 yh-appearance-updated 即时切换（无需刷新）

src/api/module/notice.ts

@@ -127,6 +127,10 @@ class NoticeApi {
     flowWithdraw(serid: number) {
         return postForm<void>(`${NOTICE}/flow/Withdraw`, { serid });
     }
+    /** 办件进度嵌入页地址（Drawer iframe 直嵌；pageUrl 含短时 token 现取现发，勿缓存复用） */
+    flowEmbed(serid: number) {
+        return get<{ pageUrl: string }>(`${NOTICE}/flow/Embed`, { serid });
+    }
     /** 应用级流程绑定（应用设置 > 流程绑定；发通知页据此判断「提交审核」还是「发送」） */
     getFlowBinding() {
         return get<FlowBindingVo>(`${NOTICE}/flow/Binding`);

src/components/UserAvatar.vue

@@ -0,0 +1,102 @@
+<script lang="ts" setup>
+/* 默认头像三态组件（YschTheme 公共源，scripts/sync-apps.mjs 下发三端 src/components/UserAvatar.vue）：
+   头像 URL 非空 → <img>；否则 style==="text" 且能取到字 → 首字；否则 → 剪影（纯 CSS/SVG，零资源文件）。
+   取值链/取字契约见《设置页修复与默认头像落地方案》§10.1/§10.2；样式全在本文件 <style scoped>（唯一 CSS 源，
+   不进通道 icons.src.css——通道 CSS 对 UserHome 不可达，内联分发才能消双份漂移，见同方案 §10.4）。
+   根元素即 .yh-avatar 圆：尺寸内联必须挂圆本身（挂外层 span 会被 flex 拉成椭圆，§12 踩坑）。 */
+import { computed, onBeforeUnmount, onMounted, ref } from "vue";
+import { pickAvatarText, resolveAvatarStyle } from "@/utils/avatar";
+
+const props = withDefaults(
+    defineProps<{
+        /** 头像 URL：非空直接 <img>（三态第一优先） */
+        src?: string | null;
+        /** 取字来源（首字态用）：经 pickAvatarText 判定，取不到字回落剪影 */
+        name?: string | null;
+        /** 直径 px；font-size = round(size * 0.44) */
+        size?: number;
+        /** 配色场景：light=页面浅底（品牌实底+白内容）；brand=header 品牌色底（剪影 S1 玻璃底 / 首字 S2 白底反色，§10.3 分档） */
+        placement?: "light" | "brand";
+    }>(),
+    { src: null, name: null, size: 28, placement: "light" },
+);
+
+const text = computed(() => (props.src ? "" : pickAvatarText(props.name)));
+/* 外观偏好异步补齐（yh-theme-init 在挂载后拉服务端真源收敛 localStorage 键）会在
+   document 上派发 yh-appearance-updated；tick 自增让 style 依赖失效重读键，三态即时切换（无需刷新）。 */
+const appearanceTick = ref(0);
+const onAppearanceUpdated = () => { appearanceTick.value += 1; };
+onMounted(() => document.addEventListener("yh-appearance-updated", onAppearanceUpdated));
+onBeforeUnmount(() => document.removeEventListener("yh-appearance-updated", onAppearanceUpdated));
+const style = computed(() => {
+    appearanceTick.value;
+    return resolveAvatarStyle();
+});
+/** 首字态 = style==="text" 且能取到字（契约 §10.2：二者缺一即剪影，取到字但档位是剪影时绝不能出字） */
+const showText = computed(() => style.value === "text" && !!text.value);
+
+const rootClass = computed(() => [
+    "yh-avatar",
+    props.placement === "brand" ? "yh-avatar--brand" : "yh-avatar--light",
+    { "is-text": showText.value },
+]);
+
+const rootStyle = computed(() => ({
+    width: `${props.size}px`,
+    height: `${props.size}px`,
+    fontSize: `${Math.round(props.size * 0.44)}px`,
+}));
+</script>
+
+<template>
+    <span :class="rootClass" :style="rootStyle">
+        <img v-if="src" class="yh-avatar__img" :src="src" alt="" />
+        <template v-else-if="showText">{{ text }}</template>
+        <svg v-else class="yh-avatar__sil" viewBox="0 0 1024 1024" aria-hidden="true">
+            <circle cx="512" cy="399" r="174" />
+            <ellipse cx="512" cy="946" rx="420" ry="240" />
+        </svg>
+    </span>
+</template>
+
+<style scoped>
+.yh-avatar {
+    position: relative;
+    border-radius: 50%;
+    overflow: hidden;
+    display: inline-grid;
+    place-items: center;
+    flex: 0 0 auto;
+    font-weight: 600;
+    line-height: 1;
+    user-select: none;
+}
+.yh-avatar__img {
+    width: 100%;
+    height: 100%;
+    object-fit: cover;
+    display: block;
+}
+/* 剪影 SVG：容器圆 overflow:hidden 裁切肩部溢出（禁用 clipPath）；overflow:visible 放行 viewBox 外形状 */
+.yh-avatar__sil {
+    display: block;
+    width: 100%;
+    height: 100%;
+    overflow: visible;
+    fill: currentColor;
+}
+/* 页面内（浅底）——品牌实底 + 白内容 */
+.yh-avatar--light {
+    background: var(--brand, #577afb);
+    color: #fff;
+}
+/* header（品牌色底）——与页面内反向：剪影档 = S1 半透明白，首字档 = S2 纯白底 + 品牌色字 */
+.yh-avatar--brand {
+    background: rgba(255, 255, 255, 0.22);
+    color: #fff;
+}
+.yh-avatar--brand.is-text {
+    background: #fff;
+    color: var(--brand, #577afb);
+}
+</style>

src/components/layout.vue

@@ -1,9 +1,11 @@
 <script setup lang="ts">
-import { ref, onBeforeMount, watch, computed } from "vue";
+import { ref, onBeforeMount, onBeforeUnmount, onMounted, watch, computed } from "vue";
 import { useRoute, useRouter } from "vue-router";
 import { Message } from "view-ui-plus";
 import { resolveMenuPage } from "@/utils/menuRoute";
 import ThemeSwitcher from "@/components/ThemeSwitcher.vue";
+import UserAvatar from "@/components/UserAvatar.vue";
+import defaultLogo from "@/assets/image/yunhai-logo.svg";
 
 const props = defineProps<{ layoutData: Record<string, any> }>();
 const route = useRoute();
@@ -23,6 +25,27 @@ const modList = computed(() => props.layoutData?.modList || []);
 
 const pathNavStyle = computed(() => (isAlone.value ? { left: "0", width: "100%" } : null));
 
+// 顶栏 Logo：localStorage["yh-logo-url"]（平台键，yh-theme-init 异步补齐段写入）优先，本仓资产兜底——绝无空 src/裂图。
+// 刷新：mounted 读一次 + 监听 yh-appearance-updated（服务端偏好到达后即时切换，无需刷新页面）。
+const logoUrl = ref<string>(defaultLogo);
+const readLogoUrl = () => {
+    let v: string | null = null;
+    try {
+        v = localStorage.getItem("yh-logo-url");
+    } catch {
+        v = null;
+    }
+    logoUrl.value = v || defaultLogo;
+};
+const onLogoError = () => {
+    if (logoUrl.value !== defaultLogo) logoUrl.value = defaultLogo;
+};
+onMounted(() => {
+    readLogoUrl();
+    document.addEventListener("yh-appearance-updated", readLogoUrl);
+});
+onBeforeUnmount(() => document.removeEventListener("yh-appearance-updated", readLogoUrl));
+
 onBeforeMount(() => {
     routeChange(route);
 });
@@ -121,7 +144,8 @@ const linkMenu = (item: any) => {
 };
 
 const linkUserInfo = () => {
-    window.location.href = baseHost.value + "/v/userinfo";
+    // 头像/姓名点击统一跳 UserHome 设置页「个人信息」pane（默认头像轮 2026-09-30，原 /v/userinfo 已下线语义）
+    window.location.href = baseHost.value + "/userhome/front/index.html#/settings?pane=profile";
 };
 const logout = () => {
     let url = window.location.href;
@@ -157,12 +181,12 @@ function linkHomePage() {
     <div class="layout-wrap">
         <header class="header-container fix">
             <!-- 云海 logo 徽标（结构与 Cms SchoolLayout 对齐，皮肤见通道 base.layout.css .logo-badge） -->
-            <span class="logo-badge fl"><img src="@/assets/image/yunhai-logo.svg" alt="云海" /></span>
+            <span class="logo-badge fl"><img :src="logoUrl" alt="云海" @error="onLogoError" /></span>
             <div class="delimiter fl align-middle"></div>
             <h4 class="fl align-middle">{{ appName }}</h4>
             <div class="school-bg"></div>
             <div class="header-aside fr">
-                <img :src="userInfo.avatar" v-if="userInfo.avatar" class="fl align-middle" @click="linkUserInfo" />
+                <UserAvatar class="fl align-middle" :src="userInfo.avatar" :name="userInfo.name" :size="28" placement="brand" @click="linkUserInfo" />
                 <a class="name fl align-middle text-ellipsis" href="javascript:void(0);" @click="linkUserInfo">
                     {{ userInfo.name }}
                 </a>

src/utils/avatar.ts

@@ -0,0 +1,94 @@
+/**
+ * 默认头像样式（首字 / 剪影）公共源（YschTheme，scripts/sync-apps.mjs 下发三端 src/utils/avatar.ts）。
+ * 取值链与主题同构（theme-core.js resolveEffectiveThemeState 的合成链写法）：
+ *   URL ?yh-avatar=text|silhouette（仅预览/排障覆盖：只影响读、绝不写回）
+ *     > localStorage["yh-avatar"]（用户自选，纯字符串）
+ *     > localStorage["yh-avatar-sch-default"]（学校默认，UserHome 登录后写入）
+ *     > "text"（系统默认）
+ * 值域恒为 "text" | "silhouette"，键缺失/值非法均静默回落下一级，不报错不阻塞渲染。
+ * 渲染三态与取字规则的唯一契约见 UserHome《设置页修复与默认头像落地方案》§10.1/§10.2。
+ */
+
+export type AvatarStyle = "text" | "silhouette";
+
+interface StorageLike {
+    getItem(k: string): string | null;
+    setItem(k: string, v: string): void;
+    removeItem(k: string): void;
+}
+
+export const AVATAR_STORAGE_KEY = "yh-avatar";
+
+/** 学校默认头像存储键（UserHome 登录时写入；值格式与用户键相同，仅无"用户自选"语义） */
+export const SCHOOL_DEFAULT_AVATAR_STORAGE_KEY = "yh-avatar-sch-default";
+
+export const AVATAR_STYLES: readonly AvatarStyle[] = ["text", "silhouette"];
+
+export const DEFAULT_AVATAR_STYLE: AvatarStyle = "text";
+
+/** 值合法才采用（用户键/学校键同一判据；脏数据不生效） */
+function readAvatarStyleOrNull(raw: string | null): AvatarStyle | null {
+    return raw === "text" || raw === "silhouette" ? raw : null;
+}
+
+/** URL 覆盖参数（?yh-avatar=text|silhouette）：非法值忽略，且只影响"读哪一档"、绝不写回 localStorage */
+function readAvatarOverride(): AvatarStyle | null {
+    try {
+        const search = (globalThis.location && globalThis.location.search) || "";
+        const m = new RegExp("[?&]yh-avatar=([^&]*)").exec(search);
+        return m ? readAvatarStyleOrNull(decodeURIComponent(m[1])) : null;
+    } catch {
+        /* 无 location 环境（测试/SSR）：无覆盖 */
+        return null;
+    }
+}
+
+/**
+ * 生效样式合成（与 resolveEffectiveThemeState 同构）：
+ *   URL 覆盖 > localStorage["yh-avatar"]（用户自选）> localStorage["yh-avatar-sch-default"]（学校默认）
+ *   > DEFAULT_AVATAR_STYLE。
+ */
+export function resolveAvatarStyle(storage: StorageLike | undefined = globalThis.localStorage): AvatarStyle {
+    let style: AvatarStyle | null = null;
+    if (storage) {
+        style = readAvatarStyleOrNull(storage.getItem(AVATAR_STORAGE_KEY));
+        if (!style) style = readAvatarStyleOrNull(storage.getItem(SCHOOL_DEFAULT_AVATAR_STORAGE_KEY));
+    }
+    if (!style) style = DEFAULT_AVATAR_STYLE;
+    return readAvatarOverride() || style;
+}
+
+/** 保存用户自选（直写 localStorage，无响应式；调用方操作后自行刷新 UI） */
+export function saveAvatarStyle(style: AvatarStyle, storage: StorageLike | undefined = globalThis.localStorage): void {
+    try {
+        storage?.setItem(AVATAR_STORAGE_KEY, style);
+    } catch {
+        /* 隐私模式/配额失败静默：仅丢持久化，不丢本次会话生效 */
+    }
+}
+
+/** 跟随学校默认 = 删用户自选键（之后回落学校默认/系统默认） */
+export function clearAvatarStyle(storage: StorageLike | undefined = globalThis.localStorage): void {
+    try {
+        storage?.removeItem(AVATAR_STORAGE_KEY);
+    } catch {
+        /* 隐私模式静默 */
+    }
+}
+
+/**
+ * 取字（顺序判定，先命中先返回）：含 "@" 先截 "@" 前段（邮箱取首字母）；
+ * 首字符必须用展开 [...s][0]（禁用 charAt(0)，避免代理对截半出乱码）。
+ * ASCII 字母转大写；纯数字回落 ""（剪影）；符号/emoji/空白回落 ""（剪影）；其余（CJK 等）原样。
+ */
+export function pickAvatarText(name: string | null | undefined): string {
+    let s = String(name ?? "");
+    const at = s.indexOf("@");
+    if (at > -1) s = s.slice(0, at);
+    const ch = [...s.trim()][0];
+    if (ch === undefined) return "";
+    if (/^[A-Za-z]$/.test(ch)) return ch.toUpperCase();
+    if (/^[0-9]$/.test(ch)) return "";
+    if (/^[\p{P}\p{S}\s]$/u.test(ch)) return "";
+    return ch;
+}

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 生成（版本 20261008-1831-d9db725），勿手改。
  * 分发方式：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));

src/views/notice/NoticeDetails.vue

@@ -90,6 +90,24 @@ function onDiagramError() {
     diagramVisible.value = false;
     Message.error("流程图加载失败（可能已过期，请刷新页面重试）");
 }
+
+/* 办件进度嵌入页（iframe 免签嵌入 flow-center 统一进度页）：每次打开现取 pageUrl——
+ * token 10 分钟短时效，不缓存、不落 localStorage 复用；嵌入页内部自己滚动 */
+const embedVisible = ref(false);
+const embedPageUrl = ref("");
+async function openFlowEmbed() {
+    if (!detail.value?.flowInstanceId) return;
+    embedVisible.value = true;
+    embedPageUrl.value = "";
+    try {
+        const res = await noticeApi.flowEmbed(serid.value).send();
+        embedPageUrl.value = res?.pageUrl || "";
+    } catch (e: any) {
+        embedVisible.value = false;
+        Message.error(e?.msg || e?.message || "嵌入页地址获取失败");
+    }
+}
+
 const readGroups = ref<ReadGroup[]>([]);
 const showRead = ref(false);
 const prevId = ref(0);
@@ -265,6 +283,13 @@ function openPreview(item: { name?: string; filename?: string; fileid?: number;
                 <span v-if="flowTrace.currentNodes" class="flow-nodes">当前节点：{{ flowTrace.currentNodes }}</span>
                 <div class="flow-ops">
                     <Button v-if="detail.flowGuid" size="small" @click="openFlowDiagram">查看流程图</Button>
+                    <Button
+                        v-if="detail.flowInstanceId"
+                        size="small"
+                        style="margin-left: 8px"
+                        @click="openFlowEmbed"
+                        >审批进度</Button
+                    >
                     <Button
                         v-if="detail.flowInstanceId && flowTrace.auditStatus === 10"
                         size="small"
@@ -324,6 +349,13 @@ function openPreview(item: { name?: string; filename?: string; fileid?: number;
             </div>
         </Modal>
 
+        <!-- 办件进度嵌入页（Drawer 内 iframe 撑满，嵌入页内部滚动；token 每次打开现取） -->
+        <Drawer v-model="embedVisible" title="审批进度" :width="860" :transfer="false" :styles="{ body: { padding: '0' } }">
+            <div class="embed-frame-wrap">
+                <iframe v-if="embedPageUrl" :src="embedPageUrl" title="办件进度"></iframe>
+            </div>
+        </Drawer>
+
         <div v-if="viewType !== 0" class="meta">
             <span>发文单位：{{ detail.DeptName || "—" }}</span>
             <span>发布人：{{ detail.TeaName || "—" }}</span>
@@ -480,6 +512,16 @@ function openPreview(item: { name?: string; filename?: string; fileid?: number;
 .diagram-wrap img {
     max-width: 100%;
 }
+/* 嵌入页 iframe 撑满 Drawer body（body padding 已由 :styles 置 0），嵌入页内部滚动 */
+.embed-frame-wrap {
+    height: 100%;
+}
+.embed-frame-wrap iframe {
+    display: block;
+    width: 100%;
+    height: 100%;
+    border: 0;
+}
 .meta {
     display: flex;
     flex-wrap: wrap;