调整api相关路由；为目录生成组件添加无内容提示

Author: srsng

docs/.vitepress/theme/components/ChapterContents.vue

@@ -16,7 +16,8 @@ const { chapter: chapter_root, root = true } = defineProps<{
 let chapter_name: string[] = [];
 let tocs: { link: string; text: string }[][] = [];
 
-// console.log(chapter_root);
+console.log("chapter_root", chapter_root);
+console.log("ChapterItems[chapter_root]", ChapterItems[chapter_root]);
 
 ChapterItems[chapter_root]?.forEach((subchapter) => {
   const t = subchapter.items?.filter((item) => {
@@ -28,15 +29,16 @@ ChapterItems[chapter_root]?.forEach((subchapter) => {
   }
 });
 
-// console.log("chapter_name:", chapter_name);
-// console.log("tocs:", tocs);
+console.log("chapter_name:", chapter_name);
+console.log("tocs:", tocs);
 </script>
 
 <template>
   <h1 v-if="root">目录</h1>
   <div v-for="(subchapter, index) in tocs">
     <h2>{{ chapter_name[index] }}</h2>
-    <ol>
+    <div v-if="subchapter.length === 0"><span>暂无内容</span></div>
+    <ol v-else>
       <li v-for="(item, index2) in subchapter" :key="item.link">
         <ol v-if="isChapter(item.link)">
           <ChapterContents

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

@@ -22,8 +22,8 @@ export enum Chapters {
   xrobot_guide_device = "/xrobot/device/",
   // api
   xrobot_api = "/xrobot/api/",
-  xrobot_api_server = "/xrobot/api/server",
-  xrobot_api_client = "/xrobot/api/client",
+  xrobot_api_server = "/xrobot/api/server/",
+  xrobot_api_client = "/xrobot/api/client/",
   // faq
   xrobot_faq = "/xrobot/faq/",
 }
@@ -42,6 +42,12 @@ export enum Chapters {
 
 // 给 ChapterItem 的 link 字段追加当前章节的 link 前缀
 export function apply_prefix(item: ChapterItem, prefix: Chapters) {
+  // // 包含子章节
+  // if (item.items && isChapter(item.link))
+  //   return item.items.map((item2) =>
+  //     apply_prefix(item2, item.link as Chapters)
+  //   );
+
   if (item?.link.startsWith("/") && prefix.endsWith("/")) {
     return { ...item, link: prefix.slice(0, -1) + item.link };
   } else if (!item.link.startsWith("/") && !prefix.endsWith("/")) {
@@ -50,28 +56,37 @@ export function apply_prefix(item: ChapterItem, prefix: Chapters) {
   return { ...item, link: prefix + item.link };
 }
 
-export const items_xrobot_api = [
+export const items_xrobot_api_server = [
   {
-    text: "API参考",
+    text: "服务端API参考",
     collapsed: false,
-    link: Chapters.xrobot_api,
+    link: Chapters.xrobot_api_server,
     items: [
       { text: "用户API", link: "user" },
       { text: "智能体API", link: "agent" },
       { text: "设备API", link: "device" },
       { text: "音色克隆API", link: "voice-clone" },
-    ].map((item) => apply_prefix(item, Chapters.xrobot_api)),
+    ].map((item) => apply_prefix(item, Chapters.xrobot_api_server)),
   },
 ];
 
-export const items_xrobot_api_server = [];
-export const items_xrobot_api_client = [];
+export const items_xrobot_api_client = [
+  {
+    text: "客户端API参考",
+    collapsed: false,
+    link: Chapters.xrobot_api_client,
+    items: [].map((item) => apply_prefix(item, Chapters.xrobot_api_client)),
+  },
+];
 
-export default {
-  items_xrobot_api,
-  items_xrobot_api_client,
-  items_xrobot_api_server,
-};
+export const items_xrobot_api = [
+  {
+    text: "API参考",
+    collapsed: false,
+    link: Chapters.xrobot_api,
+    items: [...items_xrobot_api_server, ...items_xrobot_api_client],
+  },
+];
 
 export const items_xrobot_guide_mp = [
   {
@@ -140,7 +155,7 @@ const items_xrobot = [
 
 function gobackItem(chapter: Chapters) {
   return {
-    text: "返回上级",
+    text: "< 返回上级",
     link: chapter,
     goback: true,
   };

docs/xrobot/api/client/index.md

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

docs/xrobot/api/agent.md docs/xrobot/api/server/agent.mddocs/xrobot/api/agent.md renamed to docs/xrobot/api/server/agent.md

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