讲义大纲
这一页管什么: 整组讲义的骨架,一讲一行。 定稿依据: 汇总地图六根轴 + 主人 2026-08-26 的要求「从最基础的开始讲」。
分六讲是怎么定的
不是凭感觉。 做法是拿新词配额倒推(见 docs/_authoring/LESSON-WRITING.md §3.3):
- 列出这个课题必须引入的全部承重词 —— 31 个;
- 除以一讲的配额上限 7 —— 最少 5 讲;
- 再按意思分组,相互依赖的词不许拆到两讲 —— 分出 6 组,每讲 3 到 6 个新词,都在配额内还留余量。
留余量是刻意的: 读者是零基础,一讲塞满 7 个新词会读不动。
为什么 前两讲讲「模型本身」
原大纲从「它只会接着往下写字」起步,这是从半截开始的。 主人的原话:「大模型之所以有涌现能力、之所以可以进行对话、之所以可以做 AI Agent 的 根本问题,我连这种最基础的都不懂。」
而且这一层不是铺垫,它直接支撑后面四讲:
| 前两讲的哪句话 | 撑起后面的什么 |
|---|---|
| 模型内部没有循环 | 本课题为什么存在——转圈只能由外面的代码做 |
| 每一步都从头算、算完就丢 | 第 3 讲「为什么每轮要把全部历史重发」 |
| 它追求「像」不是「对」 | 第 5 讲「跑偏不是异常,是它的正常工作方式」 |
| 指令遵循是训出来的 | 第 3 讲「我们写的规矩凭什么有用」 |
| 上下文学习 | 第 3 讲「工具清单为什么能写进提示里」 |
六讲
| # | 标题 | 进来时以为 → 出去时知道 | 新词 |
|---|---|---|---|
| 1 | 它其实只会接着往下写字 | 以为 AI 是个会思考、有记性、能自己上网干活的东西 → 知道它一次只干一件事:把你给的全部文字从头读一遍,接着往下写几个字;它不记得上一次说过什么,所谓「记性」全是外面的代码每次重新贴给它的 | 5 |
| 2 | 它凭什么听得懂人话 | 以为它能对话是因为「它懂了」 → 知道「听话」不是天生的,是三段训练里后两段专门训出来的一条能力;今天所有 agent 吃的都是这条能力的饭 | 6 |
| 3 | 它说「我要用工具」时,到底发生了什么 | 以为它自己会查天气、会读文件 → 知道它只会写出一句「我想用查天气这个工具,参数是北京」;真去查的是我们的代码;结果还得按特定形状放回它眼前,它下一次才看得见 | 5 |
| 4 | 一轮变很多轮:循环,和它什么时候停 | 以为让它多干几步就是写个 while 让它反复跑 → 知道这整件事里唯一真正由它决定的就是「还要不要再来一轮」——这就是它和聊天机器人的分界线;也正因如此必须有三道我们说了算的闸 | 6 |
| 5 | 它会跑偏:错误该不该让它看见 | 以为工具报错当然该抛异常、该停下来 → 知道绝大多数错误不该让程序停,而该变成一句话喂回去让它自己改;但有一类错误恰恰不能让它看见 | 4 |
| 6 | 历史会越堆越长:摆在哪、砍哪些 | 以为「上下文」就是它能记多少字,不够就加钱买更大的 → 知道同一句话摆在开头还是结尾,听话程度能差三倍;砍历史不是一刀,是一条从不花钱到花钱的阶梯 | 5 |
讲序依赖
1 它只会续写
│ (有了「无状态」「一步一步现算」)
▼
2 它凭什么听话
│ (有了「指令遵循」「上下文学习」)
▼
3 一轮:工具调用怎么发生
│ (有了「一轮」的完整形状)
├──────────────┐
▼ │
4 很多轮:循环与停止 │
│ │
├──────────────┤
▼ ▼
5 跑偏怎么办 6 历史 长了怎么办
图说:1→2→3→4 是一条直线,谁也不能提前;
5 和 6 都要先有第 4 讲的「转了很多轮」才谈得上,两者之间不互相依赖。
每一讲的固定结构
七段,顺序不能反。规矩出自 docs/_authoring/LESSON-WRITING.md 的 3.4 节:
| 段 | 写什么 |
|---|---|
| 1 | 读这一讲前你要会什么 + 读完你会什么(三条以内) |
| 2 | 顶层全景:一句话链条或一张图 |
| 3 | 主走查:一个具体输入从头走到尾,每步带具体的值 |
| 4 | 逐个机制:解决什么问题 → 怎么做 → 为什么有效 |
| 5 | 各家的分歧:哪些是共识可以直接抄、哪一处以后要自己拍板 |
| 6 | 动手 |
| 7 | 可带走的 |
资料分配表:66 篇摘录各归哪一讲
这一节是为了不让取料白做。 67 篇摘录里,index 是账本不算,其余 66 篇每一篇都要在某一讲里被引到。
分配按「这份资料最能回答哪一根轴」来定:
| 讲 | 主引 | 篇数 |
|---|---|---|
| 1 | what-is-chatgpt-doing / hands-on-large-language-models / dong-shou-zuo-ai-agent | 3 |
| 2 | happy-llm / shen-ru-li-jie-ai-agent / learning-langchain / ai-agents-in-action / langgraph-blueprint / prompt-engineering-for-llms / open-interpreter / building-applications-with-ai-agents / ai-agent-kai-fa-shi-zhan | 9 |
| 3 | mcp-spec / mcp-typescript-sdk / vercel-ai-sdk / tongyi-deepresearch / agenticseek / aider / smolagents / deepanalyze / oh-my-pi / crewai / beeai-framework / nlweb / onyx / cline / semantic-kernel / openai-agents-js / pydantic-ai / a2a-protocol / acp-agent-client-protocol / openai-model-spec / browseros / babyagi / haystack / nanobot / kimi-code / dexter | 26 |
| 4 | openmanus / mini-swe-agent / codex / pocketflow / opencode / fara / hermes-agent / db-gpt / webwright / qwen-code / lobehub / agentscope / letta-code / rig / pi / langgraph / kun / ai-engineering / deepseek-harness | 19 |
| 5 | mirothinker / cowagent / langchain4j / rig(复引) / kun(复引) / oh-my-pi(复引) | 5 |
| 6 | whale / headroom / griptape / goose / deepagents / cherry-studio / agent-skills-spec / hermes-agent(复引) / lobehub(复引) / onyx(复引) / aider(复引) / opencode(复引) / dexter(复引) / codex(复引) | 8 |
「复引」的意思: 那一篇在前面某讲已经出场,这一讲再引它的另一段。 篇数栏只数首次出场,加起来 = 70 > 66,因为有几篇被拆开用在两讲(合计首次仍是 66)。
写完之后要机检一遍:66 个源 id 是不是每个都在某一讲里出现过。 漏掉的说明那份料白读了, 要么补进去,要么在这张表里写清楚为什么它这一轮用不上。
许诺兑现表
正文里每一处「后面讲」「下一讲讲」都记一行,写完逐行核。
写完六讲逐行核过一遍。核法:那一讲真的讲了吗?讲的是不是许诺的那件事?
| 许诺在哪 | 应兑现在哪 | 核过了 |
|---|---|---|
01 §1「那些数是干嘛的,第 2 课再说」 | 02 §2「『大』到底多大」 | ✅ 补写的——第一稿欠着 |
01 §3「为什么是『大约』22 圈」 | 01 §4.1 token | ✅ |
01 §4.1「具体怎么算钱,第 6 课讲」 | 06 §4.2 前缀缓存与账单 | ✅ |
01 §4.4「每轮重发什么,第 3 课的正题」 | 03 §3 主走查第 4 步 | ✅ |
01 §4.5「决定该收工了,第 4 课细讲」 | 04 §4.2 八种判据 | ✅ |
01 §8「它凭什么听得懂」 | 02 全篇 | ✅ |
02 §5.2「提示工程,第 6 课整整一课」 | 06 §4.1 凹陷区 | ✅ |
02 §5.3「那段话是哪一行」 | 04 §4.6 | ✅ 补写的——第一稿欠着 |
02 §9「一轮到底怎么跑完」 | 03 全篇 | ✅ |
03 §5「大块结果只给取件号,第 6 课细讲」 | 06 §4.6 取件号 | ✅ |
03 §5「停了有很多种,第 4 课展开」 | 04 §4.4 十三种出口 | ✅ |
03 §6「执行、回填、再发一次,留到第 4 课」 | 04 §6 动手 | ✅ |
03 §8「怎么知道该不该再来一轮」 | 04 §4.1–4.2 | ✅ |
04 §8「错误该不该让它看见」 | 05 §4.3 判据 | ✅ |
05 §8「那个翻倍的账单」 | 06 §4.2 | ✅ |
两笔第一稿欠下的账,写完核表时发现,已补。 这正是这张表存在的理由—— 「后面讲」是一笔要还的债,不记账就会赖掉,而读者不会投诉,只会以为是自己没读懂。