feat(i18n): 文档站双语切换 locale (cookie + middleware IP 判断)

- 新建 middleware.ts：首次访问 /docs 时根据 IP geo / Accept-Language
  判断默认 locale，写入 cookie；默认 zh（社区主体语言）
- [...slug]/page.tsx: 从 cookie 读 locale，尝试加载 slug.en.mdx / slug.zh.mdx
  翻译版，不存在时静默 fallback 到原文（不展示碍眼横幅）
- docs-i18n-design.md: 完整双语化设计方案（frontmatter 约定、
  contributors 脚本改造、翻译流程、术语词表方向）

Author: longsizhuo

app/docs/[...slug]/page.tsx

@@ -16,6 +16,7 @@ import { LicenseNotice } from "@/app/components/LicenseNotice";
 import { PageFeedback } from "@/app/components/PageFeedback";
 import { DocHistoryPanel } from "@/app/components/DocHistoryPanel";
 import { DocShareButton } from "@/app/components/DocShareButton";
+import { cookies } from "next/headers";
 // Extract clean text content from MDX - no longer used on client/page side
 // content fetching moved to API route for performance
 
@@ -25,14 +26,60 @@ interface Param {
   }>;
 }
 
+/** 从 cookie 读取用户语言偏好，未设置时返回 null */
+async function getLocaleFromCookie(): Promise<"zh" | "en" | null> {
+  const cookieStore = await cookies();
+  const val = cookieStore.get("locale")?.value;
+  if (val === "zh" || val === "en") return val;
+  return null;
+}
+
+/**
+ * 根据 locale 尝试加载对应语言版本的文档。
+ * 翻译文件命名规则：原文 slug 最后一段加上语言后缀，例如
+ *   slug = ["ai", "rl"] → 英文版尝试 ["ai", "rl.en"]
+ *
+ * 若对应翻译版不存在，fallback 到原文。
+ */
+function getPageWithLocale(
+  slug: string[] | undefined,
+  locale: "zh" | "en" | null,
+) {
+  const originalPage = source.getPage(slug);
+  if (!locale || !slug || slug.length === 0)
+    return { page: originalPage, isFallback: false };
+
+  const originalLang =
+    (originalPage?.data as { lang?: string } | undefined)?.lang ?? null;
+
+  // 已经是目标语言，直接返回
+  if (originalLang === locale) return { page: originalPage, isFallback: false };
+
+  // 尝试加载翻译版：slug 末尾加语言后缀
+  const lastSegment = slug[slug.length - 1];
+  const translatedSlug = [...slug.slice(0, -1), `${lastSegment}.${locale}`];
+  const translatedPage = source.getPage(translatedSlug);
+
+  if (translatedPage) {
+    return { page: translatedPage, isFallback: false };
+  }
+
+  // 翻译版不存在，fallback 到原文
+  return { page: originalPage, isFallback: true };
+}
+
 export default async function DocPage({ params }: Param) {
   const { slug } = await params;
-  const page = source.getPage(slug);
+  const locale = await getLocaleFromCookie();
+  const { page } = getPageWithLocale(slug, locale);
 
   if (page == null) {
     notFound();
   }
 
+  // 静默 fallback：翻译版不存在时直接展示原文，不再显示"暂无英文版"横幅
+  // 原因：中文为默认语言，大多数文档本身就是中文；显示 banner 反而让 UI 碍眼
+
   // 统一通过工具函数生成 Edit 链接，内部已处理中文目录编码
   const editUrl = buildDocsEditUrl(page.path);
   const docIdFromPage =