cotutor 0.3.0 → 0.4.0

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/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;

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} 个字。