fix(rank): 热门文档榜链接补 locale 前缀，直达 canonical 不再 404 (#362)

后端 top-docs 返回的 path 是无 locale 的 canonical（/docs/...）。HotDocsTab /
HotDocsPreview 之前直接 <Link href={doc.path}>，配合后端旧 bug 渲染出
/en/content/docs/... 死链。

新增 lib/top-doc-href.ts：拼当前 locale 前缀 + 防御性剥掉残留 content/ 前缀，
两个组件共用。即使后端某次回退到旧格式也不会再拼出 404。

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: 3 people

app/components/HotDocsPreview.tsx

@@ -2,7 +2,8 @@
 
 import { useEffect, useState } from "react";
 import Link from "next/link";
-import { useTranslations } from "next-intl";
+import { useLocale, useTranslations } from "next-intl";
+import { topDocHref } from "@/lib/top-doc-href";
 
 interface TopDocDto {
   path: string;
@@ -56,6 +57,7 @@ export function HotDocsPreviewSkeleton() {
  */
 export function HotDocsPreview() {
   const t = useTranslations("hotDocs");
+  const locale = useLocale();
   const [docs, setDocs] = useState<TopDocDto[] | null>(null);
 
   useEffect(() => {
@@ -114,7 +116,7 @@ export function HotDocsPreview() {
               </span>
               <div className="flex-1 min-w-0">
                 <Link
-                  href={doc.path}
+                  href={topDocHref(locale, doc.path)}
                   className="font-serif text-sm font-bold uppercase text-[var(--foreground)] hover:text-[#CC0000] transition-colors leading-tight line-clamp-2 block"
                   data-umami-event="navigation_click"
                   data-umami-event-region="hot_docs_preview"

app/components/rank/HotDocsTab.tsx

@@ -2,6 +2,8 @@
 
 import { useReducer, useEffect } from "react";
 import Link from "next/link";
+import { useLocale } from "next-intl";
+import { topDocHref } from "@/lib/top-doc-href";
 
 type HotDoc = {
   path: string;
@@ -38,6 +40,7 @@ function reducer(_: State, action: Action): State {
 // 从根拔掉逃生门，同源代理永远成立；想 curl 测后端就直连 api 域名。
 
 export function HotDocsTab({ initialWindow }: { initialWindow: WindowParam }) {
+  const locale = useLocale();
   const [windowParam, setWindowParam] = useReducer(
     (_: WindowParam, next: WindowParam) => next,
     initialWindow,
@@ -165,7 +168,7 @@ export function HotDocsTab({ initialWindow }: { initialWindow: WindowParam }) {
           {state.docs.map((doc, idx) => (
             <Link
               key={doc.path}
-              href={doc.path}
+              href={topDocHref(locale, doc.path)}
               className="group w-full flex items-center gap-4 border border-[var(--foreground)] p-4 bg-[var(--background)] hard-shadow-hover transition-all"
             >
               <div className="font-mono text-2xl font-bold w-12 text-center text-[var(--foreground)] shrink-0">

lib/top-doc-href.ts

@@ -0,0 +1,11 @@
+/**
+ * top-docs（热门文档榜）后端返回的 path 是无 locale 的 canonical（形如 /docs/learn/ai）。
+ * 拼上当前 locale 前缀得到可点击 URL。
+ *
+ * 防御性归一化：剥掉可能残留的 content/ 前缀和多余前导斜杠，避免后端某次回退到
+ * 旧格式（content/docs/...）时前端直接拼出 /en/content/docs/... 死链。
+ */
+export function topDocHref(locale: string, path: string): string {
+  const clean = "/" + path.replace(/^\/+/, "").replace(/^content\//, "");
+  return `/${locale}${clean}`;
+}