4v5u09Z5a4Yuc/English
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: A1 短材料复现本单元理解词，并加入黑夜模式

Browse Source 
课程内容
- 重写全部 21 个 A1 单元的听读材料，把本单元理解词织进听/读文本，
  单元内理解词复现率从约 20% 提升到约 77%（各单元 56–96%）。
- 修正 U01 房间号与机场大巴同为 thirty 的撞车（改为 17/30/40）。
- 校验器容差按级别读取（A1 为 8%），materials 覆盖率、字数、
  选项子串等校验全部通过；course_content_test 通过。

黑夜模式
- app_theme 拆分明/暗两套调色板，AppColors 随亮度切换；
  main 用 theme/darkTheme/themeMode + builder 镜像已解析亮度；
  主题偏好持久化到快照；进度页新增“外观主题”切换。

文档
- COURSE-PACK-JSON.md 更新 A1 词池覆盖（840/933）与材料复现约定。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
shenlei
2026-09-18 11:16:09 +09:00
co-authored by Claude Opus 4.8
parent 9ab08c25ef
commit febfd30f49
93 changed files with 72676 additions and 274 deletions
Download Patch File Download Diff File Expand all files Collapse all files
kouyu_english/lib/features/review/review_page.dart
+137 -46
View File
@@ -27,7 +27,8 @@ class ReviewPage extends StatefulWidget {
State<ReviewPage> createState() => _ReviewPageState();
}
class _ReviewPageState extends State<ReviewPage> {
class _ReviewPageState extends State<ReviewPage>
with VoiceAnswerMixin<ReviewPage> {
final controller = TextEditingController();
bool showHint = false;
bool usedHelp = false;
@@ -35,29 +36,78 @@ class _ReviewPageState extends State<ReviewPage> {
bool generatingVariant = false;
bool generatingLesson = false;
/// The untouched transcript of a spoken answer; null for typed answers.
String? transcript;
bool dictationPlayed = false;
@override
AppState get voiceState => widget.state;
@override
void dispose() {
VoiceService.instance.stopSpeaking();
disposeVoiceAnswer(keepRecording: widget.state.keepRecordings);
controller.dispose();
super.dispose();
}
void _resetAnswer() {
controller.clear();
// A recording still held here was never attached to evidence.
VoiceService.instance.deleteRecording(recordingPath);
showHint = false;
usedHelp = false;
validationMessage = null;
transcript = null;
recordingPath = null;
dictationPlayed = false;
}
void _next(ReviewItem item, {required bool assisted}) {
final result = ReviewFeedback.check(item, controller.text);
if (!result.complete) {
setState(() => validationMessage = result.message);
return;
}
final answer = controller.text.trim();
final spoken = transcript != null;
widget.state.completeReview(
item,
assisted: assisted,
rawAnswer: controller.text.trim(),
rawAnswer: answer,
inputMode: spoken && transcript == answer ? 'speechToText' : 'text',
originalTranscript: transcript,
recordingPath: spoken && widget.state.keepRecordings
? recordingPath
: null,
);
controller.clear();
setState(() {
showHint = false;
usedHelp = false;
validationMessage = null;
});
// A kept recording now belongs to the evidence row; don't delete it.
if (spoken && widget.state.keepRecordings) recordingPath = null;
setState(_resetAnswer);
}
Future<void> _toggleVoice() async {
if (aiVoiceRecording) {
await finishVoiceInput(
keepAudio: widget.state.keepRecordings,
onTranscript: (text) {
controller.text = text;
transcript = text;
validationMessage = null;
},
);
return;
}
await VoiceService.instance.stopSpeaking();
await startVoiceInput(unavailableMessage: '无法访问麦克风，请检查录音权限。你仍可输入英文作答。');
}
Future<void> _play(String text, {bool slow = false}) async {
try {
await VoiceService.instance.speak(text, slow: slow);
} finally {
if (mounted) setState(() => dictationPlayed = true);
}
}
Future<void> _generateVariant(ReviewItem item) async {
@@ -144,6 +194,11 @@ class _ReviewPageState extends State<ReviewPage> {
),
);
}
final dictation = item.skill == dictationSkill
? a0DictationSentences[item.id]
: null;
final spokenTask = item.skill == spokenRecallSkill;
final audioText = reviewAudioText(item.id, item.target);
final checkpoint =
widget.state.mastery[item.id]?.checkpoint ?? item.successfulReviews;
final checkpointLabel = checkpoint >= 4
@@ -153,19 +208,22 @@ class _ReviewPageState extends State<ReviewPage> {
child: SpacedColumn(
children: [
Eyebrow('今天复习 · ${widget.state.dueReviewCount} 项待完成'),
Text('不看答案，试着回答。', style: Theme.of(context).textTheme.headlineMedium),
Text(
dictation != null ? '听一听，写下来。' : '不看答案，试着回答。',
style: Theme.of(context).textTheme.headlineMedium,
),
Text(
'目标技能：${item.skill}',
style: Theme.of(context).textTheme.bodyMedium,
),
Text(
checkpointLabel,
style: const TextStyle(color: AppColors.green, fontSize: 13),
style: TextStyle(color: AppColors.green, fontSize: 13),
),
if (item.isAiGenerated)
Row(
children: [
const Expanded(
Expanded(
child: Text(
'AI 生成题面 · 已通过客户端结构审核',
style: TextStyle(color: AppColors.muted, fontSize: 12),
@@ -174,12 +232,7 @@ class _ReviewPageState extends State<ReviewPage> {
TextButton(
onPressed: () {
widget.state.reportGeneratedReviewVariant(item);
controller.clear();
setState(() {
showHint = false;
usedHelp = false;
validationMessage = null;
});
setState(_resetAnswer);
ScaffoldMessenger.of(context).showSnackBar(
const SnackBar(content: Text('已隔离该 AI 题面，并换回本地审核题。')),
);
@@ -192,7 +245,7 @@ class _ReviewPageState extends State<ReviewPage> {
tint: AppColors.softGreen,
child: SpacedColumn(
children: [
const Text(
Text(
'情境',
style: TextStyle(
color: AppColors.green,
@@ -200,6 +253,22 @@ class _ReviewPageState extends State<ReviewPage> {
),
),
Text(item.prompt, style: const TextStyle(fontSize: 19)),
if (dictation != null)
Row(
children: [
IconButton.filled(
tooltip: '播放',
onPressed: () => _play(dictation.sentence),
icon: const Icon(Icons.play_arrow),
),
const SizedBox(width: 10),
Expanded(child: Text(dictationPlayed ? '再听一次' : '播放句子')),
TextButton(
onPressed: () => _play(dictation.sentence, slow: true),
child: const Text('慢速'),
),
],
),
],
),
),
@@ -207,14 +276,34 @@ class _ReviewPageState extends State<ReviewPage> {
controller: controller,
minLines: 2,
maxLines: 4,
enabled: dictation == null || dictationPlayed,
onChanged: (_) => setState(() {}),
decoration: const InputDecoration(
hintText: '输入你会怎么回答',
decoration: InputDecoration(
hintText: dictation != null
? (dictationPlayed ? '写下你听到的英文' : '先播放句子')
: (spokenTask ? '点下方麦克风说出来，或输入英文' : '输入你会怎么回答'),
filled: true,
fillColor: AppColors.surface,
border: OutlineInputBorder(),
border: const OutlineInputBorder(),
),
),
if (dictation == null)
OutlinedButton.icon(
onPressed: transcribing ? null : _toggleVoice,
icon: Icon(listening ? Icons.stop : Icons.mic_none),
label: Text(
transcribing
? '正在识别…'
: listening
? '说完了，停止并识别'
: '用语音回答',
),
),
if (transcript != null && controller.text.trim() != transcript)
Text(
'你修改了语音转写，本次按文字作答记录。',
style: TextStyle(fontSize: 12, color: AppColors.muted),
),
Wrap(
spacing: 8,
runSpacing: 8,
@@ -231,19 +320,14 @@ class _ReviewPageState extends State<ReviewPage> {
label: const Text('稍后复习'),
onPressed: () {
widget.state.postponeReview(item);
setState(() {});
setState(_resetAnswer);
},
),
ActionChip(
label: const Text('暂时想不起来'),
onPressed: () {
widget.state.reportReviewFailure(item);
controller.clear();
setState(() {
showHint = false;
usedHelp = false;
validationMessage = null;
});
setState(_resetAnswer);
},
),
ActionChip(
@@ -262,25 +346,36 @@ class _ReviewPageState extends State<ReviewPage> {
ActionChip(
avatar: const Icon(Icons.search, size: 16),
label: const Text('查词查句'),
onPressed: () => showLexiconLookup(
context,
state: widget.state,
),
onPressed: () =>
showLexiconLookup(context, state: widget.state),
),
],
),
if (showHint)
SectionCard(
tint: AppColors.warm,
child: Text(
'参考：${item.hint}\n目标：${item.target}',
style: const TextStyle(color: AppColors.warmInk),
child: SpacedColumn(
spacing: 8,
children: [
Text(
dictation != null
? '句子意思：${item.hint}\n目标词句：${item.target}'
: '参考：${item.hint}\n目标：${item.target}',
style: TextStyle(color: AppColors.warmInk),
),
if (audioText != null && dictation == null)
TextButton.icon(
onPressed: () => _play(audioText),
icon: const Icon(Icons.volume_up_outlined),
label: Text('听示范：$audioText'),
),
],
),
),
if (validationMessage != null)
Text(
validationMessage!,
style: const TextStyle(color: AppColors.warmInk),
style: TextStyle(color: AppColors.warmInk),
),
PrimaryButton(
label: usedHelp ? '带提示完成' : '我能独立回答',
@@ -288,7 +383,7 @@ class _ReviewPageState extends State<ReviewPage> {
? null
: () => _next(item, assisted: usedHelp),
),
const Text(
Text(
'提示后完成会在明天换题复练；第一次想不起来先复核，连续两次才会降低当前检查点。',
style: TextStyle(fontSize: 12, color: AppColors.muted),
),
@@ -439,9 +534,7 @@ class _AdaptiveLessonPageState extends State<AdaptiveLessonPage>
);
return;
}
await startVoiceInput(
unavailableMessage: '无法访问麦克风，请检查录音权限。你仍可输入英文完成补练。',
);
await startVoiceInput(unavailableMessage: '无法访问麦克风，请检查录音权限。你仍可输入英文完成补练。');
}
@override
@@ -508,7 +601,7 @@ class _AdaptiveLessonPageState extends State<AdaptiveLessonPage>
Text(
'审核：${widget.state.cachedAdaptiveLessonAuditor ?? '已配置服务'} · '
'${_formatAuditTime(widget.state.cachedAdaptiveLessonAuditedAt!)}',
style: const TextStyle(color: AppColors.muted, fontSize: 12),
style: TextStyle(color: AppColors.muted, fontSize: 12),
),
Text(task.prompt, style: Theme.of(context).textTheme.headlineMedium),
if (showStimulus)
@@ -517,7 +610,7 @@ class _AdaptiveLessonPageState extends State<AdaptiveLessonPage>
child: Text(task.stimulus, style: const TextStyle(fontSize: 20)),
)
else
const SectionCard(
SectionCard(
tint: AppColors.surfaceMuted,
child: Text('先播放音频，再输入你听到的答案。'),
),
@@ -579,9 +672,7 @@ class _AdaptiveLessonPageState extends State<AdaptiveLessonPage>
child: CircularProgressIndicator(strokeWidth: 2),
)
: Icon(
listening
? Icons.stop_circle_outlined
: Icons.mic_none,
listening ? Icons.stop_circle_outlined : Icons.mic_none,
color: listening ? AppColors.green : null,
),
),
@@ -639,7 +730,7 @@ class _AdaptiveLessonPageState extends State<AdaptiveLessonPage>
if (answerFeedback != null)
Text(
answerFeedback!,
style: const TextStyle(color: AppColors.warmInk),
style: TextStyle(color: AppColors.warmInk),
),
if (showReference)
SectionCard(