Files
English/kouyu_english/test/answer_confirmation_test.dart
T
shenleiandClaude Opus 5 6b42b7abc3 feat: 独立词库、三向认词与当日快闪复习
## 独立词库

理解词原先只能跟着课程单元走,学完 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>
2026-09-20 23:54:17 +09:00

223 lines
7.0 KiB
Dart

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:kouyu_english/core/courses/courses.dart';
import 'package:kouyu_english/core/app_state.dart';
import 'package:kouyu_english/core/generated_content.dart';
import 'package:kouyu_english/core/models.dart';
import 'package:kouyu_english/core/review_feedback.dart';
import 'package:kouyu_english/features/review/review_page.dart';
const _writing = GeneratedLessonTask(
taskId: 'w',
skill: 'writing',
type: 'writeAnswer',
prompt: '写出你来自哪里。',
stimulus: '你来自哪里?',
answer: 'I am from Hong Kong.',
targetItemIds: ['A0-P12'],
answerSpec: GeneratedAnswerSpec(
requiredAnyPhrases: [
["i'm from", 'i am from'],
['hong kong', 'shanghai'],
],
acceptedAnswers: ['I am from Hong Kong.'],
),
);
void ignoreMissingPlugins(WidgetTester tester) {
final messenger = tester.binding.defaultBinaryMessenger;
for (final name in const [
'com.llfbandit.record/messages',
'xyz.luan/audioplayers',
'xyz.luan/audioplayers.global',
]) {
messenger.setMockMethodCallHandler(MethodChannel(name), (_) async => null);
}
messenger.setMockStreamHandler(
const EventChannel('xyz.luan/audioplayers.global/events'),
MockStreamHandler.inline(onListen: (_, _) {}),
);
final reportError = FlutterError.onError;
FlutterError.onError = (details) {
if (details.exception is! MissingPluginException) {
reportError?.call(details);
}
};
addTearDown(() => FlutterError.onError = reportError);
}
void main() {
group('adaptiveAnswerShortfall', () {
test('is null for a correct answer', () {
expect(adaptiveAnswerShortfall(_writing, "I'm from Shanghai."), isNull);
});
test('names the missing phrase group', () {
final message = adaptiveAnswerShortfall(_writing, 'I am from.');
expect(message, contains('hong kong'));
expect(message, isNot(contains('i am from')));
});
test('only counts what a listening answer lacks', () {
const listening = GeneratedLessonTask(
taskId: 'l',
skill: 'listening',
type: 'listenChoice',
prompt: '听。',
stimulus: 'I am from Hong Kong.',
answer: 'Hong Kong',
targetItemIds: ['A0-P12'],
);
final message = adaptiveAnswerShortfall(listening, 'London');
expect(message, contains('还缺 1 处'));
expect(message, isNot(contains('Hong Kong')));
});
});
test('a failed dictation reports the words it missed', () {
final sentence = coreDictationSentences['A0-W02']!.sentence;
final result = ReviewFeedback.check(
ReviewItem(
id: 'A0-W02',
target: sentence,
prompt: '听写',
hint: '',
dueAt: DateTime(2026),
skill: dictationSkill,
),
'My numbr is one-two-three.',
);
expect(result.complete, isFalse);
expect(result.dictation!.missedWords, ['number']);
expect(result.dictation!.extraWords, ['numbr']);
});
testWidgets('a correct review answer is confirmed with the reference', (
tester,
) async {
ignoreMissingPlugins(tester);
final state = AppState();
state.reviewQueue.add(
ReviewItem(
id: 'A0-P12',
target: "I'm from …",
prompt: '告诉对方你来自哪里。',
hint: "I'm from Shanghai.",
dueAt: DateTime.now().subtract(const Duration(hours: 1)),
skill: '回忆表达',
),
);
state.mastery['A0-P12'] = const MasteryItem(
id: 'A0-P12',
label: "I'm from …",
status: MasteryStatus.recall,
evidence: [],
checkpoint: 1,
);
await tester.pumpWidget(
MaterialApp(
home: Scaffold(
body: ReviewPage(
state: state,
onFinished: () {},
onOpenAdaptiveLesson: () {},
),
),
),
);
await tester.enterText(find.byType(TextField), 'I am from Hong Kong.');
await tester.pump();
final submit = find.text('我能独立回答');
await tester.ensureVisible(submit);
await tester.tap(submit);
await tester.pump();
expect(find.text('答对了!'), findsOneWidget);
expect(find.text('你的回答:I am from Hong Kong.'), findsOneWidget);
expect(find.textContaining("参考说法:I'm from …"), findsOneWidget);
await tester.tap(find.text('完成今天的复习'));
await tester.pump();
expect(find.text('今日复习已完成'), findsOneWidget);
});
testWidgets(
'the adaptive lesson confirms a correct answer before moving on',
(tester) async {
ignoreMissingPlugins(tester);
final state = AppState();
state.cacheApprovedAdaptiveLesson(
const GeneratedLesson(
lessonId: 'ai-a0-p12-1',
revision: 1,
stageVersion: 'A0-1.0',
abilityIds: ['A0-C06'],
prerequisiteIds: ['a0-05'],
targetItemIds: ['A0-P12'],
receptiveChunks: [],
previewItemIds: [],
estimatedMinutes: 10,
tasks: [
_writing,
GeneratedLessonTask(
taskId: 'l',
skill: 'listening',
type: 'listenChoice',
prompt: '听。',
stimulus: 'I am from Hong Kong.',
answer: 'Hong Kong',
targetItemIds: ['A0-P12'],
),
GeneratedLessonTask(
taskId: 's',
skill: 'speaking',
type: 'repeat',
prompt: '说。',
stimulus: 'I am from Hong Kong.',
answer: 'I am from Hong Kong.',
targetItemIds: ['A0-P12'],
),
GeneratedLessonTask(
taskId: 'r',
skill: 'reading',
type: 'readAnswer',
prompt: '读。',
stimulus: 'I am from Hong Kong.',
answer: 'Hong Kong',
targetItemIds: ['A0-P12'],
),
],
),
auditor: 'test',
);
await tester.pumpWidget(
MaterialApp(
home: AdaptiveLessonPage(state: state, onFinished: () {}),
),
);
await tester.enterText(find.byType(TextField), 'I am from.');
await tester.pump();
final check = find.text('检查答案');
await tester.ensureVisible(check);
await tester.tap(check);
await tester.pump();
expect(find.textContaining('还缺:hong kong / shanghai'), findsOneWidget);
await tester.enterText(find.byType(TextField), 'I am from Shanghai.');
await tester.pump();
await tester.ensureVisible(check);
await tester.tap(check);
await tester.pump();
expect(find.text('答对了!'), findsOneWidget);
expect(find.text('AI 补练 · 1/4'), findsOneWidget);
final next = find.text('下一项');
await tester.ensureVisible(next);
await tester.tap(next);
await tester.pump();
expect(find.text('AI 补练 · 2/4'), findsOneWidget);
expect(find.text('答对了!'), findsNothing);
},
);
}