氛围编程：Java智能体开发实战

📖 全书概览

|----------|--------|---------|-----------------------------|
| 部分 | 主题 | 章节 | 核心交付 |
| 第一部分 | 极速启航 | 第1-2章 | 在线跑通第一个程序 + 本地开发环境搭建 |
| 第二部分 | AI协作心法 | 第3-4章 | 提示词工程 + 读懂代码意图 |
| 第三部分 | 数据核心 | 第5-7章 | 判断、循环、对象、JSON持久化 |
| 第四部分 | 注入智能 | 第8-10章 | 工具调用、记忆机制、知识库RAG |
| 第五部分 | 自主交互 | 第11-12章 | 命令行交互界面 + ReAct自主规划 |
| 第六部分 | 打磨交付 | 第13-15章 | 重构、测试、打包部署、持续进化 |
| 附录 | 锦囊 | 4个附录 | 提示词模板库、语法翻译表、报错修复指令、项目目录结构图 |

📘 详细章节大纲

前言：欢迎来到"氛围编程"时代

这本书是写给谁的------你有行业知识，不需要编程基础
什么是"氛围编程" ------像聊天一样编程，AI写代码，你当产品经理
为什么是 Java + 智能体 ------跨平台、生态成熟、企业级可靠
贯穿全书的项目：智能日程助手（SmartScheduler） ------它和你一起成长
本书的"三不原则" ------不背语法、不手敲大段代码、不害怕报错
如何使用这本书 ------三步走：看目标 → 复制提示词给AI → 运行代码验证
配套资源 ------本书所有源码托管在Gitee（码云），一键克隆到本地，国内访问速度飞快

第一部分：极速启航------先看到魔法，再了解原理（2章）

第1章：10分钟，在线跑通你的第一个"智能程序"

本章目标：零安装、零配置，在浏览器中体验编程的成就感

1.1 为什么我们不从安装开始？------先建立信心
1.2 使用在线Java运行平台（介绍一个无需注册的在线IDE）
1.3 第一次Vibe Coding体验：

说需求："帮我写一个程序，判断今天下午3点我有没有空"
复制AI生成的代码（用DeepSeek/通义千问生成）
粘贴到在线平台，点击运行
看到输出结果

1.4 "人话"解读这段代码------这段程序到底在帮我做什么事？
1.5 修改一个数字，看到变化------感受"改代码"的掌控感
1.6 什么是"智能体"？------从这段代码到完整智能体的想象

🎯 本章Vibe实战：换一个你关心的场景（如"订单金额超过10000需要审批"），让AI生成代码在线运行，截图留念

第2章：搭建你的专属"魔法工坊"------Windows 11 保姆级图文教程

本章目标：在本地电脑上搭建完整的开发环境，并连接Gitee实现代码云端备份（国内访问，速度快、不卡顿）

2.1 我们要装什么？（核心四件套：JDK 17 + Maven + IntelliJ IDEA + Git）
2.2 安装 JDK 17（附每一步截图说明）
2.3 安装 Maven（含环境变量配置详解，配置阿里云镜像加速）
2.4 安装 IntelliJ IDEA Community（免费版）
2.5 安装 Git（Windows版）
2.6 注册 Gitee（码云）账号并配置 SSH 密钥（免密登录）

为什么用 Gitee 而不是 GitHub？------国内访问更稳定、更快速，无需代理

2.7 在 IDEA 中配置 Git，并克隆本书配套源码（从Gitee克隆）
2.8 创建你的第一个Maven项目，并一键推送到Gitee云端备份
2.9 认识你的开发界面（只认识6个按钮：项目文件区、代码编辑区、运行按钮、控制台、新建文件、Git提交按钮）
2.10 第一次"报错"体验 + 第一次"回滚"体验（报错不可怕，改崩了能复原）
2.11 本章检查清单 + Vibe实战：从Gitee拉取代码，修改后推回云端

🎯 本章Vibe实战：在Gitee上创建一个新仓库，将本地项目推送上去，刷新Gitee网页确认代码已同步

第二部分：学会"驾驶"而非"修车"------AI协作核心心法（2章）

第3章：像指挥实习生一样指挥AI（提示词工程入门）

本章目标：掌握向AI描述需求的精准方法，让AI第一次生成的代码就能用

3.1 AI能写Java，但前提是------你得说清楚你要什么
3.2 提示词万能公式：角色 + 任务 + 输入格式 + 输出格式 + 注意事项
3.3 案例对比：烂提示词 vs 好提示词（同一个需求，生成结果天壤之别）
3.4 如何让AI把代码"拆开讲给你听"（要求AI添加中文注释）
3.5 当AI给的代码跑不通怎么办？------报错复述给AI，让它自己改
3.6 一个完整的Vibe Coding工作流：需求 → 提示词 → 运行 → 反馈 → 迭代

🎯 本章Vibe实战：用你的真实工作场景写一段提示词，让AI生成代码并成功运行

第4章：看懂代码的"大局观"（不背语法，只认模式）

本章目标：不需要背任何Java语法，只需要能看懂代码在做什么，知道"改哪里"

4.1 把代码当"菜谱"看------不需要背配方，知道这一步在"腌肉"还是"爆炒"
4.2 5种最常见的代码"动作模式"：

定义数据 ：String name = "张三"; → "造了一个叫name的文字盒子"
做判断 ：if (条件) { ... } → "如果条件成立，就做这里的事"
重复做 ：for (int i=0; i<10; i++) → "重复做10次"
打包功能 ：public static void 方法名() → "给一段功能取个名字"
使用别人造好的轮子 ：import → "借用工具箱里的零件"

4.3 怎么在代码里找到"我要改哪里"？（用注释和变量名定位）
4.4 学会"复制-修改-运行"三板斧
4.5 让AI为每一段代码生成"中文业务注释"

🎯 本章Vibe实战：打开上一章AI生成的代码，用"中文注释"标注每一段在做什么业务

第三部分：核心骨架------让程序替你处理数据（3章）

本部分教学模式 ：每章统一采用 "用户故事 → 发给AI的提示词 → AI生成的代码 → 大白话翻译 → 动手修改" 五步法

第5章：把行业规则变成代码（条件判断与逻辑）

本章目标：把你工作中的"如果...就..."规则变成可执行的程序

5.1 用户故事："如果会议超过1小时，提醒我准备茶水"
5.2 你的任务：把这条规则写成提示词发给AI
5.3 AI生成的代码长什么样（重点看 if 和 else 所在的行）
5.4 实战：把你的行业规则（比如：如果订单金额 > 10000，需要二级审批）告诉AI
5.5 多条件判断：用"而且（&&）"和"或者（||）"来描述复杂规则
5.6 提交到Gitee：把今天写的代码Commit并Push到云端

🎯 本章Vibe实战：将你工作中的一条核心判断规则变成Java代码

第6章：让程序替你跑腿（循环与批量处理）

本章目标：让程序自动重复处理大量数据，解放你的双手

6.1 用户故事："每天早上9点，检查当天所有会议并发送提醒"
6.2 重复动作的两种模式："数着次数做（for）" vs "一直做到满足条件（while）"
6.3 用大白话告诉AI"帮我循环检查所有日程"
6.4 实战：批量处理------遍历所有日程，找出时间冲突的并列出
6.5 避免死循环（告诉AI加"退出条件"）
6.6 提交到Gitee

🎯 本章Vibe实战：让智能体自动遍历你一周的日程，输出所有冲突提醒

第7章：把零散信息装进"档案袋"（对象与类 + JSON持久化）

本章目标 ：学会用"对象"来组织复杂数据，并让数据能保存到文件，关掉程序再打开数据还在

7.1 为什么需要"对象"？------一个日程有标题、时间、地点、参与人，它们应该被绑在一起
7.2 怎么跟AI描述一个"对象"："请帮我创建一个'日程'模板，包含标题、开始时间、结束时间、地点"
7.3 AI生成的类（class）长什么样（只找 public class 和里面的变量）
7.4 实战：给日程增加"优先级"属性
7.5 ⭐ 里程碑：把对象保存成JSON文件

为什么要保存成JSON？------这是最通用的数据格式
告诉AI："请用Jackson库帮我把日程列表保存到 schedule.json 文件中，程序启动时自动加载"
验证：关闭程序再打开，之前添加的数据还在

7.6 提交到Gitee

🎯 本章Vibe实战：把之前散装的日程管理重构为"对象+JSON持久化"版本，体验"关电脑再开数据还在"的里程碑感

第四部分：给它"手脚"与"大脑"------注入智能（3章）

第8章：连接外部世界（工具调用 + 真实API实战）

本章目标：让智能体具备"动手能力"------能调用外部工具和真实网络API

8.1 什么是"工具调用"？------智能体的"手脚"
8.2 模拟工具入门：设计一个"发送邮件"工具（模拟输出到控制台）
8.3 ⭐ 第一次调用真实API（联网查天气） ：

教读者怎么跟AI描述："我要调用一个HTTP请求，输入城市名，输出温度"
使用免费天气API（如 wttr.in 或聚合数据，国内可用）
让AI生成Java代码（使用 HttpURLConnection 或 OkHttp）
处理返回的JSON数据（用 Jackson 解析）

8.4 ⭐ 处理API报错 ：超时、网络不通、Key失效------全扔给AI修
8.5 实战：添加日程后，调用钉钉/飞书机器人Webhook发送通知
8.6 提交到Gitee

🎯 本章Vibe实战：给智能体装配"查天气"工具，输入城市名返回实时温度

第9章：让智能体记住你（记忆与持久化）

本章目标：让智能体拥有"记忆"，能记住你是谁、你喜欢什么，且重启不丢失

9.1 为什么记忆是智能体的"灵魂"
9.2 短期记忆（会话内：同一个对话中记得）vs 长期记忆（跨会话：今天记得明天也记得）
9.3 怎么让AI实现"记住我"：写提示词要求增加"用户档案"功能
9.4 ⭐ 记忆的持久化 ：用第7章学过的JSON技术，把用户画像保存到 user_profile.json
9.5 实战：关闭程序再打开，智能体能叫出你的名字，记得你偏好的会议时间
9.6 提交到Gitee

🎯 本章Vibe实战：让智能体记住你的常用参会人列表，并能在安排日程时主动推荐

第10章：让智能体拥有行业知识（RAG检索增强）

本章目标：给智能体配一本"行业字典"，让它能回答你的专业领域问题

10.1 大模型虽聪明，但不知道你公司的内部制度、你的专业知识
10.2 RAG是什么？------检索 → 增强 → 生成（三步走）
10.3 构建本地知识库：把文本知识放入 List 或 Map
10.4 实现简单关键词检索（查找包含关键词的文档）
10.5 实战：把你公司的会议制度文档导入智能体，问"请假需要提前几天？"
10.6 扩展思路：知识库可以是你整理的任何文本（产品手册、复盘笔记、法规条文）
10.7 提交到Gitee

🎯 本章Vibe实战：将你的行业规范文档（如财务审批流程）导入知识库，让智能体回答专业问题

第五部分：让它"活"起来------交互与自主决策（2章）

第11章：给它一个"嘴巴和耳朵"（命令行交互界面）

本章目标：让智能体从"跑一次就结束"变成"能持续跟你聊天、主动提醒你"

11.1 以前我们每次跑完 main 方法程序就退出了，现在我们要做持续对话
11.2 告诉AI："请帮我写一个持续监听用户输入的循环，直到我说'拜拜'才退出"
11.3 AI会给你什么代码？------while(true) + Scanner（控制台持续监听你的输入）
11.4 设计退出指令：输入"拜拜"就优雅退出，并自动保存所有数据
11.5 ⭐ 让智能体主动说话：在后台定时扫描日程，到点主动在控制台弹出提醒
11.6 提交到Gitee

🎯 本章Vibe实战：运行智能体，连续输入多条指令（"添加日程""查看日程""我是谁"），最后说"拜拜"退出，再重启验证数据还在

第12章：教会它"三思而后行"（ReAct自主规划）

本章目标：让智能体自主完成复杂多步任务，而不是每步都要你发指令

12.1 什么是ReAct？------思考（Reasoning）→ 行动（Acting）→ 观察（Observation）
12.2 用户故事："帮我安排明天下午和客户的会议，顺便查查天气预报，如果下雨提醒带伞"
12.3 告诉AI："请帮我实现一个ReAct循环，能自主规划步骤完成复杂任务"
12.4 把之前学过的所有能力整合进ReAct框架（工具 + 记忆 + 知识库）
12.5 ⭐ 处理过程中的意外中断：比如查天气API挂了，让AI写备选方案
12.6 见证奇迹：输入一句话，智能体自动完成"查空闲→订会议→查天气→发通知"四步
12.7 提交到Gitee

🎯 本章Vibe实战：输入"安排明天下午和客户的会议"，智能体自主完成多步任务并输出完整报告

第六部分：打磨与交付------从"能跑"到"好用"（3章）

第13章：当代码变多了，怎么让AI帮你"收拾屋子"（重构）

本章目标：当代码从1个文件变成20个文件时，学会让AI帮你整理代码结构

13.1 你的代码从1个文件变成了20个，自己都找不到想改的地方了
13.2 重构前先Commit：确保当前版本是稳定的，改崩了能一键恢复
13.3 告诉AI："帮我把所有工具类移到 tools 包，把所有记忆代码移到 memory 包"
13.4 让AI帮你检查循环依赖和重复代码
13.5 建立"需求变更"工作流：比如把"会议默认1小时"改成"默认30分钟"
13.6 提交到Gitee（见证重构后的整洁代码）

🎯 本章Vibe实战：将你的项目按功能分包（model/、tools/、memory/、agent/），用AI辅助完成重构

第14章：像真正的产品经理一样测试（边界情况与防呆）

本章目标：让程序更健壮------用户乱输入也不会崩

14.1 如果用户输入乱码、负数时间、空值，程序会崩吗？
14.2 学会向AI描述边界情况："如果日程跨夜（22点到2点），帮我处理"
14.3 让AI自动生成几个测试场景（不需要学JUnit，用 main 方法手动验证）
14.4 ⭐ 日志代替 System.out.println
14.5 提交到Gitee

🎯 本章Vibe实战：向AI描述你行业中最常见的3个边界情况，让AI生成对应的防御代码

第15章：打包给同事用，并规划下一代

本章目标：将智能体打包成可执行文件，交付给非技术同事使用，并规划未来迭代

15.1 打包成可执行Jar（让AI帮你配置 pom.xml 的打包插件）
15.2 Windows 11 双击运行（创建 .bat 启动脚本）
15.3 ⭐ 交付三件套 ：Jar包 + 启动脚本 + 使用说明书.md（让AI帮你写说明书）
15.4 把你的Gitee仓库地址发给同事------"源码也给你，欢迎Fork修改"
15.5 下一代怎么做？------告诉AI"我想加一个Web可视化界面"或"接入钉钉机器人"
15.6 Vibe Coding终极心法回顾：需求定义能力 > 代码编写能力

🎯 本章Vibe实战：生成可执行的Jar包 + 启动脚本，发给朋友/同事体验你的智能日程助手

终章：你不是程序员，你是"创造者"

回顾你的旅程：从零到拥有一个听你话的智能体
你已经掌握的核心能力清单（用AI生成代码、理解代码意图、提交到Gitee、处理报错、重构、打包交付...）
Vibe Coding的本质：你负责定义"做什么"，AI负责实现"怎么做"
如何将这套方法论迁移到你工作生活中的其他领域
最后的寄语：每一个行业专家，都应该拥有属于自己的智能工具

📎 附录（Vibe Coding 专属急救包）

附录A：写给AI的"提示词模板库"（15个高频模板）

直接复制使用，替换 【】 中的内容即可

模板1：「创建新功能」------请帮我创建一个Java方法，功能是【描述功能】，输入参数是【参数说明】，输出是【输出说明】
模板2：「修改现有功能」------请帮我修改以下代码中的【描述要改什么】，改完之后请展示完整代码
模板3：「解释这段代码」------请用大白话逐行解释以下代码在做什么：【粘贴代码】
模板4：「修复报错」------我运行Java程序遇到了以下报错，请告诉我原因和修复方法：【粘贴报错】
模板5：「添加注释」------请为以下代码添加详细的中文业务注释：【粘贴代码】
模板6：「重构」------请帮我把以下代码按功能拆分到不同的包/类中：【粘贴代码】
模板7：「添加持久化」------请帮我把【描述数据】保存到JSON文件，程序启动时自动加载
模板8：「调用API」------请帮我写Java代码调用【API名称】，输入【参数】，输出【期望结果】
模板9：「创建交互循环」------请帮我写一个持续监听用户输入的Java程序，输入"退出"时结束
模板10：「测试边界」------请帮我为以下代码添加边界情况处理：【粘贴代码】
模板11：「打包配置」------请帮我配置Maven的pom.xml，打成可执行Jar包
模板12：「生成Git提交信息」------请根据以下改动生成规范的Git Commit Message：【描述改动】
模板13：「写使用说明书」------请为我的Java程序写一份用户使用说明书
模板14：「创建对象」------请帮我创建一个【描述对象】的Java类，包含【属性列表】
模板15：「整合模块」------请帮我把【模块A】和【模块B】整合到一起，让【描述整合后的行为】

附录B：Java代码"人话翻译对照表"（40个高频关键词）

|---------------------------------- | Java代码 | public static | String | int | double | boolean | if (条件) { ... } | else { ... } | for (int i=0; | while (条件) | class | new | this | extends | implements | @Override | package | import | return | private | public | protected | static | void | null | List<> | Map<> | ArrayList | HashMap | try { ... } | throws | // | System.out.println() | Scanner | git clone | git add | git commit | git push | git pull | git reset --hard | fork | pull request -------------|--------------------------| | 翻译成人话 | void main(String[] args) | 程序的"大门"，从这里开始执行 | | 文字盒子（装文本） | | 整数盒子（装整数） | | 小数盒子（装带小数点的数） | | 真/假盒子（装true或false） | | 如果条件成立，就做这里的事 | | 否则（条件不成立时），就做这里的事 | i<10; i++) { ... } | 重复做10次，i从0数到9 | { ... } | 只要条件成立，就一直重复做 | | 模板/档案袋（定义一个"类型"） | | 照着模板做一个实物（创建对象） | | 指"我自己"（当前对象） | | 继承/抄作业（复用父类的代码） | | 实现/履行契约（承诺实现接口的方法） | | 覆盖/重写（改写从父类继承的方法） | | 包裹/文件夹（代码所在的目录） | | 引入/借用（从其他包裹借工具） | | 返还/交出（把结果返回给调用者） | | 私有的（只有自己能用） | | 公开的（谁都能用） | | 半公开的（只有自己和子类能用） | | 静态的/共享的（不依赖于具体实物） | | 空/无返回（执行完就完了，不交东西出来） | | 空/什么都没有（盒子是空的） | | 列表/清单（有顺序的一串东西） | | 字典/对照表（一个键对应一个值） | | 动态列表（可以自动长大的列表） | | 哈希对照表（根据键快速查找值） | catch (Exception e) { ... } | 试试看，如果出错了就补救 |
| 抛出去（自己搞不定，交给上级处理） |
或 /* ... */ | 注释/备注（写给人类看的，程序无视） |
| 在控制台印一行字 |
| 扫描器（监听键盘输入） |
| 把Gitee上的代码下载到本地 |
| 暂存/标记（告诉Git"这个文件我要提交"） |
| 提交/拍照（给当前版本拍一张快照） |
| 推送/上传（把本地快照传到Gitee云端） |
| 拉取/下载（把Gitee的最新代码拉到本地） |
| 回滚/恢复到某个历史版本 |
| 复制/分叉（把别人的仓库复制一份到自己的账号下） |
/ PR | 请求合并（把自己改的代码推给原作者） |

附录C：最常见的15个报错及"复制这段话给AI"修复指令

|-------------------------------------------------|------------------|------------------------------------------|
| 报错信息（关键词） | 翻译成人话 | 复制给AI的指令 |
| ';' expected | 你忘了打分号 | "我少了一个分号，请帮我找出来并修复" |
| cannot find symbol | 你打错字了，或者少import了 | "编译报错说找不到符号，请检查是否拼写错误或缺少import" |
| NullPointerException | 你碰了一个空盒子 | "运行时报NullPointerException，请告诉我哪里可能为null" |
| ClassNotFoundException | 缺了一个零件 | "报错说找不到类，请检查Maven依赖是否完整" |
| ConnectException 或 timeout | 网络连不上 | "API调用超时，请帮我加超时重试机制" |
| NumberFormatException | 把文字当数字读了 | "用户输入了非数字内容，请帮我加校验" |
| ArrayIndexOutOfBoundsException | 越界了，访问了不存在的位置 | "数组越界了，请帮我检查循环边界条件" |
| FileNotFoundException | 文件没找到 | "程序启动时找不到JSON文件，请帮我自动创建" |
| UnsupportedEncodingException | 字符编码不对 | "编码格式不支持，请帮我改成UTF-8" |
| JSONException 或 JsonParseException | JSON格式解析失败 | "解析JSON报错，请检查字段名是否匹配" |
| MalformedURLException | URL格式不对 | "URL格式错误，请帮我验证并修正" |
| ClassCastException | 类型转换错误 | "类型转换失败，请检查对象类型" |
| IllegalArgumentException | 传入了非法参数 | "参数不合法，请帮我加参数校验" |
| Maven dependency 下载失败 | 依赖包没下载下来 | "Maven下载依赖失败，请帮我配置阿里云镜像" |
| Port already in use | 端口被占用了 | "端口被占用，请帮我换一个端口" |

附录D：本书完整项目的"最终目录结构图"

复制代码

smart-scheduler/
├── pom.xml                          # Maven配置文件
├── README.md                        # 项目说明文档（让AI帮你写）
├── run.bat                          # Windows启动脚本
├── schedule.json                    # 日程数据存储文件
├── user_profile.json                # 用户画像记忆文件
│
└── src/
    └── main/
        └── java/
            └── com/
                └── yourname/
                    │
                    ├── Main.java               # 程序入口
                    ├── Launcher.java           # 交互循环（第11章）
                    │
                    ├── model/                  # 数据模型层（第7章）
                    │   ├── Event.java          # 日程对象
                    │   └── UserProfile.java    # 用户画像
                    │
                    ├── tools/                  # 工具层（第8章）
                    │   ├── EmailTool.java      # 发送邮件
                    │   ├── WeatherTool.java    # 查询天气（真实API）
                    │   └── NotificationTool.java # 钉钉/飞书通知
                    │
                    ├── memory/                 # 记忆层（第9章）
                    │   └── MemoryManager.java  # 记忆管理
                    │
                    ├── knowledge/              # 知识库层（第10章）
                    │   └── KnowledgeBase.java  # 知识检索
                    │
                    ├── scheduler/              # 日程管理层
                    │   └── ScheduleManager.java # 增删改查 + 冲突检测
                    │
                    └── agent/                  # 智能体核心（第12章）
                        └── ReActAgent.java     # ReAct自主规划引擎

📊 全书统计

|--------------|-----------------------|
| 项目 | 数量 |
| 总章节数 | 15章 + 4个附录 |
| 可运行的代码示例 | 约25个 |
| Vibe实战任务 | 每章1个，共15个 |
| 最终产出 | 1个完整的、可部署的智能日程助手 |
| 操作系统 | Windows 11（独占） |
| 代码托管平台 | Gitee（码云）------国内访问飞速 |
| 建议阅读周期 | 6~8周（每周2章 + 动手实践） |

💡 为什么选择 Gitee（码云）？

|--------|---------|------------------|
| 对比项 | GitHub | Gitee（本书选用） |
| 国内访问速度 | 慢，需代理 | 快，无需代理 |
| 注册流程 | 需英文界面操作 | 全中文，更友好 |
| 私有仓库 | 付费 | 免费 |
| 用户群体 | 国际开发者 | 国内开发者，中文交流 |
| SSH配置 | 同Gitee | 同GitHub，完全兼容 |

✅ 大纲审核结论

本大纲已满足以下所有要求：

✅ 专注Windows 11：彻底移除Ubuntu内容，降低学习门槛
✅ Gitee深度集成：从第2章开始贯穿全书，国内访问飞速，代码永不丢失
✅ Vibe Coding核心理念：AI生成代码为主，语法学习为辅
✅ 产品级交付：从在线体验 → 本地开发 → 云端备份 → 打包分享，全流程覆盖
✅ 非程序员友好：每章一个Vibe实战，每章都有可运行的成果
✅ 出版与专栏适配：结构完整，内容充实，有持续的交付点
✅ 国内用户友好：全中文界面截图说明 + 阿里云Maven镜像加速

请确认此大纲，我将按照此框架开始撰写后续章节的完整正文！