新增faq

Author: hyt1004

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

@@ -18,7 +18,7 @@ export enum Chapters {
   xrobot = "/xrobot/",
   xrobot_device = "/xrobot/device/",
   xrobot_api = "/xrobot/api/",
-  xrobot_qa = "/xrobot/qa/",
+  xrobot_faq = "/xrobot/faq/",
 }
 
 // 判断一个link是否是章节link
@@ -66,13 +66,13 @@ const items_xrobot_device = [
   // 子章节
 ];
 
-const items_xrobot_qa = [
+const items_xrobot_faq = [
   {
     text: "常见问题",
-    items: [
-      { text: "Q & A", link: "qa" },
-    ].map((item) => apply_prefix(item, Chapters.xrobot_qa)),
-    link: Chapters.xrobot_qa,
+    items: [{ text: "FAQ", link: "faq" }].map((item) =>
+      apply_prefix(item, Chapters.xrobot_faq)
+    ),
+    link: Chapters.xrobot_faq,
     collapsed: false,
   },
   // 子章节
@@ -82,7 +82,7 @@ const items_xrobot_qa = [
 const items_xrobot = [
   {
     text: "Xrobot",
-    items: [...items_xrobot_api, ...items_xrobot_device, ...items_xrobot_qa],
+    items: [...items_xrobot_api, ...items_xrobot_device, ...items_xrobot_faq],
     link: Chapters.xrobot,
     collapsed: false,
   },
@@ -104,5 +104,5 @@ export const ChapterItems: Record<Chapters, ChapterItem[]> = {
     ...items_xrobot_device,
   ],
   [Chapters.xrobot_api]: [gobackItem(Chapters.xrobot), ...items_xrobot_api],
-  [Chapters.xrobot_qa]: [gobackItem(Chapters.xrobot), ...items_xrobot_qa],
+  [Chapters.xrobot_faq]: [gobackItem(Chapters.xrobot), ...items_xrobot_faq],
 };

docs/index.md

@@ -15,7 +15,7 @@ hero:
       link: /xrobot/api/
     - theme: brand
       text: 常见问题
-      link: /xrobot/qa/
+      link: /xrobot/faq/
     - theme: alt
       text: 去体验-七牛小智
       link: https://xrobo.qiniu.com/#/home

docs/xrobot/faq/faq.md

@@ -0,0 +1,39 @@
+---
+title: Q & A
+---
+
+## 1. 怎么获取设备固件？
+
+可通过点击以下链接进行下载，七牛灵芯云提供最新版本的设备固件：
+
+   | 芯片     | 固件                                                                                                                            |
+   | :------- | :------------------------------------------------------------------------------------------------------------------------------ |
+   | ESP32-C3 | https://algorithm.qnaigc.com/xiaoling-rom/xiaoling-202507021613-ESP32C3-xiage_mini_c3-nihaoxiaozhi-without_dns.bin              |
+   | ESP32-S3 | https://algorithm.qnaigc.com/xiaoling-rom/xiaoling-202507021613-ESP32S3-bread_compact-nihaoxiaozhi_nihaoxiaoxin-without_dns.bin |
+
+## 2. 烧录固件时提示串口被占用？
+
+请检查设备连接是否完好，确保使用数据传输接口而不是充电接口进行烧录。
+
+## 3. 绑定设备时，提示已经被绑定？
+
+将设备从当前绑定的智能体中进行解绑，如找不到设备当前绑定的智能体，使用固件烧录工具擦除固件后重新烧录即可。
+
+## 4. 设备一直显示等待网络... ？
+
+请确保设备配置的网络功能正常，如果网络无法使用，请重新配网选择可用的网络。
+
+## 5. 如何重新进入配网模式？
+
+如果设备固件版本>=0.2.2，在重试 3 次连接原有 WI-FI 网络失败后，会重新进入配网模式（切换网络时可能需要按 RST 按键重启一下设备）。如果设备固件版本较新，在设备开机后，如果处于扫描 wifi 状态时按一下 boot 键（如图中绿圈所示），设备将重新配网，不再连接上次的 WIFI 网络。
+
+| 芯片     | 说明图片                                          |
+| -------- | ------------------------------------------------- |
+| ESP32-C3 | <img src="../device/imgs/device-intro/3.2 esp32-c3.png"/> |
+| ESP32-S3 | <img src="../device/imgs/device-intro/3.2 esp32-s3.png"/> |
+
+## 6. 智能体更新角色配置后未生效？
+
+智能体更新角色配置后，需重启设备才能生效。
+
+

docs/xrobot/qa/index.md docs/xrobot/faq/index.mddocs/xrobot/qa/index.md renamed to docs/xrobot/faq/index.md

@@ -1,7 +1,7 @@
 <script setup>
 import { Chapters } from "../../.vitepress/theme/constrants/route";
 
-const chapter_root = Chapters.xrobot_qa;
+const chapter_root = Chapters.xrobot_faq;
 </script>
 
 <ChapterContents :chapter=chapter_root />