Files
English/kouyu_english/lib/features/home/today_task_card.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

180 lines
6.1 KiB
Dart

import 'package:flutter/material.dart';
import '../../core/app_state.dart';
import '../../core/app_theme.dart';
import '../../core/courses/courses.dart';
import '../../widgets/app_widgets.dart';
/// 今天最该做的一件事:继续课程对话 → 到期复习 → 阶段评估/巩固 → 下一课。
class TodayTaskCard extends StatelessWidget {
const TodayTaskCard({
super.key,
required this.state,
required this.onStartLesson,
required this.onStartReview,
required this.onResumeLessonDialogue,
required this.onStartReinforcement,
required this.onOpenAssessment,
});
final AppState state;
final VoidCallback onStartLesson;
final VoidCallback onStartReview;
final VoidCallback onResumeLessonDialogue;
final VoidCallback onStartReinforcement;
final ValueChanged<String> onOpenAssessment;
@override
Widget build(BuildContext context) {
final task = _todayTask();
return SectionCard(
tint: AppColors.softGreen,
child: SpacedColumn(
children: [
Row(
children: [
Expanded(child: Eyebrow(task.label)),
Text(task.minutes, style: TextStyle(color: AppColors.green)),
],
),
Text(
task.title,
style: const TextStyle(fontSize: 17, fontWeight: FontWeight.w600),
),
Text(task.note, style: Theme.of(context).textTheme.bodyMedium),
PrimaryButton(label: task.action, onPressed: task.onPressed),
],
),
);
}
_TodayTask _todayTask() {
var lessonId = state.activeLessonId;
if (state.completedLessonIds.contains(lessonId)) {
final next = state.nextIncompleteLessonId;
if (next != null) {
lessonId = next;
}
}
final lesson = lessonById(lessonId);
if (state.hasResumableLessonDialogue) {
return _TodayTask(
label: '未完成',
title: '继续第 ${lesson.number} 课的课程对话',
note: '已保留你的对话进度和提示状态。',
action: '继续对话',
minutes: '5 分钟',
onPressed: onResumeLessonDialogue,
);
}
if (state.reviewIsPrimary) {
final planned = state.todayReviewPlan.length;
final postponed = state.postponedReviewCount;
return _TodayTask(
label: '今日复习',
title: '先复习 $planned 项',
note: postponed > 0
? '今天的复习时间安排 $planned 项,其余 $postponed 项明天接着做,不会丢。'
: state.reviewBacklog
? '有积压项目;先花几分钟清掉到期复习,再开启新课。'
: '之前练过的关键句,今天换个情境再用一次。',
action: '开始复习',
minutes: '${(planned * 2).clamp(2, 10)} 分钟',
onPressed: onStartReview,
);
}
// 学完一段后隔一会儿再想起来一次,明天的第一次检查才不会从零开始。
if (state.dueRecaps.isNotEmpty) {
return _TodayTask(
label: '课后快闪',
title: '把刚学的 ${state.dueRecaps.length} 项再想一遍',
note: '趁还记得再提取一次,明天更容易想起来。答不出也不算错,不计检查点。',
action: '开始快闪',
minutes: '1 分钟',
onPressed: onStartReview,
);
}
// A0 课程学完、尚未通过阶段评估时,先巩固再评估;通过后回到下一课。
if (state.a0LessonsComplete && !state.a0Passed) return _stageTask();
if (state.allLessonsComplete) {
return _TodayTask(
label: '已学完',
title: '所有课程已完成',
note: '你已学完全部课程内容!建议保持日常到期复习或自由情境对话。',
action: '去复习',
minutes: '10 分钟',
onPressed: onStartReview,
);
}
final segments = lesson.segments.length;
final segmentIndex = state.activeSegmentIndexFor(lesson.id);
final segment = segmentIndex + 1;
final isSegmentResuming = segments > 1 && segmentIndex > 0;
return _TodayTask(
label: isSegmentResuming ? '继续课程' : '今日新课',
title:
'第 ${lesson.number} 课 · ${lesson.title}'
'${segments > 1 ? ' · 第 $segment/$segments 段' : ''}',
note: isSegmentResuming
? '第 $segmentIndex 段已学完;继续本课下一段情境训练。'
: '预热词汇 → 听说读写 → 对话 → 独立尝试',
action: isSegmentResuming ? '继续学习第 $segment 段' : '开始今天的学习',
minutes: '12 分钟',
onPressed: () {
if (state.activeLessonId != lesson.id) {
state.openLesson(lesson.id);
}
onStartLesson();
},
);
}
_TodayTask _stageTask() {
final usable =
'可使用 ${state.coreUsableCount}/$a0UsableGoal · '
'已掌握 ${state.coreMasteredCount}/$a0MasteredGoal';
final packId = state.nextAssessmentPackId;
if (state.a0AssessmentReady && packId != null) {
return _TodayTask(
label: '阶段评估',
title: 'A0 阶段评估 · $packId',
note: '$usable。可以开始阶段评估,两套评估间隔至少 24 小时。',
action: '开始阶段评估',
minutes: '15 分钟',
onPressed: () => onOpenAssessment(packId),
);
}
return _TodayTask(
label: 'A0 巩固',
title: state.a0AssessmentReady ? '第二套评估 24 小时后开放' : 'A0 课程已学完',
note: state.a0AssessmentReady
? '第一套评估已通过。等待期间继续巩固。'
: '$usable。继续按时复习、做情境对话,达到要求后开放阶段评估。',
action: '安排一题巩固练习',
minutes: '3 分钟',
onPressed: onStartReinforcement,
);
}
}
class _TodayTask {
const _TodayTask({
required this.label,
required this.title,
required this.note,
required this.action,
required this.minutes,
required this.onPressed,
});
final String label;
final String title;
final String note;
final String action;
final String minutes;
final VoidCallback onPressed;
}