feat: implement language detection for Chinese users

Author: OreoYang

docusaurus.config.js

@@ -15,6 +15,8 @@ const config = {
     botId: process.env.BOT_ID,
     patToken: process.env.TOKEN
   },
+  // Add client module for language detection
+  clientModules: [require.resolve('./src/clientModules/lang-redirect.js')],
   markdown: {
     hooks: {
       onBrokenMarkdownLinks: 'warn',

src/clientModules/lang-redirect.js

@@ -0,0 +1,41 @@
+/**
+ * Docusaurus Client Module for Language Detection
+ * This module runs on the client side and handles browser language detection
+ */
+export function onRouteDidUpdate({ location, previousLocation }) {
+  // Only run on root path
+  if (location.pathname !== '/' && location.pathname !== '/index.html') {
+    return;
+  }
+
+  // Check if user has an existing locale preference (manual language selection)
+  const savedLocale = localStorage.getItem('docusaurus.locale');
+  if (savedLocale === 'en') {
+    // User explicitly chose English, respect it and don't redirect
+    return;
+  }
+
+  if (savedLocale === 'zh-CN') {
+    // User chose Chinese, no need to redirect
+    return;
+  }
+
+  // Check if this is the first visit to the root path in this session
+  if (sessionStorage.getItem('clientLangDetectionDone')) {
+    return;
+  }
+
+  // Detect browser language
+  const browserLang = navigator.language || navigator.userLanguage || '';
+
+  // Redirect Chinese users to Chinese version
+  if (browserLang.toLowerCase().startsWith('zh')) {
+    // Mark as done before redirecting to prevent loops
+    sessionStorage.setItem('clientLangDetectionDone', '1');
+    // Redirect Chinese users to Chinese version
+    window.location.replace('/zh-CN/');
+  } else {
+    // Mark as done for non-Chinese users too
+    sessionStorage.setItem('clientLangDetectionDone', '1');
+  }
+}

static/_redirects

@@ -1,4 +1,6 @@
 # Redirect users from China to chinese version at /zh-CN.
-/  /zh-cn 302! Country=cn
-# Also users with Chinese language should be redirected to /zh-cn
-# / /zh-cn 302! Language=zh
+# Disabled - relying on client-side browser language detection instead
+# The ! flag causes forced redirects that prevent manual language switching
+# /  /zh-CN 302 Country=cn
+# Also users with Chinese language should be redirected to /zh-CN
+# /  /zh-CN 302 Language=zh