Files
English/kouyu_english/test/review_ai_check_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

174 lines
5.4 KiB
Dart

import 'dart:convert';
import 'package:flutter_test/flutter_test.dart';
import 'package:http/http.dart' as http;
import 'package:http/testing.dart';
import 'package:flutter/material.dart';
import 'package:kouyu_english/core/app_state.dart';
import 'package:kouyu_english/features/review/review_page.dart';
import 'package:kouyu_english/core/ai_service.dart';
import 'package:kouyu_english/core/models.dart';
void main() {
Future<(WritingAiFeedback?, String)> check(Map<String, dynamic> reply) async {
AiService.instance.setFallbackApiKey('test-key');
var prompt = '';
final content = jsonEncode(reply);
final result = await http.runWithClient(
() => AiService.instance.answerFeedback(
provider: AiProviderType.compatible,
endpoint: 'https://api.deepseek.com',
model: 'deepseek-flash',
answerId: 'A0-P12',
target: "I'm from …",
taskPrompt: '告诉对方你来自哪里。',
answer: 'I am from Chna',
),
() => MockClient((request) async {
final body = jsonDecode(request.body) as Map<String, dynamic>;
prompt = jsonEncode(body);
return http.Response(
jsonEncode({
'choices': [
{
'message': {'content': content},
},
],
}),
200,
headers: {'content-type': 'application/json; charset=utf-8'},
);
}),
);
return (result, prompt);
}
test('review AI check returns spelling corrections for the item', () async {
final (feedback, prompt) = await check({
'schemaVersion': 'writing-feedback-1',
'verdict': 'rewrite',
'feedback': '句型正确,有一个拼写错误。',
'suggestion': 'I am from China.',
'missing': ['Chna 拼写应为 China'],
'lessonId': 'A0-P12',
});
expect(prompt, contains('spelling'));
expect(prompt, contains('I am from Chna'));
expect(feedback, isNotNull);
expect(feedback!.verdict, 'rewrite');
expect(feedback.suggestion, 'I am from China.');
expect(feedback.missing, ['Chna 拼写应为 China']);
});
test('review AI check rejects feedback for a different item', () async {
final (feedback, _) = await check({
'schemaVersion': 'writing-feedback-1',
'verdict': 'accepted',
'feedback': '很好。',
'suggestion': null,
'missing': <String>[],
'lessonId': 'A0-P01',
});
expect(feedback, isNull);
});
test('review AI check is skipped without a configured provider', () async {
final feedback = await AiService.instance.answerFeedback(
provider: AiProviderType.mock,
endpoint: '',
model: '',
answerId: 'A0-P12',
target: "I'm from …",
taskPrompt: '告诉对方你来自哪里。',
answer: 'I am from China',
);
expect(feedback, isNull);
});
testWidgets('finishing after an AI correction counts as assisted', (
tester,
) async {
AiService.instance.setFallbackApiKey('test-key');
final state = AppState()
..aiProvider = AiProviderType.compatible
..aiEndpoint = 'https://api.deepseek.com'
..aiModel = 'deepseek-flash';
state.reviewQueue.add(
ReviewItem(
id: 'A0-P12',
target: "I'm from …",
prompt: '告诉对方你来自哪里。',
hint: "I'm from China.",
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,
);
final content = jsonEncode({
'schemaVersion': 'writing-feedback-1',
'verdict': 'rewrite',
'feedback': '句型正确,有一个拼写错误。',
'suggestion': 'I am from China.',
'missing': ['Chna 拼写应为 China'],
'lessonId': 'A0-P12',
});
await http.runWithClient(
() async {
await tester.pumpWidget(
MaterialApp(
home: Scaffold(
body: ReviewPage(
state: state,
onFinished: () {},
onOpenAdaptiveLesson: () {},
),
),
),
);
await tester.enterText(find.byType(TextField), 'I am from Chna');
await tester.pump();
final aiButton = find.text('AI 检查语法和拼写(可选)');
await tester.ensureVisible(aiButton);
await tester.tap(aiButton);
await tester.runAsync(
() => Future<void>.delayed(const Duration(milliseconds: 50)),
);
await tester.pump();
},
() => MockClient(
(request) async => http.Response(
jsonEncode({
'choices': [
{
'message': {'content': content},
},
],
}),
200,
headers: {'content-type': 'application/json; charset=utf-8'},
),
),
);
expect(find.text('· Chna 拼写应为 China'), findsOneWidget);
expect(find.text('参考改正:I am from China.'), findsOneWidget);
final submit = find.text('带提示完成');
expect(submit, findsOneWidget);
await tester.ensureVisible(submit);
await tester.tap(submit);
await tester.pump();
expect(state.attemptEvidence.single.outcome, EvidenceKind.assisted);
expect(state.attemptEvidence.single.assisted, isTrue);
});
}