20261008173212

code/g3soft-libs/docs/app/components/app/AppHeaderCTA.vue

@@ -0,0 +1,31 @@
+<script setup lang="ts">
+// Docus 在 header 右上角渲染的占位组件，本地同名文件会覆盖 Layer 里的空实现。
+// 两个文档区入口：图标 + 文字（窄屏只留图标），并按当前路由所属板块高亮。
+const route = useRoute()
+
+const sections = [
+  { to: '/ui/usage/getting-started', prefix: '/ui', icon: 'i-lucide-component', label: 'UI 组件库' },
+  { to: '/api/getting-started', prefix: '/api', icon: 'i-lucide-cable', label: '接口文档' },
+]
+
+function isSectionActive(prefix: string) {
+  return route.path === prefix || route.path.startsWith(`${prefix}/`)
+}
+</script>
+
+<template>
+  <UButton
+    v-for="section in sections"
+    :key="section.prefix"
+    :to="section.to"
+    :icon="section.icon"
+    color="neutral"
+    variant="ghost"
+    :active="isSectionActive(section.prefix)"
+    active-color="primary"
+    active-variant="soft"
+    :aria-label="section.label"
+  >
+    <span class="hidden lg:inline">{{ section.label }}</span>
+  </UButton>
+</template>

code/g3soft-libs/docs/app/components/docs/DocsAsideLeftTop.vue

@@ -0,0 +1,8 @@
+<template>
+  <!--
+    覆盖 Docus 的 DocsAsideLeftTop（默认在侧边栏顶部渲染板块切换）。
+    这里留空，详情页侧边栏就不再出现板块切换；板块改由右上角入口按钮切换。
+    navigation.sub='aside' 仍需保留，它负责「侧边栏只显示当前板块」的隔离行为。
+  -->
+  <div />
+</template>