学习资源

🎯 难度：随时查阅# 官方文档# 进阶路线

先沿着本教程做出一个项目，再按需要看官方文档。不建议开十个教程同时学。

Python 与开发工具

• Python 官方教程（中文）：查语言细节。
• uv 官方文档：Python 版本、项目与依赖管理。
• Pydantic 文档：运行时验证、Field、JSON Schema。
• Ruff 文档：格式化与代码检查。

模型 API

• OpenAI Python SDK：SDK 用法与示例。
• DeepSeek API 文档：兼容接口与能力限制。
• 阿里云百炼文档：聊天与 Embedding 模型配置。

模型名、价格、接口能力随时变化，以平台文档和控制台为准。本教程代码采用明确的版本范围，升级先检查迁移说明。

Agent 与协议

• LangGraph 官方文档：状态图、持久化、中断。
• LangGraph Quickstart：对照手写循环理解 Graph API。
• MCP 官方说明：协议架构和安全。
• MCP Python SDK：注意主版本差异；本教程 MCP 代码使用 1.12.4。
• OpenAI Agents SDK：高层运行器、handoff 和 tracing。

发挥前端技能

• AI SDK 文档：TypeScript 模型与 UI 集成。
• Mastra 文档：TypeScript Agent 与工作流。
• FastAPI 教程：Python 后端接口与校验。

不要只照抄框架示例。对比它如何处理 messages、工具结果、用户隔离、取消和预算，你会学得更深入。

本站与部署

• VitePress 文档：静态文档、Markdown、主题与搜索。
• Cloudflare Pages 的 VitePress 指南。
• 本项目部署步骤：本仓库的命令和构建目录与默认模板略有不同。

学完之后怎么继续？

1. 把一个项目改成与你实际工作有关的工具。
2. 建立 20 条真实任务的测试集。
3. 比较两个模型的成功率、延迟和费用。
4. 补身份认证和安全边界，再给少量真实用户试用。
5. 学会基于轨迹排错，按需求选择框架，而不是追逐每个新名词。