refactor(docs): Option C IA 大重组 — learn/career/community/projects 四大区

[longsizhuo]

背景

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

新 IA

/docs/
├── learn/                  （系统学习）
│   ├── ai/                   AI 全栈主题（原 ai/）
│   └── cs/                   CS 基础 + 系统（原 computer-science/）
├── career/                 （求职）
│   ├── interview-prep/       刷题 BQ OA VI（原 jobs/interview-prep/ + CommunityShare/Leetcode/）
│   └── events/               Coffee Chat / Mock Interview（原 jobs/event-keynote/）
├── community/              （社区内容）
│   ├── dev-tips/             开发技巧（原 CommunityShare/Geek/）
│   ├── tools/                工具推荐（Amazing-AI-Tools + perplexity-comet + swanlab）
│   ├── papers/               论文摘要（leworldmodel + prompt-repetition）
│   ├── language/             语言学习（原 CommunityShare/Language/）
│   ├── life/                 留学生活
│   └── mental-health/
├── projects/               （开源项目）
│   ├── ai-town.mdx
│   └── multimodal-rl.mdx
└── （archive/ 预留，等 owner 标记过期内容）

变更规模

类别	数量
git mv 文件	~280 份（全站大搬家，绝大多数含 .en 翻译）
新 index.mdx	3 份（learn / career / projects）
docId 守恒	全部 ~145 个 docId 原样保留
301 redirects	31 条 全 statusCode: 301
Hard-coded URL 修正	Hero / Footer / layout / source.ts / SectionIndex 等
data/event.json	3 条 playback URL 更新到新路径

Reviewer subagent 审后修正（全部采纳）

级别	问题	修正
P0	Footer /docs/career 404	新建 career/index.mdx
P0	data/event.json playback 旧路径	sed 批量替换
P0	coffee-chat.md 内链用 vercel.app 子域 + 旧路径	统一 involutionhell.com + 新路径
P1	learn/、projects/ 无 index	分别补 index.mdx
P1	/docs/all-projects 裸路径无 redirect	补规则
P2	SectionIndex / page.tsx / umami_tracking 注释旧术语	一齐刷新

与 sync-uuid 的协调

sync-uuid.yml 只在 main / feat/contributor 触发，feature 分支零风险（DB 不动）。merge 后 CI 自动跑 backfill：

• 老贡献者 contributions 不变（老 commits 都在 lastContributedAt 之前，增量累加跳过）
• owner 本轮 rename commit 在每个 docId 上 +1
• generated/doc-contributors.json 里每个 docId 的 path 字段更新到新位置

合并前 contributors baseline 存在 /tmp/contributors-baseline-before-merges.txt

合并后我会 watch sync-uuid workflow 跑完，逐 docId 对照 baseline 生成完工报告。

Commit 梳理

1. df8df19 Phase 1：RAG + ai-town 初版迁移
2. 7977987 redirects 从 308 改 301
3. 0c7c981 Phase 2：leworldmodel / perplexity-comet / prompt-repetition / ppo
4. 878afb1 tag-one 占位符清理 54 文件 (cherry-pick from closed chore(docs): 清理 tag-one 占位符 → 真实内容标签（54 文件） #308)
5. 00477dc ppo revert (cherry-pick from closed chore(docs): 清理 tag-one 占位符 → 真实内容标签（54 文件） #308)
6. dd7bf83 cpp_backend kebab-case (cherry-pick from closed refactor(docs): cpp_backend 目录树规范化 — 下划线/大驼峰 → kebab-case #309)
7. 5cd9d2e Option C IA 大重组（本轮）

遗留（另开 PR）

• Leetcode 50+ 题解文件名规范化（走 pinyin 路由）
• frontmatter status 字段（active/deprecated/archived）机制
• archive/ 治理——等 owner/admin 标具体哪些过期

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
involutionhell-github-io	Ready	Preview, Comment	Apr 18, 2026 4:42pm
website-preview	Ready	Preview, Comment	Apr 18, 2026 4:42pm

[Copilot]

Pull request overview

This PR reorganizes documentation paths to better reflect IA/semantics (RAG docs under AI foundation models; AI Town under AI projects), updates a handful of docs’ placeholder tags to meaningful semantic tags, and adds Next.js permanent redirects to preserve SEO and existing inbound links.

Changes:

• Move/rename docs into new canonical locations under app/docs/ai/... (including a snake_case → kebab-case filename normalization).
• Replace placeholder tags with content-accurate semantic tags for the affected documents.
• Add next.config.mjs permanent redirects from old doc URLs to the new canonical routes.

Reviewed changes

Copilot reviewed 7 out of 9 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
next.config.mjs	Adds permanent redirects for the moved docs to protect SEO/backlinks.
app/docs/ai/projects/ai-town.mdx	Replaces the old placeholder/project tag with more specific project tags.
app/docs/ai/projects/ai-town.en.mdx	Same tag update as the zh version for consistency.
app/docs/ai/foundation-models/rag/rag.mdx	Replaces placeholder tag with RAG-specific semantic tags.
app/docs/ai/foundation-models/rag/rag.en.mdx	Same tag update as the zh version for consistency.
app/docs/ai/foundation-models/rag/embedding.mdx	Adds/relocates embedding fine-tuning doc (needs tag alignment + minor typo fix).
app/docs/ai/foundation-models/rag/embedding.en.mdx	Adds/relocates English translation (needs tag alignment).
app/docs/ai/foundation-models/rag/context-engineering-intro.md	Replaces placeholder tag with context/prompt/LLM fundamentals tags.
app/docs/ai/foundation-models/rag/context-engineering-intro.en.md	Same tag update as the zh version for consistency.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

这里注释写的是“301 重定向”，但这些规则都设置了 permanent: true，Next.js 会返回 308 而不是 301。建议把措辞统一成“permanent redirect（308）”或“永久重定向”，避免读者误以为是 301。

Suggested change

	* 文档目录重组产生的老 URL → 新 canonical URL 的 301 重定向。
	*
	* 为什么需要：站点上线一段时间后，原路径被 Google 索引 + 被用户收藏 / 外链引用。
	* 目录重组（比如把 CommunityShare/RAG/* 搬到 ai/foundation-models/rag/*）
	* 必然改 URL；不加 301 的话老链接一律 404，SEO 权重流失 + 用户体验断裂。
	*
	* permanent=true 下发 308（Next.js 特性：permanent 对应 308，保留原 method；
	* 普通文件重定向 308 和 301 对爬虫基本等价），浏览器 / 爬虫会缓存跳转关系，
	* 文档目录重组产生的老 URL → 新 canonical URL 的永久重定向（308）。
	*
	* 为什么需要：站点上线一段时间后，原路径被 Google 索引 + 被用户收藏 / 外链引用。
	* 目录重组（比如把 CommunityShare/RAG/* 搬到 ai/foundation-models/rag/*）
	* 必然改 URL；不加永久重定向的话老链接一律 404，SEO 权重流失 + 用户体验断裂。
	*
	* permanent=true 下发 308（Next.js 特性：permanent 对应 308，保留原 method；
	* 普通文件重定向里 308 和 301 对爬虫基本等价），浏览器 / 爬虫会缓存跳转关系，

[Copilot]

当前 redirects 只覆盖了无语言后缀的旧路径（例如 /docs/CommunityShare/RAG/rag），但这些文档同时存在 .en 版本（例如旧路径很可能还会被访问到 /docs/CommunityShare/RAG/rag.en、/embedding.en、/context_engineering_intro.en、/all-projects/ai-town.en）。建议补齐对应的 .en 重定向规则，避免英文旧链接直接 404。

Suggested change

	{
	source: "/docs/CommunityShare/RAG/embedding",
	destination: "/docs/ai/foundation-models/rag/embedding",
	permanent: true,
	},
	{
	// 文件名也规范化成 kebab-case：context_engineering_intro → context-engineering-intro
	source: "/docs/CommunityShare/RAG/context_engineering_intro",
	destination: "/docs/ai/foundation-models/rag/context-engineering-intro",
	permanent: true,
	},
	{
	source: "/docs/all-projects/ai-town",
	destination: "/docs/ai/projects/ai-town",
	permanent: true,
	},
	{
	source: "/docs/CommunityShare/RAG/rag.en",
	destination: "/docs/ai/foundation-models/rag/rag",
	permanent: true,
	},
	{
	source: "/docs/CommunityShare/RAG/embedding",
	destination: "/docs/ai/foundation-models/rag/embedding",
	permanent: true,
	},
	{
	source: "/docs/CommunityShare/RAG/embedding.en",
	destination: "/docs/ai/foundation-models/rag/embedding",
	permanent: true,
	},
	{
	// 文件名也规范化成 kebab-case：context_engineering_intro → context-engineering-intro
	source: "/docs/CommunityShare/RAG/context_engineering_intro",
	destination: "/docs/ai/foundation-models/rag/context-engineering-intro",
	permanent: true,
	},
	{
	source: "/docs/CommunityShare/RAG/context_engineering_intro.en",
	destination: "/docs/ai/foundation-models/rag/context-engineering-intro",
	permanent: true,
	},
	{
	source: "/docs/all-projects/ai-town",
	destination: "/docs/ai/projects/ai-town",
	permanent: true,
	},
	{
	source: "/docs/all-projects/ai-town.en",
	destination: "/docs/ai/projects/ai-town",
	permanent: true,
	},

[longsizhuo]

📢 Phase 2 更新 (commit 0c7c981)

根据 owner 反馈 "CommunityShare 内部结构进一步主题细分"，在本 PR 基础上追加 4 个 docId 的迁移——继续把 CommunityShare 下的纯 AI 内容归并到 ai/ 主题目录。

追加的 4 份文档迁移

docId	源路径	目标路径
boo70qqm8n...	CommunityShare/Geek/leworldmodel	ai/foundation-models/world-models/leworldmodel
eej2awin6i...	CommunityShare/Amazing-AI-Tools/perplexity-comet	ai/misc-tools/perplexity-comet
l6eepr5ctj...	CommunityShare/Amazing-AI-Tools/prompt-repetition-improves-non-reasoning-llms	ai/foundation-models/prompt-engineering/prompt-repetition-improves-non-reasoning-llms
zf8zk108oq...	CommunityShare/Personal-Study-Notes/Reinforcement-Learning/ppo	ai/reinforcement-learning/ppo

新增 3 个 ai/ 子目录：world-models/ / prompt-engineering/ / reinforcement-learning/

顺手的 tag 修正

• ppo.md 原 tag-one 占位符 → [reinforcement-learning, ppo, policy-gradient, gae]（和 PR chore(docs): 清理 tag-one 占位符 → 真实内容标签（54 文件） #308 的选择完全一致）
• leworldmodel.md + .zh.md 原中文 世界模型 → 英文 kebab-case [world-models, jepa, representation-learning, embodied-ai]

累计变化

• 12 份文件 git mv（7 份原文 + 5 份 .en/.zh 翻译）
• 8 条 301 redirects（原 4 + 新 4）
• 3 个新 ai/ 子目录
• 清理空目录 CommunityShare/Personal-Study-Notes/

与 PR #308 的协调

本 PR 已对 ppo.md 做了和 PR #308 完全相同的 tag 更新。为避免 rebase 冲突，已在 PR #308 分支 commit fa2fdce 里主动 revert ppo 部分（由本 PR 独占）。merge 顺序无所谓，两 PR 现在完全独立。

docId 守恒（7 个文件，4 个 docId 全对齐）

• leworldmodel（原文 + .zh.md）：boo70qqm8nos8b0q9h7zjrki
• perplexity-comet（原文 + .en.md）：eej2awin6irhbdgcy8vvs3xb
• prompt-repetition（原文 + .zh.md）：l6eepr5ctjgrhdgupy3twr1t
• ppo（单文件，无翻译）：zf8zk108oqbsg56xjyqb5txk

Reviewer subagent 已审，LGTM。