fix(docs): 服务端 308 自愈历史路径，替代客户端 not-found.tsx 跳转

原 not-found.tsx 是 "use client"：服务端先回 HTTP 404，JS 再跳。
Googlebot 不执行 JS，GSC 仍报 404，SEO 目标未达成。

修法：去掉 dynamic="force-static"，让未知 slug 走 SSR。在 DocPage
里 page == null 时先查后端 resolve 端点，命中历史路径就
permanentRedirect()（Next.js 发 308），再不认识才 notFound()。

已知路径（generateStaticParams 列出的 304 条）仍然 SSG，正常
页面 TTFB 无额外开销。build 表验证：● SSG 路径不变，ƒ Dynamic
新增（专门接收未知路径的 SSR 兜底）。

验收：curl -sI https://involutionhell.com/zh/docs/community/dev-tips/git101
应看到 308 + Location，不是 404。

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Author: github-actions[bot]

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

@@ -3,7 +3,7 @@ import { safeJsonLdString } from "@/lib/json-ld";
 import { SITE_URL } from "@/lib/site-url";
 import { ensureSeoDescription } from "@/lib/seo-description";
 import { DocsPage, DocsBody } from "fumadocs-ui/page";
-import { notFound } from "next/navigation";
+import { notFound, permanentRedirect } from "next/navigation";
 import type { Metadata } from "next";
 import { setRequestLocale } from "next-intl/server";
 import { hasLocale } from "next-intl";
@@ -24,18 +24,50 @@ import { DocShareButton } from "@/app/components/DocShareButton";
 import { routing } from "@/i18n/routing";
 import { type PageData } from "@/app/types/doc";
 
+const BACKEND_URL = process.env.BACKEND_URL ?? "http://localhost:8080";
+
+/**
+ * 查询后端 resolve 端点，未知路径可能是历史重命名路径。
+ * 返回 canonical URL（如 /docs/learn/cs/dev-tips/git101）或 null。
+ * 后端 Caffeine 缓存 TTL=600s，命中率高，延迟可控。
+ */
+async function resolveDocPath(
+  locale: string,
+  slug: string[],
+): Promise<string | null> {
+  const strippedPath = `/docs/${slug.join("/")}`;
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 400);
+    const res = await fetch(
+      `${BACKEND_URL}/api/docs/resolve?path=${encodeURIComponent(strippedPath)}`,
+      { redirect: "manual", signal: controller.signal, cache: "no-store" },
+    );
+    clearTimeout(timeout);
+    if (res.status === 301 || res.status === 308) {
+      const loc = res.headers.get("Location");
+      // loc === strippedPath 意味着当前路径已是 canonical，不跳
+      if (loc && loc !== strippedPath) {
+        return `/${locale}${loc}`;
+      }
+    }
+  } catch {
+    // 超时或后端不可达：降级到 notFound()
+  }
+  return null;
+}
+
 interface Param {
   params: Promise<{
     locale: string;
     slug?: string[];
   }>;
 }
 
-// 显式声明 force-static：让 Next.js 严格按 generateStaticParams 预渲染
-// 所有 (locale, slug) 组合，未列出的不允许动态生成。
-// 没有这条时，build 表里 ƒ Dynamic 标签会让 docs 走运行时渲染（即使加了
-// setRequestLocale 也不一定 prerender）。
-export const dynamic = "force-static";
+// dynamicParams=true（默认值）：generateStaticParams 列出的路径 SSG 预渲染，
+// 未列出的路径（包括历史旧路径）走运行时 SSR，在 DocPage 里做 resolve → permanentRedirect。
+// 不写 dynamic="force-static"：让未知路径能够 SSR，而不是直接 404。
+// 已知路径仍然走 SSG（generateStaticParams 命中），正常页面 TTFB 不受影响。
 
 export default async function DocPage({ params }: Param) {
   const { locale, slug } = await params;
@@ -47,6 +79,11 @@ export default async function DocPage({ params }: Param) {
   // 找不到时按 source.ts 配的 fallbackLanguage='zh' 回退到原文。
   const page = source.getPage(slug, locale);
   if (page == null) {
+    // slug 不在 SSG 列表里：查历史路径表，命中则服务端 308（Googlebot 可跟）
+    const redirectTarget = await resolveDocPath(locale, slug ?? []);
+    if (redirectTarget) {
+      permanentRedirect(redirectTarget);
+    }
     notFound();
   }
 
@@ -181,6 +218,11 @@ export async function generateMetadata({ params }: Param): Promise<Metadata> {
 
   const page = source.getPage(slug, locale);
   if (page == null) {
+    // generateMetadata 同步 page.tsx 的跳转逻辑，避免 metadata 和页面不一致
+    const redirectTarget = await resolveDocPath(locale, slug ?? []);
+    if (redirectTarget) {
+      permanentRedirect(redirectTarget);
+    }
     notFound();
   }