cotutor 0.3.0 → 0.4.1

package/dist/app/mock/mock.js

@@ -14,14 +14,14 @@ import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'no
 import { readdir } from 'node:fs/promises';
 import { createServer as createHttp } from 'node:http';
 import { createServer as createHttps } from 'node:https';
-import { hostname, tmpdir } from 'node:os';
+import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { parseBoard } from "../../board/parse.js";
 import { cardAssets, parseCardState, stripSecrets, DictationPropsSchema } from "../../board/cards/index.js";
 import { fileURLToPath } from 'node:url';
 import { bundleAsset, stageAsset, stageIndex, stageVersion } from "../http/stage.js";
 import { sendFile } from "../http/send-file.js";
-import { subjectLang, tutorExtras } from "../../schema/index.js";
+import { HOME_TILES, HOME_TILE_IDS, canonicalSubject, subjectLang, tutorExtras } from "../../schema/index.js";
 import { NEUTRAL_COLOR, tutorColors } from "../../ui/shared/tutor-color.js";
 import { boardMarkOf } from "../../ui/kid/board-mark.js";
 import { backTutorOf } from "../../ui/kid/tutor-face.js";
@@ -67,15 +67,15 @@ import { wavOfPcm } from "../../shared/wav.js";
 import { buildReel, playRecordOk, reelHolds, reelMissRuns } from "../../ui/kid/reel.js";
 import { weekOf } from "../../shared/time.js";
 import {} from "../../schema/index.js";
-import { lanAddresses, listenInfo } from "../cli/serve.js";
-import { qrPage } from "../../ui/dev/qr-page.js";
+import { lanAddresses, listenInfo, localName, siteUrl } from "../cli/serve.js";
+import { qrPage } from "../../ui/parent/qr-page.js";
 import { USER_CERT_DIR } from "../workspace.js";
 import { kidThreads } from "../../runtime/kid-view.js";
 import { ICON_SIZES, appIconPng, webManifest } from "../../ui/shared/icon.js";
 import { faviconResponse } from "../../ui/shared/favicon.js";
 import { kidPage } from "../../ui/kid/kid-page.js";
 import { parentPage } from "../../ui/parent/parent-page.js";
-import { arrangeHome, homeOwners, kidButtons, parseHome } from "../../runtime/home/home.js";
+import { arrangeHome, homeOwners, kidButtons, kidTiles, parseHome } from "../../runtime/home/home.js";
 import { packageTheme } from "../cli/themes.js";
 import { cardsCss } from "../../board/cards/docs.js";
 import { VOICE_GALLERY_PAGE } from "../../ui/dev/voice-gallery-page.js";
@@ -533,7 +533,9 @@ export function createMock(opts = {}) {
             // mock 的话题都是新话题进去的:今天孩子问过的那个,挂在新话题按钮上(空白板上的胶囊)
             const resumes = asked ? new Map([['free', { thread: asked.thread, title: (asked.question ?? '').slice(0, 10), at: list[list.length - 1]?.at ?? '' }]]) : undefined;
             const alive = (date, thread) => (date === yesterday() && (past.get(name) ?? []).some((m) => m.thread === thread)) || (date === localDate(d) && list.some((m) => m.thread === thread));
-            return { kind: 'tutor', props: { tutor: name, buttons: kidButtons((c.props.buttons ?? []), { resumes, alive, lecture: (id) => Boolean(mockLecture(id)), today: localDate(d) }).map((b) => { const l = b.kind === 'lecture' ? mockLecture(b.bundle) : null; return l ? { ...b, title: l.title, ms: l.ms, ...(l.video ? { video: true } : {}) } : b; }) } };
+            // 方砖:三门主科出厂都有预习、检查作业、复习(真服务看老师家里有没有那个 activity 文件)
+            const main = ['语文', '数学', '英语'].includes(canonicalSubject(MOCK_TUTORS.find((t) => t.name === name)?.subject) ?? '');
+            return { kind: 'tutor', props: { tutor: name, tiles: main ? kidTiles(HOME_TILE_IDS, { usable: () => true }) : [], buttons: kidButtons((c.props.buttons ?? []), { resumes, alive, lecture: (id) => Boolean(mockLecture(id)), today: localDate(d) }).map((b) => { const l = b.kind === 'lecture' ? mockLecture(b.bundle) : null; return l ? { ...b, title: l.title, ms: l.ms, ...(l.video ? { video: true } : {}) } : b; }) } };
         });
         // figshot:和配了 figshot 的 workspace 一样给端口;这台电脑上 figshot 没开着,页面照样藏着这张卡
         return { title, date: localDate(d), tutors: tutorsJson(), home: mockHomeId(), cards, figshot: { port: 8477 }, hand: 'right', ready: scenario !== 'nokey' };
@@ -579,6 +581,9 @@ export function createMock(opts = {}) {
             return null;
         if (via.button === 'new' || via.button === 'recent')
             return via.button;
+        const tile = HOME_TILES.find((t) => t.id === via.button);
+        if (tile)
+            return { kind: 'activity', label: tile.activity, activity: tile.activity, params: {} };
         if (via.home !== mockHomeId() || typeof via.button !== 'number')
             return null;
         const card = parseHome(mockHomeMd(localDate(now()), yesterday())).cards.find((c) => c.kind === 'tutor' && c.props.tutor === name);
@@ -626,13 +631,14 @@ export function createMock(opts = {}) {
             setTimeout(reveal, tick);
         });
     };
-    const route = async (method, path, body) => {
+    /** internal = 实时那条连接交来的孩子发的一条(kidSend);HTTP 上不收(同真服务,2026-11-04 删了 HTTP 的发) */
+    const routeIn = async (method, path, body, internal = false) => {
         await lecturesLoaded;
         const url = new URL(path, 'http://x');
         const p = url.pathname;
         if (p === '/')
             return { status: 200, html: kidPage(title, {}, await stageVersion()) };
-        if (p === '/dev/qr')
+        if (p === '/parent/qr')
             return mock.listen ? { status: 200, html: qrPage(title, mock.listen(), url.searchParams.get('via') === 'ip' ? 'ip' : 'name', url.searchParams.get('to') === 'parent' ? 'parent' : 'kid') } : { status: 404, json: { error: 'not_listening' } };
         if (p === '/dev/voice')
             return { status: 200, html: VOICE_GALLERY_PAGE };
@@ -884,7 +890,7 @@ export function createMock(opts = {}) {
                 const out = { tutor: name, date: tail, messages: await Promise.all(old.map(kidMessage)), pending: null, thread: old.length ? old[old.length - 1].thread : null };
                 return { status: 200, json: out };
             }
-            if (tail === 'messages' && method === 'POST') {
+            if (tail === 'messages' && method === 'POST' && internal) {
                 if (!isObj(body) || typeof body.text !== 'string')
                     return { status: 400, json: { error: 'bad_request' } };
                 const action = body.action === 'submit' ? 'submit' : undefined;
@@ -1085,7 +1091,9 @@ export function createMock(opts = {}) {
         })().catch((err) => { res.writeHead(500, { 'content-type': 'application/json' }); res.end(JSON.stringify({ error: 'internal', message: String(err) })); });
     };
     const settleJob = async (job) => { await inflight.get(job); };
-    const mock = { route, settle, settleJob, handler, listen: null };
+    const route = (method, path, body) => routeIn(method, path, body);
+    const kidSend = (tutor, body) => routeIn('POST', `/api/kid/conversations/${tutor}/messages`, isObj(body) ? { ...body, live: true } : body, true);
+    const mock = { route, kidSend, settle, settleJob, handler, listen: null };
     return mock;
 }
 export async function serveMock(opts = {}) {
@@ -1111,7 +1119,7 @@ export async function serveMock(opts = {}) {
     });
     const port = server.address().port;
     const scheme = tls ? 'https' : 'http';
-    const urls = [hostname(), ...lanAddresses()].map((h) => `${scheme}://${h}:${port}/`);
+    const urls = [localName(), ...lanAddresses()].map((h) => siteUrl(scheme, h, port));
     mock.listen = () => listenInfo(Boolean(tls), port);
-    return { server, mock, port, https: Boolean(tls), urls, qrPage: `${scheme}://localhost:${port}/dev/qr` };
+    return { server, mock, port, https: Boolean(tls), urls, qrPage: siteUrl(scheme, 'localhost', port, '/parent/qr') };
 }

package/dist/app/replay.js

@@ -10,9 +10,9 @@
 import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { cardLabel } from "../board/cards/index.js";
-import { logParser } from "../brain/index.js";
+import { parseLogLine } from "../brain/index.js";
 import { UsageError } from "../shared/errors.js";
-import { conversationFiles, threads } from "../schema/index.js";
+import { conversationFiles, threads, viaSendsLabel } from "../schema/index.js";
 import { compactDiff, diffLines } from "./diff.js";
 import { tokenText } from "../shared/tokens.js";
 import { toolCalls } from "../brain/transcript.js";
@@ -61,7 +61,7 @@ export async function startReplay(ws, tutor, date, job, opts = {}) {
         replayOf: job,
         runtime: opts.runtime,
         ...(m.via ? { via: m.via } : {}),
-        ...(m.via && typeof m.via.button === 'number' ? { home: { button: m.via.label, ...(button?.brief ? { brief: button.brief } : {}) } } : {}),
+        ...(m.via && viaSendsLabel(m.via) ? { home: { button: m.via.label, ...(button?.brief ? { brief: button.brief } : {}) } } : {}),
         ...(m.continues && continued ? { continues: { ...m.continues, pack: continued } } : {}),
         ...(activity ? { activity } : {}),
         // 原轮是实时的:回放也按实时写(上下文包带 live:、不补提问卡);嘴不在,接住与打断的 caught / cut 不带
@@ -119,7 +119,7 @@ async function toolsOf(ws, tutor, date, m) {
     if (m.tools)
         return m.tools;
     const text = await readFile(conversationFiles(ws.dirs.conversations, tutor, date).log(m.job), 'utf8').catch(() => '');
-    return toolCalls(text, logParser(ws.config.runtimes, m.runtime));
+    return toolCalls(text, parseLogLine);
 }
 export async function compareReplay(ws, tutor, date, evalJob) {
     const evalWs = evalWorkspace(ws);

package/dist/app/skills/home-doc.js

@@ -35,7 +35,7 @@ export function homeSyntaxDoc(dir = PACKAGE_CARDS_DIR) {
 - **第一个 \`## \` 起是给家长的**(「## 为什么这么排」),孩子看不到。
 - 围栏外的普通行首页不显示(检查会提醒),要给孩子看的写进卡里。
 
-应用保证的:每位孩子端露出的老师都有一张老师卡(没写就补一张只有「新话题」的);「新话题」永远是第一个按钮;应用不加「接着刚才的」——今天从同一个入口聊过的,孩子进老师页后在空白板上接(新话题是一个胶囊,activity、小课堂先问接着那个还是重新开始);引用坏了(话题找不到)的按钮不出现。
+应用保证的:每位孩子端露出的老师都有一张老师卡(没写就补一张只有「新话题」的);「新话题」永远是第一个按钮;老师家里有预习、检查作业、复习这几个 activity 的,新话题下面常驻这几块方砖(不用写,家长端能关,不占按钮的名额);应用不加「接着刚才的」——今天从同一个入口聊过的,孩子进老师页后在空白板上接(新话题是一个胶囊,activity、小课堂先问接着那个还是重新开始);引用坏了(话题找不到)的按钮不出现。
 
 老师卡的按钮最多 ${TUTOR_BUTTONS_MAX} 个,每个最多 ${BUTTON_LABEL_MAX} 个字。
 

package/dist/app/workspace.d.ts

@@ -1,6 +1,6 @@
 import { ConfigError, UsageError } from '../shared/errors.ts';
 import { redactDeep, redactHome } from '../shared/home.ts';
-import { type RootSource, type Workspace } from '../schema/workspace.ts';
+import { type RootSource, type SandboxMark, type Workspace } from '../schema/workspace.ts';
 import { type CotutorConfig } from '../schema/index.ts';
 export { ConfigError, UsageError, redactDeep, redactHome };
 export type { RootSource, Workspace };
@@ -29,6 +29,8 @@ export declare function resolveRoot(override?: string, opts?: ResolveOptions): R
 /** 校验 cotutor.json 的形状;失败 → ConfigError,信息是逐条修复指南 */
 export declare function parseConfig(raw: unknown, file: string): CotutorConfig;
 export declare function resolvePaths(root: string, paths: Record<string, string>): Workspace['paths'];
+/** 根下的 sandbox 标记(.cotutor/sandbox.json):没有 → null;坏了响亮报错(不当成真 workspace 静默往下跑) */
+export declare function readSandboxMark(root: string): SandboxMark | null;
 export declare function assembleWorkspace(root: string, source: RootSource, config: CotutorConfig): Workspace;
 /** 定根 + 读配置 + 校验 + 展开角色。cotutor.json 缺失也是错(它是必需的)。 */
 export declare function loadWorkspace(override?: string, opts?: ResolveOptions): Workspace;
@@ -51,8 +53,11 @@ export declare function deepMerge(base: unknown, patch: unknown): unknown;
 export declare function patchConfig(ws: Workspace, patch: Record<string, unknown>, opts?: {
     also?: readonly string[];
 }): Promise<CotutorConfig>;
-/** 文件改了(页面写的、或家长在编辑器改的)就重读;坏了抛 ConfigError,调用方决定是留旧的还是响 */
-export declare function reloadIfChanged(ws: Workspace, lastMtime: number): Promise<{
+/**
+ * 文件内容变了(页面写的、或家长在编辑器改的)就重读;坏了抛 ConfigError,调用方决定是留旧的还是响。
+ * 比原文不比修改时间:Windows 上写 .tmp 再 rename 连写两次,修改时间常常一模一样(10-31 实测 200 次里 105 次);文件只有几 K,每次读一遍不贵。
+ */
+export declare function reloadIfChanged(ws: Workspace, lastText: string | null): Promise<{
     ws: Workspace;
-    mtime: number;
+    text: string;
 }>;

package/dist/app/workspace.js

@@ -7,10 +7,10 @@
  * 配置"在但解析不了"响亮报错,不静默走缺省(沿 drawtell 的教训)。
  */
 import { readFileSync, readdirSync, statSync } from 'node:fs';
-import { writeFile, rename, stat } from 'node:fs/promises';
+import { readFile, writeFile, rename } from 'node:fs/promises';
 import { ConfigError, UsageError } from "../shared/errors.js";
 import { redactDeep, redactHome } from "../shared/home.js";
-import { SKILLS_DIR } from "../schema/workspace.js";
+import { SANDBOX_MARK, SKILLS_DIR, SandboxMarkSchema } from "../schema/workspace.js";
 import { homedir } from 'node:os';
 import { dirname, isAbsolute, join, resolve } from 'node:path';
 import { CotutorConfigSchema, PATH_ROLES, ROLE_DEFAULTS, WORKSPACE_ROLES, explainIssues, } from "../schema/index.js";
@@ -136,11 +136,24 @@ export function resolvePaths(root, paths) {
             out[role] = expandPath(value, vault);
     return out;
 }
+/** 根下的 sandbox 标记(.cotutor/sandbox.json):没有 → null;坏了响亮报错(不当成真 workspace 静默往下跑) */
+export function readSandboxMark(root) {
+    const file = join(root, SANDBOX_MARK);
+    const raw = readJson(file);
+    if (raw === null)
+        return null;
+    const r = SandboxMarkSchema.safeParse(raw);
+    if (!r.success)
+        throw new ConfigError(file, explainIssues(r.error.issues).map((l) => `  - ${l}`).join('\n'));
+    return r.data;
+}
 export function assembleWorkspace(root, source, config) {
+    const sandbox = readSandboxMark(root);
     return {
         root,
         source,
         config,
+        ...(sandbox ? { sandbox } : {}),
         paths: resolvePaths(root, config.paths),
         dirs: {
             agents: join(root, 'agents'),
@@ -178,6 +191,7 @@ export function workspaceReport(ws) {
         vault: ws.paths.vault,
         tutors: Object.keys(ws.config.tutors),
         runtime: ws.config.runtimes.default,
+        ...(ws.sandbox ? { sandbox: { from: ws.sandbox.from, forkedAt: ws.sandbox.forkedAt } } : {}),
     });
 }
 // ---- cotutor.json 的补丁写回与热重载(从 runtime/journal/store.ts 搬来,2026-10-29) ----
@@ -233,13 +247,22 @@ export async function patchConfig(ws, patch, opts = {}) {
     await rename(tmp, ws.files.config);
     return r.data;
 }
-/** 文件改了(页面写的、或家长在编辑器改的)就重读;坏了抛 ConfigError,调用方决定是留旧的还是响 */
-export async function reloadIfChanged(ws, lastMtime) {
-    const st = await stat(ws.files.config);
-    if (st.mtimeMs === lastMtime)
-        return { ws, mtime: lastMtime };
-    const raw = readJson(ws.files.config);
-    if (raw === null)
+/**
+ * 文件内容变了(页面写的、或家长在编辑器改的)就重读;坏了抛 ConfigError,调用方决定是留旧的还是响。
+ * 比原文不比修改时间:Windows 上写 .tmp 再 rename 连写两次,修改时间常常一模一样(10-31 实测 200 次里 105 次);文件只有几 K,每次读一遍不贵。
+ */
+export async function reloadIfChanged(ws, lastText) {
+    const text = await readFile(ws.files.config, 'utf8').catch(() => null);
+    if (text === null)
         throw new ConfigError(ws.files.config, '不存在了');
-    return { ws: assembleWorkspace(ws.root, ws.source, parseConfig(raw, ws.files.config)), mtime: st.mtimeMs };
+    if (text === lastText)
+        return { ws, text };
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch (err) {
+        throw new ConfigError(ws.files.config, `不是合法 JSON:${err instanceof Error ? err.message : String(err)}`);
+    }
+    return { ws: assembleWorkspace(ws.root, ws.source, parseConfig(raw, ws.files.config)), text };
 }

package/dist/app/ws/route.d.ts

@@ -18,8 +18,14 @@ export interface LiveRouteDeps {
     echoWaitMs?: number;
     ringMs?: number;
     stallMs?: number;
+    idleCutMs?: number;
+    maxTakeMs?: number;
     onFinished?(tutor: string, why: string): void;
 }
-export declare function makeLiveUpgrade(deps?: LiveRouteDeps): (req: IncomingMessage, socket: Duplex, head: Buffer, ctx: LiveApp) => Promise<boolean>;
+/** 接升级的函数;openCalls = 现在开着几通(serve 看它定这台电脑能不能睡) */
+export type LiveUpgrade = ((req: IncomingMessage, socket: Duplex, head: Buffer, ctx: LiveApp) => Promise<boolean>) & {
+    openCalls(): number;
+};
+export declare function makeLiveUpgrade(deps?: LiveRouteDeps): LiveUpgrade;
 /** 探针:COTUTOR_LIVE_ENDPOINT 指到假百炼 */
-export declare const liveUpgrade: (req: IncomingMessage, socket: Duplex, head: Buffer, ctx: LiveApp) => Promise<boolean>;
+export declare const liveUpgrade: LiveUpgrade;

package/dist/app/ws/route.js

@@ -3,7 +3,8 @@ import { acceptWebSocket, isUpgrade } from "./ws.js";
 import { cookieOf } from "../http/access.js";
 import { DEVICE_COOKIE } from "../../schema/kid-device.js";
 export function makeLiveUpgrade(deps = {}) {
-    return async function liveUpgrade(req, socket, head, ctx) {
+    const open = new Set();
+    const liveUpgrade = async function liveUpgrade(req, socket, head, ctx) {
         const m = /^\/api\/live\/([a-z0-9][a-z0-9-]*)\/ws(?:\?.*)?$/.exec(req.url ?? '');
         if (!m || !isUpgrade(req))
             return false;
@@ -20,10 +21,13 @@ export function makeLiveUpgrade(deps = {}) {
             onClose: () => call?.onSocketClose(),
         });
         const listen = new URL(req.url ?? '', 'http://x').searchParams.get('listen') === 'open' ? 'open' : 'hold';
-        call = new LiveCall(sock, { ctx, tutor, deviceId: cookieOf(req.headers.cookie, DEVICE_COOKIE), listen, endpoint: deps.endpoint, env: deps.env, heartbeatMs: deps.heartbeatMs, keepAliveMs: deps.keepAliveMs, swapTokens: deps.swapTokens, idleSwapMs: deps.idleSwapMs, echoWaitMs: deps.echoWaitMs, ringMs: deps.ringMs, stallMs: deps.stallMs, onFinished: (why) => deps.onFinished?.(tutor, why) });
+        call = new LiveCall(sock, { ctx, tutor, deviceId: cookieOf(req.headers.cookie, DEVICE_COOKIE), listen, endpoint: deps.endpoint, env: deps.env, heartbeatMs: deps.heartbeatMs, keepAliveMs: deps.keepAliveMs, swapTokens: deps.swapTokens, idleSwapMs: deps.idleSwapMs, echoWaitMs: deps.echoWaitMs, ringMs: deps.ringMs, stallMs: deps.stallMs, idleCutMs: deps.idleCutMs, maxTakeMs: deps.maxTakeMs, onFinished: (why) => { if (call)
+                open.delete(call); deps.onFinished?.(tutor, why); } });
+        open.add(call);
         void call.start();
         return true;
     };
+    return Object.assign(liveUpgrade, { openCalls: () => open.size });
 }
 /** 探针:COTUTOR_LIVE_ENDPOINT 指到假百炼 */
-export const liveUpgrade = makeLiveUpgrade(process.env.COTUTOR_LIVE_ENDPOINT ? { endpoint: process.env.COTUTOR_LIVE_ENDPOINT, env: { ...process.env, DASHSCOPE_API_KEY: process.env.DASHSCOPE_API_KEY ?? 'sk-probe' } } : {});
+export const liveUpgrade = makeLiveUpgrade(process.env.COTUTOR_LIVE_ENDPOINT ? { endpoint: process.env.COTUTOR_LIVE_ENDPOINT } : {});

package/dist/board/parse.d.ts

@@ -78,8 +78,6 @@ export declare function playsLecture(line: {
     cues?: readonly BoardCue[];
 }, cards: readonly BoardCard[]): boolean;
 export declare function parseBoard(text: string, opts?: ParseBoardOptions): ParsedBoard;
-/** 回复停在写成正文的工具调用上(后面只剩空行):老师在等工具的结果,这一轮其实没写完(runner 据此 resume 一次) */
-export declare function endsWithToolCall(text: string): boolean;
 /** 原文一行的角色:解析器把它当什么了 */
 export type SourceRole = 
 /** 讲稿一句(念出来) */

package/dist/board/parse.js

@@ -247,12 +247,6 @@ export function parseBoard(text, opts = {}) {
         },
     };
 }
-/** 回复停在写成正文的工具调用上(后面只剩空行):老师在等工具的结果,这一轮其实没写完(runner 据此 resume 一次) */
-export function endsWithToolCall(text) {
-    const { spans } = parseBoard(text);
-    const last = spans.toolCalls[spans.toolCalls.length - 1];
-    return Boolean(last) && text.split('\n').slice(last[1] + 1).every((l) => !l.trim());
-}
 const SECTION_HEAD = /^##\s+(.+?)\s*$/;
 /**
  * 家长端「看原文」用:把老师原文的每一行标上解析器怎么读的。

package/dist/board/presentation.d.ts

@@ -152,7 +152,7 @@ export interface BoardMessage {
     reply: string | null;
     pending: boolean;
     section?: BoardSection | null;
-    /** 孩子这条带的作业照片(相对 workspace 根;R5):节头上回显缩略图 */
+    /** 孩子这条带的作业照片(相对 workspace 根):答拍给我看卡的进那张卡;别的由老师用 image 卡放上板 */
     photos?: string[];
     /** 看完小课堂后的第一条:这一节前面是小课堂卡 */
     lecture?: KidLecture;
@@ -163,14 +163,14 @@ export interface BoardMessage {
     /** 按住说话的(索引里带 voice):板上去口头禅、一行截断 */
     /** 首页按钮发的:按钮上的字,不是孩子说的 */
     fromHome?: boolean;
-    /** 实时的一轮(讲稿嘴照念,不配音) */
+    /** 实时的一轮(讲稿嘴照念):板上不看它,一律照实时的画(2026-11-04);只给字幕重放、录像用 */
     live?: boolean;
 }
 /** 板上孩子的一句话:text 是显示的(语音去了口头禅),full 是原话 */
 export interface KidSaid {
     text: string;
     full: string;
-    /** 答拍给我看卡时拍来的照片:进那张卡的答案栏,节头不再回显 */
+    /** 答拍给我看卡时拍来的照片:放大放在那张卡里(2026-11-04 之前缩在卡下沿) */
     photos?: string[];
 }
 export interface BoardEntry extends BoardSection {
@@ -178,27 +178,23 @@ export interface BoardEntry extends BoardSection {
     at?: string;
     /** 老师还在说:卡只增不改;前 ready 拍就绪了就能播(2026-09-13 之前是整轮跑完才播);整轮跑完换成正式的一节 */
     partial?: boolean;
-    /** 孩子问这节时拍的照片(节头上回显) */
-    photos?: string[];
     /** 这一节答的是看完小课堂后的第一问:节前画小课堂卡 */
     lecture?: KidLecture;
     /** 这一节答的是孩子从纸上交的画:节前一张孩子的画卡 */
     drawing?: KidDrawing;
-    /** 孩子引出这一节的那句话;saidOn = 它答的是哪一节的哪张问题卡(写进那张卡的答案栏),没有 = 在这一节开头单独一行。实时的节头不是它(看 head),它只给左栏用 */
+    /** 孩子引出这一节的那句话;saidOn = 它答的是哪一节的哪张问题卡。节头不是它(看 head):它给左栏用,答拍给我看卡的还进那张卡 */
     said?: KidSaid;
     saidOn?: {
         job: string;
         card: number;
     };
-    /** 实时的一轮:卡闭合了就铺(不按拍);不出卡的板上留讲稿的字 */
-    live?: true;
-    /** 实时:这一轮开头是脑写的节头(只有一行 # 标题的文字卡),从这里起新的一件事,head 是它的标题(liveHead) */
+    /** 这一轮开头是脑写的节头(只有一行 # 标题的文字卡),从这里起新的一件事,head 是它的标题(liveHead) */
     head?: string;
-    /** 实时:这一轮开头没写节头,接着上一节画 */
+    /** 这一轮开头没写节头,接着上一节画 */
     cont?: true;
 }
 /**
- * 实时的一节怎么接:新一节的开头由脑定,不再机械是孩子那句。
+ * 一节怎么接(板上只有实时一种画法,2026-11-04;以前的话题也这样画):新一节的开头由脑定,不再机械是孩子那句。
  * 这一轮第一张卡是节头 → head;没写(只有讲稿、开头是别的卡、还没写出卡)→ cont,接着上一节。一轮中间的节头卡,是从那张卡起新一节
  */
 export declare function liveHead(s: Pick<BoardSection, 'cards'>): {
@@ -225,7 +221,7 @@ export declare function kidSaid(messages: readonly BoardMessage[]): Map<string,
 }>;
 /**
  * 孩子端条目 → 板书节(没有 section 的条目不出节);
- * 孩子的话挂在它引出的那一节上(said / saidOn,kidSaid);还在跑的只有带 partial 板书(流式,已有卡或已有配好的句;实时的有句就算)才出节且标 partial,其余不出。
+ * 孩子的话挂在它引出的那一节上(said / saidOn,kidSaid);还在跑的只有带 partial 板书(流式,已有卡或已有句)才出节且标 partial,其余不出。
  */
 export declare function sectionsFromMessages(messages: readonly BoardMessage[]): BoardEntry[];
 /** 一节在目录里的名字:小节标题 > 有名字的文字卡 > 第一张有字的卡 > 第一句讲稿;截到 14 个字 */
@@ -269,13 +265,11 @@ export type PlayerEvent = {
     type: 'fresh';
     sections: number[];
 };
-/** stop 只停声音(卡的点读、单词);paint = 把某节的标注画齐;showNow = 选中态照现在的位置;scrollLast = 滚到最后一节 */
+/** stop 只停声音(卡的点读、单词);paint = 把某节的标注画齐;scrollLast = 滚到最后一节。板上不描「念到哪张」(卡和讲稿不同步,2026-11-04 起以前的话题也这样) */
 export type PlayerEffect = {
     kind: 'stop';
 } | {
     kind: 'render';
-} | {
-    kind: 'showNow';
 } | {
     kind: 'paint';
     section: number;

package/dist/board/presentation.js

@@ -433,7 +433,7 @@ export function isQuestion(text) {
     return t.endsWith('?') || t.endsWith('？');
 }
 /**
- * 实时的一节怎么接:新一节的开头由脑定,不再机械是孩子那句。
+ * 一节怎么接(板上只有实时一种画法,2026-11-04;以前的话题也这样画):新一节的开头由脑定,不再机械是孩子那句。
  * 这一轮第一张卡是节头 → head;没写(只有讲稿、开头是别的卡、还没写出卡)→ cont,接着上一节。一轮中间的节头卡,是从那张卡起新一节
  */
 export function liveHead(s) {
@@ -488,16 +488,16 @@ export function kidSaid(messages) {
 }
 /**
  * 孩子端条目 → 板书节(没有 section 的条目不出节);
- * 孩子的话挂在它引出的那一节上(said / saidOn,kidSaid);还在跑的只有带 partial 板书(流式,已有卡或已有配好的句;实时的有句就算)才出节且标 partial,其余不出。
+ * 孩子的话挂在它引出的那一节上(said / saidOn,kidSaid);还在跑的只有带 partial 板书(流式,已有卡或已有句)才出节且标 partial,其余不出。
  */
 export function sectionsFromMessages(messages) {
     const out = [];
     const says = kidSaid(messages);
     for (const m of messages) {
         const k = says.get(m.job);
-        const at = { ...(m.at ? { at: m.at } : {}), ...(m.photos?.length && !k?.said.photos ? { photos: m.photos } : {}), ...(m.lecture ? { lecture: m.lecture } : {}), ...(m.drawing ? { drawing: m.drawing } : {}), ...(k ? { said: k.said, ...(k.on ? { saidOn: k.on } : {}) } : {}), ...(m.live ? { live: true, ...liveHead(m.section ?? { cards: [] }) } : {}) };
+        const at = { ...(m.at ? { at: m.at } : {}), ...(m.lecture ? { lecture: m.lecture } : {}), ...(m.drawing ? { drawing: m.drawing } : {}), ...(k ? { said: k.said, ...(k.on ? { saidOn: k.on } : {}) } : {}), ...liveHead(m.section ?? { cards: [] }) };
         if (m.pending) {
-            if (m.section && m.section.partial && (m.section.cards.length || (m.live && m.section.lines.length)))
+            if (m.section && m.section.partial && (m.section.cards.length || m.section.lines.length))
                 out.push({ job: m.job, ...at, cards: m.section.cards, lines: m.section.lines, partial: true, ready: m.section.ready ?? 0, ...(m.section.layout ? { layout: m.section.layout } : {}) });
             continue;
         }
@@ -558,7 +558,7 @@ export function step(model, ev, ctx) {
         case 'liveStart':
             fx.push({ kind: 'paint', section: ev.section });
             m = { state: { section: ev.section, line: -1, status: 'thinking' } };
-            fx.push({ kind: 'render' }, { kind: 'showNow' });
+            fx.push({ kind: 'render' });
             break;
         case 'liveBeat':
             if (m.state.section !== ev.section || m.state.status !== 'thinking')
@@ -569,12 +569,10 @@ export function step(model, ev, ctx) {
             fx.push({ kind: 'paint', section: ev.section });
             if (m.state.section !== ev.section)
                 break;
-            if (m.state.status !== 'thinking') {
-                fx.push({ kind: 'showNow' });
+            if (m.state.status !== 'thinking')
                 break;
-            }
             m = { state: playerAtEnd(secs) };
-            fx.push({ kind: 'render' }, { kind: 'showNow' });
+            fx.push({ kind: 'render' });
             break;
         case 'liveDropped':
             fx.push({ kind: 'stop' });
@@ -587,7 +585,7 @@ export function step(model, ev, ctx) {
             for (const i of ev.sections)
                 fx.push({ kind: 'paint', section: i });
             m = { state: playerAtEnd(secs) };
-            fx.push({ kind: 'render' }, { kind: 'showNow' }, { kind: 'scrollLast' });
+            fx.push({ kind: 'render' }, { kind: 'scrollLast' });
             break;
     }
     return { model: m, effects: fx };

package/dist/brain/api-tools.js

@@ -137,8 +137,9 @@ export function readOnlyTools(roots, opts = {}) {
     const relOf = async (p) => {
         for (const root of await realRoots()) {
             const rel = relative(root, p);
+            // 模型给的通配按 / 写(如 随便/*期中*.md),Windows 上 relative 给的是反斜杠
             if (!outside(rel))
-                return rel;
+                return rel.split(sep).join('/');
         }
         return p;
     };

package/dist/brain/api.d.ts

@@ -1,57 +1,52 @@
 import { type ModelMessage } from 'ai';
-import type { CliEvent } from './cli/types.ts';
-import { type RunPlan } from './cli/run-plan.ts';
+import { type RunPlan } from './runtime.ts';
 import { type ApiRuntime, type CotutorConfig, type Policy } from '../schema/index.ts';
-import type { BrainHooks, BrainRequest, BrainRun, WarmKey } from './index.ts';
+import type { BrainHooks, BrainRequest, BrainRun } from './index.ts';
 /** 计划里记的 cli 名:API 的轮次按它分流 */
 export declare const API_CLI = "api";
 /**
  * 出厂的 API 运行时(2026-10-31 起新装缺省 api,Qwen Code 那两条留作备用):模型同那两条——api 对 qwen(qwen3.8-max),api-flash 对 qwen-flash(qwen3.8-flash)
  */
 export declare const FACTORY_API_RUNTIMES: Record<string, ApiRuntime>;
-/** .log 的一行 → 统一事件(API 轮次的日志就是一行一条统一事件);不是这种行回 [] */
-export declare function parseEventLine(line: string): CliEvent[];
 /** 政策 effort → 思考开关与思考量(同 qwen:low 不想,孩子在等;带工具的轮次至少想一点,不然照片题连资料都不查) */
 export declare function thinkingOf(effort: Policy['effort'] | undefined, tools: BrainRequest['tools']): {
     enableThinking: boolean;
     thinkingBudget?: number;
 };
 /**
- * 有思考档的模型照 qwen 运行时发 reasoning_effort(src/brain/cli/qwen.ts 的 EFFORT):想一点 = low、不限 = xhigh;不想或没有档 → null,照 thinkingOf 发。
+ * 有思考档的模型发 reasoning_effort(照当时 Qwen Code 的档):想一点 = low、不限 = xhigh;不想或没有档 → null,照 thinkingOf 发。
  * low 是它自己看着想:闲聊想一两百 token,认照片题想得多;thinking_budget 是死卡,1024 时有照片的话题每轮都想满(2026-10-31)
  */
 export declare function effortOf(model: string, effort: Policy['effort'] | undefined, tools: BrainRequest['tools']): 'low' | 'xhigh' | null;
 /** AI SDK 的 alibaba 只认 thinking_budget:在 fetch 这一层把请求体里的换成 reasoning_effort(SDK 给的中间件口子) */
 export declare function effortFetch(effort: 'low' | 'xhigh', base?: typeof fetch): typeof fetch;
-/**
- * 百炼 Chat Completions 的端点:知道业务空间 id 就走它的域名(原型验过,同 realtime);只有按量 key 就走公网域名(qwen 那边按量的线也走它,2026-10-29 真跑通)
- */
-export declare function bailianBase(workspaceId: string | null): string;
 /**
  * 已经结束的一轮,拼回历史时的老师那条:正文照原样,思考不带,工具往返换成一句「(用了 …,回了 N 字;结果这里不再带,要看再查)」。
  * 只剩一条纯文字的回复,历史里永远没有配不上对的工具消息
  */
 export declare function slimTurn(messages: readonly ModelMessage[]): string;
+/** 这个模型发到哪、带哪把 key(src/shared/qianwen.ts 的 compatibleLine);null = 没配 */
+export type BrainLine = (model: string) => {
+    baseURL: string;
+    key: string;
+    plan: boolean;
+} | null;
 export declare class ApiBrain {
     private readonly workspace;
-    private readonly auth;
-    /** 测试与探针:…/compatible-mode/v1(假百炼);不给按业务空间 id 拼 */
+    private readonly line;
+    /** 测试与探针:…/compatible-mode/v1(假百炼);不给按模型选线 */
     private readonly endpoint;
     constructor(opts: {
         workspace: () => {
             config: CotutorConfig;
             root: string;
         };
-        auth: () => {
-            key: string;
-            workspaceId: string | null;
-        } | null;
+        line: BrainLine;
         endpoint?: string;
     });
     plan(req: BrainRequest): RunPlan;
     start(req: BrainRequest, plan: RunPlan, ctx: {
         tutor: string;
-        key: WarmKey;
         files: {
             log: string;
             err: string;