通过与 AI 编程助手对话，从零开始一步一步搭建具备 RAG 知识问答、Function Calling、MCP 协议和多工具编排能力的智能聊天机器人。
你会学到什么: LLM API 调用 · 流式输出 · RAG 检索增强 · Function Calling · MCP 协议
怎么学: 打开教材，和 AI 编程助手（OpenCode / Cursor / Copilot）对话，用自然语言驱动代码生成
适合谁: 零代码基础学员 / 希望深度理解 LLM 应用架构的开发者
这不是一个克隆即可运行的项目，而是一段学习旅程。
你将通过 6 个阶段，每次只向 AI 编程助手描述你想要的功能，让 AI 帮你生成代码，亲手构建出一个完整的智能机器人：
| 阶段 | 你将建造什么 | 核心技术 |
|---|---|---|
| Phase 1 | 基础流式聊天界面 | LLM API、SSE、Express 后端代理 |
| Phase 2 | 参数调优控制面板 | temperature、top_p、system prompt |
| Phase 3 | 知识库问答（RAG） | Embedding、向量检索、余弦相似度 |
| Phase 4 | 实时天气查询 | Function Calling、工具定义 Schema |
| Phase 5 | RSS 新闻阅读 | MCP 协议、stdio 子进程通信 |
| Phase 6 | 互联网搜索 | 多工具编排、DuckDuckGo API |
需要：
# 克隆工作坊仓库
git clone https://github.com/cloudzun/llm-chatbot-workshop.git
cd llm-chatbot-workshop
# 安装依赖
npm install
# 配置环境变量
cp .env.example .env
# 用文本编辑器打开 .env，填入你的 LLM_API_KEYnode scripts/check-env.js所有项目显示 ✅ 后继续。
📖 docs/teaching/student-textbook.md — 你的主要向导
教材里每个阶段都有：
- 概念讲解（这个技术是什么、为什么需要它）
- 现成的 AI 提示词（直接复制到 AI 编程助手对话框）
- 验收清单（怎么判断这个阶段完成了）
aigc-chatbot/
├── .env.example ← 从这里复制配置模板
├── package.json ← npm install / npm start / npm run dev
│
├── phases/ ← 核心：每个阶段的起点与完成参考
│ ├── phase-1/
│ │ ├── README.md ← 本阶段说明与验收清单
│ │ ├── starter/ ← 起点（Phase 1 从零开始，无 server.js）
│ │ └── completed/ ← 本阶段完成后的参考（server.js + public/）
│ ├── phase-2/
│ │ ├── README.md
│ │ ├── starter/ ← server.js + public/
│ │ └── completed/ ← server.js + public/
│ ├── phase-3/
│ │ ├── starter/ ← server.js + public/
│ │ └── completed/ ← server.js + public/ + rag/
│ ├── phase-4/
│ │ ├── starter/ ← server.js + public/ + rag/
│ │ └── completed/ ← server.js + public/ + rag/ + tools/weather.js
│ ├── phase-5/
│ │ ├── starter/ ← + tools/weather.js
│ │ └── completed/ ← + tools/news.js + mcp/
│ └── phase-6/
│ ├── starter/ ← server.js + public/ + rag/ + tools/ + mcp/
│ └── completed/ ← 同上 + tools/search.js（完整）
│
├── OneFlower/ ← 示例知识库（易速鲜花，RAG 使用）
├── solution/server.js ← Phase 6 成品（npm run solution 讲师演示用）
│
├── docs/ ← 学习材料
│ ├── teaching/
│ │ ├── student-textbook.md ← 📖 主教材
│ │ ├── instructor-guide.md
│ │ └── prompt-templates.md
│ └── engineering/
│ ├── construction-manual.md
│ └── PRD.md
│
└── scripts/
└── check-env.js ← 环境检查脚本
每个阶段的 phases/phase-N/ 都是完全独立的，包含该阶段所需的全部源文件：
| 子目录 | 内容 |
|---|---|
starter/ |
本阶段的起点（= 上一阶段完成后的完整状态） |
completed/ |
本阶段完成后的参考实现（标准答案） |
从任意阶段切入（以 Phase 3 为例）：
# 将本阶段起点的全部文件复制到项目根目录
cp -r phases/phase-3/starter/* .
# 启动开发模式（文件保存自动重启）
npm run dev卡壳时对照参考：
# 对比你的 server.js 与本阶段标准答案
diff server.js phases/phase-3/completed/server.js
node_modules/在项目根目录，只需npm install一次，无需重新安装。
npm run solution
# 打开 http://localhost:3000 — Phase 6 全量功能| 文档 | 用途 | 主要读者 |
|---|---|---|
| 学员教材 | 完整的自学或带练手册，含概念讲解与嵌入式 AI 指令 | 学员 |
| 讲师教案 | 课堂节奏、带练要点、常见问题 Q&A | 讲师 |
| AI 提示词索引 | 各阶段 AI 编程助手提示词的快速参考 | 讲师 / 学员 |
| 施工手册 | 从零构建的完整步骤与技术决策记录 | 课程研发团队 |
| 产品需求文档 | 课程功能定义与技术约束 | 课程研发团队 |
| 资源 | 用途 | 费用 |
|---|---|---|
BAAI/bge-m3 |
向量嵌入 | 完全免费 |
BAAI/bge-reranker-v2-m3 |
重排序 | 完全免费 |
Qwen/Qwen2.5-7B-Instruct |
轻量对话模型 | 完全免费 |
| wttr.in | 天气数据 | 完全免费，无需注册 |
| feed-mcp / hnrss.org | RSS 新闻 | 完全免费 |
| DuckDuckGo Instant Answer | 网络搜索 | 完全免费，无需 Key |
MIT License — 欢迎用于教学、个人项目和二次开发。