数字孪生城市：AI Agent 与多物联系统联动实践课程
「你可以创造技术，不只是使用它。」 欢迎来到 TwinCity 2026 研发中心。在这里，学员们不再是普通的“编程学习者”，而是以高级研发工程师的身份，借助 AI 结对导师与敏捷项目管理（PM）工具，亲手搭建出一套虚实联动的“数字孪生智慧城市”巨型系统。
🎯 核心授课理念
本课程不仅传授代码编写，更注重培养系统架构思维（System Thinking）与人机协作素养（AI Literacy）。
1. AI 结对与 Vibe Coding
在高级工程师的日常工作中，我们不再“死记硬背”繁琐的语法，而是将重复性的输入工作交给人工智能。学员将学习掌握向 AI 提问的**“黄金 Prompt 公式”，聚焦于系统设计、数据流动和逻辑规则**，体验真实科技公司的开发流程。
2. SPAT 高阶教学法
- S (Scenario – 情景)：每天引入一个智慧城市建设的子系统情景（如潮汐交通、绿色微电网、地下防震系统、大模型控制中枢等）。
- P (Project – 项目)：学生将物理行空板 K10 硬件通过 MQTT 协议连接到云端 EMQX 网关，再通过 n8n 自动化处理，最后镜像驱动 Minecraft 虚拟世界，完成虚实联动闭环。
- A (Autonomous – 自主协同)：学员在 AI 导师辅助下，自主编写微控制器代码并解决复杂的 Bug。
- T (Task – 任务看板)：敏捷任务看板管理，将开发任务分为 Must Have (必须交付)、Should Have (应当完成) 和 Could Have (卓越挑战) 三档。
3. 敏捷项目管理（PM）工具集成
- WBS（工作分解结构）：动手写代码前，先通过纸质 WBS 设计卡将今日课题拆解为物理层、通信层、逻辑层与虚拟层。
- 实时进度燃尽图（Live Burn-down Chart）：使用研发工作站，随看板任务的完成情况在 Canvas 中实时绘制燃尽图，调控时间分配。
- 敏捷复盘（Retrospective）：下课前进行敏捷三问复盘，并一键导出打包含有“开发代码、看板进度、燃尽指数”的工程报告作业。
📐 虚实联动技术架构 (4 层数据链路)
每一天的 Sprint 任务都要求学生建立并打通以下 4 层数据通路：
┌────────────────────────────────────────────────────────┐
│ Level 1 物理采集：ESP32 架构行空板 K10 (传感器采样) │
└───────────────────────────┬────────────────────────────┘
│ (MQTT 协议 - 统一 JSON 帧)
┌───────────────────────────▼────────────────────────────┐
│ Level 2 网联协议：云端 EMQX 代理服务器 / 消息路由网关 │
└───────────────────────────┬────────────────────────────┘
│ (HTTP/MQTT 触发)
┌───────────────────────────▼────────────────────────────┐
│ Level 3 逻辑大脑：n8n 自动化流 / 大语言模型 / FSM状态机 │
└───────────────────────────┬────────────────────────────┘
│ (Minecraft 远程控制 API)
┌───────────────────────────▼────────────────────────────┐
│ Level 4 虚拟执行：Minecraft 3D 虚拟世界镜像实时联动 │
└────────────────────────────────────────────────────────┘
📅 10 天 Sprint 迭代大纲
| 单元 | 日期 | 课题名称 | 核心学习内容与交付物 |
|---|---|---|---|
| 单元一： 网联协议与 物理映射 |
Day 1 | 中央网络铺设 (MQTT) | 学习 MQTT 协议的发布与订阅、Topic 路径配置及 JSON 数据帧结构。打通物理按键触发 Minecraft 消息回执。 |
| Day 2 | 光能自适应 (太阳能追踪) | 使用线性映射（Map）算法将光敏值（0-100）换算为舵机转角（0-180），并引入数据平滑滤波（滑动均值滤波）算法减少光强抖动。 | |
| 单元二： 智能控制与 自动化决策 |
Day 3 | 状态机智能交通 ⭐ | 认识软件工程核心模式——有限状态机 (FSM)。根据车距变化自动起降 MC 路口闸门，配置特种车辆强制干预机制。 |
| Day 4 | 生态气候农场 (全自动) | 采集空气温湿度并换算为干旱指数。用 n8n 条件分支实现湿度饱和突变时，MC 瞬时暴雨并开启喷水灌溉。 | |
| Day 5 | 地下生命线灾害防御 | 采集三轴加速度。编写滑动窗口过滤抖动噪声算法，1.5 秒内高频晃动 3 次触发地震警报，MC 大楼坍塌且避难所门开启。 | |
| 单元三： 边缘 AI 与 大模型大脑 |
Day 6 | 交通视觉天眼 (边缘 AI) | 启用 K10 摄像头，运行板载的目标检测/颜色分类模型，识别违章红车，触发 MQTT 并命令 MC 派发武装直升机追踪。 |
| Day 7 | 自然语言城市 (LLM) ⭐ | 对接大语言模型 API。设计并微调 System Prompt 实现参数化转译，让用户口述指令（如“下一场雨盖一栋楼”）能百分百输出规范 JSON 操纵游戏。 | |
| Day 8 | 自动化拓荒 (AI Agent) ⭐ | 将 LLM 升级为具备 Tool Calling 能力的智能 Agent，读取游戏资源并参数化自动批量建造多层街区。 | |
| 单元四： 工程攻坚与 成果发布 |
Day 9 | 黑客松：子系统方案攻坚 | 学员自选智慧城市痛点，独立绘制 WBS 和任务便利贴，多设备联合调试，产出组内子系统方案。 |
| Day 10 | 成果大屏发布会 (路演) | 物理端、游戏端与网页可视化数据大屏三端联调，面向“投资人（家长）”展示项目功能并颁发工程师结营证书。 |
[!NOTE] 带 ⭐ 标志的为核心高阶课程日，涵盖了软件工程中的设计模式（FSM）、人工智能提示词工程（Prompt Engineering）与 Agent 工具调用（Tool Calling），是全营的技术重难点。
🏆 学员结营交付物与收获
完成本课程的学习后，学员将交付以下个人工程资产：
- WBS 架构设计卡：10 张记录系统设计与数据流向的手绘工作卡。
- 工程项目看板与燃尽图：记录每天研发效率提升的燃尽数据。
- 精美工程复盘报告：每天下课前由系统一键导出并打包的 Markdown 复盘文件。
- 高阶 Python 驱动源码：包含自己调参、滤波及状态机设计的 MicroPython 完整程序。
- 数字孪生城市成果：在 Minecraft 中独立和小组合作搭建的具备物理联动自愈能力的孪生子系统。
[!IMPORTANT] 关于安全与防幻觉 在 Day 7 大语言模型控制中，学员还将学习如何设计大模型指令“安全防火墙”，主动过滤敏感爆破词，并防止 LLM 发生代码格式“幻觉”导致系统解析异常，从而奠定严谨的系统安全意识。
“你可以创造技术，不只是使用它。” TwinCity 2026 研发中心 LINGJI AI LAB
