diff --git a/app/api/docs/history/route.ts b/app/api/docs/history/route.ts
deleted file mode 100644
index 714799a4..00000000
--- a/app/api/docs/history/route.ts
+++ /dev/null
@@ -1,158 +0,0 @@
-import { NextRequest, NextResponse } from "next/server";
-import type { HistoryItem } from "@/app/types/docs-history";
-
-// 响应缓存 1 小时，GitHub API 每小时限额 5000 次（authenticated）
-export const revalidate = 3600;
-
-interface GitHubCommit {
-  sha: string;
-  commit: {
-    author: {
-      name: string;
-      date: string;
-    };
-    message: string;
-  };
-  author: {
-    login: string;
-    avatar_url: string;
-  } | null;
-  html_url: string;
-}
-
-/**
- * 规范化前端传入的文档路径为仓库根相对路径（GitHub API 要求）。
- *
- * 接受的输入形态：
- * - `app/docs/ai/...`（仓库根相对）→ 原样返回
- * - `docs/ai/...` → 前面补 `app/`
- * - `/docs/ai/...`（浏览器 URL 风格）→ 去开头斜杠再补 `app/`
- *
- * 拒绝：含 `..`、反斜杠、null 字节；最终不落在 `app/docs/` 下的路径一律拒绝，
- * 避免用服务端 GITHUB_TOKEN 被动泄露仓库内任意文件的 commit 信息。
- */
-function normalizeDocsPath(raw: string): string | null {
-  if (!raw) return null;
-  // 路径穿越 / 反斜杠 / null 字节 直接拒
-  if (raw.includes("..") || raw.includes("\\") || raw.includes("\0")) {
-    return null;
-  }
-
-  let normalized = raw;
-  // URL 风格 /docs/... → docs/...
-  if (normalized.startsWith("/")) {
-    normalized = normalized.slice(1);
-  }
-  // docs/... → app/docs/...
-  if (normalized.startsWith("docs/")) {
-    normalized = `app/${normalized}`;
-  }
-  // fumadocs 的 page.file.path 返回"相对 app/docs/"路径（如 ai/xxx/index.mdx）
-  // 而不是仓库根。这里补上前缀，和 page.tsx 传参保持兼容。
-  if (!normalized.startsWith("app/")) {
-    normalized = `app/docs/${normalized}`;
-  }
-  // 必须落在 app/docs/ 下才放行
-  if (!normalized.startsWith("app/docs/")) {
-    return null;
-  }
-  return normalized;
-}
-
-export async function GET(req: NextRequest) {
-  const { searchParams } = new URL(req.url);
-  const rawPath = searchParams.get("path");
-
-  const path = rawPath ? normalizeDocsPath(rawPath) : null;
-  if (!path) {
-    return NextResponse.json(
-      {
-        success: false,
-        error: "缺少合法的 path 参数（仅允许 app/docs/ 路径）",
-      },
-      { status: 400 },
-    );
-  }
-
-  const token = process.env.GITHUB_TOKEN;
-  if (!token) {
-    return NextResponse.json(
-      { success: false, error: "服务端未配置 GITHUB_TOKEN" },
-      { status: 500 },
-    );
-  }
-
-  const apiUrl = `https://api.github.com/repos/InvolutionHell/involutionhell/commits?path=${encodeURIComponent(path)}&per_page=5`;
-
-  let res: Response;
-  try {
-    res = await fetch(apiUrl, {
-      headers: {
-        Authorization: `Bearer ${token}`,
-        Accept: "application/vnd.github+json",
-        "X-GitHub-Api-Version": "2022-11-28",
-      },
-      // Next.js fetch 缓存，与 revalidate 配合
-      next: { revalidate: 3600 },
-    });
-  } catch {
-    return NextResponse.json(
-      { success: false, error: "无法连接 GitHub API" },
-      { status: 502 },
-    );
-  }
-
-  // 403 可能是限流、也可能是 token 权限不足 / 仓库不可访问；用 x-ratelimit-remaining 区分
-  if (res.status === 403) {
-    const rateRemaining = res.headers.get("x-ratelimit-remaining");
-    if (rateRemaining === "0") {
-      return NextResponse.json(
-        { success: false, error: "GitHub API 限流，请稍后重试" },
-        { status: 429 },
-      );
-    }
-    return NextResponse.json(
-      { success: false, error: "GitHub API 403（可能 token 权限不足）" },
-      { status: 403 },
-    );
-  }
-
-  if (res.status === 401) {
-    return NextResponse.json(
-      { success: false, error: "GitHub token 无效或过期" },
-      { status: 401 },
-    );
-  }
-
-  if (!res.ok) {
-    return NextResponse.json(
-      { success: false, error: `GitHub API 返回 ${res.status}` },
-      { status: 502 },
-    );
-  }
-
-  const commits: GitHubCommit[] = await res.json();
-
-  const data: HistoryItem[] = commits.map((c) => ({
-    sha: c.sha,
-    authorName: c.commit.author.name,
-    // author 为 null 时（commit 作者邮箱未关联 GitHub 账号），login 退回展示名
-    authorLogin: c.author?.login ?? c.commit.author.name,
-    // commit.author.name 是展示名（可能含中文/空格），拼 github.com/<name>.png 容易 404；
-    // 仅在有真实 author 时用其 avatar_url，否则返回空串让前端用占位资源
-    avatarUrl: c.author?.avatar_url ?? "",
-    date: c.commit.author.date,
-    // 只取 commit message 第一行
-    message: c.commit.message.split("\n")[0],
-    htmlUrl: c.html_url,
-  }));
-
-  return NextResponse.json(
-    { success: true, data },
-    {
-      headers: {
-        "Cache-Control": "public, s-maxage=3600, stale-while-revalidate=86400",
-      },
-    },
-  );
-}
diff --git a/app/components/AuthNav.tsx b/app/components/AuthNav.tsx
index 5bf3f779..20f39d00 100644
--- a/app/components/AuthNav.tsx
+++ b/app/components/AuthNav.tsx
@@ -17,6 +17,8 @@ export function AuthNav() {
         name: user.displayName,
         email: user.email ?? null,
         image: user.avatarUrl ?? null,
+        // 透传 githubId，让 UserMenu 渲染"我的主页"入口
+        githubId: user.githubId ?? null,
       }}
       provider="github"
       logout={logout}
diff --git a/app/components/Header.tsx b/app/components/Header.tsx
index 25f5657b..7d03d45d 100644
--- a/app/components/Header.tsx
+++ b/app/components/Header.tsx
@@ -30,24 +30,32 @@ export function Header() {
         </div>
 
         <div className="flex items-center justify-between h-10">
+          {/*
+            导航对齐当前信息架构（2026-04 重构后）：
+            - 去掉"首页"：左上角 BrandMark 已经是回首页入口，避免冗余
+            - 去掉"特点"：Features 组件已经删除，旧的 /#features 锚点不存在
+            - 文档 / 排行榜：站点两大主路由，提到顶
+            - 社区：保留 /#community 锚点（指向首页底部 DispatchNetwork 的 GitHub/Discord/Zotero bar）
+            - 联系：缩写自"联系我们"，/#contact 还在 Footer 里
+          */}
           <nav className="hidden md:flex items-center gap-8 font-sans text-xs font-bold uppercase tracking-widest text-[var(--foreground)]">
             <Link
-              href="/"
+              href="/docs"
               className="hover:text-[#CC0000] transition-colors"
               data-umami-event="navigation_click"
               data-umami-event-region="header"
-              data-umami-event-label="home"
+              data-umami-event-label="docs"
             >
-              首页
+              文档
             </Link>
             <Link
-              href="/#features"
+              href="/rank"
               className="hover:text-[#CC0000] transition-colors"
               data-umami-event="navigation_click"
               data-umami-event-region="header"
-              data-umami-event-label="features"
+              data-umami-event-label="rank"
             >
-              特点
+              排行榜
             </Link>
             <Link
               href="/#community"
@@ -65,7 +73,7 @@ export function Header() {
               data-umami-event-region="header"
               data-umami-event-label="contact"
             >
-              联系我们
+              联系
             </Link>
           </nav>
 
diff --git a/app/components/UserMenu.tsx b/app/components/UserMenu.tsx
index 8eabd045..06370b3e 100644
--- a/app/components/UserMenu.tsx
+++ b/app/components/UserMenu.tsx
@@ -12,6 +12,8 @@ interface UserMenuProps {
     name?: string | null;
     email?: string | null;
     image?: string | null;
+    /** GitHub 数字 ID，用于拼个人主页 URL /u/{githubId} */
+    githubId?: number | null;
   };
   provider?: string;
   // 退出登录回调，由父组件传入（来自 useAuth().logout）
@@ -58,6 +60,17 @@ export function UserMenu({ user, provider, logout }: UserMenuProps) {
           ) : null}
         </div>
 
+        {/* 个人主页入口：只有拿到 githubId 的登录用户才显示，避免老账号 githubId 为 null 时跳 404 */}
+        {user.githubId != null && (
+          <Link
+            href={`/u/${user.githubId}`}
+            className="block px-4 py-2 text-sm text-neutral-900 dark:text-neutral-100 transition hover:bg-neutral-100 dark:hover:bg-neutral-800"
+            data-umami-event="user_menu_profile_click"
+          >
+            我的主页
+          </Link>
+        )}
+
         {/* 设置入口：登录用户均可见，指向 /settings 偏好页 */}
         <Link
           href="/settings"
diff --git a/app/components/rank/ContributorRow.tsx b/app/components/rank/ContributorRow.tsx
index c59cc553..ecc9e358 100644
--- a/app/components/rank/ContributorRow.tsx
+++ b/app/components/rank/ContributorRow.tsx
@@ -102,17 +102,27 @@ export function ContributorRow({
                     Contributions Dossier
                   </Dialog.Description>
 
-                  {/* GitHub 个人主页跳转链接，带有 Umami 点击事件追踪埋点 */}
-                  <a
-                    href={`https://github.com/${user.name}`}
-                    target="_blank"
-                    rel="noopener noreferrer"
-                    className="inline-flex items-center gap-1 font-mono text-xs uppercase tracking-widest text-[var(--foreground)]/70 hover:text-[#CC0000] transition-colors w-max"
-                    data-umami-event="click_github_profile"
-                    data-umami-event-user={user.name}
-                  >
-                    GITHUB PROFILE <ExternalLink className="w-3 h-3" />
-                  </a>
+                  {/* 本站个人主页 + GitHub 主页两个入口 */}
+                  <div className="flex flex-wrap items-center gap-x-4 gap-y-1">
+                    <Link
+                      href={`/u/${user.id}`}
+                      className="inline-flex items-center gap-1 font-mono text-xs uppercase tracking-widest text-[var(--foreground)] hover:text-[#CC0000] transition-colors w-max font-bold"
+                      data-umami-event="click_site_profile"
+                      data-umami-event-user={user.name}
+                    >
+                      VIEW DOSSIER →
+                    </Link>
+                    <a
+                      href={`https://github.com/${user.name}`}
+                      target="_blank"
+                      rel="noopener noreferrer"
+                      className="inline-flex items-center gap-1 font-mono text-xs uppercase tracking-widest text-[var(--foreground)]/70 hover:text-[#CC0000] transition-colors w-max"
+                      data-umami-event="click_github_profile"
+                      data-umami-event-user={user.name}
+                    >
+                      GITHUB <ExternalLink className="w-3 h-3" />
+                    </a>
+                  </div>
                 </div>
 
                 {/* 贡献统计数据展示 */}
diff --git a/app/layout.tsx b/app/layout.tsx
index 95735220..a004dd34 100644
--- a/app/layout.tsx
+++ b/app/layout.tsx
@@ -12,6 +12,7 @@ import { AuthProvider } from "@/lib/use-auth";
 // import { SearchWrapper } from "@/app/components/SearchWrapper";
 import { CustomSearchDialog } from "@/app/components/CustomSearchDialog";
 import { cookies } from "next/headers";
+import { LocaleProvider } from "@/lib/i18n/client";
 
 const geistSans = localFont({
   src: "./fonts/GeistVF.woff",
@@ -209,25 +210,32 @@ export default async function RootLayout({
         className={`${geistSans.variable} ${geistMono.variable} antialiased`}
       >
         <div className="site-bg site-bg--stars" aria-hidden />
-        <ThemeProvider defaultTheme="dark" storageKey="ih-theme">
-          <AuthProvider>
-            <RootProvider
-              // 禁用 fumadocs 内置的 next-themes，避免与我们自己的 ThemeProvider（storageKey: ih-theme）
-              // 同时往 <html class> 写 light/dark 导致闪烁和状态不同步
-              theme={{ enabled: false }}
-              search={{
-                SearchDialog: CustomSearchDialog,
-                // 使用静态索引，兼容 next export 与本地开发
-                options: { type: "static", api: searchApi },
-              }}
-            >
-              <main id="main-content" className="relative z-10">
-                {children}
-              </main>
-              <UmamiIdentity />
-            </RootProvider>
-          </AuthProvider>
-        </ThemeProvider>
+        {/*
+          LocaleProvider 把服务端读出的 locale 注入客户端 Context，
+          客户端组件通过 useT() 拿到翻译函数，保持 SSR/CSR 一致，
+          不在客户端重新读 cookie 避免水合抖动。
+        */}
+        <LocaleProvider locale={locale}>
+          <ThemeProvider defaultTheme="dark" storageKey="ih-theme">
+            <AuthProvider>
+              <RootProvider
+                // 禁用 fumadocs 内置的 next-themes，避免与我们自己的 ThemeProvider（storageKey: ih-theme）
+                // 同时往 <html class> 写 light/dark 导致闪烁和状态不同步
+                theme={{ enabled: false }}
+                search={{
+                  SearchDialog: CustomSearchDialog,
+                  // 使用静态索引，兼容 next export 与本地开发
+                  options: { type: "static", api: searchApi },
+                }}
+              >
+                <main id="main-content" className="relative z-10">
+                  {children}
+                </main>
+                <UmamiIdentity />
+              </RootProvider>
+            </AuthProvider>
+          </ThemeProvider>
+        </LocaleProvider>
         {/* 谷歌分析 */}
         <Script
           src="https://www.googletagmanager.com/gtag/js?id=G-ED4GVN8YVW"
diff --git a/app/u/[username]/ActivityHeatmap.tsx b/app/u/[username]/ActivityHeatmap.tsx
new file mode 100644
index 00000000..e019bb2a
--- /dev/null
+++ b/app/u/[username]/ActivityHeatmap.tsx
@@ -0,0 +1,179 @@
+import { getServerT } from "@/lib/i18n/server";
+import type { MessageKey } from "@/lib/i18n/messages";
+
+/**
+ * 活跃度热力图 — GitHub 贡献图风格。
+ * 数据源：leaderboard JSON 里的 dailyCounts（build-time 生成，零运行时 DB 查询）。
+ *
+ * 渲染规则：
+ * - 固定显示过去 52 周（364 天）
+ * - 列 = 周（左老右新），行 = 周一到周日
+ * - 色阶按当日贡献次数分 5 档：0 / 1-2 / 3-5 / 6-10 / 10+
+ * - 无 JS 交互，纯 server component，CSS title 原生 tooltip
+ */
+
+interface Props {
+  /** 键 = "YYYY-MM-DD"，值 = 当日贡献次数（commits） */
+  dailyCounts: Record<string, number>;
+}
+
+const WEEKS = 52;
+const DAY_MS = 24 * 60 * 60 * 1000;
+
+function getBucket(count: number): number {
+  if (count <= 0) return 0;
+  if (count <= 2) return 1;
+  if (count <= 5) return 2;
+  if (count <= 10) return 3;
+  return 4;
+}
+
+function formatDay(d: Date): string {
+  return d.toISOString().slice(0, 10);
+}
+
+export async function ActivityHeatmap({ dailyCounts }: Props) {
+  const t = await getServerT();
+  // 以今天为右边界，往前 52 周；按周对齐：从上上周日起（GitHub 图的起点）
+  const today = new Date();
+  today.setUTCHours(0, 0, 0, 0);
+
+  // 找到本周日作为右上角的终点
+  const todayDow = today.getUTCDay(); // 0=Sun
+  const lastSun = new Date(today.getTime() - todayDow * DAY_MS);
+  const start = new Date(lastSun.getTime() - (WEEKS - 1) * 7 * DAY_MS);
+
+  // 构造 WEEKS × 7 的二维网格
+  const grid: Array<Array<{ day: string; count: number } | null>> = [];
+  let total = 0;
+  let activeDays = 0;
+
+  for (let w = 0; w < WEEKS; w++) {
+    const week: Array<{ day: string; count: number } | null> = [];
+    for (let d = 0; d < 7; d++) {
+      const date = new Date(start.getTime() + (w * 7 + d) * DAY_MS);
+      if (date > today) {
+        week.push(null); // 未来的格子留空
+        continue;
+      }
+      const key = formatDay(date);
+      const count = dailyCounts[key] ?? 0;
+      total += count;
+      if (count > 0) activeDays++;
+      week.push({ day: key, count });
+    }
+    grid.push(week);
+  }
+
+  // 月份标签：找到每列第一个周日的月份变化点
+  const monthLabels: Array<{ col: number; label: string }> = [];
+  let lastMonth = -1;
+  for (let w = 0; w < WEEKS; w++) {
+    const first = grid[w][0];
+    if (!first) continue;
+    const d = new Date(first.day);
+    const m = d.getUTCMonth();
+    if (m !== lastMonth) {
+      // locale 驱动月份：zh 显示 "1月 2月 ..."，en 显示 "Jan Feb ..."
+      const key = `activity.month.${m + 1}` as MessageKey;
+      monthLabels.push({ col: w, label: t(key) });
+      lastMonth = m;
+    }
+  }
+
+  return (
+    <section className="border border-[var(--foreground)] p-6 lg:p-8 flex flex-col gap-4">
+      <div className="flex items-baseline justify-between gap-3 flex-wrap">
+        <div>
+          <div className="font-mono text-[10px] uppercase tracking-widest text-neutral-500">
+            {t("activity.sec")}
+          </div>
+          <h3 className="font-serif text-xl font-black uppercase mt-1 text-[var(--foreground)]">
+            {t("activity.heading")}
+          </h3>
+        </div>
+        <div className="font-mono text-[11px] text-neutral-500">
+          {t("activity.stats", {
+            days: activeDays.toLocaleString(),
+            commits: total.toLocaleString(),
+          })}
+        </div>
+      </div>
+
+      {/* 月份刻度 */}
+      <div
+        className="grid gap-[3px] text-[9px] font-mono text-neutral-500 pl-4"
+        style={{ gridTemplateColumns: `repeat(${WEEKS}, minmax(0, 1fr))` }}
+      >
+        {Array.from({ length: WEEKS }).map((_, w) => {
+          const label = monthLabels.find((m) => m.col === w);
+          return (
+            <div key={w} className="min-w-0">
+              {label ? label.label : ""}
+            </div>
+          );
+        })}
+      </div>
+
+      {/* 网格 + 左侧周几刻度 */}
+      <div className="flex gap-1">
+        {/* 周几刻度（周一 / 周四） */}
+        <div className="flex flex-col justify-between font-mono text-[9px] text-neutral-500 py-0.5">
+          <span></span>
+          <span>{t("activity.weekday.mon")}</span>
+          <span></span>
+          <span>{t("activity.weekday.thu")}</span>
+          <span></span>
+          <span>{t("activity.weekday.sat")}</span>
+          <span></span>
+        </div>
+
+        {/* 主体网格：52 列 × 7 行 */}
+        <div
+          className="grid gap-[3px] flex-1"
+          style={{ gridTemplateColumns: `repeat(${WEEKS}, minmax(0, 1fr))` }}
+        >
+          {grid.map((week, w) => (
+            <div key={w} className="grid grid-rows-7 gap-[3px]">
+              {week.map((cell, d) => {
+                if (!cell) {
+                  return <div key={d} className="aspect-square" aria-hidden />;
+                }
+                const bucket = getBucket(cell.count);
+                return (
+                  <div
+                    key={d}
+                    title={`${cell.day}: ${cell.count} commits`}
+                    className={[
+                      "aspect-square border border-[var(--foreground)]/30",
+                      bucket === 0
+                        ? "bg-[var(--background)]"
+                        : bucket === 1
+                          ? "bg-[#CC0000]/20"
+                          : bucket === 2
+                            ? "bg-[#CC0000]/40"
+                            : bucket === 3
+                              ? "bg-[#CC0000]/70"
+                              : "bg-[#CC0000]",
+                    ].join(" ")}
+                  />
+                );
+              })}
+            </div>
+          ))}
+        </div>
+      </div>
+
+      {/* 图例 */}
+      <div className="flex items-center gap-2 font-mono text-[9px] text-neutral-500 self-end">
+        <span>{t("activity.legend.less")}</span>
+        <span className="w-3 h-3 border border-[var(--foreground)]/30 bg-[var(--background)]" />
+        <span className="w-3 h-3 border border-[var(--foreground)]/30 bg-[#CC0000]/20" />
+        <span className="w-3 h-3 border border-[var(--foreground)]/30 bg-[#CC0000]/40" />
+        <span className="w-3 h-3 border border-[var(--foreground)]/30 bg-[#CC0000]/70" />
+        <span className="w-3 h-3 border border-[var(--foreground)]/30 bg-[#CC0000]" />
+        <span>{t("activity.legend.more")}</span>
+      </div>
+    </section>
+  );
+}
diff --git a/app/u/[username]/EditLinkIfOwner.tsx b/app/u/[username]/EditLinkIfOwner.tsx
new file mode 100644
index 00000000..afbfb890
--- /dev/null
+++ b/app/u/[username]/EditLinkIfOwner.tsx
@@ -0,0 +1,43 @@
+"use client";
+
+import Link from "next/link";
+import { useAuth } from "@/lib/use-auth";
+import { useT } from "@/lib/i18n/client";
+
+interface Props {
+  /** 当前页面主人的 GitHub 数字 ID（可能为 null 的老数据） */
+  ownerGithubId: number | null;
+  /** 当前页面主人的系统 username，形如 "github_114939201" */
+  ownerUsername: string;
+  /** URL 上的标识符（/u/<identifier>），用于拼编辑页 URL 保持一致 */
+  identifier: string;
+}
+
+/**
+ * 只有登录用户自己访问自己主页时渲染"编辑"链接；其他情况返回 null。
+ * useAuth 是客户端 hook，所以这个组件必须是 client，但它本身极轻（不打 API）。
+ */
+export function EditLinkIfOwner({
+  ownerGithubId,
+  ownerUsername,
+  identifier,
+}: Props) {
+  const { user, status } = useAuth();
+  const t = useT();
+  if (status !== "authenticated" || !user) return null;
+
+  const isOwner =
+    (ownerGithubId != null && user.githubId === ownerGithubId) ||
+    user.username === ownerUsername;
+  if (!isOwner) return null;
+
+  return (
+    <Link
+      href={`/u/${identifier}/edit`}
+      className="font-mono text-[11px] uppercase tracking-widest hover:text-[#CC0000] transition-colors flex items-center gap-1 font-bold"
+      data-umami-event="profile_edit_click"
+    >
+      {t("profile.editProfile")}
+    </Link>
+  );
+}
diff --git a/app/u/[username]/FollowButton.tsx b/app/u/[username]/FollowButton.tsx
new file mode 100644
index 00000000..dd876fa9
--- /dev/null
+++ b/app/u/[username]/FollowButton.tsx
@@ -0,0 +1,153 @@
+"use client";
+
+import { useEffect, useState } from "react";
+import { useAuth } from "@/lib/use-auth";
+import { useT } from "@/lib/i18n/client";
+
+interface Props {
+  /** 目标用户的 identifier（/u/{identifier}，数字或 username 都行） */
+  identifier: string;
+  /** 目标用户的 user_accounts.id，用于判断"不能关注自己" */
+  targetUserId: number;
+}
+
+interface StatsResponse {
+  success: boolean;
+  data?: {
+    userId: number;
+    followerCount: number;
+    followingCount: number;
+    isFollowing: boolean;
+  };
+}
+
+function readToken(): string | null {
+  if (typeof window === "undefined") return null;
+  try {
+    return localStorage.getItem("satoken");
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 个人主页上的关注按钮 + 统计。
+ * - 匿名用户显示 followers/following 数字但按钮置灰提示"登录后关注"
+ * - 自己访问自己主页时不显示按钮，只显示统计
+ * - 乐观更新：点击立即切换 UI，失败回滚
+ */
+export function FollowButton({ identifier, targetUserId }: Props) {
+  const { user, status } = useAuth();
+  const t = useT();
+  const [followerCount, setFollowerCount] = useState<number | null>(null);
+  const [followingCount, setFollowingCount] = useState<number | null>(null);
+  const [isFollowing, setIsFollowing] = useState(false);
+  const [pending, setPending] = useState(false);
+
+  const isSelf = user?.id === targetUserId;
+
+  // 初次载入拉 stats
+  useEffect(() => {
+    const token = readToken();
+    fetch(`/api/user-center/follows/stats/${encodeURIComponent(identifier)}`, {
+      headers: token ? { satoken: token } : {},
+    })
+      .then((r) => (r.ok ? (r.json() as Promise<StatsResponse>) : null))
+      .then((json) => {
+        if (!json?.success || !json.data) return;
+        setFollowerCount(json.data.followerCount);
+        setFollowingCount(json.data.followingCount);
+        setIsFollowing(json.data.isFollowing);
+      })
+      .catch(() => {});
+  }, [identifier]);
+
+  async function toggle() {
+    if (status !== "authenticated" || isSelf || pending) return;
+    const token = readToken();
+    if (!token) return;
+
+    const nextFollowing = !isFollowing;
+    // 乐观更新
+    setPending(true);
+    setIsFollowing(nextFollowing);
+    setFollowerCount((c) =>
+      c == null ? c : Math.max(0, c + (nextFollowing ? 1 : -1)),
+    );
+
+    try {
+      const res = await fetch(
+        `/api/user-center/follows/${encodeURIComponent(identifier)}`,
+        {
+          method: nextFollowing ? "POST" : "DELETE",
+          headers: { satoken: token },
+        },
+      );
+      if (!res.ok) {
+        // 回滚
+        setIsFollowing(!nextFollowing);
+        setFollowerCount((c) =>
+          c == null ? c : Math.max(0, c - (nextFollowing ? 1 : -1)),
+        );
+      } else {
+        // 以服务端为准修正计数
+        const json = (await res.json()) as StatsResponse;
+        if (json.success && json.data) {
+          setFollowerCount(json.data.followerCount);
+          setFollowingCount(json.data.followingCount);
+          setIsFollowing(json.data.isFollowing);
+        }
+      }
+    } catch {
+      // 网络异常回滚
+      setIsFollowing(!nextFollowing);
+      setFollowerCount((c) =>
+        c == null ? c : Math.max(0, c - (nextFollowing ? 1 : -1)),
+      );
+    } finally {
+      setPending(false);
+    }
+  }
+
+  return (
+    <div className="flex items-center gap-4 border-t border-[var(--foreground)] pt-4">
+      <div className="flex gap-4 font-mono text-[10px] uppercase tracking-widest text-neutral-500">
+        <span>
+          <strong className="text-[var(--foreground)] font-serif text-base font-black">
+            {followerCount?.toLocaleString() ?? "—"}
+          </strong>{" "}
+          {t("follow.followers")}
+        </span>
+        <span>
+          <strong className="text-[var(--foreground)] font-serif text-base font-black">
+            {followingCount?.toLocaleString() ?? "—"}
+          </strong>{" "}
+          {t("follow.following")}
+        </span>
+      </div>
+      {!isSelf && (
+        <button
+          type="button"
+          disabled={status !== "authenticated" || pending}
+          onClick={toggle}
+          className={[
+            "font-mono text-[10px] uppercase tracking-widest px-3 py-1.5 border transition-colors",
+            isFollowing
+              ? "border-[var(--foreground)] text-[var(--foreground)] hover:bg-[#CC0000] hover:border-[#CC0000] hover:text-[var(--background)]"
+              : "border-[var(--foreground)] bg-[var(--foreground)] text-[var(--background)] hover:bg-[#CC0000] hover:border-[#CC0000]",
+            "disabled:opacity-50 disabled:cursor-not-allowed",
+          ].join(" ")}
+          data-umami-event={isFollowing ? "unfollow_click" : "follow_click"}
+        >
+          {status !== "authenticated"
+            ? t("follow.signInToFollow")
+            : pending
+              ? "..."
+              : isFollowing
+                ? t("follow.unfollow")
+                : t("follow.follow")}
+        </button>
+      )}
+    </div>
+  );
+}
diff --git a/app/u/[username]/GithubRepos.tsx b/app/u/[username]/GithubRepos.tsx
new file mode 100644
index 00000000..84c9ff6b
--- /dev/null
+++ b/app/u/[username]/GithubRepos.tsx
@@ -0,0 +1,112 @@
+import Link from "next/link";
+import { getServerT } from "@/lib/i18n/server";
+
+interface GithubRepo {
+  name: string;
+  fullName: string;
+  description: string;
+  htmlUrl: string;
+  language: string;
+  stars: number;
+  forks: number;
+  updatedAt: string;
+  fork: boolean;
+}
+
+interface Props {
+  /** 同 /u/{identifier}，传后端 */
+  identifier: string;
+}
+
+interface ReposResponse {
+  success: boolean;
+  data?: GithubRepo[];
+}
+
+/**
+ * 拉某用户的 GitHub 公开 repos。走后端 /api/user-center/github/repos/{id}，
+ * 后端 Caffeine 缓存 1h，GITHUB_TOKEN 保 5000/hour 限流。
+ * 没数据就返回空，前端直接不渲染 section。
+ */
+async function fetchRepos(identifier: string): Promise<GithubRepo[]> {
+  const backendUrl = process.env.BACKEND_URL;
+  if (!backendUrl) return [];
+  try {
+    const res = await fetch(
+      `${backendUrl}/api/user-center/github/repos/${encodeURIComponent(identifier)}`,
+      { next: { revalidate: 3600 } },
+    );
+    if (!res.ok) return [];
+    const json = (await res.json()) as ReposResponse;
+    return Array.isArray(json.data) ? json.data : [];
+  } catch {
+    return [];
+  }
+}
+
+function fmtDate(iso: string): string {
+  if (!iso) return "";
+  try {
+    return iso.slice(0, 10);
+  } catch {
+    return iso;
+  }
+}
+
+export async function GithubRepos({ identifier }: Props) {
+  const repos = await fetchRepos(identifier);
+  if (repos.length === 0) return null;
+  const t = await getServerT();
+
+  return (
+    <section className="border border-[var(--foreground)] p-6 lg:p-8 flex flex-col gap-4">
+      <div className="flex items-baseline justify-between gap-3 flex-wrap border-b border-[var(--foreground)] pb-3">
+        <div>
+          <div className="font-mono text-[10px] uppercase tracking-widest text-neutral-500">
+            {t("repos.sec")}
+          </div>
+          <h3 className="font-serif text-xl font-black uppercase mt-1 text-[var(--foreground)]">
+            {t("repos.heading")}
+          </h3>
+          <div className="font-mono text-[10px] uppercase tracking-widest text-neutral-500 mt-1">
+            {t("repos.subtitle")}
+          </div>
+        </div>
+        <div className="font-mono text-[10px] text-neutral-500">
+          {t("repos.count", { n: repos.length })}
+        </div>
+      </div>
+      <ul className="grid grid-cols-1 sm:grid-cols-2 gap-4">
+        {repos.map((r) => (
+          <li
+            key={r.fullName}
+            className="border border-[var(--foreground)] p-4 flex flex-col gap-2 hover:shadow-[4px_4px_0_var(--foreground)] transition-shadow"
+          >
+            <div className="flex items-start justify-between gap-2">
+              <Link
+                href={r.htmlUrl}
+                target="_blank"
+                rel="noopener noreferrer"
+                className="font-serif text-base font-bold text-[var(--foreground)] hover:text-[#CC0000] transition-colors truncate"
+              >
+                {r.name}
+              </Link>
+              <span className="font-mono text-[10px] text-neutral-500 shrink-0">
+                ★ {r.stars}
+              </span>
+            </div>
+            {r.description && (
+              <p className="text-[13px] leading-relaxed text-neutral-700 dark:text-neutral-300 line-clamp-2">
+                {r.description}
+              </p>
+            )}
+            <div className="mt-auto flex items-center justify-between font-mono text-[10px] uppercase tracking-wider text-neutral-500">
+              <span>{r.language || "—"}</span>
+              <span>{fmtDate(r.updatedAt)}</span>
+            </div>
+          </li>
+        ))}
+      </ul>
+    </section>
+  );
+}
diff --git a/app/u/[username]/ProfileCard.tsx b/app/u/[username]/ProfileCard.tsx
new file mode 100644
index 00000000..e9d33992
--- /dev/null
+++ b/app/u/[username]/ProfileCard.tsx
@@ -0,0 +1,171 @@
+"use client";
+
+import { useState } from "react";
+import Link from "next/link";
+import { useT } from "@/lib/i18n/client";
+
+/**
+ * URL scheme 白名单：仅允许 http(s)/mailto 和相对路径（/ 开头）。
+ * 防备 preferences 里注入 javascript: / data: 等导致的 XSS。
+ * 上游 page.tsx 已做一次过滤，这里二次防御以免组件被复用到未过滤的地方。
+ */
+function safeHref(raw: string | undefined | null): string | null {
+  if (!raw || typeof raw !== "string") return null;
+  const trimmed = raw.trim();
+  if (!trimmed) return null;
+  try {
+    if (trimmed.startsWith("/") && !trimmed.startsWith("//")) return trimmed;
+    const u = new URL(trimmed);
+    if (
+      u.protocol === "http:" ||
+      u.protocol === "https:" ||
+      u.protocol === "mailto:"
+    ) {
+      return u.toString();
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+interface ProfileCardProps {
+  kind: "PROJ" | "PAPER" | "DOC";
+  index: number;
+  title: string;
+  meta?: string;
+  summary?: string;
+  /** 展开态显示的详细内容（hover / tap 触发），没有则复用 summary */
+  detail?: string;
+  href?: string;
+  /** DOC 汇总卡占两列；其他卡片单列 */
+  spanFull?: boolean;
+}
+
+/**
+ * 个人主页小卡：静态展示 SEC 编号 + 标题 + meta + 概述；
+ * 悬停（desktop）或点击（mobile）展开详情段落，用 max-height 原地展开避免布局抖动。
+ *
+ * 设计刻意用 editorial 硬朗风格：无圆角、1px border、hover 加硬阴影，
+ * 和站内 Classified Archives / Top Rank 小卡统一。
+ */
+export function ProfileCard({
+  kind,
+  index,
+  title,
+  meta,
+  summary,
+  detail,
+  href,
+  spanFull,
+}: ProfileCardProps) {
+  const [expanded, setExpanded] = useState(false);
+  const t = useT();
+
+  const kindLabel = {
+    PROJ: t("card.kind.project"),
+    PAPER: t("card.kind.paper"),
+    DOC: t("card.kind.doc"),
+  }[kind];
+
+  // desktop 走 hover（CSS 驱动，见下面的 group-hover 样式），mobile 走 tap toggle；
+  // 这里用 `@media (hover: none)` 探测"不支持 hover 的设备"（触屏），只有这种设备才在 click 时翻转 state。
+  // 避免桌面端点击导致"离开 hover 后仍保持展开"的幽灵状态。
+  const toggleIfTouchDevice = () => {
+    if (typeof window === "undefined") return;
+    if (window.matchMedia?.("(hover: none)").matches) {
+      setExpanded((v) => !v);
+    }
+  };
+
+  const hasDetail = Boolean(detail);
+
+  return (
+    <article
+      onClick={hasDetail ? toggleIfTouchDevice : undefined}
+      onKeyDown={
+        hasDetail
+          ? (e) => {
+              if (e.key === "Enter" || e.key === " ") {
+                e.preventDefault();
+                setExpanded((v) => !v);
+              }
+            }
+          : undefined
+      }
+      role={hasDetail ? "button" : undefined}
+      tabIndex={hasDetail ? 0 : undefined}
+      aria-expanded={hasDetail ? expanded : undefined}
+      className={[
+        "group relative border border-[var(--foreground)] bg-[var(--background)]",
+        "p-6 flex flex-col gap-3 min-h-[180px]",
+        hasDetail ? "cursor-pointer" : "",
+        "transition-shadow duration-200 ease-out",
+        "hover:shadow-[6px_6px_0_var(--foreground)]",
+        "focus-visible:outline-none focus-visible:shadow-[6px_6px_0_var(--foreground)] focus-visible:ring-2 focus-visible:ring-[#CC0000]",
+        spanFull ? "sm:col-span-2" : "",
+      ].join(" ")}
+    >
+      <div className="flex items-baseline justify-between gap-2">
+        <span className="font-mono text-[10px] uppercase tracking-widest text-neutral-500">
+          SEC. {kind} · {String(index).padStart(3, "0")}
+        </span>
+        <span className="font-mono text-[9px] uppercase tracking-widest text-neutral-400">
+          {kindLabel}
+        </span>
+      </div>
+
+      <h3 className="font-serif text-lg md:text-xl font-bold leading-tight text-[var(--foreground)] line-clamp-2">
+        {title}
+      </h3>
+
+      {meta && (
+        <p className="font-mono text-[10px] uppercase tracking-wider text-neutral-500 line-clamp-1">
+          {meta}
+        </p>
+      )}
+
+      {summary && (
+        <p className="text-[13px] leading-relaxed text-neutral-700 dark:text-neutral-300 line-clamp-2">
+          {summary}
+        </p>
+      )}
+
+      {/* 展开态：hover（desktop）或点击（mobile）打开；用 max-height 过渡 */}
+      {detail && (
+        <div
+          className={[
+            "overflow-hidden transition-[max-height,opacity] duration-300 ease-out",
+            "lg:group-hover:max-h-80 lg:group-hover:opacity-100",
+            "lg:group-focus-within:max-h-80 lg:group-focus-within:opacity-100",
+            expanded
+              ? "max-h-80 opacity-100 mt-2 pt-3 border-t border-[var(--foreground)]"
+              : "max-h-0 opacity-0 lg:group-hover:mt-2 lg:group-hover:pt-3 lg:group-hover:border-t lg:group-hover:border-[var(--foreground)]",
+          ].join(" ")}
+        >
+          <p className="text-[13px] leading-relaxed text-neutral-700 dark:text-neutral-300 whitespace-pre-wrap">
+            {detail}
+          </p>
+        </div>
+      )}
+
+      {safeHref(href) && (
+        <div className="mt-auto pt-3">
+          <Link
+            href={safeHref(href)!}
+            target={safeHref(href)!.startsWith("http") ? "_blank" : undefined}
+            rel={
+              safeHref(href)!.startsWith("http")
+                ? "noopener noreferrer"
+                : undefined
+            }
+            onClick={(e) => e.stopPropagation()}
+            className="font-mono text-[10px] uppercase tracking-widest text-[#CC0000] hover:underline"
+          >
+            {t("card.view")}
+          </Link>
+        </div>
+      )}
+    </article>
+  );
+}
diff --git a/app/u/[username]/edit/EditProfileForm.tsx b/app/u/[username]/edit/EditProfileForm.tsx
new file mode 100644
index 00000000..4275b732
--- /dev/null
+++ b/app/u/[username]/edit/EditProfileForm.tsx
@@ -0,0 +1,564 @@
+"use client";
+
+import { useEffect, useState } from "react";
+import Link from "next/link";
+import { useRouter } from "next/navigation";
+import { useAuth } from "@/lib/use-auth";
+import { useT } from "@/lib/i18n/client";
+
+interface LinkItem {
+  label: string;
+  url: string;
+}
+
+interface ProjectItem {
+  title: string;
+  description: string;
+  url: string;
+  tags: string[];
+}
+
+interface PaperItem {
+  /** Zotero group item key；填了之后 profile 页会自动拉 Zotero 元信息填充 */
+  itemKey: string;
+  title: string;
+  authors: string;
+  year: string;
+  url: string;
+  abstract: string;
+}
+
+interface Preferences {
+  bio: string;
+  tagline: string;
+  links: LinkItem[];
+  projects: ProjectItem[];
+  pinned_papers: PaperItem[];
+}
+
+const EMPTY_PREFS: Preferences = {
+  bio: "",
+  tagline: "",
+  links: [],
+  projects: [],
+  pinned_papers: [],
+};
+
+/**
+ * 从 localStorage 读 satoken。SSR 下返回 null。
+ */
+function readToken(): string | null {
+  if (typeof window === "undefined") return null;
+  try {
+    return localStorage.getItem("satoken");
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 把后端 preferences JSON 规范化成表单 state。允许部分字段缺失。
+ */
+function normalize(raw: unknown): Preferences {
+  const p = (raw as Partial<Preferences>) ?? {};
+  return {
+    bio: typeof p.bio === "string" ? p.bio : "",
+    tagline: typeof p.tagline === "string" ? p.tagline : "",
+    links: Array.isArray(p.links)
+      ? p.links.map((l) => ({
+          label: l?.label ?? "",
+          url: l?.url ?? "",
+        }))
+      : [],
+    projects: Array.isArray(p.projects)
+      ? p.projects.map((x) => ({
+          title: x?.title ?? "",
+          description: x?.description ?? "",
+          url: x?.url ?? "",
+          tags: Array.isArray(x?.tags) ? x.tags : [],
+        }))
+      : [],
+    pinned_papers: Array.isArray(p.pinned_papers)
+      ? p.pinned_papers.map((x) => ({
+          itemKey: x?.itemKey ?? "",
+          title: x?.title ?? "",
+          authors: x?.authors ?? "",
+          year: String(x?.year ?? ""),
+          url: x?.url ?? "",
+          abstract: x?.abstract ?? "",
+        }))
+      : [],
+  };
+}
+
+interface Props {
+  /** 来自 URL 的 /u/[username]，用来验证访问者是不是本人 */
+  targetIdentifier: string;
+}
+
+/**
+ * 编辑个人主页客户端表单。
+ * - 用 useAuth 读当前用户 → 判断是否是本人；不是就直接拒绝
+ * - 初始化时 GET /api/user-center/preferences 填入已有值
+ * - 提交时 PATCH /api/user-center/preferences（顶层 key 原子合并）
+ */
+export function EditProfileForm({ targetIdentifier }: Props) {
+  const { user, status } = useAuth();
+  const router = useRouter();
+  const t = useT();
+
+  const [prefs, setPrefs] = useState<Preferences>(EMPTY_PREFS);
+  const [loading, setLoading] = useState(true);
+  const [saving, setSaving] = useState(false);
+  const [message, setMessage] = useState<string | null>(null);
+
+  // 仅本人可编辑：URL username 需要能匹配到当前用户（数字 github_id 或字符串 username）
+  const isOwner = (() => {
+    if (!user) return false;
+    if (user.username === targetIdentifier) return true;
+    if (user.githubId != null && String(user.githubId) === targetIdentifier)
+      return true;
+    return false;
+  })();
+
+  useEffect(() => {
+    if (status !== "authenticated" || !isOwner) {
+      setLoading(false);
+      return;
+    }
+    const token = readToken();
+    if (!token) {
+      setLoading(false);
+      return;
+    }
+    fetch("/api/user-center/preferences", {
+      headers: { satoken: token },
+    })
+      .then((r) => (r.ok ? r.json() : null))
+      .then((json) => {
+        if (json?.success) setPrefs(normalize(json.data));
+      })
+      .catch(() => {})
+      .finally(() => setLoading(false));
+  }, [status, isOwner]);
+
+  async function handleSubmit(e: React.FormEvent) {
+    e.preventDefault();
+    setMessage(null);
+    setSaving(true);
+    const token = readToken();
+    if (!token) {
+      setMessage(t("edit.error.noToken"));
+      setSaving(false);
+      return;
+    }
+    // 后端 PATCH 是顶层 key 合并，这里直接把整个 prefs 扁平覆盖掉前端展示的字段
+    const body = {
+      bio: prefs.bio,
+      tagline: prefs.tagline,
+      links: prefs.links.filter((l) => l.label && l.url),
+      projects: prefs.projects.filter((p) => p.title),
+      // 有 itemKey 或有 title 的条目保留，至少得有一个标识符
+      pinned_papers: prefs.pinned_papers.filter((p) => p.itemKey || p.title),
+    };
+    try {
+      const res = await fetch("/api/user-center/preferences", {
+        method: "PATCH",
+        headers: {
+          satoken: token,
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+      });
+      if (!res.ok) {
+        setMessage(t("edit.error.http", { status: res.status }));
+      } else {
+        setMessage(t("edit.status.saved"));
+        setTimeout(() => {
+          // 跳回自己的个人主页，用 githubId 作为 canonical URL
+          const id = user?.githubId ?? user?.username;
+          if (id) router.push(`/u/${id}`);
+        }, 600);
+      }
+    } catch (err) {
+      setMessage(err instanceof Error ? err.message : t("edit.error.unknown"));
+    } finally {
+      setSaving(false);
+    }
+  }
+
+  if (status === "loading" || loading) {
+    return (
+      <p className="font-mono text-sm text-neutral-500">{t("edit.loading")}</p>
+    );
+  }
+
+  if (status === "unauthenticated") {
+    return (
+      <div className="border border-[var(--foreground)] p-8">
+        <p className="font-mono text-sm mb-4">{t("edit.auth.required")}</p>
+        <Link
+          href="/login"
+          className="inline-block font-mono text-xs uppercase tracking-widest px-4 py-2 border border-[var(--foreground)] hover:bg-[var(--foreground)] hover:text-[var(--background)] transition-colors"
+        >
+          {t("edit.auth.signIn")}
+        </Link>
+      </div>
+    );
+  }
+
+  if (!isOwner) {
+    return (
+      <div className="border border-[var(--foreground)] p-8">
+        <p className="font-mono text-sm">
+          {t("edit.auth.notYours", { id: targetIdentifier })}
+        </p>
+        <Link
+          href={`/u/${user?.githubId ?? user?.username}`}
+          className="mt-4 inline-block font-mono text-xs uppercase tracking-widest hover:text-[#CC0000]"
+        >
+          {t("edit.auth.goMine")}
+        </Link>
+      </div>
+    );
+  }
+
+  return (
+    <form onSubmit={handleSubmit} className="flex flex-col gap-10">
+      {/* 编辑页顶部总说明：告诉用户这个页面都干什么 */}
+      <div className="border border-[var(--foreground)] bg-[var(--background)] p-6 text-sm text-neutral-700 dark:text-neutral-300 leading-relaxed">
+        <div className="font-mono text-[10px] uppercase tracking-widest text-neutral-500 mb-2">
+          {t("edit.intro.label")}
+        </div>
+        <p>
+          {t("edit.intro.body", {
+            id: String(user?.githubId ?? user?.username ?? "-"),
+          })}
+        </p>
+      </div>
+
+      {/* Section 1: 基础 */}
+      <Section
+        title={t("edit.sec1.title")}
+        heading={t("edit.sec1.heading")}
+        description={t("edit.sec1.description")}
+      >
+        <Field label={t("edit.sec1.tagline.label")}>
+          <input
+            type="text"
+            value={prefs.tagline}
+            onChange={(e) => setPrefs({ ...prefs, tagline: e.target.value })}
+            maxLength={80}
+            placeholder={t("edit.sec1.tagline.placeholder")}
+            className="w-full border border-[var(--foreground)] bg-[var(--background)] px-3 py-2 font-mono text-sm"
+          />
+        </Field>
+        <Field label={t("edit.sec1.bio.label")}>
+          <textarea
+            value={prefs.bio}
+            onChange={(e) => setPrefs({ ...prefs, bio: e.target.value })}
+            rows={4}
+            maxLength={500}
+            placeholder={t("edit.sec1.bio.placeholder")}
+            className="w-full border border-[var(--foreground)] bg-[var(--background)] px-3 py-2 font-serif text-sm leading-relaxed resize-y"
+          />
+        </Field>
+      </Section>
+
+      {/* Section 2: Links */}
+      <Section
+        title={t("edit.sec2.title")}
+        heading={t("edit.sec2.heading")}
+        description={t("edit.sec2.description")}
+      >
+        <RepeatableList
+          items={prefs.links}
+          onChange={(items) => setPrefs({ ...prefs, links: items })}
+          empty={{ label: "", url: "" }}
+          maxItems={5}
+          addLabel={t("edit.section.add")}
+          removeLabel={t("edit.section.remove")}
+          render={(item, idx, update) => (
+            <div className="grid grid-cols-1 md:grid-cols-[1fr_2fr] gap-3">
+              <input
+                type="text"
+                value={item.label}
+                onChange={(e) => update({ ...item, label: e.target.value })}
+                placeholder={t("edit.sec2.label.placeholder")}
+                className="border border-[var(--foreground)] bg-[var(--background)] px-3 py-2 font-mono text-xs uppercase"
+              />
+              <input
+                type="url"
+                value={item.url}
+                onChange={(e) => update({ ...item, url: e.target.value })}
+                placeholder={t("edit.sec2.url.placeholder")}
+                className="border border-[var(--foreground)] bg-[var(--background)] px-3 py-2 font-mono text-xs"
+              />
+            </div>
+          )}
+        />
+      </Section>
+
+      {/* Section 3: Projects */}
+      <Section
+        title={t("edit.sec3.title")}
+        heading={t("edit.sec3.heading")}
+        description={t("edit.sec3.description")}
+      >
+        <RepeatableList
+          items={prefs.projects}
+          onChange={(items) => setPrefs({ ...prefs, projects: items })}
+          empty={{ title: "", description: "", url: "", tags: [] }}
+          maxItems={8}
+          addLabel={t("edit.section.add")}
+          removeLabel={t("edit.section.remove")}
+          render={(item, idx, update) => (
+            <div className="flex flex-col gap-2">
+              <input
+                type="text"
+                value={item.title}
+                onChange={(e) => update({ ...item, title: e.target.value })}
+                placeholder={t("edit.sec3.title.placeholder")}
+                className="border border-[var(--foreground)] bg-[var(--background)] px-3 py-2 font-serif text-sm font-bold"
+              />
+              <textarea
+                value={item.description}
+                onChange={(e) =>
+                  update({ ...item, description: e.target.value })
+                }
+                rows={2}
+                placeholder={t("edit.sec3.desc.placeholder")}
+                className="border border-[var(--foreground)] bg-[var(--background)] px-3 py-2 font-sans text-xs resize-y"
+              />
+              <input
+                type="url"
+                value={item.url}
+                onChange={(e) => update({ ...item, url: e.target.value })}
+                placeholder={t("edit.sec3.url.placeholder")}
+                className="border border-[var(--foreground)] bg-[var(--background)] px-3 py-2 font-mono text-xs"
+              />
+              <input
+                type="text"
+                value={item.tags.join(", ")}
+                onChange={(e) =>
+                  update({
+                    ...item,
+                    tags: e.target.value
+                      .split(",")
+                      .map((s) => s.trim())
+                      .filter(Boolean),
+                  })
+                }
+                placeholder={t("edit.sec3.tags.placeholder")}
+                className="border border-[var(--foreground)] bg-[var(--background)] px-3 py-2 font-mono text-xs"
+              />
+            </div>
+          )}
+        />
+      </Section>
+
+      {/* Section 4: Papers */}
+      <Section
+        title={t("edit.sec4.title")}
+        heading={t("edit.sec4.heading")}
+        description={t("edit.sec4.description")}
+      >
+        <RepeatableList
+          items={prefs.pinned_papers}
+          onChange={(items) => setPrefs({ ...prefs, pinned_papers: items })}
+          empty={{
+            itemKey: "",
+            title: "",
+            authors: "",
+            year: "",
+            url: "",
+            abstract: "",
+          }}
+          maxItems={8}
+          addLabel={t("edit.section.add")}
+          removeLabel={t("edit.section.remove")}
+          render={(item, idx, update) => (
+            <div className="flex flex-col gap-2">
+              <input
+                type="text"
+                value={item.itemKey}
+                onChange={(e) => update({ ...item, itemKey: e.target.value })}
+                placeholder={t("edit.sec4.itemKey.placeholder")}
+                className="border border-dashed border-[var(--foreground)] bg-[var(--background)] px-3 py-2 font-mono text-xs uppercase tracking-wider"
+              />
+              <input
+                type="text"
+                value={item.title}
+                onChange={(e) => update({ ...item, title: e.target.value })}
+                placeholder={t("edit.sec4.title.placeholder")}
+                className="border border-[var(--foreground)] bg-[var(--background)] px-3 py-2 font-serif text-sm font-bold"
+              />
+              <div className="grid grid-cols-1 md:grid-cols-[2fr_1fr] gap-2">
+                <input
+                  type="text"
+                  value={item.authors}
+                  onChange={(e) => update({ ...item, authors: e.target.value })}
+                  placeholder={t("edit.sec4.authors.placeholder")}
+                  className="border border-[var(--foreground)] bg-[var(--background)] px-3 py-2 font-mono text-xs"
+                />
+                <input
+                  type="text"
+                  value={item.year}
+                  onChange={(e) => update({ ...item, year: e.target.value })}
+                  placeholder={t("edit.sec4.year.placeholder")}
+                  className="border border-[var(--foreground)] bg-[var(--background)] px-3 py-2 font-mono text-xs"
+                />
+              </div>
+              <input
+                type="url"
+                value={item.url}
+                onChange={(e) => update({ ...item, url: e.target.value })}
+                placeholder={t("edit.sec4.url.placeholder")}
+                className="border border-[var(--foreground)] bg-[var(--background)] px-3 py-2 font-mono text-xs"
+              />
+              <textarea
+                value={item.abstract}
+                onChange={(e) => update({ ...item, abstract: e.target.value })}
+                rows={2}
+                placeholder={t("edit.sec4.abstract.placeholder")}
+                className="border border-[var(--foreground)] bg-[var(--background)] px-3 py-2 font-sans text-xs resize-y"
+              />
+            </div>
+          )}
+        />
+      </Section>
+
+      {/* 提交 */}
+      <div className="flex items-center gap-4 border-t-2 border-[var(--foreground)] pt-6">
+        <button
+          type="submit"
+          disabled={saving}
+          className="font-mono text-xs uppercase tracking-widest px-6 py-3 border-2 border-[var(--foreground)] bg-[var(--foreground)] text-[var(--background)] hover:bg-[#CC0000] hover:border-[#CC0000] transition-colors disabled:opacity-50"
+        >
+          {saving ? t("edit.cta.saving") : t("edit.cta.save")}
+        </button>
+        <Link
+          href={`/u/${user?.githubId ?? user?.username}`}
+          className="font-mono text-xs uppercase tracking-widest text-neutral-500 hover:text-[var(--foreground)]"
+        >
+          {t("edit.cta.cancel")}
+        </Link>
+        {message && (
+          <span className="font-mono text-xs text-neutral-600 dark:text-neutral-400">
+            {message}
+          </span>
+        )}
+      </div>
+    </form>
+  );
+}
+
+function Section({
+  title,
+  heading,
+  description,
+  children,
+}: {
+  /** 左上角的 SEC 编号，全大写英文 */
+  title: string;
+  /** 大号中文标题，让用户一眼知道这是什么 */
+  heading: string;
+  /** 一两句话解释这块填什么、填了之后主页哪里会显示 */
+  description: string;
+  children: React.ReactNode;
+}) {
+  return (
+    <section className="border border-[var(--foreground)] p-6 lg:p-8 flex flex-col gap-4">
+      <header className="border-b border-[var(--foreground)] pb-3 flex flex-col gap-1">
+        <div className="font-mono text-[10px] uppercase tracking-widest text-neutral-500">
+          {title}
+        </div>
+        <h2 className="font-serif text-xl font-black text-[var(--foreground)]">
+          {heading}
+        </h2>
+        <p className="text-xs text-neutral-600 dark:text-neutral-400 leading-relaxed">
+          {description}
+        </p>
+      </header>
+      {children}
+    </section>
+  );
+}
+
+function Field({
+  label,
+  children,
+}: {
+  label: string;
+  children: React.ReactNode;
+}) {
+  return (
+    <label className="flex flex-col gap-1">
+      <span className="font-mono text-[10px] uppercase tracking-widest text-neutral-500">
+        {label}
+      </span>
+      {children}
+    </label>
+  );
+}
+
+/**
+ * 通用可增删列表（links / projects / papers 共用）。
+ * 用泛型保证 items 和 empty / render 类型一致。
+ */
+function RepeatableList<T>({
+  items,
+  onChange,
+  empty,
+  maxItems,
+  addLabel,
+  removeLabel,
+  render,
+}: {
+  items: T[];
+  onChange: (items: T[]) => void;
+  empty: T;
+  maxItems: number;
+  /** 翻译后的"+ 新增" / "+ Add"，由调用方传入保证 locale 一致 */
+  addLabel: string;
+  /** 翻译后的"删除此项" / "Remove"，由调用方传入 */
+  removeLabel: string;
+  render: (
+    item: T,
+    index: number,
+    update: (next: T) => void,
+  ) => React.ReactNode;
+}) {
+  return (
+    <div className="flex flex-col gap-4">
+      {items.map((item, idx) => (
+        <div
+          key={idx}
+          className="border border-dashed border-[var(--foreground)] p-4 flex flex-col gap-3"
+        >
+          {render(item, idx, (next) => {
+            const copy = [...items];
+            copy[idx] = next;
+            onChange(copy);
+          })}
+          <button
+            type="button"
+            onClick={() => onChange(items.filter((_, i) => i !== idx))}
+            className="self-end font-mono text-[10px] uppercase tracking-widest text-neutral-500 hover:text-[#CC0000]"
+          >
+            {removeLabel}
+          </button>
+        </div>
+      ))}
+      {items.length < maxItems && (
+        <button
+          type="button"
+          onClick={() => onChange([...items, empty])}
+          className="self-start font-mono text-[10px] uppercase tracking-widest px-3 py-1 border border-[var(--foreground)] hover:bg-[var(--foreground)] hover:text-[var(--background)] transition-colors"
+        >
+          {addLabel}
+        </button>
+      )}
+    </div>
+  );
+}
diff --git a/app/u/[username]/edit/page.tsx b/app/u/[username]/edit/page.tsx
new file mode 100644
index 00000000..40279635
--- /dev/null
+++ b/app/u/[username]/edit/page.tsx
@@ -0,0 +1,37 @@
+import { Header } from "@/app/components/Header";
+import { Footer } from "@/app/components/Footer";
+import { EditProfileForm } from "./EditProfileForm";
+import { getServerT } from "@/lib/i18n/server";
+
+interface Param {
+  params: Promise<{ username: string }>;
+}
+
+/**
+ * 个人主页编辑页。
+ * 访问权限校验放在客户端组件 EditProfileForm 里（读 useAuth），
+ * 因为 SSR 阶段还不知道用户是谁（satoken 存 localStorage）。
+ */
+export default async function EditProfilePage({ params }: Param) {
+  const { username } = await params;
+  const t = await getServerT();
+  return (
+    <>
+      <Header />
+      <main className="pt-32 pb-16 bg-[var(--background)] min-h-screen">
+        <div className="max-w-4xl mx-auto px-6 lg:px-8">
+          <header className="border-t-4 border-[var(--foreground)] pt-6 mb-12">
+            <div className="font-mono text-[10px] uppercase tracking-[0.3em] text-neutral-500">
+              {t("edit.pageHeader")}
+            </div>
+            <h1 className="font-serif text-4xl md:text-5xl font-black uppercase mt-2 tracking-tight text-[var(--foreground)]">
+              {t("edit.pageTitle")}
+            </h1>
+          </header>
+          <EditProfileForm targetIdentifier={username} />
+        </div>
+      </main>
+      <Footer />
+    </>
+  );
+}
diff --git a/app/u/[username]/page.tsx b/app/u/[username]/page.tsx
new file mode 100644
index 00000000..4bf5749a
--- /dev/null
+++ b/app/u/[username]/page.tsx
@@ -0,0 +1,509 @@
+import { notFound } from "next/navigation";
+import Link from "next/link";
+import Image from "next/image";
+import type { Metadata } from "next";
+import leaderboard from "@/generated/site-leaderboard.json";
+import { Header } from "@/app/components/Header";
+import { Footer } from "@/app/components/Footer";
+import { ProfileCard } from "./ProfileCard";
+import { EditLinkIfOwner } from "./EditLinkIfOwner";
+import { ActivityHeatmap } from "./ActivityHeatmap";
+import { FollowButton } from "./FollowButton";
+import { GithubRepos } from "./GithubRepos";
+import { getServerT } from "@/lib/i18n/server";
+
+interface UserView {
+  id: number;
+  username: string;
+  displayName: string | null;
+  avatarUrl: string | null;
+  email?: string | null;
+  githubId?: number | null;
+}
+
+interface UserProjectItem {
+  title: string;
+  description?: string;
+  url?: string;
+  tags?: string[];
+}
+
+interface UserPaperItem {
+  /** Zotero group item key；有值时优先从后端 /api/user-center/zotero/items 拉元信息 */
+  itemKey?: string;
+  title?: string;
+  authors?: string;
+  year?: string | number;
+  url?: string;
+  abstract?: string;
+}
+
+interface ZoteroItemDto {
+  itemKey: string;
+  title: string;
+  authors: string;
+  year: string;
+  url: string;
+  abstractNote: string;
+  publicationTitle: string;
+}
+
+/**
+ * 批量调后端 Zotero 代理，返回 itemKey → 元信息映射。
+ * 任意失败或没 itemKey 时返回空 map，调用方走手填 fallback。
+ */
+async function fetchZoteroByKeys(
+  keys: string[],
+): Promise<Record<string, ZoteroItemDto>> {
+  if (keys.length === 0) return {};
+  const backendUrl = process.env.BACKEND_URL;
+  if (!backendUrl) return {};
+  try {
+    const res = await fetch(
+      `${backendUrl}/api/user-center/zotero/items?keys=${encodeURIComponent(keys.join(","))}`,
+      { next: { revalidate: 3600 } },
+    );
+    if (!res.ok) return {};
+    const json = (await res.json()) as {
+      success: boolean;
+      data?: ZoteroItemDto[];
+    };
+    if (!json.success || !Array.isArray(json.data)) return {};
+    const map: Record<string, ZoteroItemDto> = {};
+    for (const it of json.data) map[it.itemKey] = it;
+    return map;
+  } catch {
+    return {};
+  }
+}
+
+interface UserLinkItem {
+  label: string;
+  url: string;
+}
+
+interface Preferences {
+  bio?: string;
+  tagline?: string;
+  links?: UserLinkItem[];
+  projects?: UserProjectItem[];
+  pinned_papers?: UserPaperItem[];
+}
+
+interface ProfileData {
+  user: UserView;
+  preferences: Preferences;
+}
+
+interface ProfileResponse {
+  success: boolean;
+  data?: ProfileData;
+  message?: string;
+}
+
+/**
+ * SSR 获取用户主页基础信息（账户 + preferences）。
+ * 服务端使用 BACKEND_URL 直连 Java 后端（不走 next.config.mjs rewrites，那是给浏览器用的）。
+ * 贡献文档不走后端 DB，而是在组件里从 build-time 的 site-leaderboard.json 读取，
+ * 目的：每次访问 /u/{x} 省一次 Neon 查询（免费额度有限）。docs 本来就是 git-based，
+ * JSON 新鲜度和 DB 一致，都是 deploy 级。
+ *
+ * 错误策略：只有后端明确返回 404 或 success=false 才 return null（走 notFound()）。
+ * 其他失败（500 / 网关异常 / JSON 解析错 / BACKEND_URL 缺失）一律抛错，
+ * 让 Next error boundary 兜底，避免把"后端故障"伪装成"用户不存在"。
+ */
+function warnFetchProfile(message: string, details?: Record<string, unknown>) {
+  if (process.env.NODE_ENV !== "production") {
+    console.warn(`[fetchProfile] ${message}`, details ?? {});
+  }
+}
+
+async function fetchProfile(identifier: string): Promise<ProfileData | null> {
+  const backendUrl = process.env.BACKEND_URL;
+  if (!backendUrl) {
+    // 关键配置缺失不能静默 notFound，给个可见错误
+    throw new Error("BACKEND_URL is not configured");
+  }
+  const res = await fetch(
+    `${backendUrl}/api/user-center/profile/${encodeURIComponent(identifier)}`,
+    { next: { revalidate: 300 } },
+  );
+  // 404：用户确实不存在 → notFound
+  if (res.status === 404) {
+    warnFetchProfile("backend 404", { identifier });
+    return null;
+  }
+  // 其他非 2xx 都抛，进 Next error boundary
+  if (!res.ok) {
+    throw new Error(
+      `profile backend ${res.status} ${res.statusText} for ${identifier}`,
+    );
+  }
+  const json = (await res.json()) as ProfileResponse;
+  // 后端用 {success:false, message:"用户不存在"} 表示软 404
+  if (!json.success || !json.data) {
+    warnFetchProfile("backend success=false", {
+      identifier,
+      message: json.message,
+    });
+    return null;
+  }
+  return json.data;
+}
+
+/**
+ * URL scheme 白名单：仅允许 http(s)/mailto，拦截 javascript: / data: 等向量。
+ * 任何 preferences 里的 URL 在渲染前必须过这里。
+ */
+function sanitizeExternalUrl(raw: string | undefined | null): string | null {
+  if (!raw || typeof raw !== "string") return null;
+  const trimmed = raw.trim();
+  if (!trimmed) return null;
+  try {
+    // 允许相对路径（以 / 开头），直接放行
+    if (trimmed.startsWith("/") && !trimmed.startsWith("//")) return trimmed;
+    const u = new URL(trimmed);
+    if (
+      u.protocol === "http:" ||
+      u.protocol === "https:" ||
+      u.protocol === "mailto:"
+    ) {
+      return u.toString();
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 从 leaderboard JSON 按 githubId 匹配贡献记录。
+ * 之前按 name 字符串匹配会踩坑（leaderboard.name = "longsizhuo"，user_accounts.username = "github_114939201"），
+ * 现在按 githubId 数字匹配直接对齐。
+ */
+function findContributions(githubId: number | null | undefined) {
+  if (githubId == null)
+    return { docs: [], points: 0, commits: 0, dailyCounts: {} };
+  type Row = {
+    id: string;
+    name: string;
+    points?: number;
+    commits?: number;
+    avatarUrl?: string;
+    contributedDocs?: Array<{ id: string; title: string; url: string }>;
+    dailyCounts?: Record<string, number>;
+  };
+  // 先经 unknown 再转 Row[]：JSON 的字面量类型（每条 dailyCounts 都是独立的 literal）和 Row 的
+  // Record<string, number> 索引签名不兼容，tsc --noEmit 会报 TS2352。先走 unknown 绕开。
+  const rows = leaderboard as unknown as Row[];
+  const idStr = String(githubId);
+  const match = rows.find((r) => r.id === idStr);
+  if (!match) return { docs: [], points: 0, commits: 0, dailyCounts: {} };
+  return {
+    docs: match.contributedDocs ?? [],
+    points: match.points ?? 0,
+    commits: match.commits ?? 0,
+    dailyCounts: match.dailyCounts ?? {},
+  };
+}
+
+interface Param {
+  params: Promise<{ username: string }>;
+}
+
+export async function generateMetadata({ params }: Param): Promise<Metadata> {
+  const { username } = await params;
+  const data = await fetchProfile(username);
+  if (!data) return { title: `@${username}` };
+  const displayName = data.user.displayName || data.user.username;
+  return {
+    title: `${displayName} (@${data.user.username})`,
+    description:
+      data.preferences?.bio ||
+      `${displayName} 在 Involution Hell 的个人主页 — 项目、论文与文档贡献。`,
+  };
+}
+
+export default async function UserProfilePage({ params }: Param) {
+  const { username } = await params;
+  const data = await fetchProfile(username);
+  if (!data) notFound();
+
+  const t = await getServerT();
+  const { user } = data;
+  const preferences = data.preferences ?? {};
+  const { docs, points, commits, dailyCounts } = findContributions(
+    user.githubId,
+  );
+  const projects = preferences.projects ?? [];
+  const rawPapers = preferences.pinned_papers ?? [];
+  const links = preferences.links ?? [];
+
+  // 用 itemKey 批量拉 Zotero 元信息 → 用它填字段，覆盖手填值（手填作为离线 fallback）
+  const zoteroKeys = rawPapers
+    .map((p) => p.itemKey)
+    .filter((k): k is string => typeof k === "string" && k.length > 0);
+  const zoteroMap = await fetchZoteroByKeys(zoteroKeys);
+  const papers: UserPaperItem[] = rawPapers.map((p) => {
+    if (!p.itemKey) return p;
+    const z = zoteroMap[p.itemKey];
+    if (!z) return p; // Zotero 拉不到就用手填值兜底
+    return {
+      itemKey: p.itemKey,
+      title: p.title || z.title,
+      authors: p.authors || z.authors,
+      year: p.year || z.year,
+      url: p.url || z.url,
+      abstract: p.abstract || z.abstractNote,
+    };
+  });
+
+  return (
+    <>
+      <Header />
+      <main className="pt-32 pb-16 bg-[var(--background)] min-h-screen">
+        <div className="max-w-7xl mx-auto px-6 lg:px-8">
+          <header className="border-t-4 border-[var(--foreground)] pt-6 mb-12">
+            <div className="flex items-baseline justify-between gap-4 flex-wrap">
+              <div>
+                <div className="font-mono text-[10px] uppercase tracking-[0.3em] text-neutral-500">
+                  {t("profile.dossier")} ·{" "}
+                  {t("profile.volumeIssue", { id: user.id })}
+                </div>
+                <h2 className="font-serif text-4xl md:text-5xl font-black uppercase mt-2 tracking-tight text-[var(--foreground)]">
+                  {user.displayName || user.username}
+                </h2>
+              </div>
+              <div className="flex items-center gap-3">
+                {/* 编辑入口：只有本人登录状态下才显示；访问者判定由 EditProfileForm 内部做，
+                    这里不做服务端鉴权，因为 satoken 存 localStorage，SSR 拿不到用户 */}
+                <EditLinkIfOwner
+                  ownerGithubId={user.githubId ?? null}
+                  ownerUsername={user.username}
+                  identifier={username}
+                />
+                <Link
+                  href="/rank"
+                  className="font-mono text-[11px] uppercase tracking-widest hover:text-[#CC0000] transition-colors flex items-center gap-1"
+                >
+                  {t("profile.fullRank")}
+                </Link>
+              </div>
+            </div>
+          </header>
+
+          <div className="grid grid-cols-12 gap-8">
+            {/* 左大块：Identity */}
+            <section className="col-span-12 lg:col-span-5 border border-[var(--foreground)] p-8 lg:p-10 flex flex-col gap-6 self-start">
+              <span className="font-mono text-[10px] uppercase tracking-widest text-neutral-500">
+                {t("profile.sec.profile")}
+              </span>
+              {user.avatarUrl ? (
+                <Image
+                  src={user.avatarUrl}
+                  alt={user.username}
+                  width={96}
+                  height={96}
+                  className="border-2 border-[var(--foreground)]"
+                />
+              ) : (
+                <div className="w-24 h-24 border-2 border-[var(--foreground)] flex items-center justify-center font-serif text-3xl font-black">
+                  {user.username.charAt(0).toUpperCase()}
+                </div>
+              )}
+              <div>
+                <h1 className="font-serif text-4xl font-black italic leading-none text-[var(--foreground)]">
+                  {user.displayName || user.username}
+                </h1>
+                <p className="font-mono text-xs text-neutral-500 mt-1">
+                  @{user.username}
+                </p>
+                {preferences.tagline && (
+                  <p className="mt-2 font-mono text-[11px] uppercase tracking-wider text-neutral-600 dark:text-neutral-400">
+                    {preferences.tagline}
+                  </p>
+                )}
+              </div>
+              {preferences.bio && (
+                <p className="border-t border-[var(--foreground)] pt-4 text-[14px] leading-relaxed text-neutral-700 dark:text-neutral-300">
+                  {preferences.bio}
+                </p>
+              )}
+              <div className="border-t border-[var(--foreground)] pt-4 grid grid-cols-3 gap-4">
+                <Stat label={t("profile.stats.docs")} value={docs.length} />
+                <Stat label={t("profile.stats.commits")} value={commits} />
+                <Stat label={t("profile.stats.points")} value={points} />
+              </div>
+              {/* 关注按钮 + 粉丝/关注数，客户端动态拉 */}
+              <FollowButton identifier={username} targetUserId={user.id} />
+              {links.length > 0 && (
+                <div className="border-t border-[var(--foreground)] pt-4 flex flex-wrap gap-2">
+                  {links.slice(0, 5).map((link, idx) => {
+                    // 过滤 javascript: / data: 等危险 scheme，不合法直接渲染成不可点击的纯文本
+                    const safe = sanitizeExternalUrl(link.url);
+                    if (!safe) {
+                      return (
+                        <span
+                          key={`${link.label}-${idx}`}
+                          className="font-mono text-[10px] uppercase tracking-widest px-2 py-1 border border-dashed border-neutral-400 text-neutral-400"
+                          title="链接协议不安全，已禁用"
+                        >
+                          {link.label}
+                        </span>
+                      );
+                    }
+                    return (
+                      <a
+                        key={safe}
+                        href={safe}
+                        target="_blank"
+                        rel="noopener noreferrer"
+                        className="font-mono text-[10px] uppercase tracking-widest px-2 py-1 border border-[var(--foreground)] hover:bg-[var(--foreground)] hover:text-[var(--background)] transition-colors"
+                      >
+                        {link.label}
+                      </a>
+                    );
+                  })}
+                </div>
+              )}
+            </section>
+
+            {/* 右侧小卡区 */}
+            <div className="col-span-12 lg:col-span-7 grid grid-cols-1 sm:grid-cols-2 gap-8">
+              {projects.map((p, idx) => (
+                <ProfileCard
+                  key={`proj-${idx}`}
+                  kind="PROJ"
+                  index={idx + 1}
+                  title={p.title}
+                  meta={p.tags?.join(" · ")}
+                  summary={p.description}
+                  detail={p.description}
+                  href={sanitizeExternalUrl(p.url) ?? undefined}
+                />
+              ))}
+              {papers.map((p, idx) => (
+                <ProfileCard
+                  key={`paper-${idx}`}
+                  kind="PAPER"
+                  index={idx + 1}
+                  // title 在 UserPaperItem 里允许 itemKey-only（title 可能缺），这里兜底
+                  title={p.title || p.itemKey || "(untitled paper)"}
+                  meta={[p.authors, p.year].filter(Boolean).join(", ")}
+                  summary={p.abstract}
+                  detail={p.abstract}
+                  href={sanitizeExternalUrl(p.url) ?? undefined}
+                />
+              ))}
+              {projects.length === 0 && papers.length === 0 && (
+                <div className="col-span-full border border-dashed border-[var(--foreground)] p-10 text-center text-neutral-500 font-sans text-sm leading-relaxed">
+                  {t("profile.empty.title")}
+                  <br />
+                  <span className="text-xs text-neutral-400">
+                    {t("profile.empty.subtitle")}
+                  </span>
+                </div>
+              )}
+            </div>
+          </div>
+
+          {/* 活跃度热力图：提到 Bento 之后立即显示，让数据可视化先于冗长的列表 */}
+          {Object.keys(dailyCounts).length > 0 && (
+            <div className="mt-12">
+              <ActivityHeatmap dailyCounts={dailyCounts} />
+            </div>
+          )}
+
+          {/* GitHub 公开 repos：server component 内部 fetch，零数据时自动返回 null */}
+          <div className="mt-12">
+            <GithubRepos identifier={username} />
+          </div>
+
+          {/* 文档贡献列表：放最底部，紧凑列表形式（每行 ~48px），避免 docs 多的用户把页面顶得很长。
+              超过 10 条时用 <details> 折叠，默认只显示前 10 */}
+          {docs.length > 0 && (
+            <section className="mt-12 border border-[var(--foreground)] p-6 lg:p-8 flex flex-col gap-4">
+              <div className="flex items-baseline justify-between gap-3 flex-wrap border-b border-[var(--foreground)] pb-3">
+                <div>
+                  <div className="font-mono text-[10px] uppercase tracking-widest text-neutral-500">
+                    {t("docs.sec")}
+                  </div>
+                  <h3 className="font-serif text-xl font-black uppercase mt-1 text-[var(--foreground)]">
+                    {t("docs.heading")}
+                  </h3>
+                </div>
+                <div className="font-mono text-[10px] text-neutral-500">
+                  {t("docs.count", {
+                    n: docs.length,
+                    commits: commits.toLocaleString(),
+                  })}
+                </div>
+              </div>
+              <ol className="flex flex-col">
+                {docs.slice(0, 10).map((doc, idx) => (
+                  <DocRow key={doc.id} idx={idx + 1} doc={doc} />
+                ))}
+              </ol>
+              {docs.length > 10 && (
+                <details className="flex flex-col">
+                  <summary className="font-mono text-[10px] uppercase tracking-widest text-[#CC0000] cursor-pointer hover:underline py-2">
+                    {t("docs.showMore", { n: docs.length - 10 })}
+                  </summary>
+                  <ol className="flex flex-col mt-2">
+                    {docs.slice(10).map((doc, idx) => (
+                      <DocRow key={doc.id} idx={idx + 11} doc={doc} />
+                    ))}
+                  </ol>
+                </details>
+              )}
+            </section>
+          )}
+        </div>
+      </main>
+      <Footer />
+    </>
+  );
+}
+
+/** 紧凑单行文档条目 */
+function DocRow({
+  idx,
+  doc,
+}: {
+  idx: number;
+  doc: { id: string; title: string; url: string };
+}) {
+  const safe = sanitizeExternalUrl(doc.url);
+  return (
+    <li className="flex items-baseline gap-3 border-t border-[var(--foreground)]/20 first:border-t-0 py-2 group">
+      <span className="font-mono text-[10px] text-neutral-400 w-6 shrink-0">
+        {String(idx).padStart(2, "0")}
+      </span>
+      {safe ? (
+        <Link
+          href={safe}
+          className="flex-1 font-serif text-sm text-[var(--foreground)] truncate group-hover:text-[#CC0000] transition-colors"
+        >
+          {doc.title}
+        </Link>
+      ) : (
+        <span className="flex-1 font-serif text-sm text-neutral-400 truncate">
+          {doc.title}
+        </span>
+      )}
+    </li>
+  );
+}
+
+function Stat({ label, value }: { label: string; value: number }) {
+  return (
+    <div>
+      <div className="font-serif text-2xl font-black text-[var(--foreground)]">
+        {value.toLocaleString()}
+      </div>
+      <div className="font-mono text-[9px] uppercase tracking-widest text-neutral-500 mt-1">
+        {label}
+      </div>
+    </div>
+  );
+}
diff --git a/docs/architecture/frontend-backend-separation.md b/docs/architecture/frontend-backend-separation.md
new file mode 100644
index 00000000..6e9e68d2
--- /dev/null
+++ b/docs/architecture/frontend-backend-separation.md
@@ -0,0 +1,191 @@
+# 前后端分离架构约定
+
+> 起草于 2026-04-15，PR #281 / `feat/user-profile-page` 迭代期间固化。
+
+## 动机
+
+involutionhell.com 早期为了快，前端 Next.js 做了不少后端该做的事：直连 Prisma 写埋点、在 Next API Route 里拼 GitHub API、在 Server Component 里做聚合查询等。结果：
+
+- Vercel Fluid Active CPU 一度冲到 **3h24m/4h (85%)**，再往上就要付费
+- 后端 Java 有连接池、Caffeine、常驻进程，反而闲着
+- 逻辑散落两端，同一张表两边读写难维护
+
+2026-04 迭代把边界划清，这篇是约定。
+
+---
+
+## 边界划分
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│ 浏览器                                                           │
+└────┬──────────────────────────────────────────────────┬──────────┘
+     │ 纯静态 / SSR HTML                                  │ 动态数据 API
+     ▼                                                   ▼
+┌──────────────────────────────┐             ┌─────────────────────┐
+│ Next.js (Vercel)             │   rewrites  │ Java Spring Boot    │
+│                              │ ──────────► │ (Oracle / Railway)  │
+│ - Static pages (SSG/ISR)     │             │                     │
+│ - SSR for /, /rank, /u/[x]   │             │ - 业务逻辑            │
+│ - fumadocs MDX 渲染           │             │ - 数据库读写（唯一入口）│
+│ - middleware.ts (locale)     │             │ - Caffeine 缓存       │
+│ - search.{zh,en}.json 索引    │             │ - SaToken 认证        │
+│ - /api/* 只做：               │             │ - GitHub OAuth 回调    │
+│   · /api/chat (LLM 代理)      │             │ - GA4 聚合            │
+│   · /api/docs-tree (纯 MDX)   │             │                     │
+│   · /api/docs/history (cron)  │             └──────────┬──────────┘
+│   · /api/suggestions (纯本地) │                        │
+│   · /api/upload (S3 中转)     │                        ▼
+│   · /api/indexnow (SEO CICD)  │             ┌─────────────────────┐
+└──────────────────────────────┘             │ PostgreSQL          │
+                                              └─────────────────────┘
+```
+
+### 前端（Next.js）只做这些
+
+1. **渲染**：静态页 + SSR + ISR
+2. **路由层 SEO / metadata**
+3. **i18n 切换**（middleware 读 cookie、layout 选 search 索引）
+4. **fumadocs 文档管线**（MDX → HTML + search.json）
+5. **纯前端缓存**（sessionStorage、fetch revalidate）
+6. 必要的 BFF 路由：
+   - `POST /api/chat` — LLM 代理（key 不能暴露，必须服务端）
+   - `GET /api/docs/history` — 临时保留，V2 迁 Java
+   - `GET /api/docs-tree` — 读 fumadocs source，纯本地
+   - `GET /api/suggestions` — 静态候选词
+   - `POST /api/upload` — S3 预签名
+   - `POST /api/indexnow` — CI/CD 触发，一天一次
+
+### 后端（Java）负责这些
+
+1. **所有业务逻辑**（认证、用户中心、埋点写入、排行榜、GA4 聚合）
+2. **唯一的数据库读写入口**（Prisma 生成的 schema 由前端维护，但运行时 DB 只被 Java 访问）
+3. **可缓存的外部 API 代理**（GA4 → Caffeine 10min、将来 GitHub commits → Caffeine 1h）
+4. **认证体系**（SaToken + JustAuth GitHub OAuth）
+
+### 不能再做的事
+
+- ❌ Next API Route 里直接 `import { prisma } from "@/lib/db"`
+- ❌ 在 Server Component 里跑 `source.getPages()` 做聚合查询（换成 build-time 生成 JSON 或调后端）
+- ❌ 为了"省一次网络请求"在前端复刻后端逻辑
+
+---
+
+## URL 约定
+
+前端 `next.config.mjs` 的 `rewrites()` 统一把这些路径**透传到 Java**：
+
+| 前端可见路径                | 转发到 Java | 用途                                 |
+| --------------------------- | ----------- | ------------------------------------ |
+| `/auth/*`                   | `/auth/*`   | SaToken 登录 / me / logout           |
+| `/oauth/*`                  | `/oauth/*`  | GitHub OAuth 发起                    |
+| `/api/auth/callback/github` | 同名        | GitHub OAuth 回调                    |
+| `/analytics/*`              | 同名        | 埋点写入 + top-docs + events/summary |
+| `/api/user-center/*`        | 同名        | 用户偏好 / profile                   |
+
+这么做的好处：
+
+- 浏览器只看到同源请求，**零 CORS 配置**
+- Vercel 对 rewrite 是 **edge proxy 不是 function invocation**，**不吃 Fluid CPU**
+- 环境切换只改 `BACKEND_URL` 一个变量
+
+---
+
+## 环境变量约定
+
+**生产环境不做硬编码 fallback**（`?? "http://localhost:8081"` 这类写法在生产环境禁止）。
+当前仓库里还有少量开发态 / 历史路径在用 `BACKEND_URL ?? "http://localhost:8080"`
+（例如 `next.config.mjs` 的 rewrites 和 `app/api/upload/route.ts`），目的是本地联调
+时减少启动门槛；这些只是过渡状态，**不能作为长期约定**。
+
+原因：端口不一致（8080/8081/其他）时，fallback 很容易把"漏配"变成"静默请求到错误地址"，
+排查成本更高。新代码应该在 env 缺失时显式报错或返回空结果。
+
+| 变量                      | 前端读取场景                | 设置位置                               |
+| ------------------------- | --------------------------- | -------------------------------------- |
+| `BACKEND_URL`             | Server 端（SSR、API Route） | `.env.local` (dev) / Vercel env (prod) |
+| `NEXT_PUBLIC_BACKEND_URL` | 浏览器端（HotDocsTab 这种） | 同上                                   |
+
+`.env.sample` 里保留 `BACKEND_URL=http://localhost:8080` 作为模板，开发者 `cp .env.sample .env.local` 后按自己后端端口改。
+
+`_DEV` 后缀只用于**需要两套不同值的场景**（例如 `AUTH_GITHUB_ID_DEV` = 本地 OAuth App，`AUTH_GITHUB_ID` = 生产 OAuth App）。
+
+---
+
+## 个人主页 feature 的落地（范例）
+
+以 `/u/[username]` 为例说明约定怎么应用：
+
+### 数据流
+
+```
+浏览器访问 /u/longsizhuo
+    │
+    ▼
+Next.js SSR app/u/[username]/page.tsx
+    │
+    │ fetch(`${BACKEND_URL}/api/user-center/profile/longsizhuo`)
+    │ next: { revalidate: 300 }    ← ISR 缓存 5min
+    │
+    ▼
+Java GET /api/user-center/profile/{username}
+    │ （SaToken 白名单，匿名可访问）
+    │
+    ├─ UserCenterService.findByUsername()  → UserAccount
+    └─ UserCenterService.getPreferences()  → Map<String, Object>
+    │
+    ▼
+返回 { user: UserView, preferences: {...} }
+    │
+    ▼
+Next 渲染 HTML + Bento Grid + ProfileCard 组件
+```
+
+### 数据契约
+
+`preferences` JSONB 约定这些顶层 key：
+
+```jsonc
+{
+  "bio": "一句话简介",
+  "tagline": "小标题（比如研究方向）",
+  "links": [
+    { "label": "GitHub", "url": "https://..." },
+    { "label": "Blog", "url": "https://..." },
+  ],
+  "projects": [
+    {
+      "title": "项目名",
+      "description": "一段描述",
+      "url": "https://...",
+      "tags": ["TypeScript", "LLM"],
+    },
+  ],
+  "pinned_papers": [
+    {
+      "title": "论文标题",
+      "authors": "Alice, Bob",
+      "year": 2024,
+      "url": "https://...",
+      "abstract": "摘要文字",
+    },
+  ],
+}
+```
+
+前端 V1 只读，后端已经有 `PATCH /api/user-center/preferences`（登录用户合并更新自己），编辑 UI V2 再接。
+
+### 文档贡献数据源
+
+不走数据库，走 build-time 生成的 `generated/site-leaderboard.json`（`scripts/generate-leaderboard.mjs` 在每次 build 前跑）。前端 SSR 时直接 import，零运行时查询。
+
+理由：贡献数据每次 deploy 才变，不需要实时。真要实时化再迁 Java。
+
+---
+
+## V2 待办
+
+- [ ] `/u/[username]/edit` 编辑页（复用 `PATCH /api/user-center/preferences`）
+- [ ] `/api/docs/history` → Java（Caffeine 1h）
+- [ ] 个人主页 Zotero pinned_papers 改为存 itemKey，运行时关联 Zotero group API
+- [ ] `analyticsEvent` 表如果长期不读取，考虑废弃；若自建 dashboard 再续
diff --git a/generated/site-leaderboard.json b/generated/site-leaderboard.json
index c8651b8f..76cc47d9 100644
--- a/generated/site-leaderboard.json
+++ b/generated/site-leaderboard.json
@@ -801,7 +801,53 @@
         "title": "2335. The shortest total time to be filled with a cup One question daily",
         "url": "/docs/CommunityShare/Leetcode/2335. 装满杯子需要的最短总时长_translated"
       }
-    ]
+    ],
+    "dailyCounts": {
+      "2025-09-26": 82,
+      "2025-10-26": 2,
+      "2025-10-25": 7,
+      "2025-10-08": 29,
+      "2025-10-27": 3,
+      "2025-12-05": 11,
+      "2025-11-09": 7,
+      "2025-12-04": 3,
+      "2025-12-13": 2,
+      "2026-03-09": 4,
+      "2026-04-11": 6,
+      "2025-11-14": 2,
+      "2025-12-07": 15,
+      "2025-12-11": 2,
+      "2025-12-10": 2,
+      "2025-11-23": 2,
+      "2025-12-09": 2,
+      "2025-11-24": 2,
+      "2025-12-17": 2,
+      "2025-11-12": 2,
+      "2025-12-03": 2,
+      "2025-11-13": 2,
+      "2025-11-25": 2,
+      "2025-11-20": 2,
+      "2025-11-15": 2,
+      "2025-12-06": 3,
+      "2025-12-12": 2,
+      "2025-12-18": 2,
+      "2026-01-10": 3,
+      "2025-11-11": 2,
+      "2025-11-10": 2,
+      "2025-11-17": 2,
+      "2025-11-19": 2,
+      "2025-12-14": 2,
+      "2025-12-16": 2,
+      "2025-11-27": 2,
+      "2025-11-22": 2,
+      "2025-11-26": 2,
+      "2025-11-21": 2,
+      "2025-12-01": 2,
+      "2025-12-08": 2,
+      "2025-11-16": 2,
+      "2025-11-18": 2,
+      "2025-11-29": 2
+    }
   },
   {
     "id": "163523387",
@@ -1170,7 +1216,29 @@
         "title": "Prompt Repetition Improves Non-Reasoning LLMs",
         "url": "/docs/CommunityShare/Amazing-AI-Tools/prompt-repetition-improves-non-reasoning-llms.zh"
       }
-    ]
+    ],
+    "dailyCounts": {
+      "2025-09-17": 16,
+      "2025-09-13": 59,
+      "2025-09-19": 6,
+      "2025-09-14": 6,
+      "2025-09-18": 2,
+      "2025-09-24": 1,
+      "2025-10-15": 3,
+      "2025-09-23": 1,
+      "2025-09-22": 1,
+      "2025-09-27": 5,
+      "2025-10-17": 7,
+      "2025-10-18": 3,
+      "2025-10-11": 3,
+      "2025-10-03": 2,
+      "2025-10-25": 6,
+      "2025-10-10": 1,
+      "2025-11-01": 2,
+      "2025-09-28": 2,
+      "2025-10-26": 2,
+      "2026-04-01": 1
+    }
   },
   {
     "id": "7187663",
@@ -1254,7 +1322,15 @@
         "title": "1234. Replace the sub -string to get a balanced string One question daily",
         "url": "/docs/CommunityShare/Leetcode/1234. 替换子串得到平衡字符串_translated"
       }
-    ]
+    ],
+    "dailyCounts": {
+      "2025-09-12": 6,
+      "2025-10-08": 3,
+      "2025-10-03": 4,
+      "2025-09-17": 2,
+      "2025-09-30": 1,
+      "2025-11-16": 3
+    }
   },
   {
     "id": "73457237",
@@ -1313,7 +1389,12 @@
         "title": "求职活动回放站",
         "url": "/docs/jobs/event-keynote/event-takeway"
       }
-    ]
+    ],
+    "dailyCounts": {
+      "2025-09-20": 6,
+      "2025-09-18": 6,
+      "2026-02-08": 1
+    }
   },
   {
     "id": "188854497",
@@ -1367,7 +1448,13 @@
         "title": "王树森推荐系统学习笔记_排序",
         "url": "/docs/ai/recommender-systems/wangshusen_recommend_note_rank"
       }
-    ]
+    ],
+    "dailyCounts": {
+      "2025-09-22": 2,
+      "2025-09-27": 5,
+      "2025-10-10": 2,
+      "2025-10-09": 1
+    }
   },
   {
     "id": "100033202",
@@ -1416,7 +1503,11 @@
         "title": "手写线程池",
         "url": "/docs/computer-science/cpp_backend/Handwritten_pool_components/1_Handwritten_threadpool"
       }
-    ]
+    ],
+    "dailyCounts": {
+      "2025-09-30": 7,
+      "2025-09-27": 1
+    }
   },
   {
     "id": "166212872",
@@ -1445,7 +1536,13 @@
         "title": "RAG",
         "url": "/docs/CommunityShare/RAG/rag"
       }
-    ]
+    ],
+    "dailyCounts": {
+      "2025-10-02": 1,
+      "2025-10-01": 2,
+      "2025-10-03": 1,
+      "2025-09-19": 2
+    }
   },
   {
     "id": "206296353",
@@ -1459,7 +1556,10 @@
         "title": "PPO",
         "url": "/docs/CommunityShare/Personal-Study-Notes/Reinforcement-Learning/ppo"
       }
-    ]
+    ],
+    "dailyCounts": {
+      "2025-10-03": 4
+    }
   },
   {
     "id": "59130571",
@@ -1478,7 +1578,11 @@
         "title": "如何部署你自己的Github图床-PictureCDN",
         "url": "/docs/CommunityShare/Geek/picturecdn"
       }
-    ]
+    ],
+    "dailyCounts": {
+      "2025-09-19": 1,
+      "2025-09-27": 2
+    }
   },
   {
     "id": "84211946",
@@ -1492,7 +1596,10 @@
         "title": "Recommended Books on Mathematics and Data Science",
         "url": "/docs/ai/ai-math-basics/math_books"
       }
-    ]
+    ],
+    "dailyCounts": {
+      "2025-10-06": 3
+    }
   },
   {
     "id": "104760545",
@@ -1511,7 +1618,10 @@
         "title": "frontend",
         "url": "/docs/computer-science/frontend"
       }
-    ]
+    ],
+    "dailyCounts": {
+      "2025-09-19": 2
+    }
   },
   {
     "id": "123258594",
@@ -1525,7 +1635,10 @@
         "title": "Introduction of Multi-agents system(In any task you want)",
         "url": "/docs/ai/Introduction-of-Multi-agents-system/introduction_of_multi-agents_system"
       }
-    ]
+    ],
+    "dailyCounts": {
+      "2025-09-29": 2
+    }
   },
   {
     "id": "150361711",
@@ -1544,7 +1657,10 @@
         "title": "多模态强化学习项目（MVP 目标）",
         "url": "/docs/all-projects/multimodal-rl"
       }
-    ]
+    ],
+    "dailyCounts": {
+      "2025-10-17": 2
+    }
   },
   {
     "id": "194795025",
@@ -1563,7 +1679,11 @@
         "title": "使用 Cloudflare R2 + ShareX 搭建个人/团队专属“永久”图床",
         "url": "/docs/CommunityShare/Geek/cloudflare-r2-sharex-free-image-hosting"
       }
-    ]
+    ],
+    "dailyCounts": {
+      "2025-09-21": 1,
+      "2025-09-27": 1
+    }
   },
   {
     "id": "76551253",
@@ -1577,7 +1697,10 @@
         "title": "Theory of MoE",
         "url": "/docs/ai/MoE/moe-update"
       }
-    ]
+    ],
+    "dailyCounts": {
+      "2025-10-06": 1
+    }
   },
   {
     "id": "88451018",
@@ -1591,7 +1714,10 @@
         "title": "Git入门操作指南-程序员必会的git小技巧",
         "url": "/docs/CommunityShare/Geek/git101"
       }
-    ]
+    ],
+    "dailyCounts": {
+      "2025-10-15": 1
+    }
   },
   {
     "id": "90535573",
@@ -1605,7 +1731,10 @@
         "title": "程序员学生时期求职与实习经验分享",
         "url": "/docs/jobs/interview-prep/preparations-to-get-an-offer-as-a-student"
       }
-    ]
+    ],
+    "dailyCounts": {
+      "2025-09-29": 1
+    }
   },
   {
     "id": "95595902",
@@ -1619,7 +1748,10 @@
         "title": "程序员 Burnout 自救指南",
         "url": "/docs/CommunityShare/MentalHealth/burnout-guide"
       }
-    ]
+    ],
+    "dailyCounts": {
+      "2025-09-26": 1
+    }
   },
   {
     "id": "128119791",
@@ -1633,7 +1765,10 @@
         "title": "Prompt Repetition Improves Non-Reasoning LLMs",
         "url": "/docs/CommunityShare/Amazing-AI-Tools/prompt-repetition-improves-non-reasoning-llms.zh"
       }
-    ]
+    ],
+    "dailyCounts": {
+      "2026-03-05": 1
+    }
   },
   {
     "id": "138507318",
@@ -1647,7 +1782,10 @@
         "title": "Prompt Repetition Improves Non-Reasoning LLMs",
         "url": "/docs/CommunityShare/Amazing-AI-Tools/prompt-repetition-improves-non-reasoning-llms.zh"
       }
-    ]
+    ],
+    "dailyCounts": {
+      "2026-04-09": 1
+    }
   },
   {
     "id": "147322547",
@@ -1661,6 +1799,9 @@
         "title": "程序员 Burnout 自救指南",
         "url": "/docs/CommunityShare/MentalHealth/burnout-guide"
       }
-    ]
+    ],
+    "dailyCounts": {
+      "2025-10-14": 1
+    }
   }
 ]
diff --git a/lib/i18n/client.tsx b/lib/i18n/client.tsx
new file mode 100644
index 00000000..6e0a0045
--- /dev/null
+++ b/lib/i18n/client.tsx
@@ -0,0 +1,41 @@
+"use client";
+
+import { createContext, useContext, useMemo } from "react";
+import { formatMessage, type Locale, type MessageKey } from "./messages";
+
+const LocaleContext = createContext<Locale>("zh");
+
+/**
+ * 包在根 layout 上，locale 由服务端读 cookie 算好再传下来。
+ * 客户端组件用 useT() 拿翻译函数；不用自己读 cookie（那样 SSR/CSR 会不一致）。
+ */
+export function LocaleProvider({
+  locale,
+  children,
+}: {
+  locale: Locale;
+  children: React.ReactNode;
+}) {
+  return (
+    <LocaleContext.Provider value={locale}>{children}</LocaleContext.Provider>
+  );
+}
+
+/**
+ * 客户端组件翻译 hook。
+ *   const t = useT();
+ *   <button>{t("follow.follow")}</button>
+ */
+export function useT() {
+  const locale = useContext(LocaleContext);
+  return useMemo(
+    () => (key: MessageKey, params?: Record<string, string | number>) =>
+      formatMessage(locale, key, params),
+    [locale],
+  );
+}
+
+/** 直接取当前 locale，较少用（大多数时候你要的是 useT） */
+export function useLocale(): Locale {
+  return useContext(LocaleContext);
+}
diff --git a/lib/i18n/messages.ts b/lib/i18n/messages.ts
new file mode 100644
index 00000000..f0137c74
--- /dev/null
+++ b/lib/i18n/messages.ts
@@ -0,0 +1,282 @@
+/**
+ * 站内 UI 字符串字典。所有 key 两种语言必须同结构，否则 TS 类型约束会红。
+ *
+ * 约定：
+ * - 纯静态字符串直接写
+ * - 带参数用 {name} 占位，调用方通过 formatMessage 填充
+ * - key 用扁平结构（profile.stats.docs），避免 type 推导嵌套过深
+ */
+
+const zh = {
+  // 个人主页
+  "profile.dossier": "User Dossier",
+  "profile.volumeIssue": "Vol. 1 Issue {id}",
+  "profile.fullRank": "总排行榜 →",
+  "profile.editProfile": "编辑主页 →",
+  "profile.sec.profile": "SEC. PROFILE · 001",
+  "profile.stats.docs": "文档贡献",
+  "profile.stats.commits": "累计 Commits",
+  "profile.stats.points": "积分",
+  "profile.empty.title": "还没填个人项目和最近在读的论文",
+  "profile.empty.subtitle": "下方仍会显示 GitHub repos 和文档贡献",
+
+  // 关注按钮
+  "follow.followers": "粉丝",
+  "follow.following": "关注",
+  "follow.signInToFollow": "登录后关注",
+  "follow.follow": "+ 关注",
+  "follow.unfollow": "已关注",
+
+  // 活跃度热力图
+  "activity.sec": "SEC. ACTIVITY · 005",
+  "activity.heading": "活跃度 · 最近 52 周",
+  "activity.stats": "{days} 天有贡献 · 合计 {commits} commits",
+  "activity.legend.less": "少",
+  "activity.legend.more": "多",
+  "activity.weekday.mon": "周一",
+  "activity.weekday.thu": "周四",
+  "activity.weekday.sat": "周六",
+  "activity.month.1": "1月",
+  "activity.month.2": "2月",
+  "activity.month.3": "3月",
+  "activity.month.4": "4月",
+  "activity.month.5": "5月",
+  "activity.month.6": "6月",
+  "activity.month.7": "7月",
+  "activity.month.8": "8月",
+  "activity.month.9": "9月",
+  "activity.month.10": "10月",
+  "activity.month.11": "11月",
+  "activity.month.12": "12月",
+
+  // GitHub repos
+  "repos.sec": "SEC. REPOS · 006",
+  "repos.heading": "GitHub 仓库",
+  "repos.subtitle": "公开仓库 · 按 stars + 更新时间排序",
+  "repos.count": "{n} 个项目",
+
+  // 贡献文档列表
+  "docs.sec": "SEC. DOCS · 007",
+  "docs.heading": "贡献过的文档",
+  "docs.count": "{n} 篇 · 合计 {commits} commits",
+  "docs.showMore": "展开剩余 {n} 篇 ↓",
+
+  // ProfileCard
+  "card.kind.project": "项目",
+  "card.kind.paper": "论文",
+  "card.kind.doc": "文档",
+  "card.view": "查看 →",
+
+  // 编辑页
+  "edit.pageTitle": "编辑个人主页",
+  "edit.pageHeader": "Edit · User Dossier",
+  "edit.loading": "正在加载...",
+  "edit.auth.required": "需要登录后才能编辑个人主页。",
+  "edit.auth.signIn": "Sign In →",
+  "edit.auth.notYours": "这不是你的主页（URL 标识 {id}），只有本人可以编辑。",
+  "edit.auth.goMine": "去我的主页 →",
+  "edit.intro.label": "About this page",
+  "edit.intro.body":
+    "这里填的内容会显示在你的个人主页 /u/{id} 上，让别人知道你是谁、做什么、在读什么。全部字段都是可选，填哪个显示哪个；不填主页就只显示 GitHub 基础信息 + 贡献统计。",
+  "edit.cta.save": "保存 →",
+  "edit.cta.saving": "保存中...",
+  "edit.cta.cancel": "取消",
+  "edit.status.saved": "已保存，返回主页...",
+  "edit.error.noToken": "未检测到登录 token，请重新登录",
+  "edit.error.http": "保存失败：HTTP {status}",
+  "edit.error.unknown": "保存出错",
+  "edit.section.add": "+ 新增",
+  "edit.section.remove": "删除此项",
+
+  // 编辑页 Section 1: Identity
+  "edit.sec1.title": "SEC. 01 · IDENTITY",
+  "edit.sec1.heading": "关于你自己",
+  "edit.sec1.description":
+    "一句小标题 + 一段自我介绍，会显示在主页左侧大块最上方。相当于你在站内的名片。",
+  "edit.sec1.tagline.label": "一句话标签（tagline，80 字以内）",
+  "edit.sec1.tagline.placeholder":
+    "比如：LLM Safety 方向 · UNSW 在读 / 全栈搞着玩 / 找暑期实习中",
+  "edit.sec1.bio.label": "自我介绍（bio，80-200 字较合适）",
+  "edit.sec1.bio.placeholder":
+    "你是谁、在做什么、感兴趣的方向。举例：我是 xxx，读研在做 LLM 对齐，平时写写文档和小工具。想认识做 RLHF / 评估 / infra 的朋友。",
+
+  // 编辑页 Section 2: Links
+  "edit.sec2.title": "SEC. 02 · LINKS",
+  "edit.sec2.heading": "外部链接",
+  "edit.sec2.description":
+    "想让大家跟你联系 / 了解你的其他地方。最多 5 条，会显示在主页左侧大块底部，以小按钮形式展示。",
+  "edit.sec2.label.placeholder": "按钮上显示的字，如 Blog / Twitter / 知乎",
+  "edit.sec2.url.placeholder": "https://your-blog.com",
+
+  // 编辑页 Section 3: Projects
+  "edit.sec3.title": "SEC. 03 · PROJECTS",
+  "edit.sec3.heading": "你自己的项目",
+  "edit.sec3.description":
+    "想展示的个人项目 / 玩具 / 开源作品。GitHub 公开 repos 会自动出现在主页底部，这里填 GitHub 里没有或想单独强调的。最多 8 条。",
+  "edit.sec3.title.placeholder": "项目名，如 involutionhell.com",
+  "edit.sec3.desc.placeholder":
+    "一两句说明做了什么、解决什么问题。hover 时会展开显示",
+  "edit.sec3.url.placeholder": "项目链接（GitHub repo / 产品首页）",
+  "edit.sec3.tags.placeholder":
+    "技术栈标签，逗号分隔。例如 TypeScript, Next.js, LLM",
+
+  // 编辑页 Section 4: Papers
+  "edit.sec4.title": "SEC. 04 · PAPERS",
+  "edit.sec4.heading": "最近在读 / 推荐的论文",
+  "edit.sec4.description":
+    "你最近读到觉得值得分享的论文（学术 / 技术博客都行）。可以填 Zotero itemKey 自动补齐信息，也可以手动填标题作者年份。不是必填，没有就留空。",
+  "edit.sec4.itemKey.placeholder":
+    "Zotero itemKey（可选，填了会自动拉元信息；不填就手填下面字段）",
+  "edit.sec4.title.placeholder": "论文标题",
+  "edit.sec4.authors.placeholder": "作者（Alice, Bob）",
+  "edit.sec4.year.placeholder": "年份",
+  "edit.sec4.url.placeholder": "链接",
+  "edit.sec4.abstract.placeholder": "摘要或一句话评价",
+} as const;
+
+const en: Record<keyof typeof zh, string> = {
+  "profile.dossier": "User Dossier",
+  "profile.volumeIssue": "Vol. 1 Issue {id}",
+  "profile.fullRank": "Full Rank →",
+  "profile.editProfile": "Edit Profile →",
+  "profile.sec.profile": "SEC. PROFILE · 001",
+  "profile.stats.docs": "Docs",
+  "profile.stats.commits": "Commits",
+  "profile.stats.points": "Points",
+  "profile.empty.title": "No projects or reading list yet.",
+  "profile.empty.subtitle":
+    "GitHub repos and doc contributions still shown below.",
+
+  "follow.followers": "Followers",
+  "follow.following": "Following",
+  "follow.signInToFollow": "Sign in to follow",
+  "follow.follow": "+ Follow",
+  "follow.unfollow": "Following",
+
+  "activity.sec": "SEC. ACTIVITY · 005",
+  "activity.heading": "Activity · Last 52 Weeks",
+  "activity.stats": "{days} active days · {commits} commits",
+  "activity.legend.less": "Less",
+  "activity.legend.more": "More",
+  "activity.weekday.mon": "Mon",
+  "activity.weekday.thu": "Thu",
+  "activity.weekday.sat": "Sat",
+  "activity.month.1": "Jan",
+  "activity.month.2": "Feb",
+  "activity.month.3": "Mar",
+  "activity.month.4": "Apr",
+  "activity.month.5": "May",
+  "activity.month.6": "Jun",
+  "activity.month.7": "Jul",
+  "activity.month.8": "Aug",
+  "activity.month.9": "Sep",
+  "activity.month.10": "Oct",
+  "activity.month.11": "Nov",
+  "activity.month.12": "Dec",
+
+  "repos.sec": "SEC. REPOS · 006",
+  "repos.heading": "GitHub Repositories",
+  "repos.subtitle": "Public repos · sorted by stars & updates",
+  "repos.count": "{n} repos",
+
+  "docs.sec": "SEC. DOCS · 007",
+  "docs.heading": "Docs Contributed",
+  "docs.count": "{n} docs · {commits} commits",
+  "docs.showMore": "Show {n} more ↓",
+
+  "card.kind.project": "Project",
+  "card.kind.paper": "Paper",
+  "card.kind.doc": "Docs",
+  "card.view": "View →",
+
+  "edit.pageTitle": "Edit Profile",
+  "edit.pageHeader": "Edit · User Dossier",
+  "edit.loading": "Loading...",
+  "edit.auth.required": "Sign in to edit your profile.",
+  "edit.auth.signIn": "Sign In →",
+  "edit.auth.notYours":
+    "This isn’t your profile (URL ID: {id}). Only the owner can edit.",
+  "edit.auth.goMine": "Go to my profile →",
+  "edit.intro.label": "About this page",
+  "edit.intro.body":
+    "What you put here shows up on your profile page at /u/{id}. Every field is optional — fill what you like; empty profiles still show GitHub info and contribution stats.",
+  "edit.cta.save": "Save →",
+  "edit.cta.saving": "Saving...",
+  "edit.cta.cancel": "Cancel",
+  "edit.status.saved": "Saved. Redirecting...",
+  "edit.error.noToken": "Login token missing, please sign in again",
+  "edit.error.http": "Save failed: HTTP {status}",
+  "edit.error.unknown": "Save failed",
+  "edit.section.add": "+ Add",
+  "edit.section.remove": "Remove",
+
+  "edit.sec1.title": "SEC. 01 · IDENTITY",
+  "edit.sec1.heading": "About You",
+  "edit.sec1.description":
+    "A one-line tagline and a short bio. Shown at the top of your profile left column — think of it as your site-wide business card.",
+  "edit.sec1.tagline.label": "Tagline (≤80 chars)",
+  "edit.sec1.tagline.placeholder":
+    "e.g. LLM Safety @ UNSW · looking for summer internships",
+  "edit.sec1.bio.label": "Bio (80-200 chars recommended)",
+  "edit.sec1.bio.placeholder":
+    "Who you are, what you're working on, what you're interested in. e.g. CS MSc, working on alignment, writing tools on the side; happy to chat about RLHF / evals / infra.",
+
+  "edit.sec2.title": "SEC. 02 · LINKS",
+  "edit.sec2.heading": "Links",
+  "edit.sec2.description":
+    "External places people can reach you or learn more. Up to 5 items; shown as small buttons at the bottom of your profile left column.",
+  "edit.sec2.label.placeholder": "Button label, e.g. Blog / Twitter / Zhihu",
+  "edit.sec2.url.placeholder": "https://your-blog.com",
+
+  "edit.sec3.title": "SEC. 03 · PROJECTS",
+  "edit.sec3.heading": "Your Projects",
+  "edit.sec3.description":
+    "Personal projects / toys / open-source work. Your public GitHub repos are shown automatically below; use this for things not on GitHub or worth highlighting. Up to 8 items.",
+  "edit.sec3.title.placeholder": "Project name, e.g. involutionhell.com",
+  "edit.sec3.desc.placeholder":
+    "1-2 sentences on what it does. Expands on hover.",
+  "edit.sec3.url.placeholder": "Project URL (GitHub repo / product homepage)",
+  "edit.sec3.tags.placeholder":
+    "Comma-separated tech tags, e.g. TypeScript, Next.js, LLM",
+
+  "edit.sec4.title": "SEC. 04 · PAPERS",
+  "edit.sec4.heading": "Currently Reading / Recommended Papers",
+  "edit.sec4.description":
+    "Papers you've recently read and want to share (academic or tech-blog). Add a Zotero itemKey to auto-fill metadata, or type title / authors / year manually. Optional.",
+  "edit.sec4.itemKey.placeholder":
+    "Zotero itemKey (optional — auto-fills metadata; or leave empty and fill below)",
+  "edit.sec4.title.placeholder": "Paper title",
+  "edit.sec4.authors.placeholder": "Authors (Alice, Bob)",
+  "edit.sec4.year.placeholder": "Year",
+  "edit.sec4.url.placeholder": "URL",
+  "edit.sec4.abstract.placeholder": "Abstract or one-line take",
+};
+
+/** 所有字典必须实现 zh 里的全部 key */
+export type MessageKey = keyof typeof zh;
+export type Messages = Record<MessageKey, string>;
+export type Locale = "zh" | "en";
+
+export const messagesByLocale: Record<Locale, Messages> = { zh, en };
+
+/**
+ * 取字典 + 模板参数填充。缺 key 退回 zh，再缺返回 key 本身方便定位。
+ *
+ * 用法：
+ *   const t = (k, p) => formatMessage(locale, k, p)
+ *   t("profile.stats.docs")                            // "文档贡献" / "Docs"
+ *   t("activity.stats", { days: 44, commits: 237 })    // "44 天有贡献 · 合计 237 commits"
+ */
+export function formatMessage(
+  locale: Locale,
+  key: MessageKey,
+  params?: Record<string, string | number>,
+): string {
+  const raw =
+    messagesByLocale[locale]?.[key] ?? messagesByLocale.zh[key] ?? String(key);
+  if (!params) return raw;
+  return raw.replace(/\{(\w+)\}/g, (_, k) => {
+    const v = params[k];
+    return v == null ? `{${k}}` : String(v);
+  });
+}
diff --git a/lib/i18n/server.ts b/lib/i18n/server.ts
new file mode 100644
index 00000000..27a3b8a0
--- /dev/null
+++ b/lib/i18n/server.ts
@@ -0,0 +1,24 @@
+import "server-only";
+import { cookies } from "next/headers";
+import { formatMessage, type Locale, type MessageKey } from "./messages";
+
+/**
+ * 服务端读 locale cookie。未设置回退 zh（和 docs 页 getLocaleFromCookie 逻辑一致）。
+ * middleware.ts 已经在用户首次访问时写入 locale cookie，这里只是消费。
+ */
+export async function getServerLocale(): Promise<Locale> {
+  const store = await cookies();
+  const val = store.get("locale")?.value;
+  return val === "en" ? "en" : "zh";
+}
+
+/**
+ * 服务端翻译函数。直接在 Server Component 用：
+ *   const t = await getServerT();
+ *   <h1>{t("profile.stats.docs")}</h1>
+ */
+export async function getServerT() {
+  const locale = await getServerLocale();
+  return (key: MessageKey, params?: Record<string, string | number>) =>
+    formatMessage(locale, key, params);
+}
diff --git a/next.config.mjs b/next.config.mjs
index 69dcbeec..155ee446 100644
--- a/next.config.mjs
+++ b/next.config.mjs
@@ -51,6 +51,12 @@ const config = {
         source: "/oauth/:path*",
         destination: `${backendUrl}/oauth/:path*`,
       },
+      {
+        // 文档 commit 历史代理到 Java（带 Caffeine 10min 缓存 + GITHUB_TOKEN），
+        // 原 Next API Route 已删除，避免 Vercel Fluid CPU 被拉取 GitHub API 的请求吃掉
+        source: "/api/docs/history",
+        destination: `${backendUrl}/api/docs/history`,
+      },
     ];
   },
   images: {
diff --git a/prisma/schema.prisma b/prisma/schema.prisma
index c3676a32..06aec1a7 100644
--- a/prisma/schema.prisma
+++ b/prisma/schema.prisma
@@ -139,3 +139,17 @@ model AnalyticsEvent {
   @@index([eventType])
   @@index([userId])
 }
+
+/// 用户关注关系：follower_id 关注了 followee_id。
+/// 两个字段都对应 user_accounts.id（BigInt/Long），和 analytics/chat 保持一致。
+/// 不建外键约束：user_accounts 由 Java 侧 SaToken 管理，Prisma 只负责 schema 声明，
+/// 避免 cross-ownership 的删除级联踩坑。
+model user_follows {
+  follower_id BigInt
+  followee_id BigInt
+  created_at  DateTime @default(now()) @db.Timestamptz(6)
+
+  @@id([follower_id, followee_id])
+  @@index([followee_id])
+  @@index([follower_id])
+}
diff --git a/scripts/generate-leaderboard.mjs b/scripts/generate-leaderboard.mjs
index d282bbc8..52d1da4c 100644
--- a/scripts/generate-leaderboard.mjs
+++ b/scripts/generate-leaderboard.mjs
@@ -11,9 +11,56 @@ import fs from "node:fs/promises";
 import path from "node:path";
 import process from "node:process";
 import { fileURLToPath } from "node:url";
+import { execSync } from "node:child_process";
 import dotenv from "dotenv";
 dotenv.config({ path: [".env.local", ".env"] });
 
+/**
+ * 从仓库 git log 反推 GitHub id → login 映射，优先走 noreply 邮箱（GitHub 默认启用 privacy）。
+ * 格式：
+ *   1234567+alice@users.noreply.github.com   → id=1234567, login=alice
+ *   alice@users.noreply.github.com           → login=alice（老格式，没 id，只能 name 回填）
+ *
+ * 这样 build 时不用调 100 次 GitHub API 就能拿到绝大多数贡献者的 login，
+ * 只有用真实邮箱提交的（少数）才回退到 GitHub API。
+ */
+function buildLoginMapFromGitLog() {
+  const byId = {}; // github_id → login
+  const byLogin = {}; // login → login（用于老格式邮箱的兜底，至少保住 name 字段）
+  try {
+    // --all 覆盖所有 ref；--no-merges 去掉 merge commit 噪音；%ae 邮箱；%an 展示名
+    const out = execSync("git log --all --no-merges --format='%ae%x09%an'", {
+      encoding: "utf8",
+      maxBuffer: 50 * 1024 * 1024,
+    });
+    for (const line of out.split("\n")) {
+      if (!line) continue;
+      const [email, name] = line.split("\t");
+      if (!email) continue;
+      // 先匹配带 id 的 noreply： "1234567+alice@users.noreply.github.com"
+      const newStyle = email.match(
+        /^(\d+)\+([^@\s]+)@users\.noreply\.github\.com$/,
+      );
+      if (newStyle) {
+        byId[newStyle[1]] = newStyle[2];
+        byLogin[newStyle[2]] = newStyle[2];
+        continue;
+      }
+      // 老式 noreply： "alice@users.noreply.github.com"（没 id，只能靠 login 反查）
+      const oldStyle = email.match(/^([^@\s]+)@users\.noreply\.github\.com$/);
+      if (oldStyle) {
+        byLogin[oldStyle[1]] = oldStyle[1];
+      }
+    }
+  } catch (e) {
+    console.warn(
+      "[generate-leaderboard] git log 解析 login 失败（是否不在仓库内？），退回到纯 GitHub API 模式：",
+      e instanceof Error ? e.message : e,
+    );
+  }
+  return { byId, byLogin };
+}
+
 // 兼容 Prisma client 引入方式
 import * as PrismaModule from "../generated/prisma/client.ts";
 const PrismaClient =
@@ -139,10 +186,20 @@ async function main() {
         grouped[gid] = {
           contributions: 0,
           docs: new Set(),
+          // 按日分桶的贡献次数，用于前端渲染活跃度热力图（GitHub 风格 365 格）
+          dailyCounts: {},
         };
       }
       grouped[gid].contributions += record.contributions;
       grouped[gid].docs.add(record.doc_id);
+      // last_contributed_at 是 timestamptz，只要精度到日即可
+      const day = record.last_contributed_at
+        ? new Date(record.last_contributed_at).toISOString().slice(0, 10)
+        : null;
+      if (day) {
+        grouped[gid].dailyCounts[day] =
+          (grouped[gid].dailyCounts[day] || 0) + record.contributions;
+      }
     }
 
     // 格式化输出榜单
@@ -173,67 +230,85 @@ async function main() {
           commits: data.contributions,
           avatarUrl: `https://avatars.githubusercontent.com/u/${githubId}`,
           contributedDocs: contributedDocsInfo,
+          dailyCounts: data.dailyCounts,
         };
       })
       .sort((a, b) => b.points - a.points);
 
-    // 为前排用户附带一下 Github API 拉取详细昵称信息，由于只是少数人（例如前100），可以接受构建时拉取。
+    // Step 1: 先从本地 git log 的 noreply 邮箱反推 id→login，覆盖绝大多数贡献者。
+    // 这个是纯本地操作，不打 GitHub API，快且免额度。
+    const { byId: loginByGitId } = buildLoginMapFromGitLog();
+    let offlineHits = 0;
+    for (const user of leaderboard) {
+      const login = loginByGitId[user.id];
+      if (login) {
+        user.name = login;
+        offlineHits++;
+      }
+    }
     console.log(
-      `[generate-leaderboard] 已聚合 ${leaderboard.length} 名用户，正在通过 GitHub API 获取前 100 名的详细信息... | Aggregated ${leaderboard.length} users. Annotating top 100 with Github API...`,
+      `[generate-leaderboard] git log 离线匹配 login：${offlineHits}/${leaderboard.length} 条直接拿到，节省同等数量的 GitHub API 调用`,
     );
 
-    // 读取 GITHUB_TOKEN（由 workflow env 注入，见 .github/workflows/sync-uuid.yml）。
-    // 匿名调用 GitHub API 限流 60/hour，带 token 后 5000/hour。没有 token 依然能跑，
-    // 只是前 100 基本全部 403，fallback 回 "GitHub User <id>"。
+    // Step 2: 仍然是 "GitHub User <id>" 占位符的前 100 名才打 GitHub API 兜底
     const ghToken = process.env.GITHUB_TOKEN || process.env.GH_PAT || "";
-    if (!ghToken) {
-      console.warn(
-        "[generate-leaderboard] 未检测到 GITHUB_TOKEN/GH_PAT（GitHub token），名字获取会因限流失败，榜单只会展示 id 占位符",
-      );
-    }
+    const topUsers = leaderboard
+      .slice(0, 100)
+      .filter((u) => u.name === `GitHub User ${u.id}`);
 
-    // 我们在此取前 100 名抓取 Github Name 防止 Rate Limit
-    const topUsers = leaderboard.slice(0, 100);
-    let successCount = 0;
-    let failureCount = 0;
-    for (let user of topUsers) {
-      try {
-        const headers = {
-          "User-Agent": "involutionhell-leaderboard-script",
-          Accept: "application/vnd.github+json",
-        };
-        if (ghToken) headers.Authorization = `Bearer ${ghToken}`;
-        const ghRes = await fetch(`https://api.github.com/user/${user.id}`, {
-          headers,
-        });
-        if (ghRes.ok) {
-          const data = await ghRes.json();
-          user.name = data.login || data.name || user.name;
-          successCount++;
-        } else {
+    if (topUsers.length === 0) {
+      console.log(
+        "[generate-leaderboard] 前 100 名 login 全部命中本地缓存，跳过 GitHub API",
+      );
+    } else {
+      if (!ghToken) {
+        console.warn(
+          `[generate-leaderboard] 还有 ${topUsers.length} 名用户需要走 GitHub API，但未检测到 GITHUB_TOKEN/GH_PAT，限流 60/hour`,
+        );
+      } else {
+        console.log(
+          `[generate-leaderboard] 剩余 ${topUsers.length} 名用户走 GitHub API 兜底 login`,
+        );
+      }
+      let successCount = 0;
+      let failureCount = 0;
+      for (const user of topUsers) {
+        try {
+          const headers = {
+            "User-Agent": "involutionhell-leaderboard-script",
+            Accept: "application/vnd.github+json",
+          };
+          if (ghToken) headers.Authorization = `Bearer ${ghToken}`;
+          const ghRes = await fetch(`https://api.github.com/user/${user.id}`, {
+            headers,
+          });
+          if (ghRes.ok) {
+            const data = await ghRes.json();
+            user.name = data.login || data.name || user.name;
+            successCount++;
+          } else {
+            failureCount++;
+            if (failureCount === 1) {
+              console.warn(
+                `[generate-leaderboard] GitHub API 返回 ${ghRes.status}，后续失败将静默计数。示例响应：`,
+                await ghRes.text().then((t) => t.slice(0, 200)),
+              );
+            }
+          }
+        } catch (err) {
           failureCount++;
-          // 首次失败时打印详情帮助定位（限流 / token 过期 / 被 revoke）
           if (failureCount === 1) {
             console.warn(
-              `[generate-leaderboard] GitHub API 返回 ${ghRes.status}，后续失败将静默计数。示例响应：`,
-              await ghRes.text().then((t) => t.slice(0, 200)),
+              "[generate-leaderboard] GitHub API 请求异常，后续失败将静默计数。示例错误：",
+              err instanceof Error ? err.message : err,
             );
           }
         }
-      } catch (err) {
-        failureCount++;
-        // 首次网络/DNS/SSL 等异常打印一次错误消息，便于排查；后续静默计数
-        if (failureCount === 1) {
-          console.warn(
-            "[generate-leaderboard] GitHub API 请求异常，后续失败将静默计数。示例错误：",
-            err instanceof Error ? err.message : err,
-          );
-        }
       }
+      console.log(
+        `[generate-leaderboard] GitHub API 兜底完成：成功 ${successCount} / 失败 ${failureCount}`,
+      );
     }
-    console.log(
-      `[generate-leaderboard] GitHub 名字获取完成：成功 ${successCount} / 失败 ${failureCount}`,
-    );
 
     await ensureParentDir(outputAbs);