+与 `l` 一样（[2.2.11](23-l)），处于元音之后的 `r` 由于有完整的舌尖动作，会使之前的元音附加一个音标标注里看不到的 `ə`，比如：
-
-####
\ No newline at end of file
+> * *fear* `/fɪr/` → `/fɪər/`
+> * *wear* `/wer/` → `/weər/`
\ No newline at end of file
diff --git a/1000-hours/sounds-of-english/23-l.md b/1000-hours/sounds-of-english/23-l.md
index 2ee075b19..5af8f0497 100644
--- a/1000-hours/sounds-of-english/23-l.md
+++ b/1000-hours/sounds-of-english/23-l.md
@@ -10,4 +10,16 @@
所以，要格外注意 `l` 在元音之后的情况，注意舌尖位置正确，动作完整，不能有嘴唇动作 —— 否则就会出现 `ʊ` 音。
-
\ No newline at end of file
+
+
+格外需要注意的是，由于处于音节末尾的 `l` 有这个完整的舌尖动作，于是，它之前的`ɪ`、`iː`、`eɪ`、`e`、`æ` 都会附加这一个未标注音标的 `ə` 音 —— 完整舌尖动作的自然结果。
+
+> * seal `/siːl/` → `/siːəl/`
+> * fill `/fɪl/` → `/fɪəl/`
+> * tale `/teɪl/` → `/teɪəl/`
+> * well `/wel/` → `/weəl/`
+> * shall `/ʃæl/` → `/ʃæəl/`
+
+注意，`r` 之前也常常有同样的现象（[2.2.10](22-r)）。
+
+另外，`l` 和 `m`、`n` 一样，有时也会使之前的辅音变成**音节辅音**（[2.2.3](15-mn)）。比如，*little* `/ˈlɪt̩l/`（注意，这里的 `t` 会被浊化，变成弹舌音 `t̬`，听起来像是 `d`），*awful* `/ˈɔf̩l/`。
\ No newline at end of file
diff --git a/1000-hours/sounds-of-english/25-jw.md b/1000-hours/sounds-of-english/25-jw.md
index 24e9ec3cc..6bf0b539e 100644
--- a/1000-hours/sounds-of-english/25-jw.md
+++ b/1000-hours/sounds-of-english/25-jw.md
@@ -18,4 +18,6 @@
> * *Do it* - `/ˈduː ˈɪt/` ⭢ `/ˈduːwɪt/`
> * *Throw it* - `/ˈθrəʊ ˈɪt/` ⭢ `/ˈθrəʊwɪt/`
-之前提到过的例子 *individual* `/ˌɪndɪˈvɪdʒəwəl/`（[2.1.4](07-ə), [2.2.11](23-l)），是个多音节词汇，如果仔细看的话，就会发现，后半部分， /`dʒə-wəl/` ，其实也是 `/dʒju-əl/` 经过 *intrusion* 插入了一个 `w` 而演化过来的。
\ No newline at end of file
+之前提到过的例子 *individual* `/ˌɪndɪˈvɪdʒəwəl/`（[2.1.4](07-ə), [2.2.11](23-l)），是个多音节词汇，如果仔细看的话，就会发现，后半部分， /`dʒə-wəl/` ，其实也是 `/dʒju-əl/` 经过 *intrusion* 插入了一个 `w` 而演化过来的。
+
+另外，请注意复习一下 `t+j`、`d+j`、`s+j`、`z+j` 可能会产生的同化现象（[2.2.5.3](17-td#_2-2-5-3-同化)）。
\ No newline at end of file
diff --git a/1000-hours/sounds-of-english/26-catenation.md b/1000-hours/sounds-of-english/26-catenation.md
index 42f3aea0e..f3b23b74f 100644
--- a/1000-hours/sounds-of-english/26-catenation.md
+++ b/1000-hours/sounds-of-english/26-catenation.md
@@ -18,7 +18,7 @@
> * 非重音上的元音常常被简化成 ` ə`（[2.1.4](07-ə)）
> * `t, d` 常常有各种变化（[2.2.5](17-td)）：
-> * 省音（ *elision*，[2.2.5.1](17-td#_2-2-5-1-省音)）
+> * 省音（*elision*，[2.2.5.1](17-td#_2-2-5-1-省音)）
> * 叠音（*geminates*，[2.2.5.2](17-td#_2-2-5-2-叠音)）
> * 同化（*assimilation*，[2.2.5.3](17-td#_2-2-5-3-同化)）；
> * 弹舌音 （*alveolar flapping*，[2.2.5.4](17-td#_2-2-5-4-弹舌音)）
diff --git a/1000-hours/sounds-of-english/36-long-short.md b/1000-hours/sounds-of-english/36-long-short.md
index f8138ecbb..9554c402b 100644
--- a/1000-hours/sounds-of-english/36-long-short.md
+++ b/1000-hours/sounds-of-english/36-long-short.md
@@ -6,7 +6,7 @@
所以，说话的过程就是**把每个音节安排好**的过程。
-传统外语教学对自然语音中**韵律**（*prosody*）和**节奏**（*beats*）的重视程度并不足够，重视得也不够全面。
+传统外语教学对自然语音中**韵律**（*prosody*）和**节奏**（*rhythm*）的重视程度并不足够，重视得也不够全面。韵律节奏长期以来一直是母语教学中所谓最高级的部分才会深入讲解的领域：诗词创作。
曾经，传统外语教学只会泛泛提及**声调**的**起伏**，并且，基本上仅限于祈使句与疑问句之中那些处于句末以词汇为单位的明显声调变化。
diff --git a/1000-hours/training-tasks/ai.md b/1000-hours/training-tasks/ai.md
index 174295701..862f1656d 100644
--- a/1000-hours/training-tasks/ai.md
+++ b/1000-hours/training-tasks/ai.md
@@ -1,4 +1,4 @@
# 人工智能
-人工智能在生活中的应用非常多，但，最有用的地方（无需附加上 “之一”）可能是用来提高我们的**语言使用能力**。毕竟，现在的人工智能都是基于**大语言模型**的，所以，它们天然在语言领域更为灵活更为强大。
+人工智能在生活中的应用非常多，但，最有用的地方（无需附加上 “之一”）是用来提高我们的**语言使用能力**。毕竟，现在的人工智能都是基于**大语言模型**的，所以，它们天然在语言领域更为灵活更为强大。
diff --git a/1000-hours/training-tasks/kick-off.md b/1000-hours/training-tasks/kick-off.md
index 40313a476..9931a63ab 100644
--- a/1000-hours/training-tasks/kick-off.md
+++ b/1000-hours/training-tasks/kick-off.md
@@ -47,13 +47,13 @@ AI 辅助工具，付费方案最好的是 [OpenAI](https://openai.com/)，无
如果做不到**每天三小时**，那就算了吧 —— 当然，其实谁都可以做到的。
-起作用的只有**大声开口练习**。注意，一定是**大声**；虽然开口了，但只不过是小声嘟囔，不算数。当然，也没必要**喊** —— 首先，声带的确需要保护，其次，我们需要练习的是主要是**舌头**、**嘴唇**，以及**呼吸**，声带还真不是练习的重点。
+起作用的只有**大声开口练习**。注意，一定是**大声**；虽然开口了，但只不过是小声嘟囔，不算数。当然，也没必要**喊** —— 首先，声带的确需要保护，其次，我们需要练习的主要是**舌头**、**嘴唇**、**喉咙**、以及**呼吸**，声带还真不是练习的重点。
虽然最好是**连贯的三小时**，但，**一天之内累计三小时**也可以。
**碎片时间**也可以利用。把跟读录音存到可以同步云端的音乐播放器里（比如 iOS/macOS 内建的 Music），随时循环播放（戴单只耳机听，如此这般，万一自己可以跟读，自己的声音也同时听得更清楚）—— 这跟学唱歌一样，听得越多细节越熟悉。学歌的时候，不唱的时候不也要经常多听几遍吗？只不过，这样的碎片练习最好不要计入**三小时**之内。
-**准备文本**的工作，最好在前一天白天的时候抽空做 —— 这也可以利用碎片时间陆陆续续做完。这样可以节省自己宝贵的精力。
+**准备文本**的工作，最好提前一天抽空做 —— 这也可以利用碎片时间陆陆续续做完，这样可以节省自己宝贵的精力。
三小时之外，如果你有时间精力，依然应该花时间输入英文，无论是阅读、还是听有声书或者看视频影视剧集。
@@ -81,8 +81,8 @@ AI 辅助工具，付费方案最好的是 [OpenAI](https://openai.com/)，无
> * **语音塑造**
> * **记忆扩展**
-**记忆**是一切思维活动的基础。我们所说的每一句话、每一个词汇，甚至每一个音节，都来自于我们的记忆。即便是创造，也只能完全建立在极大记忆容量的基础之上。一个人记忆力差，就好像是一台电脑配置的内存太小一样，处理什么都超级慢，数据量稍微大一点就会当场死机。
+**记忆**是一切思维活动的基础。我们所说的每一句话、每一个词汇、甚至每一个音节，都来自于我们的记忆。即便是创造，也只能完全建立在极大记忆容量的基础之上。一个人记忆力差，就好像是一台电脑配置的内存太小一样，处理什么都超级慢，数据量稍微大一点就会当场死机。
-训练任务中的文本，是**自己想要说的话**，也正因如此，背诵难度实际上并不高，毕竟，其中的概念与逻辑，都来自于你原本的记忆。只不过，现在用的是另外一种语言，所以，增加了一点难度而已。但是，在塑造语音的过程中，无数次的反复，又从另外一方面降低了难度。于是，总体上还是很容易做到。
+训练任务中的文本，是**自己想要说的话**，也正因如此，背诵难度实际上并不高，毕竟，其中的概念与逻辑，都来自于你原本的记忆。只不过，现在用的是另外一种语言，增加了一点难度而已。但是，在塑造语音的过程中，无数次的反复，又从另外一方面降低了难度。所以，总体上还是很容易做到。
-如果一天你能彻底记住 1 分钟的内容，一年下来就是 300 多分钟，加起来就是 5 个小时的内容…… 想想吧，如果你能滔滔不绝连续讲 5 个小时的话，你的语言能力在人群中必然能够超越 99% 以上的人群 —— 无论使用哪一种语言。
+如果一天你能完整记住 1 分钟的内容，一年下来就是 300 多分钟，加起来就是 5 个小时的内容…… 想想吧，如果你能滔滔不绝连续讲 5 个小时的话，你的语言能力必然能够超越 99% 以上的人群 —— 无论使用哪一种语言。
diff --git a/1000-hours/training-tasks/language.md b/1000-hours/training-tasks/language.md
index 94f2f89f6..da737682b 100644
--- a/1000-hours/training-tasks/language.md
+++ b/1000-hours/training-tasks/language.md
@@ -2,13 +2,13 @@
你有没有认真想过，我们经常提起或者偶尔称赞的**文笔**或者**口才**指的到底是什么呢？
-文字是用来记录并传递感知的。所以，一个人能用的名词，往往局限在他能够感知的事物的总和，不管是抽象的还是具体的。他们能用的动词，就是这个集合里的事物能够发出或者承载的动作。
+文字是用来记录并传递感知的。所以，一个人能用的名词，往往局限在他能够感知的事物的总和之中，不管是抽象的还是具体的。他们能用的动词，就是这个集合里的事物能够发出或者承载的动作。
**具体事物**，见过就知道，没见过就不知道也很容易理解。能用语言描述具体的事物及其对他们的感知，可以算作是**基础语言能力**了吧？
这基础之上的才可以被称为**文采**或者**口才**吧？
-毫无疑问，**抽象事物**的数量一直在不断增加，并且发展得越来越快。亚里士多德显然是个天才，但他不知道**重力**的存在；发明了望远镜的伽利略当然好奇过天上底有多少颗星星，可天才如他也无法想象许多年后才有科学家想到了个用照片图像上的**景深**去估算恒星数量的方法；伽利略肯定也没听说过**进化**这个概念；达尔文不可能知道什么是**量子纠缠**或者**指数基金**。
+毫无疑问，**抽象事物**的数量一直在不断增加，并且发展得越来越快。亚里士多德显然是个天才，但他不知道**重力**的存在；发明了望远镜的伽利略当然好奇过天上到底有多少颗星星，可天才如他也无法想象许多年后有科学家想到了个用照片图像上的**景深**去估算恒星数量的方法；伽利略肯定也没听说过**进化**这个概念；达尔文不可能知道什么是**量子纠缠**或者**指数基金**。
“幸福” 这样普遍的抽象概念虽然理解上并不统一，但大家好像早都知道，也不需要教育。但更多的抽象概念，比如，**适者生存**，**双盲测试**，**举证责任**，**基尼系数**，**皮格马利翁效应**，**梅特卡夫定律**，**摩尔定律**，**聚光灯效应**，**贝叶斯定理**…… 这些今天的人们可能习以为常的抽象概念，往往需要数年的教育或者自我教育才可以真正习得并熟练应用。
@@ -16,7 +16,7 @@
先不说那些高级的**修辞**，单说对一个事物的**形容**，即，普通的形容词，人与人之间的差异也非常大。
-如果一个人对一个他能够感知到的事物只有一方面的感知，那么针对这个事物，他可用的形容词也就只有一个，不可能是多个。比如，同样一部电视剧，很多人只有一个感受，“好看”。另外一个人的描述却是，“这是一个画面华丽，情绪充沛，却故事单薄，人物拉垮，但反过来又因为这个时代的品味而大火特火的电视剧”。与其说这是文采，不如说这只是对同一事物更多角度的观察、感知与思考最终在语言上的体现。
+如果一个人对一个他能够感知到的事物只有一方面的感知，那么针对这个事物，他可用的形容词也就只有一个，不可能是多个。比如，同样一部电视剧，很多人只有一个感受，“好看”；而另外一个人的描述却是，“这是一个画面华丽，情绪充沛，却故事单薄，人物拉垮，但反过来又因为这个时代的品味而大火特火的电视剧”。与其说这是文采，不如说这只是对同一事物更多角度的观察、感知与思考最终在语言上的体现。
有人喜欢**押韵**，有人善用**类比**，有人擅用**隐喻**，有人以**排比**为乐，有人以**旁征博引**为荣。
@@ -24,7 +24,7 @@
一个人能用精确且又出人意料的**类比**，说明他能看到别人看不到的不同事物之间的关联，并且还能在众多的关联里挑出最准确最令人震惊的那个…… 这可是非常了不起甚至罕见的技能。
-一个人能不动声色的用好各种**隐喻**，往往来自整个文化的长期影响。比如，同样说，“他就是一个**棋子**” — 这倒真是全球通用的一个隐喻，毕竟，**人生如棋**…… 但，接下来，这个 “棋子” 到底是什么呢？欧洲人可能在 *Knight*, *Bishop*, 和 *Pawn* 中选择（国际象棋）；而中国人呢？车马炮，或者卒（中国象棋）。
+一个人能不动声色地用好各种**隐喻**，往往来自整个文化的长期影响。比如，同样说，“他就是一颗**棋子**” — 这倒真是全球通用的一个隐喻，毕竟，**人生如棋**…… 但，接下来，这个 “棋子” 到底是什么呢？欧洲人可能在 *Knight*, *Bishop* 和 *Pawn* 中选择（国际象棋）；而中国人呢？车马炮，或者卒（中国象棋）。
至于**排比**和**旁征博引**么，毫无疑问，都需要更多额外的功课，因为现编总是来不及的。
diff --git a/1000-hours/training-tasks/procedures.md b/1000-hours/training-tasks/procedures.md
index d966852f2..623893605 100644
--- a/1000-hours/training-tasks/procedures.md
+++ b/1000-hours/training-tasks/procedures.md
@@ -6,7 +6,7 @@
在挣扎着**读准**之前，**首先要避免读错**。这只是一个习惯，遇到任何不确定的词汇都要查词典 —— 当然，在有各种辅助工具的情况下（[GPT: Phonetic Transcriber](https://chat.openai.com/g/g-nWwuxUVqO-phonetic-transcriber)），甚至可以整句查询音标。
-忘文生音非常可怕。我曾经在很多年里把 *facade* 读成 `/ˈfækeɪd/` （其实是 `/fəˈsɑːd/`）把 *specific* 读成 `/ˈspesɪfɪk/` （其实是 `/spəˈsɪfɪk/`）…… 不妨再猜猜 *plaid* 这个词怎么读？我在很长一段时间里误以为是 `/pleɪd/` …… 后来才发现并非如此 —— 其实是 `/plæd/`：。
+望文生音非常可怕。我曾经在很多年里把 *facade* 读成 `/ˈfækeɪd/` （其实是 `/fəˈsɑːd/`）把 *specific* 读成 `/ˈspesɪfɪk/` （其实是 `/spəˈsɪfɪk/`）…… 不妨再猜猜 *plaid* 这个词怎么读？我在很长一段时间里误以为是 `/pleɪd/` …… 后来才发现并非如此 —— 其实是 `/plæd/`：。
如果不养成这个习惯，那么读错的单词会越来越多，等于时时刻刻在为自己的牢墙添砖加瓦，到最后再也无法逃脱 —— Github 上有个[常见中国程序员发音错误的单词列表](https://github.com/shimohq/chinese-programmer-wrong-pronunciation)，不妨去看看，当作自己的警钟。
@@ -27,7 +27,7 @@
> * 元音（[2.1](/sounds-of-english/03-vowels-overview)）
> * 辅音（[2.2](/sounds-of-english/12-consonants-overview)）
-**仔细听**的意思是说，按照以上的顺序，逐条分析，直至每个**音素**都认真分析过、认真体会过、认真尝试过。这一步最需要**注意力集中**，也是整个训练中最关键的部分 —— 这场训练，从另外一个角度来看，全部都是**注意力训练**。
+**仔细听**的意思是说，按照以上的顺序，逐条分析，直至每个**音素**都认真分析过、认真体会过、认真尝试过。这一步最需要**注意力集中**，也是整个训练中最关键的部分 —— 这场训练，从另外一个角度来看，实际上都是**注意力训练**。
如果这一点没做到、没做好的话，就会出现 “**明明听到的是一回事，脑子里反应的却是另外一回事**”。
@@ -57,11 +57,11 @@
- 可即便放慢速度了也不行…… 于是，只能一小节一小节地练，练熟了一小节再去练下一小节，两个都练熟了之后吧，还得拼起来重复很多遍才能做到两个小节之间衔接自然…… 如此这般，一小节一小节地终于 “**爬**” 完之后，才算有资格可以进行**正式练习**了……
+ 可即便放慢速度了也不行…… 于是，只能一小节一小节地练，练熟了一小节再去练下一小节，两个小节都练熟了之后吧，还得拼起来重复很多遍才能做到两个小节之间衔接自然…… 如此这般，一小节一小节地终于 “**爬**” 完之后，才算有资格可以进行**正式练习**了……
自然语音中有**可换气停顿**的地方，就相当于是乐谱里的小节分界线。分段练习，实在难的小节，还可以继续拆分……
-在跟读的时候，有必要**夸张**一点**。声音也要正常地大** —— 确实不用喊，嗓子的确需要保护。实际上，我们主要需要练的是嘴唇、舌头、气流震动的配合，主要练的还真不是声带。
+在跟读的时候，有必要**夸张**一点。声音也要正常地**大** —— 确实不用喊，嗓子的确需要保护。实际上，我们主要需要练的是嘴唇、舌头、气流震动的配合，主要练的还真不是声带。
跟读的时候，可以戴着耳机。一个比较好的方法是戴单只耳机 —— 这样，一方面录音听得更清楚，另外一方面也不妨碍听清自己的声音，还可以换着耳朵戴。
@@ -119,4 +119,4 @@ TED 上有一个讲座，Benjamin Zander 讲 [The transformative power of classi
一天至少三个小时，每周最多可以中止一天。
-每天结束之前，要花 5～10 分钟做一下**复盘**，回忆并记录一下自己今天遇到的困难、已经克服的困难，尚未克服的困难，以及面对那些困难时所采用的方法…… 想一想还有什么方法可以试试？这些都要写下来。相信我，记录这个东西 ，总是会以想象不到的方式起想象不到的作用。
\ No newline at end of file
+每天结束之前，要花 5～10 分钟做一下**复盘**，回忆并记录一下自己今天遇到的困难、已经克服的困难、尚未克服的困难、以及面对那些困难时所采用的方法…… 想一想还有什么方法可以试试？这些都要写下来。相信我，记录这个东西 ，总是会以想象不到的方式起想象不到的作用。
\ No newline at end of file
diff --git a/1000-hours/training-tasks/wonder.md b/1000-hours/training-tasks/wonder.md
index d3d92ad08..30b1497b7 100644
--- a/1000-hours/training-tasks/wonder.md
+++ b/1000-hours/training-tasks/wonder.md
@@ -1,6 +1,6 @@
# 5. 效果非常惊人
-最更惊人的是，在人工智能的辅助之下，我的第一语言使用水平也可以用同样的方式提高。在此之前，我们通常都是**眼高手低**的 —— 我们的实际能力常常远远低于我们的**审美**。就好像我们都知道什么好吃，但真的做不出那么好吃的东西一样。但现在不一样了，突然之间，能力追上了审美，想要再提高，竟然需要做的只不过是**提高审美标准**而已……
+最惊人的是，在人工智能的辅助之下，我的第一语言使用水平也可以用同样的方式提高。在此之前，我们通常都是**眼高手低**的 —— 我们的实际能力常常远远低于我们的**审美**。就好像我们都知道什么好吃，但真的做不出那么好吃的东西一样。但现在不一样了，突然之间，能力追上了审美，想要再提高，竟然需要做的只不过是**提高审美标准**而已……
作为岁数已经不小了的成年人，我想到了一个令自己无比震惊的可能性 —— 我们完全有机会在人工智能辅助下，通过一段时间的训练，生生把英语变成自己的第一语言。这在过去当然会被认为完全不可能，现在呢？现在真的不一样了。
diff --git a/1000-hours/what.md b/1000-hours/what.md
index 4cc0362bb..894d3f12d 100644
--- a/1000-hours/what.md
+++ b/1000-hours/what.md
@@ -2,17 +2,17 @@
在过去的两百多年时间里，一方面是大多数人体力变得越来越差，另外一方面是那些主动健身的人成绩越来越好。人们投入了无数的时间与精力去研究如何提高成绩。
-马拉松运动员为了跑得更快，改变了呼吸方式、改变了跑步姿势，甚至在不断研究如何改进运动鞋，使用更先进的材质把跑鞋改得越来越轻；与此同时，出于自我保护，关于跑鞋怎么做才能更好地减震，迄今为止也不知道更新多少次专利。
+马拉松运动员为了跑得更快，改变了呼吸方式、改变了跑步姿势，甚至在不断研究如何改进运动鞋 —— 使用更先进的材质把跑鞋改得越来越轻；与此同时，为了使跑鞋更好地减震以便更有效地保护运动员，迄今为止也不知道更新了多少专利。
-登山运动员也一样，除了各种训练方式的改进之外，所有的设备包括登山绳、登山锤、登山鞋和手套都在不断改良，为了减重，通过科研，把所有衣服的材质全都更换了不知道多少遍，保暖衣在越来越薄越来越轻的同时，不仅能更好地吸汗还能更好地透气。
+登山运动员也一样，除了各种训练方式的改进之外，所有的装备包括登山绳、登山锤、登山鞋和手套都在不断改良，为了减重，通过科技手段，所有衣服的材质全都被更换了不知道多少遍，保暖衣在越来越薄越来越轻的同时，既能更好地吸汗还能更好地透气。
-在健身房里，人体的骨骼肌总计 600 多块，其中的每一块肌肉都有许多种专门的训练方法，并且往往有专门的设备可供使用，并且永远不止一种可供选择…… 并且，无论是方法还是设备，都在不断研究不断改进。
+人体的骨骼肌总计 600 多块。在健身房里，每一块肌肉都有许多种专门的训练方法，并且往往有不止一种专门的器械可供使用，并且永远不止一种可供选择…… 并且，无论是方法还是器械，都在不断研究不断改进。
遗憾的是，在健脑方面，人类基本停留在百年甚至千年之前。人们不知道有哪些部位需要训练，甚至压根就没想到还有健脑的必要，当然也因此完全不存在什么针对性训练及其相关设备。
幸运的是，最佳的健脑项目过于显而易见 —— **锻炼自然语言使用能力**，无论哪一种语言。
-**掌握并使用自然语言**，也许是所有人终生所能遇见的最复杂且有最系统的大脑工作任务。令人惊讶的是，与此同时，对大脑来说，掌握并使用自然语言，其实并不是生存必需…… 胃坏了牙坏了肯定不行，聋了哑了其实并无所谓，毕竟聋哑实际上并不影响一个人的寿命。
+**掌握并使用自然语言**，也许是所有人终生所能遇见的最复杂且又最系统的大脑工作任务。令人惊讶的是，与此同时，对大脑来说，掌握并使用自然语言，其实并不是生存必需…… 胃坏了牙坏了肯定不行，聋了哑了其实并无所谓，毕竟聋哑实际上并不影响一个人的寿命。
自然语言可以很简单。日常生活里，人们大约只需要 500～1000 的词汇量就足够完成日常必要沟通。当然，自然语言也可以无限复杂。现代汉语大词典收录单字字头 13,000 多个，各类词语 156,000 多条；而牛津英语词典收录了 301,000 个词条。
@@ -20,7 +20,7 @@
科学，主要使用的是**人工语言**。人工语言是自然语言的一个子集，由相对极少的词汇与一些作为补充的符号构成 —— 数学如此、物理如此，化学如此，计算机的编程语言也是如此。从自然语言中提取精简且又系统的人工语言，是人类的一大创举，也使得人类的智慧可以迅速积累极大提高。与此同时，主要由人工语言构成的知识，到最后还是得靠自然语言才能更大面积传播。
-与之相对的，我们在学校里花最长时间学习的，也是语文课，从开始上学一直到学校毕业。不仅如此，到了近代，全球的教育体系都一样，都纳入了第二语言学习，同样贯穿整个在校教育过程 —— 虽然效果并不怎么样。
+与之相对的，我们在学校里花最长时间学习的，也是语文课，从开始上学一直到学校毕业。不仅如此，到了近代，全球的教育体系都一样，都纳入了第二语言学习，且同样贯穿整个在校教育过程 —— 虽然效果并不怎么样。
实际上，如果我们肯穿过表象看透实质的话，学校里的一切课程都是语文课 —— 本质上都是老师们在用**自然语言**讲授用**人工语言**记录并传播的**知识**。很多人数理化成绩不佳，底层原因其实是语文问题。科学知识本身没多复杂，但，语文基础不过关的结果是，课程听不懂，或者题目读不懂，理解不完整，甚至干脆理解错误，这才导致了最终浮现在表面的那些千奇百怪的问题。
@@ -30,16 +30,16 @@
你跑马拉松，无论如何也不可能只用 3 分钟跑完；你登山，地球上也没有海拔 10,000 米以上的山峰可以让你爬，你去健身，无论怎么练也不可能把自己练成 200 公斤以上 —— 据说目前地球上最重的健身运动员体重是 400 磅，身高 193 厘米，每天要摄入 12,000 卡路里才行，那也只不过是 181.44 公斤。
-可自然语言使用能力不一样，无限空间无限可能。你可以把它练得更好，使自己的日常沟通更为有效，或者让自己通过公开讲演获得更多的影响力；你也可以用它写书，小说或者非小说；你还可以用它写剧本，电视、电影、短剧…… 你还可以学习并使用多种语言，每一种语言都有同样无限的可能性…… 没有尽头。
+可自然语言使用能力不一样，无限空间无限可能。你可以把它练得更好，使自己的日常沟通更为有效，或者让自己通过公开讲演获得更多的影响力；你也可以用它写书，虚构类或者非虚构类；你还可以用它写剧本、电视、电影、短剧…… 你还可以学习并使用多种语言，每一种语言都有同样无限的可能性…… 没有尽头。
自然语言使用之于脑力正如马拉松之于体力。如果，跑步是最为普适的**健身运动**，那么，自然语言使用就是最有趣且最为普适的**健脑运动**。
显然，跑步相对于自然语言使用来看更为枯燥。事实上，一切体育运动相对于自然语言使用来看都显得枯燥许多，因为自然语言是更大的更复杂的网络，由更多的节点构成。用得不好就算了，用得好的话，有趣的地方实在是太多。
-**跑步**锻炼最多使用最多的是对体力运动来说最重要的器官，**心**与**肺**。而**自然语言使用**对应的是大脑里的**白质**与**灰质**。语言能力更强的人以及多语使用者，从大脑结构上来看，他们都比其他人拥有相对覆盖面积更大的**白质**和密度更高体积更大的**灰质** —— **这不是天生的，这只能是后天训练的结果**。
+**跑步**锻炼最多使用最多的是对体力运动来说最重要的器官，**心**与**肺**。而**自然语言使用**对应的是大脑里的**白质**与**灰质**。语言能力更强的人以及多语使用者，从大脑结构上来看，他们都比其他人拥有相对覆盖面积更广的**白质**和密度更高体积更大的**灰质** —— **这不是天生的，这只能是后天训练的结果**。
关键在于，白质和灰质不止用来处理语言…… 事实上，人类无论做什么都用它们靠它们。白质的主要功能之一是协调大脑的各个部分，它的**覆盖面积**越广，大脑各部分之间的**协同效率就**越高。**灰质**是中枢神经系统对信息进行深入处理的部位，它的**密度**越高**体积**越大，人就越聪明，因为那里已经存储、相互关联、可以处理的信息就越多。
脑科学家们对各类专家的大脑进行扫描的结果发现，虽然大家术业有专攻，但到最后，这些人的大脑都具备相同的表征 —— 都是白质覆盖面积相对更广，灰质密度相对更高、灰质体积也相对更大。与此同时，白质覆盖面积相对更广、灰质密度相对更高、灰质体积相对更大的人，无论学什么都更快，无论做什么都更好。不仅如此，这样的人还更擅长处理多任务，所以做事的时候总是效率更高。总而言之，他们的**大脑可塑性**总是相对更强。
-并且，随着年龄增加，白质覆盖面积相对更广、灰质密度相对更高、体积相对更大的人，抗衰老能力更强。所谓的**耳聪目明**，实际上并不是耳膜或者眼角膜所决定的，真正决定视力和听力的其实是大脑。如果大脑出了问题，即便耳膜眼角膜都正常，视力和听力也都会出问题。所以，更大覆盖面积的白质，密度更高体积更大的灰质，自然会延缓大脑衰老，也能预防很多老年疾病，比如帕金森症综合症。对普通人都适用的是，更好的大脑机能显然会更少罹患抑郁症。
\ No newline at end of file
+并且，随着年龄增加，白质覆盖面积相对更广、灰质密度相对更高、体积相对更大的人，抗衰老能力更强。所谓的**耳聪目明**，实际上并不是耳膜或者眼角膜所决定的，真正决定视力和听力的其实是大脑。如果大脑出了问题，即便耳膜眼角膜都正常，视力和听力也都会出问题。所以，更广覆盖面积的白质，密度更高体积更大的灰质，自然会延缓大脑衰老，也能预防很多老年疾病，比如帕金森症综合症。对普通人都适用的是，更好的大脑机能显然会更少罹患抑郁症。
\ No newline at end of file
diff --git a/enjoy-docs/.gitignore b/enjoy-docs/.gitignore
new file mode 100644
index 000000000..afca1161e
--- /dev/null
+++ b/enjoy-docs/.gitignore
@@ -0,0 +1,139 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# vuepress v2.x temp and cache directory
+.temp
+.cache
+
+# Docusaurus cache and generated files
+.docusaurus
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# yarn v2
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+.DS_Store
+./public/jupyter-notebooks/*.mp3
+
+.vitepress/cache/
+
+.jupyter
+.ipynb_checkpoints
+
diff --git a/enjoy-docs/.vitepress/config.mts b/enjoy-docs/.vitepress/config.mts
new file mode 100644
index 000000000..49e70fc73
--- /dev/null
+++ b/enjoy-docs/.vitepress/config.mts
@@ -0,0 +1,93 @@
+import { defineConfig } from "vitepress";
+
+// https://vitepress.dev/reference/site-config
+export default defineConfig({
+ lang: "zh-CN", // 'en-US
+ title: "Enjoy App",
+ description: "Enjoy 用户手册",
+ head: [
+ [
+ "script",
+ { async: "", src: "https://www.googletagmanager.com/gtag/js?id=G-RY5XCM04NL" },
+ ],
+ [
+ "script",
+ {},
+ `window.dataLayer = window.dataLayer || [];
+ function gtag(){dataLayer.push(arguments);}
+ gtag('js', new Date());
+ gtag('config', 'G-RY5XCM04NL');`,
+ ],
+ ["link", { rel: "icon", href: "/favicon.ico" }],
+ ],
+ themeConfig: {
+ // https://vitepress.dev/reference/default-theme-config
+ logo: "/logo.png",
+ nav: [{ text: "用户手册", link: "/markdown-examples" }],
+
+ sidebar: [
+ {
+ text: "快速开始",
+ collapsed: false,
+ items: [
+ { text: "简介", link: "/guide/intro" },
+ { text: "下载安装", link: "/guide/install" },
+ { text: "软件设置", link: "/guide/settings" },
+ ],
+ },
+ {
+ text: "跟读训练",
+ collapsed: false,
+ items: [
+ { text: "音频资源", link: "/guide/audios" },
+ { text: "视频资源", link: "/guide/videos" },
+ ],
+ },
+ {
+ text: "阅读文本",
+ collapsed: false,
+ items: [
+ { text: "在线文章", link: "/guide/webpage" },
+ { text: "本地电子书", link: "/guide/ebook" },
+ ],
+ },
+ {
+ text: "智能助手",
+ collapsed: false,
+ items: [
+ { text: "简介", link: "/guide/ai-assistant" },
+ { text: "GPT 服务", link: "/guide/gpt-conversation" },
+ { text: "TTS 服务", link: "/guide/tts-conversation" },
+ ],
+ },
+ {
+ text: "使用案例",
+ collapsed: false,
+ items: [
+ {
+ text: "利用 AI 生成训练材料",
+ link: "/guide/use-case-generate-audio-resources",
+ },
+ ],
+ },
+ ],
+
+ socialLinks: [
+ {
+ icon: "github",
+ link: "https://github.com/xiaolai/everyone-can-use-english/tree/main/enjoy-docs",
+ },
+ ],
+
+ editLink: {
+ pattern:
+ "https://github.com/xiaolai/everyone-can-use-english/edit/main/enjoy-docs/:path",
+ text: "在 GitHub 上编辑此页面",
+ },
+
+ search: {
+ provider: "local",
+ },
+ },
+ lastUpdated: true,
+});
diff --git a/enjoy-docs/guide/ai-assistant.md b/enjoy-docs/guide/ai-assistant.md
new file mode 100644
index 000000000..7bfeed333
--- /dev/null
+++ b/enjoy-docs/guide/ai-assistant.md
@@ -0,0 +1,19 @@
+# 简介
+
+所有智能助手均以 **对话** 的形式呈现，添加一个对话即添加一个智能助手。
+
+左侧栏点击 `智能助手` 即可进入。
+
+## 添加对话
+
+点击 `新对话` 按钮，弹窗出现预设的 AI 角色，可以快速创建有用的智能助手，也可以选择自定义。
+
+创建对话前，需要先填写相关的配置，最重要的几项是：
+
+- AI 类型，分为 [GPT](./gpt-conversation.md) 和 [TTS](./tts-conversation.md) 两种；
+- AI 引擎，每次新建都将加载 [默认 AI 引擎](./settings.md#默认-ai-引擎)，创建时可以修改，创建后无法修改；
+- 角色定义，[GPT](./tts-conversation.md) 类型时可以定义，即将 AI 赋予一个特定的角色以得到想要的回答；
+
+## 修改对话
+
+在对话页面，右上角齿轮可以打开对话的配置，进行修改，或者删除。需要注意的是，AI 类型和 AI 引擎无法修改，需要变更时请新建一个对话。
diff --git a/enjoy-docs/guide/audios.md b/enjoy-docs/guide/audios.md
new file mode 100644
index 000000000..612fde45e
--- /dev/null
+++ b/enjoy-docs/guide/audios.md
@@ -0,0 +1,58 @@
+# 音频资源
+
+利用音视频资源进行跟读训练是 Enjoy 的核心功能之一。
+
+## 添加音频资源
+
+Enjoy 支持添加本地的音频资源，和在线资源。在音频页面，点击 `添加资源`，在弹窗中输入网址，或者点击 `本地文件` 选择本地计算机的音频文件即可添加。
+
+如果是在线资源，Enjoy 会将文件下载至默认的下载文件夹（`Downdoads` 或者 `我的下载`），然后再自动添加至 [资源库](./settings#资源库保存路径)。
+
+## 跟读音频
+
+添加成功后，会自动跳转至音频播放页面。
+
+打开时，需要先解析音频波形数据（并生成 Pitch contour）和生成音频字幕（使用 [语音转文本服务](./settings#语音转文本服务)）。首次打开时，可能需要等待一些时间。所需数据生成成功之后，后续再次打开时的速度会比较快。
+
+::: tip 卡在加载页面怎么办？
+打开音频页面时，会先按照以下步骤进行加载：
+
+1. 解析音频波形数据
+2. 语音转文本
+
+如果长时间卡在第一步，可能是因为音频太大（主要跟音频时长有关）导致加载时间过长，甚至失败。如果不是音频大小的原因，可能是出现了其他 bug，请联系开发者。
+
+如果第二步语音转文本失败，请检查是否在正在使用本地 whisper 组件进行语音转文本，在某些电脑上可能因为兼容性和未知问题导致无法使用。如果出现这种情况，请在 [语音转文本服务设置](./settings#语音转文本服务) 中改用其他语音转文本的云服务。
+:::
+
+## 录音
+
+Enjoy 会将音频按照句子切分，用户以句子为单位进行跟读练习。在激活的音频句子下，点击下方的录音按钮，即可开始录音，用户可以模仿音频朗读当前句子作为练习。
+
+
+_\* 音频播放页面_
+
+::: tip 录音权限
+在 Mac 电脑上，首次使用录音功能时，会弹窗请求麦克风的使用权限，请务必点允许，否则无法使用录音功能。
+:::
+
+## 发音评估
+
+Enjoy 集成了微软 Azure 的发音评估功能，作为自我的发音检查参考。点击录音右下方的仪表盘图标，即可打开发音评估弹窗。
+
+该功能会以**录音时的句子文本作为参考**，评估录音的发音情况，各指标的详细说明可以参考微软的 [官方文档](https://learn.microsoft.com/en-us/azure/ai-services/speech-service/how-to-pronunciation-assessment?pivots=programming-language-javascript#scripted-assessment-results)。
+
+
+_\* 发音评估示例_
+
+::: warning 发音评估的使用建议
+该功能是收费功能，每次使用均会在 Enjoy 账户的余额扣费，如果余额不足则需要 [充值](./settings#充值) 后才可继续使用。
+
+根据实测，该功能对提高学习者的发音作用水平有限，其评估结果仅做参考，不应该过度依赖。
+
+另外，我们正在开发一套更有效的发音评估体系，敬请期待。
+:::
+
+## 修改音频信息
+
+在音频页面上方，切换至列表模式，即可以对音频进行修改操作，例如修改音频标题，添加描述，和删除音频等。
diff --git a/enjoy-docs/guide/ebook.md b/enjoy-docs/guide/ebook.md
new file mode 100644
index 000000000..478687c98
--- /dev/null
+++ b/enjoy-docs/guide/ebook.md
@@ -0,0 +1,3 @@
+# 本地电子书
+
+待开发，敬请期待。
diff --git a/enjoy-docs/guide/gpt-conversation.md b/enjoy-docs/guide/gpt-conversation.md
new file mode 100644
index 000000000..d4a41bad7
--- /dev/null
+++ b/enjoy-docs/guide/gpt-conversation.md
@@ -0,0 +1,7 @@
+# GPT 服务
+
+当 AI 类型选择 `GPT` 时，AI 将会根据 `角色定义` 来回答你提出的所有问题。
+
+例如定义一个 `英语教练` 的角色，可以将你发的所有文字翻译成地道的英文表达，再配合 [TTS](./tts-conversation.md) 将其转化成语音，即可作为跟读的材料。
+
+详情可以参照使用案例：[利用 AI 生成训练材料](./use-case-generate-audio-resources.md)
diff --git a/enjoy-docs/guide/install.md b/enjoy-docs/guide/install.md
new file mode 100644
index 000000000..cfc4d8072
--- /dev/null
+++ b/enjoy-docs/guide/install.md
@@ -0,0 +1,43 @@
+# 下载安装
+
+Enjoy App 是一个跨平台的桌面应用，可以在 Windows、Mac 和 Linux 等电脑设备上运行。
+
+请根据电脑设备的操作系统，下载相应的版本安装使用。
+
+## Windows
+
+支持 Windows 10 以上版本。
+
+[点击下载](https://github.com/xiaolai/everyone-can-use-english/releases/download/v0.1.0-alpha.12/Enjoy-0.1.0-alpha.12-Setup.exe)
+
+下载后，双击即可安装。
+
+## Mac
+
+根据使用 Mac 电脑的芯片不同，需要下载不同的版本。
+
+- [Silicon 芯片版本(arm64)](https://github.com/xiaolai/everyone-can-use-english/releases/download/v0.1.0-alpha.12/Enjoy-darwin-arm64-0.1.0-alpha.12.zip)
+- [Intel 芯片版本(x64)](https://github.com/xiaolai/everyone-can-use-english/releases/download/v0.1.0-alpha.12/Enjoy-darwin-x64-0.1.0-alpha.12.zip)
+
+::: info 如何查看本机配置
+M1 以后的 Mac 电脑型号(M1、M2、M3)，均为 Silicon 芯片。
+
+如果你不清楚自己电脑的具体型号，可以点击屏幕左上方的 符号，在弹出来的菜单中，选择第一个选项 “关于本机（About This Mac）”，在弹出的窗口中，即可看到本机的硬件和系统配置。
+
+如果显示的是 _Apple M 系列_，即为 Silicon 芯片。
+:::
+
+::: warning 警告
+推荐使用 macOS 12 及以上版本，macOS 11 可能无法使用部分功能。
+:::
+
+## Linux
+
+请根据不同发行版本选用安装文件。
+
+- [下载 deb 版本](https://github.com/xiaolai/everyone-can-use-english/releases/download/v0.1.0-alpha.12/enjoy_0.1.0-alpha.12_amd64.deb)
+- [下载 rpm 版本](https://github.com/xiaolai/everyone-can-use-english/releases/download/v0.1.0-alpha.12/enjoy-0.1.0.alpha.12-1.x86_64.rpm)
+
+## 历史版本
+
+所有历史版本均可在 [这里](https://github.com/xiaolai/everyone-can-use-english/releases) 找到。
diff --git a/enjoy-docs/guide/intro.md b/enjoy-docs/guide/intro.md
new file mode 100644
index 000000000..c1e7132ce
--- /dev/null
+++ b/enjoy-docs/guide/intro.md
@@ -0,0 +1,7 @@
+# 简介
+
+AI 是当今世界上最好的外语老师，Enjoy 做 **AI 最好的助教**。
+
+::: warning 重要提示
+Enjoy App 的开发仍处于早期的快速迭代阶段，文档可能落后于开发，导致功能描述可能不符，以最新发布的软件版本为准。
+:::
diff --git a/enjoy-docs/guide/settings.md b/enjoy-docs/guide/settings.md
new file mode 100644
index 000000000..b346ee287
--- /dev/null
+++ b/enjoy-docs/guide/settings.md
@@ -0,0 +1,161 @@
+# 软件设置
+
+Enjoy 只需要登录后即可直接使用，**无需其他设置**。但是，你仍然可以根据需要做个性化的设置。
+
+打开 Enjoy 软件，点击左侧栏最下面的齿轮按钮，即可打开 `软件设置`。
+
+## 资源库保存路径
+
+::: info 设置路径
+软件设置 -> 基本设置 -> 资源库保存路径
+:::
+
+Enjoy 采用 **本地优先** 的设计原则，大部分数据均保存在本地，即 **资源库保存路径** 下。
+所谓资源库是一个名为 `EnjoyLibrary` 的文件夹，默认放置在 `My Documents` （即 `我的文档`）下。
+
+随着 Enjoy 的使用时间增长，资源库文件夹里可能会产生比较大的缓存文件，导致占用空间较大。根据具体需要，你也可以修改资源库的路径，例如从 _C 盘_ 改到空间更大的 _D 盘_。
+
+如果已经产生了数据，修改时，可以先把原来的 `EnjoyLibrary` 文件夹复制到目标路径下，再在 Enjoy 软件中点`修改`按钮，选中目标路径，然后重启软件，即可完成修改。
+
+::: tip 资源库里都有什么
+打开 `EnjoyLibrary` 文件夹，你能看到类似以下的目录结构
+
+```
+.
+├── 2400xxxx
+│ ├── audios
+│ │ ├── 0687ae31c4178bbf0466503e56d887f8.mp3
+│ │ └── ...
+│ ├── enjoy_database.sqlite
+│ ├── recordings
+│ │ ├── 025542894635903d5ea6f2395cb404c0.wav
+│ │ └── ...
+│ ├── speeches
+│ │ ├── 0687ae31c4178bbf0466503e56d887f8.mp3
+│ │ └── ...
+│ └── videos
+│ ├── 23876d46305bae2e049c691872dd3cde.mkv
+│ └── ...
+├── cache
+│ ├── 0687ae31c4178bbf0466503e56d887f8.json
+│ └── ...
+├── logs
+│ ├── main.log
+│ └── main.old.log
+├── waveforms
+│ ├── 0687ae31c4178bbf0466503e56d887f8.waveform.json
+│ └── ...
+└── whisper
+│ ├── models
+│ │ ├── tiny.en.bin
+│ │ └── ...
+```
+
+- `/2400xxxx/`: 登录的 Enjoy 帐号 ID，该文件夹下的数据均是你使用产生的个人数据
+ - `/2400xxxx/audios/`: 添加的音频文件
+ - `/2400xxxx/speeches/`: TTS 生成的语音文件
+ - `/2400xxxx/videos/`: 添加的视频文件
+ - `/2400xxxx/recordings/`: 录音文件
+ - `/2400xxxx/enjoy_database.sqlite`: 个人数据库文件
+- `/cache/`: 使用过程中产生的缓存文件，如果占用空间过大，可以安全地删除
+- `/logs/`: 保存软件运行的日志，用于帮助开发人员排除故障
+- `/waveforms/`: 音视频解码后的波形数据缓存
+- `/whisper/models`: 语音转文字服务软件 whisper 的模型文件
+
+:::
+
+::: danger 个人数据安全
+`EnjoyLibrary/2400xxxx/` 文件夹下保存的均为使用 Enjoy 过程中产生的个人数据，请务必**不要删改**该文件夹下的任何文件，否则可能会导致数据丢失，或者使得 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://huggingface.co/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 设置路径
+软件设置 -> 账户设置 -> 余额
+:::
+
+Enjoy 提供了部分收费的 AI 服务，均为 **按使用量收费**，每次使用会在余额中扣除相应的费用，直到余额不足，则停止提供该服务。
+
+如果需要继续使用，请点击 `充值` 按钮进行充值。
+
+::: danger 充值前须知
+需要特别注意的是，充值成功后将在 Enjoy 账户的余额体现，所有余额仅可作为支付 Enjoy 收费服务使用，**不支持退款**，**不支持提现**。
+
+请谨慎考虑，按需充值。
+:::
diff --git a/enjoy-docs/guide/tts-conversation.md b/enjoy-docs/guide/tts-conversation.md
new file mode 100644
index 000000000..70a7534fe
--- /dev/null
+++ b/enjoy-docs/guide/tts-conversation.md
@@ -0,0 +1,5 @@
+# TTS 服务
+
+当 AI 类型选择 `TTS` 时，该对话将提供文本转语音（Text to Speech）服务，即 AI 会将你发出的任意文本转化成语音（音频文件）。生成的语音，可以直接添加至资源库进行跟读练习。
+
+在设置里可以修改语音的角色。
diff --git a/enjoy-docs/guide/use-case-generate-audio-resources.md b/enjoy-docs/guide/use-case-generate-audio-resources.md
new file mode 100644
index 000000000..8ce2ecd23
--- /dev/null
+++ b/enjoy-docs/guide/use-case-generate-audio-resources.md
@@ -0,0 +1,45 @@
+# 利用 AI 生成训练材料
+
+用外语说我们自己想说的话是学习外语的其中一个重要目的。市面上的口语书实际上并不实用，因为那些话大都不是我们想要说的，我们需要创建专属自己的口语书。使用 Enjoy 可以很容易做到这一点。
+
+## 确保 AI 服务正常
+
+在开始之前，先要确保 AI 服务可以正常使用，要么配置好自己的 [OpenAI 密钥](./settings#openai-配置)，要么使用 Enjoy 提供的 AI 服务并确保账户 [余额](./settings#充值) 充足。
+
+## 创建英语教练
+
+点击 Enjoy 左侧栏的 `智能助手` 进入页面，点击 `新对话` 开始创建。
+
+角色定义选择预设的 `英语教练`。
+
+
+_\* 选择 AI 角色_
+
+具体配置里，根据具体情况，修改 AI 引擎 为 OpenAI 或者 Enjoy AI。如果使用 [OpenAI](./settings#openai-配置)，可能还需要检查配置 `接口地址`。
+
+将配置拉到最下面，`TTS 引擎` 也需要做相应配置。
+
+
+_\* 对话设置_
+
+配置完成后，点击下面的 `确认` 按钮，即可创建成功。
+
+## 发送任意文字
+
+智能助手的使用跟聊天窗口类似，将你想要说的话发给 `英语教练`，作为回复，AI 会将你的文字翻译成地道的纽约腔英语。
+
+## 生成语音
+
+如果你对 AI 的回复感到满意，点击信息下方的朗读图标，将其转化为语音。
+
+
+_\* 英语教练对话_
+
+## 跟读训练
+
+继而点击麦克风图标，将该语音加入资源库，进行跟读训练。
+
+
+_\* 添加跟读训练_
+
+随后也可以在 [音频页面](./audios.md) 找到该材料，继续练习。
diff --git a/enjoy-docs/guide/videos.md b/enjoy-docs/guide/videos.md
new file mode 100644
index 000000000..e7d9a0df2
--- /dev/null
+++ b/enjoy-docs/guide/videos.md
@@ -0,0 +1,20 @@
+# 视频资源
+
+视频资源的使用与 [音频资源](./audios.md) 基本一致。
+
+
+_\* 视频播放页面_
+
+## 录音
+
+在视频播放页面，需要录音时，可以点播放控制栏上的录音图标，视频将会被缩小至小窗，主界面上会显示录音按钮。
+
+## 视频大小的限制
+
+过大的视频文件会导致加载卡死而无法使用，目前 Enjoy 将添加视频的大小限制在 100 Mb，超过则会提示添加失败。
+
+后续会针对大文件做相应优化，以支持更大的文件。
+
+## Youtube 视频
+
+Enjoy 支持添加 Youtube 视频，添加资源时直接输入 Youtobe 网址即可。当然前提是当前网络条件支持访问 Youtube。
diff --git a/enjoy-docs/guide/webpage.md b/enjoy-docs/guide/webpage.md
new file mode 100644
index 000000000..4329beb23
--- /dev/null
+++ b/enjoy-docs/guide/webpage.md
@@ -0,0 +1,19 @@
+# 在线文章
+
+点击左侧栏的 `文章` 进入。
+
+输入文章的网址，即可开始阅读。
+
+
+_\* 文章阅读页面_
+
+## 提取关键词汇
+
+打开文章后，Enjoy 将会智能提取该文章的关键词汇，并在文中标注。该功能需要 AI 引擎的支持，在 [默认 AI 引擎](./settings.md#默认-ai-引擎) 可以设置。
+
+
+_\* 智能提取关键词汇_
+
+## 查单词
+
+在正文中选中任意单词或者短语，即可激活查单词服务，同样需要 [AI 引擎](./settings.md#默认-ai-引擎) 的支持。
diff --git a/enjoy-docs/index.md b/enjoy-docs/index.md
new file mode 100644
index 000000000..a6e0e51c5
--- /dev/null
+++ b/enjoy-docs/index.md
@@ -0,0 +1,12 @@
+---
+# https://vitepress.dev/reference/default-theme-home-page
+layout: home
+
+hero:
+ name: "Enjoy App"
+ tagline: AI 是最好的老师，我们做 AI 最好的助教
+ actions:
+ - theme: brand
+ text: 快速开始
+ link: /guide/intro
+---
diff --git a/enjoy-docs/package.json b/enjoy-docs/package.json
new file mode 100644
index 000000000..baf6463f2
--- /dev/null
+++ b/enjoy-docs/package.json
@@ -0,0 +1,11 @@
+{
+ "name": "enjoy-docs",
+ "scripts": {
+ "dev": "vitepress dev",
+ "build": "vitepress build",
+ "preview": "vitepress preview"
+ },
+ "devDependencies": {
+ "vitepress": "^1.0.0-rc.44"
+ }
+}
diff --git a/enjoy-docs/public/favicon.ico b/enjoy-docs/public/favicon.ico
new file mode 100644
index 000000000..febbdb8d8
Binary files /dev/null and b/enjoy-docs/public/favicon.ico differ
diff --git a/enjoy-docs/public/logo.png b/enjoy-docs/public/logo.png
new file mode 100644
index 000000000..f024d53a1
Binary files /dev/null and b/enjoy-docs/public/logo.png differ
diff --git a/enjoy-docs/public/snapshots/audio-page.png b/enjoy-docs/public/snapshots/audio-page.png
new file mode 100644
index 000000000..8c0868639
Binary files /dev/null and b/enjoy-docs/public/snapshots/audio-page.png differ
diff --git a/enjoy-docs/public/snapshots/conversation-add-speech-to-audio.png b/enjoy-docs/public/snapshots/conversation-add-speech-to-audio.png
new file mode 100644
index 000000000..4e520a426
Binary files /dev/null and b/enjoy-docs/public/snapshots/conversation-add-speech-to-audio.png differ
diff --git a/enjoy-docs/public/snapshots/conversation-form.png b/enjoy-docs/public/snapshots/conversation-form.png
new file mode 100644
index 000000000..969da03eb
Binary files /dev/null and b/enjoy-docs/public/snapshots/conversation-form.png differ
diff --git a/enjoy-docs/public/snapshots/english-coach-gpt-conversation.png b/enjoy-docs/public/snapshots/english-coach-gpt-conversation.png
new file mode 100644
index 000000000..641cc26a8
Binary files /dev/null and b/enjoy-docs/public/snapshots/english-coach-gpt-conversation.png differ
diff --git a/enjoy-docs/public/snapshots/logo.png b/enjoy-docs/public/snapshots/logo.png
new file mode 100644
index 000000000..f024d53a1
Binary files /dev/null and b/enjoy-docs/public/snapshots/logo.png differ
diff --git a/enjoy-docs/public/snapshots/pronouce-assessment.png b/enjoy-docs/public/snapshots/pronouce-assessment.png
new file mode 100644
index 000000000..4449e0488
Binary files /dev/null and b/enjoy-docs/public/snapshots/pronouce-assessment.png differ
diff --git a/enjoy-docs/public/snapshots/select-ai-role.png b/enjoy-docs/public/snapshots/select-ai-role.png
new file mode 100644
index 000000000..a0d06a57c
Binary files /dev/null and b/enjoy-docs/public/snapshots/select-ai-role.png differ
diff --git a/enjoy-docs/public/snapshots/story-key-vocabulary.png b/enjoy-docs/public/snapshots/story-key-vocabulary.png
new file mode 100644
index 000000000..2adae9997
Binary files /dev/null and b/enjoy-docs/public/snapshots/story-key-vocabulary.png differ
diff --git a/enjoy-docs/public/snapshots/story-page.png b/enjoy-docs/public/snapshots/story-page.png
new file mode 100644
index 000000000..cc669ab39
Binary files /dev/null and b/enjoy-docs/public/snapshots/story-page.png differ
diff --git a/enjoy-docs/public/snapshots/video-page.png b/enjoy-docs/public/snapshots/video-page.png
new file mode 100644
index 000000000..ca1aeb9d8
Binary files /dev/null and b/enjoy-docs/public/snapshots/video-page.png differ
diff --git a/enjoy/forge.config.js b/enjoy/forge.config.js
index d493083d5..3c1f93d0e 100644
--- a/enjoy/forge.config.js
+++ b/enjoy/forge.config.js
@@ -3,12 +3,17 @@ import { MakerZIP } from "@electron-forge/maker-zip";
import { MakerDeb } from "@electron-forge/maker-deb";
import { MakerRpm } from "@electron-forge/maker-rpm";
import { VitePlugin } from "@electron-forge/plugin-vite";
-import { FusesPlugin } from "@electron-forge/plugin-fuses";
-import { FuseV1Options, FuseVersion } from "@electron/fuses";
+import os from "os";
+// import { FusesPlugin } from "@electron-forge/plugin-fuses";
+// import { FuseV1Options, FuseVersion } from "@electron/fuses";
const config = {
packagerConfig: {
- asar: false,
+ asar: {
+ // Binary files won't work in asar, so we need to unpack them
+ unpackDir:
+ "{.vite/build/lib,.vite/build/samples,node_modules/ffmpeg-static,node_modules/@andrkrn/ffprobe-static}",
+ },
icon: "./assets/icon",
name: "Enjoy",
executableName: "enjoy",
@@ -21,11 +26,17 @@ const config = {
},
rebuildConfig: {},
makers: [
+ {
+ name: "@electron-forge/maker-dmg",
+ config: {
+ icon: "./assets/icon.png",
+ },
+ },
new MakerSquirrel({
name: "Enjoy",
setupIcon: "./assets/icon.ico",
}),
- new MakerZIP({}, ["darwin", "win32"]),
+ new MakerZIP(["win32"]),
new MakerDeb({
options: {
name: "enjoy",
@@ -51,6 +62,7 @@ const config = {
owner: "xiaolai",
name: "everyone-can-use-english",
},
+ generateReleaseNotes: true,
draft: true,
},
},
@@ -77,18 +89,44 @@ const config = {
},
],
}),
+ {
+ name: "@electron-forge/plugin-auto-unpack-natives",
+ config: {},
+ },
// Fuses are used to enable/disable various Electron functionality
// at package time, before code signing the application
- new FusesPlugin({
- version: FuseVersion.V1,
- [FuseV1Options.RunAsNode]: false,
- [FuseV1Options.EnableCookieEncryption]: true,
- [FuseV1Options.EnableNodeOptionsEnvironmentVariable]: false,
- [FuseV1Options.EnableNodeCliInspectArguments]: true,
- [FuseV1Options.EnableEmbeddedAsarIntegrityValidation]: true,
- [FuseV1Options.OnlyLoadAppFromAsar]: false,
- }),
+ // new FusesPlugin({
+ // version: FuseVersion.V1,
+ // [FuseV1Options.RunAsNode]: false,
+ // [FuseV1Options.EnableCookieEncryption]: true,
+ // [FuseV1Options.EnableNodeOptionsEnvironmentVariable]: false,
+ // [FuseV1Options.EnableNodeCliInspectArguments]: true,
+ // [FuseV1Options.EnableEmbeddedAsarIntegrityValidation]: true,
+ // [FuseV1Options.OnlyLoadAppFromAsar]: false,
+ // }),
],
};
+const macOsCodesignConfig = {
+ osxSign: {},
+ osxNotarize: {
+ tool: "notarytool",
+ appleId: process.env.APPLE_ID,
+ appleIdPassword: process.env.APPLE_APP_PASSWORD,
+ teamId: process.env.APPLE_TEAM_ID,
+ },
+};
+
+if (
+ os.platform() === "darwin" &&
+ process.env.APPLE_ID &&
+ process.env.APPLE_APP_PASSWORD &&
+ process.env.APPLE_TEAM_ID
+) {
+ config.packagerConfig = {
+ ...config.packagerConfig,
+ ...macOsCodesignConfig,
+ };
+}
+
export default config;
diff --git a/enjoy/package.json b/enjoy/package.json
index dd2cfaa64..f016c6c4e 100644
--- a/enjoy/package.json
+++ b/enjoy/package.json
@@ -30,6 +30,7 @@
"devDependencies": {
"@electron-forge/cli": "^7.3.0",
"@electron-forge/maker-deb": "^7.3.0",
+ "@electron-forge/maker-dmg": "^7.3.0",
"@electron-forge/maker-rpm": "^7.3.0",
"@electron-forge/maker-squirrel": "^7.3.0",
"@electron-forge/maker-zip": "^7.3.0",
@@ -38,7 +39,7 @@
"@electron-forge/plugin-vite": "^7.3.0",
"@electron-forge/publisher-github": "^7.3.0",
"@electron/fuses": "^1.7.0",
- "@playwright/test": "^1.41.2",
+ "@playwright/test": "^1.42.0",
"@tailwindcss/typography": "^0.5.10",
"@types/autosize": "^4.0.3",
"@types/command-exists": "^1.2.3",
@@ -48,18 +49,18 @@
"@types/intl-tel-input": "^18.1.4",
"@types/lodash": "^4.14.202",
"@types/mark.js": "^8.11.12",
- "@types/node": "^20.11.19",
- "@types/react": "^18.2.57",
+ "@types/node": "^20.11.24",
+ "@types/react": "^18.2.61",
"@types/react-dom": "^18.2.19",
"@types/validator": "^13.11.9",
"@types/wavesurfer.js": "^6.0.12",
- "@typescript-eslint/eslint-plugin": "^7.0.2",
- "@typescript-eslint/parser": "^7.0.2",
+ "@typescript-eslint/eslint-plugin": "^7.1.0",
+ "@typescript-eslint/parser": "^7.1.0",
"@vitejs/plugin-react": "^4.2.1",
"autoprefixer": "^10.4.17",
- "electron": "^29.0.1",
+ "electron": "^29.1.0",
"electron-playwright-helpers": "^1.7.1",
- "eslint": "^8.56.0",
+ "eslint": "^8.57.0",
"eslint-import-resolver-typescript": "^3.6.1",
"eslint-plugin-import": "^2.29.1",
"flora-colossus": "^2.0.0",
@@ -106,7 +107,7 @@
"@radix-ui/react-toggle": "^1.0.3",
"@radix-ui/react-tooltip": "^1.0.7",
"@uidotdev/usehooks": "^2.4.1",
- "@vidstack/react": "^1.10.9",
+ "@vidstack/react": "^0.6.14",
"autosize": "^6.0.1",
"axios": "^1.6.7",
"camelcase": "^8.0.0",
@@ -130,11 +131,11 @@
"html-to-text": "^9.0.5",
"https-proxy-agent": "^7.0.4",
"i18next": "^23.10.0",
- "intl-tel-input": "^19.2.20",
+ "intl-tel-input": "^19.5.4",
"js-md5": "^0.8.3",
"langchain": "^0.1.21",
"lodash": "^4.17.21",
- "lucide-react": "^0.336.0",
+ "lucide-react": "^0.344.0",
"mark.js": "^8.11.1",
"microsoft-cognitiveservices-speech-sdk": "^1.35.0",
"next-themes": "^0.2.1",
@@ -149,13 +150,13 @@
"react-hotkeys-hook": "^4.5.0",
"react-i18next": "^14.0.5",
"react-markdown": "^9.0.1",
- "react-router-dom": "^6.22.1",
+ "react-router-dom": "^6.22.2",
"react-tooltip": "^5.26.3",
"reflect-metadata": "^0.2.1",
"rimraf": "^5.0.5",
"sequelize": "^6.37.1",
"sequelize-typescript": "^2.1.6",
- "sonner": "^1.4.0",
+ "sonner": "^1.4.3",
"sqlite3": "^5.1.7",
"tailwind-scrollbar-hide": "^1.1.7",
"umzug": "^3.7.0",
diff --git a/enjoy/scripts/add-macos-cert.sh b/enjoy/scripts/add-macos-cert.sh
new file mode 100755
index 000000000..0e44fafdc
--- /dev/null
+++ b/enjoy/scripts/add-macos-cert.sh
@@ -0,0 +1,23 @@
+#!/usr/bin/env sh
+
+KEY_CHAIN=build.keychain
+CERTIFICATE_P12=certificate.p12
+
+# Recreate the certificate from the secure environment variable
+echo $MACOS_CERTIFICATE_APPLICATION_BASE64 | base64 --decode > $CERTIFICATE_P12
+
+#create a keychain
+security create-keychain -p actions $KEY_CHAIN
+
+# Make the keychain the default so identities are found
+security default-keychain -s $KEY_CHAIN
+
+# Unlock the keychain
+security unlock-keychain -p actions $KEY_CHAIN
+
+security import $CERTIFICATE_P12 -k $KEY_CHAIN -P $MACOS_CERTIFICATE_PASSWORD -T /usr/bin/codesign -T /usr/bin/productbuild;
+
+security set-key-partition-list -S apple-tool:,apple: -s -k actions $KEY_CHAIN
+
+# remove certs
+rm -fr *.p12
diff --git a/enjoy/src/api/client.ts b/enjoy/src/api/client.ts
index ec6763c33..cd7963976 100644
--- a/enjoy/src/api/client.ts
+++ b/enjoy/src/api/client.ts
@@ -297,4 +297,28 @@ export class Client {
unstarStory(storyId: string): Promise<{ starred: boolean }> {
return this.api.delete(`/api/mine/stories/${storyId}`);
}
+
+ createPayment(params: {
+ amount: number;
+ processor: string;
+ paymentType: string;
+ }): Promise