Xiaozhi Teach Resource Library

误区① 资源散落：讲义在电脑文件夹、题库在微信收藏、
        讲评话术在脑子里、错题案例在笔记本上，
        需要时找不到，找到时已过时。

误区② 从零开始：每个新学员/新学期都从零备课，
        之前教过的优秀案例、题库、讲评话术
        都没有积累，白白浪费。

误区③ 资源孤岛：优秀讲义、题库、讲评话术
        只在某个学员/某次课用一次，
        之后被遗忘。

                ┌──────────────────────────┐
                │ ① 入库                    │
                │  分类 + 版权状态          │
                └────────────┬─────────────┘
                             ↓
                ┌──────────────────────────┐
                │ ② AI 生成的先验算         │
                │  aiGenerated=true         │
                │  老师验算 → verifiedByTeacher│
                └────────────┬─────────────┘
                             ↓
                ┌──────────────────────────┐
                │ ③ 打标签                  │
                │  学科/知识点/难度/学段    │
                └────────────┬─────────────┘
                             ↓
                ┌──────────────────────────┐
                │ ④ 检索                    │
                │  关键词/知识点/难度       │
                └────────────┬─────────────┘
                             ↓
                ┌──────────────────────────┐
                │ ⑤ 改编适配后复用          │
                │  记来源 + 记效果          │
                └──────────────────────────┘

生成时（在别的环节）：
  按 shared/ai-item-check.md 自检——自解一遍、有解且唯一、
  条件充分不多余、数值友好、学段内、与原题同维度

到本 SKILL 入库时：
  aiGenerated = true
  verifiedByTeacher = false（默认）
  标题或 usageNotes 带【AI 生成，入库前请人工验算】

老师逐题验算后说"验过了"：
  verifiedByTeacher = true，标注可去掉

在 verifiedByTeacher 为 false 期间：
  · 检索时这条资源标灰，附一句「待验算，先别直接给学员」
  · 不进入"推荐给学员"的候选

┌──────────────────┬──────────────────────────────┬──────────────┐
│ 字段              │ 取值                          │ 用途          │
├──────────────────┼──────────────────────────────┼──────────────┤
│ subject          │ 数学/语文/英语/物理/…         │ 主分类        │
│ knowledgePoint   │ 一次函数图象/定语从句/…       │ 精确定位      │
│ gradeLevel       │ 年级或学段                    │ 适用筛选      │
│ difficulty       │ 基础/中等/提升/挑战（四档枚举）│ 难度匹配      │
│ resourceType     │ 题目/讲义/课件/板书/讲评话术/ │ 类型筛选      │
│                  │ 错因案例/家长话术（七档枚举） │              │
│ copyrightStatus  │ 自有/改编/公开可引用/仅存索引 │ 版权（必填）  │
│ aiGenerated      │ true / false                  │ 是否 AI 生成  │
│ verifiedByTeacher│ true / false                  │ 老师是否验算过│
│ usageNotes       │ 自由文本（≤500 字）           │ 用过几次、效果│
└──────────────────┴──────────────────────────────┴──────────────┘

■ 必填
  · resourceId / title / resourceType / copyrightStatus（schema required）
  · knowledgePoint + difficulty（不填就检索不到，等于没存）

■ 推荐
  · subject / gradeLevel
  · aiGenerated（AI 生成的必须为 true）

■ usageNotes 里写什么
  · 用过几次、给什么情况的学员用过、效果如何
  · 改编来源（"改自 R-001，把出租车换成快递"）
  · AI 生成未验算时的【AI 生成，入库前请人工验算】标注

输入：关键词（如"一次函数复习"）
匹配：所有包含"一次函数"+"复习"的资源
排序：按相关度 / 使用频率 / 学员匹配度

输入：学员化名 + 当前卡住的知识点
读：workspace.studentCards[].gradeBand / .primaryWeaknesses
    workspace.homeworkFollowups[].mainErrors[].knowledgePoint / .dimension
匹配：knowledgePoint 相同 + difficulty 与当前掌握度相称 +
      gradeLevel 在该学员学段内
输出（每条标明为什么推荐它）：
  · [资源标题]（[类型]，[难度]）
    推荐理由：针对 [知识点] 的 [dimension]，上次给 [场景] 用过
    ⚠️ 待验算：aiGenerated=true 且 verifiedByTeacher=false 的标出来

不做的事：
  ❌ 按"这是基础学员"整批推荐一组资源
  ❌ 推荐超出该学员 gradeBand 的内容（要用就标 ⚠高中 并说明是拓展）

输入：通用四维之一（概念模糊 / 计算失误 / 读题失误 / 方法用错，
      见 shared/vocab.md §1）
匹配：resourceType=错因案例 且 knowledgePoint 或维度相符的条目
输出：
  · 案例描述（已脱敏，不含任何可识别到具体学员的细节）
  · 当时的应对动作
  · 效果记录（写事实，不写"效果很好"）

第 1 步：检索资源
  · 基于当前需求（学员画像/学情）检索
  · 找到 1-3 个候选资源

第 2 步：评估匹配度
  · 难度匹配？
  · 知识点匹配？
  · 学员类型匹配？

第 3 步：调整适配
  · 修改参数（数字/情境）
  · 调整难度
  · 添加学员特定元素

第 4 步：使用并记录
  · 标记"复用自 [资源 ID]"
  · 记录使用效果
  · 反馈到资源库

■ 改数（参数）
  原题 y=2x+1 → 改编 y=3x-2
  适合：同一知识点不同参数
  ⚠️ 改完必须重算一遍：换个系数就可能算出无理数或负人数

■ 改问（设问角度）
  原题"求 X" → 改编"判断 X 是否正确"
  适合：换角度测同一概念

■ 改情境（背景）
  原题"出租车" → 改编"网约车"
  适合：让题目更贴近学生生活
  ⚠️ 换情境要检查量纲还合不合理（速度、单价、人数）

■ 改综合度
  单知识点 → 多知识点综合
  适合：检验综合应用
  ⚠️ 改成综合题后不再与原题同型，不能再当"同类题"用于弱项验证

改编后一律按 shared/ai-item-check.md 复核：自解一遍、有解且唯一、
条件充分不多余、数值友好、学段内。改编件的 copyrightStatus 记 `改编`，
usageNotes 里写清原出处与改动点。

usageNotes 写法（**只记资源本身的使用情况，不记学员**）：
  用过 2 次 | 效果：1 次需提示、1 次直接做对 | 下次配纯净版再试
  → 不写学员化名、日期、分数、个体弱项。个体层面的记录在 lessonLogs / homeworkFollowups 里已经有，
    靠 resourceId 关联即可；把它们再抄一遍进 usageNotes，会在一条自由文本里累积成准可识别的学员画像
  改自 R-001（把出租车情境换成快递），已重算
  【AI 生成，入库前请人工验算】← 验算后删掉这一行

写事实，不写"效果很好""这题很经典"——
后者三个月后回头看，等于什么都没说。
超过 500 字符时保留最近几条，旧的合并成一句"此前用过 N 次"。

✅ 自有
  老师自己写的
  完整存储

✅ 改编
  基于某资源改编
  必须在 usageNotes 标注"原出处 + 改了什么"

✅ 公开可引用
  教材例题、明确开放授权（如 CC 协议）的资源
  完整存储，标注来源

⚠️ 仅存索引
  **教辅原题与历年真题一律归这一档**，没有例外
  只记书名/卷名、页码、题号，不录入题干、不存扫描件
  检索时给出"在哪本书第几页"，老师自己去翻

❌ 禁止入库
  未授权的教辅原题题干
  盗版扫描件、拍照件
  未授权转载的网络资源

■ 必脱敏
  · 真实姓名 → 化名
  · 学校名称 → "某公立/民办学校"
  · 年级 → 模糊（"初中学员"）
  · 家长身份 → 移除
  · 家庭住址 → 移除
  · 联系方式 → 移除

■ 可保留（用于案例分析）
  · 学科
  · 知识点
  · 错因
  · 应对动作
  · 效果数据

□ 学员姓名已替换为化名
□ 学校名称已模糊化
□ 年级已模糊化（"初中学员"等）
□ 家长身份信息已移除
□ 家庭住址已移除
□ 联系方式已移除
□ 案例描述不含可识别细节
□ 案例分析基于错因/方法/效果而非具体人

■ 必入库时机
  · 学员试讲课讲义通过后
  · 优秀作业讲评案例
  · 重要错因突破案例
  · 阶段性测评优秀试卷
  · 复习规划方案

■ 选入库时机
  · 课堂过渡话术
  · 家长沟通案例
  · 学员进步转折点

每次使用资源后：
  · 标记使用次数
  · 记录使用效果
  · 标记"使用频率高"或"待改进"

→ 资源库排序基于实际使用效果
→ 高频高质量资源进入"我的最爱"
→ 低频低质资源进入"待优化"或"归档"

新入库 → 试用 → 优化 → 成熟 → 经典
  ↓
  归档（如过时/淘汰）

  老师说"这个存一下" ──→ ┌────────────────────┐ ──→ 检索结果（带推荐理由）
  老师说"帮我找…"   ──→ │ resource-library    │ ──→ 改编后的资源
                        │ （本 SKILL）         │
                        └─────────┬──────────┘
                                  │ 只写这一处
                          resourceLibraryIndex[]

读：
  workspace.studentCards[].alias / .gradeLevel / .gradeBand /
      .subjects / .goals / .primaryWeaknesses
                          → 匹配资源用（按知识点与难度，不按"学员类型"）
  workspace.homeworkFollowups[].mainErrors[].knowledgePoint / .dimension
                          → 按当前错因找对应的题与讲评话术
  workspace.lessonLogs[].completedContent / .nextLessonFocus
                          → 找下节课要用的材料

写（唯一写入处）：
  workspace.resourceLibraryIndex[].resourceId
  workspace.resourceLibraryIndex[].title
  workspace.resourceLibraryIndex[].resourceType   （七档枚举）
  workspace.resourceLibraryIndex[].subject
  workspace.resourceLibraryIndex[].gradeLevel
  workspace.resourceLibraryIndex[].knowledgePoint
  workspace.resourceLibraryIndex[].difficulty     （四档枚举）
  workspace.resourceLibraryIndex[].copyrightStatus（四档枚举，必填）
  workspace.resourceLibraryIndex[].aiGenerated    （AI 生成的必须 true）
  workspace.resourceLibraryIndex[].verifiedByTeacher（老师验算后才 true）
  workspace.resourceLibraryIndex[].usageNotes     （用过几次、效果、改编来源）

派生视图（不落库）：
  · 匹配结果   ← resourceLibraryIndex[] 与 studentCards[] / mainErrors[] 实时比对
  · 使用统计   ← 运行时聚合；要留痕就写进 usageNotes，不新增字段

不写：
  · 题干原文（copyrightStatus=仅存索引 的资源只记出处）
  · 任何学员可识别信息（案例一律脱敏）

✅ 可存储：化名案例、自有内容、改编件、公开可引用资源
❌ 禁止：未授权教辅原题的题干、盗版扫描件、未授权转载
✅ 案例可保留：学科/知识点/错因维度/应对方法/效果事实
❌ 不保留：真实姓名/学校/家长信息/家庭住址/联系方式
✅ 检索基于：知识点、难度、类型、关键词
❌ 检索不支持：反查具体学员（"这条案例是谁"）

教学资源复用库（自成闭环，不需要前置 SKILL）
    读 workspace.studentCards[]        ← student-intake 写
    读 workspace.homeworkFollowups[]   ← homework-tracker 写
    读 workspace.lessonLogs[]          ← lesson-log 写
    写 workspace.resourceLibraryIndex[] ← 本 SKILL 唯一写入方

  其他 SKILL 需要资源时直接读 resourceLibraryIndex[]，本 SKILL 不推送。
  若装有教师通用包，备课/作业/命题类 SKILL 可来检索；未安装不影响使用。