Earthworm 游戏化连词成句：开源英语练习场，十分钟本地跑起来

Earthworm 游戏化连词成句：开源英语练习场，十分钟本地跑起来

【免费下载链接】earthwormLearning English through the method of constructing sentences with conjunctions项目地址: https://gitcode.com/GitHub_Trending/ea/earthworm

Earthworm 是一款开源的「连词成句」英语学习工具：把完整英语句子拆成单词和短语，你再把它们重新拼回正确句子。它解决的是"背单词记不住、写句子没人批改"的问题——每次拼完立刻知道对错，配合日历式学习记录和排名，让练习变成可以每天打卡的游戏。

Earthworm 安装步骤：最短路径跑起来

前置要求：Node 20+、pnpm 8+，以及本地可用的 Docker（后端依赖 Postgres 和 Redis，都通过 docker-compose 拉起）。

git clone https://gitcode.com/GitHub_Trending/ea/earthworm cd earthworm

pnpm install cp ./apps/api/.env.example ./apps/api/.env cp ./apps/client/.env.example ./apps/client/.env unzip logto_db_init_data.zip -d .volumes/ pnpm docker:start

pnpm db:init pnpm db:upload pnpm dev:serve pnpm dev:client

db:init初始化表结构，db:upload上传内置课程数据（仅首次需要）。浏览器打开后邮箱注册（也支持 GitHub 登录）即可开始。README 里有个小提示：db:init报连接失败，多半是 Docker 刚起还在 running，等几秒重跑一遍即可。

Earthworm 能帮你做什么：按场景看核心能力

• 练造句：进入课程后，系统给出一句完整英文和一组打散的单词/短语，你拼回正确顺序，对错即时反馈。每个元素带音标和中文释义，拼错时能对照着看懂每个词的位置和作用。
• 听力和听写：听力模式要求先听句子再拼写，听写（dictation）模式则让你直接敲键盘作答，两条路分别练耳朵和拼写。
• 滚动复习：你学过的内容会被拆散、混进后面的课程里反复出现，相当于自动安排复习；学透的元素可以标记为 mastered，减少干扰。
• 学习数据可视化：首页有日历式学习图和累计学习时长，rank页面展示学习排名，课程完成后还能生成一张分享卡片图。
• 自定义课程：内置「零基础英语」「高考写作课程」「小猪佩奇（第一季）」等 55 个课程包，也可以用自己的材料上传课程。

课程数据在packages/xingrong-courses/data/courses/，每个课程包就是一个含中文、英文、音标字段的 JSON 文件；改完数据用pnpm db:update同步进数据库。

Earthworm 适合谁、不适合谁

• 适合：靠自觉背单词容易放弃、需要即时反馈推着走的人；零基础学习者（第一个课程包真的从 I / like / the food 这种词组起步）；想给孩子定制学习内容再一起玩的家长；想加课程或加功能、愿意读源码的开发者。
• 不适合：只想注册即用的人——文档主线是本地自部署，你得自己装 Docker、配 .env、初始化数据库；期待它覆盖完整英语大纲的人——内容边界就是内置课程包加你上传的；需要开箱即用完整账号体系的人——认证基于 Logto，文档也提供了手动配置的替代方案（config-logto.md）。另外官方说明项目未来会转向订阅制，编辑端无限制上传等内容会放在会员体系里。

Earthworm 技术选型速览

前端是 Nuxt 3（Vue 3）+ Pinia + Tailwind CSS，测试用 Vitest 和 Cypress；后端是 NestJS，Drizzle ORM 连 Postgres，Redis 做缓存与会话，认证走 Logto。整体用 pnpm workspace 管理 api、client、db、schema、xingrong-courses 等子包，Docker Compose 一键拉起数据库和认证服务。

如何参与 Earthworm 开发

贡献流程见 packages/docs/contribution/：Fork 后建功能分支（feat/xxx、fix/xxx），提 PR 等维护者合并。提交前记得跑测试：前端在 apps/client 下执行pnpm test:unit:run，后端在 apps/api 下执行pnpm test:unit，README 的「关于测试」一节有完整命令。

本地 Docker 环境齐的话，上面几条命令就能把完整的学习页面跑起来。挑一个零基础课程包做几道拼句，就能判断这种连词成句的练法合不合你的习惯。

【免费下载链接】earthwormLearning English through the method of constructing sentences with conjunctions项目地址: https://gitcode.com/GitHub_Trending/ea/earthworm