cotutor 0.3.0 → 0.4.1

package/dist/app/http/parent-home.d.ts

@@ -8,8 +8,10 @@
  *   PUT   /api/parent/home/tutors/<老师>/dictation   {words: [{chars, say?}]} 这周的词;[] = 删掉
  *   PUT   /api/parent/home/order                    {tutors: [老师…]} 老师的先后(排第一的进首页时在最前)
  *   PATCH /api/parent/settings                      {tutors?: {<老师>: {extras?: [..] | null, hidden?}}, talk?: {note?, minutes?}}
+ *   GET   /api/parent/qr                            孩子端与家长端地址的二维码(各有主机名一张、局域网 IP 一张)、是不是 HTTPS、孩子的设备连过几台、上次什么时候;服务没在听(测试走 route)→ {ready: false}
  */
 import { type DictationLang, type TutorButton } from '../../board/cards/index.ts';
+import { type HomeTileId } from '../../schema/index.ts';
 import type { AppContext, RouteResult } from './app.ts';
 export interface ParentHomeTutor {
     name: string;
@@ -20,6 +22,13 @@ export interface ParentHomeTutor {
     /** 卡上的常驻入口(按学科补过缺省的);extrasSet = cotutor.json 里写的(没写 = null,走缺省) */
     extras: string[];
     extrasSet: string[] | null;
+    /** 常驻的方砖(HOME_TILES 的先后):家里有那个 activity 文件的才列;on = 没关掉,usable = 文件检查过得去(写坏了孩子端不出) */
+    tiles: {
+        id: HomeTileId;
+        label: string;
+        on: boolean;
+        usable: boolean;
+    }[];
     /** 首页里这位老师的按钮(文件里的,带讲法与留到) */
     buttons: TutorButton[];
     /** 这周的词:写了这位老师的听写卡;没有 = null */
@@ -32,6 +41,11 @@ export interface ParentHomeTutor {
     lang: DictationLang;
     /** 学科色(src/ui/shared/tutor-color.ts) */
     color: string;
+    /** 「样子与声音」那一行:说话的声音、点读的声音叫什么(点开见 ./parent-look.ts);点读没配 = null */
+    voices: {
+        mouth: string;
+        card: string | null;
+    };
 }
 export declare function parentHome(ctx: AppContext): Promise<Record<string, unknown>>;
 export declare function parentHomeRoute(method: string, p: string, ctx: AppContext, body: unknown): Promise<RouteResult | null>;

package/dist/app/http/parent-home.js

@@ -8,19 +8,33 @@
  *   PUT   /api/parent/home/tutors/<老师>/dictation   {words: [{chars, say?}]} 这周的词;[] = 删掉
  *   PUT   /api/parent/home/order                    {tutors: [老师…]} 老师的先后(排第一的进首页时在最前)
  *   PATCH /api/parent/settings                      {tutors?: {<老师>: {extras?: [..] | null, hidden?}}, talk?: {note?, minutes?}}
+ *   GET   /api/parent/qr                            孩子端与家长端地址的二维码(各有主机名一张、局域网 IP 一张)、是不是 HTTPS、孩子的设备连过几台、上次什么时候;服务没在听(测试走 route)→ {ready: false}
  */
 import { DICTATION_EN_MAX, DICTATION_WORD_MAX, DICTATION_WORDS_MAX, TUTOR_BUTTONS_MAX, TutorButtonSchema, dictationWordLang } from "../../board/cards/index.js";
+import { existsSync } from 'node:fs';
 import { localDate } from "../../shared/time.js";
 import { orderTutors, setTutorButtons, setTutorDictation } from "../../runtime/home/edit.js";
-import { AGENT_NAME_RE, TUTOR_EXTRAS, subjectLang, tutorExtras } from "../../schema/index.js";
-import { editPublished, readPublished } from "../../runtime/home/store.js";
+import { AGENT_NAME_RE, HOME_TILES, HOME_TILE_IDS, TUTOR_EXTRAS, cardVoice, mouthVoice, subjectLang, tutorExtras, tutorTiles } from "../../schema/index.js";
+import { findActivityFile } from "../../runtime/activities.js";
+import { REALTIME_VOICES } from "../../realtime/voices.js";
+import { TTS_VOICES } from "../../media/tts.js";
+import { editPublished, readPublished, usableActivity } from "../../runtime/home/store.js";
 import { patchConfig } from "../workspace.js";
 import { tutorColors } from "../../ui/shared/tutor-color.js";
 import { wordEmoji } from "../../ui/kid/word-emoji.js";
+import { shownAvatar } from "./avatars.js";
+import { qrNotes, qrSvg } from "../../ui/shared/qr-svg.js";
+import { readDevices } from "../../runtime/journal/kid-log.js";
 const isObj = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
 const bad = (message) => ({ status: 400, json: { error: 'bad_request', message } });
 /** 家长端列的老师:有脸的(-tutor 结尾)、开着的;藏着的也列(家长要能把他放回首页) */
 const faceTutors = (c) => Object.entries(c.tutors).filter(([n, t]) => n.endsWith('-tutor') && t.enabled).map(([n]) => n);
+/** 音色 id → 官方的中文名(没在表里的照写 id) */
+function voiceNames(c, name) {
+    const mouth = mouthVoice(c.live, name);
+    const card = cardVoice(c.tutors, name);
+    return { mouth: REALTIME_VOICES.find((v) => v.voice === mouth)?.name ?? mouth, card: card ? (TTS_VOICES.find((v) => v.voice === card)?.name ?? card) : null };
+}
 export async function parentHome(ctx) {
     const c = ctx.ws.config;
     const { home } = await readPublished(ctx.ws);
@@ -30,6 +44,19 @@ export async function parentHome(ctx) {
     // 先后 = 首页里老师卡的先后,没写卡的照 cotutor.json 的顺序排在后面
     const written = cards.filter((x) => x.kind === 'tutor').map((x) => String(x.props.tutor)).filter((n, i, a) => names.includes(n) && a.indexOf(n) === i);
     const order = [...written, ...names.filter((n) => !written.includes(n))];
+    const tilesOf = async (name) => {
+        const on = tutorTiles(c.tutors[name]);
+        const out = [];
+        for (const t of HOME_TILES) {
+            if (!existsSync(findActivityFile(ctx.ws.root, name, t.activity)))
+                continue;
+            out.push({ id: t.id, label: t.activity, on: on.includes(t.id), usable: Boolean(await usableActivity(ctx.ws, name, t.activity)) });
+        }
+        return out;
+    };
+    const tiles = new Map();
+    for (const name of order)
+        tiles.set(name, await tilesOf(name));
     const tutors = order.map((name) => {
         const t = c.tutors[name];
         const card = cards.find((x) => x.kind === 'tutor' && x.props.tutor === name);
@@ -37,15 +64,17 @@ export async function parentHome(ctx) {
         return {
             name,
             display: t.display,
-            avatar: t.avatar ?? null,
+            avatar: shownAvatar(t),
             subject: t.subject ?? null,
             hidden: t.hidden,
             extras: tutorExtras(t, c.talk.enabled),
             extrasSet: t.extras ?? null,
+            tiles: tiles.get(name) ?? [],
             buttons: (card?.props.buttons ?? []),
             dictation: dict ? (dict.props.words ?? []) : null,
             lang: subjectLang(t.subject),
             color: colors[name],
+            voices: voiceNames(c, name),
         };
     });
     return {
@@ -107,7 +136,7 @@ async function withEmoji(ctx, name, words) {
                     had.set(w.chars, w.emoji);
     const ask = [...new Set(words.map((w) => w.chars).filter((w) => !had.has(w)))];
     const fake = process.env.COTUTOR_EMOJI_ENDPOINT;
-    const got = ask.length ? await wordEmoji(ask, fake ? { endpoint: fake, env: { DASHSCOPE_API_KEY: 'sk-fake' } } : {}) : {};
+    const got = ask.length ? await wordEmoji(ask, fake ? { endpoint: fake } : {}) : {};
     return words.map((w) => { const e = had.get(w.chars) ?? got[w.chars]; return e ? { ...w, emoji: e } : w; });
 }
 /** 发布的结果:有「要改」的不发,把检查说的回给页面 */
@@ -116,9 +145,25 @@ function published(r) {
         return { status: 400, json: { error: 'home_check', message: r.check.issues.filter((i) => i.level === 'fix').map((i) => i.text).join(';') || '首页检查没过' } };
     return { status: 200, json: { ok: true, home: r?.home ? { id: r.home.id, publishedAt: r.home.publishedAt } : null, changed: Boolean(r) } };
 }
+/** 首页上「扫码打开」那块:孩子的平板一张(孩子端 /)、家长自己的手机一张(家长端 /parent);编什么地址由服务端定(同 /parent/qr,不看请求的 Host);连过的设备拿来定这块缺省开着还是收着 */
+async function kidQr(ctx) {
+    const info = ctx.listen?.() ?? null;
+    if (!info)
+        return { ready: false };
+    const devices = Object.values(await readDevices(ctx.ws));
+    const last = devices.map((d) => d.last).sort().at(-1) ?? null;
+    const parent = { url: `${info.name}parent`, ip: info.ip ? `${info.ip}parent` : null };
+    return {
+        ready: true, https: info.https, url: info.name, svg: qrSvg(info.name), ip: info.ip, svgIp: info.ip ? qrSvg(info.ip) : null,
+        parent: { ...parent, svg: qrSvg(parent.url), svgIp: parent.ip ? qrSvg(parent.ip) : null },
+        notes: qrNotes(info.https).slice(1), devices: devices.length, last,
+    };
+}
 export async function parentHomeRoute(method, p, ctx, body) {
     if (p === '/api/parent/home' && method === 'GET')
         return { status: 200, json: await parentHome(ctx) };
+    if (p === '/api/parent/qr' && method === 'GET')
+        return { status: 200, json: await kidQr(ctx) };
     const names = faceTutors(ctx.ws.config);
     const tb = /^\/api\/parent\/home\/tutors\/([^/]+)\/(buttons|dictation)$/.exec(p);
     if (tb) {
@@ -150,6 +195,9 @@ export async function parentHomeRoute(method, p, ctx, body) {
         return published(await editPublished(ctx.ws, (md) => orderTutors(md, list), ctx.now()));
     }
     if (p === '/api/parent/settings') {
+        // 设置页(/parent/settings)读的:孩子的平板上按住说话那一栏放哪边(kid.hand;缺省 right = 栏在左边)
+        if (method === 'GET')
+            return { status: 200, json: { title: ctx.ws.config.title, hand: ctx.ws.config.kid.hand ?? 'right' } };
         if (method !== 'PATCH')
             return { status: 405, json: { error: 'method_not_allowed' } };
         if (!isObj(body))
@@ -157,7 +205,7 @@ export async function parentHomeRoute(method, p, ctx, body) {
         const patch = {};
         if (body.tutors !== undefined) {
             if (!isObj(body.tutors))
-                return bad('tutors 要 {<老师>: {extras?, hidden?}}');
+                return bad('tutors 要 {<老师>: {extras?, hidden?, tiles?}}');
             const tp = {};
             for (const [name, v] of Object.entries(body.tutors)) {
                 if (!names.includes(name) || !AGENT_NAME_RE.test(name) || !isObj(v))
@@ -173,6 +221,15 @@ export async function parentHomeRoute(method, p, ctx, body) {
                         return bad('hidden 要 true / false');
                     one.hidden = v.hidden;
                 }
+                // 方砖:{preview?: true/false, …};cotutor.json 只记关掉的(开 = 删掉那一项)
+                if (v.tiles !== undefined) {
+                    if (!isObj(v.tiles) || Object.entries(v.tiles).some(([k, x]) => !HOME_TILE_IDS.includes(k) || typeof x !== 'boolean'))
+                        return bad(`tiles 要 {${HOME_TILE_IDS.join(' / ')}: true / false}`);
+                    const off = { ...(ctx.ws.config.tutors[name].tiles ?? {}), ...Object.fromEntries(Object.entries(v.tiles).map(([k, x]) => [k, x ? undefined : false])) };
+                    const left = Object.entries(off).filter(([, x]) => x === false);
+                    // 全开着 = 整个 tiles 删掉(null);不然只留关掉的那几项(开了的写 null 删掉)
+                    one.tiles = left.length ? Object.fromEntries(Object.keys(off).map((k) => [k, off[k] === false ? false : null])) : null;
+                }
                 tp[name] = one;
             }
             patch.tutors = tp;
@@ -190,8 +247,14 @@ export async function parentHomeRoute(method, p, ctx, body) {
                 t.minutes = body.talk.minutes;
             patch.talk = t;
         }
+        // 孩子的平板(设置页):只收 kid.hand;缺省的 right 不写进文件
+        if (body.kid !== undefined) {
+            if (!isObj(body.kid) || Object.keys(body.kid).some((k) => k !== 'hand') || (body.kid.hand !== 'left' && body.kid.hand !== 'right'))
+                return bad('kid 只收 {hand: left / right}');
+            patch.kid = { hand: body.kid.hand === 'left' ? 'left' : null };
+        }
         try {
-            await patchConfig(ctx.ws, patch, { also: ['talk'] });
+            await patchConfig(ctx.ws, patch, { also: ['talk', 'kid'] });
         }
         catch (err) {
             return bad(err instanceof Error ? err.message : String(err));

package/dist/app/http/parent-look.d.ts

@@ -0,0 +1,2 @@
+import type { AppContext, RouteResult } from './app.ts';
+export declare function parentLookRoute(method: string, p: string, url: URL, ctx: AppContext, body: unknown): Promise<RouteResult | null>;

package/dist/app/http/parent-look.js

@@ -0,0 +1,151 @@
+/**
+ * 家长端「样子与声音」(家长端首页点一位老师的那一行):头像、说话的声音(嘴,全部 56 个)、点读的声音(卡的配音,全部 597 个),点了就存。
+ * 声音全给,页面上点「换一个」开弹窗挑:搜、按男女 / 口音 / 中英 / 年纪 / 场景筛;现在用的排最前、出厂的那个标出来。头像与声音只在这里改(工作台不重复);别的头像直接写 cotutor.json。
+ *
+ *   GET  /api/parent/tutors/<老师>/look                          现在用的与可选的(头像、嘴、卡的配音)
+ *   PUT  /api/parent/tutors/<老师>/look                          {avatar?: string | null, mouth?: string, voice?: string};回 GET 那份
+ *   GET  /api/parent/tutors/<老师>/look/avatar?k=factory|image   选项里那两张图:包里的出厂头像、workspace 里 figshot 画的
+ *   GET  /api/parent/tutors/<老师>/look/preview?kind=mouth|card&voice=…   试听,念的句子服务端定(./voice-preview.ts,有缓存)
+ *
+ * 头像只收选项里的值(不让页面往 cotutor.json 写任意路径);avatar null = 用出厂的(三门主科是木钉娃娃,别的显示学科首字)。
+ * 挑回出厂的那个声音就删掉那一项,cotutor.json 里不留和缺省一样的值。
+ */
+import { existsSync } from 'node:fs';
+import { join, resolve, sep } from 'node:path';
+import { REALTIME_VOICES, isRealtimeVoice } from "../../realtime/voices.js";
+import { TTS_VOICES } from "../../media/tts.js";
+import { SHIPPED_CARD_VOICES, SHIPPED_MOUTHS, canonicalSubject, cardVoice, mouthVoice } from "../../schema/index.js";
+import { patchConfig } from "../workspace.js";
+import { ownAvatar, subjectAvatarFile } from "./avatars.js";
+import { cardPreview, mouthPreview } from "./voice-preview.js";
+/** 不放 📚 🧮 🔤:旧版 init 写的出厂 emoji,当作没写(avatars.ts) */
+const EMOJI = ['📖', '✏️', '🌱', '🦉', '🐼', '⭐'];
+const IMAGE_RE = /\.(png|jpe?g|webp)$/i;
+/** 试听念的句子:学科的口吻 */
+const MOUTH_SAMPLE = { 语文: '你好呀,今天我们读哪一课?', 数学: '你好呀,今天想算点什么?', 英语: 'Hello! 今天我们学哪几个单词?' };
+const CARD_SAMPLE = { 语文: '小蝌蚪找妈妈', 数学: '二十八加十五等于四十三', 英语: 'apple, banana, orange' };
+const isObj = (v) => Boolean(v) && typeof v === 'object' && !Array.isArray(v);
+const bad = (message) => ({ status: 400, json: { error: 'bad_request', message } });
+/** 现在用的排最前,出厂的其次,别的照表里的先后 */
+const ranked = (all, current, shipped) => {
+    const rank = (v) => (v.voice === current ? 0 : v.voice === shipped ? 1 : 2);
+    return [...all].sort((a, b) => rank(a) - rank(b));
+};
+/** 表里十几种「某某型客服」并成一个场景,筛的时候不占一排 */
+const sceneOf = (scene) => (scene.endsWith('客服') ? '客服' : scene);
+function mouthOptions(c, name) {
+    const current = mouthVoice(c.live, name);
+    const known = REALTIME_VOICES.some((v) => v.voice === current) ? [] : [{ voice: current, name: current, gender: '', trait: '', lang: '普通话' }];
+    return ranked([...known, ...REALTIME_VOICES], current, SHIPPED_MOUTHS[name]).map((v) => {
+        // 表里的「(缺省)」是说 realtime 模型自己的缺省,家长用不着;「;中英夹着说……」拆成 warn
+        const [trait, extra = ''] = v.trait.replace(/\(缺省\)$/, '').split(';');
+        return { voice: v.voice, name: v.name, gender: v.gender, lang: v.lang, trait, ...(extra.includes('英文腔') ? { warn: '中英夹着说带英文腔' } : {}), shipped: SHIPPED_MOUTHS[name] === v.voice };
+    });
+}
+function cardOptions(c, name) {
+    const current = cardVoice(c.tutors, name);
+    const known = !current || TTS_VOICES.some((v) => v.voice === current) ? [] : [{ voice: current, name: current, gender: '', age: 0, trait: '', scene: '', lang: '中文' }];
+    return ranked([...known, ...TTS_VOICES], current, SHIPPED_CARD_VOICES[name]).map((v) => ({
+        voice: v.voice, name: v.name, gender: v.gender === '女' || v.gender === '男' ? v.gender : '', lang: v.lang, trait: v.trait,
+        ...(v.age ? { age: v.age } : {}), ...(v.scene ? { scene: sceneOf(v.scene) } : {}), shipped: SHIPPED_CARD_VOICES[name] === v.voice,
+    }));
+}
+/** figshot 画的图:现在用着的那张,或 workspace 里 avatars/<老师>.png 之类(换回别的以后还能选回来) */
+function imageAvatar(ctx, name) {
+    const own = ownAvatar(ctx.ws.config.tutors[name]);
+    if (own && IMAGE_RE.test(own))
+        return own;
+    for (const ext of ['png', 'webp', 'jpg'])
+        if (existsSync(join(ctx.ws.root, 'avatars', `${name}.${ext}`)))
+            return `avatars/${name}.${ext}`;
+    return null;
+}
+function avatarOptions(ctx, name) {
+    const t = ctx.ws.config.tutors[name];
+    const base = `/api/parent/tutors/${name}/look/avatar`;
+    const out = [];
+    if (subjectAvatarFile(t.subject))
+        out.push({ value: null, label: '木钉娃娃', img: `${base}?k=factory` });
+    const img = imageAvatar(ctx, name);
+    if (img)
+        out.push({ value: img, label: 'figshot 画的', img: `${base}?k=image` });
+    const ch = (t.subject || t.display || '?').slice(0, 1);
+    out.push({ value: ch, label: '学科字', text: ch });
+    for (const e of EMOJI)
+        out.push({ value: e, label: '', text: e });
+    return out;
+}
+function look(ctx, name) {
+    const c = ctx.ws.config;
+    const t = c.tutors[name];
+    const own = ownAvatar(t);
+    return {
+        tutor: { name, display: t.display },
+        // 没写的、写的值不在选项里(cotutor.json 里手填的)都照实给,页面只是哪格都不亮
+        avatar: { current: own, options: avatarOptions(ctx, name) },
+        mouth: { current: mouthVoice(c.live, name), options: mouthOptions(c, name) },
+        card: { current: cardVoice(c.tutors, name) ?? null, options: cardOptions(c, name) },
+    };
+}
+export async function parentLookRoute(method, p, url, ctx, body) {
+    const m = /^\/api\/parent\/tutors\/([a-z0-9][a-z0-9-]*)\/look(?:\/(avatar|preview))?$/.exec(p);
+    if (!m)
+        return null;
+    const [, name, sub] = m;
+    const t = ctx.ws.config.tutors[name];
+    if (!t || !name.endsWith('-tutor'))
+        return { status: 404, json: { error: 'no_such_tutor' } };
+    const subject = canonicalSubject(t.subject) ?? '';
+    if (sub === 'avatar') {
+        if (method !== 'GET')
+            return { status: 405, json: { error: 'method_not_allowed' } };
+        if (url.searchParams.get('k') === 'factory') {
+            const file = subjectAvatarFile(t.subject);
+            return file ? { status: 200, file, contentType: 'image/webp', cacheControl: 'max-age=86400' } : { status: 404, json: { error: 'not_found' } };
+        }
+        const rel = imageAvatar(ctx, name);
+        const file = rel ? resolve(ctx.ws.root, rel) : '';
+        if (!rel || !file.startsWith(ctx.ws.root + sep) || !existsSync(file))
+            return { status: 404, json: { error: 'not_found' } };
+        const ext = (IMAGE_RE.exec(rel)?.[1] ?? '').toLowerCase();
+        return { status: 200, file, contentType: ext === 'png' ? 'image/png' : ext === 'webp' ? 'image/webp' : 'image/jpeg', cacheControl: 'no-cache' };
+    }
+    if (sub === 'preview') {
+        if (method !== 'GET')
+            return { status: 405, json: { error: 'method_not_allowed' } };
+        const voice = url.searchParams.get('voice')?.trim() ?? '';
+        return url.searchParams.get('kind') === 'card' ? cardPreview(ctx.ws, voice, CARD_SAMPLE[subject] ?? CARD_SAMPLE.语文) : mouthPreview(ctx.ws, voice, MOUTH_SAMPLE[subject] ?? MOUTH_SAMPLE.语文);
+    }
+    if (method === 'GET')
+        return { status: 200, json: look(ctx, name) };
+    if (method !== 'PUT')
+        return { status: 405, json: { error: 'method_not_allowed' } };
+    if (!isObj(body))
+        return bad('要 {avatar?, mouth?, voice?}');
+    const tutor = {};
+    const patch = { tutors: { [name]: tutor } };
+    if ('avatar' in body) {
+        const ok = avatarOptions(ctx, name).some((o) => o.value === body.avatar);
+        if (!ok)
+            return bad('头像只能从给的几个里挑;别的(图片路径、别的 emoji)直接写 cotutor.json');
+        tutor.avatar = body.avatar;
+    }
+    if (body.mouth !== undefined) {
+        if (typeof body.mouth !== 'string' || !isRealtimeVoice(body.mouth))
+            return bad(`说话的声音不认「${String(body.mouth)}」`);
+        patch.live = { voices: { [name]: body.mouth === SHIPPED_MOUTHS[name] ? null : body.mouth } };
+    }
+    if (body.voice !== undefined) {
+        if (typeof body.voice !== 'string' || !TTS_VOICES.some((v) => v.voice === body.voice))
+            return bad(`点读的声音不认「${String(body.voice)}」`);
+        tutor.voice = body.voice === SHIPPED_CARD_VOICES[name] ? null : body.voice;
+    }
+    try {
+        await patchConfig(ctx.ws, patch);
+    }
+    catch (err) {
+        return bad(err instanceof Error ? err.message : String(err));
+    }
+    await ctx.reload();
+    return { status: 200, json: look(ctx, name) };
+}

package/dist/app/http/raw-view.js

@@ -11,7 +11,7 @@ import { annotateSource } from "../../board/parse.js";
 import { conversationFiles } from "../../schema/index.js";
 import { kidSource, truncateReply } from "../../runtime/kid-view.js";
 import { foldRuns, toolCalls } from "../../brain/transcript.js";
-import { logParser, toolKind } from "../../brain/index.js";
+import { parseLogLine, toolKind } from "../../brain/index.js";
 import { resolvePolicy } from "../../schema/index.js";
 import { readErrLog, readIndex, readRunFile, readTranscript, scanCards } from "../../runtime/journal/store.js";
 import { formatEvent, parseEvents, timelineSpans } from "../../runtime/journal/events.js";
@@ -61,7 +61,7 @@ export async function rawView(ws, tutor, date, job) {
         return null;
     const files = conversationFiles(ws.dirs.conversations, tutor, date);
     const policy = resolvePolicy(ws.config, tutor);
-    const transcript = await readTranscript(ws, tutor, date, job, m.runtime);
+    const transcript = await readTranscript(ws, tutor, date, job);
     const pack = await readRunFile(ws, tutor, date, job);
     const blocks = (transcript?.items ?? []).filter((i) => i.kind === 'text' && !i.sub).map((i) => i.text.trim());
     const src = (transcript ? kidSource(transcript) : null) ?? '';
@@ -93,7 +93,7 @@ export async function rawView(ws, tutor, date, job) {
     }));
     const err = await readErrLog(ws, tutor, date, job);
     // 读了什么:索引里物化过的优先(和当时一致),没有(老轮次)就从 .log 现抽
-    const tools = (m.tools ?? toolCalls(await readFile(files.log(job), 'utf8').catch(() => ''), logParser(ws.config.runtimes, m.runtime))).map((t) => ({ ...t, kind: toolKind(t.name) }));
+    const tools = (m.tools ?? toolCalls(await readFile(files.log(job), 'utf8').catch(() => ''), parseLogLine)).map((t) => ({ ...t, kind: toolKind(t.name) }));
     const toolFiles = new Set(tools.filter((t) => t.kind === 'read' && t.arg).map((t) => t.arg)).size;
     const toolFailed = tools.filter((t) => t.ok === false).length;
     const events = parseEvents(await readFile(files.events(job), 'utf8').catch(() => ''));

package/dist/app/http/voice-preview.d.ts

@@ -0,0 +1,4 @@
+import type { Workspace } from '../../schema/index.ts';
+import type { RouteResult } from './app.ts';
+export declare function mouthPreview(ws: Workspace, voice: string, text: string): Promise<RouteResult>;
+export declare function cardPreview(ws: Workspace, voice: string, text: string): Promise<RouteResult>;

package/dist/app/http/voice-preview.js

@@ -0,0 +1,34 @@
+/**
+ * 试听一个音色(家长端「样子与声音」):
+ * 嘴(realtime)真连一次照念这一句(几分钱),存在 .cotutor/live-preview/,同一句同一音色以后直接给文件;
+ * 卡的配音合成一句,在配音缓存里(.cotutor/tts/),之后直接给文件。失败回 JSON 说原因(页面拿 message 显示)。
+ */
+import { createHash } from 'node:crypto';
+import { mkdir, stat, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { synthesize } from "../../media/tts.js";
+import { previewVoice } from "../../realtime/preview.js";
+import { isRealtimeVoice } from "../../realtime/voices.js";
+const VOICE_ID_RE = /^[A-Za-z0-9._:-]{1,120}$/;
+export async function mouthPreview(ws, voice, text) {
+    if (!isRealtimeVoice(voice))
+        return { status: 400, json: { error: 'bad_voice', message: `这个模型不认「${voice}」这个音色` } };
+    const dir = join(ws.root, '.cotutor', 'live-preview');
+    const file = join(dir, `${createHash('sha1').update(`${ws.config.live.model}\n${voice}\n${text}`).digest('hex').slice(0, 20)}.wav`);
+    if (!(await stat(file).catch(() => null))?.isFile()) {
+        const r = await previewVoice({ voice, text, model: ws.config.live.model, env: process.env, endpoint: process.env.COTUTOR_LIVE_ENDPOINT });
+        if ('error' in r)
+            return { status: 502, json: { error: 'realtime_failed', voice, message: r.error } };
+        await mkdir(dir, { recursive: true });
+        await writeFile(file, r.wav);
+    }
+    return { status: 200, file, contentType: 'audio/wav' };
+}
+export async function cardPreview(ws, voice, text) {
+    if (!VOICE_ID_RE.test(voice))
+        return { status: 400, json: { error: 'bad_voice', message: '音色 id 只能是字母数字与 . _ : -' } };
+    const r = await synthesize({ text, voice }, { cacheDir: ws.dirs.tts, env: process.env });
+    if (!r.file)
+        return { status: 502, json: { error: 'tts_failed', voice, message: r.error } };
+    return { status: 200, file: r.file, contentType: 'audio/mpeg' };
+}

package/dist/app/machine/bailian.d.ts

@@ -7,8 +7,6 @@ export interface BailianAuth {
 export interface BailianStatus {
     /** 孩子端能用:按量 key 与业务空间 id 都有(或指了假端点) */
     ready: boolean;
-    /** 用的那份是哪来的:parent = 家长端配的;machine = 这台电脑别处配的(环境变量、qwen、voxtell);null = 没有 */
-    from: 'parent' | 'machine' | null;
     /** key 的末四位(不回显整把) */
     keyTail: string | null;
     workspaceId: string | null;

package/dist/app/machine/bailian.js

@@ -2,9 +2,9 @@
  * 百炼:孩子端的老师靠实时模型开口,没配百炼孩子端打不开,家长在家长端「首页」里配。
  * 配的是按量的 key + 业务空间 id(Token Plan 的 `sk-sp-` 没有 realtime;端点要业务空间 id 的域名)。
  * 存机器级 ~/.config/cotutor/bailian.json(0600,同 PIN、证书,几个孩子的 workspace 共用),不进 cotutor.json:
- * workspace 是 git 仓,工作台的 PATCH /api/config 也能改它。读的顺序(家长端配的在最前)见 src/shared/qianwen.ts。
+ * workspace 是 git 仓,工作台的 PATCH /api/config 也能改它。cotutor 的 key 只认这里(开发机另有 token-plan.json),见 src/shared/qianwen.ts。
  *
- *   GET  /api/parent/bailian        {ready, from, keyTail, workspaceId, canEdit}
+ *   GET  /api/parent/bailian        {ready, keyTail, workspaceId, canEdit}
  *   PUT  /api/parent/bailian        {key, workspaceId}:先试连,通了才存;回 GET 那份 + ms
  *   POST /api/parent/bailian/test   拿现在用的那份试连一次:{ok, ms, message?}
  *
@@ -14,7 +14,7 @@
 import { mkdir, writeFile } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { dirname } from 'node:path';
-import { bailianFile, cotutorBailian } from "../../shared/qianwen.js";
+import { bailianFile } from "../../shared/qianwen.js";
 import { dashscopeAuth } from "../../realtime/bailian.js";
 import { probeRealtime } from "../../realtime/preview.js";
 export function createBailian(opts = {}) {
@@ -25,9 +25,8 @@ export function createBailian(opts = {}) {
         status() {
             const auth = dashscopeAuth(env);
             if (!auth)
-                return { ready: Boolean(fake), from: null, keyTail: null, workspaceId: null };
-            const mine = cotutorBailian(home);
-            return { ready: true, from: mine.apiKey === auth.key && mine.workspaceId === auth.workspaceId ? 'parent' : 'machine', keyTail: auth.key.slice(-4), workspaceId: auth.workspaceId };
+                return { ready: Boolean(fake), keyTail: null, workspaceId: null };
+            return { ready: true, keyTail: auth.key.slice(-4), workspaceId: auth.workspaceId };
         },
         probe: opts.probe ?? ((auth) => probeRealtime({ auth, env, endpoint: fake })),
         async save(auth) {

package/dist/app/machine/update.d.ts

@@ -0,0 +1,25 @@
+export declare const UPDATE_URLS: string[];
+export declare const updateFile: () => string;
+export interface UpdateRecord {
+    checkedAt?: string;
+    latest?: string;
+    off?: boolean;
+}
+/** 读不到、写坏了 → 空的,当作没问过 */
+export declare function readUpdateRecord(file?: string): Promise<UpdateRecord>;
+/** 依次问,谁先答谁算;都问不到 → null */
+export declare function fetchLatest(fetchFn?: typeof fetch, urls?: string[]): Promise<string | null>;
+/** 这个进程现在知道的最新版本;还不知道、关掉了 → null */
+export declare const knownLatest: () => string | null;
+export interface UpdateOptions {
+    now?: number;
+    fetch?: typeof fetch;
+    file?: string;
+}
+/** 文件里的还新鲜就用它,否则问一次并存下;问不到就继续用上次的 */
+export declare function refreshLatest(o?: UpdateOptions): Promise<string | null>;
+/** serve 起来时调:先用存着的那份,一分钟后问(刚开机网可能还没好),之后每小时看一眼,过了一天才真的问。定时器不拦进程退出 */
+export declare function startUpdateChecks(o?: UpdateOptions & {
+    firstMs?: number;
+    everyMs?: number;
+}): () => void;

package/dist/app/machine/update.js

@@ -0,0 +1,88 @@
+/**
+ * 有没有新版本:服务每天问一次 npm 的 latest,结果存机器级 ~/.config/cotutor/update.json(几个孩子的服务共用,一天只问一次,重起不重问)。
+ * /api/health 带上 latest(比在跑的新才有),托盘、家长端、service status 都从它拿;doctor 只读这份文件,不上网。
+ * 只发一个普通的 GET,不带孩子或使用的任何信息;问不到(断网、被墙)不报错,下个小时再问。先问 npm,不通再问 npmmirror(中国家庭常连不上 npm)。
+ * latest 这个标签要等 npm 扫描通过才变(2026-07 起发布后先扫描),不会提前提醒。
+ * 不自动升级:升级要重起服务,孩子可能正在上课;老师文件的更新也要家长知道。
+ * 不想让它问:update.json 写 {"off": true}。从仓库跑的(BUILD.commit 有值)不问,见 main.ts。
+ */
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { isPlainVersion } from "../../shared/upgrade.js";
+export const UPDATE_URLS = ['https://registry.npmjs.org/cotutor/latest', 'https://registry.npmmirror.com/cotutor/latest'];
+const DAY_MS = 24 * 3600_000;
+const HOUR_MS = 3600_000;
+const FIRST_MS = 60_000;
+const TIMEOUT_MS = 8000;
+export const updateFile = () => join(homedir(), '.config', 'cotutor', 'update.json');
+/** 读不到、写坏了 → 空的,当作没问过 */
+export async function readUpdateRecord(file = updateFile()) {
+    try {
+        const j = JSON.parse(await readFile(file, 'utf8'));
+        return {
+            ...(typeof j.checkedAt === 'string' ? { checkedAt: j.checkedAt } : {}),
+            ...(isPlainVersion(j.latest) ? { latest: j.latest } : {}),
+            ...(j.off === true ? { off: true } : {}),
+        };
+    }
+    catch {
+        return {};
+    }
+}
+/** 依次问,谁先答谁算;都问不到 → null */
+export async function fetchLatest(fetchFn = fetch, urls = UPDATE_URLS) {
+    for (const url of urls) {
+        try {
+            const r = await fetchFn(url, { signal: AbortSignal.timeout(TIMEOUT_MS), headers: { accept: 'application/json' } });
+            if (!r.ok)
+                continue;
+            const v = (await r.json()).version;
+            if (isPlainVersion(v))
+                return v;
+        }
+        catch {
+            /* 这家不通,问下一家 */
+        }
+    }
+    return null;
+}
+let known = null;
+/** 这个进程现在知道的最新版本;还不知道、关掉了 → null */
+export const knownLatest = () => known;
+/** 文件里的还新鲜就用它,否则问一次并存下;问不到就继续用上次的 */
+export async function refreshLatest(o = {}) {
+    const file = o.file ?? updateFile();
+    const now = o.now ?? Date.now();
+    const rec = await readUpdateRecord(file);
+    if (rec.off)
+        return (known = null);
+    const at = rec.checkedAt ? Date.parse(rec.checkedAt) : Number.NaN;
+    // 时间在将来(改过系统时间)算不新鲜
+    if (rec.latest && now >= at && now - at < DAY_MS)
+        return (known = rec.latest);
+    const latest = await fetchLatest(o.fetch);
+    if (!latest)
+        return (known = rec.latest ?? null);
+    known = latest;
+    try {
+        await mkdir(dirname(file), { recursive: true });
+        const tmp = `${file}.${process.pid}.tmp`;
+        await writeFile(tmp, `${JSON.stringify({ checkedAt: new Date(now).toISOString(), latest }, null, 2)}\n`);
+        await rename(tmp, file);
+    }
+    catch {
+        /* 写不了:下个小时再问一次,不影响别的 */
+    }
+    return latest;
+}
+/** serve 起来时调:先用存着的那份,一分钟后问(刚开机网可能还没好),之后每小时看一眼,过了一天才真的问。定时器不拦进程退出 */
+export function startUpdateChecks(o = {}) {
+    void readUpdateRecord(o.file).then((rec) => { known = rec.off ? null : rec.latest ?? null; });
+    const run = () => { void refreshLatest(o).catch(() => { }); };
+    const first = setTimeout(run, o.firstMs ?? FIRST_MS);
+    first.unref();
+    const every = setInterval(run, o.everyMs ?? HOUR_MS);
+    every.unref();
+    return () => { clearTimeout(first); clearInterval(every); };
+}

package/dist/app/mock/mock-live.js

@@ -45,7 +45,7 @@ export function mockLiveUpgrade(mock) {
             const my = turn;
             if (caught)
                 say('catch', caught);
-            const r = await mock.route('POST', `/api/kid/conversations/${tutor}/messages`, { ...body, live: true });
+            const r = await mock.kidSend(tutor, body);
             if (my !== turn)
                 return;
             if (r.status !== 202) {

package/dist/app/mock/mock.d.ts

@@ -4,7 +4,7 @@ export declare const MOCK_BUNDLES_DIR: string;
 /** mock 的视频小课堂目录:仓库里的样本(tests/fixtures/lectures/) */
 export declare const MOCK_LECTURES_DIR: string;
 import { type BoardSection, type PenName } from '../../board/presentation.ts';
-import { type ListenInfo } from '../../ui/dev/qr-page.ts';
+import { type ListenInfo } from '../../ui/parent/qr-page.ts';
 export type MockScenario = 'normal' | 'nokey';
 export interface MockTutor {
     name: string;
@@ -62,12 +62,14 @@ export interface MockOptions {
 }
 export interface Mock {
     route(method: string, path: string, body?: unknown): Promise<MockRouteResult>;
+    /** 孩子端发一条(同真服务只走实时那条连接:mock-live.ts 收到了交给它,测试也用它);回的形状同路由,收下 202 + {job, thread} */
+    kidSend(tutor: string, body: unknown): Promise<MockRouteResult>;
     /** 等所有还在「想」的老师答完(测试用) */
     settle(): Promise<void>;
     /** 等这一轮的老师答完(mock 的假嘴等它写完再「念」) */
     settleJob(job: string): Promise<void>;
     handler(req: IncomingMessage, res: ServerResponse): void;
-    /** 在哪个地址上听着(serveMock 在 listen 之后填;扫码页 /dev/qr 每次现问) */
+    /** 在哪个地址上听着(serveMock 在 listen 之后填;扫码页 /parent/qr 每次现问) */
     listen: (() => ListenInfo) | null;
 }
 export declare function createMock(opts?: MockOptions): Mock;