PPysolate SpineREAD THE CODE · UNDERSTAND THE SYSTEM
课程与章节
源码索引 / CURRENT IMPLEMENTATION

site/src/pages/index.astro

18 行 · 点击行号可定位;函数链接随声明位置更新,不手填行号。

---
import Layout from '../layouts/Docs.astro';
import coverage from '../../.generated/reading-coverage.json';
const paths = [
  {href:'/read-entry/', title:'先跟完一次普通执行', description:'从 main 的参数出发,走过 Go、Wasm、C、Python 和 Host 工具。'},
  {href:'/read-futures/', title:'再读 PLM 与 Future', description:'跟随一次提前读取,看任务怎样登记、完成并在原位置交付。'},
  {href:'/read-prefix-host/', title:'接入流式源码', description:'看接收、解析、提前准备与最终领取怎样协作。'},
  {href:'/read-prepared/', title:'最后读内存复用', description:'先 full-copy,再跟进 Linux COW 的系统调用与所有权。'},
];
---
<Layout title="沿真实代码学习">
  <section class="hero"><div class="eyebrow">FOLLOW THE EXECUTION</div><h1>跟完一次执行,<br/>读懂<em>整块代码。</em></h1><p class="lede">先看这一步为什么存在、接到什么状态。<br/>再沿函数调用理解源码,跟清结果与资源交给谁。</p><div class="actions"><a class="button" href="/read/">先看执行地图 →</a><a class="button secondary" href="/read-entry/">从 main 开始带读</a></div></section>
  <section><div class="section-heading"><span class="eyebrow">先走主线,再展开旁支</span><h2>一次调用,逐层读懂</h2></div><div class="cards">{paths.map((p,i)=><a class="card" href={p.href}><span class="card-number">{String(i+1).padStart(2,'0')}</span><h3>{p.title}</h3><p>{p.description}</p><span class="arrow">↗</span></a>)}</div></section>
  <section class="command-card"><div><span class="eyebrow">先预测,再运行</span><h2>每一层都接回实际结果</h2></div><pre><code>make demo     <span># 普通执行</span>
make explain  <span># 实际 PLM 转换</span>
make prepared-cow <span># Linux 写时复制</span></code></pre></section>
  <div class="notice"><strong>按职责分块,保留完整覆盖。</strong>带读片段从仓库提取,覆盖 {coverage.length} 个教学源文件的全部非空行。每块都接回目的、状态变化与调用去向;覆盖检查负责防漏,讲解仍需结合源码审读。<a href="/foundations/">背景课程</a>和 Go 语法可以随用随查。</div>
</Layout>