用 TRAE SOLO 从零搭建一套完整的古诗词文言文复习系统，覆盖小升初·中考·高考

SOLO挑战赛专区
1

# 【Code With SOLO】用 TRAE SOLO 从零搭建一套完整的古诗词文言文复习系统，覆盖小升初·中考·高考

## 1. 摘要

用 TRAE SOLO 从零搭建了一套完整的古诗词文言文复习系统，涵盖 **192 篇诗词文言文**、**7 个互动学习工具**、**3 个知识百科页面**，并打包为 Android APP。原本需要团队数周开发的工作，一个人用 AI 对话式编程在几天内完成。

## 2. 背景

我是一名家长，孩子正在上小学，马上面临升学的压力，需要系统复习古诗词和文言文。市面上的古诗词 APP 要么内容不全，要么功能单一，要么需要付费订阅，很难找到一个既免费又全面的工具。

我希望做一个 **免费的、内容全面的、覆盖小升初到高考的复习工具**，让孩子能随时随地复习古诗文。

### 面临的具体挑战

- :books: **数据分散**：古诗词和文言文数据散落在课本、教辅、网络各处，需要系统整理

- :bullseye: **学段差异大**：小学、初中、高中不同学段的复习需求完全不同，需要分类管理

- :brain: **学习方式多样**：需要浏览、闪卡、填空、默写、测试等多种学习方式

- :mobile_phone: **移动端适配**：孩子主要用手机学习，需要适配手机端使用

作为一个非程序员，这些挑战看起来几乎不可能完成。但 TRAE SOLO 改变了这一切。

## 3. 实践过程

### 3.1 任务拆解

我将整个项目拆解为以下几个阶段，循序渐进地推进：

| 阶段 | 内容 | 说明 |

|------|------|------|

| :one: 数据层 | 整理 192 篇诗词文言文数据 | 含原文、注释、赏析，按学段和朝代分类 |

| :two: 浏览层 | 按朝代、学段分类的诗词浏览页面 | 22 个分类页面，方便查找和浏览 |

| :three: 工具层 | 闪卡记忆、填空挑战、挖空默写、模拟测试 | 7 个互动学习工具 |

| :four: 知识层 | 知识百科、考试攻略、速查手册 | 3 个知识百科页面 |

| :five: 适配层 | 打包为 Android APP | 完全离线，无需网络 |

### 3.2 使用 SOLO 的能力

在整个开发过程中，SOLO 展现了非常全面的能力：

- :laptop: **代码生成**：自动生成 HTML/CSS/JS 页面和 Android 项目文件，代码质量高、结构清晰

- :bar_chart: **数据处理**：批量添加 166 首诗词 + 26 篇文言文的结构化数据，包括原文、注释、赏析、学段标签等

- :bug: **Bug 修复**：快速定位并修复中文输入法兼容问题、卡片翻转偏移、链接错误等各种 Bug

- :counterclockwise_arrows_button: **功能迭代**：根据测试反馈快速添加筛选器、新页面、新功能，响应迅速

- :package: **打包部署**：生成 Android Studio 项目并配置国内镜像，解决网络访问问题

### 3.3 关键操作过程

整个开发过程就像和一个经验丰富的开发者对话。只需要用自然语言描述需求，SOLO 就能自动生成代码：

> :speaking_head: “创建一个诗词闪卡页面，支持按学段和来源筛选”

SOLO 立刻生成了一个带有翻转动画的闪卡页面，支持多维度筛选。

> :speaking_head: “挖空默写时中文输入法会跳到下一个空，需要修复”

SOLO 通过添加 `compositionstart`/`compositionend` 事件监听，完美解决了拼音输入过程中的误触发问题。

> :speaking_head: “把文言文也加入系统，分为小学、初中、高中”

SOLO 扩展了数据结构，新增了 26 篇文言文，并为每个学段创建了独立的浏览页面。

> :speaking_head: “增加考试攻略页面，包含小升初、中考、高考的考点总结”

SOLO 生成了详细的考试攻略页面，包含考点梳理、答题模板、易错字总结和备考规划。

> :speaking_head: “打包生成 Android 安装文件”

SOLO 创建了完整的 Android Studio 项目，配置了 WebView 和国内镜像，生成了可安装的 APK 文件。

**每次只需描述问题，SOLO 就能理解上下文并给出解决方案。** 这种开发体验对于非程序员来说，简直是降维打击。

### 3.4 踩过的坑

开发过程中也遇到了不少问题，但 SOLO 都一一解决了：

#### :cross_mark: 坑 1：中文输入法兼容

**问题**：默写练习中，使用拼音输入法输入汉字时，拼音字母的输入过程就触发了跳转到下一个空，导致无法正常输入。

**解决**：SOLO 通过添加 `compositionstart` / `compositionend` 事件监听，在中文输入法组合期间禁止跳转，完美解决。

#### :cross_mark: 坑 2：卡片翻转偏移

**问题**：CSS 3D 翻转动画在 flex 布局中产生了位移，卡片翻转后位置错乱。

**解决**：SOLO 放弃了 CSS 3D 翻转方案，改用 JS 切换显示/隐藏的方式，彻底解决了偏移问题。

#### :cross_mark: 坑 3：Gradle 下载超时

**问题**：国内网络无法访问 Google 的 Maven 仓库，导致依赖下载失败。

**解决**：SOLO 将所有仓库地址替换为腾讯云和阿里云镜像，下载速度飞快。

#### :cross_mark: 坑 4：Gradle 版本不兼容

**问题**：Java 21 与 Gradle 8.0 不兼容，构建时报错。

**解决**：SOLO 升级到 Gradle 8.5 + AGP 8.2.0，兼容性问题顺利解决。

#### :cross_mark: 坑 5：仓库冲突

**问题**：`settings.gradle` 和 `build.gradle` 中重复声明了仓库地址，导致构建警告。

**解决**：SOLO 删除了 `build.gradle` 中的 `allprojects` 块，统一在 `settings.gradle` 中管理仓库。

-–

## 4. 成果展示

### 最终产出

一个完整的古诗词文言文复习系统，包含丰富的内容和强大的功能。

### :open_book: 数据规模

- **192 篇内容**：166 首诗词 + 26 篇文言文

- **覆盖 3 个学段**：小学、初中、高中

- **每篇包含**：完整原文、详细注释、赏析

### :hammer_and_wrench: 7 个互动学习工具

| 工具 | 功能描述 |

|------|----------|

| :joker: 诗词闪卡 | 正反面翻转记忆，支持学段/朝代/来源/类型四维筛选 |

| :pencil: 填空挑战 | 根据上下文填写诗句，三个难度等级（简单/中等/困难） |

| :memo: 挖空默写 | 逐字默写，完美支持中文输入法，实时反馈对错 |

| :clipboard: 模拟测试 | 选择题 + 填空题 + 赏析题，模拟真实考试体验 |

| :label: 主题分类 | 按主题浏览（送别、思乡、爱国、边塞等），可点击跳转详情 |

| :balance_scale: 对比阅读 | 两首诗词并排对比，支持选择任意诗词进行对比 |

| :bust_in_silhouette: 诗人故事 | 诗人生平时间线，了解诗人背后的故事 |

### :books: 3 个知识百科页面

| 页面 | 内容概要 |

|------|----------|

| :open_book: 知识百科 | 诗词发展史、体裁分类（诗/词/曲/赋）、文学流派、文言文基础知识 |

| :bullseye: 考试攻略 | 小升初/中考/高考考点梳理、答题模板、易错字总结、备考时间规划 |

| :magnifying_glass_tilted_left: 速查手册 | 诗词格律速查、18 个文言虚词、32 组通假字、16 组古今异义，支持搜索 |

### :bookmark_tabs: 22 个浏览页面

**按朝代分类：**

- 先秦两汉魏晋

- 唐诗（上）

- 唐诗（下）

- 宋词宋诗

- 元明清

**按学段分类：**

- 小学必背 75 首

- 初中必背古诗文

- 高中必背古诗文

- 文言文阅读（小学/初中/高中）

### :mobile_phone: Android APP

- :white_check_mark: **完全离线运行**，无需网络连接

- :white_check_mark: **底部导航栏**：主页、复习工具、知识工具、文言文

- :white_check_mark: **支持返回键导航**，操作体验流畅

- :white_check_mark: **最低支持 Android 5.0**，覆盖绝大多数手机

### :wrench: 技术栈

| 技术 | 说明 |

|------|------|

| 前端 | 纯 HTML + CSS + JavaScript（无框架依赖，轻量高效） |

| 数据 | 本地 JSON + API 封装（结构化数据管理） |

| 移动端 | Android WebView 包装（原生体验） |

| 开发工具 | TRAE SOLO（全程 AI 对话式编程） |

## 5. 效果与总结

### :chart_increasing: 提效数据

| 指标 | 数据 |

|------|------|

| 传统开发预估 | 2-4 周（前端 + 数据整理 + 移动端适配） |

| 实际用时 | 约 3-4 天（利用碎片时间） |

| **提效倍数** | **约 10 倍以上** |

### :robot: SOLO 在流程中的角色

SOLO 承担了整个开发流程中的核心工作：

1. **需求理解** :bullseye:：通过自然语言对话，准确理解功能需求，不需要写任何技术文档

2. **代码生成** :laptop:：自动生成高质量的 HTML/CSS/JS 代码，结构清晰、可维护性强

3. **数据处理** :bar_chart:：批量处理 192 篇古诗文的结构化数据，效率极高

4. **问题排查** :magnifying_glass_tilted_left:：快速定位和修复各种 Bug，从中文输入法到构建配置

5. **持续迭代** :counterclockwise_arrows_button:：根据反馈快速添加新功能和优化体验，响应迅速

### :light_bulb: 可复用的方法

如果你也想用 AI 工具从零开发一个项目，这里有几个经验分享：

1. **对话式开发** :speech_balloon:：用自然语言描述需求，让 AI 理解并实现。你不需要会编程，只需要会说清楚"我想要什么"。

2. **分阶段迭代** :antenna_bars:：先做核心功能（数据 + 浏览），再逐步完善（工具 + 知识 + APP），每一步都可以验证和测试。

3. **数据驱动** :card_index_dividers:：先整理好数据结构，再基于数据构建功能。好的数据结构是项目成功的基础。

4. **测试驱动优化** :test_tube:：实际使用中发现问题，及时反馈修复。让孩子试用，收集真实的使用反馈。

### :glowing_star: 思考

AI 编程工具最大的价值不是替代程序员，而是 **让非专业人员也能把想法变成产品**。

作为一名家长，我从未想过自己能开发一个 APP。但 TRAE SOLO 让这成为了现实——从数据整理到页面开发，从 Bug 修复到 APP 打包，整个过程就像和一个经验丰富的开发者对话，你只需要说"我想要什么"，它就能帮你实现。

这种开发模式特别适合教育类工具——因为 **最了解学生需求的是家长和老师，而不是程序员**。AI 让需求方直接成为开发方，大大缩短了从"想法"到"产品"的距离。

如果你也有类似的想法，不妨试试 TRAE SOLO。也许下一个改变教育的产品，就出自你手。

:pushpin: **项目关键词**：古诗词复习、文言文学习、小升初、中考、高考、AI 编程、TRAE SOLO、对话式开发、Android APP