如何贡献题目

题目模板、目录约定与本地预览方式。

目录约定

内容全部在 src/content/docs 下,目录层级 = 导航层级:

src/content/docs/
├── llm/                 # 一级分类:大模型
│   ├── basics/          # 二级方向:基础原理
│   │   ├── transformer.mdx
│   │   ├── attention.mdx
│   │   └── kv-cache.mdx
│   ├── prompt/
│   ├── rag/
│   ├── finetune/
│   ├── agent/
│   ├── inference/
│   └── eval/
├── lang/                # 编程语言
├── cs/                  # 计算机基础
├── eng/                 # 工程与系统
├── career/              # 面试实战
├── about.mdx            # 关于本站
└── contributing.mdx     # 本页

新增一个专题页,要做两件事:

  1. 在对应目录新建 .mdx 文件(文件路径就是 URL,例如 llm/basics/attention.mdx → /llm/basics/attention/)。
  2. 在 src/lib/nav.ts 的对应分类下,把 slug 加进 groups[].slugs——导航顺序就是这个数组的顺序。

页面模板

---
title: 专题标题
description: 一句话说明这个专题覆盖什么,20-40 字。
---

一两句导语,说明面试里怎么考这一块。

<QA n="Q1" q="问题本身?" level="高频" tags={['关键词', '另一个']}>

**一句话回答:** 先给结论,控制在两行内。

**展开:**

- 第一层:机制或原理
- 第二层:工程上的取舍
- 第三层:能给出数字、参数或线上经验

**追问:** 面试官最可能接着问的一句,以及一句回答要点。

</QA>
  • n 是题号(Q1、Q2……),同时作为锚点 id(#q-Q1)出现在右侧题目导航里,同一页内不要重复。
  • level 只能是 基础 / 进阶 / 高频 / 专家。
  • tags 用来做搜索关键词,一般 2–3 个。
  • 不需要 import:QA 已经在页面渲染时全局注入。

写作规范

  • 每题只问一件事。复合问题拆成两题。
  • 先结论后展开。面试时先说一句结论,面试官有兴趣再往下讲。
  • 给数字。复杂度、显存、延迟、参数量,能算就写出算式。
  • 写清取舍。没有银弹,答案里要体现「什么情况下不这么做」。
  • 正文里避免裸的 <、>、{,需要时用文字描述或放进反引号里。

图片

放法很简单:把文件丢进 public/images/,正文里用绝对路径引用,不需要 import。

<figure>
  <img
    src="/images/rag-pipeline.svg"
    alt="RAG 全链路:解析、切分、嵌入、检索、重排、生成"
    width="960"
    height="520"
  />
  <figcaption>切分和上下文组装是最容易被忽略的两步</figcaption>
</figure>

约定:

  • 示意图用 SVG,照片和截图用 PNG / JPG;文件名用英文短横线,全站不重名。
  • 正文图片会自动铺满阅读列,点击可放大(Esc 或再点一次关闭)。
  • alt 必填,写清图在讲什么——读屏软件和 SEO 都要用。
  • width / height 按图片真实比例填,避免加载时页面跳动。
  • SVG 里的文字不小于 13px,配色沿用品牌色(朱砂 #b8322b、藏青 #2c3e6b、驼 #c39a6b),这样和正文放在一起不违和。

代码

代码块就是常见的三反引号加语言名,会自动上色,左上角标语言、右上角带「复制」按钮:

# 列表:一次性算完,100 万个整数约占 36MB
squares = [i * i for i in range(1_000_000)]

# 生成器:按需计算,常驻内存只有一个元素
squares = (i * i for i in range(1_000_000))

约定:

  • 语言标记必填(python、java、javascript、bash、json、text),它决定高亮规则、左上角标签和复制按钮的显隐。
  • 片段控制在 15 行以内;更长的代码建议单独开一节讲,而不是塞进某个答案里。
  • 行内代码用单反引号,只放术语、函数名、参数,不要整句用行内代码。
  • 深浅色主题各有一套高亮配色,写题时不用手工指定颜色。

本地预览

pnpm install
pnpm dev      # http://localhost:4321
pnpm build    # 产出 dist/,纯静态