cotutor 0.2.0 → 0.4.0

package/dist/runtime/home/edit.js

@@ -0,0 +1,132 @@
+const OPEN = /^(`{3,})\s*(\S.*)?$/;
+export function splitHomeMd(md) {
+    const lines = md.replace(/\r\n/g, '\n').split('\n');
+    let i = 0;
+    const front = [];
+    if (lines[0]?.trim() === '---') {
+        const end = lines.findIndex((l, k) => k > 0 && l.trim() === '---');
+        if (end > 0) {
+            front.push(...lines.slice(0, end + 1));
+            i = end + 1;
+        }
+    }
+    const segs = [];
+    const text = (l) => { const last = segs[segs.length - 1]; if (last?.kind === 'text')
+        last.lines.push(l);
+    else
+        segs.push({ kind: 'text', lines: [l] }); };
+    for (; i < lines.length; i++) {
+        const l = lines[i];
+        if (/^##\s/.test(l))
+            return { front, segs, note: lines.slice(i) };
+        const m = OPEN.exec(l);
+        if (!m || !m[2]) {
+            text(l);
+            continue;
+        }
+        const close = new RegExp(`^${m[1]}\`*\\s*$`);
+        const end = lines.findIndex((x, k) => k > i && close.test(x));
+        if (end < 0) {
+            text(l);
+            continue;
+        } // 没收口的围栏照字留着,检查会说
+        const info = m[2].trim();
+        const [card, ...rest] = info.split(/\s+/);
+        segs.push({ kind: 'fence', fence: m[1], card, mods: rest.filter((x) => !x.includes('=')), info, body: lines.slice(i + 1, end) });
+        i = end;
+    }
+    return { front, segs, note: [] };
+}
+export function joinHomeMd(p) {
+    const out = [...p.front];
+    for (const s of p.segs) {
+        if (s.kind === 'text')
+            out.push(...s.lines);
+        else
+            out.push(`${s.fence}${s.info}`, ...s.body, s.fence);
+    }
+    // 卡与卡之间空一行,家长段前也空一行
+    const body = out.join('\n').replace(/\n{3,}/g, '\n\n').replace(/\s+$/, '');
+    const note = p.note.join('\n').replace(/^\n+/, '').replace(/\s+$/, '');
+    return `${body}${note ? `\n\n${note}` : ''}\n`;
+}
+const isTutor = (s, name) => s.kind === 'fence' && s.card === 'tutor' && (name === undefined || s.mods[0] === name);
+const fence = (card, mods, body) => ({ kind: 'fence', fence: '```', card, mods, info: [card, ...mods].join(' '), body });
+const blank = () => ({ kind: 'text', lines: [''] });
+/** 老师卡的正文:一行一个按钮,讲法与留到挂在下面 */
+export function tutorBody(buttons) {
+    const out = [];
+    for (const b of buttons) {
+        out.push(b.kind === 'continue' ? `接着 ${b.date} ${b.thread} ${b.label}` : b.kind === 'lecture' ? `小课堂 ${b.bundle} ${b.label}` : b.kind === 'activity' ? `activity ${b.activity}${b.label === b.activity ? '' : ` ${b.label}`}` : b.label);
+        if (b.kind === 'activity')
+            for (const [k, v] of Object.entries(b.params))
+                out.push(`${k}: ${v}`);
+        if (b.kind === 'lecture' && b.activity)
+            out.push(`activity: ${b.activity}`);
+        if (b.brief)
+            for (const l of b.brief.split('\n'))
+                out.push(`讲法: ${l}`);
+        if (b.until)
+            out.push(`留到: ${b.until}`);
+    }
+    return out;
+}
+/** 分组:第一张老师卡前面的(公共)+ 每张老师卡连同跟在后面、到下一张老师卡之前的块 */
+function groups(p) {
+    const head = [];
+    const out = [];
+    for (const s of p.segs) {
+        if (isTutor(s))
+            out.push({ name: s.mods[0] ?? '', segs: [s] });
+        else if (out.length)
+            out[out.length - 1].segs.push(s);
+        else
+            head.push(s);
+    }
+    return { head, groups: out };
+}
+/** 这位老师的老师卡;没有就在最后一位老师的那组后面加一张空的 */
+function ensureTutor(p, name) {
+    const found = p.segs.find((s) => isTutor(s, name));
+    if (found && isTutor(found))
+        return found;
+    const card = fence('tutor', [name], []);
+    p.segs.push(blank(), card);
+    return card;
+}
+/** 换掉这位老师的按钮(整张卡的正文);没有老师卡就加一张 */
+export function setTutorButtons(md, name, buttons) {
+    const p = splitHomeMd(md);
+    ensureTutor(p, name).body = tutorBody(buttons);
+    return joinHomeMd(p);
+}
+/** 这位老师的听写卡(`dictation <老师>`):words 空 = 删掉;没有就紧跟在他的老师卡后面加一张 */
+export function setTutorDictation(md, name, words) {
+    const p = splitHomeMd(md);
+    // 英文单词配的 emoji 写在最前面(同单词卡的「🍎 apple」,cards/dictation)
+    const body = words.map((w) => [w.emoji, w.chars, w.say].filter(Boolean).join(' '));
+    const at = p.segs.findIndex((s) => s.kind === 'fence' && s.card === 'dictation' && s.mods[0] === name);
+    if (at >= 0) {
+        if (body.length)
+            p.segs[at].body = body;
+        else
+            p.segs.splice(at, 1);
+        return joinHomeMd(p);
+    }
+    if (!body.length)
+        return md;
+    const card = ensureTutor(p, name);
+    p.segs.splice(p.segs.indexOf(card) + 1, 0, blank(), fence('dictation', [name], body));
+    return joinHomeMd(p);
+}
+/** 调老师的先后:names 里的按这个顺序排(没有老师卡的补一张空的),别的老师照原来的相对顺序排在后面;每位老师带着跟在他后面的卡一起挪 */
+export function orderTutors(md, names) {
+    const p = splitHomeMd(md);
+    for (const n of names)
+        ensureTutor(p, n);
+    const g = groups(p);
+    const rank = (n) => { const k = names.indexOf(n); return k < 0 ? names.length + g.groups.findIndex((x) => x.name === n) : k; };
+    const sorted = [...g.groups].sort((a, b) => rank(a.name) - rank(b.name));
+    p.segs = [...g.head, ...sorted.flatMap((x) => (x.segs[x.segs.length - 1]?.kind === 'text' ? x.segs : [...x.segs, blank()]))];
+    return joinHomeMd(p);
+}

package/dist/runtime/home/home.d.ts

@@ -0,0 +1,191 @@
+/**
+ * 首页文件的纯函数:解析草稿、查问题(两级)、排卡(老师卡置顶、缺的补)、孩子端按钮。
+ * 解析走板书同一个解析器(place = home);永不抛错,问题都带行号(1 起)与修法。要读盘的引用(话题在不在)由调用方查好传进来。
+ */
+import type { TutorButton } from '../../board/cards/index.ts';
+import { type Activity, type HomeTileId } from '../../schema/index.ts';
+import type { BoardCard } from '../../board/presentation.ts';
+export type HomeIssueLevel = 'fix' | 'note';
+export interface HomeIssue {
+    /** fix = 要改(publish 拒绝);note = 提醒(照发) */
+    level: HomeIssueLevel;
+    text: string;
+    /** 原文行号,1 起 */
+    line?: number;
+    /** 出在第几张卡(0 起,文件顺序);--force 发布时丢掉这张 */
+    card?: number;
+    /** 出在这张老师卡的第几个按钮;--force 发布时只丢这个按钮 */
+    button?: number;
+}
+export interface HomeDoc {
+    for?: string;
+    /** 文件顺序 */
+    cards: BoardCard[];
+    /** 每张卡的开头行(1 起),与 cards 同序 */
+    cardLines: number[];
+    /** 第一个 H2 起的家长段 */
+    note: string;
+    /** 解析时就能看出来的问题(引用类的在 homeIssues) */
+    issues: HomeIssue[];
+}
+export declare function parseHome(md: string): HomeDoc;
+/** 一位老师在 cotutor.json 里的样子(查老师卡用) */
+export interface HomeTutorInfo {
+    display: string;
+    enabled: boolean;
+    hidden: boolean;
+    /** cotutor.json 的 subject(对小课堂课包的科目用);没配 = 不查 */
+    subject?: string;
+}
+export interface HomeCheckContext {
+    tutors: Record<string, HomeTutorInfo>;
+    /** 查得到的话题:`<老师> <日期> <话题>` */
+    threads: ReadonlySet<string>;
+    /** 小课堂按钮引用的课包或视频:读得出来的 → 科目(没写 = null);不在表里 = 不在或坏了 */
+    lectures?: ReadonlyMap<string, string | null>;
+    /** 读不出来的那几份,为什么(src/runtime/lecture.ts inspectLecture);没给就说一句笼统的 */
+    lectureProblems?: ReadonlyMap<string, readonly string[]>;
+    /** 读得出来但没烤过(或画面改过没重烤)的课包 id:播放退回在浏览器里现跑 excalidraw,提醒去 cotutor chalk bake */
+    unbaked?: ReadonlySet<string>;
+    today: string;
+    /**
+     * activity 按钮引用的 activity 文件(键「老师/名」):读得出来的 → 解析出来的 activity 与文件自己的「要改」(activity check 那几条);
+     * 不在表里 = 文件不在。没给就不查
+     */
+    activities?: ReadonlyMap<string, {
+        activity: Activity;
+        fixes: number;
+    }>;
+}
+/** 老师卡能不能上首页:有脸(-tutor 结尾)、开着、孩子端露 */
+export declare function faceTutor(name: string, t: HomeTutorInfo | undefined): boolean;
+/** 首页的老师(孩子端露的有脸老师),cotutor.json 的顺序 */
+export declare function homeTutors(tutors: Record<string, HomeTutorInfo>): string[];
+export declare const threadKey: (tutor: string, date: string, thread: string) => string;
+/** 草稿里小课堂按钮引用的课包 id */
+export declare function homeLectures(doc: Pick<HomeDoc, 'cards'>): string[];
+/** 草稿里 activity 按钮引用的 activity:「老师/名」 */
+export declare function homeActivities(doc: Pick<HomeDoc, 'cards'>): {
+    tutor: string;
+    name: string;
+}[];
+/** 草稿里要读盘才能查的引用:接着按钮指的话题(调用方按它读索引) */
+export declare function homeRefs(doc: Pick<HomeDoc, 'cards'>): {
+    tutor: string;
+    date: string;
+    thread: string;
+}[];
+/** 解析的问题 + 引用的问题 + 缺的老师 + 过期 + 没家长段;按行号排 */
+export declare function homeIssues(doc: HomeDoc, ctx: HomeCheckContext): HomeIssue[];
+/** --force 发布:丢掉有「要改」的卡 / 按钮;返回剩下的卡与丢了什么 */
+export declare function dropFixes(cards: readonly BoardCard[], issues: readonly HomeIssue[]): {
+    cards: BoardCard[];
+    dropped: string[];
+};
+/**
+ * 孩子端的排法:老师卡置顶(文件里的先后;不在 / 关了 / 藏了 / 重复的丢掉),没写的老师补一张空的(cotutor.json 顺序),其余卡照文件顺序。
+ * tutors = 首页的老师(homeTutors)。
+ */
+export declare function arrangeHome(cards: readonly BoardCard[], tutors: readonly string[]): BoardCard[];
+/** 非老师卡归哪位老师:文件顺序里跟在哪张(上首页的)老师卡后面;听写卡写了念的老师(而且上首页)就归他;都没有 = 公共 */
+export declare function homeOwners(cards: readonly BoardCard[], tutors: readonly string[]): (string | null)[];
+/**
+ * 今天从同一个入口进去的话题(设计稿 https://claude.ai/artifact/QkJBzLVbL7tgfEGKcDjaRm):
+ * 新话题的空白板上一个胶囊接它;activity、小课堂按钮先问接着它还是重新开始。title = 那个话题孩子说的第一句(截到 10 字;activity 是按钮字之后那句,还没说就空),at = 最后一条的时刻
+ */
+export interface Resume {
+    thread: string;
+    title: string;
+    at: string;
+}
+/** 孩子端老师卡上的一个按钮:id = 文件里的下标,或应用加的 new;resume = 今天同一个入口的话题 */
+export type KidHomeButton = {
+    id: 'new';
+    kind: 'new';
+    label: string;
+    resume?: Resume;
+} | {
+    id: number;
+    kind: 'start';
+    label: string;
+    brief?: string;
+    resume?: Resume;
+} | {
+    id: number;
+    kind: 'continue';
+    label: string;
+    date: string;
+    thread: string;
+    brief?: string;
+}
+/** 小课堂:title / ms(课名、课长)由服务端读课包后补 */
+ | {
+    id: number;
+    kind: 'lecture';
+    label: string;
+    bundle: string;
+    brief?: string;
+    title?: string;
+    ms?: number;
+    video?: true;
+    resume?: Resume;
+};
+/** 孩子端老师卡上常驻的一块方砖(HOME_TILES):label = activity 的名字;resume = 今天从这个 activity 进去的话题(和 activity 按钮同一个入口) */
+export interface KidHomeTile {
+    id: HomeTileId;
+    label: string;
+    resume?: Resume;
+}
+/** 这位老师牌上的方砖:开着的(on,牌上的先后)里,家里那个 activity 用得了的才出 */
+export declare function kidTiles(on: readonly HomeTileId[], opts: {
+    usable: (activity: string) => boolean;
+    resumes?: ReadonlyMap<string, Resume>;
+}): KidHomeTile[];
+export declare const NEW_THREAD_LABEL = "\u65B0\u8BDD\u9898";
+/** 一个话题是从哪个入口进去的:小课堂(按课包)、activity(按名字,参数不比)、自由话题(新话题按钮或没有按钮);别的按钮(开场、接着)进去的 → null */
+export declare function resumeKey(first: {
+    via?: {
+        button: number | string;
+    };
+    activity?: {
+        name: string;
+    };
+    lecture?: {
+        bundle: string;
+    };
+    continues?: unknown;
+}): string | null;
+/** 今天的索引 → 每个入口最近的那个话题(孩子开过口的;系统任务的话题不算) */
+export declare function todayResumes(messages: readonly {
+    thread?: string;
+    job: string;
+    at: string;
+    from: string;
+    text: string;
+    via?: {
+        button: number | string;
+    };
+    activity?: {
+        name: string;
+    };
+    lecture?: {
+        bundle: string;
+    };
+    continues?: unknown;
+    bookkeep?: unknown;
+}[]): Map<string, Resume>;
+/**
+ * 一张老师卡的按钮:新话题第一,然后是文件里的。应用不再加「接着刚才的」:每个按钮进去都是新话题,
+ * 新话题、activity、小课堂三种按钮带上 resume(今天同一个入口的话题),孩子端在空白板上接。
+ * 接着按钮指的话题现在找不到(alive 说没有)就不出现。keepBriefs = 家长预览(讲法留着)。
+ */
+export declare function kidButtons(buttons: readonly TutorButton[], opts: {
+    resumes?: ReadonlyMap<string, Resume>;
+    alive: (date: string, thread: string) => boolean;
+    lecture?: (bundle: string) => boolean;
+    activity?: (name: string, params: Readonly<Record<string, string>>) => boolean;
+    keepBriefs?: boolean;
+    today?: string;
+}): KidHomeButton[];
+/** 发布的 id:YYYY-MM-DD-HHMM(本地时间);taken 里有就加 -2、-3 */
+export declare function homeId(now: Date, taken: (id: string) => boolean): string;

package/dist/runtime/home/home.js

@@ -0,0 +1,318 @@
+import { HOME_TILES, LECTURE_ACTIVITY } from "../../schema/index.js";
+import { resolveParams } from "../activity.js";
+import { parseBoard } from "../../board/parse.js";
+const DAY_RE = /^\d{4}-\d{2}-\d{2}$/;
+const FENCE_TAG = /^ {0,3}(?:`{3,}|~{3,})\s*(\S*)/;
+export function parseHome(md) {
+    const all = md.replace(/\r\n/g, '\n').split('\n');
+    const issues = [];
+    let start = 0;
+    let forDay;
+    if (/^---\s*$/.test(all[0] ?? '')) {
+        const close = all.findIndex((l, i) => i > 0 && /^---\s*$/.test(l));
+        if (close < 0)
+            issues.push({ level: 'fix', line: 1, text: 'frontmatter 没闭合:在 for: 之后单独一行写 ---(或整段删掉)' });
+        else {
+            for (let i = 1; i < close; i++) {
+                const l = all[i];
+                if (!l.trim())
+                    continue;
+                const m = /^([A-Za-z][\w-]*):\s*(.*)$/.exec(l);
+                if (!m)
+                    issues.push({ level: 'note', line: i + 1, text: `frontmatter 这行认不出(只认 key: value):${l.trim()}` });
+                else if (m[1] !== 'for')
+                    issues.push({ level: 'note', line: i + 1, text: `frontmatter 只认 for,${m[1]} 不管用` });
+                else {
+                    const v = m[2].trim().replace(/^(["'])(.*)\1$/, '$2');
+                    if (DAY_RE.test(v))
+                        forDay = v;
+                    else
+                        issues.push({ level: 'note', line: i + 1, text: `for 要写成 YYYY-MM-DD(如 2026-09-18),「${v}」不认` });
+                }
+            }
+            start = close + 1;
+        }
+    }
+    const body = all.slice(start);
+    const board = parseBoard(body.join('\n'), { place: 'home' });
+    const at = (bodyLine) => start + bodyLine + 1;
+    for (const w of board.warnings) {
+        const line = w.line === undefined ? undefined : at(w.line);
+        const card = w.line === undefined ? -1 : board.spans.cards.findIndex((s) => s[0] === w.line);
+        issues.push({ level: w.fallback ? 'fix' : 'note', text: w.text, ...(line !== undefined ? { line } : {}), ...(card >= 0 ? { card } : {}) });
+    }
+    // 标签写的种类和解析出来的对不上 = 退了(解析器已经报过 fallback 的,这里只兜不认识的标签)
+    board.spans.cards.forEach((s, n) => {
+        const tag = (FENCE_TAG.exec(body[s[0]] ?? '')?.[1] ?? '').toLowerCase();
+        if (tag && tag !== board.section.cards[n].kind && !issues.some((x) => x.card === n && x.level === 'fix'))
+            issues.push({ level: 'fix', line: at(s[0]), card: n, text: `这张卡没解析成 ${tag}` });
+    });
+    if (board.spans.lines.length) {
+        const lines = board.spans.lines.map((s) => at(s[0]));
+        issues.push({ level: 'note', line: lines[0], text: `第 ${lines.join('、')} 行是围栏外的普通行,首页不显示;要给孩子看的写进卡里,给家长的挪到「## 为什么这么排」下面` });
+    }
+    return { ...(forDay ? { for: forDay } : {}), cards: board.section.cards, cardLines: board.spans.cards.map((s) => at(s[0])), note: board.tail, issues };
+}
+/** 老师卡能不能上首页:有脸(-tutor 结尾)、开着、孩子端露 */
+export function faceTutor(name, t) {
+    return Boolean(t && t.enabled && !t.hidden && name.endsWith('-tutor'));
+}
+/** 首页的老师(孩子端露的有脸老师),cotutor.json 的顺序 */
+export function homeTutors(tutors) {
+    return Object.entries(tutors)
+        .filter(([name, t]) => faceTutor(name, t))
+        .map(([name]) => name);
+}
+export const threadKey = (tutor, date, thread) => `${tutor} ${date} ${thread}`;
+/** 草稿里小课堂按钮引用的课包 id */
+export function homeLectures(doc) {
+    const out = new Set();
+    for (const c of doc.cards)
+        if (c.kind === 'tutor')
+            for (const b of (c.props.buttons ?? []))
+                if (b.kind === 'lecture')
+                    out.add(b.bundle);
+    return [...out];
+}
+/** 草稿里 activity 按钮引用的 activity:「老师/名」 */
+export function homeActivities(doc) {
+    const out = new Map();
+    for (const c of doc.cards)
+        if (c.kind === 'tutor')
+            for (const b of (c.props.buttons ?? [])) {
+                const name = b.kind === 'activity' ? b.activity : b.kind === 'lecture' ? (b.activity ?? LECTURE_ACTIVITY) : undefined;
+                if (name)
+                    out.set(`${c.props.tutor}/${name}`, { tutor: String(c.props.tutor), name });
+            }
+    return [...out.values()];
+}
+/** 草稿里要读盘才能查的引用:接着按钮指的话题(调用方按它读索引) */
+export function homeRefs(doc) {
+    const out = [];
+    for (const c of doc.cards) {
+        if (c.kind !== 'tutor')
+            continue;
+        for (const b of (c.props.buttons ?? []))
+            if (b.kind === 'continue')
+                out.push({ tutor: String(c.props.tutor), date: b.date, thread: b.thread });
+    }
+    return out;
+}
+/** 解析的问题 + 引用的问题 + 缺的老师 + 过期 + 没家长段;按行号排 */
+export function homeIssues(doc, ctx) {
+    const out = [...doc.issues];
+    const names = Object.keys(ctx.tutors);
+    const seen = new Map();
+    doc.cards.forEach((c, n) => {
+        if (c.kind !== 'tutor')
+            return;
+        const line = doc.cardLines[n];
+        const name = String(c.props.tutor);
+        const t = ctx.tutors[name];
+        if (!t)
+            return void out.push({ level: 'fix', line, card: n, text: `老师卡 ${name}:cotutor.json 里没有这位老师(有:${names.join('、')})` });
+        if (!name.endsWith('-tutor'))
+            return void out.push({ level: 'fix', line, card: n, text: `老师卡 ${name}:它是工具人(键不以 -tutor 结尾),孩子不直接找它` });
+        if (!t.enabled)
+            return void out.push({ level: 'fix', line, card: n, text: `老师卡 ${name}:${t.display}关着(cotutor.json enabled = false),先打开或删掉这张卡` });
+        if (t.hidden)
+            return void out.push({ level: 'fix', line, card: n, text: `老师卡 ${name}:${t.display}孩子端不露(hidden),删掉这张卡` });
+        const first = seen.get(name);
+        if (first !== undefined)
+            return void out.push({ level: 'fix', line, card: n, text: `${t.display}已经有一张老师卡(第 ${doc.cardLines[first]} 行),按钮合到那一张里` });
+        seen.set(name, n);
+        (c.props.buttons ?? []).forEach((b, k) => {
+            // activity 按钮,或小课堂按钮看完照哪个 activity 聊(写了 activity: 就是它,没写是这位老师的「小课堂」):文件在不在、文件自己要不要改、参数对不对(挂在小课堂下面的只用缺省)
+            const act = b.kind === 'activity' ? { name: b.activity, params: b.params } : b.kind === 'lecture' ? { name: b.activity ?? LECTURE_ACTIVITY, params: {} } : null;
+            if (act && ctx.activities) {
+                const got = ctx.activities.get(`${name}/${act.name}`);
+                if (!got)
+                    out.push({ level: 'fix', line, card: n, button: k, text: b.kind === 'lecture' && !b.activity ? `${t.display}的「${b.label}」:看完怎么聊写在 agents/${name}/activities/${LECTURE_ACTIVITY}.md,这份不在(cotutor upgrade 补出厂的;或按钮下面写一行 activity: <名> 换一个)` : `${t.display}的「${b.label}」:agents/${name}/activities/${act.name}.md 不在(cotutor activity check ${name} 看这位老师有哪些)` });
+                else {
+                    if (got.fixes)
+                        out.push({ level: 'fix', line, card: n, button: k, text: `${t.display}的「${b.label}」:activity 文件 ${act.name}.md 有 ${got.fixes} 处要改(cotutor activity check ${name} ${act.name})` });
+                    for (const text of resolveParams(got.activity, act.params).issues)
+                        out.push({ level: 'fix', line, card: n, button: k, text: `${t.display}的「${b.label}」:${text}` });
+                }
+            }
+            if (b.kind === 'activity')
+                return;
+            if (b.kind === 'lecture') {
+                const subject = ctx.lectures?.get(b.bundle);
+                if (ctx.lectures && subject === undefined)
+                    out.push({ level: 'fix', line, card: n, button: k, text: `${t.display}的「${b.label}」:${ctx.lectureProblems?.get(b.bundle)?.join(';') || `bundles/${b.bundle}/ 不在或读不出来(要有 scene.json 与带步的 manifest.json)`}` });
+                else if (subject && t.subject && subject !== t.subject)
+                    out.push({ level: 'note', line, card: n, button: k, text: `${t.display}的「${b.label}」:小课堂 ${b.bundle} 是${subject}的,${t.display}教${t.subject}` });
+                if (ctx.unbaked?.has(b.bundle))
+                    out.push({ level: 'note', line, card: n, button: k, text: `${t.display}的「${b.label}」:课包 ${b.bundle} 没烤过(或画面改过没重烤),孩子端要现画,慢、iPad 上可能不顺;跑 cotutor chalk bake ${b.bundle}(服务端发现了也会在后台补烤)` });
+                return;
+            }
+            if (b.kind !== 'continue')
+                return;
+            if (b.date > ctx.today)
+                out.push({ level: 'fix', line, card: n, button: k, text: `${t.display}的「${b.label}」:${b.date} 还没到` });
+            else if (!ctx.threads.has(threadKey(name, b.date, b.thread)))
+                out.push({ level: 'fix', line, card: n, button: k, text: `${t.display}的「${b.label}」:${b.date} 没有话题 ${b.thread}(cotutor show ${name} <job> ${b.date} 或 conversations/${name}/${b.date}.json 里找话题 id)` });
+        });
+    });
+    // 听写卡写了念的老师:不在 cotutor.json 就换人念(听写页照样能用,只提醒)
+    doc.cards.forEach((c, n) => {
+        if (c.kind !== 'dictation' || typeof c.props.tutor !== 'string' || ctx.tutors[c.props.tutor])
+            return;
+        out.push({ level: 'note', line: doc.cardLines[n], card: n, text: `听写卡写的 ${c.props.tutor} 不在 cotutor.json 里(有:${names.join('、')}),会换成语文老师念` });
+    });
+    const missing = homeTutors(ctx.tutors).filter((name) => !seen.has(name));
+    if (missing.length)
+        out.push({ level: 'note', text: `${missing.map((m) => ctx.tutors[m].display).join('、')}没写老师卡,孩子端会补一张只有「新话题」的` });
+    if (doc.for && doc.for < ctx.today)
+        out.push({ level: 'note', text: `for 是 ${doc.for},已经过去了(孩子端照样显示)` });
+    if (!doc.note.trim())
+        out.push({ level: 'note', text: '没有家长段(「## 为什么这么排」),下次回头看不知道为什么这么排' });
+    return out.sort((a, b) => (a.line ?? Infinity) - (b.line ?? Infinity));
+}
+/** --force 发布:丢掉有「要改」的卡 / 按钮;返回剩下的卡与丢了什么 */
+export function dropFixes(cards, issues) {
+    const dropped = [];
+    const out = [];
+    cards.forEach((c, n) => {
+        const mine = issues.filter((i) => i.level === 'fix' && i.card === n);
+        if (!mine.length)
+            return void out.push(c);
+        if (mine.every((i) => i.button !== undefined) && c.kind === 'tutor') {
+            const bad = new Set(mine.map((i) => i.button));
+            const buttons = (c.props.buttons ?? []).filter((_, k) => !bad.has(k));
+            dropped.push(...mine.map((i) => i.text));
+            out.push({ ...c, props: { ...c.props, buttons } });
+            return;
+        }
+        dropped.push(`第 ${n + 1} 张卡(${c.kind}):${mine.map((i) => i.text).join(';')}`);
+    });
+    return { cards: out, dropped };
+}
+/**
+ * 孩子端的排法:老师卡置顶(文件里的先后;不在 / 关了 / 藏了 / 重复的丢掉),没写的老师补一张空的(cotutor.json 顺序),其余卡照文件顺序。
+ * tutors = 首页的老师(homeTutors)。
+ */
+export function arrangeHome(cards, tutors) {
+    const seen = new Set();
+    const top = [];
+    const rest = [];
+    for (const c of cards) {
+        if (c.kind !== 'tutor') {
+            rest.push(c);
+            continue;
+        }
+        const name = String(c.props.tutor);
+        if (!tutors.includes(name) || seen.has(name))
+            continue;
+        seen.add(name);
+        top.push(c);
+    }
+    for (const name of tutors)
+        if (!seen.has(name))
+            top.push({ kind: 'tutor', props: { tutor: name, buttons: [] } });
+    return [...top, ...rest];
+}
+/** 非老师卡归哪位老师:文件顺序里跟在哪张(上首页的)老师卡后面;听写卡写了念的老师(而且上首页)就归他;都没有 = 公共 */
+export function homeOwners(cards, tutors) {
+    let cur = null;
+    return cards.map((c) => {
+        if (c.kind === 'tutor') {
+            const n = String(c.props.tutor);
+            if (tutors.includes(n))
+                cur = n;
+            return null;
+        }
+        const who = c.kind === 'dictation' && typeof c.props.tutor === 'string' && tutors.includes(c.props.tutor) ? c.props.tutor : null;
+        return who ?? cur;
+    });
+}
+/** 这位老师牌上的方砖:开着的(on,牌上的先后)里,家里那个 activity 用得了的才出 */
+export function kidTiles(on, opts) {
+    return HOME_TILES.filter((t) => on.includes(t.id) && opts.usable(t.activity)).map((t) => {
+        const r = opts.resumes?.get(`activity:${t.activity}`);
+        return { id: t.id, label: t.activity, ...(r ? { resume: r } : {}) };
+    });
+}
+export const NEW_THREAD_LABEL = '新话题';
+const RESUME_MAX = 10;
+/** 一个话题是从哪个入口进去的:小课堂(按课包)、activity(按名字,参数不比)、自由话题(新话题按钮或没有按钮);别的按钮(开场、接着)进去的 → null */
+export function resumeKey(first) {
+    if (first.lecture)
+        return `lecture:${first.lecture.bundle}`;
+    if (first.activity)
+        return `activity:${first.activity.name}`;
+    if (first.continues)
+        return null;
+    return !first.via || first.via.button === 'new' || first.via.button === 'recent' ? 'free' : null;
+}
+/** 今天的索引 → 每个入口最近的那个话题(孩子开过口的;系统任务的话题不算) */
+export function todayResumes(messages) {
+    const by = new Map();
+    for (const m of messages) {
+        const th = m.thread ?? m.job;
+        let t = by.get(th);
+        if (!t) {
+            t = { key: m.from === 'kid' ? resumeKey(m) : null, kid: [], at: m.at, firstVia: Boolean(m.via) };
+            by.set(th, t);
+        }
+        if (m.from === 'kid' && !m.bookkeep)
+            t.kid.push(m.text);
+        if (m.at > t.at)
+            t.at = m.at;
+    }
+    const out = new Map();
+    for (const [thread, t] of by) {
+        if (!t.key || !t.kid.length)
+            continue;
+        // 按钮进去的第一条是按钮上的字(activity 的名字),不是孩子说的:用第二句;还没有第二句就空着(孩子端写「刚开了个头」)
+        const said = (t.key.startsWith('activity:') ? (t.kid[1] ?? '') : t.kid[0]).replace(/\s+/g, ' ').trim();
+        const cps = Array.from(said);
+        const title = cps.length > RESUME_MAX ? `${cps.slice(0, RESUME_MAX).join('')}…` : said;
+        const prev = out.get(t.key);
+        if (!prev || t.at >= prev.at)
+            out.set(t.key, { thread, title, at: t.at });
+    }
+    return out;
+}
+/**
+ * 一张老师卡的按钮:新话题第一,然后是文件里的。应用不再加「接着刚才的」:每个按钮进去都是新话题,
+ * 新话题、activity、小课堂三种按钮带上 resume(今天同一个入口的话题),孩子端在空白板上接。
+ * 接着按钮指的话题现在找不到(alive 说没有)就不出现。keepBriefs = 家长预览(讲法留着)。
+ */
+export function kidButtons(buttons, opts) {
+    const resume = (key) => { const r = opts.resumes?.get(key); return r ? { resume: r } : {}; };
+    const out = [{ id: 'new', kind: 'new', label: NEW_THREAD_LABEL, ...resume('free') }];
+    buttons.forEach((b, k) => {
+        // 留到那天为止(家长端表单的「只今天 / 到周日」);过了就不出现,id 还是文件里的下标
+        if (b.until && opts.today && b.until < opts.today)
+            return;
+        const brief = opts.keepBriefs && b.brief ? { brief: b.brief } : {};
+        // activity 按钮在孩子那边就是开场按钮:点了发出按钮上的字;是哪个 activity、参数是什么,服务端照 via 从发布件查
+        // activity 用不了(文件不在、写坏了、这个按钮的参数按现在的文件解析不出),按钮不出:不让孩子点进一个没人带或带不了的话题;小课堂看完照它聊,同样
+        const hasActivity = (name, params = {}) => opts.activity?.(name, params) ?? true;
+        if (b.kind === 'start')
+            out.push({ id: k, kind: 'start', label: b.label, ...brief });
+        else if (b.kind === 'activity') {
+            if (hasActivity(b.activity, b.params))
+                out.push({ id: k, kind: 'start', label: b.label, ...brief, ...resume(`activity:${b.activity}`) });
+        }
+        else if (b.kind === 'lecture') {
+            if ((opts.lecture?.(b.bundle) ?? true) && hasActivity(b.activity ?? LECTURE_ACTIVITY))
+                out.push({ id: k, kind: 'lecture', label: b.label, bundle: b.bundle, ...brief, ...resume(`lecture:${b.bundle}`) });
+        }
+        else if (opts.alive(b.date, b.thread))
+            out.push({ id: k, kind: 'continue', label: b.label, date: b.date, thread: b.thread, ...brief });
+    });
+    return out;
+}
+/** 发布的 id:YYYY-MM-DD-HHMM(本地时间);taken 里有就加 -2、-3 */
+export function homeId(now, taken) {
+    const pad = (n) => String(n).padStart(2, '0');
+    const base = `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}-${pad(now.getHours())}${pad(now.getMinutes())}`;
+    if (!taken(base))
+        return base;
+    for (let k = 2;; k++)
+        if (!taken(`${base}-${k}`))
+            return `${base}-${k}`;
+}