cotutor 0.3.0 → 0.4.1

package/dist/runtime/live/call.js

@@ -7,7 +7,7 @@
  * 没念的拍丢掉,孩子听到第几句(src/runtime/delivery/playback.ts 按声音排到哪算)进下一轮的上下文包 live:。嘴只接住、只照念,不讲新内容(2026-10-19 P1);画板开着时例外(边画边聊,见下)。
  *
  * 孩子端 → 这里:二进制帧 = PCM16 16k 单声道一块(按着时才推);文本帧 = JSON
- *   {t:'hold'} 按下 · {t:'release', body} 松手(body 同 POST /api/kid/conversations/<老师>/messages 少 text:thread / newThread / device…)
+ *   {t:'hold'} 按下 · {t:'release', body} 松手(body 同 send 的那条少 text:thread / newThread / device…,runner.accept 验)
  *   {t:'hush'} 停下不开新一轮(上滑取消):嘴在出就掐、孩子端清了、没念的丢掉
  *   {t:'send', body} 不是说的(打字、拍照、交卡、首页按钮;舞台开着带 focus.card):body 同那条 POST · {t:'view', w, h} 屏幕多大 · {t:'bye'}
  *   {t:'staged'} 讲稿 [[play]] 的小课堂那一段放完了(或放不了、被关):后面的讲稿接着交给嘴
@@ -31,12 +31,15 @@
  *   孩子说完(像跟读,src/scenes/talk/warmup.ts)开闸下一拍,不接住、不交脑;对老师说的照收下办(打断、接住、交脑);ECHO_WAIT_MS 没开口接着走,连着两拍没开口停下交脑(app: quiet)。
  *   每拍记进摸底(录像 {t:'echo'},只记不发),交脑时带上(live.warmup)。[[call]] 那句念完孩子端响铃,这里马上交脑一轮(app: call,不接住),
  *   之后的接住换英文(cue.ts 的 CATCH_EN),交脑带打电话几分钟(live.phone)。孩子端连上发来的第一条带 talk(口语单)时嘴先说「好,我们先热热身!」。
- * 录像:进出的消息、两边的声音都记(CallRecorder),挂了落在 conversations/<老师>/<日期>.live/<时分秒>.reel.json / .wav。
+ * 录像:进出的消息、两边的声音都记(CallRecorder),落在 conversations/<老师>/<日期>.live/<时分秒>.reel.json / .wav(时分秒 = 这一段开始的时刻)。
+ *   按段落(2026-11-06):两轮之间安静着(心跳时看),这一段 IDLE_CUT_MS 没动静、或录了 MAX_TAKE_MS,就收下这一段落盘、接着录新的一段;挂了落最后一段。
+ *   一段一轮都不会切开(录像按轮在一段里找按下、松手、turn、read);没动静的一段不落。
  * 字幕重放:嘴照念的声音按轮另留一份,出了的都留(孩子按下时清掉、没放出来的也在),
  *   一段出完(或被掐、断了)就落 <日期>.<job>.mouth.wav 与每句的起点 .mouth.json(src/runtime/journal/mouth-index.ts);接住那句不在里面。孩子端从 /api/kid/conversations/<老师>/mouth/<日期>/<job> 取。
  * 事件:嘴这一道(mouth:按下、松手 / 发了、接住开始放、第几句开始放、打断)补进那一轮的 events.jsonl(Runner.noteEvent),工作台的时间线上看;
  * 按下、松手、接住在脑起来之前,先攒着,等那一轮的老师进程起来(main:start)再按它的起点换成相对毫秒(负的)。
  */
+import { existsSync } from 'node:fs';
 import { mkdir, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { localDate } from "../../shared/time.js";
@@ -50,7 +53,7 @@ import { wavOfPcm } from "../../shared/wav.js";
 import { mouthInstructions } from "../../realtime/prompt.js";
 import { mouthVoice } from "../../schema/index.js";
 import { INPUT_RATE, MAX_IMAGE_B64, OUTPUT_RATE, RealtimeSession } from "../../realtime/bailian.js";
-import { CallRecorder } from "../journal/recorder.js";
+import { CallRecorder, renderTake } from "../journal/recorder.js";
 import { MouthEvents, MouthTakes } from "../journal/mouth.js";
 import { Turns } from "./turns.js";
 /** 嘴接住的那句最多等多久再把孩子的话交给脑(接住的字一般 1 秒内齐;脑知道嘴说了什么,第一句就不再重复) */
@@ -77,6 +80,12 @@ const IDLE_SWAP_MS = 240_000;
 /** 热身:[[echo]] / [[say]] 那句在孩子端放完,这么久没开口就接着下一拍(不催);连着这么多拍没开口就停下交脑 */
 const ECHO_WAIT_MS = 8000;
 const QUIET_BEATS = 2;
+/**
+ * 录像切段:这一段这么久没动静、或录了这么久(两轮之间安静着才切),就收下落盘、接着录新的一段。
+ * 页面开着不关能挂几个钟头(2026-10-25 一段 2 小时、361 MB 的 wav,几乎没说话):不切的话声音全攒在内存里,挂断时一起混
+ */
+const IDLE_CUT_MS = 5 * 60_000;
+const MAX_TAKE_MS = 30 * 60_000;
 /** 打电话:[[call]] 那句放完先响这么久的铃,脑的英文开场来得再早也等它(孩子听得到在打电话) */
 const RING_MS = 3000;
 /**
@@ -170,6 +179,8 @@ export class LiveCall {
     chatQuiet = 0;
     chatQuietUntil = 0;
     offEvents = null;
+    /** 录像一段一段排着落盘(按顺序、一次混一段);挂了等它们都落完 */
+    saving = Promise.resolve();
     ended = false;
     sock;
     deps;
@@ -526,6 +537,7 @@ export class LiveCall {
     keepAlive() {
         const s = this.session;
         this.maybeSwap();
+        this.maybeCut();
         if (!s?.isReady || this.holding || this.vadOn || s.responding || Date.now() - this.lastActive > (this.deps.keepAliveMs ?? KEEP_ALIVE_MS))
             return;
         // 一直听、声音一直在推:本来就有输入,不用跳
@@ -563,6 +575,32 @@ export class LiveCall {
             this.send({ t: 'flush' });
         }
     }
+    /**
+     * 录像切段:两轮之间安静着(孩子没在说、嘴没在说也没在放、脑没在写、没在等转写),这一段没动静够久了或录得够长了,就收下落盘。
+     * 一轮不会被切开:录像按轮在一段里找按下、松手、turn 和 read
+     */
+    maybeCut() {
+        if (this.ended || !this.quiet() || this.playing() || this.pendingVoice || this.draft || this.echoing || this.chatHeard !== null)
+            return;
+        const idle = this.rec.quietMs() >= (this.deps.idleCutMs ?? IDLE_CUT_MS);
+        const long = this.rec.stirred && this.rec.takeMs() >= (this.deps.maxTakeMs ?? MAX_TAKE_MS);
+        if (idle || long)
+            this.saveTake(this.rec.cut());
+    }
+    /** 落一段录像(排在前面那几段后面):没动静的、只有连上那两条的不落 */
+    saveTake(raw) {
+        if (!raw.stirred || raw.msgs.length <= 2)
+            return;
+        const { ctx, tutor } = this.deps;
+        this.saving = this.saving.then(async () => {
+            const take = await renderTake(raw);
+            const dir = join(ctx.runner.ws.dirs.conversations, tutor, `${localDate(raw.startedAt)}.live`);
+            await mkdir(dir, { recursive: true });
+            const name = takeName(dir, raw.startedAt);
+            await writeFile(join(dir, `${name}.wav`), wavOfPcm(take.callPcm, MIX_RATE));
+            await writeFile(join(dir, `${name}.reel.json`), JSON.stringify(take.reel));
+        }).catch((err) => { console.error('live: 录像落盘失败', err); });
+    }
     /** 孩子的一条文本消息 */
     onText(raw) {
         if (this.ended)
@@ -1155,21 +1193,8 @@ export class LiveCall {
         if (this.said?.kind === 'read')
             this.mouthEnd(this.said, false);
         await this.takes.flush();
-        try {
-            const take = this.rec.finish();
-            if (take.reel.msgs.length > 2) {
-                const { ctx, tutor } = this.deps;
-                const at = this.rec.startedAt;
-                const dir = join(ctx.runner.ws.dirs.conversations, tutor, `${localDate(at)}.live`);
-                const name = [at.getHours(), at.getMinutes(), at.getSeconds()].map((n) => String(n).padStart(2, '0')).join('');
-                await mkdir(dir, { recursive: true });
-                await writeFile(join(dir, `${name}.wav`), wavOfPcm(take.callPcm, MIX_RATE));
-                await writeFile(join(dir, `${name}.reel.json`), JSON.stringify(take.reel));
-            }
-        }
-        catch (err) {
-            console.error('live: 录像落盘失败', err);
-        }
+        this.saveTake(this.rec.finish());
+        await this.saving;
         this.sock.close(1000, why);
         this.deps.onFinished?.(why);
     }
@@ -1178,6 +1203,14 @@ export class LiveCall {
         void this.end('kid-gone'); }
 }
 const isObj = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+/** 一段录像的文件名:开始的时分秒;这一秒已经有一段了(同一位老师两次通话、切段撞在同一秒)往后挪一秒,不盖掉 */
+const takeName = (dir, at) => {
+    const hms = (d) => [d.getHours(), d.getMinutes(), d.getSeconds()].map((n) => String(n).padStart(2, '0')).join('');
+    let name = hms(at);
+    for (let k = 1; k < 60 && existsSync(join(dir, `${name}.reel.json`)); k++)
+        name = hms(new Date(at.getTime() + k * 1000));
+    return name;
+};
 /** 孩子端发来的图(data:image/jpeg;base64,…)→ 字节;不是 jpeg、太大(百炼一帧上限)回 null */
 const jpegOf = (v) => {
     const m = typeof v === 'string' ? /^data:image\/jpeg;base64,([A-Za-z0-9+/=]+)$/.exec(v) : null;

package/dist/runtime/live/turns.js

@@ -1,6 +1,6 @@
 /**
  * 实时那一轮交给脑(从 call.ts 拆出来,2026-10-29,行为不变;以后是 runtime/turn):
- * 孩子端发来的那条验过、拼好(runner.accept,和 HTTP 共用),带上这一轮实时的那些(live:)交给 runner.send;
+ * 孩子端发来的那条验过、拼好(runner.accept;孩子端只走这条路,HTTP 的发 2026-11-04 删了),带上这一轮实时的那些(live:)交给 runner.send;
  * 这位老师别处正在写(BusyError)就排着,它写完把排着的几句合并成一条再发;脑在写时孩子又说的(submit 时 running)也排着,这一轮写完一起发。
  * 一轮写完,收尾时把流式没发出来的讲稿从正式的一节补上(整块出的运行时、最后几句)。
  */

package/dist/runtime/runner.d.ts

@@ -11,9 +11,8 @@
  * 进程 cwd 是老师目录 agents/<name>/。
  */
 import { type IncomingMark } from './lecture.ts';
-import { type BrainExecutor, type Slot } from '../brain/index.ts';
+import { type BrainExecutor, type RunPlan } from '../brain/index.ts';
 import { type BoardSection, type Device } from '../board/presentation.ts';
-import { type RunPlan } from '../brain/cli/run-plan.ts';
 import { type RunEvent, type RunEventEnvelope } from '../schema/index.ts';
 import { type ContextPack, type ConversationIndex, type ActivityRun, type ConversationMessage, type Focus, type MessageFrom, type MessageVia } from '../schema/index.ts';
 import type { Workspace } from '../schema/index.ts';
@@ -59,7 +58,7 @@ export interface SendInput {
     drawing?: NonNullable<ConversationMessage['drawing']>;
     /** 这条是回放(app/replay.ts):原轮的 job,记进消息;调用方已经把 Runner 指到 evals/ */
     replayOf?: string;
-    /** cotutor activity eval 跑的一轮:不写记忆、不预热(画照画,画家由 eval 换成假的) */
+    /** cotutor activity eval 跑的一轮:不写记忆(画照画,画家由 eval 换成假的) */
     eval?: true;
     /** 孩子看完小课堂后的第一条:上下文包带 lecture:(课的每句、看的情况、画过的几处),消息记 lecture;again = 问过以后再看一遍又画了 */
     lecture?: {
@@ -130,58 +129,35 @@ export declare function attachActivity(ws: Workspace, tutor: string, pack: Conte
     thread: string;
     now: number;
 }, inSystem?: boolean): Promise<string[]>;
-/** 按老师裁的板书写法落在哪(相对 workspace 根;机器文件,内容变了文件名跟着变) */
-export declare const TUTOR_BOARD_DIR = ".cotutor/board";
 /** activity 在系统提示里时,上下文包 activityGuide 那一行 */
 export declare const ACTIVITY_IN_SYSTEM = "\u5DF2\u5728\u4F60\u7684\u7CFB\u7EDF\u63D0\u793A\u91CC(\u8FD9\u4E2A\u8BDD\u9898\u7684 activity,\u7167\u5B83\u5E26)";
 /**
  * activity 话题的系统提示(九点五):不读老师文件,人设与做法都是 activity 自己的。
  *   body   「老师怎么带」按参数与这个话题的卡裁好、剥了注释
  *   kinds  这个话题的卡:activity 头上的 cards 加 text(不并老师的)
- *   guide  只讲这几种卡的板书写法,写到 .cotutor/board/
+ *   guide  只讲这几种卡的板书写法
  *   memory 这个 activity 自己的记忆:agent: <老师>/<activity>,文件名 <老师显示名>·<activity>
  * activity 文件不在、没有「老师怎么带」→ null(退回老师文件)。
  */
 export interface ActivityParts {
     body: string;
     kinds: string[];
-    guide: {
-        body: string;
-        path: string;
-    };
+    guide: string;
     memory: {
         agent: string;
         display: string;
     };
 }
 export declare function activityParts(ws: Workspace, tutor: string, run: ActivityRun): Promise<ActivityParts | null>;
-/**
- * 这位老师的板书写法:正文 + 相对 workspace 根的路径(给 {boardFile} 与上下文包)。
- * 没写 cards → 出厂的 cotutor-board SKILL.md;写了 → 按清单从包里现拼(boardGuideFor),写到 .cotutor/board/<老师>-<hash>.md,
- * 文件名带内容的 hash:清单一改路径就变,预热进程的 argv 对不上,不会拿着旧写法去答。读不到 SKILL.md → null。
- */
-export declare function boardGuideOf(ws: Workspace, tutor: string): Promise<{
-    body: string;
-    path: string;
-} | null>;
-/**
- * 板书写法怎么递给老师(2026-09-19):有脸的老师、板书没关才带。运行时预载了 → 上下文包只写一行事实;
- * 没预载 → 原文作为一条笔记放进话题第一条(<cotutor-board>),排在守则后面,续话题没改过写「未变」。返回板书写法(给 {systemBody} 与 {boardFile})。
- */
-export declare function attachBoardGuide(ws: Workspace, tutor: string, pack: ContextPack, o: {
-    preloaded: boolean;
-    boardOff: boolean;
-}): Promise<{
-    body: string;
-    path: string;
-} | null>;
+/** 这位老师的板书写法:没写 cards → 出厂的 cotutor-board SKILL.md;写了 → 按清单从包里现拼(boardGuideFor)。读不到 SKILL.md → null */
+export declare function boardGuideOf(ws: Workspace, tutor: string): Promise<string | null>;
 /** 这轮带的笔记版本:role → `路径@hash`(记进消息;同一话题下一轮对得上就不再带原文) */
 export declare function noteVersions(pack: ContextPack): Record<string, string>;
 /** 续会话时:上一轮这个话题已经带过、版本没变的笔记去掉原文,YAML 里注明「未变」 */
 export declare function dropSeenNotes(pack: ContextPack, seen: Record<string, string>): ContextPack;
 /** 这个话题里最近一次记下的笔记版本(新话题、没记过 → {}) */
 export declare function seenNotes(messages: readonly ConversationMessage[], thread: string): Record<string, string>;
-/** 老师该读得到的目录:workspace 根(作业照片、技能)与 vault(教材、日记);会话 cwd 是老师目录,这些在它外面(qwen 读外面要先划进来) */
+/** 只读工具读得到的目录:workspace 根(作业照片、技能)与 vault(教材、日记) */
 export declare function readDirsOf(ws: Workspace): string[];
 /** 干跑:现在给这位老师发这句话,上下文包会是什么样、每段从哪来、截了多少;不起模型、不写盘 */
 export declare function packDryRun(ws: Workspace, tutor: string, input: {
@@ -205,16 +181,9 @@ export declare class Runner {
     private readonly listeners;
     /** noteEvent 每个事件文件一条追加链 */
     private readonly notes;
-    /** 脑执行:起老师、读输出、断流接着跑、预热下一轮(src/brain/) */
+    /** 脑执行:请模型、读输出(src/brain/) */
     readonly brain: BrainExecutor;
-    /** 预热池的旧入口(测试看有没有、杀掉);迁完删 */
-    get spares(): {
-        has(tutor: string, slot?: Slot): boolean;
-        drop(tutor: string, slot?: Slot): void;
-    };
-    /** 页面拉今天时的预热:每位老师(与带的话题)上次看的时刻 */
-    private readonly prewarmedAt;
-    /** 起子进程用的环境(测试注入) */
+    /** key、假端点从哪读的环境(测试注入) */
     get env(): NodeJS.ProcessEnv | undefined;
     /** 当前的 workspace(cotutor.json 热重载后是新的;实时老师经它拿) */
     get ws(): Workspace;
@@ -223,8 +192,6 @@ export declare class Runner {
     constructor(getWs: () => Workspace, opts?: {
         now?: () => Date;
         env?: NodeJS.ProcessEnv;
-        warmIdleMs?: number;
-        warm?: boolean;
         draw?: Draw;
     });
     /** 孩子端发一条的验与拼(HTTP 与实时老师共用,./kid-input.ts):拼成 send 的入参,或回 reject;不起老师 */
@@ -239,19 +206,6 @@ export declare class Runner {
     onEvent(fn: (e: RunEventEnvelope) => void): () => void;
     /** 别处给某一轮补事件(实时老师的嘴,src/runtime/live/call.ts;t 已经换成离这一轮老师进程起来的毫秒):追加到 events.jsonl、给订阅者;这一轮跑完了也行 */
     noteEvent(tutor: string, date: string, job: string, event: RunEvent): Promise<void>;
-    /** 杀掉所有预热的进程(测试收尾;服务退出时它们的 stdin 断了会自己退) */
-    close(): void;
-    /**
-     * 预热:给这位老师起好下一轮的进程,两个位置都补齐——
-     * fresh:新开会话(新话题、接着上次都用它);
-     * resume:接 thread(页面选着的话题;不给或今天没有 = 当天末条所在的话题,和 send 缺省一样)的会话,它没有会话就不留。
-     * 只给有脸的、开着的、运行时 stdin: "stream-json"、这会儿没在跑的老师起;throttleMs 内同一话题看过就不再看(页面轮询今天)。
-     * 起了返回 true;起不了不报错,下一轮冷起。warm: false(cotutor send:跑完就退,留着备用进程会把它挂一小时)不起。
-     */
-    prewarm(tutor: string, opts?: {
-        throttleMs?: number;
-        thread?: string;
-    }): Promise<boolean>;
     /** 正在回的那条已经出来的板书(流式);没在跑或还没出卡 → null */
     partial(tutor: string): BoardSection | null;
     send(tutor: string, input: SendInput): Promise<SendStarted>;