本项目是专注于 Python 大模型 Agent 工程开发 的系统化学习笔记、工程文档与分层实战题集。
| 专区 | 路径 | 说明 |
|---|---|---|
| 📝 学习笔记 | notes/ |
记录 Python 基础、Agent 框架（LangChain/LangGraph 等）、架构模式与思考总结 |
| 📚 工程文档 | docs/ |
存放系统架构设计、接口协议规范与第三方技术参考资料 |
| 💡 实战习题 | exercises/ |
包含 51 道涵盖语言特性、工程治理、框架实战与综合 Agent 开发的进阶习题 |
| 🧪 回归测试 | tests/ |
题库目录完整性与参考答案核心合约的自动化测试套件 |
确保已安装 uv，在项目根目录下执行：
export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8
uv syncuv run pytest
uv run ruff check .- 做题：进入
exercises/查看 51 道题目的详细清单与分层指南。 - 写笔记：在
notes/下按主题或模块沉淀自己的学习心得。 - 查文档：在
docs/下查阅架构图与技术规范。
项目共包含 51 道涵盖 Python 进阶、工程规范与 Agent 全栈开发的精选习题，详见 exercises/README.md：
- 01-10 入门主线：数据类、闭包装饰器、生成器、文件沙箱、线程池、Counter 统计、异步并发治理、有界队列 worker、分层配置与插件注册。
- 11-20 基础工程：FastAPI 契约、上游 HTTP 重试、后台任务生命周期、SQLite 事务、不可变消息、会话管理、文件防穿透、幂等治理、结构化日志与 JSON envelope。
- 21-35 轻量选修：LangChain 提示词、Pydantic 工具调用、LangGraph 状态图、路由分发、反思复盘、历史压缩、Skill 发现/打包、脱敏治理与轻量 Agent 服务。
- 36-45 工程选修：JSONL 架构迁移、JWT/RBAC 权限、事件溯源审计、pytest 仿真实测、WebSocket 会话流、SQLite 锁迁移与分布式租约。
- 46-51 综合收束：混合检索 RAG、MCP 协议服务、LLM 评测基准、Prompt 注入防御、模型智能路由与端到端 Agent 应用综合大作业。
👉 查看详细题面、学习路线与验收标准：习题专区文档 (exercises/README.md)
