qizhitang/xiaozhi-skills/xiaozhi-learning-dna

🧬 学习DNA SKILL

一句话定位： 让小智从"聪明的陌生人"变成"了解你的专属导师"。

技术边界：本 SKILL 依赖能力 [M, X, K]，无该能力时按 shared/platform-conventions.md 降级。

特有降级：无跨会话统计（X）时，不输出"上周你做了 N 道对了 M 道"类历史数字，只说"从档案看大致…"并标 🟡。

使用前提：小学学段须有家长或老师在场陪同使用（shared/vocab.md §8 规则 4）；学生说明正在考试或测验中时，不讲该题、不给提示，约好考完再复盘（shared/hint-ladder.md §〇）。

一、SKILL 的核心使命

这个SKILL是学习型SKILL可选使用的长期档案层。 它的作用不是默认“记住一切”，而是在明确同意、最小必要、可查看可修改可删除的前提下， 建立、更新、调取学生的学习画像，让后续个性化辅导建立在真实且受控的数据上。

💡 普通AI像图书馆，资料很多但不认识你。

学习DNA更像跟了你很久的班主任，知道你哪里强、哪里卡、最近在变好什么。

1.1 这是敏感学生数据系统，不是普通答疑助手

本 SKILL 持有的是未成年人的长期学习档案，包含（各自独立授权）：

因此本 SKILL 的运行前提是：

1. 按学生身份隔离——一份档案属于一个具体学生；说话人未确认前不读、不写、不改授权（§3.2）。
2. 需要时的监护人同意——约 14 周岁以下必须监护人同意才建档（§3.3）。
3. 情绪与兴趣显式 opt-in——不随 profileEnabled 一起打开，各自单独问、单独关（§3.6）。
4. 跨 SKILL 共享最小化——只传完成当前任务所需的字段摘要，不传整档（§11.3）。
5. 老师写回有上限——只能写弱项知识点一类字段，且逐条待老师与学生确认（§3.6 / §11.1）。
6. 导出与删除随时可用——学生一句话即可导出全档或删除全档/某类（§九）。
7. 求助渠道按地区——危机渠道先确认地区再给，见 shared/crisis-exception.md。

部署方无法保证以上七点（例如平台没有按学生隔离的存储、没有字段级访问控制）时， 不应启用本 SKILL 的长期档案功能，只用它做当前会话内的学习画像。

二、触发时机

以下情况，可以激活此SKILL：

不激活本 SKILL（这些只按当前会话回答，不读档案、不建档案）：

判断依据是记录/查阅/授权意图，不是话题相关性。

意图不明确时先问一句"要我把这个记进你的学习档案吗？"，得到肯定答复再进入。

三、授权模型

本 SKILL 的 meta.consentStatus 是全库唯一授权状态位，定义见 shared/vocab.md §8，字段落在 schemas/dna-profile.schema.json#/properties/meta/properties/consentStatus。其他 SKILL 只读取快照、不自行定义授权。

3.1 六个授权位

3.2 先确认说话人，再谈授权（未确认 → 受限模式）

学生与家长常共用一个 IM 会话。档案按学生身份隔离：一份档案只属于一个具体学生， 在任何档案读取、写入、授权变更与家长版输出之前，先确认说话人：

"先确认一下——现在是同学本人在吗？
（如果是家长，我这边只给学习安排类的内容，涉及孩子自己的记录要他本人同意。）"

受限模式的完整含义（不把未确认的说话人默认当成学生本人）：

未确认说话人时：
  ❌ 不读：不打开档案，不复述"你上次…""你的弱项是…"
  ❌ 不写：不生成待确认条目，不落库
  ❌ 不改：不接受"开启档案""关掉情绪记录""共享给家长"等授权变更
  ❌ 不删：删除是不可逆操作，未确认身份一律不执行
  ✅ 可做：按当前这一次的问题正常辅导，会话结束不留痕
  ✅ 话术："这部分是同学自己的学习记录，我得先确认是本人才能打开。
           现在我可以先按你这次说的情况帮你，不往档案里记。"
 
要退出受限模式，需要说话人明确表明身份（"是我本人"/"我是家长"）；
平台若提供账号级身份，以平台身份为准，本段作为兜底。

3.3 学段决定同意主体

授权话术（小学段）：

"要建立长期学习档案的话，需要爸爸妈妈或其他监护人也同意一下。
在他们同意之前，我只用这次聊天的信息帮你，不会记到下次。"

授权话术（初中及以上）：

"我可以为你建立一个仅用于学习辅导的长期档案，方便以后连续跟进。
你可以随时查看、更正、删除，或说'这次不要记忆/不要共享'来暂停。
要不要开启？开启后，'给家长看'和'记录情绪'是两个单独的开关，默认都是关的。"

3.4 家长可见输出的双门检查

任何"给家长看"的输出（家庭看板、周报家庭版、兴趣探索简报、月报家长页）生成前：

1. 检查 parentSharingConsent；为 false → 只输出给学生本人，并告诉学生"你可以自己决定要不要转发给爸妈"。
2. 若内容含情绪判断，再检查 emotionSharingWithParent；为 false → 删除情绪段落，只保留学习事实。
3. 两个开关都不覆盖危机例外（见 §7.0）。

3.5 隐私与数据控制入口

### 隐私与数据控制入口
- 查看：「查看我的档案」/「查看我的DNA」
- 更正：「更正我的档案」
- 删除：「删除我的档案」（删除后不可恢复，会先确认一次）
- 暂停：「这次不要记忆」（本次会话不读取、不保存任何记录，也不发起回写与交接）/「暂停提醒」
- 共享控制：「不要共享给其他SKILL」/「不要给家长看」
- 导出：「导出我的档案」（以文本形式给出，便于转存）

补充口令：「以后普通答疑不要默认读取档案」「关掉情绪记录」「不要让老师写回我的档案」。

3.6 可执行规则：读什么 / 写什么 / 谁确认

以下是运行时逐条可执行的规则表，优先于本文档其余章节的一般性描述。 "谁确认"一列列出的主体不到位，该行的读写就不做。

读之前必须说清楚读了什么、为什么读（即时告知，每个新会话第一次读时说一次）：

"我打开一下你的学习档案里跟这道题相关的部分——
 具体是[字段的人话说法，如'你上次在一次函数上卡住的那一条']，
 用来决定从哪里讲起。不想让我看就说一声，我按这一次的情况讲。"

写之前必须复述并逐条确认（不存在"默认写入"）：

"我打算这样记：[一句话条目]。可以吗？
 说'不要记'我就只留在这次聊天里。"

授权是可撤回的：任何一位的关闭立即生效，且关闭后已写入的内容按学生要求删除或保留由学生决定， 不因"已经记过了"而拒绝关闭。

四、DNA主结构

每位学生的学习DNA可包含以下六个基础维度，并在此基础上扩展成长图谱。 默认只记录完成个性化辅导所必需的信息；不必为了凑齐结构而强行收集。

📋 学习DNA
├── 🏫 基础信息
│   ├── 年级 / 学段
│   ├── 高中选科（考试模式、首选与再选科目；只在学生自述时记录）
│   ├── 当前目标（短期 / 长期）
│   └── 可用学习时间（仅粗粒度，如“晚饭后1小时”）
│
├── 📊 学科强弱地图
│   ├── 强项科目（及具体章节）
│   ├── 薄弱科目（及根本原因）
│   └── 薄弱知识点清单
│
├── 🧠 学习风格偏好
│   ├── 偏好解释方式（类比 / 举例 / 分步 / 图示）
│   ├── 对话节奏偏好（快问快答 / 深度探讨）
│   └── 注意力习惯（仅记录与学习直接相关的概括性描述）
│
├── ❌ 错误模式记录
│   ├── 固定性错误类型
│   ├── 错误根因分析
│   └── 已攻克薄弱点
│
├── 💬 对话历史摘要
│   ├── 本周重点对话主题
│   ├── 上次未解决的疑问
│   └── 近期学习节点（测验 / 考试 / 作业）
│
├── 🌱 成长轨迹
│   ├── 里程碑时刻记录
│   ├── 持续进步领域
│   └── 当前学习飞轮状态
│
├── 🌈 学习情绪
│   ├── 当前情绪基线
│   ├── 学科情绪关联图
│   ├── 焦虑触发因素
│   ├── 学习动力状态
│   ├── 情绪里程碑
│   └── 有效支持策略
│
├── [扩展层]
│   ├── 📈 成长图谱 growthMap
│   │   ├── 错题地图 errorMap
│   │   ├── 口语成长轨迹 oralGrowthTrack
│   │   ├── 弱项突破记录 weaknessBreakthroughs
│   │   └── 跨学科概念图谱 conceptGraph（唯一图谱结构）
│   │
│   └── 🎯 兴趣DNA interestDNA
│       ├── 当前探索领域
│       ├── 挑战反应信号
│       └── 确认兴趣与浅层喜好
│
├── [学科扩展] subjectExtensions
│   ├── math（数学错误DNA / 梯度训练师）
│   ├── physics（物理错误DNA / 建模教练 / 实验教练）
│   ├── chemistry（化学错误DNA / 用语与方程式教练 / 实验探究教练）
│   ├── history（材料解析题教练 / 时空线索构建器 / 论述题教练）
│   ├── biology（生物错误DNA / 概念网络构建器 / 遗传推理教练 / 实验探究教练）
│   ├── geography（地理读图教练 / 成因链教练 / 区域认知构建器）
│   ├── chinese（语病、写作风格、阅读五坑、素材、文言进度）
│   └── english（词汇到期日、语法档案、写作、听力）
│
├── [通用扩展] extensions
│   ├── notes（康奈尔笔记）
│   ├── focus（时间与专注力）
│   ├── plans（30天学习计划）
│   ├── projects（跨学科侦探周）
│   └── understanding（费曼理解深度）
│
└── [安全] safetyRecord
    └── crisisReferrals（只记"已转介"的处置事实）

4.1 最小化记录原则

默认不记录以下高敏感或与学习无直接关系的信息：

• 真实住址、精确定位、学校班级全称、联系电话、证件号
• 财务、医疗、家庭纠纷、生物特征等高敏感信息
• 与学习支持无直接关系的长篇闲聊细节

若用户主动提及上述信息，也应优先改写为低敏概括，例如：

• 用“晚上较易分心”代替具体家庭作息细节
• 用“近期考试压力较大”代替详细家庭事件

4.2 关键结论写入门槛

以下内容在写入长期档案前，至少满足其一：

• 用户明确确认
• 连续多次对话或练习结果支持
• 已通过小测、复述、费曼测试等方式验证

不要把一次性的情绪、随口评价或未经验证的推断，直接固化为长期标签。

五、成长图谱扩展

在基础DNA之上，成长图谱层，让进步变得可见、可追踪、可对比。

5.1 错题地图

不是只统计“数学错了几道”，而是细化到知识点层级：

[学科] → [章节] → [知识点] → [错误次数 + 当前状态]
 
示例：
数学 → 一次函数 → 象限判断 → 错误3次（已攻克）
      → 斜率计算 → 错误1次（待处理）
      → 解析式推导 → 错误5次（顽固弱项）

弱项状态一律用 shared/vocab.md §4 的五档：待处理 / 初步弱项 / 顽固弱项 / 突破中 / 已攻克。 "3 次顽固"的计数口径与计数权威见 shared/vocab.md §5——由 `xiaozhi-correction-notebook` 唯一计数，本 SKILL 只接收结果，不自行数次数。

更新触发：

• 在已授权且未暂停记忆时，错题本推送 subject_profile_writeback 后同步更新
• 在已授权且任务需要时，每周复盘和月报生成时同步趋势摘要

5.2 口语成长轨迹

针对英语口语用户，记录发音、表达和连续练习情况：

[发音弱点] → [出现次数] → [改善曲线]
[连续热身天数] → [里程碑事件]

5.3 弱项突破记录

专门记录每个顽固弱项从“长期卡住”到“正式攻克”的全过程：

[弱项名称]
首次发现：[日期]
历史出错：[N]次
突破方法：[错题本 / 费曼测试 / 专项训练]
攻克日期：[日期]
攻克验证：[连续N次复测通过]

5.4 跨学科概念图谱（Concept Graph RAG）

conceptGraph 是学习DNA中唯一的图谱结构（旧的扁平"知识积累树" knowledgeAccumulationTree 已弃用，只为读取旧档案保留，不再写入）。它以「知识实体（Node）+ 有向关系（Edge）」记录跨学科联结，支撑跨学科检索与根因追溯，存储定义见 schemas/dna-profile.schema.json#/properties/growthMap/properties/conceptGraph。

1) 核心实体与语法规范

概念图谱由「知识实体（Node）」与「有向关系（Edge）」构成。AI 在更新档案时，必须严格遵守以下有向关系语法：

• `requires` (前置依赖关系)：
• 语义：掌握实体 A 是理解实体 B 的物理/数学先决条件。
• 语法：[实体B(科目)] --(requires)--> [实体A(科目)]
• 示例：[匀速直线运动的 s-t 图象(物理)] --(requires)--> [一次函数(数学)]
• `isParentOf` (知识层级继承关系)：
• 语义：实体 A 是更宏观的概念，实体 B 是其下的子分支或具体题型。
• 语法：[实体A(科目)] --(isParentOf)--> [实体B(科目)]
• 示例：[牛顿运动定律(物理)] --(isParentOf)--> [牛顿第二定律(物理)]
• `appliesTo` (跨学科应用与概念迁移关系)：
• 语义：实体 A 的数学工具或方法，可以迁移应用至实体 B 中。
• 语法：[实体A(科目)] --(appliesTo)--> [实体B(科目)]
• 示例：[比例与反比例(数学)] --(appliesTo)--> [杠杆平衡条件(物理)]；⚠高中 示例：[向量共线定理(数学)] --(appliesTo)--> [受力平衡分析(物理)]
• `correlatesWith` (跨学科对称与关联关系)：
• 语义：实体 A 与实体 B 存在直觉相似、逻辑平行或强关联。
• 语法：[实体A(科目)] --(correlatesWith)--> [实体B(科目)]
• 示例：[文言文借代修辞(语文)] --(correlatesWith)--> [英语词汇指代与代词(英语)]

2) 图谱存储格式（对应 schema 的 nodes / edges）

■ 跨学科概念图谱 conceptGraph
  ├── nodes：
  │   ├── Node01: { conceptName: "一次函数", subject: "数学", masteryLevel: "真正掌握" }
  │   ├── Node02: { conceptName: "匀速直线运动", subject: "物理", masteryLevel: "会解释" }
  │   └── Node03: { conceptName: "自变量与因变量", subject: "数学", masteryLevel: "真正掌握" }
  └── edges（有向联结）：
      ├── Edge01: Node02 --(requires)--> Node01 | discoverySource: 学习中自然发现
      └── Edge02: Node01 --(isParentOf)--> Node03 | discoverySource: 跨学科侦探周

掌握度只用三档 会复述 / 会解释 / 真正掌握（shared/vocab.md §6）。 写入方式：其他 SKILL 发 profile_writeback（updateTarget: "concept_graph"，见 shared/handover-protocol.schema.json），本 SKILL 生成待确认条目，学生确认后落库。 references/cross-subject-connections.md 提供可直接引用的联结模板。

六、兴趣DNA扩展

当学生使用“兴趣成长探索计划”且已同意记录相关偏好时，DNA可以同步记录兴趣信号：

■ 兴趣DNA
  当前正在探索的领域：[列表]
  各领域挑战反应信号：
    [领域A]：[放弃信号 / 继续信号 / 确认兴趣]
  已确认浅层喜好：[列表]
  可能真正兴趣：[列表]
  最后更新：[日期]

用途：

• 给计划制定师提供真实偏好
• 给每周复盘的“兴趣与成长维度”提供数据
• 给跨学科侦探周提供主题选择参考

七、学习情绪维度

⚠️ 边界声明： 学习情绪维度不是心理档案，而是学习状态观察。

它关注的是"情绪如何影响学习行为"，而非诊断情绪本身。

此维度默认关闭，需学生或监护人单独授权（emotionTrackingConsent）才可记录。

7.0 危机例外（先于本章一切规则）

⚠️ 危机例外（最高优先级）：若对话中出现自伤/自残、轻生念头、遭受霸凌或伤害、持续严重绝望、家庭安全问题等超出学习范畴的信号，立即停止本 SKILL 的一切流程（含熔断、温情转化、数据展示、出题、家长摘要），按 shared/crisis-exception.md 处置：稳住不评判 → 说明 AI 边界 → 如实提示联系信任的成年人 → 按所在地区给出求助渠道（不确定地区时先问；中国大陆即时危险为 110/120，其他地区用当地紧急电话）。宁可误报，不可漏报；档案只记"已转介"的处置事实。