# 打字大师

**Repository Path**: hiczz/typing-trainer-app

## Basic Information

- **Project Name**: 打字大师
- **Description**: 一款让你从零入门快速打字的便携式APP，无需任何环境
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-10-17
- **Last Updated**: 2026-10-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ⌨️ 打字大师 - Typing Trainer

> 一个基于 Electron + React 的跨平台打字训练桌面应用，使用QwenCode生成，帮助单指打字用户重塑指法，提升打字速度。

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Gitee](https://img.shields.io/badge/Gitee-typing--trainer--app-blue)](https://gitee.com/zkyczz/typing-trainer-app)

---

## 下载链接
通过网盘分享的文件：typing-trainer
链接: https://pan.baidu.com/s/1Vk1rPDA5eRnKleRRSxiFJw?pwd=CZZZ 提取码: CZZZ 
--来自百度网盘超级会员v7的分享


![效果图](image.png)





## 📂 目录结构说明

本项目采用 **源码与发布版分离** 的结构，方便不同角色的用户使用：

```text
typing-trainer/
├── 📦 release/              # 📥 发布目录：存放打包好的 Windows 可执行文件
│   └── TypingTrainer-win32-x64/
│       └── TypingTrainer.exe  <-- 双击即可运行，无需安装环境
├── 💻 source/               # 💻 源码目录：存放所有开发源代码与配置
│   ├── src/                 # React 源码
│   ├── main.cjs             # Electron 主进程
│   ├── package.json         # 依赖配置
│   └── vite.config.ts       # Vite 构建配置
├── 📖 README.md             # 📄 本文件：项目总览与使用指南
├── 📦 打包说明.md           # 🛠️ 详细指南：如何构建与打包 exe
└── 📝 项目清单.md           # 📋 清单：项目文件索引与检查表
```

---

## ✨ 核心功能

- 🎯 **渐进式训练**：从基准键位 (ASDF) 到单词、句子实战，科学进阶。
- 🎮 **虚拟键盘**：实时高亮显示按键，颜色编码区分 10 根手指，告别“盲打”焦虑。
- 🏆 **成就系统**：连击 (Combo)、准确率徽章、动态鼓励语，让练习不再枯燥。
- 📊 **数据追踪**：实时 WPM (每分钟字数) 监控，错误率分析，本地持久化记录。

---

## 🚀 快速开始

### 👤 普通用户（直接使用）`不要删除release中的任何文件`

1. 进入 `release/TypingTrainer-win32-x64` 目录。
2. 双击运行 `TypingTrainer.exe`。
3. **无需安装** Node.js 或任何运行环境，开箱即用！

### 👨‍💻 开发者（二次开发）

1. 进入 `source/` 目录。
2. 安装依赖：
   ```bash
   npm install --legacy-peer-deps
   ```
3. 启动开发服务器：
   ```bash
   npm run dev
   ```
4. 浏览器将自动打开 `http://localhost:3000` 预览界面。

---

## 🛠️ 构建与打包

如果你想重新生成 Windows 可执行文件，请参考 [打包说明.md](打包说明.md)。

**快速命令：**
```bash
cd source
npm run build
npx electron-packager . TypingTrainer --platform=win32 --arch=x64 --out=../release --overwrite
```

---

## 📦 部署与仓库

本项目托管于 Gitee，欢迎 Star 和 Fork！

- **仓库地址**：[https://gitee.com/zkyczz/typing-trainer-app](https://gitee.com/zkyczz/typing-trainer-app)
- **上传指南**：详见 [项目清单.md](项目清单.md) 中的部署章节。

---

## 📄 许可证

MIT License © 2026 TypingTrainer

---

**开始你的打字提升之旅吧！** 🚀