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>
This commit is contained in:
@@ -21,6 +21,7 @@ part 'app_state_assessment.dart';
|
||||
part 'app_state_lesson.dart';
|
||||
part 'app_state_review.dart';
|
||||
part 'app_state_snapshot.dart';
|
||||
part 'app_state_words.dart';
|
||||
|
||||
/// Everything the app persists. Behaviour lives in the domain mixins that
|
||||
/// [AppState] composes.
|
||||
@@ -88,11 +89,31 @@ abstract class _AppStateData extends ChangeNotifier {
|
||||
|
||||
final Map<String, MasteryItem> mastery = {};
|
||||
|
||||
/// Recognition-only words, kept apart from [mastery] so they never enter a
|
||||
/// level's upgrade denominator (learning engine 3.5).
|
||||
final Map<String, WordKnowledge> wordKnowledge = {};
|
||||
|
||||
/// Words saved from lookup. They live outside any unit, so they are kept
|
||||
/// here to be put back into the word registry on the next start.
|
||||
final Map<String, RegisteredReceptiveWord> savedWords = {};
|
||||
|
||||
void _syncInBackground();
|
||||
}
|
||||
|
||||
class AppState extends _AppStateData
|
||||
with _ReviewAndMastery, _AssessmentProgress, _LessonProgress, _AiContent {
|
||||
with _ReviewAndMastery,
|
||||
_ReceptiveWords,
|
||||
_AssessmentProgress,
|
||||
_LessonProgress,
|
||||
_AiContent {
|
||||
/// Round-trip seam for tests: the real save and load go through
|
||||
/// `LocalSnapshotStore`, which needs a database.
|
||||
@visibleForTesting
|
||||
Map<String, dynamic> snapshotForTest() => _toSnapshotJson();
|
||||
|
||||
@visibleForTesting
|
||||
void restoreForTest(Map<String, dynamic> data) => _restore(data);
|
||||
|
||||
static const _storageKey = 'learning_state_v1';
|
||||
bool isLoaded = false;
|
||||
bool _writing = false;
|
||||
@@ -114,6 +135,9 @@ class AppState extends _AppStateData
|
||||
// Adapt the A1–B1 JSON packs into the runtime registries before the saved
|
||||
// snapshot is restored, so progress that points at those lessons resolves.
|
||||
await CourseRepository.instance.load();
|
||||
// The word bank is independent of the packs, so it loads whatever the
|
||||
// learner's lesson progress is.
|
||||
await WordBank.instance.load();
|
||||
final config = await AiConfigFile.loadFromAsset();
|
||||
if (config != null) {
|
||||
if (config.apiKey != null && config.apiKey!.trim().isNotEmpty) {
|
||||
|
||||
Reference in New Issue
Block a user