# EnglishTrainer

**Repository Path**: IgnatiusGL/english-trainer

## Basic Information

- **Project Name**: EnglishTrainer
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-07-01
- **Last Updated**: 2026-07-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# English Trainer

一个披着聊天软件外衣的英语训练工具。没有课程广告，没有打卡群，也不会突然播放一段响彻办公室的英语听力。

它尤其适合工作间隙使用：界面低调，操作以键盘为主，几分钟就能完成一组练习。等接口、等编译、等会议开始时都可以顺手写两句，让摸鱼从“刷新网页”升级为“提升英语水平”。当然，老板走到身后时请保持镇定——你确实在学习。

## 它能做什么

- **i+1 循序渐进**：每轮 32 题，从单词、短语和简单句开始，每次只增加一个主要知识点，再逐步进入扩句与句型变式。
- **在上下文中真正学会表达**：题目围绕连续生活场景展开，核心词和句型会多角度重复，并在后续题目中间隔召回，减少“看着认识、轮到自己就不会”的情况。
- **根据真实表现自动调整难度**：系统按完整一轮统计错误提交率，记录每次错误和重试过程。错误提交率稳定时逐步摸底，明显升高时同时降低语法与词汇难度，不会因最后几题的短期波动突然降级。
- **Codex 个性化生成题库**：一轮结束后，Codex 会分析已完成题目、所有错误输入和薄弱点，生成下一轮有针对性的练习内容。
- **逐条讲清薄弱知识点**：评估完成后，Codex 会把真实错误归纳成独立的短消息，逐个说明错因、规则和贴近原题的正确示例，再由老师开始下一轮出题。
- **持续评估英语输出能力**：由 Codex 按 0–1000 分统一评估实际中译英能力；1000 分对标顶尖翻译官、同传或专家译者，而不是“背完十个单词奖励一百分”。
- **专注纠正真正不会的部分**：错误单词会被定位并保留完整错误记录；连续卡住时可以查看答案，之后的新题还会从更基础的前置表达重新搭建。
- **可管理的 Codex 消息历史**：发送给 Codex 的历史消息可逐条折叠和复制，复制成功后按钮会即时显示对勾。
- **适合碎片时间和办公室低调练习**：聊天式界面不抢眼，全程可用空格、回车和方向键快速操作。一两分钟也能练几题，随时停下，进度不会丢。
- **本地保存与多主题**：练习进度和错题记录保存在本机，并提供暗色、亮色、粉色和蓝色主题。英语水平需要慢慢练，摸鱼皮肤可以随时换。

## 直接运行免安装版

支持环境：

- Windows 10/11 64 位。
- 解压后至少预留约 500 MB 空间。
- 更新自适应题库需要本机安装并登录 Codex CLI，且 `codex` 命令位于 `PATH` 中。
- 调用 Codex 时需要可用网络；应用使用 Codex CLI 的本机登录状态和默认模型，不会在项目中保存 API Key。

使用步骤：

1. 解压 `English Trainer 1.1.0 Portable.zip`。
2. 双击 `English Trainer.exe`。
3. 开始答题。不会的词可以错，应用会记住；希望你的老师没有这么好的记性。

检查 Codex CLI 是否可用：

```powershell
codex --version
```

如果 Codex 暂时不可用，首轮内置题库仍可正常练习；完成一轮后更新题库会在聊天区域显示错误信息和重试按钮，不会偷偷拿一套本地题库糊弄你。

## 源码开发环境

- Node.js 20+
- npm
- 已安装并登录的 Codex CLI
- Windows、macOS 或 Linux 均可进行前端开发；当前发布包针对 Windows x64

```powershell
npm install
npm run dev
```

## 构建

只构建前端：

```powershell
npm run build
```

生成解压即用的应用目录：

```powershell
npm run pack
```

生成 Windows 安装程序：

```powershell
npm run dist
```

构建产物位于 `release` 目录。首次打包可能需要下载 Electron 组件；如果网络不配合，它通常不是代码坏了，只是 GitHub 又在和你的网络进行跨国冷战。