Merge pull request #10 from hyt1004/main

调整样式，增加时序图

Author: hyt1004

docs/.vitepress/config.mts

@@ -1,12 +1,13 @@
-import { defineConfig } from "vitepress";
+// import { defineConfig } from "vitepress";
+import { withMermaid } from "vitepress-plugin-mermaid";
 import { Chapters, getChapterItems } from "./theme/constrants/route";
 import autoH1 from "./plugins/autoH1";
 
 // 限制sidebar最多深入两层章节
 const sidebarItems = getChapterItems(1, 2);
 
 // https://vitepress.dev/reference/site-config
-export default defineConfig({
+export default withMermaid({
   lang: "zh",
   title: "灵矽文档中心",
   description: "A 灵矽 Documentation Project",
@@ -22,7 +23,7 @@ export default defineConfig({
       { text: "API", link: Chapters.xrobot_api },
       { text: "MCP接入", link: Chapters.xrobot_mcp },
       { text: "最佳实践", link: Chapters.xrobot_guide },
-      { text: "FAQ", link: Chapters.xrobot_faq },
+      { text: "FAQ", link: Chapters.xrobot_faq + "faq/" },
     ],
     sidebar: sidebarItems,
     socialLinks: [
@@ -32,8 +33,8 @@ export default defineConfig({
       },
     ],
     search: {
-      provider: 'local',
-    }
+      provider: "local",
+    },
   },
   markdown: {
     toc: {

docs/.vitepress/theme/constrants/route.ts

@@ -76,8 +76,8 @@ const items_xrobot_platform = [
     link: Chapters.xrobot_platform,
     collapsed: true,
     items: [
-      { text: "OTA", link: "OTA" },
-      { text: "websocket", link: "websocket" },
+      { text: "OTA 网关", link: "OTA" },
+      { text: "WebSocket", link: "websocket" },
       { text: "MQTT", link: "MQTT" },
     ].map((item) => apply_prefix(item, Chapters.xrobot_platform)),
   },
@@ -105,9 +105,7 @@ const items_xrobot_mcp = [
     items: [
       // { text: "硬件MCP", link: "hardware-mcp" },
       // { text: "软件MCP", link: "software-mcp" },
-    ].map((item) =>
-      apply_prefix(item, Chapters.xrobot_mcp)
-    ),
+    ].map((item) => apply_prefix(item, Chapters.xrobot_mcp)),
   },
 ];
 

docs/.vitepress/theme/index.css

@@ -25,6 +25,11 @@
   margin: auto;
 }
 
+/* 主页 */
+div.home #local-search button {
+  display: none;
+}
+
 /* todo 移除测试背景-该背景被应用到整个页面 */
 /* div[class="VPContent is-home"] {
   background: linear-gradient(to bottom right, #dce8ff, #e4eeff, #e6cbfd);

docs/index.md

@@ -41,7 +41,7 @@ features:
       dark: /icons/dark/faq.svg
       width: 100
       height: 100
-    link: ./xrobot/faq
+    link: ./xrobot/faq/faq/
   - linkText: 去体验
     icon: 
       light: /icons/light/experience.svg