开源本地打字练习软件：Qwerty Learner – 离线免费，支持英语词库

一、特点：离线运行，开源免费

词库

内置了常用的 CET-4 、CET-6 、GMAT 、GRE 、IELTS 、SAT 、TOEFL 、考研英语、专业四级英语、专业八级英语，也有程序员常见英语单词以及多种编程语言 API 等词库。 尽可能满足大部分用户对单词记忆的需求，也非常欢迎社区贡献更多的词库。

音标显示、发音功能

方便用户在记忆单词时，同时记忆读音与音标。

默写模式

在用户完成一个章节的练习后，会弹出选项是否默写本章，方便用户巩固本章学习的单词。

速度、正确率显示

量化用户输入的速度和输入的正确率，让用户有感知的了解自己技能的提升

二、本地安装

运行环境

1.NodeJS
2.Git
3.Yarn

验证是否已经拥有相关环境

1. 手动验证
   请在命令行下执行以下命令，查看是否有对应版本输出

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

2.脚本验证
使用提供的脚本对所需环境进行验证，如果确实依赖项会自动安装

• Windows 用户可以直接执行 pre-check.ps1 脚本
• MacOS 用户可以直接执行 pre-check.sh 脚本

如果有对应环境缺失，我们可以参考下列官方文档进行安装

• NodeJS
• Git
• yarn

手动安装

1. 在命令行中执行 git clone https://github.com/RealKai42/qwerty-learner.git 将项目拉取到本地, 如果不使用 git 可能因为缺少依赖而无法运行
2. 在命令行中执行 cd qwerty-learner，进入项目根目录，执行yarn install来下载依赖。
3. 执行yarn start来启动项目，项目默认地址为http://localhost:5173/
4. 在浏览器中打开http://localhost:5173/来访问项目。

脚本执行

对于 Windows 用户，可以直接执行 install.ps1 脚本，来一键安装依赖并启动项目。

1. 打开 powershell，定位到项目根目录中的scripts目录
2. 在命令行中，执行.\install.ps1
3. 等待脚本完成。

备注 脚本依赖winget来安装 node，仅在 Windows 10 1709（版本 16299）或更高版本上受支持！

对于 MacOS 用户，可以直接执行 install.sh 脚本来一键安装依赖并启动项目

1. 打开终端，并进入此项目文件夹
2. 在命令行中执行 scripts/install.sh
3. 等待脚本完成

此脚本依赖于 homebrew，请确保自己电脑上可以执行brew命令

Docker Compose安装

services:
 qwerty-learner:
  image: ginuerzh/qwerty-learner:latest
  container_name: qwerty-learner
  ports:
   - "5173:5173"

然后浏览器中输入 http://你服务器的IP:5173 就能看到界面

本机运行自建批处理启动文件

你可以在文本编辑器（如记事本）中输入以下代码，然后将文件保存为带有 .bat 扩展名的文件，例如 run_project.bat：

@echo off
cd /d %~dp0qwerty-learner
start "Yarn Start" cmd /k yarn start
timeout /t 5
start http://localhost:5173/

此批处理文件应放置在 “qwerty-learner” 目录的父目录中。例如，如果项目位于 C:\Projects\qwerty-learner，则批处理文件应保存为 C:\Projects\run_project.bat。然后右键点击以管理员运行。