diff --git a/.env.dev b/.env.dev
index dfb42e7..39cdb71 100644
--- a/.env.dev
+++ b/.env.dev
@@ -5,6 +5,10 @@
 # 规避后端 CAS 过滤器不回 CORS 头导致的跨域拦截；SSO/基础平台用真实环境。
 # ⚠️ VITE_SERVICE_HOST 必须留空：host.config 设计约定 dev 模式走同源代理，
 #    配置远端地址会导致浏览器直连被 CAS 过滤器拦截（无 CORS 头），全部请求失败
+# 主题通道（A 类免插件接入 §2）：index.html 的 loader 与 vite.config.ts 的 /static 代理已就位，
+# 本地 dev 的 /static/** 由代理兜到线上通道；联调本地通道源时用环境变量覆盖代理目标：
+#   YH_THEME_PROXY_TARGET=http://localhost:9527 npm run dev
+
 VITE_BASE_HOST=http://base.yunhaixingtong.com
 VITE_SSO_HOST=http://sso.yunhaixingtong.com
 VITE_SERVICE_HOST=http://base.yunhaixingtong.com/familyactivity/