diff --git a/.env.dev b/.env.dev
index 359f483..d6d22a5 100644
--- a/.env.dev
+++ b/.env.dev
@@ -3,6 +3,10 @@
 # ⚠️ VITE_* 仅本地开发生效。
 # API 走 /api 同源相对路径（vite proxy 转发到本地后端 8101），
 # 规避后端 CAS 过滤器不回 CORS 头导致的跨域拦截；SSO/基础平台用真实环境
+# 主题通道（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/campusnotice/