程序员基础版
就业上岗，约 10 周精简主线，交付可演示、可部署的 Agent OS
北极星准则：帮助学习者找到并胜任一份 AI Agent 开发工程师的工作。
主线架构：原生模型协议 → Native Agent Harness → RAG → Mastra Agent OS → Production。
毕业项目是 Agent OS（Agent Platform），程序员基础版交付可上线的精简形态（Native / Mastra 双 Runtime）。
这门课适合谁
| 你的情况 | 建议 |
|---|---|
| 有 Node.js / TypeScript 后端或全栈经验，想转 AI Agent 方向 | 正合适，直接从第 1 周开始 |
| 会调 OpenAI API 写过聊天机器人，但没做过工程化 Agent | 正合适，第 2 周开始会覆盖你的盲区 |
| 只会 Python，不写 TypeScript | 可以学，但要先补两周 TS 严格模式与 Zod。第 7 周有 Python 侧同类框架的对照表，第 9 周有一个 Python Runtime 的选做 |
| 完全没有后端经验 | 先看小白科普版建立概念，再补后端基础 |
| 只想在日常工作里用好 AI，不打算写代码 | 去超级普通版 |
学习强度按每周 15 到 20 小时估算，只需满足各周核心档验收。
怎么学
每周固定四步循环：设计稳定契约 → 实现（Schema First、可取消、可超时、可追踪、可重试）→ 验证（测试、事件快照、基本回归）→ 复盘。
每一周的页面都按同一套结构组织，建议按顺序走完，不要跳过自测：
- 学前自测：答不上来说明前置知识没补齐，先去看复习与延伸里的链接
- 学习目标 / 课程内容 / 实施任务：本周要建的东西
- 动手挑战：30 分钟内能做完的小实验，用来验证本周最关键的那个直觉
- 验收标准：核心档是程序员基础版毕业线，进阶档在程序员进阶版完成
- 学后自测：检验是否真的通关
- 本周作业：独立交付物，直接进作品集
- 面试考点：这块内容在面试里怎么被问
- 复习与延伸：官方文档，以及本仓库对应 package 的源码入口
课表（约 10 周）
| 周次 | 主题 | 核心产出 |
|---|---|---|
| 1 | AI Agent 工程基线 | Monorepo、CI、ADR、统一事件词典 |
| 2 | 原生模型 API 与 Model Gateway | 多 Provider、流式取消、成本追踪 |
| 3 | Tool Runtime、Sandbox 与 Permission | Tool Registry、Executor、Permission Gate |
| 4 | Native Agent Harness 与事件协议 | Agent Loop、Budget/Stop/Validator、事件快照 |
| 5 | Session/Context 精简版 + RAG 数据管道 | 基本 Session Log、Upload→Index 全链路、Chunk 溯源 |
| 6 | 检索系统 + RAG 生成与引用（评测精简版） | Dense/BM25/Metadata 融合 + Reranker、Context Packing、引用绑定 |
| 7 | Mastra Agent/Tool/Workspace + Workflow/Durable | mastra-adapter、商品运营 Agent、Suspend/Resume |
| 8 | Mastra Memory/RAG/MCP/Server + 事件驱动异步 Agent | 三层 Memory、MCP Server、BullMQ Job Center |
| 9 | Runtime 平台化最小实现 + 可观测性/Eval/Security 基线 | Agent Registry、OTel、基本回归测试、Policy Center 程序员基础版（选做：跨语言 Runtime） |
| 10 | 部署、压测、故障演练与毕业答辩 | 生产部署、压测报告、简化 API/CLI Demo、技术答辩 |
关于框架
主线用 TypeScript，框架选型是 Mastra（第 7、8 周），加上你自己在第 4 周手写的 Native Harness。这两条实现跑同一批契约测试，是整个平台抽象的地基。
其余框架按用途分布在两个地方：
| 框架 | 在哪学 | 为什么放这里 |
|---|---|---|
| Mastra | 程序员基础版第 7、8 周 | TypeScript 产品级 Agent 的主实现 |
| Agno（Python） | 第 7 周认一下，第 9 周选做接入，深度在进阶版 A10 | Python 岗绕不开，但它是跨语言跨进程，治理问题独立成一块 |
| Pi | 进阶版 A1 | 源码精读，不是拿来用的 |
| LangGraph / LangChain | 进阶版 A3 / A4 | 面试高频但基础版时间不够，压缩时整体迁出 |
基础版不追求框架数量。 一个手写的加一个产品级的，能把契约打磨到位就够上岗了。想在候选人里做出差异，去程序员进阶版。
版本说明
2026-07-21 修订：程序员基础版从约 19 周压缩为约 10 周精简主线。LangGraph、AG-UI 自定义前端整体迁移程序员进阶版；Session/Compaction、RAG 评测、Eval、Security 只保留精简版，深度全集在程序员进阶版。
2026-08-01 修订：新增 Agno（Python）作为对照框架。第 7 周加一张三框架对照表（认得出即可），第 9 周加一个跨语言 Runtime 的选做（不进毕业线）。深度实现在进阶版 A10。毕业标准十条不变。
对应原 24 周总课表编号：第 5、10–12、17（全集）、18–20（全集）、21–23 周为程序员进阶版内容，程序员基础版不再教授或只保留精简版。每周页面顶部会标注对应的原编号，方便和程序员进阶版对照。
毕业标准
十条硬性要求，全部满足才算通关，详见第 10 周的最终验收：
- Agent Run 成功率达到既定目标
- 服务重启后长任务可恢复
- 高风险操作均有审批记录
- 所有回答可追踪模型、Prompt、工具和知识来源
- Eval Gate 可阻断低质量版本
- 具备多租户隔离
- 成本、延迟和 Token 可视化
- 关键 API 有压测报告
- 完整 README、架构文档和运行手册
- 完成 30 分钟技术答辩