feat: resolve incomplete path error 404 (#54)

Author: wuyiping0628

.vitepress/config.mts

@@ -77,7 +77,7 @@ export default defineConfig({
     'next-sdk/docs/:path*': 'next-sdk/:path*',
     'tiny-vue/examples/sites/demos/pc/webdoc/:path*': 'tiny-vue/guide/:path*',
     'tiny-engine/docs/:section(getting-started|basic-features|advanced-features|tutorials)/:path*':
-      'tiny-engine/engines/:path*',
+      'tiny-engine/guide/:path*',
     'tiny-engine/docs/:section(practical-cases|api|extension-capabilities-tutorial|development-getting-started|changelog|solutions|extension-capabilities-overview)/:path*':
       'tiny-engine/dev/:path*',
     'tiny-engine/docs/:section(ecosystem-center|about-applications|about-materials|about-designer)/:path*':
@@ -102,8 +102,8 @@ export default defineConfig({
     engineNav: [
       {
         text: '使用指南',
-        link: '/tiny-engine/engines/introduction',
-        activeMatch: '/engines/',
+        link: '/tiny-engine/guide/introduction',
+        activeMatch: '/guide/',
       },
       {
         text: '平台开发指南',
@@ -231,11 +231,11 @@ export default defineConfig({
           ]
         }
       ],
-      '/tiny-engine/engines/': [
+      '/tiny-engine/guide/': [
         {
           text: '新手指引',
           collapsed: false,
-          base: '/tiny-engine/engines/',
+          base: '/tiny-engine/guide/',
           items: [
             { text: '简介', link: 'introduction' },
             { text: '快速上手', link: 'quick-start' }
@@ -244,11 +244,10 @@ export default defineConfig({
         {
           text: '基础功能',
           collapsed: false,
-          base: '/tiny-engine/engines/',
+          base: '/tiny-engine/guide/',
           items: [
-            { text: '初识设计器', link: 'intro-to-designer' },
-            { text: '设计前端应用流程', link: 'frontend-application-flow' },
             { text: '设计器界面模块简介', link: 'designer-ui-modules' },
+            { text: '设计前端应用流程', link: 'frontend-application-flow' },
             { text: '页面管理', link: 'page-management' },
             { text: '使用组件', link: 'using-components' },
             { text: '样式设置', link: 'style-settings' },
@@ -262,7 +261,7 @@ export default defineConfig({
         {
           text: '进阶功能',
           collapsed: false,
-          base: '/tiny-engine/engines/',
+          base: '/tiny-engine/guide/',
           items: [
             { text: '区块管理', link: 'block-management' },
             { text: '使用JS面板和事件绑定', link: 'js-panel-and-event-binding' },
@@ -271,15 +270,14 @@ export default defineConfig({
             { text: '如何使用插槽', link: 'how-to-use-slots' },
             { text: '循环渲染', link: 'loop-rendering' },
             { text: '条件渲染', link: 'conditional-rendering' },
-            { text: '集成ChatGPT搭建简单页面能力', link: 'integrating-chatgpt-for-simple-pages' },
             { text: '新版AI插件使用', link: 'new-ai-plugin-usage' },
             { text: '数据源和Collection—远程字段', link: 'data-source-and-collection-remote-fields' },
             { text: '数据源和Collection—mock数据', link: 'data-source-and-collection-mock-data' },
             { text: '数据源和Collection—使用数据源', link: 'data-source-and-collection-usage' },
             {
               text: '路由功能',
               collapsed: false,
-              base: '/tiny-engine/engines/route-capabilities/',
+              base: '/tiny-engine/guide/route-capabilities/',
               items: [
                 { text: '页面支持嵌套路由', link: 'page-support-nested-route' },
                 { text: '路由bar一键清除预览页面路径', link: 'route-bar-clear-preview-page' },
@@ -294,7 +292,7 @@ export default defineConfig({
         {
           text: '教程',
           collapsed: false,
-          base: '/tiny-engine/engines/',
+          base: '/tiny-engine/guide/',
           items: [{ text: '从零搭建一个页面', link: 'build-a-page-from-scratch' }]
         }
       ],
@@ -388,7 +386,9 @@ export default defineConfig({
                 { text: '全局布局API', link: 'global-layout-api' },
                 { text: '物料API', link: 'material-api' },
                 { text: '设置面板API', link: 'settings-panel-api' },
-                { text: '预览API', link: 'preview-api' }
+                { text: '预览API', link: 'preview-api' },
+                { text: '元服务API', link: 'globalService-api' },
+                { text: '注册表API', link: 'registry-api' }
               ]
             },
             {

.vitepress/theme/Layout.vue

@@ -34,6 +34,7 @@ const docTitle = ref('指南')
 const { site,theme } = useData()
 const route = useRoute()
 const themeConfig = computed(() => theme.value)
+const router = useRouter();
 
 // 在客户端环境下同步 ColorModeSubject
 if (typeof window !== 'undefined') {
@@ -55,12 +56,51 @@ if (typeof window !== 'undefined') {
 // 获取 VitePress 默认布局组件
 const DefaultLayout = DefaultTheme.Layout
 
+// 定义重定向映射
+const redirectMap = [
+  { 
+    patterns: ['/tiny-engine.html', '/tiny-engine/', '/tiny-engine/guide.html', '/tiny-engine/guide/'],
+    target: '/tiny-engine/guide/introduction'
+  },
+  { 
+    patterns: ['/tiny-engine/dev/', '/tiny-engine/dev.html'],
+    target: '/tiny-engine/dev/dev-intro'
+  },
+  { 
+    patterns: ['/tiny-engine/portal/', '/tiny-engine/portal.html'],
+    target: '/tiny-engine/portal/ecosystem-intro'
+  },
+  { 
+    patterns: ['/tiny-vue.html', '/tiny-vue/', '/tiny-vue/guide.html', '/tiny-vue/guide/'],
+    target: '/tiny-vue/guide/introduce'
+  },
+  { 
+    patterns: ['/tiny-robot.html', '/tiny-robot/', '/tiny-robot/guide.html', '/tiny-robot/guide/'],
+    target: '/tiny-robot/guide/quick-start'
+  },
+  { 
+    patterns: ['/tiny-robot/examples/', '/tiny-robot/examples.html'],
+    target: '/tiny-robot/examples/assistant'
+  },
+  { 
+    patterns: ['/next-sdk.html', '/next-sdk/'],
+    target: '/next-sdk/guide'
+  }
+];
+
 // 将文档标题更新逻辑提取为独立函数，便于维护和测试
 const updateDocTitle = () => {
   const base = site.value?.base || '/'
   const path = route.path.replace(new RegExp(`^${base}`), '/')
   const cfg = themeConfig.value || {}
 
+  for (const { patterns, target } of redirectMap) {
+    if (patterns.includes(path)) {
+      router.go(target);
+      break;
+    }
+  }
+
   // next-sdk / tiny-vue: 从对应 sidebar 的 guide 中寻找匹配项
   if (path.includes('/next-sdk/') || path.includes('/tiny-vue/')) {
     let sidebarConfig: any[] = []

.vitepress/theme/components/CustomHeader.vue

@@ -478,7 +478,7 @@ const productTabs = computed(() => [
   {
     key: "tiny-engine",
     name: "TinyEngine",
-    link: `${prefix}tiny-engine/engines/introduction`,
+    link: `${prefix}tiny-engine/guide/introduction`,
     src: `${prefix}images/logo-${
       activeProductTab.value === "tiny-engine" ? "active" : "normal"
     }-tiny-engine.svg`,
@@ -514,6 +514,13 @@ watch(
   },
   { deep: true, immediate: true }
 );
+watch(
+  () => navigationTabs.value,
+  () => {
+    getActiveNavTab();
+  },
+  { deep: true, immediate: true }
+);
 </script>
 
 <style lang="less" scoped>

.vitepress/theme/style.css

@@ -540,6 +540,10 @@ info{
 .vp-doc :not(pre) > code{
   padding:0 6px;
 }
+img.image-inline {
+  display: inline-block;
+  margin: 0;
+}
 
 /* 暗色模式下全局样式 */
 .dark h1{