Merge remote-tracking branch 'origin/main' into docs

* origin/main: (72 commits)
  fix recording update failed (ZuodaoTech#883)
  keep updated
  keep updated
  Bump openai from 4.52.5 to 4.53.0 (ZuodaoTech#879)
  Fix recording sequelize unique constraint error (ZuodaoTech#882)
  keep updated
  Fix some minor bugs (ZuodaoTech#880)
  keep updated
  keep updated
  keep updated
  spellings and examples added.
  fix undefined issue
  Feat update openai setting (ZuodaoTech#876)
  docs: fix
  docs: update faq
  docs: update settings
  docs: update README
  docs: update faq
  may update ytb channels via api
  add instructions about how to finish chapter
  ...

.yarnrc.yml

@@ -4,4 +4,4 @@ nmHoistingLimits: workspaces
 
 nodeLinker: node-modules
 
-yarnPath: .yarn/releases/yarn-4.2.1.cjs
+yarnPath: .yarn/releases/yarn-4.3.1.cjs

1000-hours/.vitepress/config.mts

@@ -217,7 +217,11 @@ export default withMermaid(
  text: '2.2.15. w, j',
  link: '/sounds-of-american-english/2.2.15-wj',
  },
- ],
+ {
+ text: "2.2.16. Đánh vần",
+ link: "/sounds-of-american-english/2.2.16-spellings",
+ },
+ ]
  },
  {
  text: '2.3. Âm tiết',

1000-hours/enjoy-app/changelog.md

@@ -1,5 +1,46 @@
 # 版本更新
 
+## v0.3.2
+
+### 新增功能
+
+- 可以修改 API 网址
+
+### 修复故障
+
+- 字幕首个单词闪动
+
+## v0.3.1
+
+### 新增功能
+
+- 社区广场分享录音显示评估分数
+- 课程显示章节完成人数
+- 音视频字幕可导出为 PDF（带音标）
+- 社区广场可以点赞
+- 语音转文本可以从云端下载已有的字幕
+
+### 修复故障
+
+- 录音对比不起作用
+- 课程发音评估结果不显示
+- 侧边栏在小窗口的显示
+
+### 其他
+
+- 优化了发音评估流程
+
+## v0.3.0
+
+### 新增功能
+
+- 互动式课程
+
+### 修复故障
+
+- 语音转文本时出现网络错误后卡死
+- 发音评估部分音标显示不正常
+
 ## v0.2.14
 
 ### 新增功能

1000-hours/enjoy-app/faq.md

@@ -1,5 +1,50 @@
 # 常见问题
 
+## 总是报网络错误怎么办？
+
+如果登录时报 `Network Error`，发音评估或者使用其他功能时报 `connect ETIMEDOUT` 错误，可以打开浏览器（不要在微信里打开），尝试打开 [https://enjoy.bot](https://enjoy.bot)。
+
+如果无法打开，或者跳转到了其他不相关页面，说明您当前的网络无法连接上 Enjoy 的服务。
+
+可以按照以下步骤解决：
+
+1. [升级 Enjoy App](./install.md) 至 v0.3.2 以上；
+2. 在登录页面，点 `高级设置`（如果已登录，点 `软件设置`/`高级设置`），修改 API 设置，填入 `https://api.getenjoyapp.com`，点保存。
+
+软件自动重载后即可。
+
+另一种办法就是使用代理服务。
+
+## 如何多设备使用同一个帐号？
+
+Enjoy App 的大部分数据均保存在本地（即您的计算机硬盘），具体来说，保存在一个名为 `EnjoyLibrary` 的文件夹里。
+
+Enjoy 目前不提供云同步的服务。如果您需要在多个设备上使用 Enjoy App，建议使用网盘服务来同步数据。
+
+以百度网盘为例，可以参考以下步骤使用：
+
+1. 将 `/EnjoyLirary` 文件夹（即[资源库保存路径](./settings.md#资源库保存路径)）加入到百度网盘的同步列表中；
+2. 每次使用完 Enjoy App，关机之前，确保 `/EnjoyLibrary` 文件夹全部同步完成；
+3. 在第二部电脑上，利用网盘，将 `/EnjoyLibrary` 文件夹最新状态同步完成；
+4. 在第二部电脑上，登录相同的 Enjoy 帐号使用；
+5. 重复 2~4 步骤。
+
+另外需要注意，在利用网盘同步的情况下，不要同一时间在不同设置使用相同的 Enjoy 帐号，这样会导致数据冲突。
+
+## 超过每日使用限额怎么办？
+
+Enjoy 的新用户会自动发放一定的体验金，新用户可以无需充值即可体验 Enjoy 的收费服务，但同时还有一个每天使用次数的限制，超过后则会报错。
+
+只要充值任意金额一次，即可解除限制。
+
+## 自备 OpenAI 密钥，还需要充值吗？
+
+Enjoy App 很多功能都基于 AI。为了方便用户使用，Enjoy 提供了 EnjoyAI 服务，集成了当下流行的大模型服务商和热门模型供选择，用户只需要在 Enjoy 充值后即可使用。
+
+当然，Enjoy 也允许用户自定义服务商和密钥，此种情况下，Enjoy 不会收取任何费用。
+
+但是，发音评估功能并非 OpenAI 提供的服务，是 Enjoy 的收费功能，使用前必须保证 Enjoy 账户有余额。
+
 ## 为什么本地语音转文本服务无法使用？
 
 Enjoy 集成了 [whipser.cpp](https://github.com/ggerganov/whisper.cpp) 作为本地的语音转文本（STT）服务，但是由于兼容性的问题，某些配置较低或者操作系统版本较低的电脑无法使用。

1000-hours/enjoy-app/install.md

@@ -4,13 +4,13 @@ Enjoy App 是一个跨平台的桌面应用，可以在 Windows、Mac 和 Linux
 
 请根据电脑设备的操作系统，下载相应的版本安装使用。
 
-当前最新版本：[v0.2.14](https://github.com/zuodaotech/everyone-can-use-english/releases/latest)
+当前最新版本：[v0.3.2](https://github.com/zuodaotech/everyone-can-use-english/releases/latest)
 
 ## Windows
 
 支持 Windows 10 以上版本。
 
-[点击下载](https://dl.enjoy.bot/app/win32/x64/Enjoy-0.2.14%20Setup.exe)
+[点击下载](https://dl.enjoy.bot/app/win32/x64/Enjoy-0.3.2%20Setup.exe)
 
 下载后，双击即可安装。
 
@@ -33,8 +33,8 @@ A JavaScript error occurred in the main process
 
 根据使用 Mac 电脑的芯片不同，需要下载不同的版本。
 
-- [Silicon 芯片版本(arm64)](https://dl.enjoy.bot/app/darwin/arm64/Enjoy-0.2.14-arm64.dmg)
-- [Intel 芯片版本(x64)](https://dl.enjoy.bot/app/darwin/x64/Enjoy-0.2.14-x64.dmg)
+- [Silicon 芯片版本(arm64)](https://dl.enjoy.bot/app/darwin/arm64/Enjoy-0.3.2-arm64.dmg)
+- [Intel 芯片版本(x64)](https://dl.enjoy.bot/app/darwin/x64/Enjoy-0.3.2-x64.dmg)
 
 ::: info 如何查看本机配置
 M1 以后的 Mac 电脑型号(M1、M2、M3)，均为 Silicon 芯片。
@@ -52,8 +52,8 @@ M1 以后的 Mac 电脑型号(M1、M2、M3)，均为 Silicon 芯片。
 
 请根据不同发行版本选用安装文件。
 
-- [下载 deb 版本](https://dl.enjoy.bot/app/linux/x64/enjoy_0.2.14_amd64.deb)
-- [下载 zip 版本](https://dl.enjoy.bot/app/linux/x64/Enjoy-linux-x64-0.2.14.zip)
+- [下载 deb 版本](https://dl.enjoy.bot/app/linux/x64/enjoy_0.3.2_amd64.deb)
+- [下载 zip 版本](https://dl.enjoy.bot/app/linux/x64/Enjoy-linux-x64-0.3.2.zip)
 
 ## 历史版本
 

1000-hours/enjoy-app/settings.md

@@ -4,7 +4,125 @@ Enjoy 只需要登录后即可直接使用，**无需其他设置**。但是，
 
 打开 Enjoy 软件，点击左侧栏最下面的齿轮按钮，即可打开 `软件设置`。
 
-## 资源库保存路径
+## 基本设置
+
+### 母语
+
+请选择您的母语，默认为`简体中文`。
+
+请注意，此设定关系到学习过程中的翻译内容、分析等，并不影响软件的界面语言。
+
+### 学习语言
+
+请选择您要学习的语言，默认为 `English(United States)`。
+
+### 语音转文本服务
+
+::: info 设置路径
+软件设置 -> 基本设置 -> 语音转文本服务
+:::
+
+语音转文本（即 STT，Speech to Text）服务是 Enjoy 提供的核心功能之一，也是 [跟读训练](./audios.md#跟读音频) 的前提条件。
+
+此处设置为默认值，在语音转文本时仍可选择不同服务。
+
+<details>
+<summary>
+本地(whisper)
+</summary>
+
+该设置默认项为 `本地`，即利用 Enjoy 集成的 whisper 组件，完全利用本地计算机的算力提供 STT 服务，该服务完全免费。
+
+Enjoy 软件集成了最小的 whisper 模型 `tiny.en`，如果电脑配置较高，可以选用更大的模型以提高语音转文本的准确度。点击 `模型` 按钮，在弹窗中选择相应的模型即可自动下载并选中。
+
+::: tip 关于 whisper 模型的选择
+下载的 whisper 模型会保存在 `/EnjoyLibrary/whisper/models/` 文件夹下。如果自动下载失败，也可以到 [这里](https://hf-mirror.com/ggerganov/whisper.cpp) 手动下载，放置在该文件夹下，在 Enjoy 中即可以选中。
+
+理论上，模型越大，识别的准确度也更高，但是运行得越慢，甚至在一些配置不高的电脑中无法运行。
+
+凡是以 `.en` 结尾的模型均只支持英文，识别英文准确性也更高，例如 `base.en`；而不以 `.en` 结尾的模型则可以支持多种语言，例如 `base`。
+:::
+
+::: warning 检查本地 whisper 服务
+有些电脑或者系统（例如 macOS 11）可能会因为兼容性问题（或其他未知问题）无法使用本地的 whisper 服务。点击 `检查` 按钮即可检查 whisper 服务在本地计算机是否工作正常。如果提示无法正常工作，可以选用其他服务。
+:::
+</details>
+
+<details>
+<summary>
+Azure AI STT
+</summary>
+
+利用微软 Azure AI 的语音识别 API 服务提供的 STT，该服务为**收费服务**，每次使用均会在 Enjoy 账户余额中扣费，，余额不足则需要 [充值](#充值) 后才可继续使用。
+</details>
+
+<details>
+<summary>
+Cloudflare AI STT
+</summary>
+
+利用 Cloudflare 提供的 whisper 云服务，该服务目前免费。经实测，对于一些时长较短的音频，识别会有较大误差。
+</details>
+
+<details>
+<summary>
+OpenAI STT
+</summary>
+
+利用 OpenAI 提供的 whipser 云服务，该服务需要[配置自己的 OpenAI 密钥](#openai-配置)。
+</details>
+
+### 默认 AI 引擎
+
+::: info 设置路径
+软件设置 -> 基本设置 -> 默认 AI 引擎
+:::
+
+Enjoy 中提供了很多方便的功能，例如 [提取关键词汇](./webpage#提取关键词汇)、 [查单词](./webpage#查单词)、标注音标 等，均是利用 AI 服务来实现。
+
+默认值为 `Enjoy AI`，由 Enjoy 提供该服务，每次使用均会在账户余额中扣费，余额不足则需要 [充值](#充值) 后才可继续使用。EnjoyAI 提供了除 OpenAI 以外，目前流行的热门模型，用户可以灵活选用。
+
+如果您配备了可用的 [OpenAI 密钥](#openai-配置)，也可以将 **默认 AI 引擎** 选为 `OpenAI`。
+
+在默认模型，您还可以对不同的服务选用不同的模型。
+
+### OpenAI 配置
+
+::: info 设置路径
+软件设置 -> 基本设置 -> OpenAI
+:::
+
+配置 OpenAI API 密钥，可以在 [官网](https://platform.openai.com/api-keys) 申请。配置好的 OpenAI 服务可以在 [智能助手](./ai-assistant.md)、 [提取关键词汇](./webpage#提取关键词汇)、 [查单词](./webpage#查单词)、标注音标 等服务中使用。
+
+- 密钥：OpenAI API 密钥
+- 模型：默认使用的模型
+- 接口地址：如果使用的是官方申请的密钥，则不需要填；否则请根据密钥提供方的信息填写。
+
+::: warning 接口地址
+由于 OpenAI 在某些地区不提供服务，有些用户会使用第三方提供的中转服务。请务必根据服务提供方的信息填写好 **接口地址**。如果使用时出现报错，可能需要在接口地址结尾加上 `/v1`。
+:::
+
+## 高级设置
+
+### API 设置
+
+设置 Enjoy 服务的 API 地址。默认为 `https://enjoy.bot`。
+
+### 代理设置
+
+为 Enjoy App 设置代理服务。
+
+### 重置设置选项
+
+退出登录并将 Enjoy App 的所有设置重置为默认值。
+
+### 重置所有
+
+将退出登录，并删除所有个人数据。
+
+## 账户设置
+
+### 资源库保存路径
 
 ::: info 设置路径
 软件设置 -> 基本设置 -> 资源库保存路径
@@ -70,81 +188,7 @@ Enjoy 采用 **本地优先** 的设计原则，大部分数据均保存在本
 如前文所说，Enjoy 采用本地优先的设计原则，绝大部分数据并没有上传云服务器，请妥善保管好自己的个人数据。
 :::
 
-## OpenAI 配置
-
-::: info 设置路径
-软件设置 -> 基本设置 -> OpenAi
-:::
-
-配置 OpenAI API 密钥，可以在 [官网](https://platform.openai.com/api-keys) 申请。配置好的 OpenAI 服务可以在 [智能助手](./ai-assistant.md)、 [提取关键词汇](./webpage#提取关键词汇)、 [查单词](./webpage#查单词)、标注音标 等服务中使用。
-
-- 密钥：OpenAI API 密钥
-- 模型：默认使用的模型
-- 接口地址：如果使用的是官方申请的密钥，则不需要填；否则请根据密钥提供方的信息填写。
-
-::: warning 接口地址
-由于 OpenAI 在某些地区不提供服务，有些用户会使用第三方提供的中转服务。请务必根据服务提供方的信息填写好 **接口地址**。如果使用时出现报错，可能需要在接口地址结尾加上 `/v1`。
-:::
-
-## Google Generative AI 配置
-
-::: info 设置路径
-软件设置 -> 基本设置 -> Google Generative AI
-:::
-
-配置 Google Generative AI 的密钥，可以在 [官网](https://ai.google.dev/) 申请 。配置后可以在 [智能助手](./ai-assistant.md) 中选用 Google Generative AI 作为 AI 引擎。
-
-## 语音转文本服务
-
-::: info 设置路径
-软件设置 -> 基本设置 -> 语音转文本服务
-:::
-
-语音转文本（即 STT，Speech to Text）服务是 Enjoy 提供的核心功能之一，也是 [跟读训练](./audios.md#跟读音频) 的前提条件。
-
-### 本地(whisper)
-
-该设置默认项为 `本地`，即利用 Enjoy 集成的 whisper 组件，完全利用本地计算机的算力提供 STT 服务，该服务完全免费。
-
-Enjoy 软件集成了最小的 whisper 模型 `tiny.en`，如果电脑配置较高，可以选用更大的模型以提高语音转文本的准确度。点击 `模型` 按钮，在弹窗中选择相应的模型即可自动下载并选中。
-
-::: tip 关于 whisper 模型的选择
-下载的 whisper 模型会保存在 `/EnjoyLibrary/whisper/models/` 文件夹下。如果自动下载失败，也可以到 [这里](https://hf-mirror.com/ggerganov/whisper.cpp) 手动下载，放置在该文件夹下，在 Enjoy 中即可以选中。
-
-理论上，模型越大，识别的准确度也更高，但是运行得越慢，甚至在一些配置不高的电脑中无法运行。
-
-凡是以 `.en` 结尾的模型均只支持英文，识别英文准确性也更高，例如 `base.en`；而不以 `.en` 结尾的模型则可以支持多种语言，例如 `base`。
-:::
-
-::: warning 检查本地 whisper 服务
-有些电脑或者系统（例如 macOS 11）可能会因为兼容性问题（或其他未知问题）无法使用本地的 whisper 服务。点击 `检查` 按钮即可检查 whisper 服务在本地计算机是否工作正常。如果提示无法正常工作，可以选用其他服务。
-:::
-
-### Azure AI STT
-
-利用微软 Azure AI 的语音识别 API 服务提供的 STT，该服务为**收费服务**，每次使用均会在 Enjoy 账户余额中扣费，，余额不足则需要 [充值](#充值) 后才可继续使用。
-
-### Cloudflare AI STT
-
-利用 Cloudflare 提供的 whisper 云服务，该服务目前免费。经实测，对于一些时长较短的音频，识别会有较大误差。
-
-### OpenAI STT
-
-利用 OpenAI 提供的 whipser 云服务，该服务需要[配置自己的 OpenAI 密钥](#openai-配置)。
-
-## 默认 AI 引擎
-
-::: info 设置路径
-软件设置 -> 基本设置 -> 默认 AI 引擎
-:::
-
-Enjoy 中提供了很多方便的功能，例如 [提取关键词汇](./webpage#提取关键词汇)、 [查单词](./webpage#查单词)、标注音标 等，均是利用 AI 服务来实现。
-
-如果你有自己的 [OpenAI 密钥](#openai-配置)，建议将 **默认 AI 引擎** 选为 `OpenAI`。
-
-否则，可以选 `Enjoy AI`，由 Enjoy 提供该服务，每次使用均会在账户余额中扣费，余额不足则需要 [充值](#充值) 后才可继续使用。
-
-## 充值
+### 充值
 
 ::: info 设置路径
 软件设置 -> 账户设置 -> 余额
@@ -159,3 +203,15 @@ Enjoy 提供了部分收费的 AI 服务，均为 **按使用量收费**，每
 
 请谨慎考虑，按需充值。
 :::
+
+## 快捷键
+
+Enjoy App 可用的快捷键，点击键位可以修改。
+
+## 外观
+
+可修改主题和界面语言。
+
+## 关于
+
+当前版本和更新链接。

1000-hours/package.json

@@ -9,7 +9,7 @@
  "markdown-it-sup": "^2.0.0",
  "mermaid": "^10.9.1",
  "sass": "^1.77.6",
- "vitepress": "^1.2.3",
+ "vitepress": "^1.3.0",
  "vitepress-plugin-mermaid": "^2.0.16",
  "vue": "^3.4.30"
  },