diff --git a/.env.local b/.env.local
index 35765584d..36252e93f 100644
--- a/.env.local
+++ b/.env.local
@@ -30,5 +30,7 @@ VITE_MALL_H5_DOMAIN='http://localhost:3000'
 # 验证码的开关
 VITE_APP_CAPTCHA_ENABLE=false
 
-# GoView域名
+# 大屏设计器（GoView）独立前端地址：需另起仓库 yudao-ui-go-view（pnpm dev，默认端口 3000）
+# 仓库：https://gitee.com/yudaocode/yudao-ui-go-view  文档：https://doc.iocoder.cn/report/screen/
+# 若 GoView 改端口，请同步修改此处，并保证与芋道后端的跨域、Token 配置按 go-view 项目说明一致
 VITE_GOVIEW_URL='http://127.0.0.1:3000'
\ No newline at end of file
diff --git a/src/views/report/goview/index.vue b/src/views/report/goview/index.vue
index 1ec8c29b0..c1bf5ef85 100644
--- a/src/views/report/goview/index.vue
+++ b/src/views/report/goview/index.vue
@@ -1,6 +1,26 @@
 <template>
   <doc-alert title="大屏设计器" url="https://doc.iocoder.cn/report/screen/" />
 
+  <el-alert
+    class="!mb-12px"
+    type="warning"
+    show-icon
+    :closable="false"
+    title="本页为 iframe 嵌入「GoView 大屏」独立前端，与当前管理端不是同一个进程。"
+  >
+    <template #default>
+      <p class="m-0 leading-relaxed">
+        若出现「127.0.0.1 拒绝连接」，请先克隆并启动
+        <el-link type="primary" href="https://gitee.com/yudaocode/yudao-ui-go-view" target="_blank">
+          yudao-ui-go-view
+        </el-link>
+        ：在项目根目录执行 <code>pnpm install</code> 与 <code>pnpm dev</code>，默认地址
+        <strong>http://127.0.0.1:3000</strong>。若修改端口，请在 <code>.env.local</code> 中调整
+        <code>VITE_GOVIEW_URL</code> 与 go-view 项目内对接后端的配置。
+      </p>
+    </template>
+  </el-alert>
+
   <ContentWrap :bodyStyle="{ padding: '0px' }" class="!mb-0">
     <IFrame :src="src" />
   </ContentWrap>