Xiaozhi Teach Lesson Log

误区① 凭记忆：下课就忘，下周上课时
        不知道上次讲了什么、学生什么状态。

误区② 流水账：只写"今天讲了 X 章节"，
        没有掌握度评估、没有学生反应、
        没有下节课衔接点。

误区③ 不写：觉得"我心里有数就行"，
        累积下来学员成长轨迹全无，
        续费沟通和阶段报告全凭印象。

                ┌──────────────────────────┐
                │ ① 课后 5 分钟内记录       │
                │  学员/日期/课题           │
                └────────────┬─────────────┘
                             ↓
                ┌──────────────────────────┐
                │ ② 5 维度结构化            │
                │  学/掌握/反应/进步/调整  │
                └────────────┬─────────────┘
                             ↓
                ┌──────────────────────────┐
                │ ③ 分知识点记掌握度        │
                │  perTopicMastery[]        │
                └────────────┬─────────────┘
                             ↓
                ┌──────────────────────────┐
                │ ④ 生成课时待确认条目      │
                │  pendingConfirmations     │
                │  老师确认后才计入 usedUnits│
                └────────────┬─────────────┘
                             ↓
                ┌──────────────────────────┐
                │ ⑤ 下节课衔接点            │
                │  写 nextLessonFocus       │
                └────────────┬─────────────┘
                             ↓
                ┌──────────────────────────┐
                │ ⑥ 家长事实摘要（可选）    │
                │  查两个授权位             │
                │  → 起草内部草稿           │
                │  发不发由老师自己决定     │
                └──────────────────────────┘

workspace.lessonLogs[].perTopicMastery = [
  { "topic": "一元一次方程移项", "masteryStatus": "已掌握" },
  { "topic": "去分母",           "masteryStatus": "仍需巩固" },
  { "topic": "含参方程",         "masteryStatus": "需要重讲" }
]
workspace.lessonLogs[].masteryStatus = "仍需巩固"   ← 整体判断

✅ studentReaction = "疲惫"
   evidence = "后 20 分钟两次走神，问'还有多久下课'"

❌ 不写：触发点（猜测）：可能是昨晚没睡好 / 家里有事 / 对数学有畏难情绪
❌ 不写：情绪标签（"焦虑""厌学""抗拒数学"）
❌ 不写：推断性特质（"抗挫能力弱""思维能力强""专注力差""动机不足""性格内向"）
❌ 不写：对家庭情况的推测

窗口 1（理想）：课后 0-5 分钟
  · 学生刚走，趁记忆清晰
  · 完成核心 5 维度记录

窗口 2（可接受）：课后 5-30 分钟
  · 关键信息不丢
  · 5 分钟内补完

窗口 3（事后回忆）：课后 30 分钟-24 小时
  · 标注"事后回忆，准确度有限"
  · 重点补核心：学了什么 + 掌握度

窗口 4（过期）：课后 > 24 小时
  · 强烈不建议
  · 教学价值大幅下降

学生离开前 1 分钟（5 句话速记）：
  ① 今天（[日期]）学了 [课题]
  ② [化名] 掌握了 [X]，没掌握 [Y]
  ③ 课堂反应：□投入 □平稳 □疲惫 □抗拒 □未观察
  ④ 下次讲 [X]
  ⑤ 需要给家长说：[X / 暂不需要]

课后再花 3-5 分钟补全 5 维度与 perTopicMastery。

速记版（课后 1 分钟内）：
  · 5 句话
  · 课题 + 掌握度 + 反应 + 衔接 + 家长沟通

完整版（课后 5-10 分钟）：
  · 5 维度结构化
  · 含错题/弱项/调整方向

每次课后记录 = 学员学习轨迹的一个点
轨迹包含：
  · 课时编号
  · 日期
  · 课题
  · 掌握度
  · 进步方向
  · 调整方向

单课时记录   → workspace.lessonLogs[]（本 SKILL 写）
分知识点掌握 → workspace.lessonLogs[].perTopicMastery[]
进步证据     → workspace.progressEvidence[]
累积轨迹     → 派生视图，由上述字段按 date 排序聚合，不落库

工作台（solo-dashboard）只读这些字段渲染，本 SKILL 不向它推送。

① 本 SKILL 写 lessonLogs[].consumeLessonUnits = 1（本节课的建议消耗数）
       ↓
② 同时在 coursePackageLedger[].pendingConfirmations 追加一条：
     { "lessonId": "L-20260904-A", "units": 1, "generatedAt": "2026-09-04T20:10:00+08:00" }
       ↓
③ 向老师问一次：
     「小A 今天这节课记 1 课时，确认吗？（确认 / 改成 X 课时 / 这次不扣）」
       ↓
④ 老师确认 → 从 pendingConfirmations 移出，usedUnits +1、remainingUnits -1
   老师没回 → 条目留在 pendingConfirmations，剩余课时不变

学生请假：
  · 生成 units=0 的待确认条目，并在 lessonLogs[].evidence 记请假事实
  · 请假原因只记"已请假"，不记家庭细节

老师取消：
  · 不生成课时条目
  · 补课时间由 xiaozhi-teach-schedule-manager 生成待确认的补课建议

补课：
  · 按实际时长生成待确认条目
  · 对应 lessonSchedule[].status = makeup

试听：
  · 不生成任何课时条目
  · 对应 lessonSchedule[].status = trial（schema 枚举值）
  · 试听记录照常写 lessonLogs，用于老师自己判断是否适配

■ 学生迟到
  · 10 分钟内：按整课时生成待确认条目
  · 10-30 分钟：按整课时生成，并提示老师是否需要与家长同步
  · > 30 分钟：生成 units=0.5 的待确认条目，或建议重新约

■ 学生早退
  · 同上，按实际上课时长判断

■ 老师迟到
  · 不生成课时条目，由老师决定补时长还是补课
  · 需要改期时转 xiaozhi-teach-schedule-manager

■ 网络/设备故障（线上课）
  · 5 分钟内：按整课时生成待确认条目
  · 5-15 分钟：按整课时生成，并记下需补的时长
  · > 15 分钟：建议本次重排，生成 units=0 的待确认条目

基于本次课后记录，生成下节课衔接建议（供老师取舍，不代替备课）：

  · 复习未掌握知识点
  · 继续未完成的进度
  · 强化新增弱项
  · 引入新内容（如进度允许）

  · 未掌握的知识点、需要重做的错题、节奏建议
      → workspace.lessonLogs[].nextLessonFocus（本 SKILL 写）
  · 老师备下一节课时直接读这个字段
  · 若装有教师通用包，可把它带给备课类 SKILL；未安装时老师自己用