## 独立词库 理解词原先只能跟着课程单元走,学完 A0 十课词汇量只增加约 22 个实词, 不足以解决"记不住单词"。新增一份独立词库 assets/words/wordbank.json (2748 词,A1–B1),挂进 receptiveWordRegistry 的合成单元 bank-A1/A2/B1, 完全复用理解词已有的状态机,不依赖课程进度,第一天就能用。 数据来源、许可与合成规则记在 tool/words/DATA-NOTE.md:CEFR-J 定等级、 公开词书提供音标、AI 重写全部释义并生成例句、OpenSubtitles 提供口语词频。 词书部分为 CC BY-NC-SA 4.0 且上游权利不明,仅供个人非商用; 若要分发或上架,须替换音标那一列。 ## 背单词机制 - 间隔阶梯 1/3/7/15/30/60/120 天,连续答对上一级,答错回第一级。 原先首次答对后要等 7 天才复习,正是"第二天就忘"的成因。 - 每日新词上限(10 分钟 8 个 / 20 分钟 15 个 / 30 分钟 20 个)。 阶梯第一级是次日,今天引入的新词就是明天的工作量。 - 新词按口语频率发放,不再按字母序 —— A1 从 a.m./ability 变成 no/not/know/just。 - 三个方向按层级轮转:看词(英→中)→ 听词(音→中)→ 想词(中→英)。 想词题仍是选择题,不要求产出,理解词定位不变,不进升级分母。 - 单词页独立成 tab,首页今日任务卡下方给一张认词入口卡。 ## 用法对照 课程 JSON 增加 usage 字段(when/reply/swap/confuse):一个句型用在什么场合、 对方通常怎么答、还能怎么说、跟哪个学过的句型容易混。 知道 How are you? 的意思,不等于知道它不是用来问名字的。 ## 复习流 - 当日快闪(recap)独立成队列,不占复习预算,也不计入积压。 - 只发放当日预算内的量,其余保持到期状态等下次,不悄悄丢弃或改期。 - 答错的项隔几题后回来,而不是立刻重问。 测试 296 通过,flutter analyze 干净。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
207 lines
6.6 KiB
Dart
207 lines
6.6 KiB
Dart
part of '../lesson_flow.dart';
|
|
|
|
class _SpeakingStep extends StatefulWidget {
|
|
const _SpeakingStep({
|
|
required this.state,
|
|
required this.segmentId,
|
|
required this.text,
|
|
this.tip = '',
|
|
required this.keepRecording,
|
|
required this.onContinue,
|
|
});
|
|
final String segmentId;
|
|
final String text;
|
|
final String tip;
|
|
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),
|
|
),
|
|
SectionCard(
|
|
tint: AppColors.surfaceMuted,
|
|
child: _AudioRow(label: '播放示范音', speech: widget.text),
|
|
),
|
|
if (widget.tip.isNotEmpty)
|
|
SectionCard(
|
|
tint: AppColors.warm,
|
|
child: Text(
|
|
widget.tip,
|
|
style: TextStyle(color: AppColors.warmInk),
|
|
),
|
|
),
|
|
SegmentUsage(segmentId: widget.segmentId, state: widget.state),
|
|
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)
|
|
_SpokenComparisonCard(expected: widget.text, transcript: transcript),
|
|
const SectionCard(
|
|
child: Text(
|
|
'转写只反映机器听成了什么,不等于发音评分;没听出的词可以再听示范、重说一次。这一步只算跟读练习,不作为独立口语证据。',
|
|
),
|
|
),
|
|
PrimaryButton(
|
|
label: transcript.isEmpty ? '我已跟读,继续' : '确认并继续',
|
|
onPressed: widget.onContinue,
|
|
),
|
|
],
|
|
),
|
|
);
|
|
}
|
|
|
|
class _SpokenComparisonCard extends StatelessWidget {
|
|
const _SpokenComparisonCard({
|
|
required this.expected,
|
|
required this.transcript,
|
|
});
|
|
|
|
final String expected;
|
|
final String transcript;
|
|
|
|
@override
|
|
Widget build(BuildContext context) {
|
|
final result = compareSpoken(expected, transcript);
|
|
final summary = result.matches
|
|
? '每个词都被听出来了。'
|
|
: result.close
|
|
? '大部分词都被听出来了,橙色的词再练一次。'
|
|
: '有几个词没被听出来:先听示范,再慢一点说。';
|
|
return SectionCard(
|
|
tint: result.close ? AppColors.softGreen : AppColors.warm,
|
|
child: SpacedColumn(
|
|
spacing: 8,
|
|
children: [
|
|
Text('听出 ${result.heardCount}/${result.total} 个词。$summary'),
|
|
Wrap(
|
|
spacing: 6,
|
|
runSpacing: 6,
|
|
children: [
|
|
for (final word in result.words)
|
|
Text(
|
|
word.text,
|
|
style: TextStyle(
|
|
fontSize: 18,
|
|
fontWeight: FontWeight.w600,
|
|
color: word.heard ? AppColors.green : AppColors.warmInk,
|
|
decoration: word.heard
|
|
? TextDecoration.none
|
|
: TextDecoration.underline,
|
|
),
|
|
),
|
|
],
|
|
),
|
|
Text(
|
|
'设备转写:$transcript',
|
|
style: Theme.of(context).textTheme.bodySmall,
|
|
),
|
|
],
|
|
),
|
|
);
|
|
}
|
|
}
|