连词造句学英语的开源练习平台:Earthworm

背单词列表、刷语法题、看剧跟读,这些路子很多人都试过,真正被跳过的往往是最不起眼的一层:句子和句子之间该用什么词接起来。写出来的英文单词都对,读起来却像几块砖硬拼在一起,问题常常不在词汇量,而在连词。Earthworm 把切口收得很窄,它不做大而全的英语课程,只把练习压缩成一件小事,让你在两个短句之间挑一个合适的连词,把它们接成一句自然、语义成立的英文,接对了才继续往下走。项目以开源仓库的形式发布,前端、后端、数据库结构、容器编排脚本和课程数据导入流程都摆在明面上,想自己跑一份、改一份、或者搬进教室和团队内部用,都不必先谈授权。对既想练英语、又想看看一个完整全栈项目怎么搭起来的人来说,它同时给了两样东西:一个可以长期用的练习工具,和一份能从头读到底的工程样本。

Earthworm是什么?

Earthworm 是一个开源的英语练习项目,主要用来通过连词造句的方式训练句间连接与表达逻辑,服务于想提升写作和口语连贯度、同时希望自己能部署一套练习环境的学习者与开发者。它的学习目标非常克制:不铺词汇量,也不堆语法术语,只让你在两个短句之间挑一个合适的连词,把它们拼成一句语义通顺的英文,选错就重来。题目以课程为单位组织,练完一节进下一节,进度是看得见的。技术侧它没有做成一个单页小玩具,而是前端、后端、关系型数据库、缓存和容器编排都齐备的完整工程,仓库里同时给出了环境要求、配置说明、测试说明和前端开发规范,读起来更像一个可以直接照抄结构的中后台项目。

Earthworm 项目卡片

核心功能

  • 连词造句练习——把两个短句拼成一句完整的英文,练的是句间关系而不是单词记忆,练一次就有一句能直接用的表达。
  • 即时判题与反复重做——选项点下去马上知道对错,错了可以接着试,不需要等谁批改,也不会因为怕出错而不敢动笔。
  • 课程数据导入流程——仓库自带课程数据的创建与上传步骤,服务装好之后按顺序跑一遍就有题可练,不用先手工造题库。
  • 中英双语界面——界面同时提供英文与中文两套文案,中文用户不必先过语言关才能上手,读题和操作都更省力。
  • 容器化依赖管理——数据库与缓存都由 Docker 承担,起停用仓库里配好的脚本一条命令解决,省掉逐个安装和版本对齐的麻烦。
  • 独立后台管理入口——题库和课程数据有单独的管理端,内容维护和练习页面分开,运营方可以自己往里加课,不必改代码。
  • 前端约定与测试说明——仓库里有成文的前端开发规范,把状态管理、路由归类和测试边界都写清楚了,多人协作时少踩反应式丢失那类坑。
  • 活跃的社区协作记录——设有贡献指南与星标历史小节,外部开发者能顺着说明找到可以下手的位置,项目不是一次性放出来的快照。
Earthworm 首页截图

使用场景

练英语和读代码是两拨人,落到具体场景里差别不小。下面按角色拆一下它更适合谁:

人群/角色场景描述推荐指数
英语自学者每天抽出十几分钟做连词造句,专门治写作文时句子之间接不上的毛病★★★★☆
英语老师在自己机器上部署一套,课上让学生轮流拼句,比空讲语法点直观得多★★★★☆
前端学习者完整的前后端加容器编排,拿来读代码、学工程分层与部署流程★★★★☆
小团队内部培训私有环境里跑一份,题库自己维护,训练内容不依赖外部账号★★★☆☆
开源贡献者贡献指南、测试说明、前端规范都齐全,容易找到合适的切入位置★★★★☆

操作指南

整个流程按仓库给出的顺序走最稳,跳步是绝大多数失败的来源:

  1. 先对齐环境:Node.js 用仓库 .node-version 里指定的版本,包管理器用 8 以上的 pnpm,另外准备 Docker,以及 14 以上的 Postgres 和 5 以上的 Redis。版本对不上,后面每一步都会跟着报错。
  2. 拉下仓库后,在项目根目录执行依赖安装。用 VSCode 打开项目时它会提示安装 extensions.json 里推荐的扩展,装上可以少掉一堆格式与类型提示上的干扰。
  3. 配置后端:把 apps/api 目录下的配置样例文件复制成正式配置,按自己的数据库地址、账号、端口和密钥改一遍。后端启动时会从这份文件读取连接信息,样例里的值只是占位。
  4. 还原后台数据:把 logto 的初始化数据压缩包解到 .volumes/ 目录下。这一步跳过后台管理端的账号是空的,会出现页面能开但登录不进去的情况。
  5. 起容器服务:用 package.json 里配好的脚本拉起 Postgres 与 Redis,需要手动时也可以直接用仓库给出的命令。Windows 上如果编译时中文显示成乱码,先在命令提示符里执行 chcp 437 再重跑安装。
  6. 初始化数据库结构与课程数据,两条命令之间留一点间隔,上一条刚把服务挂到后台,容器可能还没完全就绪,报错了重跑一次通常就好。
  7. 最后把前后端分别启动,练习页面和后台管理端各占一个端口,浏览器打开就能开始练。不想折腾环境的,可以先点 立即使用 看看项目主页,或者直接访问 Earthworm 读原始说明。

支持平台

事实里能确认的形态是 Web 端:前端页面加后端服务,通过浏览器访问,服务跑在自己的机器或容器里,依赖的数据库和缓存也由容器提供。部署方式上给出了 Docker 编排与手动命令两条路,桌面客户端、移动 App、小程序、浏览器插件这几类,站方没有明确列出。也就是说,它现在是一个需要先把服务拉起来再用的网页应用,而不是装完就能双击打开的客户端。对个人来说这意味着要过一道环境配置的关,对团队来说反而方便,服务放在哪里、数据存在哪台机器上都可以自己决定。

产品定价

站方未公开价格信息,以站内为准。项目以公开仓库的形式分发,代码可以自行获取并部署到自己的环境里,练习过程没有出现账号订阅、按次计费或功能分档这类设计。对个人学习者,本地跑一份就够用;要在教室或团队里铺开,成本主要落在自己维护的数据库、缓存和容器环境上,而不是软件本身。换句话说,需要先算的是环境与运维的账,而不是一份订阅的账。

常见问题

Q:不会写代码的人能不能直接用?

要分两种用法看。只想练英语的话,仍然需要有人在本地把服务跑起来,这一步涉及命令行、配置文件和 Docker,确实要一点动手能力,目前还没有那种打开网页就能注册开练的形态。想读代码、改功能的话,仓库里把环境要求、配置步骤和前端规范都写全了,按顺序走下来基本能跑通,卡住的位置通常集中在数据库配置和后台数据还原这两步。

Q:依赖装完了,页面能打开但后台登录不进去是什么原因?

最常见的原因是后台的初始化数据没有还原。仓库的步骤里明确要求把 logto 的初始化数据压缩包解到 .volumes/ 目录下,跳过这一步后台账号就是空的。其次要检查配置样例复制出来的正式配置文件,数据库地址、端口、账号只要有一项还是占位值,后端就读不到数据,登录自然走不通。

Q:Windows 上编译时中文全是乱码怎么办?

仓库的说明里给了现成的办法:在命令提示符里执行 chcp 437 切换代码页,然后重新跑一遍安装命令。这是终端编码与脚本输出之间的错位,不影响代码本身,也不需要改任何源文件。

开发者小结

这套东西的取舍很清楚:把学习目标压到连词造句这一件事上,换来的是练习路径短、反馈快、不容易半途放弃;代价是它不当背单词工具,也替代不了系统的语法课,想要全面提升还得另找材料。工程侧的取舍同样明显,前端、后端、Postgres、Redis、Docker 一样不少,换来的是一个能直接拿去读、拿去改的完整样本,代价是环境门槛不低,Node.js 与 pnpm 的版本要求偏新,容器没起好或者后台数据没还原,就会停在第一步。所以它适合两类人:一类是愿意花半小时把环境搭起来、之后长期练句间连接的学习者,一类是想看一个真实全栈项目怎么分层、怎么测试、怎么部署的开发者。如果你要的是装上就能用、打开就有人带着念的产品,现阶段的形态还差点意思;如果你能接受自己动手,它给的东西比大多数练习类项目都实在。

© 版权声明

相关文章

暂无评论

您必须登录才能参与评论!
立即登录
none
暂无评论...