diff --git a/frontend-web/.env.example b/frontend-web/.env.example
new file mode 100644
index 00000000..06579a79
--- /dev/null
+++ b/frontend-web/.env.example
@@ -0,0 +1,6 @@
+# 复制为 .env 后按需修改（Vite 仅暴露以 VITE_ 开头的变量）
+# 直连本机 Gateway 时使用；若浏览器报 CORS，请在网关环境设置 CORS_ORIGINS，包含前端源站，例如：
+#   CORS_ORIGINS=http://127.0.0.1:5173,http://localhost:5173
+
+VITE_BACKEND_BASE_URL=http://127.0.0.1:8001
+VITE_LANGGRAPH_BASE_URL=http://127.0.0.1:8001/api