实战导览

🎯 难度：递进式⏱ 预计：10 天起，按自己的节奏# 实战# 作品# 验收

这五个项目不是生产成品模板，而是能够运行、看清原理的教学版本。每个都有准备步骤、完整核心代码、验收任务与升级方向。

项目顺序

项目	做出什么	主要能力	前置
1 · 终端编程助手	读取限定项目，解释代码并建议修复	工具、权限、循环	Python + 手写 Agent
2 · 个人知识库	把笔记变成可引用的问答系统	分块、Embedding、检索	RAG 概念
3 · 深度研究员	多次搜索、收集来源、输出报告	搜索、证据、预算	工具调用、规划
4 · 全栈 Agent	浏览器提问、可视化工具状态、流式回答	FastAPI、流协议、取消	异步 Python + 前端基础
5 · MCP Server	用标准协议提供自己的笔记工具	stdio、Server、Client	MCP 概念

建议每个项目用独立目录，保存自己的依赖和 .env。不要在这份文档站的 docs 目录里运行 Agent，避免把私有资料打包进网站。

共享代码

• config.py：模型配置与客户端。
• runner.py：可复用工具循环。

项目页会明确说明需要复制哪些共享文件。文中的带文件名代码块是完整文件；没有文件名的片段可能用于解释或局部替换，请阅读前面的说明。

API 能力不是所有平台都一致

• 项目 1、3、4：需要工具调用支持。
• 项目 2：另需 Embedding API，不能默认使用 DeepSeek 聊天地址。
• 项目 3：另需搜索服务账号，费用独立计算。
• 项目 5：协议测试不需要大模型 Key。

每个项目用同一种学习节奏

1. 跑通最小版：确认输入能到达输出。
2. 看中间状态：messages、检索块、工具事件，不只看回答。
3. 测失败情况：非法参数、网络失败、路径越界、预算耗尽。
4. 再加一项能力：不要一口气堆十个工具。
5. 写下验收证据：哪些用例通过、哪些仍失败，不把「看起来能用」当完成。

你最终应该能解释自己的程序，而不是只会说「它用了某某框架」。