企业官网建设流程全解析

把英语句子"拼"出来：Earthworm 连词成句学习工具的本地部署指南

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

英语常卡在"会认不会用"。Earthworm 是一款开源英语学习工具，它把句子拆成单词和短语，让你把词重新拼回正确句子，配合 i+1 理论和游戏化机制，把死记硬背变成能坚持下来的练习。这篇文章先讲清楚它怎么学，再给你一套本地跑起来的步骤。

先搞懂玩法：连词成句比"重排单词"多一点东西

这一节帮你判断它和背单词卡片的区别在哪。

打开 课程数据目录，以第 1 课为例：内容从 "I"、"like" 开始，逐步长成 "I like"、"I like the food"，再到 "I don't like the food"。你不是在孤立背词，而是在短语和句子里看每个词该站什么位置——语法结构是拼出来的，不是背出来的。

练习目前有两种模式（定义在 gamePlayMode.ts）：

• 中译英：给出中文意思，你把词组拼成正确的英文句子，这是最基础的玩法，答错立刻知道错在哪。
• 听写：句子读出来，你按听到的内容拼写，专门补听力短板。

另外有个容易被忽略的设计：复习。学过的内容会被拆分进后续课程里反复出现，相当于天然的间隔重复，不用你自己安排回顾。

本地跑起来的 5 个步骤

这一节直接给可复制的命令，跑完打开浏览器就能用。前置要求：Node.js ≥ 20、pnpm ≥ 8、Docker。

1. git clone https://gitcode.com/GitHub_Trending/ea/earthworm && cd earthworm—— 拿到源码
2. pnpm install—— 安装全部依赖
3. 复制配置：cp ./apps/api/.env.example ./apps/api/.env和cp ./apps/client/.env.example ./apps/client/.env—— 前后端各一份环境变量
4. unzip logto_db_init_data.zip -d .volumes/再pnpm docker:start—— 准备注册系统数据，并启动 Postgres、Redis 服务
5. pnpm db:init && pnpm db:upload—— 建表，并首次上传内置课程数据
6. 两个终端分别pnpm dev:serve、pnpm dev:client—— 起后端和前端，浏览器打开本地地址，邮箱注册后即可开始 🎮

命令本身不复杂，卡住时看 根目录 README 的 FAQ 一节，数据库连接、权限类问题基本都有现成答案。

如果你是……

按你的实际情况对号入座，不用全看：

• 词汇还行但写句子别扭：用中译英模式，词序和结构的问题会当场暴露，即时反馈比等老师批改快得多。
• 听力跟不上：听写模式让耳朵和手一起练。
• 纯零基础：从"零基础英语"课程开始，按 i+1 的思路只在你水平之上加一点难度，不会一上来就被劝退。
• 有特定材料需求：支持自定义上传课程，工作用语、喜欢的剧集内容都可以变成练习。

内置课程目前有零基础英语、高考写作课程和小猪佩奇（第一季），文档在 packages/docs/。

技术构成与参与方式

这一段点到为止，方便你评估代码质量和维护成本。

• 前端：Nuxt（Vue）+ Pinia，游戏逻辑拆在 composables 里，单元测试覆盖较全
• 后端：NestJS，模块划分清晰，带 Jest 单测与端到端测试
• 数据与部署：PostgreSQL + Redis，Docker Compose 一键拉起

项目以 GNU AGPL-3.0 协议开源（见 LICENSE）。想参与的话，贡献指南 从 Fork 到提 PR 有完整图文流程；提交前跑一遍对应模块的测试，比如 course-pack 测试，就能少走很多弯路。

下一步很简单：按上面的步骤把项目跑起来，明天的第一组连词成句，就是你的入门练习。

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