cotutor 0.2.0 → 0.4.0

package/dist/memory/context.js

@@ -0,0 +1,97 @@
+/**
+ * 上下文包里从 vault 来的那几段(从 runner.gatherContext 拆出来,2026-10-29,行为不变):
+ * 课程表命中的时段、当前学期、档案 / 孩子的记忆 / 入口文件 / 记忆的原文(按 entryChars 截;记忆留最近的)、参考路径、本周计划里本老师的行、
+ * 最近 14 天日记里本学科的「- 观察:」行(《obsidian仓库设计.md》§7)。都是现读的:家长改了这些文件,下一轮取材就是新的。
+ * 有脸的老师的守则(机器技能的原文)不在 vault 里,runner 自己加在这几条笔记前面。
+ */
+import { readFile } from 'node:fs/promises';
+import { join, relative, sep } from 'node:path';
+import { localDate } from "../shared/time.js";
+import { extractObservations, recentDiaryDates } from "./diary.js";
+import { isoWeek, parsePlan, planLinesFor } from "./plan.js";
+import { currentSlot, parseTimetable, slotLabel } from "./timetable.js";
+import { clipNote, missingEntry, pickNotes } from "./vault-notes.js";
+import { lookup } from "./retrieval.js";
+import { readDiaries, scanVault } from "./vault.js";
+const MANY = 100_000;
+/**
+ * 这一轮从 vault 取的材。agent = 记忆认谁的(activity 话题是 <老师>/<activity>,档案、入口文件、日记观察照旧共用);
+ * teacher = 这位是有脸的老师(没有入口文件时写「缺」;带孩子的记忆——它是有意的例外,activity 话题也带同一篇);display = 计划里认他的名字(不在 tutors 里就不带计划)
+ * query = 孩子这一轮说的话(加首页按钮的讲法):有脸的老师才拿它替老师查生字表、口径、以前讲过的骨架(retrieval.ts)
+ */
+export async function learningContext(v, o, report) {
+    const out = { notes: [], profile: '', memory: '', plan: [], recent: [], lookup: [], retrieved: [] };
+    if (report)
+        report.timetable = { file: v.paths.timetable, found: false, slot: null };
+    try {
+        const slot = currentSlot(parseTimetable(await readFile(v.paths.timetable, 'utf8')).entries, o.at);
+        if (report)
+            report.timetable.found = true;
+        if (slot)
+            out.slot = slotLabel(slot);
+        if (report)
+            report.timetable.slot = out.slot ?? null;
+    }
+    catch {
+        /* 没有课程表:不带 slot */
+    }
+    const { notes, files } = await scanVault(v);
+    const pick = pickNotes(notes, files, { date: localDate(o.at), subject: o.subject, agent: o.agent });
+    const limit = o.limits.entryChars;
+    if (pick.semester)
+        out.semester = pick.semester;
+    const labels = {};
+    for (const [role, n] of [['profile', pick.profile], ['child', o.teacher ? pick.child : null], ['entry', pick.entry], ['memory', pick.memory]]) {
+        if (!n)
+            continue;
+        const tail = role === 'memory' || role === 'child';
+        const clip = clipNote(n.text, limit, tail ? 'tail' : 'head');
+        labels[role] = clip.cut ? `${n.path}(原文 ${n.text.length} 字,${tail ? `只带最近 ${limit}` : `截到 ${limit}`})` : n.path;
+        out.notes.push({ role, path: n.path, text: clip.text, ...(clip.cut ? { cut: true } : {}) });
+    }
+    out.profile = labels.profile ?? '缺:vault 里没有 cotutor: profile 的档案';
+    if (o.teacher)
+        out.child = labels.child ?? '还没有';
+    const entry = labels.entry ?? (o.teacher ? missingEntry(o.subject, pick) : undefined);
+    if (entry !== undefined)
+        out.entry = entry;
+    out.memory = labels.memory ?? '还没有';
+    if (pick.refs.length)
+        out.refs = pick.refs.map((r) => join(v.paths.vault, r));
+    if (report)
+        report.vault = { root: v.paths.vault, semester: pick.semester, profile: pick.profile?.path ?? null, extraProfiles: pick.extraProfiles, entry: pick.entry?.path ?? null, extraEntries: pick.extraEntries, memory: pick.memory?.path ?? null, extraMemories: pick.extraMemories, subject: o.subject ?? null, refs: pick.refs, limit, chars: { profile: pick.profile?.text.length ?? 0, entry: pick.entry?.text.length ?? 0, memory: pick.memory?.text.length ?? 0 } };
+    const planFile = join(v.paths.plans, `${isoWeek(o.at)}.md`);
+    if (report)
+        report.plan = { file: planFile, found: false, total: 0, kept: 0, limit: o.limits.planLines };
+    try {
+        const { plan } = parsePlan(await readFile(planFile, 'utf8'));
+        if (report)
+            report.plan.found = true;
+        if (plan && o.display !== undefined) {
+            out.plan = planLinesFor(plan, o.display, o.limits.planLines);
+            if (report)
+                report.plan = { ...report.plan, total: planLinesFor(plan, o.display, MANY).length, kept: out.plan.length };
+        }
+    }
+    catch {
+        /* 没有本周计划,或读不到:上下文包不带 plan */
+    }
+    // 取材:孩子问到的字、提到的课(只读教材与最近 30 天日记,不调模型)
+    if (o.teacher && o.query?.trim() && pick.textbooks.length) {
+        const diaryRel = (date) => relative(v.paths.vault, join(v.paths.diary, `${date}.md`)).split(sep).join('/');
+        const old = (await readDiaries(v, recentDiaryDates(localDate(o.at), 30))).map((d) => ({ ...d, path: diaryRel(d.date) }));
+        const r = lookup({ query: o.query, textbooks: pick.textbooks, diaries: old });
+        out.lookup = r.lines;
+        out.retrieved = r.retrieved;
+        if (r.caliber) {
+            out.notes.push({ role: 'lesson', path: r.caliber.path, text: r.caliber.text });
+            out.lesson = `${r.caliber.path}(${r.caliber.text.split('\n')[0].replace(/^##\s+/, '')} 的口径)`;
+        }
+    }
+    const dates = recentDiaryDates(localDate(o.at), 14);
+    const diaries = await readDiaries(v, dates);
+    out.recent = extractObservations(diaries, { subject: o.subject, n: o.limits.recent });
+    if (report)
+        report.recent = { dir: v.paths.diary, days: dates.length, filesFound: diaries.map((d) => d.date).sort(), total: extractObservations(diaries, { subject: o.subject, n: MANY }).length, kept: out.recent.length, limit: o.limits.recent, subject: o.subject ?? null };
+    return out;
+}

package/dist/memory/diary.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 日记与档案的纯函数(《obsidian仓库设计.md》§3 / §6 / §7):vault 是长期记忆,机器只新建或追加,形状由这里保证。
+ *  - 记账:老师回「## 记账」段(sections.ts 解析),应用按话题渲染成日记里的一段 `## 学科 · 话题名`:
+ *    孩子问的话总是记(callout,一行一问;老师挑的 asked 核对过才用,没有就由 tidyQuestions 筛);摘要 + 星 + 教材单元链接 + 课包 id、`骨架:` 行只在话题打分 ≥ keepScore 时有;
+ *    `- 观察:` 行是上下文包「最近观察」的来源——家长在 Obsidian 里改一句、删一行,下次对话就变(观察的真相在日记,账本 jsonl 退役)。
+ *  - 抽取:`extractObservations` 从最近几天的日记抽「- 观察:」行(按 H2 的学科过滤)。
+ *  - 老师(LLM)不直接写 vault 文件;`bookkeepingPrompt` 是记账任务的消息正文,教材目录(册#节)列在里面让它原样挑。
+ */
+import type { Bookkeeping, BookkeepingEntry, ConversationMessage } from '../schema/index.ts';
+export interface DiaryTopic {
+    /** H2 的前半:学科(老师没配学科就用显示名) */
+    subject: string;
+    /** H2 的后半:话题名 */
+    name: string;
+    /** 孩子在这个话题里说的话,原话 */
+    questions: string[];
+    /** 家长打的星;没打 = undefined */
+    rating?: number;
+    /** 打分够时才有:摘要、骨架、教材单元(wikilink 目标「册#节」) */
+    summary?: string;
+    steps?: string;
+    textbook?: string;
+    /** 这个话题里做出来的课包 id */
+    bundles: string[];
+    observations: string[];
+}
+/** 孩子在这个话题里说的话:from: kid、不是「继续」/ 交答案这种动作、非空;多行并成一行 */
+export declare function kidQuestions(messages: readonly Pick<ConversationMessage, 'job' | 'from' | 'thread' | 'text' | 'action' | 'via'>[], thread: string): string[];
+/**
+ * 老师没挑「孩子问」(或挑的都对不上)时,从孩子的话里筛(2026-10-30):去掉标点、语气词与称呼后不到四个字的、和前面重复的不要,最多 max 句。
+ * 语音转写里「嗯,老师,呃」「语文老师。」这种碎句不进日记;孩子的原话全在 workspace 的录像里。
+ */
+export declare function tidyQuestions(said: readonly string[], max?: number): string[];
+/** 这个话题里做出来的课包(消息的 artifacts) */
+export declare function threadBundles(messages: readonly Pick<ConversationMessage, 'job' | 'from' | 'thread' | 'artifacts'>[], thread: string): string[];
+/** 把记账段的一条与索引里的话题拼成日记的素材;打分不够就丢掉摘要与骨架(老师多写了也不进)。questions = 调用方挑好的孩子问(缺省照抄孩子的话) */
+export declare function diaryTopic(index: {
+    messages: readonly Pick<ConversationMessage, 'job' | 'from' | 'thread' | 'text' | 'action' | 'artifacts'>[];
+    ratings: Record<string, number>;
+}, entry: BookkeepingEntry, opts: {
+    subject: string;
+    keepScore: number;
+    questions?: string[];
+}): DiaryTopic;
+/** 一个话题在日记里的一段;什么都没有(没问、没摘要、没观察)→ null,日记不出现它 */
+export declare function renderDiaryBlock(t: DiaryTopic): string | null;
+/** 从日记里摘掉一段(删话题时,2026-10-05):按记账时追加的原文找;家长改过那段就找不到,返回 null,不动 */
+export declare function removeDiaryBlock(existing: string, block: string): string | null;
+/** 追加到当天的日记:文件不在就是这一段;在就空一行接上(家长自己写的行永不动) */
+export declare function appendDiary(existing: string | null, block: string): string;
+/**
+ * 上下文包的 recent:最近几天日记里的「- 观察:」行,按日期升序取最后 n 条。
+ * 段的 H2 是「学科 · 名」时按学科过滤(subject 没配 → 全量);不在任何 H2 下的(家长写在文件头的)总是算。
+ */
+export declare function extractObservations(diaries: readonly {
+    date: string;
+    text: string;
+}[], opts: {
+    subject?: string;
+    n: number;
+}): {
+    date: string;
+    claim: string;
+}[];
+/** 教材目录的可引用条目:每册文件的每个 H2 → 「册#节标题」(wikilink 的目标;文件名不带 .md) */
+export declare function textbookHeadings(files: readonly {
+    name: string;
+    text: string;
+}[]): string[];
+/** 日记里最近 days 天的文件名(含今天) */
+export declare function recentDiaryDates(today: string, days: number): string[];
+/**
+ * 记账任务的消息正文(上下文包由 runner 照常拼在前面;这轮 resume 那个话题的会话,老师记得聊了什么)。
+ * 打分够:要 name / textbook / asked / summary / steps / observations;不够或没打:只要 name / textbook / asked / observations。
+ */
+export declare function bookkeepingPrompt(opts: {
+    thread: string;
+    rating?: number;
+    keepScore: number;
+    headings: string[]; /** 这个话题里孩子拍了几张作业照片(R5):有就让摘要把图上的东西写成文字 */
+    photos?: number;
+}): string;
+/** 记账段里对上这个话题的那条(老师只该回一条;thread 写错了但只有一条也认) */
+export declare function entryFor(b: Bookkeeping, thread: string): BookkeepingEntry | null;

package/dist/memory/diary.js

@@ -0,0 +1,183 @@
+import { threads, viaSendsLabel } from "../schema/index.js";
+/** 孩子在这个话题里说的话:from: kid、不是「继续」/ 交答案这种动作、非空;多行并成一行 */
+export function kidQuestions(messages, thread) {
+    const ths = threads(messages);
+    const out = [];
+    messages.forEach((m, i) => {
+        // 首页的开场 / 接着按钮、方砖发的是按钮上的字,不是孩子说的
+        if (ths[i] !== thread || m.from !== 'kid' || m.action || (m.via && viaSendsLabel(m.via)))
+            return;
+        const text = m.text.replace(/\s+/g, ' ').trim();
+        if (text && text !== '继续')
+            out.push(text);
+    });
+    return out;
+}
+/** 语气词与称呼:转写里只剩这些的不算孩子问的 */
+const FILLER = /[嗯呃啊哦噢喔唉哎诶欸额呀吧呢嘛哈]|(?:语文|数学|英语)?老师/g;
+/**
+ * 老师没挑「孩子问」(或挑的都对不上)时,从孩子的话里筛(2026-10-30):去掉标点、语气词与称呼后不到四个字的、和前面重复的不要,最多 max 句。
+ * 语音转写里「嗯,老师,呃」「语文老师。」这种碎句不进日记;孩子的原话全在 workspace 的录像里。
+ */
+export function tidyQuestions(said, max = 5) {
+    const seen = new Set();
+    const out = [];
+    for (const s of said) {
+        const core = s.toLowerCase().replace(/[\s\p{P}\p{S}]/gu, '').replace(FILLER, '');
+        if (Array.from(core).length < 4 || seen.has(core))
+            continue;
+        seen.add(core);
+        out.push(s);
+        if (out.length >= max)
+            break;
+    }
+    return out;
+}
+/** 这个话题里做出来的课包(消息的 artifacts) */
+export function threadBundles(messages, thread) {
+    const ths = threads(messages);
+    const out = new Set();
+    messages.forEach((m, i) => {
+        if (ths[i] === thread)
+            for (const a of m.artifacts)
+                out.add(a);
+    });
+    return [...out];
+}
+/** 把记账段的一条与索引里的话题拼成日记的素材;打分不够就丢掉摘要与骨架(老师多写了也不进)。questions = 调用方挑好的孩子问(缺省照抄孩子的话) */
+export function diaryTopic(index, entry, opts) {
+    const rating = index.ratings[entry.thread];
+    const keep = rating !== undefined && rating >= opts.keepScore;
+    return {
+        subject: opts.subject,
+        name: entry.name.trim(),
+        questions: opts.questions ?? kidQuestions(index.messages, entry.thread),
+        rating,
+        ...(keep && entry.summary ? { summary: entry.summary.trim() } : {}),
+        ...(keep && entry.steps ? { steps: entry.steps.trim() } : {}),
+        ...(keep && entry.textbook ? { textbook: entry.textbook.trim().replace(/^\[\[|\]\]$/g, '') } : {}),
+        bundles: keep ? threadBundles(index.messages, entry.thread) : [],
+        observations: entry.observations.map((o) => o.trim()).filter(Boolean),
+    };
+}
+const stars = (n) => (n ? '★'.repeat(n) : '');
+/** 一个话题在日记里的一段;什么都没有(没问、没摘要、没观察)→ null,日记不出现它 */
+export function renderDiaryBlock(t) {
+    const lines = [`## ${t.subject} · ${t.name}`];
+    if (t.questions.length) {
+        lines.push('', '> [!question] 孩子问', ...t.questions.map((q) => `> ${q}`));
+    }
+    if (t.summary) {
+        const tail = [stars(t.rating), t.textbook ? `→ [[${t.textbook}]]` : '', t.bundles.length ? `课包 ${t.bundles.join('、')}` : ''].filter(Boolean).join(' ');
+        lines.push('', `${t.summary}${tail ? ` ${tail}` : ''}`);
+        if (t.steps)
+            lines.push(`骨架:${t.steps}`);
+    }
+    if (t.observations.length)
+        lines.push('', ...t.observations.map((o) => `- 观察:${o}`));
+    if (lines.length === 1)
+        return null;
+    return `${lines.join('\n')}\n`;
+}
+/** 从日记里摘掉一段(删话题时,2026-10-05):按记账时追加的原文找;家长改过那段就找不到,返回 null,不动 */
+export function removeDiaryBlock(existing, block) {
+    const want = block.trim();
+    const i = existing.indexOf(want);
+    if (!want || i < 0)
+        return null;
+    const out = `${existing.slice(0, i).replace(/\s+$/, '')}\n\n${existing.slice(i + want.length).replace(/^\s+/, '')}`.trim();
+    return out ? `${out}\n` : '';
+}
+/** 追加到当天的日记:文件不在就是这一段;在就空一行接上(家长自己写的行永不动) */
+export function appendDiary(existing, block) {
+    if (!existing || !existing.trim())
+        return block;
+    return `${existing.replace(/\s+$/, '')}\n\n${block}`;
+}
+const H2 = /^##\s+(.+?)\s*$/;
+const OBS = /^-\s*观察[:：]\s*(.+?)\s*$/;
+/**
+ * 上下文包的 recent:最近几天日记里的「- 观察:」行,按日期升序取最后 n 条。
+ * 段的 H2 是「学科 · 名」时按学科过滤(subject 没配 → 全量);不在任何 H2 下的(家长写在文件头的)总是算。
+ */
+export function extractObservations(diaries, opts) {
+    const out = [];
+    for (const d of [...diaries].sort((a, b) => (a.date < b.date ? -1 : a.date > b.date ? 1 : 0))) {
+        let subject = null;
+        let fence = false;
+        for (const line of d.text.split('\n')) {
+            if (/^\s*```/.test(line))
+                fence = !fence;
+            if (fence)
+                continue;
+            const h = H2.exec(line);
+            if (h) {
+                subject = h[1].split(/\s+·\s+/)[0].trim();
+                continue;
+            }
+            const m = OBS.exec(line);
+            if (!m)
+                continue;
+            if (opts.subject && subject !== null && subject !== opts.subject)
+                continue;
+            out.push({ date: d.date, claim: m[1] });
+        }
+    }
+    return out.slice(-opts.n);
+}
+/** 教材目录的可引用条目:每册文件的每个 H2 → 「册#节标题」(wikilink 的目标;文件名不带 .md) */
+export function textbookHeadings(files) {
+    const out = [];
+    for (const f of files) {
+        const book = f.name.replace(/\.md$/, '');
+        let fence = false;
+        for (const line of f.text.split('\n')) {
+            if (/^\s*```/.test(line))
+                fence = !fence;
+            if (fence)
+                continue;
+            const h = H2.exec(line);
+            if (h)
+                out.push(`${book}#${h[1]}`);
+        }
+    }
+    return out;
+}
+/** 日记里最近 days 天的文件名(含今天) */
+export function recentDiaryDates(today, days) {
+    const [y, m, d] = today.split('-').map(Number);
+    const out = [];
+    for (let i = 0; i < days; i++) {
+        const t = new Date(y, m - 1, d - i);
+        out.push(`${t.getFullYear()}-${String(t.getMonth() + 1).padStart(2, '0')}-${String(t.getDate()).padStart(2, '0')}`);
+    }
+    return out;
+}
+/**
+ * 记账任务的消息正文(上下文包由 runner 照常拼在前面;这轮 resume 那个话题的会话,老师记得聊了什么)。
+ * 打分够:要 name / textbook / asked / summary / steps / observations;不够或没打:只要 name / textbook / asked / observations。
+ */
+export function bookkeepingPrompt(opts) {
+    const keep = opts.rating !== undefined && opts.rating >= opts.keepScore;
+    const graded = opts.rating === undefined ? '家长还没打分' : `家长打了 ${opts.rating} 星${keep ? '' : `(不到 ${opts.keepScore} 星,摘要不进日记)`}`;
+    const lines = [
+        `学习结束,给刚才这个话题记账(话题 ${opts.thread},${graded})。只回一段「## 记账」,别的一个字都不用写,不用工具:`,
+        '',
+        '## 记账',
+        `- thread: ${opts.thread}`,
+        '  name: 这个话题叫什么(不超过 12 字,像日记里的小标题)',
+        opts.headings.length ? '  textbook: 属于哪册哪节——从下面的教材目录里挑一条原样抄;都不是就不写这行' : '  textbook: 属于哪册哪节,写成「册#节」;认不出就不写这行',
+        '  asked:',
+        '    - 孩子在这个话题里问的、说的,挑 1–3 句以后还值得看的,照他的原话抄,可以只抄其中一截(语音转写有错字也照抄;没有就不写 asked)',
+        ...(keep ? [`  summary: 一到三句,讲了什么、难点在哪、孩子哪里卡住${opts.photos ? ';这个话题里有 ' + opts.photos + ' 张作业照片,把你认出的册子 / 页 / 题号 / 题面写成文字(日记不存图、不写照片路径)' : ''}`, '  steps: 讲解的骨架,一行,步骤用 → 连'] : []),
+        '  observations:',
+        '    - 关于孩子、值得别的老师下次知道的一句话(0–3 条;没有就不写 observations)',
+    ];
+    if (opts.headings.length)
+        lines.push('', '教材目录:', ...opts.headings.map((h) => `- ${h}`));
+    return lines.join('\n');
+}
+/** 记账段里对上这个话题的那条(老师只该回一条;thread 写错了但只有一条也认) */
+export function entryFor(b, thread) {
+    return b.entries.find((e) => e.thread === thread) ?? (b.entries.length === 1 ? { ...b.entries[0], thread } : null);
+}

package/dist/memory/grade.d.ts

@@ -0,0 +1,2 @@
+/** 当前学期仍由档案推算。此函数仅用于 doctor 比对,不选择/切换文件。 */
+export declare function gradeOfSemester(semester: string | null): number | null;

package/dist/memory/grade.js

@@ -0,0 +1,7 @@
+/** 当前学期仍由档案推算。此函数仅用于 doctor 比对,不选择/切换文件。 */
+export function gradeOfSemester(semester) {
+    const match = /^([一二三四五六]|[1-6])年级/.exec(semester ?? '');
+    if (!match)
+        return null;
+    return /^[1-6]$/.test(match[1]) ? Number(match[1]) : '一二三四五六'.indexOf(match[1]) + 1;
+}

package/dist/{lib → memory}/plan.d.ts

@@ -1,5 +1,5 @@
 /**
- * 计划文件解析(《cotutor契约草案.md》§8),与课程表解析同法:纯函数,错误即修复指南带行号。
+ * 计划文件解析,与课程表解析同法:纯函数,错误即修复指南带行号。
  * frontmatter 要有 week(2026-W37)与 status(draft | confirmed);正文按老师显示名分 H2。
  */
 import { type Plan } from '../schema/index.ts';

package/dist/{lib → memory}/plan.js

@@ -1,5 +1,5 @@
 /**
- * 计划文件解析(《cotutor契约草案.md》§8),与课程表解析同法:纯函数,错误即修复指南带行号。
+ * 计划文件解析,与课程表解析同法:纯函数,错误即修复指南带行号。
  * frontmatter 要有 week(2026-W37)与 status(draft | confirmed);正文按老师显示名分 H2。
  */
 import { PLAN_STATUS, WEEK_RE } from "../schema/index.js";

package/dist/memory/proposals.d.ts

@@ -0,0 +1,11 @@
+import { type ConversationMessage, type EvidenceCheck, type MemoryProposal } from '../schema/index.ts';
+/** 拆一条:证据拿出来(vault 里不写),末尾多出来的逗号分号去掉;`孩子:` 前缀留在 item 里 */
+export declare function parseProposal(raw: string): Omit<MemoryProposal, 'check'>;
+/** 进孩子的记忆时去掉 `孩子:` 前缀(那篇里不用标) */
+export declare function childItem(item: string): string;
+/** 孩子说过的话:这个话题里的;thread = null(整理记忆那轮自成话题,里面没有孩子的话)→ 这一天所有话题的 */
+export declare function kidSaid(messages: readonly Pick<ConversationMessage, 'job' | 'from' | 'thread' | 'text' | 'action' | 'via'>[], thread: string | null): string[];
+/** 证据对不对得上:没写(或去掉标点后不到两个字,太短分不出)→ unverified;孩子哪句话里有它 → verified;都没有 → rejected */
+export declare function checkEvidence(quote: string | undefined, said: readonly string[]): EvidenceCheck;
+/** 「## 记忆」段的几条 → 建议,各自带证据对没对上 */
+export declare function proposalsOf(items: readonly string[], said: readonly string[]): MemoryProposal[];

package/dist/memory/proposals.js

@@ -0,0 +1,43 @@
+/**
+ * 「## 记忆」段的一条 → 建议(schema/memory.ts,《vault重构方案》§3,2026-10-30):拆出行首 `孩子:` 与行末 `证据:「…」`,
+ * 再拿证据对孩子说过的话。只认孩子发来的消息(diary.ts 的 kidQuestions:from: kid、不是首页按钮上的字、不是交卡的动作);
+ * 老师自己讲的、应用派的任务都不算——生成了五道题不等于孩子做完了五道题。
+ */
+import { kidQuestions } from "./diary.js";
+import { threads } from "../schema/index.js";
+const CHILD = /^孩子\s*[:：]/;
+const EVIDENCE = /\s*证据\s*[:：]\s*(?:「([^」]*)」|“([^”]*)”|"([^"]*)")\s*$/;
+/** 拆一条:证据拿出来(vault 里不写),末尾多出来的逗号分号去掉;`孩子:` 前缀留在 item 里 */
+export function parseProposal(raw) {
+    const s = raw.replace(/\s+/g, ' ').trim();
+    const m = EVIDENCE.exec(s);
+    const item = m ? s.slice(0, m.index).replace(/[\s,,;;、]+$/, '') : s;
+    const quote = m ? (m[1] ?? m[2] ?? m[3]).trim() : '';
+    return { item, target: CHILD.test(item) ? 'child' : 'tutor', ...(quote ? { quote } : {}) };
+}
+/** 进孩子的记忆时去掉 `孩子:` 前缀(那篇里不用标) */
+export function childItem(item) {
+    return item.replace(/^孩子\s*[:：]\s*/, '');
+}
+/** 比对用:去掉空白、标点、符号,英文不分大小写(孩子的话是语音转写,标点靠不住) */
+const norm = (s) => s.toLowerCase().replace(/[\s\p{P}\p{S}]/gu, '');
+/** 孩子说过的话:这个话题里的;thread = null(整理记忆那轮自成话题,里面没有孩子的话)→ 这一天所有话题的 */
+export function kidSaid(messages, thread) {
+    if (thread !== null)
+        return kidQuestions(messages, thread);
+    return [...new Set(threads(messages))].flatMap((th) => kidQuestions(messages, th));
+}
+/** 证据对不对得上:没写(或去掉标点后不到两个字,太短分不出)→ unverified;孩子哪句话里有它 → verified;都没有 → rejected */
+export function checkEvidence(quote, said) {
+    const q = norm(quote ?? '');
+    if (Array.from(q).length < 2)
+        return 'unverified';
+    return said.some((s) => norm(s).includes(q)) ? 'verified' : 'rejected';
+}
+/** 「## 记忆」段的几条 → 建议,各自带证据对没对上 */
+export function proposalsOf(items, said) {
+    return items.map((raw) => {
+        const p = parseProposal(raw);
+        return { ...p, check: checkEvidence(p.quote, said) };
+    });
+}

package/dist/memory/retrieval.d.ts

@@ -0,0 +1,44 @@
+export interface Lesson {
+    /** 册名(教材文件名去掉 .md,wikilink 的前半) */
+    book: string;
+    /** H2 原文,如「课文 2 我是什么」 */
+    title: string;
+    recognize: string[];
+    write: string[];
+    /** `### 口径` 下面的原文;没有 = null */
+    caliber: string | null;
+}
+export interface Retrieved {
+    /** 相对 vault 根 */
+    path: string;
+    hash: string;
+    why: string;
+}
+/** 孩子这句话里问到的字(去重,按出现先后,最多 6 个);没在问字 → [] */
+export declare function askedChars(text: string): string[];
+/** 读一册教材:每个 H2 一课;围栏里的不算 */
+export declare function parseTextbook(book: string, text: string): Lesson[];
+/**
+ * 这一轮替老师查的:query = 孩子这句话(加首页按钮的讲法);textbooks = 这科这学期的教材(cotutor: textbook);diaries = 最近的日记。
+ * lines 进上下文包的 lookup;caliber 是要带原文的口径(没有 = null);retrieved 记来源。什么都没查到 → 全空
+ */
+export declare function lookup(o: {
+    query: string;
+    textbooks: readonly {
+        path: string;
+        text: string;
+    }[];
+    diaries: readonly {
+        path: string;
+        date: string;
+        text: string;
+    }[];
+    maxCaliber?: number;
+}): {
+    lines: string[];
+    caliber: {
+        path: string;
+        text: string;
+    } | null;
+    retrieved: Retrieved[];
+};

package/dist/memory/retrieval.js

@@ -0,0 +1,157 @@
+/**
+ * 取材(《vault重构方案》§6,2026-10-30):孩子的话缺省不带工具,讲之前该查的由应用替老师查好,放进上下文包的 lookup 与 <vault-note role="lesson">。
+ * 只读、确定性,只做关键词与标题匹配(不做向量检索,vault 是唯一的真相):
+ *  - 生字表:孩子问到的字(「X字怎么写」「X怎么读」「“X”」这几种说法)落在这科这学期教材哪一课的 识字: / 写字: 行,或都没有
+ *  - 那一课的口径:孩子提到的课(课题、第 N 课),或问到的字要会写的那一课;家长在那一节下写了 `### 口径` 就带原文
+ *  - 以前讲过:最近日记里链到那一课(`[[册#节]]`)的段,最新一条的 `骨架:` 行
+ * 每一样都记来源路径、hash 与为什么查它(retrieved),进这一轮的运行记录(《vault重构方案》§7)。
+ * 教材的形状见《obsidian仓库设计.md》§3.3:一课一个 H2,节下 `识字:` `写字:` 行(字用空格隔开),`### 口径` 是家长写的讲法。
+ */
+import { textHash } from "./vault-notes.js";
+const HAN = '\\p{Script=Han}';
+/** 孩子问字的几种说法;抓到的是要查的字词 */
+const ASKS = [
+    new RegExp(`(${HAN}{1,2}?)(?:这个字|字)?怎么(?:写|读|念|拼|组词)`, 'gu'),
+    new RegExp(`(${HAN})字(?=的|是|不|能|要|有|怎|呢)`, 'gu'),
+    new RegExp(`[「“"](${HAN}{1,4})[」”"]`, 'gu'),
+];
+/** 抓到了也不是在问字的 */
+const NOT_WORDS = new Set(['拼音', '作文', '句子', '题目', '这题', '这道', '这个', '那个', '怎么', '这样', '那样']);
+/** 孩子这句话里问到的字(去重,按出现先后,最多 6 个);没在问字 → [] */
+export function askedChars(text) {
+    const out = [];
+    for (const re of ASKS) {
+        for (const m of text.matchAll(re)) {
+            if (NOT_WORDS.has(m[1]))
+                continue;
+            for (const c of Array.from(m[1]))
+                if (c !== '字' && !out.includes(c))
+                    out.push(c);
+        }
+    }
+    return out.slice(0, 6);
+}
+/** 读一册教材:每个 H2 一课;围栏里的不算 */
+export function parseTextbook(book, text) {
+    const out = [];
+    let cur = null;
+    let inCaliber = false;
+    let fence = false;
+    const caliber = [];
+    const close = () => {
+        if (cur)
+            cur.caliber = caliber.join('\n').trim() || null;
+        caliber.length = 0;
+        inCaliber = false;
+    };
+    for (const line of text.split('\n')) {
+        if (/^\s*```/.test(line))
+            fence = !fence;
+        if (fence) {
+            if (inCaliber)
+                caliber.push(line);
+            continue;
+        }
+        const h2 = /^##\s+(.+?)\s*$/.exec(line);
+        if (h2) {
+            close();
+            cur = { book, title: h2[1], recognize: [], write: [], caliber: null };
+            out.push(cur);
+            continue;
+        }
+        if (!cur)
+            continue;
+        if (/^#{1,3}\s/.test(line)) {
+            inCaliber = /^###\s+口径\s*$/.test(line);
+            continue;
+        }
+        if (inCaliber) {
+            caliber.push(line);
+            continue;
+        }
+        const row = /^(识字|写字)[:：]\s*(.*)$/.exec(line);
+        if (row)
+            (row[1] === '识字' ? cur.recognize : cur.write).push(...row[2].split(/\s+/).filter(Boolean));
+    }
+    close();
+    return out;
+}
+/** 课题去掉「课文 2」「识字 1」这种编号后的那截(「我是什么」) */
+const titleCore = (title) => title.replace(/^(课文|识字|语文园地|口语交际|快乐读书吧)\s*[0-9一二三四五六七八九十]*\s*/, '').trim();
+/** 孩子这句话提到的课:课题(去掉编号后至少两个字)出现在话里,或「课文 N」「第 N 课」 */
+function mentioned(lessons, text) {
+    const n = /(?:课文|第)\s*([0-9]{1,2})\s*课?/.exec(text)?.[1];
+    return lessons.filter((l) => {
+        const core = titleCore(l.title);
+        return (Array.from(core).length >= 2 && text.includes(core)) || (n !== undefined && new RegExp(`^课文\\s*${n}(?!\\d)`).test(l.title));
+    });
+}
+/** 一个字落在哪几课、会认还是会写:「海」:课文 2 我是什么 会写 */
+function charLine(c, lessons, books) {
+    const hits = lessons.flatMap((l) => {
+        const kinds = [l.recognize.includes(c) ? '会认' : '', l.write.includes(c) ? '会写' : ''].filter(Boolean);
+        return kinds.length ? [`${l.title} ${kinds.join('、')}`] : [];
+    });
+    return hits.length ? `「${c}」:${hits.join(';')}` : `「${c}」:不在这学期的识字、写字表里(${books})`;
+}
+/** 日记里链到这一课的段,最新那条的 `骨架:` 行(日期新的在前找) */
+function lastSteps(lesson, diaries) {
+    const link = `[[${lesson.book}#${lesson.title}]]`;
+    for (const d of [...diaries].sort((a, b) => (a.date < b.date ? 1 : -1))) {
+        for (const block of d.text.split(/^(?=## )/m).reverse()) {
+            if (!block.includes(link))
+                continue;
+            const steps = /^骨架[:：]\s*(.+)$/m.exec(block)?.[1];
+            if (steps)
+                return { line: `以前讲过「${lesson.title}」(${d.date}):骨架:${steps}`, from: d };
+        }
+    }
+    return null;
+}
+/**
+ * 这一轮替老师查的:query = 孩子这句话(加首页按钮的讲法);textbooks = 这科这学期的教材(cotutor: textbook);diaries = 最近的日记。
+ * lines 进上下文包的 lookup;caliber 是要带原文的口径(没有 = null);retrieved 记来源。什么都没查到 → 全空
+ */
+export function lookup(o) {
+    const books = o.textbooks.map((t) => ({ ...t, book: t.path.replace(/^.*\//, '').replace(/\.md$/, ''), lessons: parseTextbook(t.path.replace(/^.*\//, '').replace(/\.md$/, ''), t.text) }));
+    const lessons = books.flatMap((b) => b.lessons);
+    const lines = [];
+    const retrieved = [];
+    const used = (path, text, why) => {
+        const hit = retrieved.find((r) => r.path === path);
+        if (hit) {
+            if (!hit.why.includes(why))
+                hit.why += `;${why}`;
+        }
+        else
+            retrieved.push({ path, hash: textHash(text), why });
+    };
+    // 生字表:教材里有识字、写字行才查(数学的教材没有,别报一串「没有」)
+    const chars = lessons.some((l) => l.recognize.length || l.write.length) ? askedChars(o.query) : [];
+    for (const c of chars)
+        lines.push(charLine(c, lessons, books.map((b) => b.book).join('、')));
+    for (const b of books)
+        if (chars.length && b.lessons.some((l) => l.recognize.length || l.write.length))
+            used(b.path, b.text, `问到的字:${chars.join('、')}`);
+    // 那一课:提到的课,加问到的字要会写的那一课;最多两课
+    const hit = [...new Set([...mentioned(lessons, o.query), ...lessons.filter((l) => chars.some((c) => l.write.includes(c)))])].slice(0, 2);
+    const calibers = hit.filter((l) => l.caliber);
+    for (const l of hit) {
+        const b = books.find((x) => x.lessons.includes(l));
+        if (l.caliber)
+            used(b.path, b.text, `口径:${l.title}`);
+        const s = lastSteps(l, o.diaries);
+        if (s) {
+            lines.push(s.line);
+            used(s.from.path, s.from.text, `以前讲过:${l.title}`);
+        }
+    }
+    const max = o.maxCaliber ?? 1200;
+    const caliberText = calibers.map((l) => `## ${l.title}\n### 口径\n${l.caliber}`).join('\n\n');
+    const caliberPath = calibers.length ? books.find((x) => x.lessons.includes(calibers[0])).path : null;
+    return {
+        lines,
+        caliber: caliberPath ? { path: caliberPath, text: caliberText.length > max ? `${caliberText.slice(0, max)}\n……(后面截掉了)` : caliberText } : null,
+        retrieved,
+    };
+}