跳转至

怎样从文章结论核回锁定源码

返回学习入口

每条源码课程都会链接到锁定 Commit 的 GitHub 文件，因此不同读者看到的是同一版代码和同一段行号。不过，链接只能锁住版本，机器也只能检查仓库、Commit 和路径是否存在，判断不了文章有没有把代码讲对。这一步不能交给机器。你复核时还得沿着调用链亲自回答下面五个问题。

源码站点五问

  1. 谁调用这段函数，它在真实产品路径上吗？
  2. 输入来自模型、配置、用户还是已验证的内部对象？
  3. 它修改了 Session、工具、文件还是仅修改局部投影？
  4. 返回值代表调用完成、步骤完成还是任务完成？
  5. 下一站在哪里，错误、取消和清理走哪条分支？

文章里的每个「第 N 站」都会回答这五项，你可以据此检查正文有没有说得太满，超出源码实际能够支持的范围。

三类材料不要混用

材料 能支持 不能单独支持
Runtime 源码 该提交的实现和类型边界 运行时一定触发了这条路径
上游测试/Fixture 构造场景下的可执行行为 未覆盖平台、真实 Provider 和长期负载
官方公开文档/协议 对外承诺与用法 闭源内部如何实现

这三类材料不能混用。在这里，公开 Agent SDK 源码只能帮你核对 Transport（传输层）、Messages、Permissions 和 Hooks（钩子集合）等公开契约，不能拿来还原 Claude Code 内部完整的 Agent Loop。

从仓库根目录复核

npm run bootstrap
npm test
npm run check
  • bootstrap 按 Source Lock 准备对应上游提交；
  • test 运行本仓库脚本的单元测试；
  • check 检查公共内容、链接、来源、图示和其他仓库规则。

这些命令只检查教材自身，不会调用六套 Harness 的付费模型，所以运行时不用准备相关账号。不过，本仓库没有覆盖上游项目的全部运行条件，这些检查也就代替不了目标项目自己的完整测试。你若要核对某条关于运行行为的结论，还应该进入对应的锁定 Checkout，按官方要求运行最小相关测试，并记下 Node、Rust、Python 的版本以及跳过了哪些项目。

判断一句话是否过度外推

你可以试着把一句结论改写成「在锁定 Commit 的哪条路径里，给了什么输入，又观察到什么」，这样很快就能看出证据缺了哪一环。如果其中任何一项填不出来，就要收窄结论，只说现有材料确实覆盖的对象和条件。到了这一步，应明确标成未核对、仅在特定条件下成立、公开材料不可见，或仍需到真实环境中实验。

继续实践：受控本地核对。