cotutor 0.1.0 → 0.3.0

package/dist/app/http/dev-activities.d.ts

@@ -0,0 +1,115 @@
+import { type ActivityStatus } from '../cli/activities.ts';
+import type { Workspace } from '../../schema/index.ts';
+import { type ActivityIssue } from '../../runtime/activity.ts';
+export interface DevActivityRow {
+    tutor: string;
+    name: string;
+    description: string;
+    /** 不起老师、进一页的(听写):那一页 */
+    page: string | null;
+    state: ActivityStatus['state'];
+    basedOn?: string;
+    fixes: number;
+    notes: number;
+    /** 已发布的首页上用到它的按钮几个(小课堂按钮挂的也算) */
+    buttons: number;
+    /** <名>.例子.md 里几个例子 */
+    examples: number;
+}
+/** 首页上用到它的一个按钮,按正在改的这份解析 */
+export interface DevActivityButton {
+    label: string;
+    kind: 'activity' | 'lecture';
+    /** 按钮下面写的参数原文 */
+    params: Record<string, string>;
+    ok: boolean;
+    /** 解析出的值(补了缺省)或解析不出的原因 */
+    detail: string;
+}
+/** 和出厂比的一块:at = 在现在这份里的行号(1 起);old / now 是出厂那份 / 现在这份的行 */
+export interface DiffHunk {
+    at: number;
+    oldAt: number;
+    old: string[];
+    now: string[];
+}
+/** 按老师(cotutor.json 的顺序)列 workspace 里的 activity */
+export declare function listDevActivities(ws: Workspace): Promise<DevActivityRow[]>;
+/** 名字在不在 workspace 的这位老师名下(只认列得出的,不拼路径) */
+export declare function findDevActivity(ws: Workspace, tutor: string, name: string): Promise<string | null>;
+export declare function readDevActivity(ws: Workspace, tutor: string, name: string): Promise<{
+    tutor: string;
+    name: string;
+    path: string;
+    text: string;
+    hash: string;
+    state: ActivityStatus['state'];
+    basedOn?: string;
+    shipped: boolean;
+    examples: number;
+}>;
+/** 一节一个读者(《写提示词.md》):节标题 → 谁读、在第几行 */
+export declare function activitySections(text: string): {
+    title: string;
+    reader: string;
+    line: number;
+}[];
+/** 两份原文按行比,连着改的合成一块;行号按现在这份(LCS,文件一两百行) */
+export declare function diffHunks(before: string, now: string): DiffHunk[];
+export interface DevActivityCheck {
+    issues: ActivityIssue[];
+    summary: {
+        params: {
+            name: string;
+            type: string;
+            optional: boolean;
+            default?: string;
+            min?: number;
+            max?: number;
+        }[];
+        state: string[];
+        gates: string[];
+        cards: string[];
+        tools: {
+            tool: string;
+            slots: readonly string[];
+        }[];
+        page: string | null;
+    };
+    sections: {
+        title: string;
+        reader: string;
+        line: number;
+    }[];
+    buttons: DevActivityButton[];
+    /** 老师实际收到什么:按 params(首页按钮的或自己填的)裁好的「老师怎么带」;不起老师的是 null */
+    preview: {
+        text: string | null;
+        chars: number;
+        cards: string[];
+        paramIssues: string[];
+        values: Record<string, string>;
+        tools: {
+            tool: string;
+            prompt: string;
+            negative?: string;
+        }[];
+    };
+    /** 和出厂那份比;不是出厂的 → null */
+    diff: DiffHunk[] | null;
+}
+/** 边改边查(不落盘):检查、首页按钮按这份解析、预览、和出厂比 */
+export declare function checkDevActivity(ws: Workspace, tutor: string, name: string, text: string, params?: Record<string, string>): Promise<DevActivityCheck>;
+export declare class ActivityConflict extends Error {
+    readonly hash: string;
+    constructor(hash: string);
+}
+/** 存:磁盘上那份的 hash 要还是 base(读进来时的),不然不存(ActivityConflict);先写 .tmp 再 rename */
+export declare function saveDevActivity(ws: Workspace, tutor: string, name: string, text: string, base: string): Promise<{
+    hash: string;
+    state: ActivityStatus['state'];
+    fixes: number;
+}>;
+export declare function restoreDevActivity(ws: Workspace, tutor: string, name: string): Promise<{
+    bak: string | null;
+}>;

package/dist/app/http/dev-activities.js

@@ -0,0 +1,193 @@
+/**
+ * 工作台改 activity(2026-10-17;设计稿 https://claude.ai/artifact/Srg1Pe4z51iUbei1TxNtLp):
+ * 列 workspace 里每位老师的 activity、读一份原文、边改边查(不落盘:检查、首页按钮解析不解析得出、老师实际收到什么、和出厂比)、
+ * 存(带读进来时的 hash,磁盘上的变了就不存,免得盖掉编程助手那边的改动)、恢复出厂(原文留 .bak)。
+ * 只认 listActivities 列得出的名字,不拼路径;新建、改名、删不在这里(在 workspace 里和编程助手说)。
+ */
+import { readFile, rename, writeFile } from 'node:fs/promises';
+import { join, relative, sep } from 'node:path';
+import { activityStatusOf, restoreActivity, shippedActivityText } from "../cli/activities.js";
+import { EXAMPLES_SUFFIX, activityFile, listActivities } from "../../runtime/activities.js";
+import { sha256 } from "../cli/tutors.js";
+import { lintActivity, renderTutorSection, resolveParams } from "../../runtime/activity.js";
+import { ACTIVITY_PAGES, ACTIVITY_SECTIONS, ACTIVITY_TOOLS, ACTIVITY_TOOL_SECTION_RE, BOARD_CARD_KINDS, LECTURE_ACTIVITY } from "../../schema/index.js";
+import { readPublished } from "../../runtime/home/store.js";
+const exampleCount = async (file) => {
+    const text = await readFile(file.replace(/\.md$/, `${EXAMPLES_SUFFIX}.md`), 'utf8').catch(() => null);
+    return text === null ? 0 : (text.match(/^## /gm) ?? []).length;
+};
+/** 已发布首页上这位老师用到这个 activity 的按钮 */
+async function homeButtons(ws, tutor, name) {
+    const { home } = await readPublished(ws);
+    const out = [];
+    for (const c of home?.cards ?? []) {
+        if (c.kind !== 'tutor' || c.props.tutor !== tutor)
+            continue;
+        for (const b of (c.props.buttons ?? [])) {
+            if (b.kind === 'activity' && b.activity === name)
+                out.push({ label: b.label, kind: 'activity', params: b.params });
+            else if (b.kind === 'lecture' && (b.activity ?? LECTURE_ACTIVITY) === name)
+                out.push({ label: b.label, kind: 'lecture', params: {} });
+        }
+    }
+    return out;
+}
+const tutorCards = (ws, tutor) => ws.config.tutors[tutor]?.cards;
+/** 按老师(cotutor.json 的顺序)列 workspace 里的 activity */
+export async function listDevActivities(ws) {
+    const order = Object.keys(ws.config.tutors);
+    const refs = (await listActivities(join(ws.root, 'agents'))).sort((a, b) => ((order.indexOf(a.tutor) + 1 || 999) - (order.indexOf(b.tutor) + 1 || 999)) || a.name.localeCompare(b.name, 'zh'));
+    const rows = [];
+    for (const r of refs) {
+        const text = await readFile(r.file, 'utf8').catch(() => '');
+        const { activity, issues } = lintActivity(text, { fileName: r.name, tutorCards: tutorCards(ws, r.tutor) });
+        const st = await activityStatusOf(ws.root, r.tutor, r.name);
+        rows.push({
+            tutor: r.tutor,
+            name: r.name,
+            description: activity.description,
+            page: activity.page ? (ACTIVITY_PAGES[activity.page] ?? activity.page) : null,
+            state: st.state,
+            ...(st.basedOn ? { basedOn: st.basedOn } : {}),
+            fixes: issues.filter((i) => i.level === 'fix').length,
+            notes: issues.filter((i) => i.level === 'note').length,
+            buttons: (await homeButtons(ws, r.tutor, r.name)).length,
+            examples: await exampleCount(r.file),
+        });
+    }
+    return rows;
+}
+/** 名字在不在 workspace 的这位老师名下(只认列得出的,不拼路径) */
+export async function findDevActivity(ws, tutor, name) {
+    const refs = await listActivities(join(ws.root, 'agents'), tutor);
+    return refs.find((r) => r.name === name)?.file ?? null;
+}
+export async function readDevActivity(ws, tutor, name) {
+    const file = activityFile(ws.root, tutor, name);
+    const text = await readFile(file, 'utf8');
+    const st = await activityStatusOf(ws.root, tutor, name);
+    return {
+        tutor,
+        name,
+        path: relative(ws.root, file).split(sep).join('/'),
+        text,
+        hash: sha256(text),
+        state: st.state,
+        ...(st.basedOn ? { basedOn: st.basedOn } : {}),
+        shipped: (await shippedActivityText(tutor, name, ws.root)) !== null,
+        examples: await exampleCount(file),
+    };
+}
+/** 一节一个读者(《写提示词.md》):节标题 → 谁读、在第几行 */
+export function activitySections(text) {
+    const out = [{ title: '头', reader: 'name · cards', line: 1 }];
+    let fence = false;
+    text.split('\n').forEach((l, i) => {
+        if (/^`{3,}/.test(l))
+            fence = !fence;
+        const m = !fence && /^##[ \t]+(.+?)[ \t]*$/.exec(l);
+        if (!m)
+            return;
+        const title = m[1];
+        const tool = ACTIVITY_TOOL_SECTION_RE.exec(title)?.[1];
+        const reader = title === ACTIVITY_SECTIONS.tutor ? '老师的系统提示' : tool ? (tool in ACTIVITY_TOOLS ? (tool === '画家' ? '百炼文生图' : tool === '认字' ? '拍照认词' : tool) : tool) : '给你';
+        out.push({ title, reader, line: i + 1 });
+    });
+    return out;
+}
+/** 两份原文按行比,连着改的合成一块;行号按现在这份(LCS,文件一两百行) */
+export function diffHunks(before, now) {
+    const A = before.split('\n');
+    const B = now.split('\n');
+    const n = A.length;
+    const m = B.length;
+    const dp = Array.from({ length: n + 1 }, () => new Array(m + 1).fill(0));
+    for (let i = n - 1; i >= 0; i--)
+        for (let j = m - 1; j >= 0; j--)
+            dp[i][j] = A[i] === B[j] ? dp[i + 1][j + 1] + 1 : Math.max(dp[i + 1][j], dp[i][j + 1]);
+    const out = [];
+    let cur = null;
+    const open = (i, j) => (cur ??= { at: j + 1, oldAt: i + 1, old: [], now: [] });
+    const close = () => { if (cur)
+        out.push(cur); cur = null; };
+    let i = 0;
+    let j = 0;
+    while (i < n || j < m) {
+        if (i < n && j < m && A[i] === B[j]) {
+            close();
+            i++;
+            j++;
+        }
+        else if (j >= m || (i < n && dp[i + 1][j] >= dp[i][j + 1]))
+            open(i, j).old.push(A[i++]);
+        else
+            open(i, j).now.push(B[j++]);
+    }
+    close();
+    return out;
+}
+const showValue = (v) => (Array.isArray(v) ? v.join('、') : String(v));
+/** 边改边查(不落盘):检查、首页按钮按这份解析、预览、和出厂比 */
+export async function checkDevActivity(ws, tutor, name, text, params = {}) {
+    const { activity, issues } = lintActivity(text, { fileName: name, tutorCards: tutorCards(ws, tutor) });
+    const resolve = (raw) => {
+        const r = resolveParams(activity, raw);
+        return r.issues.length ? { ok: false, detail: r.issues.join(';'), values: {} } : { ok: true, detail: Object.entries(r.values).map(([k, v]) => `${k} ${showValue(v)}${raw[k] === undefined ? '(缺省)' : ''}`).join(' · ') || '没有参数', values: r.values };
+    };
+    const fixes = issues.some((i) => i.level === 'fix');
+    const buttons = (await homeButtons(ws, tutor, name)).map((b) => {
+        const r = resolve(b.params);
+        return { ...b, ok: r.ok && !fixes, detail: fixes ? '写坏了,孩子端不出' : r.ok ? r.detail : `解析不出,孩子端不出:${r.detail}` };
+    });
+    const kinds = [...new Set(['text', ...activity.cards.filter((k) => BOARD_CARD_KINDS.includes(k))])];
+    const p = resolveParams(activity, params);
+    const body = activity.tutor ? renderTutorSection(activity, { params: p.values, cards: kinds }) : null;
+    const shipped = await shippedActivityText(tutor, name, ws.root);
+    return {
+        issues,
+        summary: summaryOf(activity),
+        sections: activitySections(text),
+        buttons,
+        preview: {
+            text: body,
+            chars: body ? [...body].length : 0,
+            cards: kinds,
+            paramIssues: p.issues,
+            values: Object.fromEntries(Object.entries(p.values).map(([k, v]) => [k, showValue(v)])),
+            tools: activity.tools.map((t) => ({ tool: t.tool, prompt: t.prompt, ...(t.negative ? { negative: t.negative } : {}) })),
+        },
+        diff: shipped === null ? null : diffHunks(shipped, text),
+    };
+}
+function summaryOf(a) {
+    return {
+        params: a.params.map((x) => ({ name: x.name, type: x.type, optional: x.optional, ...(x.default !== undefined ? { default: x.default } : {}), ...(x.min !== undefined ? { min: x.min } : {}), ...(x.max !== undefined ? { max: x.max } : {}) })),
+        state: a.state.map((x) => x.name),
+        gates: a.gates.map((x) => x.rule),
+        cards: a.cards,
+        tools: a.tools.map((t) => ({ tool: t.tool, slots: ACTIVITY_TOOLS[t.tool]?.slots ?? [] })),
+        page: a.page ? (ACTIVITY_PAGES[a.page] ?? a.page) : null,
+    };
+}
+export class ActivityConflict extends Error {
+    hash;
+    constructor(hash) {
+        super('文件在别处改过了');
+        this.hash = hash;
+    }
+}
+/** 存:磁盘上那份的 hash 要还是 base(读进来时的),不然不存(ActivityConflict);先写 .tmp 再 rename */
+export async function saveDevActivity(ws, tutor, name, text, base) {
+    const file = activityFile(ws.root, tutor, name);
+    const disk = await readFile(file, 'utf8');
+    if (sha256(disk) !== base)
+        throw new ActivityConflict(sha256(disk));
+    await writeFile(`${file}.tmp`, text);
+    await rename(`${file}.tmp`, file);
+    const st = await activityStatusOf(ws.root, tutor, name);
+    return { hash: sha256(text), state: st.state, fixes: lintActivity(text, { fileName: name, tutorCards: tutorCards(ws, tutor) }).issues.filter((i) => i.level === 'fix').length };
+}
+export async function restoreDevActivity(ws, tutor, name) {
+    const r = await restoreActivity(ws.root, tutor, name);
+    return { bak: r.bak ? relative(ws.root, r.bak).split(sep).join('/') : null };
+}

package/dist/app/http/dev-overview.d.ts

@@ -0,0 +1,108 @@
+import type { Workspace } from '../../schema/index.ts';
+/** 首句就绪(没有就首卡)超过它算慢;与工作台对话页的 SLOW_FIRST 同数 */
+export declare const SLOW_FIRST_MS = 15000;
+export interface DevIssue {
+    /** js = 孩子端页面脚本出错(流水里的 error;tutor、job 可能是空的);net = 孩子端连接(一台设备一天一条,7.3) */
+    kind: 'slow' | 'error' | 'warn' | 'js' | 'net';
+    tutor: string;
+    date: string;
+    job: string;
+    /** 消息的 at(到分钟) */
+    at: string;
+    /** 孩子那句话(截短) */
+    text: string;
+    /** 一句说明:多慢、什么错、什么提醒 */
+    detail: string;
+    /** 页面出错:同一条(报错 + 位置 + 页面 + 页面版本)七天里合成一条 */
+    js?: {
+        page: string;
+        mode: string;
+        where: string;
+        stack: string;
+        count: number;
+        devices: string[];
+        first: string;
+        thread: string | null;
+    };
+}
+/** 概览「设备」卡的一行(近 30 天开过的) */
+export interface DevDevice {
+    id: string;
+    name: string | null;
+    label: string;
+    last: string;
+    /** 今天开了几次 */
+    today: number;
+    /** 今天在前台多久(毫秒,7.4) */
+    todayMs: number;
+    /** 近 7 天页面出错几条 */
+    errors: number;
+    /** 最近一次打开时服务端的提交(7.1) */
+    commit: string | null;
+    /** 这台的毛病(7.2):有才列,err 砖红、warn 琥珀 */
+    flags: {
+        text: string;
+        level: 'err' | 'warn';
+    }[];
+}
+export interface DevTutorRow {
+    name: string;
+    display: string;
+    hidden: boolean;
+    enabled: boolean;
+    /** 今天跑过就是最后一轮用的,没跑过是 cotutor.json 配的 */
+    runtime: string;
+    turns: number;
+    firstMedianMs: number | null;
+    lastAt: string | null;
+}
+export interface DevOverview {
+    today: string;
+    /** 近七天每天孩子说了几轮,升序,最后一天是今天 */
+    days: {
+        date: string;
+        turns: number;
+    }[];
+    todayTurns: number;
+    todayTasks: number;
+    todayThreads: number;
+    lastAt: string | null;
+    /** 近七天最新的一轮(孩子的话):概览「看原文」直达它 */
+    last: {
+        tutor: string;
+        date: string;
+        job: string;
+        at: string;
+    } | null;
+    firstMedianMs: number | null;
+    doneMedianMs: number | null;
+    slow: number;
+    tutors: DevTutorRow[];
+    /** 近七天,按运行时分:几轮、老师用的 token(没报的轮只算轮数) */
+    usage: {
+        runtime: string;
+        turns: number;
+        tokensIn: number;
+        tokensOut: number;
+    }[];
+    paint: {
+        today: number;
+    };
+    issues: DevIssue[];
+    /** 近 30 天开过的设备,最近开的在前;更早的折起来 */
+    devices: DevDevice[];
+    olderDevices: DevDevice[];
+    /** 孩子端开着多久(7.4):近七天每天前台的毫秒,今天另给几点到几点(本地「时:分」);今天没开过 → today null */
+    kidTime: {
+        days: {
+            date: string;
+            ms: number;
+        }[];
+        today: {
+            ms: number;
+            from: string;
+            to: string;
+        } | null;
+    };
+}
+export declare function devOverview(ws: Workspace, now?: Date): Promise<DevOverview>;

package/dist/app/http/dev-overview.js

@@ -0,0 +1,209 @@
+/**
+ * 工作台概览:把近七天各老师的会话索引读一遍,算成一页数字。
+ * 只读不写;只看 conversations/ 下的索引(回放在 evals/,不算)、今天画了几张(不限张数,只数)、孩子端的流水与设备表。
+ * 「轮」只算孩子的话(from: kid);记账、整理记忆这类应用派的任务(from: system)单记,钱和 token 照算进用量。
+ */
+import { localDate, localMinute, weekOf } from "../../shared/time.js";
+import { listTutors } from "../../schema/config.js";
+import { paintedToday } from "../../scenes/paint/painter.js";
+import { readIndex } from "../../runtime/journal/store.js";
+import { readDevices, readKidLog } from "../../runtime/journal/kid-log.js";
+import { deviceLabel } from "../../schema/kid-device.js";
+/** 首句就绪(没有就首卡)超过它算慢;与工作台对话页的 SLOW_FIRST 同数 */
+export const SLOW_FIRST_MS = 15_000;
+const MAX_ISSUES = 8;
+const median = (xs) => {
+    const a = xs.slice().sort((x, y) => x - y);
+    return a.length ? a[Math.floor(a.length / 2)] : null;
+};
+const firstOf = (m) => m.timing?.firstReadyMs ?? m.timing?.firstCardMs;
+const clip = (s, n = 40) => (s.length > n ? s.slice(0, n) + '…' : s);
+const secs = (ms) => (ms < 10_000 ? (ms / 1000).toFixed(1) : String(Math.round(ms / 1000))) + ' s';
+export async function devOverview(ws, now = new Date()) {
+    const today = localDate(now);
+    const days = weekOf(today, today);
+    const tutors = listTutors(ws.config);
+    const perDay = new Map(days.map((d) => [d, 0]));
+    const usage = new Map();
+    const issues = [];
+    const todayFirst = [];
+    const todayDone = [];
+    const threads = new Set();
+    let todayTasks = 0;
+    let slow = 0;
+    let lastAt = null;
+    let last = null;
+    const rows = [];
+    for (const t of tutors) {
+        const row = { name: t.name, display: t.display, hidden: Boolean(t.hidden), enabled: t.enabled, runtime: ws.config.tutors[t.name]?.runtime ?? ws.config.runtimes.default, turns: 0, firstMedianMs: null, lastAt: null };
+        const firsts = [];
+        for (const date of days) {
+            const index = await readIndex(ws, t.name, date).catch(() => null);
+            if (!index)
+                continue;
+            for (const m of index.messages) {
+                const kid = m.from === 'kid';
+                const rt = m.runtime ?? ws.config.runtimes.default;
+                const u = usage.get(rt) ?? { runtime: rt, turns: 0, tokensIn: 0, tokensOut: 0 };
+                u.turns++;
+                u.tokensIn += m.tokens?.in ?? 0;
+                u.tokensOut += m.tokens?.out ?? 0;
+                usage.set(rt, u);
+                if (kid)
+                    perDay.set(date, (perDay.get(date) ?? 0) + 1);
+                if (kid && (!last || m.at > last.at))
+                    last = { tutor: t.name, date, job: m.job, at: m.at };
+                const first = firstOf(m);
+                const base = { tutor: t.name, date, job: m.job, at: m.at, text: clip(m.text) };
+                if (m.result === 'error')
+                    issues.push({ ...base, kind: 'error', detail: m.error || '出错了' });
+                else if (first !== undefined && first > SLOW_FIRST_MS)
+                    issues.push({ ...base, kind: 'slow', detail: (m.timing?.firstReadyMs !== undefined ? '首句就绪 ' : '首卡 ') + secs(first) });
+                else if (m.warnings?.length)
+                    issues.push({ ...base, kind: 'warn', detail: clip(m.warnings[0], 60) + (m.warnings.length > 1 ? ` 等 ${m.warnings.length} 条` : '') });
+                if (date !== today)
+                    continue;
+                if (!kid) {
+                    todayTasks++;
+                    continue;
+                }
+                row.turns++;
+                row.runtime = rt;
+                if (!row.lastAt || m.at > row.lastAt)
+                    row.lastAt = m.at;
+                if (!lastAt || m.at > lastAt)
+                    lastAt = m.at;
+                threads.add(t.name + '/' + (m.thread ?? m.job));
+                if (first !== undefined) {
+                    firsts.push(first);
+                    todayFirst.push(first);
+                    if (first > SLOW_FIRST_MS)
+                        slow++;
+                }
+                if (m.timing?.doneMs !== undefined)
+                    todayDone.push(m.timing.doneMs);
+            }
+        }
+        row.firstMedianMs = median(firsts);
+        rows.push(row);
+    }
+    const kid = await kidSide(ws, today, days);
+    issues.push(...kid.issues);
+    issues.sort((a, b) => (a.at < b.at ? 1 : a.at > b.at ? -1 : 0));
+    return {
+        today,
+        days: days.map((date) => ({ date, turns: perDay.get(date) ?? 0 })),
+        todayTurns: perDay.get(today) ?? 0,
+        todayTasks,
+        todayThreads: threads.size,
+        lastAt,
+        last,
+        firstMedianMs: median(todayFirst),
+        doneMedianMs: median(todayDone),
+        slow,
+        tutors: rows,
+        usage: [...usage.values()].sort((a, b) => b.turns - a.turns),
+        paint: { today: await paintedToday(ws, today, now.getTime()).catch(() => 0) },
+        issues: issues.slice(0, MAX_ISSUES),
+        devices: kid.devices,
+        olderDevices: kid.older,
+        kidTime: kid.time,
+    };
+}
+const DEVICE_DAYS = 30;
+/** 设备卡与页面出错:设备表 + 近 7 天的流水 */
+async function kidSide(ws, today, days) {
+    const table = await readDevices(ws);
+    const log = await readKidLog(ws, days).catch(() => []);
+    const nameOf = (id, ua) => table[id]?.name ?? table[id]?.label ?? deviceLabel({ ua });
+    const errorsBy = new Map();
+    const groups = new Map();
+    for (const l of log) {
+        if (l.k !== 'error')
+            continue;
+        errorsBy.set(l.device, (errorsBy.get(l.device) ?? 0) + 1);
+        // 流水的时刻是 ISO(UTC),概览别的轮次是本地的「日期T时:分」,换成一样的
+        const at = localMinute(new Date(l.at));
+        const tutor = typeof l.ctx?.tutor === 'string' ? l.ctx.tutor : '';
+        const thread = typeof l.ctx?.thread === 'string' ? l.ctx.thread : null;
+        const dev = nameOf(l.device, l.ua);
+        const key = [l.msg, l.where, l.page, l.v].join('\u0000');
+        const g = groups.get(key);
+        if (!g) {
+            groups.set(key, { kind: 'js', tutor, date: at.slice(0, 10), job: '', at, text: clip(l.msg, 80), detail: `${l.page}${l.mode && l.mode !== 'kid' ? `(${l.mode})` : ''} · ${l.where || '—'}`, js: { page: l.page, mode: l.mode, where: l.where, stack: l.stack, count: 1, devices: [dev], first: at, thread } });
+            continue;
+        }
+        g.js.count++;
+        if (!g.js.devices.includes(dev))
+            g.js.devices.push(dev);
+        // 流水按时刻追加,后来的就是最近一次:时刻、老师、话题跟着它
+        g.at = at;
+        g.date = at.slice(0, 10);
+        if (tutor)
+            g.tutor = tutor;
+        if (thread)
+            g.js.thread = thread;
+    }
+    // 连接(7.3):一台设备一天合一条
+    const nets = new Map();
+    for (const l of log) {
+        if (l.k !== 'net')
+            continue;
+        const at = localMinute(new Date(l.at));
+        const key = `${l.device}/${at.slice(0, 10)}`;
+        const n = nets.get(key) ?? { device: l.device, ua: table[l.device]?.ua ?? '', date: at.slice(0, 10), at, off: 0, offMax: 0, fail: 0, drop: 0 };
+        n.at = at;
+        if (l.what === 'offline') {
+            n.off++;
+            n.offMax = Math.max(n.offMax, l.ms);
+        }
+        else if (l.opened)
+            n.drop++;
+        else
+            n.fail++;
+        nets.set(key, n);
+    }
+    const span = (ms) => { const s = Math.round(ms / 1000); return s < 60 ? `${s} 秒` : `${Math.floor(s / 60)} 分${s % 60 ? ` ${s % 60} 秒` : ''}`; };
+    const netIssues = [...nets.values()].map((n) => ({
+        kind: 'net', tutor: '', date: n.date, job: '', at: n.at, text: nameOf(n.device, n.ua),
+        detail: [n.off ? `断线 ${n.off} 次,最长 ${span(n.offMax)}` : '', n.fail || n.drop ? `实时${n.fail ? `连不上 ${n.fail} 次` : ''}${n.fail && n.drop ? '、' : ''}${n.drop ? `断了 ${n.drop} 次` : ''}` : ''].filter(Boolean).join(' · '),
+    }));
+    const floor = new Date(Date.parse(`${today}T00:00:00`) - (DEVICE_DAYS - 1) * 86_400_000).toISOString();
+    const opensToday = new Map();
+    for (const l of log)
+        if (l.k === 'open' && localDate(new Date(l.at)) === today)
+            opensToday.set(l.device, (opensToday.get(l.device) ?? 0) + 1);
+    // 前台多久:fg 一笔的时刻是记下的那一刻,开始在 ms 之前;几点到几点 = 今天第一次打开(或第一笔的开头)到最后一笔
+    const fgByDay = new Map();
+    const fgToday = new Map();
+    let from = Infinity, to = -Infinity;
+    for (const l of log) {
+        const t = Date.parse(l.at);
+        const date = localDate(new Date(t));
+        if (l.k === 'fg') {
+            fgByDay.set(date, (fgByDay.get(date) ?? 0) + l.ms);
+            if (date === today)
+                fgToday.set(l.device, (fgToday.get(l.device) ?? 0) + l.ms);
+        }
+        if (date !== today || (l.k !== 'fg' && l.k !== 'open'))
+            continue;
+        from = Math.min(from, l.k === 'fg' ? t - l.ms : t);
+        to = Math.max(to, t);
+    }
+    const hm = (t) => localMinute(new Date(t)).slice(11);
+    const time = { days: days.map((date) => ({ date, ms: fgByDay.get(date) ?? 0 })), today: Number.isFinite(from) ? { ms: fgByDay.get(today) ?? 0, from: hm(from), to: hm(to) } : null };
+    const all = Object.entries(table).sort((a, b) => (a[1].last < b[1].last ? 1 : -1));
+    const weekStart = new Date(`${days[0]}T00:00:00`).toISOString();
+    const flagsOf = (d) => [
+        ...(d.caps?.mic === 'denied' ? [{ text: '麦克风拒了', level: 'err' }] : []),
+        ...(d.caps && !d.caps.gum ? [{ text: '没有麦克风接口', level: 'err' }] : []),
+        ...(d.blockedAt && d.blockedAt >= weekStart ? [{ text: '声音被拦过', level: 'warn' }] : []),
+    ];
+    const row = ([id, d]) => ({ id, name: d.name ?? null, label: d.label, last: d.last, today: opensToday.get(id) ?? 0, todayMs: fgToday.get(id) ?? 0, errors: errorsBy.get(id) ?? 0, commit: d.commit ?? null, flags: flagsOf(d) });
+    return {
+        devices: all.filter(([, d]) => d.last >= floor).map(row),
+        older: all.filter(([, d]) => d.last < floor).map(row),
+        issues: [...groups.values(), ...netIssues],
+        time,
+    };
+}