阿源的知识库学习地图与资源使用方法
本章是可随时打开的资源导航，不是开始基础课前必须背完的理论章节。它把官方项目、协议、课程和论文按“要解决的问题”分类，并为每条记录注明前置知识、阅读阶段、阅读深度、推荐入口以及和 DeepSeek Harness 的对应关系。
怎么走这条路线
学习者应当已经能用 Python 编写函数、读取 JSON、处理异常并运行命令行脚本。本课程不重复讲 Java、Python 或 TypeScript 的通用语法；遇到源码中的语言障碍时，回到对应语言课程单独补齐即可。
第 02–10 章遵循认知依赖顺序。每一章的第一篇是章首导读或该章的主线入口，文章中的代码骨架以 Python 为主。第 11 章再把前面形成的模型映射到五个项目的源码结构。
01–11 章节地图
| 顺序 | 章节与入口 | 当前目标 | 前置关系 | 下一步 |
|---|---|---|---|---|
| 01 | 项目与知识库导航 | 选择资料、识别版本风险、建立源码阅读地图 | Python 基础编程能力 | 02 Agent 基础 |
| 02 | Agent 基础（8 篇） | 从 Agent 是什么到 Workflow 边界，建立可运行、可停止的最小闭环 | Python 基础 | 03 模型与消息 |
| 03 | 模型与消息（9 篇） | 理解 Provider/Adapter、Message、Content-Block、Token、结构化输出与流式可靠性 | 02 按顺序 | 04 Tool Calling |
| 04 | Tool Calling 与 Agent Loop（9 篇） | 从 Function Calling 与 schema 推进到选择、校验、执行、回填、并行、重试、幂等、审批与可观测 Loop | 02–03 | 05 State 与 Memory |
| 05 | State、Context、Session 与 Memory（9 篇） | 区分状态所有权、会话、检查点、上下文压缩、短期/长期记忆和隔离 | 02–04 | 06 MCP |
| 06 | MCP（12 篇） | 按 2026-07-28 理解 JSON-RPC、无协议 Session、每请求元数据、发现、能力、传输、扩展和授权 | 02–05、JSON-RPC | 07 Skills、Plugin 与 Hook |
| 07 | Skills、Plugin 与 Hook（9 篇） | 区分能力接口、工作方法、渐进式上下文、插件生命周期、依赖注入、Hook 与安全隔离 | 02–06 | 08 RAG |
| 08 | RAG 与 Context Engineering | 构建检索、重排、引用和分层评测的本地管线 | 02–07 | 09 Workflow |
| 09 | Workflow、Planning 与 Multi-Agent | 先做单 Agent 状态机，再判断是否需要多 Agent | 02–08 | 10 Evals 与安全 |
| 10 | Evals、Tracing、Guardrails 与安全 | 把轨迹、评测、权限、注入防护和 Sandbox 连成闭环 | 02–09 | 11 源码精读 |
| 11 | 源码精读 | 比较五个项目的 Loop、State、扩展与可靠性设计 | 02–10、Git 阅读能力 | 完成一轮对照后回到具体专题 |
五个主线源码项目
五个项目固定按以下顺序阅读。项目页中的版本和内部接口会变化，下面的链接是官方来源；阅读时优先看仓库当前分支的文档和测试，不以 Star 数或排行榜替代技术评价。
| 顺序 | 项目 | 官方入口 | 课程源码导读 | 主要观察点 |
|---|---|---|---|---|
| 1 | smolagents | GitHub · 文档 | 导读 | 最小 Agent Loop、Tool、CodeAgent、停止与执行边界 |
| 2 | OpenAI Agents SDK | GitHub · 文档 | 导读 | Agent、Runner、handoff、guardrail、session、tracing |
| 3 | MCP TypeScript SDK | GitHub · v2 文档 | 导读 | Client、Server、Transport、Capability、协议错误 |
| 4 | LangGraph | GitHub · 文档 | 导读 | State、Node、Edge、Checkpoint、Interrupt、Durable Execution |
| 5 | DeepSeek Harness | GitHub · 文档 | 导读 | Agent Driver、Everything is a Plugin、Cordis、Session、Skill、Hook、事件 |
资源字段与阅读深度
每条记录都提供以下字段，方便以后更新而不退化成链接堆积：
- 解决的问题：这条资源在系统中负责哪一类边界，不复述项目宣传语。
- 推荐学习内容：第一次打开时应先做什么、读什么、跑什么。
- 前置知识：直接开始前需要掌握的课程概念或工程能力。
- 学习阶段：
入门、进阶或生产工程。 - 阅读深度：
主线精读、专题查阅或案例参考。 - 推荐目录/文章：把入口缩小到可以执行的阅读范围。
- 与 DeepSeek Harness 对应关系：说明可以比较的 driver、plugin、session、skill、hook、event 或安全边界；不把对照关系写成实现等价。
- 查看日期：本批记录统一核对于 2026-10-07。版本敏感内容以后应重新核对官方页面。
按问题进入专题
- Agent 框架与运行时：先理解 loop、runner 和 state，再选框架。
- Coding Agent 与 Harness：关注工作区、执行器、插件和安全，而不是只看 demo。
- MCP、Tools、Skills 与集成：把能力接口、工作方法和扩展生命周期分开。
- RAG、Memory 与 Context Engineering：比较检索、记忆和上下文投影的责任。
- Workflow、Multi-Agent、Evals 与 Tracing：先读可恢复的单 Agent 流程，再看协作和观测。
- 课程知识库、官方文档与论文：用原始材料补充术语、协议和研究背景。
更新边界
本页是大纲预览和导航，不承诺外部项目 API 永久稳定。涉及密钥、浏览器登录、文件写入、Shell 或网络操作的资源，先在无敏感数据的本地环境阅读权限和安全说明；课程文章会给出模拟执行、显式审批和失败提示。