换新科目不用重新自我介绍:StudyMate跨科目共享记忆MEMORY.yaml是怎么工作的

原创2026-10-19 16:45:301,874 阅读

换新科目不用重新自我介绍:StudyMate跨科目共享记忆MEMORY.yaml是怎么工作的

📌 换一门新科目,还要从"我会什么、学过哪些、喜欢怎么学"重新讲起吗?StudyMate 的跨科目共享记忆 MEMORY.yaml 会替你记住这些事——它把学习者的水平、讲法偏好与学习习惯存成一份 YAML 文件,每开一门新课时自动带入上下文,让你直接开讲、不用重新自我介绍。

为什么"换科目"总像在跟一个失忆的人聊天

直接跟 AI 聊天学习有个通病:会话一结束,上下文就清零;换个科目,等于面对一个全新的 AI,又要盘问一遍基础、目的、时间投入。

StudyMate 的思路是把"你是谁"从聊天记录里搬出来,落成工作区里的一份纯文本文件。它的位置固定在两个地方:

文件 位置 存什么
共享记忆 <工作区>/.learning/MEMORY.yaml 跨科目成立的画像与做法(默认工作区为 ~/StudyMate)
科目记忆 <工作区>/.learning/subjects/<slug>/MEMORY.yaml 只对这一门课成立的做法与事实

StudyMate学习会话示例:开课后AI直接按路线图推进,无需重复交代背景

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

💡 投影是原文照搬而不是重新序列化:你在文件里改了措辞,注入的就是你改的措辞——这份记忆永远是你亲手可以改的。

StudyMate系统架构:共享记忆MEMORY.yaml位于学习工作区,由Host半与Client半共同消费

记忆在三个地方真正生效

1️⃣ 答疑面板:选中课文问"这里没懂"

阅读端里选中看不懂的文本,右栏问答面板就地回答。它独立调模型,不经过学习会话,上下文只带三样:当前课件、选中文本、共享记忆的画像三节(见 lib/ask/session.ts)。所以哪怕学习会话已经聊了几个小时,答疑依然轻量、依然"认识你"。

StudyMate阅读端问答面板:选中课件内容就地答疑,上下文仅带课件、选中文本与共享记忆画像三节

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课程路线图主页:多科目并列展示,共享记忆让每门课独立推进又互不"失忆"

小结

StudyMate 的 MEMORY.yaml 用一份小小的 YAML 文件解决了一个大问题:AI 的"记忆"从会话里搬到了你的文件里——画像三节进上下文,干活笔记按需去读,跨科目共享、科目内隔离。文件可手改、可备份、可随工作区复制到新机器,换科目从此不用重新自我介绍。

登录后查看全文
Study-Mate