我不是老师，也没有乡村支教的经验。但我记得自己上学那会儿，语文课学古诗词的流程就是，读一遍、翻译一遍、背下来、默写。至于这首诗到底好在哪里，老师偶尔讲几句，大部分时候靠我们自己体会。说实话，大多数时候什么也没有体会到。。。
我很难想象，在资源更有限的乡村课堂上，古诗词教学会是什么样子。
后来我想，与其想象，不如直接做点什么。AI 现在这么强，能不能让它帮老师把古诗词课变得有意思一点，让学生不只是背，而是真的能感受到诗的美？
于是我用 TRAE SOLO 从零开始做了"诗中天地"。它不是一个复杂的产品，打开浏览器就能用，不需要安装，不需要注册。但它做到了一件事：让李白、杜甫、王维这些诗人"走进"课堂，和学生聊天、讨论、一起写诗。
下面是项目的详细介绍，请查阅。
一、摘要
面向乡村中小学语文教师，在古诗词课堂教学场景下，提供一个零门槛、免安装、打开即用的 AI 唐诗教学互动工具。通过"诗会模式"让学生与李白杜甫"面对面"讨论诗歌、通过"创作模式"让学生与诗人协作写诗，将传统的"老师讲、学生背"变成沉浸式互动体验。目前通过完整功能开发、多轮迭代优化和模拟教学场景测试验证有效。
二、真实场景与需求
1、目标人群
乡村中小学语文教师，以及他们课堂上的学生。
2、痛点描述
一个很现实的场景是：乡村学校语文老师在教古诗词时，往往只能照着课本念注释、翻译字面意思、让学生背诵默写。一堂好的古诗词课，需要什么？ 需要让学生理解诗人的情感、感受诗歌的意境、体会文字的美。但乡村学校通常没有多媒体课件资源，没有专业的教研团队帮忙打磨教案，一个老师可能要同时带语文、数学甚至英语，备课时间本来就捉襟见肘。
具体到"一步任务"：老师想让学生理解《春江花月夜》为什么被称为"孤篇盖全唐"，但自己能找到的辅助材料有限，课堂上最多就是放一段朗读音频、讲几句赏析，学生听得昏昏欲睡，最后还是靠死记硬背。
3、现有做法
现在老师们的常规做法是：自己从网上搜教案、找课件、下教学视频。但问题是：
1. 资源质量参差不齐：网上能找到的课件大多是城市重点学校的版本，和乡村学生的认知水平有差距
2. 缺乏互动性：PPT 再精美也是单向输出，学生被动接收
3. 难以持续：就算老师有热情，每天备课已经精疲力尽，很难持续花时间去找资源、做课件
三、作品介绍
“诗中天地” 是一个前端的网页应用，打开浏览器就能用，不需要安装任何东西，不需要注册账号。
核心功能有三个：
1、诗会模式，让学生和诗人"面对面"
老师选择一首唐诗（内置 16 首经典唐诗，涵盖初高中必背篇目），邀请 2-4 位诗人"出席"诗会。AI 会模拟李白、杜甫、王维等诗人围绕这首诗展开讨论，聊意境、聊用词、聊情感。
最关键的是，学生可以随时插话参与讨论。比如李白说"此诗气势磅礴"，学生可以问"李白你觉得哪句最好？“，所有诗人会依次回应。这把传统的"听老师讲"变成了"和诗人聊天”，学生的参与感和理解深度完全不一样。
2、创作模式，让学生和诗人一起写诗
学生选择一位诗人，描述一个场景（比如"写一首关于打工人的诗"），诗人会给出 2-4 句候选诗句，学生可以选择采纳或放弃，最终组装成自己的诗。
这个过程中，诗人会讲解为什么这样用词、这句诗的意境是什么，学生在创作中自然就学到了炼字、意象、情感表达这些诗歌创作的核心技巧。
3、诗人群像，让诗人"活"起来
内置 10 位唐代诗人（李白、杜甫、王维、白居易、李商隐、张若虚、孟浩然、王昌龄、高适、杜牧），每位诗人都有完整的人物设定：生平简介、诗风特点、代表作品、AI 角色提示词。学生可以点击了解每位诗人，就像认识新朋友一样。
4、技术特点
- 零依赖：纯 HTML/CSS/JavaScript，打开 `index.html` 就能跑
- 双模式 AI：支持 DeepSeek API（需要配置 API Key），也有完整的本地模拟模式（不需要网络也能体验全部功能）
- 中国古典水墨视觉风格：书法字体、水墨配色、古典动画，本身就是一种文化熏陶
- 作品保存：学生创作的诗会自动保存到浏览器本地，关闭页面也不会丢
四、用 SOLO 实现的过程
整个项目从零开始，完全用 TRAE SOLO 完成。中间踩了不少坑，也深刻体会到了 SOLO 的能力边界和正确用法。
第一步：拆解任务
我没有一上来就让 SOLO “帮我做一个唐诗教学工具”，这种太泛的指令效果很差。我是这样拆解的：
1. 先搭基础框架（HTML 结构 + CSS 样式 + 页面导航）
2. 做诗人数据库和唐诗数据库
3. 做 AI 服务模块（对接 DeepSeek API + 本地模拟）
4. 做诗会模式（多人对话）
5. 做创作模式（一对一协作）
6. 做我的创作（作品保存）
7. 做响应式适配和细节优化
每一步都是一个独立的、可验证的小任务。
第二步：关键 Prompt 示例
搭框架时，我给 SOLO 的指令是：
“创建一个单页应用，包含首页、诗会模式、创作模式三个页面。使用中国古典水墨风格，配色用墨黑、纸色、金色。首页要有标题动画和功能入口。”
做诗人数据库时：
“创建 10 位唐代诗人的数据，每位诗人包含：姓名、字、朝代、诗风、代表作品 5 首、完整的 AI 系统提示词（让 AI 能模仿这位诗人的说话风格）。提示词要包含诗人的性格特点、说话习惯、擅长领域。”
做诗会模式时：
“实现诗会讨论功能：用户选择一首诗和 2-4 位诗人，AI 模拟诗人围绕这首诗展开讨论。每位诗人轮流发言，用户可以随时插话参与。讨论结束后停止，等待用户输入。”
第三步：踩过的坑
**坑一：**诗会模式变成"诗人自嗨"
最初我做的诗会模式是一个无限循环，诗人不停地自动发言，用户完全插不上话，也没有参与感。而且三位诗人一直在刷消息，API 调用费用蹭蹭往上涨。
后来我重新设计成了"回合制"：开场讨论一轮后自动暂停，等用户参与；用户发消息后所有诗人依次回应；用户也可以点"继续讨论"让诗人再聊一轮。这样既节省 token，又让学生真正参与进来。
**坑二：**创作模式的诗句提取不稳定
最初我只用 `「」` 符号来提取诗句，但 AI 有时候会用 `“”` 或者直接换行，导致提取不到诗句，用户看不到"采纳"按钮。
后来我做了三级兜底：先尝试 `「」`，再尝试 `“”`，最后按换行提取类似诗句的行。这样不管 AI 返回什么格式，都能尽量提取出可采纳的诗句。
**坑三：**手机端布局反复出问题
诗人轮播在手机上用了虚拟滚动方案，结果把横向轮播变成了纵向列表，卡片样式全部乱套。折腾了好几轮才改成简单的 grid 布局，有时候最简单的方案就是最好的。
**坑四：**弹窗滚动穿透和状态残留
诗人详情弹窗在手机上滑动时，底部页面也跟着动（滚动穿透）；切换诗人时弹窗的滚动位置没有重置。这些细节问题都是在实际使用中才发现的，逐个修复。
第四步：SOLO 的能力边界
通过这个项目，我对 SOLO 的使用有了几点体会：
1. 任务要拆得足够细：一次只做一件事，做完验证再继续
2. 给够上下文：SOLO 能记住当前会话的代码，每次指令都要说清楚"基于现有代码修改什么"，而不是让它从头来
3. CSS 调试需要耐心：SOLO 对布局问题的判断有时候不够准确，需要反复看截图、描述问题、让它修改
五、成果展示
1、访问地址：https://poetry-ai-three.vercel.app/
2、项目代码：GitHub - sarahxu0205/poetry-ai: 一个让大众沉浸式走近唐诗、与李白杜甫等诗人对话唠诗、共写诗词的国风 AI 交互工具。 · GitHub
3、项目截图：
1）首页：水墨风格标题 + 三大功能入口
2）诗会模式：选择诗词和诗人 → 诗人讨论 → 用户参与
3）创作模式：选择诗人 → 描述场景 → 采纳诗句 → 完成创作
4）我的创作：已保存的诗作列表
5）诗人群像，展示所有诗人信息
4、核心数据
- 10 位唐代诗人：李白、杜甫、王维、白居易、李商隐、张若虚、孟浩然、王昌龄、高适、杜牧
- 16 首经典唐诗：涵盖《春江花月夜》《将进酒》《登高》等初高中必背篇目
- 5 种讨论主题：综合赏析、意境分析、格律探讨、情感解读、比较品评
- 5 种诗歌体裁：五言绝句、七言绝句、五言律诗、七言律诗、自由创作
- 15+ 场景诗句库：春天、秋天、月亮、送别、思乡、酒、山水、爱情、友情等
六、验证方式与下一步
1、已完成的验证
1）功能完整性测试：诗会模式、创作模式、我的创作、诗人详情等全部功能均通过手动测试
2）模拟模式测试：在无 API Key 的情况下，模拟模式能完整体验所有功能
3）响应式测试：在手机端和桌面端分别测试，修复了布局异常问题
4）多轮迭代优化：根据实际使用反馈，修复了诗会交互、诗句提取、弹窗滚动等 10+ 个问题
2、下一步计划
1）扩展诗词库：增加更多唐诗和宋词，覆盖更多教材篇目
2）添加教学辅助功能：如诗歌朗读（TTS）、默写练习、理解力测验等
3）离线部署方案：打包成 PWA 或 Electron 应用，让没有网络的乡村学校也能用
最后想说，我相信 AI 不只是城市里的"效率工具"，它更应该成为乡村课堂里的“新老师”，不是替代人类老师，而是帮老师做那些一个人做起来太费力的事情，让每一个孩子都能感受到唐诗的美。
最后，附SOLO使用截图：
