修复 H5 嵌入小程序导航栏冲突

- 识别微信小程序 web-view 宿主环境
- 宿主导航存在时隐藏 H5 自绘返回与页面标题
- 收回详情、搜索、讲解列表页面顶部预留空间

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

src/components/explain/ExplainHallSelect.vue

@@ -1,6 +1,6 @@
 <template>
-  <view class="explain-hall-select">
-    <view class="explain-page-header">
+  <view class="explain-hall-select" :class="{ 'host-navigation': shouldUseHostNavigation }">
+    <view v-if="!shouldUseHostNavigation" class="explain-page-header">
       <view class="header-back" @tap="handleBack">
         <text class="header-back-icon">‹</text>
         <text class="header-back-text">返回</text>
@@ -153,6 +153,7 @@ import { computed, ref } from 'vue'
 import {
   EXPLAIN_UNIT_PREVIEW_FALLBACK
 } from '@/utils/explainUnitPreviews'
+import { isEmbeddedInWechatMiniProgram } from '@/utils/hostEnvironment'
 
 export interface ExplainHallSelectItem {
   id: string
@@ -239,6 +240,7 @@ const hallPreviewMap: Record<string, string> = {
 }
 
 const filteredHalls = computed(() => props.halls)
+const shouldUseHostNavigation = computed(() => isEmbeddedInWechatMiniProgram())
 const headerTitle = computed(() => {
   if (props.stage === 'unit') return props.selectedHallName || '选择业务单元'
   if (props.stage === 'stop') return props.selectedBusinessUnitName || '选择讲解点'
@@ -356,6 +358,14 @@ const handleBack = () => {
   padding-bottom: 0;
 }
 
+.explain-hall-select.host-navigation .explain-scroll {
+  padding-top: 12px;
+}
+
+.explain-hall-select.host-navigation .explain-scroll.hall-stage {
+  padding-top: 12px;
+}
+
 .state-title,
 .state-desc,
 .hall-name,

src/components/navigation/GuidePageFrame.vue

@@ -1,28 +1,35 @@
 <template>
   <view
     class="guide-page-frame"
-    :class="[`variant-${variant}`, { 'no-top-tabs': !showTopTabs }]"
+    :class="[
+      `variant-${variant}`,
+      {
+        'no-top-tabs': !effectiveShowTopTabs,
+        'no-frame-header': !hasFrameHeader
+      }
+    ]"
+    :style="frameStyle"
   >
     <GuideTopTabs
-      v-if="showTopTabs"
+      v-if="effectiveShowTopTabs"
       :active-tab="activeTab"
       :variant="topTabsVariant"
       :top="topTabsTop"
       @tab-change="handleTabChange"
     />
     <view
-      v-if="showBack || showCancel"
+      v-if="effectiveShowBack || effectiveShowCancel"
       class="guide-page-frame-actions"
     >
       <view
-        v-if="showBack"
+        v-if="effectiveShowBack"
         class="frame-action frame-action-back"
         @tap.stop="handleBackTap"
       >
         <text class="frame-action-text">{{ backLabel }}</text>
       </view>
       <view
-        v-if="showCancel"
+        v-if="effectiveShowCancel"
         class="frame-action frame-action-cancel"
         @tap.stop="handleCancelTap"
       >
@@ -43,12 +50,14 @@
 </template>
 
 <script setup lang="ts">
+import { computed } from 'vue'
 import GuideTopTabs from '@/components/navigation/GuideTopTabs.vue'
 import GlobalAudioPlayerHost from '@/components/audio/GlobalAudioPlayerHost.vue'
 import type { AudioDisplayMode } from '@/components/audio/AudioPlayer.vue'
 import type { GuideTopTab } from '@/utils/guideTopTabs'
+import { isEmbeddedInWechatMiniProgram } from '@/utils/hostEnvironment'
 
-withDefaults(defineProps<{
+const props = withDefaults(defineProps<{
   activeTab?: GuideTopTab
   variant?: 'overlay' | 'static'
   topTabsVariant?: 'underline' | 'segmented'
@@ -86,6 +95,18 @@ const emit = defineEmits<{
   cancel: []
 }>()
 
+const shouldUseHostNavigation = computed(() => isEmbeddedInWechatMiniProgram())
+const effectiveShowTopTabs = computed(() => props.showTopTabs && !shouldUseHostNavigation.value)
+const effectiveShowBack = computed(() => props.showBack && !shouldUseHostNavigation.value)
+const effectiveShowCancel = computed(() => props.showCancel && !shouldUseHostNavigation.value)
+const hasFrameHeader = computed(() => (
+  effectiveShowTopTabs.value || effectiveShowBack.value || effectiveShowCancel.value
+))
+const frameStyle = computed(() => ({
+  '--guide-page-top-offset': shouldUseHostNavigation.value ? '0px' : '44px',
+  '--guide-page-detail-top-padding': shouldUseHostNavigation.value ? '24px' : '84px'
+}))
+
 const handleTabChange = (tab: GuideTopTab) => {
   emit('tabChange', tab)
 }
@@ -123,11 +144,11 @@ const handleCancelTap = () => {
 }
 
 .variant-static .guide-page-frame-body {
-  top: 44px;
+  top: var(--guide-page-top-offset, 44px);
   background: var(--museum-bg-light);
 }
 
-.variant-static.no-top-tabs .guide-page-frame-body {
+.variant-static.no-frame-header .guide-page-frame-body {
   top: 0;
 }
 

src/pages/exhibit/detail.vue

@@ -20,7 +20,7 @@
             mode="aspectFill"
           />
           <view class="hero-image-shade"></view>
-          <view class="hero-back" @tap.stop="handleBack">
+          <view v-if="!shouldUseHostNavigation" class="hero-back" @tap.stop="handleBack">
             <text class="hero-back-icon">‹</text>
           </view>
           <view class="hero-copy">
@@ -128,6 +128,7 @@ import {
 import {
   EXPLAIN_DETAIL_PLACEHOLDER_IMAGE
 } from '@/utils/placeholders'
+import { isEmbeddedInWechatMiniProgram } from '@/utils/hostEnvironment'
 
 const defaultDetail: ExplainDetailPageViewModel = {
   id: '',
@@ -170,6 +171,7 @@ const detailTextLoadedByLanguage = ref<Record<AudioLanguage, boolean>>({
 })
 // 讲解详情页位置入口暂未开放，避免误导用户进入位置预览流程。
 const isLocationActionVisible = false
+const shouldUseHostNavigation = computed(() => isEmbeddedInWechatMiniProgram())
 
 const contentLanguageOptions: Array<{
   value: AudioLanguage
@@ -208,7 +210,6 @@ const currentAudioTarget = computed(() => ({
   lang: selectedAudioLanguage.value
 }))
 const isCurrentDetailAudio = computed(() => globalAudioPlayer.isCurrentSource(currentAudioTarget.value))
-
 const isCurrentDetailAudioTarget = computed(() => {
   const source = globalAudioPlayer.currentSource.value
   const targetType = exhibit.value.audio.playTargetType || 'ITEM'
@@ -699,7 +700,7 @@ const handleBack = () => {
 
 .content {
   height: 100%;
-  padding: 84px 20px calc(104px + env(safe-area-inset-bottom));
+  padding: var(--guide-page-detail-top-padding, 84px) 20px calc(104px + env(safe-area-inset-bottom));
   box-sizing: border-box;
 }
 
@@ -967,7 +968,6 @@ const handleBack = () => {
   background: rgba(249, 250, 251, 0.96);
 }
 
-
 .location-btn {
   height: 52px;
   display: flex;

src/pages/hall/detail.vue

@@ -264,7 +264,7 @@ const handleBack = () => {
 
 .content {
   height: 100%;
-  padding: 84px 20px calc(28px + env(safe-area-inset-bottom));
+  padding: var(--guide-page-detail-top-padding, 84px) 20px calc(28px + env(safe-area-inset-bottom));
   box-sizing: border-box;
 }
 

src/pages/search/index.vue

@@ -1,6 +1,6 @@
 <template>
-  <view class="poi-search-page">
-    <view class="search-header">
+  <view class="poi-search-page" :class="{ 'host-navigation': shouldUseHostNavigation }">
+    <view v-if="!shouldUseHostNavigation" class="search-header">
       <view class="search-header-copy">
         <text class="page-title">点位搜索</text>
         <text class="page-subtitle">Search Museum Locations</text>
@@ -21,11 +21,13 @@
 </template>
 
 <script setup lang="ts">
-import { onMounted, onUnmounted, ref } from 'vue'
+import { computed, onMounted, onUnmounted, ref } from 'vue'
 import { onLoad } from '@dcloudio/uni-app'
 import PoiSearchPanel from '@/components/search/PoiSearchPanel.vue'
+import { isEmbeddedInWechatMiniProgram } from '@/utils/hostEnvironment'
 
 const initialKeyword = ref('')
+const shouldUseHostNavigation = computed(() => isEmbeddedInWechatMiniProgram())
 
 onLoad((options: any) => {
   const keyword = typeof options.keyword === 'string'
@@ -119,6 +121,14 @@ onUnmounted(() => {
 }
 /* #endif */
 
+.poi-search-page.host-navigation {
+  padding-top: 0;
+}
+
+.poi-search-page.host-navigation::before {
+  display: none;
+}
+
 .search-header {
   position: relative;
   z-index: 1;

src/utils/hostEnvironment.ts

@@ -0,0 +1,34 @@
+const getCurrentUrlSearchParams = () => {
+  if (typeof window === 'undefined') return new URLSearchParams()
+
+  const params = new URLSearchParams(window.location.search)
+  const hash = window.location.hash || ''
+  const hashQueryStart = hash.indexOf('?')
+
+  if (hashQueryStart >= 0) {
+    const hashParams = new URLSearchParams(hash.slice(hashQueryStart + 1))
+    hashParams.forEach((value, key) => {
+      if (!params.has(key)) params.set(key, value)
+    })
+  }
+
+  return params
+}
+
+export const isEmbeddedInWechatMiniProgram = () => {
+  if (typeof window === 'undefined') return false
+
+  const params = getCurrentUrlSearchParams()
+  const embedded = params.get('embedded') || params.get('embed') || params.get('host')
+  if (embedded === 'wechat-mini-program' || embedded === 'weapp' || embedded === 'mini-program') {
+    return true
+  }
+
+  const wxEnvironment = (window as Window & {
+    __wxjs_environment?: string
+  }).__wxjs_environment
+
+  if (wxEnvironment === 'miniprogram') return true
+
+  return /miniProgram/i.test(window.navigator?.userAgent || '')
+}