换新科目不用重新自我介绍:StudyMate跨科目共享记忆MEMORY.yaml是怎么工作的
换新科目不用重新自我介绍:StudyMate跨科目共享记忆MEMORY.yaml是怎么工作的
📌 换一门新科目,还要从"我会什么、学过哪些、喜欢怎么学"重新讲起吗?StudyMate 的跨科目共享记忆 MEMORY.yaml 会替你记住这些事——它把学习者的水平、讲法偏好与学习习惯存成一份 YAML 文件,每开一门新课时自动带入上下文,让你直接开讲、不用重新自我介绍。
为什么"换科目"总像在跟一个失忆的人聊天
直接跟 AI 聊天学习有个通病:会话一结束,上下文就清零;换个科目,等于面对一个全新的 AI,又要盘问一遍基础、目的、时间投入。
StudyMate 的思路是把"你是谁"从聊天记录里搬出来,落成工作区里的一份纯文本文件。它的位置固定在两个地方:
| 文件 | 位置 | 存什么 |
|---|---|---|
| 共享记忆 | <工作区>/.learning/MEMORY.yaml |
跨科目成立的画像与做法(默认工作区为 ~/StudyMate) |
| 科目记忆 | <工作区>/.learning/subjects/<slug>/MEMORY.yaml |
只对这一门课成立的做法与事实 |
MEMORY.yaml 长什么样:四个节,三个画像
共享记忆就是一份 YAML,按四个一级键分节(完整模板见 templates/MEMORY.yaml):
我是谁:
现有技能: []
各领域当前水平: []
教学偏好:
有效的讲法: []
容易烦躁的: []
例子偏好: []
学习习惯:
可投入时间: []
节奏: []
常见卡点: []
积累: {}
- 前三个节(我是谁/教学偏好/学习习惯)是"画像",描述你这个人,换任何科目都成立;
积累是角色的"干活笔记":一条 = 中文键 + 一句话(比如* 先动手再补理论),记的是踩过的坑、验过的工序;- 科目记忆只有一个
积累节,骨架来自 templates/subject-MEMORY.yaml,建科目时预置一份。
往哪份写只有一个判据:换一门课还成立 → 写共享记忆;不成立 → 写科目记忆。这条规则写在 preset/skills/record-keeping/SKILL.md 里,所有角色收尾时按它追加。
关键设计:只有"画像三节"能进 AI 上下文
文件里有四节,但真正会被注入上下文的只有前三节。积累 与整份科目记忆永不进注入——它们是给角色按需 grep 键去读的笔记,不是喂给模型的记忆。
这条边界不靠提示词约定,而是用一个纯函数模块统一定义一次(见 lib/core/memory.ts):
export const PROFILE_SECTIONS = ['我是谁', '教学偏好', '学习习惯'] as const;
三个"取内容"的消费点都走同一份投影,取哪几节是查表,不是猜:
| 消费点 | 源码位置 | 场景 |
|---|---|---|
| 答疑开张注入 | lib/ask/memory.ts | 阅读端问答面板独立调模型时带入 |
| 工作区摘要工具 | lib/tools/context.ts | 主教练开场只调一次 studymate_workspace_context |
| 图片库载荷 | lib/library.ts | 采图角色拿到的 memory_md |
💡 投影是原文照搬而不是重新序列化:你在文件里改了措辞,注入的就是你改的措辞——这份记忆永远是你亲手可以改的。
记忆在三个地方真正生效
1️⃣ 答疑面板:选中课文问"这里没懂"
阅读端里选中看不懂的文本,右栏问答面板就地回答。它独立调模型,不经过学习会话,上下文只带三样:当前课件、选中文本、共享记忆的画像三节(见 lib/ask/session.ts)。所以哪怕学习会话已经聊了几个小时,答疑依然轻量、依然"认识你"。
2️⃣ 开新课的盘问:记忆里有就不再问
开新科目时主教练会盘问五项(目的、程度、基础、项目、实验载体),但记忆里已经有的信息不会再问一遍(见 docs/使用/使用说明.md)。学微积分时记下的"每周 5 小时、喜欢先动手",到学 C++ 时直接复用。
3️⃣ 讲法偏好实时调整
说"太简单了"或"没听懂",系统换讲法(加边界反例,或降一层抽象),并把这条偏好直接追加进共享记忆——下次任何科目都生效。
谁来写、什么时候更新
- 任何角色收尾时直写:讲解、采图、评估……五个角色干完活,都把这一轮"值得留的做法与事实"按节末尾追加一行,不整文件覆盖、也不等你确认;
- 你本人也可以手改:它就是一份 YAML,一行一条;注意以
*、&、!开头的值要加引号,否则 YAML 会拒收,记忆当场打不开; - 读不到不是错误:新工作区还没有记忆文件时照常能学、能答,记忆是渐进长出来的。
背景小知识:这份文件最早叫 MEMORY.md,用 ## 标题分节,机器没法可靠地"按节取用"。改名 MEMORY.yaml 后,节名变成了一级键,取哪几节从"猜散文"变成了"查表"(见决策记录 docs/adr/0014-共享记忆改名MEMORY.yaml.md)。
快速上手:让记忆开始工作只需 3 步
1️⃣ 安装插件(以 DSH 为例):
dsh plugin --profile web add @yunmiao/studymate
2️⃣ 学习模式里说一句「我想学 [某科目]」,按主教练的盘问回答——这些信息会写进 MEMORY.yaml 的画像三节;
3️⃣ 再开新科目时说一句「我想学 [另一门]」——你会明显感觉到:它已经知道你是谁了。
想查看记忆全貌与文件归属,可对照 docs/规范/文件归属.md 和 docs/使用/使用说明.md §六"学习数据存在哪"。
小结
StudyMate 的 MEMORY.yaml 用一份小小的 YAML 文件解决了一个大问题:AI 的"记忆"从会话里搬到了你的文件里——画像三节进上下文,干活笔记按需去读,跨科目共享、科目内隔离。文件可手改、可备份、可随工作区复制到新机器,换科目从此不用重新自我介绍。



