配置前端三环境变量

.env

@@ -1,14 +0,0 @@
-# 腾讯地图 API Key
-# 请到 https://lbs.qq.com/index.html 申请
-VITE_DATA_SOURCE_MODE=sdk
-VITE_GUIDE_CONTENT_SOURCE_MODE=static
-VITE_API_BASE_URL=/app-api
-VITE_SGS_SDK_TIMEOUT_MS=15000
-VITE_TENCENT_MAP_KEY=EJPBZ-DQEEQ-PDN5U-4ZDVX-F4I3F-6MBJC
-
-# SGS SDK 配置（SDK 模式下必需）
-VITE_SGS_API_BASE_URL=/app-api
-VITE_SGS_MAP_ID=1
-VITE_SGS_SDK_SCRIPT_URL=/static/sgs-map-sdk/index.global.js
-VITE_SGS_H5_ENGINE_URL=/h5-sdk
-VITE_SGS_SDK_ORIGIN=https://guide.whaoyue.com

.env.development

@@ -0,0 +1,27 @@
+# uni-app + Vite 开发环境默认配置。
+# 真实本地接口地址或 key 请放入 .env.development.local。
+
+VITE_APP_PUBLIC_BASE=/
+VITE_DATA_SOURCE_MODE=sdk
+VITE_GUIDE_CONTENT_SOURCE_MODE=static
+VITE_GUIDE_STATIC_DATA_BASE_URL=/static/guide-data
+VITE_API_BASE_URL=/app-api
+VITE_AUDIO_API_BASE_URL=/nhm/audio
+VITE_AUDIO_LANGUAGE=zh-CN
+VITE_SGS_API_BASE_URL=/app-api
+VITE_SGS_MAP_ID=1
+VITE_SGS_SDK_SCRIPT_URL=/static/sgs-map-sdk/index.global.js
+VITE_SGS_H5_ENGINE_URL=/h5-sdk
+VITE_SGS_SDK_ORIGIN=
+VITE_SGS_SDK_TIMEOUT_MS=15000
+VITE_TENCENT_MAP_KEY=__REPLACE_WITH_TENCENT_MAP_WEB_KEY__
+VITE_PUBLIC_SAME_ORIGIN_ASSET_HOST=
+VITE_PUBLIC_LEGACY_AUDIO_HOST=
+
+# Vite 开发服务器代理目标，只由 vite.config.ts 读取。
+DEV_PROXY_APP_API_TARGET=http://localhost:3001
+DEV_PROXY_H5_SDK_TARGET=http://localhost:3001
+DEV_PROXY_SDK_TARGET=http://localhost:3001
+DEV_PROXY_MUSEUM_ASSETS_TARGET=http://localhost:9000
+DEV_PROXY_MINIO_TARGET=http://localhost:3001
+DEV_PROXY_AUDIO_TARGET=http://localhost:19000

.env.example

@@ -1,15 +1,27 @@
-# 腾讯地图 API Key
+# 复制到 .env.development.local、.env.test.local 或 .env.production.local 后填写真实部署值。
-# 请到 https://lbs.qq.com/index.html 申请
+# VITE_ 前缀变量会被打包进前端产物，不应存放后端密钥或私有令牌。
-VITE_TENCENT_MAP_KEY=your_tencent_map_key_here
 
-# 数据源模式：sdk / mock
+VITE_APP_PUBLIC_BASE=/
 VITE_DATA_SOURCE_MODE=sdk
+VITE_GUIDE_CONTENT_SOURCE_MODE=static
+VITE_GUIDE_STATIC_DATA_BASE_URL=/static/guide-data
 VITE_API_BASE_URL=/app-api
-VITE_SGS_SDK_TIMEOUT_MS=15000
+VITE_AUDIO_API_BASE_URL=/yudao-server
-
+VITE_AUDIO_LANGUAGE=zh-CN
-# SGS SDK 配置（生产部署使用同源路径，避免 HTTPS 页面请求 HTTP 后端被浏览器拦截）
 VITE_SGS_API_BASE_URL=/app-api
 VITE_SGS_MAP_ID=1
 VITE_SGS_SDK_SCRIPT_URL=/static/sgs-map-sdk/index.global.js
 VITE_SGS_H5_ENGINE_URL=/h5-sdk
-VITE_SGS_SDK_ORIGIN=https://guide.whaoyue.com
+VITE_SGS_SDK_ORIGIN=
+VITE_SGS_SDK_TIMEOUT_MS=15000
+VITE_TENCENT_MAP_KEY=__REPLACE_WITH_TENCENT_MAP_WEB_KEY__
+VITE_PUBLIC_SAME_ORIGIN_ASSET_HOST=
+VITE_PUBLIC_LEGACY_AUDIO_HOST=
+
+# 仅开发环境使用的 Vite 代理目标，只由 vite.config.ts 读取。
+DEV_PROXY_APP_API_TARGET=http://localhost:3001
+DEV_PROXY_H5_SDK_TARGET=http://localhost:3001
+DEV_PROXY_SDK_TARGET=http://localhost:3001
+DEV_PROXY_MUSEUM_ASSETS_TARGET=http://localhost:9000
+DEV_PROXY_MINIO_TARGET=http://localhost:3001
+DEV_PROXY_AUDIO_TARGET=http://localhost:19000

.env.production

@@ -0,0 +1,19 @@
+# uni-app + Vite 生产环境默认配置。
+# 真实生产值请通过部署平台环境变量或 .env.production.local 覆盖。
+
+VITE_APP_PUBLIC_BASE=/
+VITE_DATA_SOURCE_MODE=sdk
+VITE_GUIDE_CONTENT_SOURCE_MODE=static
+VITE_GUIDE_STATIC_DATA_BASE_URL=/static/guide-data
+VITE_API_BASE_URL=/app-api
+VITE_AUDIO_API_BASE_URL=/yudao-server
+VITE_AUDIO_LANGUAGE=zh-CN
+VITE_SGS_API_BASE_URL=/app-api
+VITE_SGS_MAP_ID=1
+VITE_SGS_SDK_SCRIPT_URL=/static/sgs-map-sdk/index.global.js
+VITE_SGS_H5_ENGINE_URL=/h5-sdk
+VITE_SGS_SDK_ORIGIN=https://guide.sznhmuseum.org.cn
+VITE_SGS_SDK_TIMEOUT_MS=15000
+VITE_TENCENT_MAP_KEY=__REPLACE_WITH_TENCENT_MAP_WEB_KEY__
+VITE_PUBLIC_SAME_ORIGIN_ASSET_HOST=
+VITE_PUBLIC_LEGACY_AUDIO_HOST=

.env.test

@@ -0,0 +1,19 @@
+# uni-app + Vite 测试环境默认配置。
+# 真实测试环境接口地址或 key 请通过部署平台环境变量或 .env.test.local 覆盖。
+
+VITE_APP_PUBLIC_BASE=/
+VITE_DATA_SOURCE_MODE=sdk
+VITE_GUIDE_CONTENT_SOURCE_MODE=static
+VITE_GUIDE_STATIC_DATA_BASE_URL=/static/guide-data
+VITE_API_BASE_URL=/app-api
+VITE_AUDIO_API_BASE_URL=/yudao-server
+VITE_AUDIO_LANGUAGE=zh-CN
+VITE_SGS_API_BASE_URL=/app-api
+VITE_SGS_MAP_ID=1
+VITE_SGS_SDK_SCRIPT_URL=/static/sgs-map-sdk/index.global.js
+VITE_SGS_H5_ENGINE_URL=/h5-sdk
+VITE_SGS_SDK_ORIGIN=https://guide.whaoyue.com
+VITE_SGS_SDK_TIMEOUT_MS=15000
+VITE_TENCENT_MAP_KEY=__REPLACE_WITH_TENCENT_MAP_WEB_KEY__
+VITE_PUBLIC_SAME_ORIGIN_ASSET_HOST=
+VITE_PUBLIC_LEGACY_AUDIO_HOST=

.gitignore

@@ -14,6 +14,10 @@ coverage/
 .env
 .env.local
 .env.*.local
+!.env.example
+!.env.development
+!.env.test
+!.env.production
 .claude/*.local.json
 .claude/worktrees/
 .codex-artifacts/

package.json

@@ -8,10 +8,14 @@
     "node": ">=20 <25"
   },
   "scripts": {
-    "dev:h5": "uni -p h5",
+    "dev:h5": "uni -p h5 --mode development",
-    "build:h5": "uni build -p h5 && node scripts/copy-h5-nav-assets.cjs",
+    "dev:test:h5": "uni -p h5 --mode test",
-    "dev:mp-weixin": "uni -p mp-weixin",
+    "build:test:h5": "uni build -p h5 --mode test && node scripts/copy-h5-nav-assets.cjs",
-    "build:mp-weixin": "uni build -p mp-weixin",
+    "build:h5": "uni build -p h5 --mode production && node scripts/copy-h5-nav-assets.cjs",
+    "dev:mp-weixin": "uni -p mp-weixin --mode development",
+    "dev:test:mp-weixin": "uni -p mp-weixin --mode test",
+    "build:test:mp-weixin": "uni build -p mp-weixin --mode test",
+    "build:mp-weixin": "uni build -p mp-weixin --mode production",
     "type-check": "vue-tsc --noEmit",
     "lint": "eslint \"src/**/*.{ts,vue}\""
   },

src/config/dataSource.ts

@@ -68,7 +68,9 @@ export const dataSourceConfig = {
   sgsSdkScriptUrl: normalizeUrl(import.meta.env.VITE_SGS_SDK_SCRIPT_URL, defaultSdkScriptUrl),
   sgsMapEngineUrl: normalizeUrl(import.meta.env.VITE_SGS_H5_ENGINE_URL, defaultSgsEngineUrl),
   sgsSdkTargetOrigin: import.meta.env.VITE_SGS_SDK_ORIGIN?.trim() || '',
-  sgsSdkTimeoutMs: normalizeTimeout(import.meta.env.VITE_SGS_SDK_TIMEOUT_MS)
+  sgsSdkTimeoutMs: normalizeTimeout(import.meta.env.VITE_SGS_SDK_TIMEOUT_MS),
+  publicSameOriginAssetHost: import.meta.env.VITE_PUBLIC_SAME_ORIGIN_ASSET_HOST?.trim() || '',
+  publicLegacyAudioHost: import.meta.env.VITE_PUBLIC_LEGACY_AUDIO_HOST?.trim() || ''
 }
 
 export const isSgsSdkMode = () => dataSourceConfig.mode === 'sdk'

src/env.d.ts

@@ -1,6 +1,7 @@
 /// <reference types="vite/client" />
 
 interface ImportMetaEnv {
+  readonly VITE_APP_PUBLIC_BASE?: string
   readonly VITE_DATA_SOURCE_MODE?: 'static' | 'api' | 'sdk'
   readonly VITE_GUIDE_CONTENT_SOURCE_MODE?: 'static' | 'remote' | 'mock'
   readonly VITE_GUIDE_STATIC_DATA_BASE_URL?: string
@@ -14,6 +15,8 @@ interface ImportMetaEnv {
   readonly VITE_SGS_SDK_ORIGIN?: string
   readonly VITE_SGS_SDK_TIMEOUT_MS?: string
   readonly VITE_TENCENT_MAP_KEY?: string
+  readonly VITE_PUBLIC_SAME_ORIGIN_ASSET_HOST?: string
+  readonly VITE_PUBLIC_LEGACY_AUDIO_HOST?: string
 }
 
 interface ImportMeta {

src/manifest.json

@@ -55,7 +55,7 @@
     "sdkConfigs": {
       "maps": {
         "qqmap": {
-          "key": "EJPBZ-DQEEQ-PDN5U-4ZDVX-F4I3F-6MBJC"
+          "key": "__REPLACE_WITH_TENCENT_MAP_WEB_KEY__"
         }
       }
     }

src/repositories/GuideModelRepository.ts

@@ -113,7 +113,8 @@ const resolveSgsAssetUrl = (url?: string | null) => {
     try {
       const assetUrl = new URL(normalizedUrl)
       if (
-        assetUrl.hostname === '1.92.206.90'
+        dataSourceConfig.publicSameOriginAssetHost
+        && assetUrl.hostname === dataSourceConfig.publicSameOriginAssetHost
         && assetUrl.port === '9000'
         && assetUrl.pathname.startsWith('/museum-assets/')
       ) {

src/services/tencent/TencentMapService.ts

@@ -3,8 +3,7 @@
  * 用于 POI 搜索、地址解析、路线规划等
  */
 
-// 优先从环境变量读取 API Key，回退到硬编码值（仅用于开发环境）
+const TENCENT_MAP_KEY = import.meta.env.VITE_TENCENT_MAP_KEY?.trim() || ''
-const TENCENT_MAP_KEY = import.meta.env.VITE_TENCENT_MAP_KEY || 'EJPBZ-DQEEQ-PDN5U-4ZDVX-F4I3F-6MBJC'
 const TENCENT_MAP_BASE_URL = 'https://apis.map.qq.com/ws'
 const TENCENT_DIRECTION_BASE_URL = `${TENCENT_MAP_BASE_URL}/direction/v1`
 

src/utils/publicUrl.ts

@@ -1,5 +1,6 @@
-const SAME_SERVER_HOST = '1.92.206.90'
+import {
-const LEGACY_AUDIO_HOST = '47.120.48.148'
+  dataSourceConfig
+} from '@/config/dataSource'
 
 const isAbsoluteHttpUrl = (url: string) => /^https?:\/\//i.test(url)
 
@@ -9,7 +10,8 @@ export const normalizeSameOriginPublicUrl = (url: string | null | undefined) =>
 
   try {
     const parsed = new URL(value)
-    const isSameServer = parsed.hostname === SAME_SERVER_HOST
+    const isSameServer = Boolean(dataSourceConfig.publicSameOriginAssetHost)
+      && parsed.hostname === dataSourceConfig.publicSameOriginAssetHost
 
     if (
       isSameServer
@@ -31,7 +33,8 @@ export const normalizeSameOriginPublicUrl = (url: string | null | undefined) =>
     }
 
     if (
-      parsed.hostname === LEGACY_AUDIO_HOST
+      dataSourceConfig.publicLegacyAudioHost
+      && parsed.hostname === dataSourceConfig.publicLegacyAudioHost
       && parsed.port === '19000'
       && parsed.pathname.startsWith('/nhm/audio/')
     ) {

vite.config.ts

@@ -1,54 +1,66 @@
-import { defineConfig } from 'vite'
+import { defineConfig, loadEnv } from 'vite'
 import uni from '@dcloudio/vite-plugin-uni'
 
-const sgsDevServer = 'http://1.92.206.90:3001'
+const normalizeEnvUrl = (value: string | undefined, fallback: string) => {
-const sgsAssetServer = 'http://1.92.206.90:9000'
+  const normalized = value?.trim()
-const legacyAudioServer = 'http://47.120.48.148:19000'
+  return normalized || fallback
+}
 
-export default defineConfig({
+export default defineConfig(({ mode }) => {
-  plugins: [uni()],
+  const env = loadEnv(mode, process.cwd(), '')
-  server: {
+  const appApiProxyTarget = normalizeEnvUrl(env.DEV_PROXY_APP_API_TARGET, 'http://localhost:3001')
-    host: '0.0.0.0',
+  const h5SdkProxyTarget = normalizeEnvUrl(env.DEV_PROXY_H5_SDK_TARGET, appApiProxyTarget)
-    proxy: {
+  const sdkProxyTarget = normalizeEnvUrl(env.DEV_PROXY_SDK_TARGET, appApiProxyTarget)
-      '/app-api': {
+  const museumAssetsProxyTarget = normalizeEnvUrl(env.DEV_PROXY_MUSEUM_ASSETS_TARGET, 'http://localhost:9000')
-        target: sgsDevServer,
+  const minioProxyTarget = normalizeEnvUrl(env.DEV_PROXY_MINIO_TARGET, appApiProxyTarget)
-        changeOrigin: true
+  const audioProxyTarget = normalizeEnvUrl(env.DEV_PROXY_AUDIO_TARGET, 'http://localhost:19000')
-      },
+
-      '/h5-sdk': {
+  return {
-        target: sgsDevServer,
+    base: normalizeEnvUrl(env.VITE_APP_PUBLIC_BASE, '/'),
-        changeOrigin: true
+    plugins: [uni()],
-      },
+    server: {
-      '/sdk': {
+      host: '0.0.0.0',
-        target: sgsDevServer,
+      proxy: {
-        changeOrigin: true
+        '/app-api': {
-      },
+          target: appApiProxyTarget,
-      '/museum-assets': {
+          changeOrigin: true
-        target: sgsAssetServer,
+        },
-        changeOrigin: true
+        '/h5-sdk': {
-      },
+          target: h5SdkProxyTarget,
-      '/minio': {
+          changeOrigin: true
-        target: sgsDevServer,
+        },
-        changeOrigin: true
+        '/sdk': {
-      },
+          target: sdkProxyTarget,
-      '/nhm/audio': {
+          changeOrigin: true
-        target: legacyAudioServer,
+        },
-        changeOrigin: true
+        '/museum-assets': {
+          target: museumAssetsProxyTarget,
+          changeOrigin: true
+        },
+        '/minio': {
+          target: minioProxyTarget,
+          changeOrigin: true
+        },
+        '/nhm/audio': {
+          target: audioProxyTarget,
+          changeOrigin: true
+        }
       }
-    }
+    },
-  },
+    resolve: {
-  resolve: {
+      alias: {
-    alias: {
+        '@': '/src'
-      '@': '/src'
+      }
-    }
+    },
-  },
+    optimizeDeps: {
-  optimizeDeps: {
+      include: ['three']
-    include: ['three']
+    },
-  },
+    build: {
-  build: {
+      rollupOptions: {
-    rollupOptions: {
+        output: {
-      output: {
+          manualChunks: {
-        manualChunks: {
+            three: ['three']
-          three: ['three']
+          }
         }
       }
     }