🔎 可视化浏览器：index.html —— 19 篇可<b>搜索 / 按层筛选</b>的卡片总览 + 4 条阅读路径 + 5 个证据节点 + 三角闭环。 📄 全文 HTML：html/ —— 每篇 md <b>全量渲染</b>成独立页面（侧栏目录 + 上/下一篇导航），由 build_html.py 确定性生成，改 md 重跑即可。均无外部依赖、离线可用。

与 docs/（学习方案 + 归档结论）、code/（已建并验证的实现）并列。 这里是底层知识 + Q&A + 反馈 + 更正的系统记录区。 docs 回答"我们做了什么、证明了什么"；notes 回答"为什么是这样、底层原理是什么"。

0. 这个知识库怎么用

  • 每个主题一个编号文件：NN-主题.md，按学习顺序编号。
  • 自底向上：从密码学原语 → 区块链 → 以太坊 → DeFi → MEV → 跨链。
  • 锚定已有实践：本项目已经在 Phase 1/4/5/6 实际跑过套利/闪电贷/清算/mempool/跨链。 每篇笔记会标注「与本项目实践的对应」——你不是从零学，是补已做之事的底层 why。
  • 类比优先：用"银行 / 账本 / 支付系统"的类比讲（沿用你熟悉的心智模型）， 再上精确定义。先懂直觉，再懂细节。
  • evidence-first 基因继承：连分析者自己的错误都被实证抓出并记录修正 （见 docs 2026-05-19 自我更正）。本知识库每篇都有 Q&A / 更正记录区， 讨论、质疑、反馈、纠错都按日期追加进去，永不抹掉错误轨迹。

0.5 读者导览（4 条路径任选其一）

KB 全景：19 篇 / 5 层 / 1 条核心方法论（evidence-first）。每篇约 4-8k 字、20-40 分钟读完 + 答 §9 自检题。 4 条建议路径——按你的目的选：

🛤️ 路径 A：完整顺序（强烈推荐，4–6 周）

  • 谁适合：从零开始系统学的人；想真正"知道"而不是"听过"的人
  • 怎么走：01 → 02 → … → 19，每篇答完 §9 自检再进下一篇
  • 总投入：~10 小时阅读 + ~10 小时自检 + ~20 小时跑 code/ 实证
  • 产出：能独立判断 90% 的"加密圈传闻"

⚡ 路径 B：MEV 速通（1–2 周，适合已懂区块链基础）

  • 跳过：01-05（基础）、12（预言机）、17（跨链）
  • 必读：06 账户 → 07 EVM/Gas → 09 ERC-20 → 10 AMM → 13 闪电贷 → 14 mempool/PBS → 15 MEV 策略 → 16 Flashbots → 18 核查 → 19 evidence-first
  • 重点：14 §6 demo-backrun + 16 §6 demo-flashbots structured error 这两段务必看完
  • 产出：能读懂 jaredfromsubway / Flashbots 一类 searcher 在干什么

💰 路径 C：DeFi 速通（1 周，适合只想搞懂 Uni/Aave 怎么转的人）

  • 必读：09 ERC-20 → 10 DEX/AMM → 11 借贷 → 12 预言机 → 13 闪电贷
  • 跳过：14-17（MEV/跨链）；方法论 18-19 仍推荐看
  • 重点：09 §6 approve/transferFrom 字节级 + 10 §6 AMM 数学 + 11 §6 清算 5 步
  • 产出：能看懂任何 DeFi 协议的工作原理

🧭 路径 D：方法论速通（半天，适合只想拿走"怎么判断"的人）

  • 只读：18 链上核查 + 19 evidence-first + docs/学习路径方案.md 2026-05-19 自我更正
  • 跳过：所有技术篇
  • 产出：以后任何"听某地址在做 X 套利"的传闻，你 5 分钟核查能淘汰 90%

💎 整套 KB 最重要的 5 个证据节点（不论走哪条路径都该亲自核验）

  1. docs/学习路径方案.md 2026-05-19 自我更正 —— 整个项目最珍贵的史料（19 §6 完整复盘）
  2. 12/12 fork tests wei-exact —— 跑 code/phase4-onchain-basics/foundry/ && forge test
  3. demo-backrun P1 = P2 字节级一致 —— 14 §6 + 跑 code/phase4-onchain-basics/watcher/ && pnpm demo:backrun
  4. demo-flashbots structured error —— 16 §6 / 1050000000000000 wei = 0.00105 ETH
  5. 0x65A8 vs 0x6bdc 对照核查 —— 18 §6（5 分钟你自己 etherscan 跑一遍）

📚 怎么使用 Q&A / 更正区

  • 读笔记发现错 / 觉得有疑 → 直接在那篇 Q&A 区按日期追加（按 README.md §0 nuemric format）
  • 不要直接改正文删错误——保留更正轨迹是本 KB 核心纪律（19 §0）
  • 哪怕是"小白朴素疑问"也欢迎追加——docs 2026-05-19 那次自我更正就是用户朴素疑问触发的

1. 每篇笔记的固定结构（写作规范） 

0. 一句话本质
1. 怎么产生的 / 解决什么问题（问题驱动，不是定义驱动）
2. 它本质在做一件什么事
3. 类比（银行/账本/支付系统视角）
4. 核心关键点（编号列出）
5. 必须先知道的前置名词（带类比的小词典）
6. 一个完整过程走一遍（端到端，用类比叙述）
7. 常见误区
8. 与本项目实践的对应（链接到 code/ 或 docs/）
9. 自检问题（答得出才算过）
── Q&A / 更正记录区（按日期追加，含质疑与纠错）──

2. 学习流程（大纲 + 进度）

# 主题 状态 对应本项目实践
第一层：基础（What & Why）
01 区块链是什么 / 怎么产生 / 在做什么 / 核心关键点 / 前置知识 ✅ 本次 全局背景
02 密码学三原语：哈希 / 公私钥 / 数字签名 ✅ 本次 地址、签名、所有权的根基
03 区块、链式结构、Merkle 树、不可篡改怎么来的 ✅ 本次 "为什么改不了" + forge fork 可信性
04 共识机制：PoW / PoS、为什么需要共识、出块 ✅ 本次 出块者、排序权（MEV 的根）+ PBS
05 节点 / 网络 / 去中心化的真实含义与代价 ✅ 本次 为什么自建节点是壁垒（含月成本账单 + L0–L4 阶梯）
第二层：以太坊与智能合约
06 账户模型：EOA vs 合约账户、nonce、状态 ✅ 本次 0x6bdc/0x65A8 实证 + dealUsdc 槽位 + 部署地址确定性
07 EVM / Gas / 交易生命周期 ✅ 本次 Phase 4 gas 分析（487k arb / 897k 清算 / 271k revert）+ via_ir 之根 + EIP-1559 双价制
08 智能合约：部署、调用、Revert、回调 ✅ 本次 4 份合约的 EVM 层剖面：selector / ABI / interface / CALL/STATICCALL/DELEGATECALL / LOG / REVERT
09 ERC-20 / approve 机制 / USDC、WETH 的特殊性 ✅ 本次 token 在 mapping 的一行 + approve/transferFrom 三件套 + decimals 陷阱 + SafeERC20 之根
第三层：DeFi
10 DEX 与 AMM：恒定乘积 x·y=k、滑点、wei-exact 之根 ✅ 本次 V2 getAmountOut 整数公式 + 套利对称性 + Sushi 是 V2 fork + pair 地址链下可算
11 借贷协议：Aave、健康因子、清算 ✅ 本次 4 个魔法数字 + HF 公式 + 清算 5 步原子流程 + 897k gas 归因
12 预言机：链下世界往链上送数据的唯一桥 ✅ 本次 push/pull/TWAP 三模式 + AaveOracle mock 原理 + Mango/Bonq/Cream 攻击案例
13 闪电贷：原子性 = 终极抵押品 ✅ 本次 6 步流程 + 5bps 算法 + 三种用法对照 4 份合约 + 攻击案例非闪电贷之过
第四层：MEV 与跨链
14 mempool / 区块构建 / PBS：未来 12 秒 ✅ 本次 tx 7 阶段生命周期 + builder/relay/proposer 拍卖经济 + demo-backrun wei-exact 之根
15 MEV：套利 / 清算 / 三明治 / backrun / JIT ✅ 本次 五大类策略目录 + $1.5B 累计数据 + 残差=footprint 的精确数学 + 我们刻意不做三明治的三层理由
16 Flashbots / bundle / 私有 orderflow ✅ 本次 bundle 4 铁性质 + eth_sendBundle API + structured error 11 阶段拆解 + block.coinbase.transfer 之根
17 跨链：消息层 / 桥 / LayerZero / OFT / 失去原子性的代价 ✅ 本次 4 大桥家族信任假设 + LayerZero DVN/OFT/Stargate + $3B 桥被黑史 + 0x65A8 vs 0x6bdc 实证 + 跨链篇 docs 自我更正归位
第五层：方法论（本项目独有）
18 链上核查方法论：5 分钟死/活、资金路径分析 ✅ 本次 5 步 checklist + 5 普适维度 + "地址是结果不是策略" 原则 + 0x6bdc / 0x65A8 双案 + 工作流复用模板
19 evidence-first：测而非断言、自我更正纪律 ✅ 本次 四级可信度 + 五纪律 + 七反模式 + docs 2026-05-19 自我更正全过程 + 整套 KB 19 篇骨架收官

进度随学习推进更新本表。一篇没通过自检（第 9 节）不进下一篇。

3. 索引

4. 与其他目录的关系 

notes/   ← 你在这里：系统化底层知识 + Q&A + 更正
  │  深化 / 解释
  ▼
code/    ← 已建并验证的实现（套利/闪电贷/清算/mempool/Flashbots/跨链）
  │  实证支撑
  ▼
docs/学习路径方案.md  ← 方案 + 7 阶段归档 + 诚实结论链 + 自我更正记录

三者互相引用。学到 notes 某主题时，去 code 看我们实际怎么用的； 对结论有疑问时，去 docs 看实证数据。知识、实现、结论三角闭环。