feat(portal): 首页补齐产品功能、核心能力、界面预览、官方文档四个区块

用户反馈首页缺产品功能、核心能力与界面预览，且没有官方文档入口。

新增区块
- 产品功能：三条产品线（iotLCM / 秀杰 DTU / XiuAdmin），
  每条列 6 项能力，卡片底部直达详情页
- 核心能力：8 张带标签的卡片，讲工程层面的硬指标
  （部署、接入、开放、治理、韧性、交付、数据、维护），
  与"产品功能"区分开：前者是做什么，后者是凭什么能用住
- 界面预览：ScreenshotPreview 组件，Web 管理端 / 小程序端两组标签切换，
  首屏大图 + 缩略图条，带浏览器窗口装饰
- 官方文档：6 个入口卡片（文档中心、Web 手册、小程序手册、部署手册、
  OpenAPI 合同、门户部署说明），外链自动加 target=_blank

界面预览的占位机制
- previewShots 里 file 留空时渲染带图注的占位框，不报错、不影响构建
- 补图只改 file 字段，组件无需改动
- 新增 pages/public/screenshots/README.md 写清命名、尺寸、脱敏要求

导航
- 增加产品功能、核心能力、界面预览、官方文档四个锚点项
- 窄屏（≤860px）隐藏中间三个锚点项，避免挤压

验证
- 构建 13 页，208 条引用 0 失效
- 浏览器实测：7 个导航项、5 个 section 锚点齐全
- 移动端 390px 无横向溢出
- 文档站 5 个外链地址均实测 200 可达

.vitepress/theme/components/HomePage.vue

@@ -1,7 +1,12 @@
 <script setup lang="ts">
-import { ref } from 'vue'
 import { projects } from '../../../data/projects'
-import { stats, foundations } from '../../../data/content'
+import {
+  stats,
+  foundations,
+  productLines,
+  coreAbilities,
+  docs,
+} from '../../../data/content'
 </script>
 
 <template>
@@ -22,7 +27,7 @@ import { stats, foundations } from '../../../data/content'
               <path d="M3 8h10M9 4l4 4-4 4" stroke="currentColor" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round" />
             </svg>
           </a>
-          <a class="p-btn p-btn--ghost" href="/projects/iotlcm/guide/quickstart">快速开始</a>
+          <a class="p-btn p-btn--ghost" href="#docs">官方文档</a>
         </div>
 
         <div class="p-stats">
@@ -65,8 +70,68 @@ import { stats, foundations } from '../../../data/content'
       </div>
     </section>
 
-    <!-- 通用能力 -->
-    <section class="p-section">
+    <!-- 产品功能 -->
+    <section class="p-section" id="features">
+      <div class="p-wrap">
+        <header class="p-head">
+          <span class="p-eyebrow">PRODUCT FEATURES</span>
+          <h2 class="p-title">三个产品线，各自覆盖一段完整业务</h2>
+          <p class="p-desc">
+            iotLCM 管卡、秀杰 DTU 管设备、XiuAdmin 提供中后台底座。每条产品线的功能都在生产环境跑过，不是规划稿。
+          </p>
+        </header>
+
+        <div class="p-grid p-grid--3">
+          <div v-for="line in productLines" :key="line.id" class="p-card pf-card">
+            <h3 class="p-card-title pf-name">{{ line.name }}</h3>
+            <p class="pf-tagline">{{ line.tagline }}</p>
+            <ul class="pf-list">
+              <li v-for="f in line.features" :key="f">{{ f }}</li>
+            </ul>
+            <a :href="line.page" class="pf-more">功能详情 →</a>
+          </div>
+        </div>
+      </div>
+    </section>
+
+    <!-- 核心能力 -->
+    <section class="p-section p-section--alt" id="core">
+      <div class="p-wrap">
+        <header class="p-head">
+          <span class="p-eyebrow">CORE CAPABILITIES</span>
+          <h2 class="p-title">工程层面的硬指标</h2>
+          <p class="p-desc">
+            功能列表谁都能写。这些是真正决定能不能上线、好不好维护的部分。
+          </p>
+        </header>
+
+        <div class="p-grid p-grid--4">
+          <div v-for="a in coreAbilities" :key="a.title" class="p-card ca-card">
+            <span class="ca-tag">{{ a.tag }}</span>
+            <h3 class="p-card-title">{{ a.title }}</h3>
+            <p class="p-card-text">{{ a.text }}</p>
+          </div>
+        </div>
+      </div>
+    </section>
+
+    <!-- 界面预览 -->
+    <section class="p-section" id="preview">
+      <div class="p-wrap">
+        <header class="p-head">
+          <span class="p-eyebrow">SCREENSHOTS</span>
+          <h2 class="p-title">界面预览</h2>
+          <p class="p-desc">
+            管理端与用户端的实际界面。功能项远不止这些，完整清单见各项目详情页与文档站。
+          </p>
+        </header>
+
+        <ScreenshotPreview />
+      </div>
+    </section>
+
+    <!-- 通用能力底座 -->
+    <section class="p-section p-section--alt">
       <div class="p-wrap">
         <header class="p-head">
           <span class="p-eyebrow">FOUNDATION</span>
@@ -88,7 +153,7 @@ import { stats, foundations } from '../../../data/content'
     </section>
 
     <!-- 组合方式 -->
-    <section class="p-section p-section--alt">
+    <section class="p-section">
       <div class="p-wrap">
         <header class="p-head">
           <span class="p-eyebrow">HOW THEY FIT</span>
@@ -119,6 +184,44 @@ import { stats, foundations } from '../../../data/content'
       </div>
     </section>
 
+    <!-- 官方文档 -->
+    <section class="p-section p-section--alt" id="docs">
+      <div class="p-wrap">
+        <header class="p-head">
+          <span class="p-eyebrow">DOCUMENTATION</span>
+          <h2 class="p-title">官方文档</h2>
+          <p class="p-desc">
+            使用手册、部署手册与接口合同随平台一起发布，与代码同仓维护。
+            下面是各册入口，点击直接跳转。
+          </p>
+        </header>
+
+        <div class="p-grid p-grid--3 doc-grid">
+          <a
+            v-for="d in docs"
+            :key="d.name"
+            :href="d.url"
+            class="p-card doc-card"
+            :target="d.url.startsWith('http') ? '_blank' : undefined"
+            :rel="d.url.startsWith('http') ? 'noopener' : undefined"
+          >
+            <div class="doc-top">
+              <h3 class="p-card-title">{{ d.name }}</h3>
+              <svg class="doc-arrow" width="14" height="14" viewBox="0 0 16 16" fill="none" aria-hidden="true">
+                <path d="M5 11L11 5M11 5H6M11 5v5" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" />
+              </svg>
+            </div>
+            <p class="p-card-text">{{ d.desc }}</p>
+            <span class="doc-project">{{ d.project }}</span>
+          </a>
+        </div>
+
+        <p class="doc-note">
+          文档站地址：<a :href="'http://open.5iot.com:5051/docs/'" target="_blank" rel="noopener">http://open.5iot.com:5051/docs/</a>
+        </p>
+      </div>
+    </section>
+
     <!-- CTA -->
     <section class="p-cta">
       <div class="p-wrap">

.vitepress/theme/components/ScreenshotPreview.vue

@@ -0,0 +1,226 @@
+<script setup lang="ts">
+import { ref, computed } from 'vue'
+import { previewShots } from '../../../data/content'
+
+const active = ref<'web' | 'app'>('web')
+const shots = computed(() => previewShots[active.value] ?? [])
+const main = computed(() => shots.value[0])
+const rest = computed(() => shots.value.slice(1))
+const current = ref(0)
+
+const mainShot = computed(() => shots.value[current.value] ?? main.value)
+
+function select(i: number) {
+  current.value = i
+}
+
+function switchGroup(g: 'web' | 'app') {
+  active.value = g
+  current.value = 0
+}
+</script>
+
+<template>
+  <div class="pv">
+    <div class="p-tabs pv-tabs" role="tablist">
+      <button
+        class="p-tab"
+        :class="{ 'is-active': active === 'web' }"
+        role="tab"
+        :aria-selected="active === 'web'"
+        @click="switchGroup('web')"
+      >
+        Web 管理端
+      </button>
+      <button
+        class="p-tab"
+        :class="{ 'is-active': active === 'app' }"
+        role="tab"
+        :aria-selected="active === 'app'"
+        @click="switchGroup('app')"
+      >
+        小程序 / H5 用户端
+      </button>
+    </div>
+
+    <!-- 主图 -->
+    <figure class="pv-main" :data-group="active">
+      <div class="pv-frame">
+        <span class="pv-bar" aria-hidden="true">
+          <i></i><i></i><i></i>
+        </span>
+        <img
+          v-if="mainShot && mainShot.file"
+          :src="`/screenshots/${mainShot.file}`"
+          :alt="mainShot.caption"
+          loading="lazy"
+        />
+        <div v-else class="pv-empty">
+          <svg width="34" height="34" viewBox="0 0 24 24" fill="none" aria-hidden="true">
+            <rect x="3" y="4" width="18" height="14" rx="2" stroke="currentColor" stroke-width="1.5" />
+            <path d="M3 9h18" stroke="currentColor" stroke-width="1.5" />
+            <circle cx="6.5" cy="6.5" r="0.9" fill="currentColor" />
+            <path d="M8 17l3.2-3.6 2.3 2.2 1.8-1.6L19 17" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" />
+          </svg>
+          <span class="pv-empty-text">截图待补</span>
+          <span v-if="mainShot" class="pv-empty-caption">{{ mainShot.caption }}</span>
+        </div>
+      </div>
+      <figcaption v-if="mainShot" class="pv-caption">{{ mainShot.caption }}</figcaption>
+    </figure>
+
+    <!-- 缩略图条 -->
+    <div v-if="rest.length" class="pv-thumbs">
+      <button
+        v-for="(s, i) in shots"
+        :key="s.caption"
+        class="pv-thumb"
+        :class="{ 'is-active': i === current }"
+        :title="s.caption"
+        @click="select(i)"
+      >
+        <img v-if="s.file" :src="`/screenshots/${s.file}`" :alt="s.caption" loading="lazy" />
+        <span v-else class="pv-thumb-ph">{{ String(i + 1).padStart(2, '0') }}</span>
+      </button>
+    </div>
+
+    <p class="pv-note">
+      截图按端分组，点击缩略图切换主图。当前为占位状态，补齐截图后自动替换。
+    </p>
+  </div>
+</template>
+
+<style scoped>
+.pv-tabs {
+  margin-bottom: 28px;
+}
+
+.pv-main {
+  margin: 0;
+}
+
+.pv-frame {
+  position: relative;
+  border: 1px solid var(--p-line-strong);
+  border-radius: var(--p-radius);
+  background: var(--p-surface-alt);
+  overflow: hidden;
+  box-shadow: var(--p-shadow-hover);
+}
+
+.pv-bar {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  height: 34px;
+  padding: 0 14px;
+  background: var(--p-surface);
+  border-bottom: 1px solid var(--p-line);
+}
+
+.pv-bar i {
+  width: 9px;
+  height: 9px;
+  border-radius: 50%;
+  background: var(--p-line-strong);
+}
+
+.pv-frame img {
+  display: block;
+  width: 100%;
+  height: auto;
+}
+
+.pv-empty {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  gap: 10px;
+  min-height: 380px;
+  color: var(--p-ink-3);
+}
+
+.pv-main[data-group='app'] .pv-empty {
+  min-height: 420px;
+}
+
+.pv-empty-text {
+  font-size: 13px;
+  font-weight: 500;
+}
+
+.pv-empty-caption {
+  font-size: 13px;
+  color: var(--p-ink-2);
+}
+
+.pv-caption {
+  margin: 14px 0 0;
+  text-align: center;
+  font-size: 13px;
+  color: var(--p-ink-3);
+}
+
+.pv-thumbs {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: center;
+  gap: 10px;
+  margin-top: 22px;
+}
+
+.pv-thumb {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 76px;
+  height: 52px;
+  padding: 0;
+  overflow: hidden;
+  background: var(--p-surface-alt);
+  border: 1px solid var(--p-line-strong);
+  border-radius: 8px;
+  cursor: pointer;
+  transition: border-color 0.15s, transform 0.15s;
+}
+
+.pv-thumb:hover {
+  transform: translateY(-1px);
+  border-color: var(--p-ink-3);
+}
+
+.pv-thumb.is-active {
+  border-color: var(--p-accent);
+  box-shadow: 0 0 0 2px var(--p-accent-soft);
+}
+
+.pv-thumb img {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+}
+
+.pv-thumb-ph {
+  font-family: var(--vp-font-family-mono);
+  font-size: 12px;
+  color: var(--p-ink-3);
+}
+
+.pv-note {
+  margin: 20px 0 0;
+  text-align: center;
+  font-size: 12.5px;
+  color: var(--p-ink-3);
+}
+
+@media (max-width: 720px) {
+  .pv-empty {
+    min-height: 220px;
+  }
+  .pv-thumb {
+    width: 62px;
+    height: 44px;
+  }
+}
+</style>

.vitepress/theme/index.ts

@@ -7,6 +7,7 @@ import ProjectList from './components/ProjectList.vue'
 import HomePage from './components/HomePage.vue'
 import CapabilityTabs from './components/CapabilityTabs.vue'
 import FeatureGrid from './components/FeatureGrid.vue'
+import ScreenshotPreview from './components/ScreenshotPreview.vue'
 
 import './styles/portal.css'
 
@@ -28,5 +29,6 @@ export default {
     app.component('HomePage', HomePage)
     app.component('CapabilityTabs', CapabilityTabs)
     app.component('FeatureGrid', FeatureGrid)
+    app.component('ScreenshotPreview', ScreenshotPreview)
   },
 } satisfies Theme

.vitepress/theme/styles/portal.css

@@ -741,3 +741,181 @@ html.dark .p-tab.is-active {
 .vp-doc a:hover {
   text-decoration-color: var(--p-accent);
 }
+
+/* ============================================================
+   产品功能卡片
+   ============================================================ */
+.pf-card {
+  position: relative;
+}
+
+.pf-name {
+  font-size: 17px;
+}
+
+.pf-tagline {
+  margin: 8px 0 0;
+  font-size: 13.5px;
+  font-weight: 600;
+  color: var(--p-accent);
+}
+
+.pf-list {
+  margin: 20px 0 0;
+  padding: 0;
+  list-style: none;
+  flex: 1;
+}
+
+.pf-list li {
+  position: relative;
+  padding: 9px 0 9px 22px;
+  font-size: 13.5px;
+  line-height: 1.6;
+  color: var(--p-ink-2);
+  border-top: 1px solid var(--p-line);
+}
+
+.pf-list li:first-child {
+  border-top: none;
+}
+
+.pf-list li::before {
+  content: '';
+  position: absolute;
+  left: 2px;
+  top: 17px;
+  width: 6px;
+  height: 6px;
+  border-radius: 50%;
+  background: var(--p-accent);
+  opacity: 0.55;
+}
+
+.pf-more {
+  display: inline-block;
+  margin-top: 20px;
+  font-size: 13px;
+  font-weight: 600;
+  color: var(--p-accent);
+  text-decoration: none !important;
+}
+
+.pf-more:hover {
+  text-decoration: underline !important;
+  text-underline-offset: 3px;
+}
+
+/* ============================================================
+   核心能力卡片
+   ============================================================ */
+.ca-card {
+  position: relative;
+  padding: 26px 24px;
+}
+
+.ca-tag {
+  display: inline-block;
+  align-self: flex-start;
+  width: auto;
+  margin-bottom: 14px;
+  padding: 2px 9px;
+  font-size: 11.5px;
+  font-weight: 600;
+  letter-spacing: 0.04em;
+  color: var(--p-accent);
+  background: var(--p-accent-soft);
+  border-radius: 5px;
+}
+
+.ca-card .p-card-title {
+  font-size: 15.5px;
+}
+
+.ca-card .p-card-text {
+  font-size: 13.5px;
+  line-height: 1.7;
+}
+
+/* ============================================================
+   官方文档
+   ============================================================ */
+.doc-grid {
+  margin-bottom: 8px;
+}
+
+.doc-card {
+  text-decoration: none !important;
+  color: var(--p-ink) !important;
+}
+
+.doc-top {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 12px;
+}
+
+.doc-top .p-card-title {
+  font-size: 15.5px;
+}
+
+.doc-arrow {
+  flex: none;
+  margin-top: 3px;
+  color: var(--p-ink-3);
+  transition: color 0.18s, transform 0.18s;
+}
+
+.doc-card:hover .doc-arrow {
+  color: var(--p-accent);
+  transform: translate(1px, -1px);
+}
+
+.doc-card .p-card-text {
+  flex: 1;
+  font-size: 13.5px;
+  line-height: 1.7;
+}
+
+.doc-project {
+  display: inline-block;
+  align-self: flex-start;
+  margin-top: 18px;
+  padding: 2px 9px;
+  font-size: 11.5px;
+  color: var(--p-ink-3);
+  background: var(--p-surface-alt);
+  border: 1px solid var(--p-line);
+  border-radius: 5px;
+}
+
+html.dark .doc-project {
+  background: rgba(255, 255, 255, 0.04);
+}
+
+.doc-note {
+  margin: 28px 0 0;
+  text-align: center;
+  font-size: 13px;
+  color: var(--p-ink-3);
+}
+
+.doc-note a {
+  color: var(--p-accent);
+  text-decoration: none;
+}
+
+.doc-note a:hover {
+  text-decoration: underline;
+  text-underline-offset: 3px;
+}
+
+/* ============================================================
+   导航：锚点项在窄屏隐藏，避免挤压
+   ============================================================ */
+@media (max-width: 860px) {
+  .VPNavBarMenuGroup:nth-child(n + 5):nth-child(-n + 7) {
+    display: none;
+  }
+}