【qwerty-learner】开源下载和安装教程

1、项目介绍

Qwerty Learner 是一款为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件。通过将英语单词记忆与键盘输入训练结合，帮助用户提升打字速度和单词拼写准确率。项目基于 React 开发，支持多词库（如 CET-4/6、GRE、TOEFL 等）和编程语言 API 练习。

2、项目下载位置

• 主仓库：GitHub RealKai42/qwerty-learner
• 镜像仓库：
  • GitCode RealKai42/qwerty-learner
  • Gitee KaiyiWing/qwerty-learner

3、项目安装环境配置

需提前安装以下环境：

• NodeJS（推荐 LTS 版本）
• Git
• Yarn

验证环境是否就绪：

node --version
git --version
yarn --version

示例截图（以 Windows 为例）：

> node --version
v18.12.1
> yarn --version
1.22.19

4、项目安装方式

手动安装步骤

1. 克隆仓库：

   git clone https://github.com/RealKai42/qwerty-learner.git
   

2. 进入项目目录：

   cd qwerty-learner
   

3. 安装依赖：

   yarn install
   

4. 启动项目：

   yarn start
   

5. 浏览器访问 http://localhost:5173

脚本安装（Windows）

1. 在项目 scripts 目录执行：

   .\install.ps1
   

脚本安装（MacOS）

1. 在项目根目录执行：

   scripts/install.sh
   

5、项目处理脚本

• pre-check.ps1/pre-check.sh：环境预检查脚本
• install.ps1/install.sh：一键安装脚本
• 脚本会自动检测并安装缺失的依赖项（如 NodeJS、Yarn）。

示例脚本输出：

[INFO] 检测到缺少 NodeJS，正在通过 winget 安装...
[SUCCESS] 所有依赖已就绪，开始构建项目...