docs(agent-tars): fix showcase not found (#1708)

Author: ulivz

multimodal/pnpm-lock.yaml

@@ -14,10 +14,12 @@ to = "https://preview.agent-tars.com/doc/*"
 [[redirects]]
 from = "/showcase/*"
 to = "/showcase"
+status = 200
 
 [[redirects]]
 from = "/replay/*"
 to = "/replay"
+status = 200
 
 [[redirects]]
 from = "/wechat-intro"

multimodal/websites/docs/docs/en/guide/get-started/sdk.mdx

@@ -8,8 +8,7 @@
     "preview": "rspress preview"
   },
   "dependencies": {
-    "@rspress/core": "2.0.0-beta.31",
-    "@rspress/theme-default": "2.0.0-beta.31",
+    "@rspress/core": "2.0.0-beta.34",
     "react-icons": "5.5.0",
     "framer-motion": "12.19.2",
     "tailwindcss": "^3.4.17",
@@ -25,7 +24,6 @@
     "@types/react": "^18.2.75",
     "@types/react-dom": "^18.2.24",
     "@tarko/agent": "workspace:*",
-    "@rspress/plugin-client-redirects": "2.0.0-beta.31",
     "@types/node": "^18.11.17",
     "rspress-plugin-mermaid": "^0.3.0"
   }

multimodal/websites/docs/docs/public/netlify.toml

@@ -1,13 +1,12 @@
 import * as path from 'node:path';
 import { defineConfig } from '@rspress/core';
 import mermaid from 'rspress-plugin-mermaid';
-import { pluginClientRedirects } from '@rspress/plugin-client-redirects';
+
 import { SEO_CONFIG } from './src/shared/seoConfig';
 
 const isProd = process.env.NODE_ENV === 'production';
 
 export default defineConfig({
-  root: path.join(__dirname, 'docs'),
   lang: 'en',
   title: SEO_CONFIG.siteName,
   icon: SEO_CONFIG.images.favicon,
@@ -16,7 +15,10 @@ export default defineConfig({
     light: '/agent-tars-dark-logo.png',
     dark: '/agent-tars-dark-logo.png',
   },
+  // Disable SSG to allow client-side routing for dynamic paths
+  ssg: false,
   route: {
+    cleanUrls: true,
     exclude: isProd
       ? [
           'en/sdk/**',
@@ -79,9 +81,6 @@ export default defineConfig({
         fontSize: 16,
       },
     }),
-    pluginClientRedirects({
-      redirects: [],
-    }),
   ],
   themeConfig: {
     darkMode: false,

multimodal/websites/docs/docs/zh/guide/get-started/sdk.mdx

@@ -1,16 +1,27 @@
-
 import { Layout as BasicLayout } from '@rspress/core/theme';
 import { NotFoundLayout } from '../src/components';
 import { Showcase } from '../src/components/Showcase';
 import { Replay } from '../src/components/Replay';
 import { useLocation } from '@rspress/core/runtime';
-import { Nav } from '@rspress/theme-default';
+import { Nav } from '@rspress/core/theme';
 import { DYNAMIC_ROUTE } from '../src/shared/types';
 
 const Layout = () => {
   const location = useLocation();
 
+  // Debug logging
+  console.log('🔍 Layout Debug:', {
+    pathname: location.pathname,
+    showcaseRoute: DYNAMIC_ROUTE.Showcase,
+    replayRoute: DYNAMIC_ROUTE.Replay,
+    startsWithShowcase: location.pathname.startsWith(DYNAMIC_ROUTE.Showcase),
+    startsWithReplay: location.pathname.startsWith(DYNAMIC_ROUTE.Replay),
+  });
+
+  // Handle showcase routes - both /showcase and /showcase/*
+  // This needs to be checked BEFORE BasicLayout to override rspress routing
   if (location.pathname.startsWith(DYNAMIC_ROUTE.Showcase)) {
+    console.log('✅ Rendering Showcase component for path:', location.pathname);
     return (
       <>
         <Nav />
@@ -19,7 +30,9 @@ const Layout = () => {
     );
   }
 
+  // Handle replay routes - both /replay and /replay/*
   if (location.pathname.startsWith(DYNAMIC_ROUTE.Replay)) {
+    console.log('✅ Rendering Replay component for path:', location.pathname);
     return (
       <>
         <Nav />
@@ -28,6 +41,7 @@ const Layout = () => {
     );
   }
 
+  console.log('⚠️ Falling back to BasicLayout with NotFoundLayout for path:', location.pathname);
   return <BasicLayout NotFoundLayout={NotFoundLayout} />;
 };