From be70ad2a2974722b3d3d6a0bc8d3e154176113ba Mon Sep 17 00:00:00 2001 From: shenlei Date: Wed, 16 Sep 2026 17:23:26 +0900 Subject: [PATCH] =?UTF-8?q?refactor:=20=E5=B0=86=E8=AF=BE=E7=A8=8B?= =?UTF-8?q?=E5=90=84=E6=AD=A5=E9=AA=A4=E6=8B=86=E5=88=86=E5=88=B0=20featur?= =?UTF-8?q?es/lesson/steps/?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit lesson_flow.dart 保留流程状态、公共脚手架与小组件，预习/听/说/读/写/独立表达 六个步骤各自成为 part 文件。代码仅搬移并经 dart format 格式化，无用户可见变化。 Co-Authored-By: Claude Opus 5 --- .../lib/features/lesson/lesson_flow.dart | 1033 +---------------- .../lesson/steps/independent_step.dart | 220 ++++ .../features/lesson/steps/listening_step.dart | 96 ++ .../features/lesson/steps/preview_step.dart | 62 + .../features/lesson/steps/reading_step.dart | 373 ++++++ .../features/lesson/steps/speaking_step.dart | 151 +++ .../features/lesson/steps/writing_step.dart | 187 +++ 7 files changed, 1097 insertions(+), 1025 deletions(-) create mode 100644 kouyu_english/lib/features/lesson/steps/independent_step.dart create mode 100644 kouyu_english/lib/features/lesson/steps/listening_step.dart create mode 100644 kouyu_english/lib/features/lesson/steps/preview_step.dart create mode 100644 kouyu_english/lib/features/lesson/steps/reading_step.dart create mode 100644 kouyu_english/lib/features/lesson/steps/speaking_step.dart create mode 100644 kouyu_english/lib/features/lesson/steps/writing_step.dart diff --git a/kouyu_english/lib/features/lesson/lesson_flow.dart b/kouyu_english/lib/features/lesson/lesson_flow.dart index ef51ef2..bbd6860 100644 --- a/kouyu_english/lib/features/lesson/lesson_flow.dart +++ b/kouyu_english/lib/features/lesson/lesson_flow.dart @@ -11,6 +11,13 @@ import '../../widgets/app_widgets.dart'; import '../../widgets/lexicon_lookup.dart'; import '../../widgets/voice_answer.dart'; +part 'steps/independent_step.dart'; +part 'steps/listening_step.dart'; +part 'steps/preview_step.dart'; +part 'steps/reading_step.dart'; +part 'steps/speaking_step.dart'; +part 'steps/writing_step.dart'; + class LessonFlow extends StatefulWidget { const LessonFlow({ super.key, @@ -256,11 +263,7 @@ class _LessonScaffold extends StatelessWidget { } class _LessonScope extends InheritedWidget { - const _LessonScope({ - required this.title, - this.onExit, - required super.child, - }); + const _LessonScope({required this.title, this.onExit, required super.child}); final String title; final VoidCallback? onExit; @@ -277,807 +280,6 @@ class _LessonScope extends InheritedWidget { title != oldWidget.title || onExit != oldWidget.onExit; } -class _PreviewStep extends StatelessWidget { - const _PreviewStep({ - required this.state, - required this.item, - required this.position, - required this.total, - required this.onLookup, - required this.onNext, - required this.onSkip, - }); - - final VocabularyItem item; - final AppState state; - final int position; - final int total; - final VoidCallback onLookup; - final VoidCallback onNext; - final VoidCallback onSkip; - - @override - Widget build(BuildContext context) => _LessonScaffold( - step: 1, - child: SpacedColumn( - children: [ - Eyebrow('先认识今天的词 · $position / $total'), - Text('后面会遇到这些词。', style: Theme.of(context).textTheme.headlineMedium), - const Text('先听一遍、知道意思就够了，不用马上背会。'), - SectionCard( - tint: AppColors.softGreen, - child: SpacedColumn( - children: [ - Text( - item.word, - style: const TextStyle( - fontSize: 28, - fontWeight: FontWeight.w600, - ), - ), - if (item.ipa != null) - Text(item.ipa!, style: Theme.of(context).textTheme.bodyMedium), - Text(item.meaning, style: const TextStyle(fontSize: 17)), - _AudioRow(label: '播放示范音', speech: item.word), - LexiconText(item.example, state: state), - Text(item.exampleMeaning), - ], - ), - ), - Wrap( - spacing: 8, - children: [ActionChip(label: const Text('查词'), onPressed: onLookup)], - ), - PrimaryButton( - label: position == total ? '进入课程' : '认识了，下一个', - onPressed: onNext, - ), - TextButton(onPressed: onSkip, child: const Text('跳过，直接进入课程')), - ], - ), - ); -} - -class _ListeningStep extends StatelessWidget { - const _ListeningStep({ - required this.state, - required this.activity, - required this.options, - required this.correctAnswer, - required this.selectedAnswer, - required this.audioPlayed, - required this.onSelected, - required this.onPlayed, - required this.onLookup, - required this.onContinue, - }); - - final LessonActivity activity; - final AppState state; - final List options; - final String correctAnswer; - - final int selectedAnswer; - final bool audioPlayed; - final ValueChanged onSelected; - final VoidCallback onPlayed; - final VoidCallback onLookup; - final VoidCallback? onContinue; - - @override - Widget build(BuildContext context) { - final answers = options; - return _LessonScaffold( - step: 2, - child: SpacedColumn( - spacing: 14, - children: [ - const Eyebrow('听一听'), - Text( - activity.listeningQuestion, - style: Theme.of(context).textTheme.headlineMedium, - ), - SectionCard( - tint: AppColors.surfaceMuted, - child: _AudioRow( - label: audioPlayed ? '再播放一次' : '播放问题', - speech: activity.listening, - onPlayed: onPlayed, - ), - ), - TextButton.icon( - onPressed: onLookup, - icon: const Icon(Icons.menu_book_outlined), - label: const Text('查看词或短语'), - ), - if (audioPlayed) - SectionCard(child: LexiconText(activity.listening, state: state)), - for (var index = 0; index < answers.length; index++) - SectionCard( - tint: selectedAnswer == index ? AppColors.softGreen : null, - onTap: () { - onSelected(index); - if (!audioPlayed) { - onPlayed(); - } - }, - child: Row( - children: [ - Icon( - selectedAnswer == index - ? Icons.radio_button_checked - : Icons.radio_button_off, - color: selectedAnswer == index - ? AppColors.green - : AppColors.muted, - ), - const SizedBox(width: 10), - Text(answers[index]), - ], - ), - ), - PrimaryButton( - label: selectedAnswer >= 0 - ? '检查并继续' - : (audioPlayed ? '请选择答案' : '先播放音频或选择答案'), - onPressed: onContinue, - ), - if (selectedAnswer >= 0 && answers[selectedAnswer] != correctAnswer) - const Text( - '再听一次，选择正确答案。', - style: TextStyle(color: AppColors.warmInk), - ), - ], - ), - ); - } -} - -class _SpeakingStep extends StatefulWidget { - const _SpeakingStep({ - required this.state, - required this.text, - required this.keepRecording, - required this.onContinue, - }); - final String text; - final AppState state; - final bool keepRecording; - final VoidCallback onContinue; - - @override - State<_SpeakingStep> createState() => _SpeakingStepState(); -} - -class _SpeakingStepState extends State<_SpeakingStep> - with VoiceAnswerMixin<_SpeakingStep> { - String transcript = ''; - - @override - AppState get voiceState => widget.state; - - @override - void dispose() { - disposeVoiceAnswer(keepRecording: widget.keepRecording); - super.dispose(); - } - - Future _toggleMic() async { - if (aiVoiceRecording) { - await finishVoiceInput( - noSpeech: '未识别到清晰发音，请重试或点击“播放示范音”。', - onTranscript: (text) => transcript = text, - ); - return; - } - - await VoiceService.instance.stopRecordingPlayback(); - if (mounted) setState(() => playingRecording = false); - if (!widget.keepRecording) { - await VoiceService.instance.deleteRecording(recordingPath); - } - - final recordStarted = await startVoiceInput(); - if (!recordStarted || !mounted) return; - setState(() => recordingPath = null); - showVoiceMessage('已启动麦克风录音，跟读完成后再次点击，AI 将自动转写发音。'); - } - - Future _togglePlayRecording() async { - if (playingRecording) { - await VoiceService.instance.stopRecordingPlayback(); - if (mounted) setState(() => playingRecording = false); - return; - } - if (recordingPath == null) { - ScaffoldMessenger.of(context).showSnackBar( - const SnackBar(content: Text('请先使用麦克风跟读，录音完成后即可播放。')), - ); - return; - } - await playRecording(); - } - - @override - Widget build(BuildContext context) => _LessonScaffold( - step: 3, - child: SpacedColumn( - children: [ - const Eyebrow('跟读'), - Text('先听，再说。', style: Theme.of(context).textTheme.headlineMedium), - LexiconText( - widget.text, - state: widget.state, - textAlign: TextAlign.center, - style: const TextStyle(fontSize: 30, fontWeight: FontWeight.w600), - ), - Text( - '/es - eɪtʃ - iː - en/', - style: Theme.of(context).textTheme.bodyMedium, - ), - SectionCard( - tint: AppColors.surfaceMuted, - child: _AudioRow(label: '播放示范音', speech: widget.text), - ), - const SectionCard( - tint: AppColors.warm, - child: Text( - '字母之间留一个短停顿。先清楚，不必快。', - style: TextStyle(color: AppColors.warmInk), - ), - ), - SecondaryButton( - label: transcribing - ? '正在 AI 识别发音…' - : (listening ? '停止录音并识别' : '使用麦克风跟读'), - onPressed: transcribing ? null : _toggleMic, - ), - SecondaryButton( - label: playingRecording ? '停止播放' : '播放跟读', - onPressed: (listening || transcribing) ? null : _togglePlayRecording, - ), - if (recordingPath != null) - SectionCard( - tint: AppColors.softGreen, - child: SpacedColumn( - spacing: 8, - children: [ - Text(widget.keepRecording ? '录音已保存在本机。' : '本次跟读录音仅在离开此步骤前保留。'), - Row( - children: [ - Expanded( - child: OutlinedButton.icon( - onPressed: (listening || transcribing) ? null : _togglePlayRecording, - icon: Icon(playingRecording ? Icons.stop : Icons.play_arrow), - label: Text(playingRecording ? '停止播放' : '播放跟读'), - ), - ), - const SizedBox(width: 8), - IconButton( - tooltip: '删除录音', - onPressed: (listening || transcribing) ? null : deleteRecording, - icon: const Icon(Icons.delete_outline), - ), - ], - ), - ], - ), - ), - if (transcript.isNotEmpty) - SectionCard( - child: Text("设备转写：$transcript\n请确认它是否接近你刚才说的内容。"), - ), - const SectionCard( - child: Text('转写不确定或与原句不符时，可重说或继续文字练习；这一步只算跟读练习，不作为独立口语证据。'), - ), - PrimaryButton( - label: transcript.isEmpty ? '我已跟读，继续' : '确认并继续', - onPressed: widget.onContinue, - ), - ], - ), - ); -} - -class _ReadingStep extends StatefulWidget { - const _ReadingStep({ - required this.state, - required this.activity, - required this.onLookup, - required this.onContinue, - }); - final LessonActivity activity; - final AppState state; - final VoidCallback onLookup; - final VoidCallback onContinue; - - @override - State<_ReadingStep> createState() => _ReadingStepState(); -} - -class _ReadingStepState extends State<_ReadingStep> { - final controller = TextEditingController(); - int? selectedOptionIndex; - bool showAnswer = false; - - /// 打乱后的选项：答案不再固定排在第一位，但同一道题顺序保持稳定。 - late final List options = shuffledOptions( - widget.activity.readingOptions, - '${widget.activity.readingQuestion}-reading', - ); - - @override - void dispose() { - controller.dispose(); - super.dispose(); - } - - bool _isOptionCorrect(int index) { - if (options.isEmpty || index < 0 || index >= options.length) { - return false; - } - final option = options[index].trim(); - final answer = widget.activity.readingAnswer.trim(); - if (option.toLowerCase() == answer.toLowerCase()) return true; - - final normOption = option - .toLowerCase() - .replaceAll(RegExp(r'[^a-z0-9\u4e00-\u9fa5]'), ''); - final normAnswer = answer - .toLowerCase() - .replaceAll(RegExp(r'[^a-z0-9\u4e00-\u9fa5]'), ''); - return normOption.isNotEmpty && - normAnswer.isNotEmpty && - (normOption.contains(normAnswer) || normAnswer.contains(normOption)); - } - - bool get isOptionMode => options.isNotEmpty; - - bool get isCorrect { - if (isOptionMode) { - return selectedOptionIndex != null && _isOptionCorrect(selectedOptionIndex!); - } - final answer = widget.activity.readingAnswer.toLowerCase().replaceAll( - RegExp(r'[^a-z0-9\u4e00-\u9fa5]'), - '', - ); - final response = controller.text.toLowerCase().replaceAll( - RegExp(r'[^a-z0-9\u4e00-\u9fa5]'), - '', - ); - // 只接受写全了答案的输入：过去反向的 answer.contains(response) 让单个字母 - // 也能判对（'a' 通过 'A book'）。 - return response.isNotEmpty && answer.isNotEmpty && response.contains(answer); - } - - @override - Widget build(BuildContext context) { - final hasSelected = selectedOptionIndex != null; - final answeredCorrectly = isCorrect; - - return _LessonScaffold( - step: 4, - child: SpacedColumn( - children: [ - const Eyebrow('读一读'), - Text('在对话里找到答案。', style: Theme.of(context).textTheme.headlineMedium), - SectionCard( - tint: AppColors.softGreen, - child: Column( - crossAxisAlignment: CrossAxisAlignment.start, - children: [ - Row( - mainAxisAlignment: MainAxisAlignment.spaceBetween, - children: [ - const Row( - children: [ - Icon(Icons.chat_bubble_outline, size: 16, color: AppColors.green), - SizedBox(width: 6), - Text( - '对话内容', - style: TextStyle( - fontSize: 13, - fontWeight: FontWeight.w600, - color: AppColors.green, - ), - ), - ], - ), - InkWell( - onTap: () => VoiceService.instance.speak(widget.activity.reading), - borderRadius: BorderRadius.circular(16), - child: const Padding( - padding: EdgeInsets.symmetric(horizontal: 8, vertical: 4), - child: Row( - children: [ - Icon(Icons.volume_up_outlined, size: 16, color: AppColors.green), - SizedBox(width: 4), - Text('朗读对话', style: TextStyle(fontSize: 13, color: AppColors.green)), - ], - ), - ), - ), - ], - ), - const SizedBox(height: 8), - LexiconText( - widget.activity.reading, - state: widget.state, - style: const TextStyle(fontSize: 16, height: 1.6), - ), - ], - ), - ), - Row( - children: [ - TextButton.icon( - onPressed: widget.onLookup, - icon: const Icon(Icons.menu_book_outlined, size: 18), - label: const Text('查词或短语'), - ), - const SizedBox(width: 8), - TextButton.icon( - onPressed: () { - final lines = widget.activity.reading.split('\n'); - final target = lines.firstWhere( - (l) => l.trim().isNotEmpty, - orElse: () => widget.activity.reading, - ).replaceFirst(RegExp(r'^[A-Za-z]+:\s*'), ''); - showLexiconLookup( - context, - state: widget.state, - initialText: target, - ); - }, - icon: const Icon(Icons.auto_stories_outlined, size: 18), - label: const Text('句型深度解析'), - ), - ], - ), - SectionCard( - tint: AppColors.surfaceMuted, - child: Row( - crossAxisAlignment: CrossAxisAlignment.start, - children: [ - Container( - padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 2), - decoration: BoxDecoration( - color: AppColors.green.withValues(alpha: 0.12), - borderRadius: BorderRadius.circular(6), - ), - child: const Text( - '问题', - style: TextStyle( - color: AppColors.green, - fontWeight: FontWeight.bold, - fontSize: 12, - ), - ), - ), - const SizedBox(width: 10), - Expanded( - child: Text( - widget.activity.readingQuestion, - style: const TextStyle( - fontSize: 15, - fontWeight: FontWeight.w600, - color: AppColors.ink, - ), - ), - ), - ], - ), - ), - if (isOptionMode) ...[ - for (var index = 0; index < options.length; index++) ...[ - SectionCard( - tint: selectedOptionIndex == index - ? (_isOptionCorrect(index) ? AppColors.softGreen : AppColors.warm) - : null, - onTap: () { - setState(() { - selectedOptionIndex = index; - showAnswer = false; - }); - }, - child: Row( - children: [ - Icon( - selectedOptionIndex == index - ? (_isOptionCorrect(index) ? Icons.check_circle : Icons.cancel_outlined) - : Icons.radio_button_off, - color: selectedOptionIndex == index - ? (_isOptionCorrect(index) ? AppColors.green : AppColors.warmInk) - : AppColors.muted, - ), - const SizedBox(width: 12), - Expanded( - child: Text( - options[index], - style: TextStyle( - fontSize: 15, - fontWeight: selectedOptionIndex == index ? FontWeight.w600 : FontWeight.normal, - color: selectedOptionIndex == index - ? (_isOptionCorrect(index) ? AppColors.green : AppColors.warmInk) - : AppColors.ink, - ), - ), - ), - ], - ), - ), - ], - if (hasSelected && answeredCorrectly) - Container( - padding: const EdgeInsets.symmetric(horizontal: 14, vertical: 10), - decoration: BoxDecoration( - color: AppColors.softGreen, - borderRadius: BorderRadius.circular(10), - border: Border.all(color: AppColors.green.withValues(alpha: 0.3)), - ), - child: const Row( - children: [ - Icon(Icons.check_circle, color: AppColors.green, size: 20), - SizedBox(width: 8), - Expanded( - child: Text( - '回答正确！点击下方按钮继续', - style: TextStyle( - color: AppColors.green, - fontWeight: FontWeight.w600, - fontSize: 14, - ), - ), - ), - ], - ), - ) - else if (hasSelected && !answeredCorrectly) - Container( - padding: const EdgeInsets.symmetric(horizontal: 14, vertical: 10), - decoration: BoxDecoration( - color: AppColors.warm, - borderRadius: BorderRadius.circular(10), - border: Border.all(color: AppColors.warmInk.withValues(alpha: 0.2)), - ), - child: const Row( - children: [ - Icon(Icons.help_outline, color: AppColors.warmInk, size: 20), - SizedBox(width: 8), - Expanded( - child: Text( - '不对哦，再仔细观察对话中的关键句子～', - style: TextStyle(color: AppColors.warmInk, fontSize: 13), - ), - ), - ], - ), - ), - ] else ...[ - TextField( - controller: controller, - onChanged: (_) => setState(() {}), - decoration: const InputDecoration( - hintText: '用英文输入答案', - filled: true, - fillColor: AppColors.surface, - border: OutlineInputBorder(), - ), - ), - ], - if (showAnswer) - SectionCard( - tint: AppColors.warm, - child: Text( - '答案：${widget.activity.readingAnswer}', - style: const TextStyle(color: AppColors.warmInk), - ), - ), - if (!showAnswer && - ((isOptionMode && hasSelected && !answeredCorrectly) || - (!isOptionMode && controller.text.isNotEmpty && !answeredCorrectly))) - TextButton( - onPressed: () => setState(() => showAnswer = true), - child: const Text('查看答案后继续学习'), - ), - PrimaryButton( - label: showAnswer || answeredCorrectly - ? '继续写一写' - : (isOptionMode ? '请选择答案' : '检查并继续'), - onPressed: showAnswer || answeredCorrectly ? widget.onContinue : null, - ), - ], - ), - ); - } -} - -class _WritingStep extends StatefulWidget { - const _WritingStep({ - required this.state, - required this.lessonId, - required this.segmentId, - required this.activity, - required this.controller, - required this.showHelp, - required this.canContinue, - required this.onChanged, - required this.onToggleHelp, - required this.onContinue, - }); - final String lessonId; - final AppState state; - final String segmentId; - final LessonActivity activity; - final TextEditingController controller; - final bool showHelp; - final bool canContinue; - final VoidCallback onChanged; - final VoidCallback onToggleHelp; - final ValueChanged onContinue; - - @override - State<_WritingStep> createState() => _WritingStepState(); -} - -class _WritingStepState extends State<_WritingStep> { - WritingCheckResult? result; - WritingAiFeedback? aiFeedback; - String? aiFeedbackError; - bool requestingAiFeedback = false; - - void _checkOrContinue() { - if (result?.complete == true) { - widget.onContinue(aiFeedback != null); - return; - } - setState( - () => result = WritingFeedback.check( - widget.lessonId, - widget.controller.text, - segmentId: widget.segmentId, - ), - ); - } - - Future _requestAiFeedback() async { - if (widget.controller.text.trim().isEmpty || requestingAiFeedback) return; - if (widget.state.aiProvider == AiProviderType.mock) { - setState(() => aiFeedbackError = '请先在“我的”配置 AI 服务；本地检查仍可继续学习。'); - return; - } - setState(() { - requestingAiFeedback = true; - aiFeedbackError = null; - }); - final feedback = await AiService.instance.writingFeedback( - provider: widget.state.aiProvider, - endpoint: widget.state.aiEndpoint, - model: widget.state.aiModel, - lessonId: widget.lessonId, - taskPrompt: widget.activity.writingPrompt, - answer: widget.controller.text.trim(), - ); - if (!mounted) return; - setState(() { - requestingAiFeedback = false; - aiFeedback = feedback; - aiFeedbackError = feedback == null - ? '暂时无法获得 AI 反馈。你的答案保留在这里，可稍后重试或继续本地练习。' - : null; - }); - } - - @override - Widget build(BuildContext context) => _LessonScaffold( - step: 5, - child: SpacedColumn( - children: [ - const Eyebrow('写一写'), - Text( - widget.activity.writingPrompt, - style: Theme.of(context).textTheme.headlineMedium, - ), - SectionCard( - tint: AppColors.surfaceMuted, - child: Text( - '小提示：${grammarNoteForSegment(widget.segmentId, widget.lessonId)}', - ), - ), - if (widget.showHelp) - SectionCard( - tint: AppColors.softGreen, - child: Text( - widget.activity.writingExample, - style: TextStyle(fontSize: 18, height: 1.5), - ), - ), - TextField( - controller: widget.controller, - onChanged: (_) { - setState(() { - result = null; - aiFeedback = null; - aiFeedbackError = null; - }); - widget.onChanged(); - }, - minLines: 3, - maxLines: 4, - decoration: InputDecoration( - labelText: '你的答案', - hintText: widget.showHelp - ? widget.activity.writingExample - : '请输入完整英文答案', - filled: true, - fillColor: AppColors.surface, - border: const OutlineInputBorder(), - ), - ), - TextButton( - onPressed: widget.onToggleHelp, - child: Text(widget.showHelp ? '收起示例，自己试一次' : '需要帮助，查看示例'), - ), - OutlinedButton.icon( - onPressed: widget.canContinue && !requestingAiFeedback - ? _requestAiFeedback - : null, - icon: requestingAiFeedback - ? const SizedBox( - width: 16, - height: 16, - child: CircularProgressIndicator(strokeWidth: 2), - ) - : const Icon(Icons.auto_awesome_outlined), - label: Text(requestingAiFeedback ? '正在获取反馈…' : '获取 AI 写作建议（可选）'), - ), - if (aiFeedback != null) - SectionCard( - tint: aiFeedback!.verdict == 'accepted' - ? AppColors.softGreen - : AppColors.warm, - child: SpacedColumn( - spacing: 6, - children: [ - Text('AI 建议：${aiFeedback!.feedback}'), - if (aiFeedback!.missing.isNotEmpty) - Text('还可补充：${aiFeedback!.missing.join('、')}'), - if (aiFeedback!.suggestion != null) - Text('可参考改写：${aiFeedback!.suggestion}'), - const Text( - '这是学习帮助；请按自己的意思重写后再检查，系统不会仅凭 AI 建议记为掌握。', - style: TextStyle(fontSize: 12, color: AppColors.muted), - ), - ], - ), - ), - if (aiFeedbackError != null) - SectionCard( - tint: AppColors.warm, - child: Text( - aiFeedbackError!, - style: const TextStyle(color: AppColors.warmInk), - ), - ), - if (result != null) - SectionCard( - tint: result!.complete ? AppColors.softGreen : AppColors.warm, - child: Text( - result!.message, - style: TextStyle( - color: result!.complete ? AppColors.green : AppColors.warmInk, - ), - ), - ), - PrimaryButton( - label: result?.complete == true ? '进入课程对话' : '检查句子', - onPressed: widget.canContinue ? _checkOrContinue : null, - ), - ], - ), - ); -} - class _DialoguePendingStep extends StatelessWidget { const _DialoguePendingStep({required this.onOpenDialogue}); final VoidCallback onOpenDialogue; @@ -1096,225 +298,6 @@ class _DialoguePendingStep extends StatelessWidget { ); } -class _IndependentStep extends StatefulWidget { - const _IndependentStep({ - required this.state, - required this.segmentId, - required this.keepRecording, - required this.activity, - required this.controller, - required this.showHelp, - required this.canContinue, - required this.onChanged, - required this.onNeedHelp, - required this.onLookup, - required this.onContinue, - required this.onLater, - }); - final AppState state; - final LessonActivity activity; - final String segmentId; - final bool keepRecording; - final TextEditingController controller; - final bool showHelp; - final bool canContinue; - final VoidCallback onChanged; - final VoidCallback onNeedHelp; - final VoidCallback onLookup; - final void Function(bool spoken, String? recordingPath) onContinue; - final VoidCallback onLater; - - @override - State<_IndependentStep> createState() => _IndependentStepState(); -} - -class _IndependentStepState extends State<_IndependentStep> - with VoiceAnswerMixin<_IndependentStep> { - bool usedVoice = false; - bool transcriptEdited = false; - String lastTranscript = ''; - String? validationError; - - @override - AppState get voiceState => widget.state; - - @override - void dispose() { - disposeVoiceAnswer(keepRecording: widget.keepRecording); - super.dispose(); - } - - void _submit() { - if (!matchesSegmentIndependent(widget.segmentId, widget.controller.text)) { - setState(() => validationError = '这次还没有用上本段要练的内容。查看帮助后补充一次。'); - return; - } - widget.onContinue( - usedVoice && !transcriptEdited, - widget.keepRecording ? recordingPath : null, - ); - } - - Future _toggleMic() async { - if (aiVoiceRecording) { - await finishVoiceInput( - onTranscript: (text) { - widget.controller.text = text; - usedVoice = true; - lastTranscript = text; - transcriptEdited = false; - }, - afterTranscribe: widget.onChanged, - ); - return; - } - - if (listening) { - await VoiceService.instance.stopListening(); - if (mounted) setState(() => listening = false); - return; - } - - final ready = await VoiceService.instance.startListening( - (text, _) { - if (!mounted) return; - setState(() { - widget.controller.text = text; - usedVoice = true; - lastTranscript = text; - transcriptEdited = false; - }); - widget.onChanged(); - }, - onStatus: (status) { - if (mounted && (status == 'notListening' || status == 'done')) { - setState(() => listening = false); - } - }, - onError: (err) { - if (mounted) { - setState(() => listening = false); - } - }, - ); - - if (!ready) { - final recordStarted = await startVoiceInput(); - if (recordStarted && mounted) { - showVoiceMessage('已启动麦克风录音，说完后再次点击，AI 将自动转写为英文。'); - } - return; - } - - if (mounted) setState(() => listening = ready); - } - - @override - Widget build(BuildContext context) => _LessonScaffold( - step: 6, - child: SpacedColumn( - children: [ - const Eyebrow('试着自己写 / 说一次 · 约 1 分钟'), - Text('现在不看句框。', style: Theme.of(context).textTheme.headlineMedium), - Text(widget.activity.independentPrompt), - if (widget.showHelp) - SectionCard( - tint: AppColors.warm, - child: Text( - '帮助：${widget.activity.independentHelp}', - style: TextStyle(color: AppColors.warmInk), - ), - ), - TextField( - controller: widget.controller, - onChanged: (value) { - if (usedVoice && value != lastTranscript) transcriptEdited = true; - setState(() {}); - widget.onChanged(); - }, - minLines: 2, - maxLines: 4, - decoration: InputDecoration( - hintText: '输入完整英文句子', - filled: true, - fillColor: AppColors.surface, - prefixIcon: IconButton( - tooltip: listening ? '停止录音' : '语音输入', - icon: Icon( - listening ? Icons.stop_circle_outlined : Icons.mic_none, - ), - onPressed: _toggleMic, - ), - border: OutlineInputBorder(), - ), - ), - SectionCard( - tint: AppColors.surfaceMuted, - child: SpacedColumn( - spacing: 8, - children: [ - Text( - widget.keepRecording - ? '可录下这次尝试并保存在本机；不会发送给 AI。' - : '可录下这次尝试并回听；离开本页后会自动删除。', - ), - RecordingControls( - recording: recording, - playing: playingRecording, - hasRecording: recordingPath != null, - onToggleRecording: toggleRecording, - onPlay: playRecording, - onDelete: deleteRecording, - ), - ], - ), - ), - if (usedVoice) - SectionCard( - tint: transcriptEdited ? AppColors.warm : AppColors.softGreen, - child: Text( - transcriptEdited - ? '你修改了设备转写：这次会按文字练习保存，不计口语练习。' - : '这是设备转写。未修改并确认后，会保留为本次语音练习记录。', - style: TextStyle( - color: transcriptEdited ? AppColors.warmInk : AppColors.green, - ), - ), - ), - if (validationError != null) - SectionCard( - tint: AppColors.warm, - child: Text( - validationError!, - style: const TextStyle(color: AppColors.warmInk), - ), - ), - if (!widget.showHelp) - Wrap( - spacing: 8, - children: [ - TextButton( - onPressed: widget.onNeedHelp, - child: const Text('需要帮助'), - ), - TextButton( - onPressed: widget.onLookup, - child: const Text('查词或短语'), - ), - ], - ) - else - TextButton(onPressed: widget.onLookup, child: const Text('查词或短语')), - PrimaryButton( - label: widget.showHelp ? '带帮助完成' : '独立完成', - onPressed: widget.canContinue ? _submit : null, - ), - TextButton(onPressed: widget.onLater, child: const Text('稍后继续')), - ], - ), - ); -} - class _CompletionStep extends StatelessWidget { const _CompletionStep({ required this.assisted, diff --git a/kouyu_english/lib/features/lesson/steps/independent_step.dart b/kouyu_english/lib/features/lesson/steps/independent_step.dart new file mode 100644 index 0000000..890c691 --- /dev/null +++ b/kouyu_english/lib/features/lesson/steps/independent_step.dart @@ -0,0 +1,220 @@ +part of '../lesson_flow.dart'; + +class _IndependentStep extends StatefulWidget { + const _IndependentStep({ + required this.state, + required this.segmentId, + required this.keepRecording, + required this.activity, + required this.controller, + required this.showHelp, + required this.canContinue, + required this.onChanged, + required this.onNeedHelp, + required this.onLookup, + required this.onContinue, + required this.onLater, + }); + final AppState state; + final LessonActivity activity; + final String segmentId; + final bool keepRecording; + final TextEditingController controller; + final bool showHelp; + final bool canContinue; + final VoidCallback onChanged; + final VoidCallback onNeedHelp; + final VoidCallback onLookup; + final void Function(bool spoken, String? recordingPath) onContinue; + final VoidCallback onLater; + + @override + State<_IndependentStep> createState() => _IndependentStepState(); +} + +class _IndependentStepState extends State<_IndependentStep> + with VoiceAnswerMixin<_IndependentStep> { + bool usedVoice = false; + bool transcriptEdited = false; + String lastTranscript = ''; + String? validationError; + + @override + AppState get voiceState => widget.state; + + @override + void dispose() { + disposeVoiceAnswer(keepRecording: widget.keepRecording); + super.dispose(); + } + + void _submit() { + if (!matchesSegmentIndependent(widget.segmentId, widget.controller.text)) { + setState(() => validationError = '这次还没有用上本段要练的内容。查看帮助后补充一次。'); + return; + } + widget.onContinue( + usedVoice && !transcriptEdited, + widget.keepRecording ? recordingPath : null, + ); + } + + Future _toggleMic() async { + if (aiVoiceRecording) { + await finishVoiceInput( + onTranscript: (text) { + widget.controller.text = text; + usedVoice = true; + lastTranscript = text; + transcriptEdited = false; + }, + afterTranscribe: widget.onChanged, + ); + return; + } + + if (listening) { + await VoiceService.instance.stopListening(); + if (mounted) setState(() => listening = false); + return; + } + + final ready = await VoiceService.instance.startListening( + (text, _) { + if (!mounted) return; + setState(() { + widget.controller.text = text; + usedVoice = true; + lastTranscript = text; + transcriptEdited = false; + }); + widget.onChanged(); + }, + onStatus: (status) { + if (mounted && (status == 'notListening' || status == 'done')) { + setState(() => listening = false); + } + }, + onError: (err) { + if (mounted) { + setState(() => listening = false); + } + }, + ); + + if (!ready) { + final recordStarted = await startVoiceInput(); + if (recordStarted && mounted) { + showVoiceMessage('已启动麦克风录音，说完后再次点击，AI 将自动转写为英文。'); + } + return; + } + + if (mounted) setState(() => listening = ready); + } + + @override + Widget build(BuildContext context) => _LessonScaffold( + step: 6, + child: SpacedColumn( + children: [ + const Eyebrow('试着自己写 / 说一次 · 约 1 分钟'), + Text('现在不看句框。', style: Theme.of(context).textTheme.headlineMedium), + Text(widget.activity.independentPrompt), + if (widget.showHelp) + SectionCard( + tint: AppColors.warm, + child: Text( + '帮助：${widget.activity.independentHelp}', + style: TextStyle(color: AppColors.warmInk), + ), + ), + TextField( + controller: widget.controller, + onChanged: (value) { + if (usedVoice && value != lastTranscript) transcriptEdited = true; + setState(() {}); + widget.onChanged(); + }, + minLines: 2, + maxLines: 4, + decoration: InputDecoration( + hintText: '输入完整英文句子', + filled: true, + fillColor: AppColors.surface, + prefixIcon: IconButton( + tooltip: listening ? '停止录音' : '语音输入', + icon: Icon( + listening ? Icons.stop_circle_outlined : Icons.mic_none, + ), + onPressed: _toggleMic, + ), + border: OutlineInputBorder(), + ), + ), + SectionCard( + tint: AppColors.surfaceMuted, + child: SpacedColumn( + spacing: 8, + children: [ + Text( + widget.keepRecording + ? '可录下这次尝试并保存在本机；不会发送给 AI。' + : '可录下这次尝试并回听；离开本页后会自动删除。', + ), + RecordingControls( + recording: recording, + playing: playingRecording, + hasRecording: recordingPath != null, + onToggleRecording: toggleRecording, + onPlay: playRecording, + onDelete: deleteRecording, + ), + ], + ), + ), + if (usedVoice) + SectionCard( + tint: transcriptEdited ? AppColors.warm : AppColors.softGreen, + child: Text( + transcriptEdited + ? '你修改了设备转写：这次会按文字练习保存，不计口语练习。' + : '这是设备转写。未修改并确认后，会保留为本次语音练习记录。', + style: TextStyle( + color: transcriptEdited ? AppColors.warmInk : AppColors.green, + ), + ), + ), + if (validationError != null) + SectionCard( + tint: AppColors.warm, + child: Text( + validationError!, + style: const TextStyle(color: AppColors.warmInk), + ), + ), + if (!widget.showHelp) + Wrap( + spacing: 8, + children: [ + TextButton( + onPressed: widget.onNeedHelp, + child: const Text('需要帮助'), + ), + TextButton( + onPressed: widget.onLookup, + child: const Text('查词或短语'), + ), + ], + ) + else + TextButton(onPressed: widget.onLookup, child: const Text('查词或短语')), + PrimaryButton( + label: widget.showHelp ? '带帮助完成' : '独立完成', + onPressed: widget.canContinue ? _submit : null, + ), + TextButton(onPressed: widget.onLater, child: const Text('稍后继续')), + ], + ), + ); +} diff --git a/kouyu_english/lib/features/lesson/steps/listening_step.dart b/kouyu_english/lib/features/lesson/steps/listening_step.dart new file mode 100644 index 0000000..cdcd118 --- /dev/null +++ b/kouyu_english/lib/features/lesson/steps/listening_step.dart @@ -0,0 +1,96 @@ +part of '../lesson_flow.dart'; + +class _ListeningStep extends StatelessWidget { + const _ListeningStep({ + required this.state, + required this.activity, + required this.options, + required this.correctAnswer, + required this.selectedAnswer, + required this.audioPlayed, + required this.onSelected, + required this.onPlayed, + required this.onLookup, + required this.onContinue, + }); + + final LessonActivity activity; + final AppState state; + final List options; + final String correctAnswer; + + final int selectedAnswer; + final bool audioPlayed; + final ValueChanged onSelected; + final VoidCallback onPlayed; + final VoidCallback onLookup; + final VoidCallback? onContinue; + + @override + Widget build(BuildContext context) { + final answers = options; + return _LessonScaffold( + step: 2, + child: SpacedColumn( + spacing: 14, + children: [ + const Eyebrow('听一听'), + Text( + activity.listeningQuestion, + style: Theme.of(context).textTheme.headlineMedium, + ), + SectionCard( + tint: AppColors.surfaceMuted, + child: _AudioRow( + label: audioPlayed ? '再播放一次' : '播放问题', + speech: activity.listening, + onPlayed: onPlayed, + ), + ), + TextButton.icon( + onPressed: onLookup, + icon: const Icon(Icons.menu_book_outlined), + label: const Text('查看词或短语'), + ), + if (audioPlayed) + SectionCard(child: LexiconText(activity.listening, state: state)), + for (var index = 0; index < answers.length; index++) + SectionCard( + tint: selectedAnswer == index ? AppColors.softGreen : null, + onTap: () { + onSelected(index); + if (!audioPlayed) { + onPlayed(); + } + }, + child: Row( + children: [ + Icon( + selectedAnswer == index + ? Icons.radio_button_checked + : Icons.radio_button_off, + color: selectedAnswer == index + ? AppColors.green + : AppColors.muted, + ), + const SizedBox(width: 10), + Text(answers[index]), + ], + ), + ), + PrimaryButton( + label: selectedAnswer >= 0 + ? '检查并继续' + : (audioPlayed ? '请选择答案' : '先播放音频或选择答案'), + onPressed: onContinue, + ), + if (selectedAnswer >= 0 && answers[selectedAnswer] != correctAnswer) + const Text( + '再听一次，选择正确答案。', + style: TextStyle(color: AppColors.warmInk), + ), + ], + ), + ); + } +} diff --git a/kouyu_english/lib/features/lesson/steps/preview_step.dart b/kouyu_english/lib/features/lesson/steps/preview_step.dart new file mode 100644 index 0000000..e2fe184 --- /dev/null +++ b/kouyu_english/lib/features/lesson/steps/preview_step.dart @@ -0,0 +1,62 @@ +part of '../lesson_flow.dart'; + +class _PreviewStep extends StatelessWidget { + const _PreviewStep({ + required this.state, + required this.item, + required this.position, + required this.total, + required this.onLookup, + required this.onNext, + required this.onSkip, + }); + + final VocabularyItem item; + final AppState state; + final int position; + final int total; + final VoidCallback onLookup; + final VoidCallback onNext; + final VoidCallback onSkip; + + @override + Widget build(BuildContext context) => _LessonScaffold( + step: 1, + child: SpacedColumn( + children: [ + Eyebrow('先认识今天的词 · $position / $total'), + Text('后面会遇到这些词。', style: Theme.of(context).textTheme.headlineMedium), + const Text('先听一遍、知道意思就够了，不用马上背会。'), + SectionCard( + tint: AppColors.softGreen, + child: SpacedColumn( + children: [ + Text( + item.word, + style: const TextStyle( + fontSize: 28, + fontWeight: FontWeight.w600, + ), + ), + if (item.ipa != null) + Text(item.ipa!, style: Theme.of(context).textTheme.bodyMedium), + Text(item.meaning, style: const TextStyle(fontSize: 17)), + _AudioRow(label: '播放示范音', speech: item.word), + LexiconText(item.example, state: state), + Text(item.exampleMeaning), + ], + ), + ), + Wrap( + spacing: 8, + children: [ActionChip(label: const Text('查词'), onPressed: onLookup)], + ), + PrimaryButton( + label: position == total ? '进入课程' : '认识了，下一个', + onPressed: onNext, + ), + TextButton(onPressed: onSkip, child: const Text('跳过，直接进入课程')), + ], + ), + ); +} diff --git a/kouyu_english/lib/features/lesson/steps/reading_step.dart b/kouyu_english/lib/features/lesson/steps/reading_step.dart new file mode 100644 index 0000000..a9463ad --- /dev/null +++ b/kouyu_english/lib/features/lesson/steps/reading_step.dart @@ -0,0 +1,373 @@ +part of '../lesson_flow.dart'; + +class _ReadingStep extends StatefulWidget { + const _ReadingStep({ + required this.state, + required this.activity, + required this.onLookup, + required this.onContinue, + }); + final LessonActivity activity; + final AppState state; + final VoidCallback onLookup; + final VoidCallback onContinue; + + @override + State<_ReadingStep> createState() => _ReadingStepState(); +} + +class _ReadingStepState extends State<_ReadingStep> { + final controller = TextEditingController(); + int? selectedOptionIndex; + bool showAnswer = false; + + /// 打乱后的选项：答案不再固定排在第一位，但同一道题顺序保持稳定。 + late final List options = shuffledOptions( + widget.activity.readingOptions, + '${widget.activity.readingQuestion}-reading', + ); + + @override + void dispose() { + controller.dispose(); + super.dispose(); + } + + bool _isOptionCorrect(int index) { + if (options.isEmpty || index < 0 || index >= options.length) { + return false; + } + final option = options[index].trim(); + final answer = widget.activity.readingAnswer.trim(); + if (option.toLowerCase() == answer.toLowerCase()) return true; + + final normOption = option.toLowerCase().replaceAll( + RegExp(r'[^a-z0-9\u4e00-\u9fa5]'), + '', + ); + final normAnswer = answer.toLowerCase().replaceAll( + RegExp(r'[^a-z0-9\u4e00-\u9fa5]'), + '', + ); + return normOption.isNotEmpty && + normAnswer.isNotEmpty && + (normOption.contains(normAnswer) || normAnswer.contains(normOption)); + } + + bool get isOptionMode => options.isNotEmpty; + + bool get isCorrect { + if (isOptionMode) { + return selectedOptionIndex != null && + _isOptionCorrect(selectedOptionIndex!); + } + final answer = widget.activity.readingAnswer.toLowerCase().replaceAll( + RegExp(r'[^a-z0-9\u4e00-\u9fa5]'), + '', + ); + final response = controller.text.toLowerCase().replaceAll( + RegExp(r'[^a-z0-9\u4e00-\u9fa5]'), + '', + ); + // 只接受写全了答案的输入：过去反向的 answer.contains(response) 让单个字母 + // 也能判对（'a' 通过 'A book'）。 + return response.isNotEmpty && + answer.isNotEmpty && + response.contains(answer); + } + + @override + Widget build(BuildContext context) { + final hasSelected = selectedOptionIndex != null; + final answeredCorrectly = isCorrect; + + return _LessonScaffold( + step: 4, + child: SpacedColumn( + children: [ + const Eyebrow('读一读'), + Text('在对话里找到答案。', style: Theme.of(context).textTheme.headlineMedium), + SectionCard( + tint: AppColors.softGreen, + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + const Row( + children: [ + Icon( + Icons.chat_bubble_outline, + size: 16, + color: AppColors.green, + ), + SizedBox(width: 6), + Text( + '对话内容', + style: TextStyle( + fontSize: 13, + fontWeight: FontWeight.w600, + color: AppColors.green, + ), + ), + ], + ), + InkWell( + onTap: () => + VoiceService.instance.speak(widget.activity.reading), + borderRadius: BorderRadius.circular(16), + child: const Padding( + padding: EdgeInsets.symmetric( + horizontal: 8, + vertical: 4, + ), + child: Row( + children: [ + Icon( + Icons.volume_up_outlined, + size: 16, + color: AppColors.green, + ), + SizedBox(width: 4), + Text( + '朗读对话', + style: TextStyle( + fontSize: 13, + color: AppColors.green, + ), + ), + ], + ), + ), + ), + ], + ), + const SizedBox(height: 8), + LexiconText( + widget.activity.reading, + state: widget.state, + style: const TextStyle(fontSize: 16, height: 1.6), + ), + ], + ), + ), + Row( + children: [ + TextButton.icon( + onPressed: widget.onLookup, + icon: const Icon(Icons.menu_book_outlined, size: 18), + label: const Text('查词或短语'), + ), + const SizedBox(width: 8), + TextButton.icon( + onPressed: () { + final lines = widget.activity.reading.split('\n'); + final target = lines + .firstWhere( + (l) => l.trim().isNotEmpty, + orElse: () => widget.activity.reading, + ) + .replaceFirst(RegExp(r'^[A-Za-z]+:\s*'), ''); + showLexiconLookup( + context, + state: widget.state, + initialText: target, + ); + }, + icon: const Icon(Icons.auto_stories_outlined, size: 18), + label: const Text('句型深度解析'), + ), + ], + ), + SectionCard( + tint: AppColors.surfaceMuted, + child: Row( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Container( + padding: const EdgeInsets.symmetric( + horizontal: 8, + vertical: 2, + ), + decoration: BoxDecoration( + color: AppColors.green.withValues(alpha: 0.12), + borderRadius: BorderRadius.circular(6), + ), + child: const Text( + '问题', + style: TextStyle( + color: AppColors.green, + fontWeight: FontWeight.bold, + fontSize: 12, + ), + ), + ), + const SizedBox(width: 10), + Expanded( + child: Text( + widget.activity.readingQuestion, + style: const TextStyle( + fontSize: 15, + fontWeight: FontWeight.w600, + color: AppColors.ink, + ), + ), + ), + ], + ), + ), + if (isOptionMode) ...[ + for (var index = 0; index < options.length; index++) ...[ + SectionCard( + tint: selectedOptionIndex == index + ? (_isOptionCorrect(index) + ? AppColors.softGreen + : AppColors.warm) + : null, + onTap: () { + setState(() { + selectedOptionIndex = index; + showAnswer = false; + }); + }, + child: Row( + children: [ + Icon( + selectedOptionIndex == index + ? (_isOptionCorrect(index) + ? Icons.check_circle + : Icons.cancel_outlined) + : Icons.radio_button_off, + color: selectedOptionIndex == index + ? (_isOptionCorrect(index) + ? AppColors.green + : AppColors.warmInk) + : AppColors.muted, + ), + const SizedBox(width: 12), + Expanded( + child: Text( + options[index], + style: TextStyle( + fontSize: 15, + fontWeight: selectedOptionIndex == index + ? FontWeight.w600 + : FontWeight.normal, + color: selectedOptionIndex == index + ? (_isOptionCorrect(index) + ? AppColors.green + : AppColors.warmInk) + : AppColors.ink, + ), + ), + ), + ], + ), + ), + ], + if (hasSelected && answeredCorrectly) + Container( + padding: const EdgeInsets.symmetric( + horizontal: 14, + vertical: 10, + ), + decoration: BoxDecoration( + color: AppColors.softGreen, + borderRadius: BorderRadius.circular(10), + border: Border.all( + color: AppColors.green.withValues(alpha: 0.3), + ), + ), + child: const Row( + children: [ + Icon(Icons.check_circle, color: AppColors.green, size: 20), + SizedBox(width: 8), + Expanded( + child: Text( + '回答正确！点击下方按钮继续', + style: TextStyle( + color: AppColors.green, + fontWeight: FontWeight.w600, + fontSize: 14, + ), + ), + ), + ], + ), + ) + else if (hasSelected && !answeredCorrectly) + Container( + padding: const EdgeInsets.symmetric( + horizontal: 14, + vertical: 10, + ), + decoration: BoxDecoration( + color: AppColors.warm, + borderRadius: BorderRadius.circular(10), + border: Border.all( + color: AppColors.warmInk.withValues(alpha: 0.2), + ), + ), + child: const Row( + children: [ + Icon( + Icons.help_outline, + color: AppColors.warmInk, + size: 20, + ), + SizedBox(width: 8), + Expanded( + child: Text( + '不对哦，再仔细观察对话中的关键句子～', + style: TextStyle( + color: AppColors.warmInk, + fontSize: 13, + ), + ), + ), + ], + ), + ), + ] else ...[ + TextField( + controller: controller, + onChanged: (_) => setState(() {}), + decoration: const InputDecoration( + hintText: '用英文输入答案', + filled: true, + fillColor: AppColors.surface, + border: OutlineInputBorder(), + ), + ), + ], + if (showAnswer) + SectionCard( + tint: AppColors.warm, + child: Text( + '答案：${widget.activity.readingAnswer}', + style: const TextStyle(color: AppColors.warmInk), + ), + ), + if (!showAnswer && + ((isOptionMode && hasSelected && !answeredCorrectly) || + (!isOptionMode && + controller.text.isNotEmpty && + !answeredCorrectly))) + TextButton( + onPressed: () => setState(() => showAnswer = true), + child: const Text('查看答案后继续学习'), + ), + PrimaryButton( + label: showAnswer || answeredCorrectly + ? '继续写一写' + : (isOptionMode ? '请选择答案' : '检查并继续'), + onPressed: showAnswer || answeredCorrectly + ? widget.onContinue + : null, + ), + ], + ), + ); + } +} diff --git a/kouyu_english/lib/features/lesson/steps/speaking_step.dart b/kouyu_english/lib/features/lesson/steps/speaking_step.dart new file mode 100644 index 0000000..e0afe5a --- /dev/null +++ b/kouyu_english/lib/features/lesson/steps/speaking_step.dart @@ -0,0 +1,151 @@ +part of '../lesson_flow.dart'; + +class _SpeakingStep extends StatefulWidget { + const _SpeakingStep({ + required this.state, + required this.text, + required this.keepRecording, + required this.onContinue, + }); + final String text; + final AppState state; + final bool keepRecording; + final VoidCallback onContinue; + + @override + State<_SpeakingStep> createState() => _SpeakingStepState(); +} + +class _SpeakingStepState extends State<_SpeakingStep> + with VoiceAnswerMixin<_SpeakingStep> { + String transcript = ''; + + @override + AppState get voiceState => widget.state; + + @override + void dispose() { + disposeVoiceAnswer(keepRecording: widget.keepRecording); + super.dispose(); + } + + Future _toggleMic() async { + if (aiVoiceRecording) { + await finishVoiceInput( + noSpeech: '未识别到清晰发音，请重试或点击“播放示范音”。', + onTranscript: (text) => transcript = text, + ); + return; + } + + await VoiceService.instance.stopRecordingPlayback(); + if (mounted) setState(() => playingRecording = false); + if (!widget.keepRecording) { + await VoiceService.instance.deleteRecording(recordingPath); + } + + final recordStarted = await startVoiceInput(); + if (!recordStarted || !mounted) return; + setState(() => recordingPath = null); + showVoiceMessage('已启动麦克风录音，跟读完成后再次点击，AI 将自动转写发音。'); + } + + Future _togglePlayRecording() async { + if (playingRecording) { + await VoiceService.instance.stopRecordingPlayback(); + if (mounted) setState(() => playingRecording = false); + return; + } + if (recordingPath == null) { + ScaffoldMessenger.of( + context, + ).showSnackBar(const SnackBar(content: Text('请先使用麦克风跟读，录音完成后即可播放。'))); + return; + } + await playRecording(); + } + + @override + Widget build(BuildContext context) => _LessonScaffold( + step: 3, + child: SpacedColumn( + children: [ + const Eyebrow('跟读'), + Text('先听，再说。', style: Theme.of(context).textTheme.headlineMedium), + LexiconText( + widget.text, + state: widget.state, + textAlign: TextAlign.center, + style: const TextStyle(fontSize: 30, fontWeight: FontWeight.w600), + ), + Text( + '/es - eɪtʃ - iː - en/', + style: Theme.of(context).textTheme.bodyMedium, + ), + SectionCard( + tint: AppColors.surfaceMuted, + child: _AudioRow(label: '播放示范音', speech: widget.text), + ), + const SectionCard( + tint: AppColors.warm, + child: Text( + '字母之间留一个短停顿。先清楚，不必快。', + style: TextStyle(color: AppColors.warmInk), + ), + ), + SecondaryButton( + label: transcribing + ? '正在 AI 识别发音…' + : (listening ? '停止录音并识别' : '使用麦克风跟读'), + onPressed: transcribing ? null : _toggleMic, + ), + SecondaryButton( + label: playingRecording ? '停止播放' : '播放跟读', + onPressed: (listening || transcribing) ? null : _togglePlayRecording, + ), + if (recordingPath != null) + SectionCard( + tint: AppColors.softGreen, + child: SpacedColumn( + spacing: 8, + children: [ + Text(widget.keepRecording ? '录音已保存在本机。' : '本次跟读录音仅在离开此步骤前保留。'), + Row( + children: [ + Expanded( + child: OutlinedButton.icon( + onPressed: (listening || transcribing) + ? null + : _togglePlayRecording, + icon: Icon( + playingRecording ? Icons.stop : Icons.play_arrow, + ), + label: Text(playingRecording ? '停止播放' : '播放跟读'), + ), + ), + const SizedBox(width: 8), + IconButton( + tooltip: '删除录音', + onPressed: (listening || transcribing) + ? null + : deleteRecording, + icon: const Icon(Icons.delete_outline), + ), + ], + ), + ], + ), + ), + if (transcript.isNotEmpty) + SectionCard(child: Text("设备转写：$transcript\n请确认它是否接近你刚才说的内容。")), + const SectionCard( + child: Text('转写不确定或与原句不符时，可重说或继续文字练习；这一步只算跟读练习，不作为独立口语证据。'), + ), + PrimaryButton( + label: transcript.isEmpty ? '我已跟读，继续' : '确认并继续', + onPressed: widget.onContinue, + ), + ], + ), + ); +} diff --git a/kouyu_english/lib/features/lesson/steps/writing_step.dart b/kouyu_english/lib/features/lesson/steps/writing_step.dart new file mode 100644 index 0000000..e45de2d --- /dev/null +++ b/kouyu_english/lib/features/lesson/steps/writing_step.dart @@ -0,0 +1,187 @@ +part of '../lesson_flow.dart'; + +class _WritingStep extends StatefulWidget { + const _WritingStep({ + required this.state, + required this.lessonId, + required this.segmentId, + required this.activity, + required this.controller, + required this.showHelp, + required this.canContinue, + required this.onChanged, + required this.onToggleHelp, + required this.onContinue, + }); + final String lessonId; + final AppState state; + final String segmentId; + final LessonActivity activity; + final TextEditingController controller; + final bool showHelp; + final bool canContinue; + final VoidCallback onChanged; + final VoidCallback onToggleHelp; + final ValueChanged onContinue; + + @override + State<_WritingStep> createState() => _WritingStepState(); +} + +class _WritingStepState extends State<_WritingStep> { + WritingCheckResult? result; + WritingAiFeedback? aiFeedback; + String? aiFeedbackError; + bool requestingAiFeedback = false; + + void _checkOrContinue() { + if (result?.complete == true) { + widget.onContinue(aiFeedback != null); + return; + } + setState( + () => result = WritingFeedback.check( + widget.lessonId, + widget.controller.text, + segmentId: widget.segmentId, + ), + ); + } + + Future _requestAiFeedback() async { + if (widget.controller.text.trim().isEmpty || requestingAiFeedback) return; + if (widget.state.aiProvider == AiProviderType.mock) { + setState(() => aiFeedbackError = '请先在“我的”配置 AI 服务；本地检查仍可继续学习。'); + return; + } + setState(() { + requestingAiFeedback = true; + aiFeedbackError = null; + }); + final feedback = await AiService.instance.writingFeedback( + provider: widget.state.aiProvider, + endpoint: widget.state.aiEndpoint, + model: widget.state.aiModel, + lessonId: widget.lessonId, + taskPrompt: widget.activity.writingPrompt, + answer: widget.controller.text.trim(), + ); + if (!mounted) return; + setState(() { + requestingAiFeedback = false; + aiFeedback = feedback; + aiFeedbackError = feedback == null + ? '暂时无法获得 AI 反馈。你的答案保留在这里，可稍后重试或继续本地练习。' + : null; + }); + } + + @override + Widget build(BuildContext context) => _LessonScaffold( + step: 5, + child: SpacedColumn( + children: [ + const Eyebrow('写一写'), + Text( + widget.activity.writingPrompt, + style: Theme.of(context).textTheme.headlineMedium, + ), + SectionCard( + tint: AppColors.surfaceMuted, + child: Text( + '小提示：${grammarNoteForSegment(widget.segmentId, widget.lessonId)}', + ), + ), + if (widget.showHelp) + SectionCard( + tint: AppColors.softGreen, + child: Text( + widget.activity.writingExample, + style: TextStyle(fontSize: 18, height: 1.5), + ), + ), + TextField( + controller: widget.controller, + onChanged: (_) { + setState(() { + result = null; + aiFeedback = null; + aiFeedbackError = null; + }); + widget.onChanged(); + }, + minLines: 3, + maxLines: 4, + decoration: InputDecoration( + labelText: '你的答案', + hintText: widget.showHelp + ? widget.activity.writingExample + : '请输入完整英文答案', + filled: true, + fillColor: AppColors.surface, + border: const OutlineInputBorder(), + ), + ), + TextButton( + onPressed: widget.onToggleHelp, + child: Text(widget.showHelp ? '收起示例，自己试一次' : '需要帮助，查看示例'), + ), + OutlinedButton.icon( + onPressed: widget.canContinue && !requestingAiFeedback + ? _requestAiFeedback + : null, + icon: requestingAiFeedback + ? const SizedBox( + width: 16, + height: 16, + child: CircularProgressIndicator(strokeWidth: 2), + ) + : const Icon(Icons.auto_awesome_outlined), + label: Text(requestingAiFeedback ? '正在获取反馈…' : '获取 AI 写作建议（可选）'), + ), + if (aiFeedback != null) + SectionCard( + tint: aiFeedback!.verdict == 'accepted' + ? AppColors.softGreen + : AppColors.warm, + child: SpacedColumn( + spacing: 6, + children: [ + Text('AI 建议：${aiFeedback!.feedback}'), + if (aiFeedback!.missing.isNotEmpty) + Text('还可补充：${aiFeedback!.missing.join('、')}'), + if (aiFeedback!.suggestion != null) + Text('可参考改写：${aiFeedback!.suggestion}'), + const Text( + '这是学习帮助；请按自己的意思重写后再检查，系统不会仅凭 AI 建议记为掌握。', + style: TextStyle(fontSize: 12, color: AppColors.muted), + ), + ], + ), + ), + if (aiFeedbackError != null) + SectionCard( + tint: AppColors.warm, + child: Text( + aiFeedbackError!, + style: const TextStyle(color: AppColors.warmInk), + ), + ), + if (result != null) + SectionCard( + tint: result!.complete ? AppColors.softGreen : AppColors.warm, + child: Text( + result!.message, + style: TextStyle( + color: result!.complete ? AppColors.green : AppColors.warmInk, + ), + ), + ), + PrimaryButton( + label: result?.complete == true ? '进入课程对话' : '检查句子', + onPressed: widget.canContinue ? _checkOrContinue : null, + ), + ], + ), + ); +}