diff --git a/.env.dev b/.env.dev
index a1b118e..b31749e 100644
--- a/.env.dev
+++ b/.env.dev
@@ -5,6 +5,10 @@
 # 规避后端 CAS 过滤器不回 CORS 头导致的跨域拦截；SSO/基础平台用真实环境。
 # VITE_SERVICE_HOST 必须留空：host.config 的 applyConf 跳过空值 → 回落同源兜底（本地路径无上下文段 → ""）；
 # 填远程地址会绕过本地后端直连测试环境（临时联调远程时才改回）
+# 主题通道（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/coursehomework