refactor(docs): Option C IA 大重组 — 按读者意图分 learn/career/community/projects 四大区

Admin 反馈"目录结构要重新设计，很多内容过时"。经 owner 拍板选方案 C（按
读者意图分类），全站 docs 在本 PR 内一次到位，避免分多个 PR 把 contributors
的 review 路径切碎。

# 顶层结构（Before → After）

- ai/                   → learn/ai/           （AI 学科知识）
- computer-science/     → learn/cs/           （CS 基础 + 系统）
- jobs/interview-prep/  → career/interview-prep/  （刷题 BQ OA VI）
- jobs/event-keynote/   → career/events/      （Coffee Chat / Mock Interview）
- CommunityShare/Leetcode/  → career/interview-prep/leetcode/  （50+ 题解归求职刷题）
- CommunityShare/Amazing-AI-Tools/perplexity-comet   → community/tools/        （工具推荐）
- CommunityShare/Amazing-AI-Tools/prompt-repetition  → community/papers/       （论文摘要）
- CommunityShare/Geek/leworldmodel                   → community/papers/       （JEPA paper）
- CommunityShare/Geek/*（其他）        → community/dev-tips/   （开发技巧）
- CommunityShare/Language/             → community/language/
- CommunityShare/Life/                 → community/life/
- CommunityShare/MentalHealth/         → community/mental-health/
- CommunityShare/Personal-Study-Notes/Reinforcement-Learning/ppo
                                       → learn/ai/reinforcement-learning/ppo
- all-projects/ + ai/projects/ → projects/（项目文档顶层化）

# 变更清单

1. 新增 4 个顶层区 index.mdx (learn / career / community 原有 / projects)
   加上 SectionIndex 作为品类着陆页
2. 31 条 301 redirects（statusCode:301），覆盖所有老 URL
   - 特殊文件级（RAG / leworldmodel / perplexity-comet / prompt-repetition /
     ppo / swanlab / cpp_backend 老名字 / all-projects/ai-town 等）排前
   - Wildcard 顶层区（/docs/ai/:path* / /docs/computer-science/:path* /
     /docs/jobs/{interview-prep,event-keynote}/:path* / /docs/all-projects/:path* /
     CommunityShare/{Leetcode,Language,Life,MentalHealth,Geek,Amazing-AI-Tools}/:path*）
     排后做兜底
3. Hard-coded URL 修正：Hero.tsx / Footer.tsx / layout.tsx / source.ts /
   SectionIndex.tsx / [...slug]/page.tsx 注释 / dev_docs/umami_tracking.md
4. data/event.json 三条 playback URL + coffee-chat.md 内链域名统一成
   involutionhell.com + 路径指向新位置
5. SectionIndex root props 更新：
   - community/index.mdx:  root="community"
   - career/interview-prep/leetcode/index.mdx:  root="career/interview-prep/leetcode"
6. lib/source.ts pinyin transformer 前缀匹配更新

# docId 守恒

所有 289 个 .mdx/.md 文件的 docId 原样保留，sync-uuid workflow 合 main
后 backfill 按 docId 聚合，老贡献者 contributions 不变，longsizhuo 本轮
rename commit 在每个涉及的 docId 上 +1。

# reviewer subagent 审后修正

reviewer 审出 3 条 P0 死链 + 4 条 P1 index 缺失 + 3 条 P2 陈旧注释，全部
采纳并修完：
- P0 Footer /docs/career 404   → 新建 career/index.mdx
- P0 event.json playback 旧路径 → sed 批量替换
- P0 coffee-chat 内链 vercel.app + 旧路径 → 统一 involutionhell.com + 新路径
- P1 learn/ 和 projects/ 无 index → 新建 index.mdx
- P1 /docs/all-projects 裸路径无 redirect → 补 redirect 规则
- P2 SectionIndex / page.tsx / [...slug] / umami_tracking 注释旧术语 → sed 更新

# 后续工作

- Leetcode 50+ 题解文件名规范化（走 pinyin 路由，URL 规则特殊）
- frontmatter status 字段（active/deprecated/archived）机制接入
- archive/ 过期内容治理（本 PR 暂未创建目录，等 owner/admin 标记具体哪些过期）

Author: github-actions[bot]

app/components/Footer.tsx

@@ -63,7 +63,7 @@ export async function Footer() {
               <ul className="space-y-3 font-body text-sm text-[var(--foreground)]">
                 <li>
                   <Link
-                    href="/docs/ai"
+                    href="/docs/learn/ai"
                     className="hover:text-[#CC0000] transition-colors"
                     data-umami-event="navigation_click"
                     data-umami-event-region="footer"
@@ -74,7 +74,7 @@ export async function Footer() {
                 </li>
                 <li>
                   <Link
-                    href="/docs/computer-science"
+                    href="/docs/learn/cs"
                     className="hover:text-[#CC0000] transition-colors"
                     data-umami-event="navigation_click"
                     data-umami-event-region="footer"
@@ -85,7 +85,7 @@ export async function Footer() {
                 </li>
                 <li>
                   <Link
-                    href="/docs/CommunityShare"
+                    href="/docs/community"
                     className="hover:text-[#CC0000] transition-colors"
                     data-umami-event="navigation_click"
                     data-umami-event-region="footer"
@@ -96,7 +96,7 @@ export async function Footer() {
                 </li>
                 <li>
                   <Link
-                    href="/docs/jobs"
+                    href="/docs/career"
                     className="hover:text-[#CC0000] transition-colors"
                     data-umami-event="navigation_click"
                     data-umami-event-region="footer"

app/components/Hero.tsx

@@ -21,22 +21,22 @@ export async function Hero() {
     {
       title: t("categories.ai.title"),
       desc: t("categories.ai.desc"),
-      href: "/docs/ai",
+      href: "/docs/learn/ai",
     },
     {
       title: t("categories.cs.title"),
       desc: t("categories.cs.desc"),
-      href: "/docs/computer-science",
+      href: "/docs/learn/cs",
     },
     {
       title: t("categories.jobs.title"),
       desc: t("categories.jobs.desc"),
-      href: "/docs/jobs/interview-prep/bq",
+      href: "/docs/career/interview-prep/bq",
     },
     {
       title: t("categories.community.title"),
       desc: t("categories.community.desc"),
-      href: "/docs/CommunityShare",
+      href: "/docs/community",
     },
   ];
 
@@ -91,7 +91,7 @@ export async function Hero() {
                 {t("join.body")}
               </p>
               <Link
-                href="/docs/ai"
+                href="/docs/learn/ai"
                 className="block w-full"
                 data-umami-event="navigation_click"
                 data-umami-event-region="hero_cta"

app/components/docs/SectionIndex.tsx

@@ -9,8 +9,8 @@ import type { PageTree } from "fumadocs-core/server";
  *
  * 三处使用场景：
  *   1. /docs landing        SectionIndex 不传参                         列出顶层分区（ai / cs / 群友分享 等）
- *   2. CommunityShare 首页   SectionIndex root=CommunityShare            列出 Geek / Leetcode / RAG 等子分类
- *   3. Leetcode 首页         SectionIndex root=CommunityShare/Leetcode   列出全部 Leetcode 题解
+ *   2. community 首页 SectionIndex root=community            列出 Geek / Leetcode / RAG 等子分类
+ *   3. career/interview-prep/leetcode 首页 SectionIndex root=career/interview-prep/leetcode   列出全部 Leetcode 题解
  *
  * ----------------------------------------------------------------------------
  * 为什么不直接用 fumadocs 自带的？
@@ -27,7 +27,7 @@ import type { PageTree } from "fumadocs-core/server";
  *     children:
  *       Folder
  *         name = AI 知识库
- *         index = Page(url=/docs/ai, name=AI 知识库)      // 有 index.mdx
+ *         index = Page(url=/docs/learn/ai, name=AI 知识库)      // 有 index.mdx
  *         children: [Page, Folder, ...]
  *       Folder
  *         name = All projects
@@ -53,7 +53,7 @@ type FolderNode = Extract<PageTree.Node, { type: "folder" }>;
 
 interface SectionIndexProps {
   /**
-   * 从 pageTree 根往下走的目录路径，段之间用 / 分隔，例如 CommunityShare/Leetcode。
+   * 从 pageTree 根往下走的目录路径，段之间用 / 分隔，例如 career/interview-prep/leetcode。
    * 不传 = 直接用 pageTree 根节点本身（用于 /docs landing）。
    */
   root?: string;
@@ -69,9 +69,9 @@ interface CardEntry {
 /**
  * 从 pageTree 根一路钻到 root 指定的目录节点。
  *
- * 举例：root = CommunityShare/Leetcode
- *   1) 根的 children 里找 segmentName = CommunityShare 的 folder
- *   2) 再在这个 folder 的 children 里找 segmentName = Leetcode 的 folder
+ * 举例：root = career/interview-prep/leetcode
+ *   1) 根的 children 里找 segmentName = career 的 folder
+ *   2) 再在这个 folder 的 children 里找 segmentName = interview-prep/leetcode 的 folder
  *   3) 返回这个 folder 节点
  *
  * 任一段找不到就返回 null（组件会渲染一个明显的错误提示，而不是静默空页）。
@@ -101,7 +101,7 @@ function findFolderByPath(
  * 为什么不直接用 folder.name：
  * fumadocs 的 FolderNode.name 是 ReactNode 类型（可能是 string，也可能是 JSX），
  * 直接字符串比较会在极端情况踩坑。更可靠的办法是从 folder.index.url 反推——
- * 比如 /docs/CommunityShare/Geek 最后一段 Geek 就是目录名。
+ * 比如 /docs/community/dev-tips 最后一段 Geek 就是目录名。
  *
  * 没 index 时退回 name.toString()。目前仓库里这种情况目录名都是纯字符串，
  * 所以兜底够用。
@@ -154,10 +154,10 @@ function buildCanonicalUrlSet(): Set<string> {
  * 用途：folder 没有自己的 index.mdx 时，不能硬拼 /docs/<folder> 做卡片链接（Next 路由
  * 里没这条，会 404）。所以往里走一层，找到第一个 page 文件的 url 拿来做兜底链接。比如：
  *
- *   CommunityShare/Language/         没 index.mdx
+ *   community/language/         没 index.mdx
  *     pte-intro.mdx                   用这篇的 url 做兜底
  *
- * 点击卡片会进到 /docs/CommunityShare/Language/pte-intro，不会 404。
+ * 点击卡片会进到 /docs/community/language/pte-intro，不会 404。
  */
 function findFirstPageUrl(
   nodes: PageTree.Node[],

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

@@ -195,7 +195,7 @@ export async function generateMetadata({ params }: Param): Promise<Metadata> {
     notFound();
   }
 
-  // 规范化 slug → canonical 路径。用户访问 /docs/ai/rl（原文）或 /docs/ai/rl.en（翻译版）
+  // 规范化 slug → canonical 路径。用户访问 /docs/learn/ai/rl（原文）或 /docs/learn/ai/rl.en（翻译版）
   // 都统一指向原始 slug，避免两个 URL 竞争同一份内容的 PageRank。
   const slugPath = (slug ?? []).join("/");
   const canonical = slugPath ? `/docs/${slugPath}` : "/docs";