## 独立词库 理解词原先只能跟着课程单元走,学完 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>
188 lines
6.0 KiB
Dart
188 lines
6.0 KiB
Dart
part of '../lesson_flow.dart';
|
|
|
|
class _WritingStep extends StatefulWidget {
|
|
const _WritingStep({
|
|
required this.state,
|
|
required this.lessonId,
|
|
required this.segmentId,
|
|
required this.activity,
|
|
required this.controller,
|
|
required this.showHelp,
|
|
required this.canContinue,
|
|
required this.onChanged,
|
|
required this.onToggleHelp,
|
|
required this.onContinue,
|
|
});
|
|
final String lessonId;
|
|
final AppState state;
|
|
final String segmentId;
|
|
final LessonActivity activity;
|
|
final TextEditingController controller;
|
|
final bool showHelp;
|
|
final bool canContinue;
|
|
final VoidCallback onChanged;
|
|
final VoidCallback onToggleHelp;
|
|
final ValueChanged<bool> onContinue;
|
|
|
|
@override
|
|
State<_WritingStep> createState() => _WritingStepState();
|
|
}
|
|
|
|
class _WritingStepState extends State<_WritingStep> {
|
|
WritingCheckResult? result;
|
|
WritingAiFeedback? aiFeedback;
|
|
String? aiFeedbackError;
|
|
bool requestingAiFeedback = false;
|
|
|
|
void _checkOrContinue() {
|
|
if (result?.complete == true) {
|
|
widget.onContinue(aiFeedback != null);
|
|
return;
|
|
}
|
|
setState(
|
|
() => result = WritingFeedback.check(
|
|
widget.segmentId,
|
|
widget.controller.text,
|
|
),
|
|
);
|
|
}
|
|
|
|
Future<void> _requestAiFeedback() async {
|
|
if (widget.controller.text.trim().isEmpty || requestingAiFeedback) return;
|
|
if (widget.state.aiProvider == AiProviderType.mock) {
|
|
setState(() => aiFeedbackError = '请先在“我的”配置 AI 服务;本地检查仍可继续学习。');
|
|
return;
|
|
}
|
|
setState(() {
|
|
requestingAiFeedback = true;
|
|
aiFeedbackError = null;
|
|
});
|
|
final feedback = await AiService.instance.capabilities.evaluation
|
|
.evaluateWriting(
|
|
provider: widget.state.aiProvider,
|
|
endpoint: widget.state.aiEndpoint,
|
|
model: widget.state.aiModel,
|
|
lessonId: widget.lessonId,
|
|
taskPrompt: widget.activity.writingPrompt,
|
|
answer: widget.controller.text.trim(),
|
|
level: lessonLevel(widget.lessonId),
|
|
);
|
|
if (!mounted) return;
|
|
setState(() {
|
|
requestingAiFeedback = false;
|
|
aiFeedback = feedback;
|
|
aiFeedbackError = feedback == null
|
|
? '暂时无法获得 AI 反馈。你的答案保留在这里,可稍后重试或继续本地练习。'
|
|
: null;
|
|
});
|
|
}
|
|
|
|
@override
|
|
Widget build(BuildContext context) => _LessonScaffold(
|
|
step: 5,
|
|
child: SpacedColumn(
|
|
children: [
|
|
const Eyebrow('写一写'),
|
|
Text(
|
|
widget.activity.writingPrompt,
|
|
style: Theme.of(context).textTheme.headlineMedium,
|
|
),
|
|
SectionCard(
|
|
tint: AppColors.surfaceMuted,
|
|
child: Text('小提示:${grammarNoteForSegment(widget.segmentId)}'),
|
|
),
|
|
SegmentUsage(segmentId: widget.segmentId, state: widget.state),
|
|
if (widget.showHelp)
|
|
SectionCard(
|
|
tint: AppColors.softGreen,
|
|
child: Text(
|
|
widget.activity.writingExample,
|
|
style: TextStyle(fontSize: 18, height: 1.5),
|
|
),
|
|
),
|
|
TextField(
|
|
controller: widget.controller,
|
|
onChanged: (_) {
|
|
setState(() {
|
|
result = null;
|
|
aiFeedback = null;
|
|
aiFeedbackError = null;
|
|
});
|
|
widget.onChanged();
|
|
},
|
|
minLines: 3,
|
|
maxLines: 4,
|
|
decoration: InputDecoration(
|
|
labelText: '你的答案',
|
|
hintText: widget.showHelp
|
|
? widget.activity.writingExample
|
|
: '请输入完整英文答案',
|
|
filled: true,
|
|
fillColor: AppColors.surface,
|
|
border: const OutlineInputBorder(),
|
|
),
|
|
),
|
|
TextButton(
|
|
onPressed: widget.onToggleHelp,
|
|
child: Text(widget.showHelp ? '收起示例,自己试一次' : '需要帮助,查看示例'),
|
|
),
|
|
OutlinedButton.icon(
|
|
onPressed: widget.canContinue && !requestingAiFeedback
|
|
? _requestAiFeedback
|
|
: null,
|
|
icon: requestingAiFeedback
|
|
? const SizedBox(
|
|
width: 16,
|
|
height: 16,
|
|
child: CircularProgressIndicator(strokeWidth: 2),
|
|
)
|
|
: const Icon(Icons.auto_awesome_outlined),
|
|
label: Text(requestingAiFeedback ? '正在获取反馈…' : '获取 AI 写作建议(可选)'),
|
|
),
|
|
if (aiFeedback != null)
|
|
SectionCard(
|
|
tint: aiFeedback!.verdict == 'accepted'
|
|
? AppColors.softGreen
|
|
: AppColors.warm,
|
|
child: SpacedColumn(
|
|
spacing: 6,
|
|
children: [
|
|
Text('AI 建议:${aiFeedback!.feedback}'),
|
|
if (aiFeedback!.missing.isNotEmpty)
|
|
Text('还可补充:${aiFeedback!.missing.join('、')}'),
|
|
if (aiFeedback!.suggestion != null)
|
|
Text('可参考改写:${aiFeedback!.suggestion}'),
|
|
Text(
|
|
'这是学习帮助;请按自己的意思重写后再检查,系统不会仅凭 AI 建议记为掌握。',
|
|
style: TextStyle(fontSize: 12, color: AppColors.muted),
|
|
),
|
|
],
|
|
),
|
|
),
|
|
if (aiFeedbackError != null)
|
|
SectionCard(
|
|
tint: AppColors.warm,
|
|
child: Text(
|
|
aiFeedbackError!,
|
|
style: TextStyle(color: AppColors.warmInk),
|
|
),
|
|
),
|
|
if (result != null)
|
|
SectionCard(
|
|
tint: result!.complete ? AppColors.softGreen : AppColors.warm,
|
|
child: Text(
|
|
result!.message,
|
|
style: TextStyle(
|
|
color: result!.complete ? AppColors.green : AppColors.warmInk,
|
|
),
|
|
),
|
|
),
|
|
PrimaryButton(
|
|
label: result?.complete == true ? '进入课程对话' : '检查句子',
|
|
onPressed: widget.canContinue ? _checkOrContinue : null,
|
|
),
|
|
],
|
|
),
|
|
);
|
|
}
|