feat: 外观支持自定义 CSS/JS,并升级发帖工作台与积分存量看板
后台可注入全站 CSS/JS(SSR 生效,CSS 可热换);发帖/编辑改为锁一屏工作室;经济看板增加存量健康度;主题令牌与弹层误关一并收紧。 Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
@@ -4,39 +4,52 @@ import { useEffect, useRef } from "react";
|
||||
import { usePathname } from "next/navigation";
|
||||
import { apiGetSettings } from "@/lib/api";
|
||||
import { applyAccentTheme } from "@/lib/theme";
|
||||
import { applyCustomCSS } from "@/lib/customCode";
|
||||
import { realtime, RT_SETTINGS_CHANGED, type RtSettingsData } from "@/lib/realtime";
|
||||
import {
|
||||
VISIBLE_RECONCILE_GAP_MS,
|
||||
onDocumentVisible,
|
||||
} from "@/lib/visibilityReconcile";
|
||||
|
||||
// 站点主题色同步器:
|
||||
// 主题色由管理员在后台修改后,其他用户已打开的标签页不会因软导航重新执行根布局
|
||||
// SSR,本组件通过 WS 推送 + 标签页重新可见时探测公开设置,发现变化即热替换
|
||||
// accent CSS 变量(复用 lib/theme 的运行时 style 节点),无需 F5 即可换肤。
|
||||
// 焦点/可见性事件可能短时间连续触发,限制实际请求间隔
|
||||
// 站点外观同步器:
|
||||
// 主题色 / 自定义 CSS 由管理员在后台修改后,其他用户已打开的标签页不会因软导航重新执行根布局
|
||||
// SSR,本组件通过 WS 推送 + 标签页重新可见时探测公开设置,发现变化即热替换。
|
||||
// 自定义 JS 只在整页加载时执行,不在此热替换(避免重复绑定)。
|
||||
const MIN_FETCH_GAP_MS = VISIBLE_RECONCILE_GAP_MS;
|
||||
|
||||
export default function ThemeSync({ initialAccent }: { initialAccent: string }) {
|
||||
export default function ThemeSync({
|
||||
initialAccent,
|
||||
initialCustomCSS,
|
||||
}: {
|
||||
initialAccent: string;
|
||||
initialCustomCSS: string;
|
||||
}) {
|
||||
const pathname = usePathname();
|
||||
// 当前已应用的已保存色(空串=内置默认);与 SSR 注入的 style 节点保持一致
|
||||
const currentRef = useRef((initialAccent || "").trim().toLowerCase());
|
||||
const cssRef = useRef((initialCustomCSS || "").trim());
|
||||
const lastFetchAtRef = useRef(0);
|
||||
const inFlightRef = useRef(false);
|
||||
|
||||
useEffect(() => {
|
||||
// 外观设置页存在"未保存的本地实时预览",该页面内暂停同步,
|
||||
// 避免 HTTP 校准覆盖管理员正在预览的颜色;离开页面后 effect 重跑立即对齐
|
||||
// 外观设置页存在未保存的本地实时预览,暂停同步避免覆盖草稿
|
||||
if (pathname?.startsWith("/admin/appearance")) return;
|
||||
|
||||
let cancelled = false;
|
||||
|
||||
const apply = (next: string) => {
|
||||
const applyAccent = (next: string) => {
|
||||
if (cancelled || next === currentRef.current) return;
|
||||
currentRef.current = next;
|
||||
applyAccentTheme(next || null);
|
||||
};
|
||||
|
||||
const applyCSS = (next: string) => {
|
||||
if (cancelled) return;
|
||||
const text = (next || "").trim();
|
||||
if (text === cssRef.current) return;
|
||||
cssRef.current = text;
|
||||
applyCustomCSS(text);
|
||||
};
|
||||
|
||||
const sync = async () => {
|
||||
if (inFlightRef.current) return;
|
||||
const now = Date.now();
|
||||
@@ -44,25 +57,24 @@ export default function ThemeSync({ initialAccent }: { initialAccent: string })
|
||||
lastFetchAtRef.current = now;
|
||||
inFlightRef.current = true;
|
||||
try {
|
||||
// no-store:必须拿到管理员刚保存的最新值,不能走浏览器缓存
|
||||
const { accent } = await apiGetSettings();
|
||||
const settings = await apiGetSettings();
|
||||
if (cancelled) return;
|
||||
apply((accent || "").trim().toLowerCase());
|
||||
applyAccent((settings.accent || "").trim().toLowerCase());
|
||||
applyCSS(settings.custom_css || "");
|
||||
} catch {
|
||||
// 主题同步失败静默处理,下次回前台再试,不打扰用户
|
||||
// 同步失败静默,下次回前台再试
|
||||
} finally {
|
||||
inFlightRef.current = false;
|
||||
}
|
||||
};
|
||||
|
||||
// WebSocket 推送优先:管理员保存即换肤;回前台 HTTP 校准兜底
|
||||
const offPush = realtime.on<RtSettingsData>(RT_SETTINGS_CHANGED, (data) => {
|
||||
if (data) apply((data.accent || "").trim().toLowerCase());
|
||||
if (!data) return;
|
||||
applyAccent((data.accent || "").trim().toLowerCase());
|
||||
if (typeof data.custom_css === "string") applyCSS(data.custom_css);
|
||||
});
|
||||
|
||||
// 仅 visibility:window focus 与 visibility 常连发,统一走限频即可
|
||||
const offVisible = onDocumentVisible(() => void sync(), MIN_FETCH_GAP_MS);
|
||||
// 离开外观页等 pathname 变化时立刻对齐一次(受 MIN_FETCH_GAP 限频)
|
||||
void sync();
|
||||
|
||||
return () => {
|
||||
|
||||
Reference in New Issue
Block a user