本索引定位135个基础知识点。新的论文与工程变化另见2026研究进展,查出处与本地保存记录可进入来源资料库。
v1.0包含45个主题、135个知识点。选择一个问题,先推导,再运行教学示例,最后沿固定版本链接阅读源码。每行对应一份可独立复习的学习单元。
正文、代码、证据由机器可读知识点清单关联;完整模型与设备实践状态见各主题。
模型网络
| 主题与知识点 | 核心函数 | 教学代码 |
|---|---|---|
| Transformer与自回归生成 · 知识点一:缩放、可见范围与稳定的因果注意力 | causal_attention | Python |
| Transformer与自回归生成 · 知识点二:多头的索引变换与输出投影 | split_merge_heads | Python |
| Transformer与自回归生成 · 知识点三:训练并行、生成依赖与采样分布 | generate_tokens | Python |
| MHA与MQA及GQA · 知识点一:共享键值并不共享查询分布 | grouped_attention | Python |
| MHA与MQA及GQA · 知识点二:从持久缓存推导字节数与计算边界 | kv_budget | Python |
| MHA与MQA及GQA · 知识点三:均值合并只是转换初始化 | mean_pool_heads | Python |
| 位置编码与RoPE · 知识点一:从二维旋转推导相对位置 | relative_rotation | Python |
| 位置编码与RoPE · 知识点二:多频率与两种维度配对布局 | rope_layout | Python |
| 位置编码与RoPE · 知识点三:线性缩放与缓存位置的一致性 | cached_rope_scores | Python |
| 前馈网络与归一化 · 知识点一:SwiGLU 的门控计算与等参数宽度 | swiglu | Python |
| 前馈网络与归一化 · 知识点二:RMSNorm 保持尺度而不去均值 | norm_statistics | Python |
| 前馈网络与归一化 · 知识点三:归一化位置改变残差雅可比 | residual_paths | Python |
训练
| 主题与知识点 | 核心函数 | 教学代码 |
|---|---|---|
| 预训练目标与数据 · 知识点一:标签只能错位一次,mask属于目标位置 | shift_targets | Python |
| 预训练目标与数据 · 知识点二:有效token分母决定梯度权重 | token_loss | Python |
| 预训练目标与数据 · 知识点三:文档切分、重复候选与token打包 | audit_split | Python |
| 监督微调与LoRA · 知识点一:对话模板、mask交集与目标错位 | build_sft_labels | Python |
| 监督微调与LoRA · 知识点二:低秩参数、缩放与零初始化梯度 | lora_gradients | Python |
| 监督微调与LoRA · 知识点三:合并等价成立的精确条件 | lora_merge_equivalence | Python |
| 偏好学习与DPO · 知识点一:KL最优策略与配分函数抵消 | optimal_policy | Python |
| 偏好学习与DPO · 知识点二:相对margin、稳定损失与梯度符号 | dpo_loss | Python |
| 偏好学习与DPO · 知识点三:序列log概率、回复mask与长度偏差 | completion_logratio | Python |
| 策略优化与GRPO · 知识点一:组内基线、标准差约定与无区分信号 | group_advantages | Python |
| 策略优化与GRPO · 知识点二:概率比裁剪的方向与冻结旧策略 | clipped_surrogate | Python |
| 策略优化与GRPO · 知识点三:KL估计的期望条件与不等长归约 | grpo_loss_terms | Python |
推理
| 主题与知识点 | 核心函数 | 教学代码 |
|---|---|---|
| Prefill与Decode · 知识点一:首 token、逐 token 与请求计时边界 | request_metrics | Python |
| Prefill与Decode · 知识点二:缓存改变了每步要计算哪些位置 | attention_work | Python |
| Prefill与Decode · 知识点三:分块 Prefill 是受预算约束的状态推进 | schedule_tokens | Python |
| KV缓存原理与显存估算 · 知识点一:有效状态、padding与物理分页的三本账 | kv_layout | Python |
| KV缓存原理与显存估算 · 知识点二:追加KV之后仍然要读取历史 | cached_attention | Python |
| KV缓存原理与显存估算 · 知识点三:块哈希必须包含历史和计算身份 | prefix_block_hashes | Python |
| 缓存分页与连续批处理 · 知识点一:块表将逻辑连续性与物理连续性解耦 | page_address | Python |
| 缓存分页与连续批处理 · 知识点二:连续批处理同时守住token和块预算 | continuous_step | Python |
| 缓存分页与连续批处理 · 知识点三:基数树分叉与锁定叶子的淘汰条件 | radix_split | Python |
| 推理框架与性能实验 · 知识点一:到达率与突发度是两个独立负载参数 | arrival_schedule | Python |
| 推理框架与性能实验 · 知识点二:联合达标吞吐与SLO容量不是同一个量 | qualified_metrics | Python |
| 推理框架与性能实验 · 知识点三:分位数、缺失值和受截断样本 | latency_summary | Python |
Harness
知识库
| 主题与知识点 | 核心函数 | 教学代码 |
|---|---|---|
| RAG与引用回答 · 知识点一:检索文档是潜变量,求和与求积不能交换 | rag_marginals | Python |
| RAG与引用回答 · 知识点二:召回集合不等于实际进入上下文的证据 | select_context | Python |
| RAG与引用回答 · 知识点三:引用格式有效不等于声明得到支持 | audit_citations | Python |
| 来源接入与版本管理 · 知识点一:来源身份、正文指纹和解析身份分开保存 | source_fingerprint | Python |
| 来源接入与版本管理 · 知识点二:增量接入必须区分新增、更正、删除与不可读 | classify_versions | Python |
| 来源接入与版本管理 · 知识点三:删除原文前先修复共享派生知识 | reconcile_support | Python |
| 混合检索与重排 · 知识点一:BM25如何同时控制稀有词、词频饱和与长度 | bm25_scores | Python |
| 混合检索与重排 · 知识点二:RRF融合的是名次,工程加分会改变结论 | reciprocal_rank_fusion | Python |
| 混合检索与重排 · 知识点三:重排只在候选内工作,必须记录漏斗与回退 | rerank_audit | Python |
| GraphRAG与LLMWiki · 知识点一:实体入口、邻接关系与原始片段排序 | local_graph_context | Python |
| GraphRAG与LLMWiki · 知识点二:社区摘要与全局map-reduce的预算路径 | reduce_points | Python |
| GraphRAG与LLMWiki · 知识点三:Wiki反向链接与类型化知识影响闭包 | wiki_impact | Python |