📣 文档目录大重组通告（2026-04-18）— 按读者意图重设 IA，贡献保留 100%

[longsizhuo]

📣 文档目录大重组通告（2026-04-18）

本文是 PR #307 合并后向贡献者公告的草稿。一份文档，多个渠道并行发布。

---

🎯 一句话总结

Involution Hell 全站文档按"读者来这里想做什么"重新分成 4 大区：learn/（学）、career/（找工作）、community/（社区内容）、projects/（开源项目）。老 URL 全部 301 自动跳新位置，你过去写的文章不需要你做任何事。

---

💡 为什么重组

1. Admin 反馈：原目录 ai/ vs computer-science/ vs CommunityShare/ 混杂多轴，"MoE 到底算 AI 还是 CS？"这类问题每周被问
2. 新同学找不到：社区投稿的 AI 论文分享散落在 CommunityShare/Geek/ 和 CommunityShare/Amazing-AI-Tools/，AI 学习者看不到
3. Sidebar 条目爆炸 上百个同级条目，新用户迷失
4. 内容过时标识缺失：没有 status 字段区分"仍有效"vs"过期"

重组之后，一个新用户打开站点，从顶层 4 个入口就能判断要去哪：

• 我来学新东西 → learn/ai 或 learn/cs
• 我来找工作 → career/interview-prep（刷题/BQ/OA）或 career/events（活动）
• 我想看前辈经验 / 工具推荐 / 论文分享 / 留学生活 → community/*
• 我想看开源项目 → projects/

---

🗺️ 新目录结构（完整）

/docs/
├── learn/
│   ├── ai/                   AI 全栈主题（LLM / Agent / RL / 推荐 / 多模态 / 数学基础…）
│   └── cs/                   CS 基础（数据结构 / C++ 后端 / 系统编程 / 前端）
├── career/
│   ├── interview-prep/       刷题 + BQ + OA + VI 技巧
│   │   └── leetcode/         LeetCode 题解（50+ 篇社区投稿）
│   └── events/               Coffee Chat / Mock Interview / Career Journey
├── community/
│   ├── dev-tips/             开发技巧（Git、Cloudflare R2、自建图床、树莓派…）
│   ├── tools/                工具推荐（学生邮箱福利、Perplexity Comet、SwanLab…）
│   ├── papers/               论文导读（LeWorldModel、Prompt Repetition…）
│   ├── language/             英语学习
│   ├── life/                 留学生活 / 大学福利
│   └── mental-health/        心理健康 / 反内卷
└── projects/                 社区开源项目（AI 小镇 / 多模态 RL…）

---

📋 新贡献规则（以后投稿看这个）

决策树：我的文章该放哪？

我写的东西是……
├── 想教别人一个主题（系统教程、概念讲解、学习路径）
│   └→ learn/ai/ 或 learn/cs/（按学科）
│
├── 求职相关（面经、刷题、BQ、OA 技巧、投递经验）
│   ├── 刷题 + 面试技巧 → career/interview-prep/
│   └── 活动回顾 / Coffee Chat 记录 → career/events/
│
├── 社区分享（不是系统教程，是个人经验或推荐）
│   ├── 工具安利 / 软件介绍 → community/tools/
│   ├── 论文导读 / 某篇 arXiv 的个人理解 → community/papers/
│   ├── 开发技巧 / Hack / DIY → community/dev-tips/
│   ├── 英语学习 / PTE / 托福 → community/language/
│   ├── 留学生活 / 学生福利 → community/life/
│   └── 心理健康 / 反内卷 → community/mental-health/
│
└── 我做了一个开源项目，想放它的文档
    └→ projects/<project-name>/

边界 case

• "我写的 LeetCode 题解" → career/interview-prep/leetcode/（不放 learn/cs/——读者打开 LeetCode 目录的意图是"面试刷题"，不是"学算法理论"）
• "我写的 PPO 算法讲解" → learn/ai/reinforcement-learning/（系统主题教程）
• "我写的一篇 PPO 论文阅读笔记" → community/papers/（单篇论文的个人摘要）
• "一个 AI 工具评测" → community/tools/（不放 learn/ai/misc-tools/，现在的 misc-tools/ 只剩自研学习工具链 learning-toolkit）
• "一个完整的实战项目" → projects/<name>/

Frontmatter 约定（还在用，不变）

---
title: 你的标题
description: 一句话描述
date: "2026-04-18"
tags:
  - real-tag-1         # ✅ 有意义的标签，英文 kebab-case
  - real-tag-2         # ❌ 不要用 tag-one / tag-two 占位符
docId: xxxxx           # CI 自动生成，别手动改
---

---

🔒 老链接怎么办？

什么都不用做。所有 31 条老 URL → 新 URL 的 301 永久重定向 已经在 next.config.mjs 里写好。老外链、老收藏、老 Google 搜索结果都会自动跳到新位置。

举例：

• https://involutionhell.com/docs/CommunityShare/RAG/rag → 跳到 /docs/learn/ai/foundation-models/rag/rag ✅
• https://involutionhell.com/docs/jobs/interview-prep/bq → 跳到 /docs/career/interview-prep/bq ✅
• https://involutionhell.com/docs/CommunityShare/Leetcode/142.环形链表II → 跳到 /docs/career/interview-prep/leetcode/142.环形链表II ✅

🛡️ 贡献者署名会丢吗？

不会。sync-uuid workflow 按 docId（frontmatter 里的 cuid）追踪贡献者，不是文件路径。PR 里 145 个 docId 全部原样保留，合并后 CI 自动跑 backfill：

• 老贡献者 contributions 不变
• 仅 PR 作者因为这次 rename commit +1（这是 GitHub commit 的自然归属）
• generated/doc-contributors.json 里每个 docId 的 path 字段自动更新

---

🙏 感谢

感谢 21 位社区贡献者过去写下的所有文章。这次重组是为了让下一个访客更容易找到你们的作品，不是否定任何东西。

有疑问：

• GitHub Discussion：https://github.com/InvolutionHell/involutionhell/discussions
• Discord：https://discord.gg/6CGP73ZWbD
• PR 本身：refactor(docs): Option C IA 大重组 — learn/career/community/projects 四大区 #307

---

📮 如果 CONTRIBUTING.md 需要更新（建议）

新增一个 ## Where to put new docs 章节，内容直接从本文档的"新贡献规则"段复制过去。下一个贡献者提 PR 前会先看 CONTRIBUTING，不会再出现"放错目录"的情况。