kyber-survey

本仓库用于学习与撰写 ML-KEM（CRYSTALS-Kyber，NIST FIPS 203）的系统性综述，并记录我们的基础笔记、文献笔记、分析与工程复现。

我们要做什么

• 从基础到入门：补齐进入 Kyber/ML-KEM 所需的最小基础并沉淀笔记
• 写成一份综述：机制、标准、攻击面、安全性与参数、实现与部署注意事项
• 形成可复现记录：性能测试、脚本与工程实践笔记

仓库结构

• basics/：入门的基础知识点清单与笔记（进入 Kyber/ML-KEM 前置）
• notes/：读标准/论文的笔记、摘录、心得与术语沉淀
• analysis/：我们的分析整理（安全性分析、参数对比、标准差异、关键结论）
• engineering/：工程实践（脚本、性能测试、实现记录、实验输出）

快速入口

• 基础清单与笔记：basics/README.md
• 阅读笔记入口：notes/README.md
• 分析入口：analysis/README.md
• 工程入口：engineering/README.md

里程碑

• M-1 从基础到入门(复习整理)：完成 basics/ 中的前置知识点清单与对应笔记沉淀
• M0 标准与规格：读 FIPS 203 + Kyber v3.02，输出接口与流程；整理差异点
• M1 机制讲清楚：写出“能让读者看懂”的算法叙述（含流程图/伪代码）
• M2 安全性与参数：攻击面分类；整理参数安全估计的来源、结论与局限
• M3 实现与工程：参考实现/优化实现；性能数据；实现注意事项
• M4 侧信道/故障：代表性攻击与缓解策略，落到工程实现建议
• M5 定稿：整合、统一术语与引用、形成最终综述（Markdown）

分工

• Rene：覆盖所有模块并做最终整合/复核；负责深挖（安全性/参数/实现/侧信道）
• WZR：负责阶段性整理与协助

必读材料

• FIPS 203（ML-KEM）：标准定义与实现要求（接口/流程/注意事项）
• Kyber v3.02 规格书：Kyber 设计与解释
• pq-crystals/kyber：官方参考实现（代码结构、测试、实现细节）
• pq-crystals/security-estimates：参数安全估计脚本与说明

协作

• 小改动可以直接提交到 main
• 队友的阶段性成果建议：单独分支 → PR