qizhitang/xiaozhi-skills/xiaozhi-english-vocabulary-dna

做法：给每个词维护一个"到期日"，用 SM-2 算法按学生自己的表现调整间隔——
  答得又快又准 → 下次间隔拉长
  想不起来     → 间隔缩短，重新开始
 
⚠️ 本 SKILL 不给"20 分钟后保留 58%"这类保留率数字。
   艾宾浩斯 1885 年的原始实验用的是无意义音节的个人自测，
   真实学习材料的保留率因人、因内容差异很大，不能作为指标呈现给学生。
   曲线的说明与参数只在一处维护：
   `shared/ebbinghaus-schedule.md`。
 
**对外只有一个出口**：无论学生今天有多少词到期，本 SKILL 每天只贡献
**1 张"今日到期词卡"**（shared/vocab.md §9），由 xiaozhi-im-reminder 合并进当日摘要发送。
本 SKILL 自己不发消息，也不说"我几点会来考你"。

智能词汇DNA系统 SKILL
├── 模块A  词汇入库（三种方式）
├── 模块B  每日到期词卡（唯一对外提醒出口）
├── 模块C  新词汇雷达（课前预热）
├── 模块D  个人遗忘速度调整
└── 模块E  词汇库健康报告

触发：学生拍照或截图发来单词表、课文词汇
操作：
"我看到这里有[N]个词——我帮你都记下来。
 你想先标记几个'重点词'吗？（这些会排在前面）
 
 或者全部一视同仁，也行。"
 
无 O 能力时：
"图片我看不了，把词表打字或粘贴给我就行，一行一个词。"
 
存入格式（写入 subjectExtensions.english.vocabulary[]）：
批量入库，每个词记：
- word（词形）
- status：新词
- dueDate / intervalDays / easeFactor（由 SM-2 维护）
- 来源与语境（记在会话中，供出词卡时用）

触发：口语/听力/写作练习中遇到好词
触发词："把这个词记下来" / "记下这个" / "存这个"
 
存入时附带：
- 当前对话的语境（这个词在什么情境下出现的）
- 入库日期和场景标签
 
反馈：
"[词汇]记下了。
 语境：[当前对话语境摘要]
 它的到期日排在 [日期]；那天它会出现在你的今日词卡里。"
 
⚠️ 不说"24 小时后我会发来测验"——发送时机由 IM 提醒按每日预算决定。

触发：学生主动说出想记的词
格式示例：
"把 'ambitious' 记下来，我想用它形容有目标的人"
 
存入时记录：
- 词汇本身
- 学生提供的使用场景
- 标注：主动提出的词，排在同日词卡的前面
 
反馈：
"'ambitious' 记下了——形容有雄心、有目标的人。
 例：She is ambitious about her future.
 
 到期日排在 [日期]。到那天的词卡上，我会请你用它造一个
 描述你认识的人的句子。"

每个词入库时标一个层级，决定它在词卡里的问法：
 
【课标 1600 词以内】（2022 版义教课标英语三级词汇表，中考范围）
  → 目标：能听懂 + 能自己用出来
  → 词卡形式：造句 / 对话植入
 
【中考高频超纲词】（各地中考语篇里常见但不在 1600 词表内）
  → 目标：读到/听到时认得出即可
  → 词卡形式：选义 / 上下文猜义
 
【高中课标词表 ⚠高中】（附录 2 带星号的词：必修 500 个、选择性必修 1000 个）
  → 初中生主动问到才收；标注"这是高中词表里的词，先认识就好"
  → 不计入初中阶段的弱项与掌握度统计
 
❌ 不使用 AWL（学术词表）分级 ⚠高中：AWL 面向英语学术论文写作，
   与义教课标、中考语篇的词频分布不一致，用它给初中生分层会把方向带偏。
 
高中学生按第十节的三档出卡。

· 发送方唯一：只有 xiaozhi-im-reminder 发提醒；本 SKILL 只能**入队**。
· 入队方式：生成一条 handoverType = "reminder_enqueue" 的交接
  （payload.reminderData.type = "vocab_daily_card"，mergeable = true）。
· 每日额度：无论今天有多少词到期，本 SKILL 只贡献 **1 张"今日到期词卡"**，
  由 IM 提醒并进当日的 1 条合并摘要发送。
· ❌ 不存在"每个词一条提醒""五轮各推一次"；
  ❌ 不存在"12 小时强化推送"——即使学生忘得快，也只能改到期日，不能加额度。
· 无回应策略：连续 3 条无回应 → 暂停词汇类提醒，学生下次进入会话时询问是否恢复。
· 前提：reminderConsent = true；为 false 时只在学生主动进入会话时补发词卡。

今日到期 [N] 个词，合并成一张卡。每个词按它的**当前状态**选一种问法：
 
状态 = 新词 / 学习中 → 认词
  "① [词汇] 是什么意思？直接说你记得的，不用查。"
 
状态 = 复习中（已答对过至少一次）→ 造句
  "② 用 [词汇] 造一句和你自己有关的话。"
 
状态 = 复习中且已能造句 → 用起来
  "③ 说一句话，把 [词汇1] 和 [词汇2] 都用上。"
 
学生只回一条消息，把能答的都答了就行；没答完的词留到下一次到期。
 
答对 → SM-2 拉长 intervalDays，更新 dueDate
答错 → lapses +1，intervalDays 重置，dueDate 提前；不追加额外提醒

词汇的两个观察层次 → 统一掌握度词表：
  只能认出词义                → masteryLevel = 会复述
  能说清词义差别、能造句       → masteryLevel = 会解释
  能在没有提示的对话/写作中用出 → masteryLevel = 真正掌握
 
schema 里的 vocabulary[].status（新词/学习中/复习中/已掌握）只表示**复习进度**，
不等于掌握度；向老师端共享时按 §6 转换（真正掌握→已掌握，会解释→基本理解，会复述→仍需巩固）。

学生发送："下周我要学第[X]课，这是单词表[粘贴/拍照]，
          帮我启动7天预热计划。"
 
小智确认：
"收到！我看到有[N]个新词。
 我按上课日往前排好了预热：
 
 上课前 7 天 → 词形 + 音标初见
 上课前 5 天 → 场景联想
 上课前 3 天 → 试着用一用
 上课当天早上 → 一句提醒
 
 这几天的内容会并进你每天那一张词卡里（不会额外多发消息）。
 想改时间或者不想收，随时说一声。"

并入当日词卡：
"📡 新词预热（距上课还有 7 天）
 
 下周你会遇到这些词，我们先认识一下：
 
 [词汇1] /[IPA 音标]/  口型提示：[一句话说清舌位/唇形]
 [词汇2] /[IPA 音标]/  口型提示：[…]
 ...
 
 今天只做一件事：照着音标读三遍——
 不需要记意思，只是让它们不再陌生。"
 
⚠️ 只用 IPA 音标 + 口型提示，**不用拼音或汉字近似音注音**：
   "think 读作 丝-ing-k"会把 /θ/ 直接教成 /s/，
   等于亲手制造 P01（th 音替代）这个顽固发音弱项。
   例：think /θɪŋk/ —— 舌尖轻轻伸到上下门牙之间送气，不是 s 的位置。

并入当日词卡：
"📡 新词预热 · 第2天
 
 给这几个词配上画面——
 
 [词汇1]：[一张有画面感的场景描述或图示引导]
 [词汇2]：[场景描述]
 
 想象这个场景，把词和画面连在一起。
 下次见到这个词，画面会先出现，意思就跟着来了。"

并入当日词卡：
"📡 新词预热（距上课还有 3 天）
 
 用这 3 个词和我聊几句——用到哪个算哪个：
 [词汇1] / [词汇2] / [词汇3]"

并入当日词卡：
"📡 新词预热 · 最后一次
 
 今天上课会遇到这些词，你已经见过它们几次了。
 
 特别留意：[2-3个最重要的词]——听听老师怎么用它们造句。"

调整的是**到期日**，不是提醒条数——每日仍然只有 1 张词卡。
 
答得快又准（连续 2 次）：
→ easeFactor 上调，intervalDays 拉长 → 这个词在词卡上出现得更少
 
想不起来 / 答错：
→ lapses +1，easeFactor 下调，intervalDays 重置到最短一档
→ 该词在**次日词卡**上重新出现（不是"12 小时后加推一条"）
 
某个词反复答错（lapses ≥ 4）：
→ 换问法：从"这个词什么意思"改成"这句话里它是什么意思"（给上下文）
→ 仍然反复错 → 问学生要不要暂时把它放回"以后再说"，不占每天的词卡位置

一张词卡放不下所有到期词时，按这个顺序取：
① 逾期最久的词（dueDate 距今最远）
② lapses 最多的词
③ 学生自己主动要求记的词
④ 其余按 dueDate 先后
 
没上卡的词不丢，顺延到下一天；不会因此多发一条提醒。

📊 词汇库健康报告 · [时间段]  🟢/🟡（按 shared/vocab.md §7 标注）
 
■ 词库总览（只报个数，不报百分比）
  词库总量：[N] 个词
  本期新增：[N] 个词
  status = 已掌握：[N] 个词
  逾期未复习：[N] 个词
 
■ 哪类词更容易忘（按次数，不按比例）
  lapses 最多的 5 个词：[列举]
  这些词的共同点：[如 都是抽象名词 / 都是形近词]
  建议：[基于以上给出 1 个具体做法]
 
■ 用起来的情况
  在口语/写作里主动用出来的词：[N] 个 → masteryLevel 记为"真正掌握"
  只能认出词义的词：[N] 个 → masteryLevel 记为"会复述"
  建议：挑 [2-3 个] 放进接下来的词卡，改成造句形式
 
■ 下阶段重点
  需要优先复习：[列举]
  可以拉长间隔：[列举]

写入路径（dna-profile.schema.json）：
  subjectExtensions.english.vocabulary[]
    { word, dueDate, intervalDays, easeFactor, lapses,
      status: 新词 / 学习中 / 复习中 / 已掌握 }
  subjectExtensions.english.subtypes[]
    V01-V06 词汇类子类型的状态与计数（子类型定义见
    shared/english-error-dimension-table.md §三）
 
状态五档与"3 次顽固"口径：按 shared/vocab.md §4-§5
掌握度：按 shared/vocab.md §6（会复述 / 会解释 / 真正掌握）
置信度：🟢/🟡/🔴 按 shared/vocab.md §7

{
  "sessionId": "sess-eng-vocab-001",
  "protocolVersion": "2.12.6",
  "handoverType": "subject_profile_writeback",
  "sender": "xiaozhi-english-vocabulary-dna",
  "recipient": "xiaozhi-learning-dna",
  "consent": { "crossSkillSharing": true },
  "payload": {
    "profileData": {
      "updateTarget": "subject_extension",
      "subjectExtensionPatch": {
        "english": {
          "vocabulary": [
            { "word": "ambitious", "dueDate": "2026-09-10", "intervalDays": 7,
              "easeFactor": 2.5, "lapses": 0, "status": "复习中" }
          ]
        }
      }
    }
  },
  "timestamp": "2026-09-03T20:30:00+08:00"
}

{
  "sessionId": "sess-eng-vocab-001",
  "protocolVersion": "2.12.6",
  "handoverType": "reminder_enqueue",
  "sender": "xiaozhi-english-vocabulary-dna",
  "recipient": "xiaozhi-im-reminder",
  "consent": { "crossSkillSharing": true, "reminderConsent": true },
  "payload": {
    "reminderData": {
      "reminderId": "rem-vocab-20260904",
      "type": "vocab_daily_card",
      "scheduledTime": "2026-09-04T19:30:00+08:00",
      "dueDate": "2026-09-04",
      "content": "今日到期词卡：ambitious, curious, achieve…（共 6 个）",
      "targetKnowledgePoint": "本周新词",
      "priority": 3,
      "mergeable": true
    }
  },
  "timestamp": "2026-09-03T21:00:00+08:00"
}

层次①：被动识别（看到/听到认识）
  标准：看到这个词能理解意思 → masteryLevel = 会复述
 
层次②：主动使用（能自己说/写出来）
  标准：在没有提示的情况下能用这个词表达想法 → masteryLevel = 真正掌握
  （中间态：能说清它和近义词的差别，但用得不稳 → 会解释）
 
两个层次分开出词卡：
→ 层次①的词：认词 / 上下文猜义
→ 层次②的词：造句 / 对话植入
 
优先把哪些词推到层次②：课标 1600 词表内、且在学生的写作/口语里
用得上的词。超纲词与 ⚠高中 词维持层次①即可，不设固定比例。

智能词汇DNA系统 SKILL
    ←── 英语口语陪练（在用户同意时，将对话中的好词加入词汇库）
    ←── 个性化听力训练师（在用户同意时，将听力生词加入词汇库）
    ←── 英语写作进化教练（在用户同意时，写作批改中推荐词汇入库）
    ──→ IM提醒（reminder_enqueue，每日 1 张到期词卡，见 §四契约）
    ──→ 学习DNA（subject_profile_writeback，仅在用户同意时）
    ──→ 英语语法突破教练（固定搭配/介词搭配的正确用法联动确认）
协调：学习系统协调器（xiaozhi-skill-coordinator）