@rookiestar/eng-lang-tutor 1.2.2 → 1.2.4

package/CHANGELOG.md

@@ -2,6 +2,52 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.2.4] - 2026-02-27
+
+### Fixed
+- **TTS voice selection**: Audio composer now automatically selects appropriate voices based on TTS provider
+  - Edge-TTS: `en-US-JennyNeural`, `en-US-EricNeural`
+  - XunFei: `catherine`, `henry`
+- **CLI import paths**: Fixed broken imports in `state_manager.py` CLI module
+
+### Changed
+- **npm package**: Removed automatic `pip install` from postinstall script
+  - Added `eng-lang-tutor-setup` CLI tool for manual dependency installation
+  - Supports `--venv`, `--user`, and `--check` options
+- **Test coverage**: Added 38 new tests covering:
+  - `scripts/audio/utils.py` (6 tests)
+  - `scripts/audio/converter.py` (16 tests)
+  - `scripts/utils/helpers.py` (16 tests)
+- **Test fixes**: Fixed pre-existing test failures in CLI and TTS modules
+
+## [1.2.3] - 2026-02-27
+
+### Changed
+- Version bump for npm publishing
+
+## [1.2.0] - 2026-02-27
+
+### Changed
+- Initial npm package setup
+
+## [1.0.1] - 2025-02-27
+
+### Fixed
+- **TTS voice selection**: Audio composer now automatically selects appropriate voices based on TTS provider
+  - Edge-TTS: `en-US-JennyNeural`, `en-US-EricNeural`
+  - XunFei: `catherine`, `henry`
+- **CLI import paths**: Fixed broken imports in `state_manager.py` CLI module
+
+### Changed
+- **npm package**: Removed automatic `pip install` from postinstall script
+  - Added `eng-lang-tutor-setup` CLI tool for manual dependency installation
+  - Supports `--venv`, `--user`, and `--check` options
+- **Test coverage**: Added 38 new tests covering:
+  - `scripts/audio/utils.py` (6 tests)
+  - `scripts/audio/converter.py` (16 tests)
+  - `scripts/utils/helpers.py` (16 tests)
+- **Test fixes**: Fixed pre-existing test failures in CLI and TTS modules
+
 ## [1.0.1] - 2025-02-27
 
 ### Changed

package/README.md

@@ -277,6 +277,7 @@ eng-lang-tutor/
 │   ├── cli/                    # 命令行模块
 │   │   ├── cli.py              # CLI 入口点
 │   │   └── command_parser.py   # 用户命令解析
+│   ├── setup.py                # 依赖安装脚本 (npm bin)
 │   ├── scheduling/             # 调度模块
 │   │   └── cron_push.py        # 定时内容推送
 │   ├── utils/                  # 工具模块

package/backups/state_backup_20260227_063358.json

@@ -0,0 +1,47 @@
+{
+  "version": 2,
+  "initialized": false,
+  "onboarding_step": 0,
+  "completion_status": {
+    "quiz_completed_date": null,
+    "keypoint_view_history": []
+  },
+  "schedule": {
+    "keypoint_time": "06:45",
+    "quiz_time": "22:45",
+    "timezone": "Asia/Shanghai"
+  },
+  "user": {
+    "xp": 0,
+    "level": 1,
+    "streak": 0,
+    "streak_freeze": 0,
+    "gems": 0,
+    "badges": []
+  },
+  "preferences": {
+    "cefr_level": "B1",
+    "oral_written_ratio": 0.7,
+    "topics": {
+      "movies": 0.2,
+      "news": 0.15,
+      "gaming": 0.15,
+      "sports": 0.1,
+      "workplace": 0.2,
+      "social": 0.1,
+      "daily_life": 0.1
+    },
+    "tutor_style": "humorous",
+    "dedup_days": 14
+  },
+  "progress": {
+    "total_quizzes": 0,
+    "correct_rate": 0.0,
+    "last_study_date": null,
+    "perfect_quizzes": 0,
+    "expressions_learned": 0
+  },
+  "recent_topics": [],
+  "error_notebook": [],
+  "error_archive": []
+}

package/backups/state_backup_20260227_063405.json

@@ -0,0 +1,47 @@
+{
+  "version": 2,
+  "initialized": false,
+  "onboarding_step": 0,
+  "completion_status": {
+    "quiz_completed_date": null,
+    "keypoint_view_history": []
+  },
+  "schedule": {
+    "keypoint_time": "06:45",
+    "quiz_time": "22:45",
+    "timezone": "Asia/Shanghai"
+  },
+  "user": {
+    "xp": 0,
+    "level": 1,
+    "streak": 0,
+    "streak_freeze": 0,
+    "gems": 0,
+    "badges": []
+  },
+  "preferences": {
+    "cefr_level": "B1",
+    "oral_written_ratio": 0.7,
+    "topics": {
+      "movies": 0.2,
+      "news": 0.15,
+      "gaming": 0.15,
+      "sports": 0.1,
+      "workplace": 0.2,
+      "social": 0.1,
+      "daily_life": 0.1
+    },
+    "tutor_style": "humorous",
+    "dedup_days": 14
+  },
+  "progress": {
+    "total_quizzes": 0,
+    "correct_rate": 0.0,
+    "last_study_date": null,
+    "perfect_quizzes": 0,
+    "expressions_learned": 0
+  },
+  "recent_topics": [],
+  "error_notebook": [],
+  "error_archive": []
+}

package/backups/state_backup_20260227_064016.json

@@ -0,0 +1,47 @@
+{
+  "version": 2,
+  "initialized": false,
+  "onboarding_step": 0,
+  "completion_status": {
+    "quiz_completed_date": null,
+    "keypoint_view_history": []
+  },
+  "schedule": {
+    "keypoint_time": "06:45",
+    "quiz_time": "22:45",
+    "timezone": "Asia/Shanghai"
+  },
+  "user": {
+    "xp": 0,
+    "level": 1,
+    "streak": 0,
+    "streak_freeze": 0,
+    "gems": 0,
+    "badges": []
+  },
+  "preferences": {
+    "cefr_level": "B1",
+    "oral_written_ratio": 0.7,
+    "topics": {
+      "movies": 0.2,
+      "news": 0.15,
+      "gaming": 0.15,
+      "sports": 0.1,
+      "workplace": 0.2,
+      "social": 0.1,
+      "daily_life": 0.1
+    },
+    "tutor_style": "humorous",
+    "dedup_days": 14
+  },
+  "progress": {
+    "total_quizzes": 0,
+    "correct_rate": 0.0,
+    "last_study_date": null,
+    "perfect_quizzes": 0,
+    "expressions_learned": 0
+  },
+  "recent_topics": [],
+  "error_notebook": [],
+  "error_archive": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rookiestar/eng-lang-tutor",
-  "version": "1.2.2",
+  "version": "1.2.4",
   "description": "地道美式英语导师 - OpenClaw Skill for learning authentic American English",
   "main": "scripts/cli/cli.py",
   "bin": {

package/scripts/audio/composer.py

@@ -87,9 +87,9 @@ class AudioComposer:
         lead_in_silence: float = 1.0,   # 引导语后留白
         section_silence: float = 2.0,   # 内容后留白（段落间隔）
         dialogue_silence: float = 0.5,  # 对话行之间留白
-        narrator_voice: str = "henry",  # 旁白音色（男声）
-        voice_a: str = "mary",          # 对话 A 音色（女声）
-        voice_b: str = "henry",         # 对话 B 音色（男声，沉稳）
+        narrator_voice: str = None,     # 旁白音色（None 时使用 TTS provider 默认值）
+        voice_a: str = None,            # 对话 A 音色（None 时使用 TTS provider 默认值）
+        voice_b: str = None,            # 对话 B 音色（None 时使用 TTS provider 默认值）
         speed: float = 0.9              # 语速
     ) -> CompositionResult:
         """
@@ -110,6 +110,11 @@ class AudioComposer:
             CompositionResult: 合成结果
         """
         try:
+            # 使用 TTS provider 的默认音色（自动适配 Edge-TTS 或讯飞）
+            narrator_voice = narrator_voice or self.tts.get_voice_by_role("narrator")
+            voice_a = voice_a or self.tts.get_voice_by_role("dialogue_a")
+            voice_b = voice_b or self.tts.get_voice_by_role("dialogue_b")
+
             output_path = Path(output_path)
             output_path.parent.mkdir(parents=True, exist_ok=True)
 
@@ -213,7 +218,7 @@ class AudioComposer:
                             if not text:
                                 continue
 
-                            # A = henry (男声), B = catherine (女声)
+                            # A = EricNeural (男声), B = JennyNeural (女声)
                             voice = voice_a if speaker.upper() == "A" else voice_b
 
                             segment = self._synthesize_segment(

package/scripts/core/state_manager.py

@@ -810,5 +810,8 @@ class StateManager:
 
 # CLI interface - delegated to cli.py for better code organization
 if __name__ == "__main__":
-    from cli import main
+    try:
+        from ..cli.cli import main
+    except ImportError:
+        from scripts.cli.cli import main
     main()