cotutor 0.3.0 → 0.4.1

package/dist/app/cli/chalk/browser.js

@@ -2,28 +2,43 @@
  * 做课包用的浏览器(2026-10-31 替掉 drawtell 的 playwright):起本机的 Chrome(无头、自己的临时 profile,不碰平时用的那个),
  * 走 DevTools 协议(CDP)开页面、等、取值、截图。不另装浏览器:烤画面、截图与孩子端是同一种渲染就够。
  * 每条命令都有超时(回包不来就报错,不挂着);收尾杀进程、删临时 profile,出错也在 finally 里收(scripts/_guard.mjs 那次的教训:无头 Chrome 挂了两天)。
- * Chrome 在哪:环境变量 CHROME > macOS 的 /Applications/Google Chrome.app > PATH 里的 google-chrome / chromium。
+ * Chrome 在哪:环境变量 CHROME > macOS 的 /Applications/Google Chrome.app > Windows 的 Chrome、再 Edge(装在 Program Files 或自己的 AppData 下,不在 PATH 里)
+ * > PATH 里的 google-chrome / chromium(Windows 带 .exe)。Edge 是 Windows 10/11 自带的 Chromium,CDP 一样,烤出的画面一字不差(2026-11-02 在 Windows 上对过)。
  */
 import { spawn } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import { mkdtemp, rm } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import { delimiter, join } from 'node:path';
+import { UsageError } from "../../workspace.js";
 const MAC_CHROME = '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome';
 const PATH_NAMES = ['google-chrome', 'google-chrome-stable', 'chromium', 'chromium-browser'];
+/** Windows:先 Chrome 后 Edge,每样依次看全机装的、32 位的、只给自己装的 */
+const WIN_BROWSERS = [['Google', 'Chrome', 'Application', 'chrome.exe'], ['Microsoft', 'Edge', 'Application', 'msedge.exe']];
+const WIN_ROOTS = ['ProgramFiles', 'ProgramFiles(x86)', 'LOCALAPPDATA'];
 /** 一条 CDP 命令最多等多久 */
 const SEND_MS = 60_000;
-/** 本机 Chrome 的可执行文件;找不到 null */
-export function chromePath(env = process.env) {
+/** 本机 Chrome(Windows 上没有 Chrome 就是 Edge)的可执行文件;找不到 null */
+export function chromePath(env = process.env, platform = process.platform) {
     const set = env.CHROME?.trim();
     if (set)
         return existsSync(set) ? set : null;
-    if (process.platform === 'darwin' && existsSync(MAC_CHROME))
+    if (platform === 'darwin' && existsSync(MAC_CHROME))
         return MAC_CHROME;
+    if (platform === 'win32') {
+        for (const parts of WIN_BROWSERS) {
+            for (const root of WIN_ROOTS) {
+                const dir = env[root];
+                if (dir && existsSync(join(dir, ...parts)))
+                    return join(dir, ...parts);
+            }
+        }
+    }
+    const exe = platform === 'win32' ? '.exe' : '';
     for (const dir of (env.PATH ?? '').split(delimiter)) {
         for (const name of PATH_NAMES)
-            if (dir && existsSync(join(dir, name)))
-                return join(dir, name);
+            if (dir && existsSync(join(dir, name + exe)))
+                return join(dir, name + exe);
     }
     return null;
 }
@@ -86,7 +101,7 @@ async function connect(url) {
 export async function withBrowser(fn, opts = {}) {
     const bin = chromePath(opts.env);
     if (!bin)
-        throw new Error('找不到 Chrome:装 Google Chrome,或环境变量 CHROME 指到 Chrome / Chromium 的可执行文件');
+        throw new UsageError('找不到 Chrome:装 Google Chrome,或环境变量 CHROME 指到 Chrome / Chromium / Edge 的可执行文件');
     const width = opts.width ?? 1280;
     const height = opts.height ?? 960;
     const profile = await mkdtemp(join(tmpdir(), 'cotutor-chalk-'));

package/dist/app/cli/chalk/main.js

@@ -9,6 +9,7 @@
  */
 import { dirname, join, resolve } from 'node:path';
 import { checkScene } from "../../../chalk/check.js";
+import { cardVoice } from "../../../schema/index.js";
 import { UsageError, loadWorkspace, redactDeep, redactHome } from "../../workspace.js";
 import { buildBundle, readBundle } from "./build.js";
 import { LoadError, NotFoundError, loadScene, loadSceneFiles, resolveSceneInput } from "./load-scene.js";
@@ -153,9 +154,9 @@ export async function chalkCommand(args, flags, opts) {
                 const ws = loadWorkspace(opts.workspace);
                 const bundlesDir = str(flags.bundles) ? resolve(str(flags.bundles)) : ws.dirs.bundles;
                 const tutor = str(flags.tutor) ?? 'math-tutor';
-                const voice = str(flags.voice) ?? ws.config.tutors[tutor]?.voice;
+                const voice = str(flags.voice) ?? cardVoice(ws.config.tutors, tutor);
                 if (!voice)
-                    throw new UsageError(`没有音色:--voice <音色>,或 --tutor <老师>(缺省 math-tutor)在 cotutor.json 里配了卡的音色(工作台「音色」页挑)`);
+                    throw new UsageError(`没有音色:--voice <音色>,或 --tutor <老师>(缺省 math-tutor)在 cotutor.json 里配了卡的音色(家长端首页「样子与声音」挑)`);
                 const s = await sceneOrBundle('dub', file, bundlesDir, json);
                 if (!s)
                     return;

package/dist/app/cli/doctor.d.ts

@@ -4,7 +4,12 @@ export interface DoctorCheck {
     ok: boolean;
     required: boolean;
     detail: string;
+    /** 给人看的修法 */
     fix?: string;
+    /** 不过时能直接跑的修复命令:幂等、不碰孩子的数据、不用人输东西(INSTALL.md 让 agent 照跑) */
+    cmd?: string;
+    /** 不过、又没有 cmd:要人来(填 key、输开机密码、点弹窗、写孩子的情况),agent 别动手。finish 统一补 */
+    human?: true;
 }
 export interface DoctorReport {
     ok: boolean;
@@ -12,12 +17,13 @@ export interface DoctorReport {
     source: RootSource | null;
     checks: DoctorCheck[];
 }
-/** 运行时的 CLI 名(run[0] 的 basename) */
-export declare function runtimeCli(run: readonly string[]): string;
-/** 已知的环境坑,从 CLI 的输出里认出来给修复命令(错误信息即修复指南) */
-export declare function explainLlmFailure(text: string, runtime: readonly string[]): string;
 export declare function doctorWorkspace(override?: string, opts?: ResolveOptions & {
     probeEnv?: boolean;
-    live?: boolean; /** 测试钉时间用:首页「几天前发布的」按它算 */
+    live?: boolean;
+    /** 测试钉时间用:首页「几天前发布的」按它算 */
     now?: Date;
+    /** Windows 上查防火墙放没放行(起一次 PowerShell,一秒多):缺省跟 probeEnv;serve 起来时要查 */
+    firewall?: boolean;
+    /** 防火墙按哪个端口查:缺省 cotutor.json 的 server.port,serve --port 换了就传进来 */
+    port?: number;
 }): Promise<DoctorReport>;