/everyone-can-use-english

人人都能用英语

Primary LanguageTypeScript

人人都能用英语

中文 | English

目录


Enjoy App

* 开发者

本地启动

yarn install
yarn start:enjoy

编译

yarn make:enjoy

* 普通小白用户

方法一:最直接简单的方法是去 releases 页面下载相应的安装文件。

如果你需要详细下载操作指导点这里

Tip

如果你是普通用户,并不想为本项目提供代码,按上面的操作就可以正常使用 Enjoy APP !

方法二:如果想要随时试用更新版本的话,请按以下步骤操作。

MacOS 用户

  1. 打开命令行工具 Terminal

  2. 安装 Homebrew(请参阅这篇文章:《从 Terminal 开始…》)

  3. 安装 nodejs 以及 yarn

    brew install nvm
    nvm install 20.5.1
    brew install yarn
    brew install ffmpeg
  4. 设置 yarn 环境变量以及 Node.js 配置

    export ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
    corepack enable
  5. 克隆此仓库至本地,而后安装、启动:

    cd ~
    mkdir github
    cd github
    git clone https://github.com/xiaolai/everyone-can-use-english
    cd ~/github/everyone-can-use-english
    yarn install
    yarn start:enjoy
  6. 以后重新启动用 Terminal

    cd ~/github/everyone-can-use-english
    git pull
    yarn install
    yarn start:enjoy

Windows 用户

系统要求:Windows 10 22H2 以上版本、 Windows PowerShell 5.1 以上版本、互联网网络连接正常。

  1. 将鼠标移至任务栏的 “Windows 徽标” 上单击右键,选择 “PowerShell”

    tips 1 :在最新的 Windows 11 上,你看不到 “PowerShell” 选项,只有 “终端”

    tips 2 :不能用管理员权限运行 PowerShell ,否则会导致 Scoop 安装失败

  2. 在弹出的 PowerShell 窗口中依次执行运行以下命令,安装 Scoop:

    # 设置 PowerShell 执行策略
    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
    # 下载安装脚本
    irm get.scoop.sh -outfile 'install.ps1'
    # 执行安装, --ScoopDir 参数指定 Scoop 安装路径
    .\install.ps1 -ScoopDir 'C:\Scoop'

    如果出现下面的错误:

    irm : 未能解析此远程名称: 'raw.githubusercontent.com'

    说明你的网络连接有问题,请自行研究解决:

  3. 安装 Nodejs 和 yarn 以及其他依赖环境 :

    scoop install nodejs
    scoop install git
    npm install yarn -g
  4. 设置 yarn 环境变量以及 Node.js 配置

    $env:ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
    corepack enable
  5. 克隆此仓库至本地,而后安装 Enjoy APP:

    cd ~
    mkdir github
    cd github
    git clone https://github.com/xiaolai/everyone-can-use-english
    cd everyone-can-use-english
    yarn install

    出现 “YN0000: · Done …… ” 类似字样说明安装成功!

  6. 运行 Enjoy APP ,在终端执行下列命令:

    yarn start:enjoy

更新 Enjoy

更新并使用最新版本的 Enjoy:

  1. 将仓库最新内容拉取到本地,在命令行工具中执行:

    git pull

    结果显示为:

    Already up to date.

    若非如此,那么意味着代码有所更新,那么就要运行以下命令:

    yarn install
  2. 运行 Enjoy APP:

    yarn start:enjoy

FAQ(常见问题)

Q: 我该下载哪个版本?

A: 点这里 有详细说明。

Q: 如何确定安装成功了?

A: 目前 Enjoy 的核心功能依赖两个服务,一个是 Whisper,用来语音转文字,在 软件设置 -> STT 语音转文字 -> 检查,提示工作正常表示 Whisper 安装成功。另一个是 FFmpeg,在 软件设置 -> FFmpeg -> 查找,确保提示成功。

Q: 我用 Mac,安装不了 FFmpeg

A: 安装 FFmpeg 要先安装 Homebrew,如果安装失败,多数是因为网络问题导致 Github 服务连接失败。

Q: 无法语音转文字

A: 先确定选择了哪个模型,如果选了 medium 以上的,试试换一个小一点的模型,电脑配置不够高可能会导致失败。如果是相对老版本 Windows 用户,可以是缺少一些依赖,到 这里 下载这个软件然后安装,再重新打开 Enjoy 试试。

Q: 智能助手一直转圈

A: 绝大多数是网络问题,请确保网络环境能正常访问 OpenAI 接口。如果网络有困难,请等待后续提供其他更易用的方案。

Q: 还有 bug,怎么办?

A: 可以提 Issue,也可以 Mixin 开发者(Mixin ID: 1051445)。

Q: 很多解决不了的问题,怎么办?

其实,可能还有很多其它问题,比如,本软件安装、OpenAI(注册、支付)、美国线路……

A: 1)文本生成,可以暂时用各种翻译工具,比如 Google Translate,或者其它的替代方案;2)语音生成,可以暂时用开源免费的 Edge-TTS-record