refactor: 将课程各步骤拆分到 features/lesson/steps/
lesson_flow.dart 保留流程状态、公共脚手架与小组件，预习/听/说/读/写/独立表达 六个步骤各自成为 part 文件。代码仅搬移并经 dart format 格式化，无用户可见变化。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
shenlei
File diff suppressed because it is too large
Load Diff
@@ -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<void> _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('稍后继续')),
|
||||||
|
],
|
||||||
|
),
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -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<String> options;
|
||||||
|
final String correctAnswer;
|
||||||
|
|
||||||
|
final int selectedAnswer;
|
||||||
|
final bool audioPlayed;
|
||||||
|
final ValueChanged<int> 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),
|
||||||
|
),
|
||||||
|
],
|
||||||
|
),
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -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('跳过，直接进入课程')),
|
||||||
|
],
|
||||||
|
),
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -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<String> 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,
|
||||||
|
),
|
||||||
|
],
|
||||||
|
),
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -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<void> _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<void> _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,
|
||||||
|
),
|
||||||
|
],
|
||||||
|
),
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -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<bool> 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<void> _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,
|
||||||
|
),
|
||||||
|
],
|
||||||
|
),
|
||||||
|
);
|
||||||
|
}
|
||||||
Reference in New Issue
Block a user