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 可达

.gitignore

@@ -12,3 +12,4 @@ dist
 # 本地构建产物（多形态验证用）
 .vitepress/dist-build*
 .vitepress/final
+.vitepress/v2

.vitepress/config.mts

@@ -33,7 +33,11 @@ export default defineConfig({
   themeConfig: {
     nav: [
       { text: '首页', link: '/' },
+      { text: '产品功能', link: '/#features' },
+      { text: '核心能力', link: '/#core' },
+      { text: '界面预览', link: '/#preview' },
       { text: '项目', link: '/projects/' },
+      { text: '官方文档', link: '/#docs' },
       { text: '关于', link: '/about' },
     ],
     sidebar: {

.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;
+  }
+}

data/content.ts

@@ -19,6 +19,120 @@ export const stats: Stat[] = [
   { num: '100', unit: '%', label: 'Apache-2.0 许可' },
 ]
 
+/* ============================================================
+   产品功能 —— 首页「产品功能」区块，按产品线列功能点
+   ============================================================ */
+
+export interface ProductLine {
+  id: string
+  name: string
+  /** 一句话定位 */
+  tagline: string
+  /** 该产品线的功能清单，取 6 条最能说明问题的 */
+  features: string[]
+  /** 对应详情页 */
+  page: string
+}
+
+export const productLines: ProductLine[] = [
+  {
+    id: 'iotlcm',
+    name: 'iotLCM 物联网卡',
+    tagline: 'SIM 卡从入库到销户的全流程',
+    features: [
+      '卡信息检索与批量导入',
+      '入库 / 库存 / 出库三级流转',
+      '批量开停复机与续费',
+      '套餐、流量池与定价',
+      '三大运营商协议直连',
+      '达量断网与智能诊断',
+    ],
+    page: '/projects/iotlcm/',
+  },
+  {
+    id: 'xiu-dtu',
+    name: '秀杰 DTU 设备',
+    tagline: 'DTU 设备从生产到运行监控',
+    features: [
+      '产品、型号与生产批次',
+      '固件版本与 OTA 升级',
+      '配置分组与下发状态',
+      '代理商划拨与回收',
+      'HTTP / TCP 双通道接入',
+      '设备在线状态监控',
+    ],
+    page: '/projects/xiu-dtu/',
+  },
+  {
+    id: 'xiu-admin',
+    name: 'XiuAdmin 中后台',
+    tagline: '22 项内置功能的应用底座',
+    features: [
+      '多租户与租户套餐',
+      '用户、部门、岗位、角色',
+      '菜单与按钮级权限',
+      '代码生成（CURD / 树表）',
+      '定时任务与消息队列',
+      '服务监控与操作日志',
+    ],
+    page: '/projects/xiu-admin/',
+  },
+]
+
+/* ============================================================
+   核心能力 —— 首页「核心能力」区块，强调工程层面的硬指标
+   ============================================================ */
+
+export interface CoreAbility {
+  title: string
+  text: string
+  /** 卡片角标，一个词概括 */
+  tag: string
+}
+
+export const coreAbilities: CoreAbility[] = [
+  {
+    tag: '部署',
+    title: '单机一条命令起',
+    text: 'Docker Compose 编排齐备，首次启动自动建库建表、导入种子数据与时序库建表，不需要本地编译，约一分钟可用。',
+  },
+  {
+    tag: '接入',
+    title: '运营商协议内置',
+    text: '中国移动 OneLink、中国电信 5G CMP、中国联通 10646 的接口差异收敛在对接层，上层业务不感知底层协议。',
+  },
+  {
+    tag: '开放',
+    title: '版本化对外接口',
+    text: 'V3 版本化接口、旧版兼容接口与运营商能力代理三套合同并行，升级不破坏既有调用方。',
+  },
+  {
+    tag: '治理',
+    title: '多租户权限模型',
+    text: '租户、部门、岗位、角色四层结构，菜单与按钮级权限、数据范围划分，关键操作全程留痕。',
+  },
+  {
+    tag: '韧性',
+    title: '上游抖动隔离',
+    text: '独立的通道缓存转发层，上游接口异常或超时不直接传导到管理端，配合健康探针与运行期 DNS 解析自动跟随容器 IP 变化。',
+  },
+  {
+    tag: '交付',
+    title: '离线可部署',
+    text: '镜像可导出为归档文件带入内网，无外网环境同样能完成安装与升级，适合企业内网与客户现场。',
+  },
+  {
+    tag: '数据',
+    title: '时序数据留存',
+    text: '流量与状态按账期落入时序库，月度账单自动生成、每小时增量更新，长期趋势分析不失真。',
+  },
+  {
+    tag: '维护',
+    title: '文档与代码同仓',
+    text: '使用手册、部署手册与接口合同与代码同仓维护，随平台一起发布，版本不会脱节。',
+  },
+]
+
 export interface Capability {
   title: string
   text: string
@@ -170,3 +284,98 @@ export const dtuGroups: CapGroup[] = [
     ],
   },
 ]
+
+/* ============================================================
+   界面预览 —— 首页「界面预览」区块
+   ============================================================ */
+
+export interface PreviewShot {
+  /** 截图文件名，放在 pages/public/screenshots/ 下；为空时渲染占位框 */
+  file: string
+  /** 图注，说明这张图看的是什么 */
+  caption: string
+  /** 所属端，用于标签切换 */
+  group: 'web' | 'app'
+}
+
+/**
+ * 每个分组的第一张是首屏大图，其余进下方缩略图条。
+ *
+ * 图片放置约定：pages/public/screenshots/<file>
+ * 建议尺寸 1600x1000（web）/ 750x1334（app），单张控制在 400KB 以内。
+ * file 留空时页面显示占位框与图注，不会报错 —— 补图时只改 file 字段即可。
+ */
+export const previewShots: Record<'web' | 'app', PreviewShot[]> = {
+  web: [
+    { file: '', caption: '管理端工作台：卡量与用量概览', group: 'web' },
+    { file: '', caption: '卡信息列表：三码检索与批量操作', group: 'web' },
+    { file: '', caption: '业务受理：开通、续费与变更套餐', group: 'web' },
+    { file: '', caption: '套餐与定价配置', group: 'web' },
+    { file: '', caption: '通道与上游接入管理', group: 'web' },
+    { file: '', caption: '企业、用户与角色权限', group: 'web' },
+  ],
+  app: [
+    { file: '', caption: '用户端首页：公开查卡入口', group: 'app' },
+    { file: '', caption: '卡片详情与用量', group: 'app' },
+    { file: '', caption: '业务办理：续费与套餐变更', group: 'app' },
+    { file: '', caption: '智能诊断：按链路排查问题', group: 'app' },
+  ],
+}
+
+/* ============================================================
+   官方文档 —— 首页「官方文档」区块
+   ============================================================ */
+
+export interface DocEntry {
+  name: string
+  /** 这份文档解决什么问题 */
+  desc: string
+  url: string
+  /** 归属项目名，用于分组显示 */
+  project: string
+}
+
+/**
+ * 文档站是随 iotLCM 发布的独立站点（VitePress），按手册分册。
+ * 地址可用 DOCS_BASE 环境变量在构建时覆盖，见 .vitepress/config.mts。
+ */
+const DOCS_BASE = 'http://open.5iot.com:5051/docs'
+
+export const docs: DocEntry[] = [
+  {
+    name: '文档中心',
+    desc: '全部手册的入口页，按端与用途分册索引',
+    url: `${DOCS_BASE}/`,
+    project: 'iotLCM',
+  },
+  {
+    name: '使用手册 · Web 管理端',
+    desc: '查卡、业务受理、套餐定价、库存出入库、通道管理、企业用户与角色、工单、API 凭证',
+    url: `${DOCS_BASE}/manual/web/`,
+    project: 'iotLCM',
+  },
+  {
+    name: '使用手册 · 小程序端',
+    desc: '公开查卡、卡片排查、客户管理与划拨、工单、批次执行日志、消息与个人中心',
+    url: `${DOCS_BASE}/manual/mini-program/`,
+    project: 'iotLCM',
+  },
+  {
+    name: '部署手册',
+    desc: '环境要求、一键部署、配置说明、离线部署、拆分部署、自建镜像、运维与排错',
+    url: `${DOCS_BASE}/deploy/`,
+    project: 'iotLCM',
+  },
+  {
+    name: 'OpenAPI 合同',
+    desc: '鉴权方式、V3 接口、旧版兼容接口、运营商能力代理',
+    url: `${DOCS_BASE}/openapi/`,
+    project: 'iotLCM',
+  },
+  {
+    name: '门户部署说明',
+    desc: '本门户自身的构建参数、镜像形态与容器部署方式',
+    url: '/guide/portal-deploy',
+    project: '门户站',
+  },
+]

pages/public/screenshots/README.md

@@ -0,0 +1,37 @@
+# 界面预览截图
+
+首页「界面预览」区块从这里取图。补图时**只改 `data/content.ts` 里的 `file` 字段**，不用动组件。
+
+## 命名约定
+
+```
+pages/public/screenshots/
+├── web-dashboard.png        # 管理端工作台（首屏大图）
+├── web-cards.png            # 卡信息列表
+├── web-business.png         # 业务受理
+├── web-packages.png         # 套餐与定价
+├── web-channels.png         # 通道管理
+├── web-org.png              # 企业与权限
+├── app-home.png             # 用户端首页
+├── app-card-detail.png      # 卡片详情
+├── app-business.png         # 业务办理
+└── app-diagnosis.png        # 智能诊断
+```
+
+## 规格
+
+| 项 | 建议 |
+| --- | --- |
+| Web 端尺寸 | 1600 × 1000（16:10） |
+| 小程序端尺寸 | 750 × 1334（9:16） |
+| 单张体积 | 400 KB 以内，PNG 或 WebP |
+| 内容 | 用演示数据，不要出现真实客户名、真实 ICCID、真实手机号 |
+| 敏感信息 | 账号、口令、密钥片段一律打码 |
+
+## 补图步骤
+
+1. 把图片放进本目录，按上面约定命名
+2. 打开 `data/content.ts`，找到 `previewShots`，把对应条目的 `file` 从 `''` 改成文件名
+3. 保存，页面自动从占位框切换成真实截图
+
+`file` 留空时页面显示带图注的占位框，不会报错，也不影响构建。