如何贡献题目
题目模板、目录约定与本地预览方式。
目录约定
内容全部在 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 # 本页
新增一个专题页,要做两件事:
- 在对应目录新建
.mdx文件(文件路径就是 URL,例如llm/basics/attention.mdx→/llm/basics/attention/)。 - 在
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/,纯静态