diff --git a/src/assets/config/host.config.ts b/src/assets/config/host.config.ts
index 7d0afd3..df07b39 100644
--- a/src/assets/config/host.config.ts
+++ b/src/assets/config/host.config.ts
@@ -69,4 +69,30 @@ try {
     /* 无运行时配置时沿用兜底 */
 }
 
+/**
+ * 回写 __APP_CONFIG__.serviceHost（仅同源场景）。
+ * 主题通道 yh-theme-init.js 的 appearance 请求有硬性同源限制：
+ *   if (!url || !appearanceSameOrigin(url)) return;  → 跨源会被直接跳过、连请求都不发。
+ * 本地 dev：serviceUrl 是 VITE_SERVICE_HOST 的绝对地址（跨源），此时不能回写，
+ *          保持空串让 init 走同源 "/api/appearance"，由 vite 代理转发到后端。
+ * 生产：serviceUrl = 同域 ctx（https://base.../userclass），同源，回写后 init 请求正确前缀。
+ * 已有 env-config 下发值时不动（以平台配置为准）。
+ */
+try {
+    const w = window as any;
+    w.__APP_CONFIG__ = w.__APP_CONFIG__ || {};
+    if (!w.__APP_CONFIG__.serviceHost) {
+        const candidate = conf.serviceUrl || conf.serviceHost || "";
+        let sameOrigin = !candidate;
+        try {
+            sameOrigin = new URL(candidate, window.location.href).origin === window.location.origin;
+        } catch {
+            sameOrigin = false;
+        }
+        if (sameOrigin) w.__APP_CONFIG__.serviceHost = candidate;
+    }
+} catch {
+    /* 极端环境无 window：忽略，保持同源兜底 */
+}
+
 export default conf;
diff --git a/vite.config.ts b/vite.config.ts
index 9047815..761e89f 100644
--- a/vite.config.ts
+++ b/vite.config.ts
@@ -43,6 +43,9 @@ export default defineConfig(({ mode }) => {
             open: false,
             proxy: {
                 // 本地后端：serviceUrl 在 dev 下为空 → /api/* 同源相对，由本代理转发
+                // 想直接连真实后端（含主题通道「同源」的 appearance）：
+                //   YH_API_PROXY_TARGET=http://base.yunhaixingtong.com/userclass npm run dev
+                // 注意 target 要带上下文前缀 /userclass，http-proxy 会把它拼在 /api 前
                 "/api": {
                     target: process.env.YH_API_PROXY_TARGET || "http://localhost:8101",
                     changeOrigin: true,