cotutor 0.2.0 → 0.3.0

package/dist/{cli → app/cli}/tutors.d.ts

@@ -1,20 +1,5 @@
 import { type TutorTemplateInput } from './skeleton.ts';
-export declare const SHIPPED_FILE = ".cotutor/shipped.json";
-export interface ShippedManifest {
-    /** 出厂 skill(drawtell-skills 的四个领域 skill)的 hash,与 tutors 同一套机制(src/cli/skills.ts) */
-    skills?: Record<string, {
-        hash: string;
-        version: string;
-    }>;
-    version: string;
-    tutors: Record<string, {
-        hash: string;
-        version: string;
-    }>;
-}
-export declare const sha256: (text: string) => string;
-export declare function readManifest(root: string): Promise<ShippedManifest>;
-export declare function writeManifest(root: string, m: ShippedManifest): Promise<void>;
+export { SHIPPED_FILE, sha256, readManifest, writeManifest, type ShippedManifest } from './shipped.ts';
 export type TutorState = 'latest' | 'upgradable' | 'custom' | 'untracked' | 'missing' | 'broken';
 export interface TutorStatus {
     name: string;
@@ -23,23 +8,18 @@ export interface TutorStatus {
     file: string;
     /** 记录的出厂版本(custom / upgradable 时有) */
     basedOn?: string;
-    /** 是否还是指向包的旧链(init 会换成拷贝) */
-    legacyLink?: boolean;
 }
-/** 老师文件在 workspace 里的位置:.claude/agents/<name>.md 是真相,.qwen/agents/<name>.md 是相对链 */
-export declare function tutorFiles(root: string, name: string): {
-    claude: string;
-    qwen: string;
-};
+/** 老师文件在 workspace 里的位置:agents/<name>.md 是真相(应用读正文递进系统提示) */
+export declare function tutorFile(root: string, name: string): string;
 export declare function tutorStatuses(root: string): Promise<TutorStatus[]>;
 export interface InstallStep {
     item: string;
-    action: 'created' | 'exists' | 'kept' | 'replaced';
+    action: 'created' | 'exists' | 'kept' | 'replaced' | 'removed';
     note?: string;
 }
 /**
  * init 用。出厂的:缺的拷,旧的包内链换成拷贝,家长的文件不动;
- * cotutor.json 里的每一位(含家长自己加的):补老师目录 agents/<name>/ 与 .qwen 链——「加老师 = 加文件 + 目录,没有注册表」,
+ * cotutor.json 里的每一位(含家长自己加的):补老师目录 agents/<name>/——「加老师 = 加文件 + 目录,没有注册表」,
  * 自己加的老师文件不在这里生成(cotutor add 生成模板),缺了由 doctor 点名。
  */
 export declare function installTutors(root: string, configured?: string[]): Promise<InstallStep[]>;
@@ -49,7 +29,7 @@ export interface AddResult {
     home: string;
 }
 /**
- * cotutor add <name>:按出厂老师的结构写一份模板(约定都带上,人设一句留给家长填)、建目录与 .qwen 链。
+ * cotutor add <name>:按出厂老师的结构写一份模板(约定都带上,人设一句留给家长填)、建目录。
  * 不动 cotutor.json——那是调用方(main / 页面)用 patchConfig 加的,同一条路。已有同名文件就拒,不覆盖。
  */
 export declare function addTutorFile(root: string, input: TutorTemplateInput): Promise<AddResult>;
@@ -82,3 +62,12 @@ export declare function writeTutorFile(root: string, name: string, text: string)
 export declare function removeTutorFile(root: string, name: string): Promise<{
     moved: string | null;
 }>;
+/** 出厂那份老师文件的原文;不是出厂的 → null */
+export declare function shippedTutorText(name: string, root?: string): Promise<string | null>;
+/**
+ * 只把一位出厂老师的文件换回出厂那份(工作台「恢复出厂」,与 upgrade --force <老师> 同一条路,但不碰别的老师):
+ * 现在那份和出厂不一样就先存 .bak。不是出厂的 → UsageError。返回 .bak 的路径(没存就是 null)
+ */
+export declare function restoreTutor(root: string, name: string): Promise<{
+    bak: string | null;
+}>;

package/dist/{cli → app/cli}/tutors.js

@@ -1,120 +1,81 @@
 /**
- * 老师文件的安装与升级(2026-09-09 拍板:**拷贝,不链**)。
- * 包里的 agents/<name>.md 是出厂件;init 把它拷进 workspace 的 .claude/agents/<name>.md(这份是家长的,想改就改),
- * .qwen/agents/<name>.md 是指向它的相对链(一份真相两处可见,链在 workspace 内,不怕包搬家或 npx 缓存回收)。
+ * 老师文件的安装与升级(**拷贝,不链**)。
+ * 包里的 grades/grade-<n>/agents/<name>.md 是出厂件;init 把它拷进 workspace 的 agents/<name>.md(这份是家长的,想改就改),
+ * 和老师的家 agents/<name>/ 并排,同包里一样(2026-10-30 从 .claude/agents/ 挪来,老 workspace 由 migrate.ts 的 migrateLayout 搬)。
  * 出厂时的内容 hash 记在 .cotutor/shipped.json(机器文件,家长不用管),据此分三种状态:
  *   latest     与本包一致
  *   upgradable 与记录的出厂 hash 一致(没改过,只是包更新了)→ cotutor upgrade 直接换新
  *   custom     改过 → upgrade 只报 diff,不动
  *   untracked  没有记录(旧workspace、或家长手写的老师)→ 当 custom 对待
  */
-import { createHash } from 'node:crypto';
-import { lstat, mkdir, readFile, readlink, rename, symlink, unlink, writeFile } from 'node:fs/promises';
-import { basename, dirname, join, relative } from 'node:path';
-import { PACKAGE_AGENTS_DIR, PACKAGE_VERSION, shippedAgents, tutorTemplate, writeSchemaFile, writeSyntaxFile } from "./skeleton.js";
-import { AGENT_NAME_RE } from "../schema/index.js";
-import { UsageError } from "./workspace.js";
-export const SHIPPED_FILE = '.cotutor/shipped.json';
-export const sha256 = (text) => `sha256:${createHash('sha256').update(text).digest('hex')}`;
-export async function readManifest(root) {
-    try {
-        const raw = JSON.parse(await readFile(join(root, SHIPPED_FILE), 'utf8'));
-        return { version: raw.version ?? '0', tutors: raw.tutors ?? {} };
-    }
-    catch {
-        return { version: '0', tutors: {} };
-    }
-}
-export async function writeManifest(root, m) {
-    const file = join(root, SHIPPED_FILE);
-    await mkdir(dirname(file), { recursive: true });
-    const tmp = `${file}.tmp`;
-    await writeFile(tmp, `${JSON.stringify({ ...m, _note: '出厂时老师文件的 hash,cotutor upgrade 据此分辨「没改过」与「改过」;机器写,不用手改' }, null, 2)}\n`);
-    await rename(tmp, file);
-}
-/** 老师文件在 workspace 里的位置:.claude/agents/<name>.md 是真相,.qwen/agents/<name>.md 是相对链 */
-export function tutorFiles(root, name) {
-    return { claude: join(root, '.claude', 'agents', `${name}.md`), qwen: join(root, '.qwen', 'agents', `${name}.md`) };
+import { lstat, mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
+import { basename, dirname, join } from 'node:path';
+import { PACKAGE_VERSION, shippedAgents, tutorTemplate, writeSchemaFile } from "./skeleton.js";
+import { AGENT_NAME_RE, tutorFilePath } from "../../schema/index.js";
+import { UsageError } from "../workspace.js";
+import { SHIPPED_FILE, sha256, readManifest, writeManifest } from "./shipped.js";
+import { workspaceGradePack } from "./grades.js";
+export { SHIPPED_FILE, sha256, readManifest, writeManifest } from "./shipped.js";
+/** 老师文件在 workspace 里的位置:agents/<name>.md 是真相(应用读正文递进系统提示) */
+export function tutorFile(root, name) {
+    return tutorFilePath(join(root, 'agents'), name);
 }
 async function readState(root, a, manifest) {
-    const { claude } = tutorFiles(root, a.name);
-    const st = await lstat(claude).catch(() => null);
+    const file = tutorFile(root, a.name);
+    const st = await lstat(file).catch(() => null);
     if (!st)
-        return { name: a.name, state: 'missing', file: claude };
-    let legacyLink = false;
-    if (st.isSymbolicLink()) {
-        const target = await readlink(claude).catch(() => '');
-        legacyLink = target.startsWith(PACKAGE_AGENTS_DIR) || target === a.file;
-    }
+        return { name: a.name, state: 'missing', file };
     let text;
     try {
-        text = await readFile(claude, 'utf8');
+        text = await readFile(file, 'utf8');
     }
     catch {
-        return { name: a.name, state: 'broken', file: claude, legacyLink };
+        return { name: a.name, state: 'broken', file };
     }
     const shipped = await readFile(a.file, 'utf8');
     const h = sha256(text);
     const rec = manifest.tutors[a.name];
     if (h === sha256(shipped))
-        return { name: a.name, state: 'latest', file: claude, basedOn: rec?.version, legacyLink };
+        return { name: a.name, state: 'latest', file, basedOn: rec?.version };
     if (rec && rec.hash === h)
-        return { name: a.name, state: 'upgradable', file: claude, basedOn: rec.version, legacyLink };
-    return { name: a.name, state: rec ? 'custom' : 'untracked', file: claude, basedOn: rec?.version, legacyLink };
+        return { name: a.name, state: 'upgradable', file, basedOn: rec.version };
+    return { name: a.name, state: rec ? 'custom' : 'untracked', file, basedOn: rec?.version };
 }
 export async function tutorStatuses(root) {
     const manifest = await readManifest(root);
     const out = [];
-    for (const a of await shippedAgents())
+    for (const a of await shippedAgents((await workspaceGradePack(root)).agentsDir))
         out.push(await readState(root, a, manifest));
     return out;
 }
 /** 把出厂件写进 workspace(覆盖),并记 hash */
 async function installOne(root, a, manifest) {
-    const { claude } = tutorFiles(root, a.name);
-    await mkdir(dirname(claude), { recursive: true });
+    const file = tutorFile(root, a.name);
+    await mkdir(dirname(file), { recursive: true });
     const text = await readFile(a.file, 'utf8');
-    await unlink(claude).catch(() => { });
-    await writeFile(claude, text);
+    await unlink(file).catch(() => { });
+    await writeFile(file, text);
+    manifest.teachingPack ??= { grade: (await workspaceGradePack(root)).grade };
     manifest.tutors[a.name] = { hash: sha256(text), version: PACKAGE_VERSION };
 }
-/** .qwen/agents/<name>.md → ../../.claude/agents/<name>.md;已是这条链就不动;是旧的包内链或别的东西就换 */
-async function ensureQwenLink(root, name) {
-    const { claude, qwen } = tutorFiles(root, name);
-    await mkdir(dirname(qwen), { recursive: true });
-    const want = relative(dirname(qwen), claude);
-    const st = await lstat(qwen).catch(() => null);
-    if (st?.isSymbolicLink() && (await readlink(qwen).catch(() => '')) === want)
-        return 'exists';
-    if (st) {
-        if (!st.isSymbolicLink()) {
-            // 家长手放了实体文件在 .qwen 下:留着,当作她的
-            return 'exists';
-        }
-        await unlink(qwen);
-        await symlink(want, qwen);
-        return 'replaced';
-    }
-    await symlink(want, qwen);
-    return 'created';
-}
 /**
  * init 用。出厂的:缺的拷,旧的包内链换成拷贝,家长的文件不动;
- * cotutor.json 里的每一位(含家长自己加的):补老师目录 agents/<name>/ 与 .qwen 链——「加老师 = 加文件 + 目录,没有注册表」,
+ * cotutor.json 里的每一位(含家长自己加的):补老师目录 agents/<name>/——「加老师 = 加文件 + 目录,没有注册表」,
  * 自己加的老师文件不在这里生成(cotutor add 生成模板),缺了由 doctor 点名。
  */
 export async function installTutors(root, configured = []) {
     const steps = [];
     const manifest = await readManifest(root);
-    let touched = false;
-    const shipped = await shippedAgents();
+    let touched = !manifest.teachingPack;
+    manifest.teachingPack ??= { grade: (await workspaceGradePack(root)).grade };
+    const shipped = await shippedAgents((await workspaceGradePack(root)).agentsDir);
     for (const a of shipped) {
         const s = await readState(root, a, manifest);
-        const item = `.claude/agents/${basename(a.file)}`;
-        if (s.state === 'missing' || s.legacyLink || s.state === 'broken') {
+        const item = `agents/${basename(a.file)}`;
+        if (s.state === 'missing' || s.state === 'broken') {
             await installOne(root, a, manifest);
             touched = true;
-            steps.push({ item, action: s.state === 'missing' ? 'created' : 'replaced', note: s.legacyLink ? '旧的包内链换成拷贝(2026-09-09 起老师文件是你的)' : s.state === 'broken' ? '读不到,重新拷贝' : `拷自本包 ${PACKAGE_VERSION}` });
+            steps.push({ item, action: s.state === 'missing' ? 'created' : 'replaced', note: s.state === 'broken' ? '读不到,重新拷贝' : `拷自本包 ${PACKAGE_VERSION}` });
         }
         else if (s.state === 'untracked') {
             // 没记录但内容在:当家长的,记一笔当前 hash 免得以后一直是 untracked?不记——记了就等于宣称它是出厂件。留 untracked。
@@ -123,17 +84,11 @@ export async function installTutors(root, configured = []) {
         else {
             steps.push({ item, action: 'exists', note: s.state === 'custom' ? `自定义(基于 ${s.basedOn})` : s.state === 'upgradable' ? `可升级(cotutor upgrade)` : undefined });
         }
-        const q = await ensureQwenLink(root, a.name);
-        steps.push({ item: `.qwen/agents/${basename(a.file)}`, action: q, note: q === 'exists' ? undefined : '→ ../../.claude/agents/' });
     }
     for (const name of configured.filter((n) => !shipped.some((a) => a.name === n))) {
-        const { claude } = tutorFiles(root, name);
-        if (await lstat(claude).catch(() => null)) {
-            const q = await ensureQwenLink(root, name);
-            steps.push({ item: `.qwen/agents/${name}.md`, action: q, note: q === 'exists' ? undefined : '→ ../../.claude/agents/(自家的老师)' });
-        }
-        else
-            steps.push({ item: `.claude/agents/${name}.md`, action: 'kept', note: `缺:cotutor.json 里有 ${name},文件还没写;cotutor add ${name} 出模板,或自己写(frontmatter name: ${name})` });
+        const file = tutorFile(root, name);
+        if (!(await lstat(file).catch(() => null)))
+            steps.push({ item: `agents/${name}.md`, action: 'kept', note: `缺:cotutor.json 里有 ${name},文件还没写;cotutor add ${name} 出模板,或自己写(frontmatter name: ${name})` });
     }
     for (const name of [...new Set([...shipped.map((a) => a.name), ...configured])]) {
         const home = join(root, 'agents', name);
@@ -150,22 +105,21 @@ export async function installTutors(root, configured = []) {
     return steps;
 }
 /**
- * cotutor add <name>:按出厂老师的结构写一份模板(约定都带上,人设一句留给家长填)、建目录与 .qwen 链。
+ * cotutor add <name>:按出厂老师的结构写一份模板(约定都带上,人设一句留给家长填)、建目录。
  * 不动 cotutor.json——那是调用方(main / 页面)用 patchConfig 加的,同一条路。已有同名文件就拒,不覆盖。
  */
 export async function addTutorFile(root, input) {
     if (!AGENT_NAME_RE.test(input.name))
         throw new UsageError(`老师名 "${input.name}" 不合规:小写字母数字连字符,如 science-tutor`);
-    const { claude } = tutorFiles(root, input.name);
-    if (await lstat(claude).catch(() => null))
-        throw new UsageError(`${claude} 已经在了;要改就直接改它,要重来先把它挪开`);
-    await mkdir(dirname(claude), { recursive: true });
-    await writeFile(claude, tutorTemplate(input));
-    await ensureQwenLink(root, input.name);
+    const file = tutorFile(root, input.name);
+    if (await lstat(file).catch(() => null))
+        throw new UsageError(`${file} 已经在了;要改就直接改它,要重来先把它挪开`);
+    await mkdir(dirname(file), { recursive: true });
+    await writeFile(file, tutorTemplate(input));
     const home = join(root, 'agents', input.name);
     await mkdir(home, { recursive: true });
     await writeFile(join(home, '.gitkeep'), '').catch(() => { });
-    return { name: input.name, file: claude, home };
+    return { name: input.name, file, home };
 }
 /** 最小行 diff(LCS),只为让家长看清改了哪几行;不追求 git 那么好 */
 export function lineDiff(a, b) {
@@ -201,18 +155,19 @@ export function lineDiff(a, b) {
  */
 export async function upgradeTutors(root, opts = {}) {
     const manifest = await readManifest(root);
+    manifest.teachingPack ??= { grade: (await workspaceGradePack(root)).grade };
     const steps = [];
-    for (const a of await shippedAgents()) {
+    for (const a of await shippedAgents((await workspaceGradePack(root)).agentsDir)) {
         const s = await readState(root, a, manifest);
         const force = opts.force?.includes(a.name) ?? false;
-        if (s.state === 'latest' && !s.legacyLink) {
+        if (s.state === 'latest') {
             steps.push({ name: a.name, action: 'latest', basedOn: s.basedOn });
         }
         else if (s.state === 'missing' || s.state === 'broken') {
             await installOne(root, a, manifest);
             steps.push({ name: a.name, action: 'installed' });
         }
-        else if (s.state === 'upgradable' || s.legacyLink || (s.state === 'latest' && s.legacyLink)) {
+        else if (s.state === 'upgradable') {
             await installOne(root, a, manifest);
             steps.push({ name: a.name, action: 'upgraded', basedOn: s.basedOn });
         }
@@ -227,48 +182,69 @@ export async function upgradeTutors(root, opts = {}) {
             const shipped = await readFile(a.file, 'utf8');
             steps.push({ name: a.name, action: 'kept-custom', basedOn: s.basedOn, diff: lineDiff(mine, shipped) });
         }
-        await ensureQwenLink(root, a.name);
     }
     await writeManifest(root, { ...manifest, version: PACKAGE_VERSION });
     await writeSchemaFile(root);
-    await writeSyntaxFile(root);
     return steps;
 }
 export async function readTutorFile(root, name) {
-    const { claude } = tutorFiles(root, name);
-    const text = await readFile(claude, 'utf8').catch(() => null);
+    const file = tutorFile(root, name);
+    const text = await readFile(file, 'utf8').catch(() => null);
     if (text === null)
-        throw new UsageError(`老师文件不在:${claude};cotutor add ${name} --display <显示名> 可出模板`);
+        throw new UsageError(`老师文件不在:${file};cotutor add ${name} --display <显示名> 可出模板`);
     const st = (await tutorStatuses(root)).find((s) => s.name === name);
     return { name, text, state: st?.state ?? 'own', basedOn: st?.basedOn };
 }
 /** 页面上改老师正文:frontmatter 的 name 必须还是它;写完 doctor 会把它标成自定义 */
 export async function writeTutorFile(root, name, text) {
-    const { parseAgentFile } = await import("../lib/agent-file.js");
+    const { parseAgentFile } = await import("../../runtime/agent-file.js");
     const fm = parseAgentFile(text).frontmatter;
     if (fm.name !== name)
         throw new UsageError(`frontmatter 的 name 要是 ${name}(现在是 "${fm.name ?? ''}"),老师键靠它对上`);
-    const { claude } = tutorFiles(root, name);
-    await mkdir(dirname(claude), { recursive: true });
-    const tmp = `${claude}.tmp`;
+    const file = tutorFile(root, name);
+    await mkdir(dirname(file), { recursive: true });
+    const tmp = `${file}.tmp`;
     await writeFile(tmp, text.endsWith('\n') ? text : `${text}\n`);
-    await rename(tmp, claude);
-    await ensureQwenLink(root, name);
+    await rename(tmp, file);
     return readTutorFile(root, name);
 }
 /** 删自家加的老师文件:改名成 .removed-<时间>(不真删;记忆目录与对话不动);出厂的不让删,用开关 */
 export async function removeTutorFile(root, name) {
-    if ((await shippedAgents()).some((a) => a.name === name))
+    if ((await shippedAgents((await workspaceGradePack(root)).agentsDir)).some((a) => a.name === name))
         throw new UsageError(`${name} 是出厂老师,不删文件;不想用就在老师团页关掉`);
-    const { claude, qwen } = tutorFiles(root, name);
-    await unlink(qwen).catch(() => { });
+    const file = tutorFile(root, name);
     const stamp = new Date().toISOString().replace(/[:.]/g, '-');
-    const moved = `${claude}.removed-${stamp}`;
+    const moved = `${file}.removed-${stamp}`;
     try {
-        await rename(claude, moved);
+        await rename(file, moved);
         return { moved };
     }
     catch {
         return { moved: null };
     }
 }
+/** 出厂那份老师文件的原文;不是出厂的 → null */
+export async function shippedTutorText(name, root) {
+    const a = (await shippedAgents(root ? (await workspaceGradePack(root)).agentsDir : undefined)).find((x) => x.name === name);
+    return a ? readFile(a.file, 'utf8') : null;
+}
+/**
+ * 只把一位出厂老师的文件换回出厂那份(工作台「恢复出厂」,与 upgrade --force <老师> 同一条路,但不碰别的老师):
+ * 现在那份和出厂不一样就先存 .bak。不是出厂的 → UsageError。返回 .bak 的路径(没存就是 null)
+ */
+export async function restoreTutor(root, name) {
+    const a = (await shippedAgents((await workspaceGradePack(root)).agentsDir)).find((x) => x.name === name);
+    if (!a)
+        throw new UsageError(`${name} 是自家加的老师,没有出厂那份可换`);
+    const manifest = await readManifest(root);
+    const file = tutorFile(root, name);
+    const cur = await readFile(file, 'utf8').catch(() => null);
+    let bak = null;
+    if (cur !== null && cur !== (await readFile(a.file, 'utf8'))) {
+        bak = `${file}.bak`;
+        await writeFile(bak, cur);
+    }
+    await installOne(root, a, manifest);
+    await writeManifest(root, manifest);
+    return { bak };
+}

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

@@ -0,0 +1,2 @@
+/** 命令用法(cotutor --help;技能 cotutor-analyze 的 references/命令与文件.md 从这里取分析用的那几行,所以放单独文件,别的模块 import 不会跑到 CLI) */
+export declare const USAGE = "\u7528\u6CD5:\n  cotutor init <slug> [--dir <path>] [--name <\u5B69\u5B50\u540D>] [--grade <1-6>] [--port <n>]   \u5EFA ~/cotutor/<slug>/ \u9AA8\u67B6(\u5E42\u7B49\u8865\u7F3A;\u9ED8\u8BA4\u4E8C\u5E74\u7EA7\u6559\u5B66\u5305)\n  cotutor grades [--json]                                          \u5217\u51FA\u672C\u5305\u53EF\u5B89\u88C5\u7684\u5E74\u7EA7\u6559\u5B66\u5305\n  cotutor doctor [--workspace <dir>] [--json] [--live]                 \u9010\u9879\u4F53\u68C0;--live \u771F\u8D77\u4E00\u6B21\u8001\u5E08\u4E0E\u914D\u97F3(\u82B1\u4E00\u5206\u94B1)\u628A API \u5C42\u7684\u5751\u6446\u51FA\u6765\n  cotutor upgrade [--workspace <dir>] [--force <\u8001\u5E08>]...                \u8001\u5E08\u6587\u4EF6\u3001activity \u4E0E skill \u6362\u65B0\u7248:\u6CA1\u6539\u8FC7\u7684\u76F4\u63A5\u6362,\u6539\u8FC7\u7684\u53EA\u62A5 diff(--force <\u8001\u5E08> \u6216 --force <\u8001\u5E08>/<\u540D> \u624D\u8986\u76D6,\u539F\u6587\u7559 .bak)\n  cotutor upgrade --config [--dry-run] [--workspace <dir>]              cotutor.json \u8865\u7F3A:\u65B0\u51FA\u5382\u8001\u5E08 / \u8FD0\u884C\u65F6 / \u547D\u4EE4\u6A21\u677F\u65D7\u6807(\u53EA\u52A0\u7F3A\u7684,\u4F60\u6539\u8FC7\u7684\u503C\u4E0D\u52A8)\n  cotutor add <\u8001\u5E08\u540D> --display <\u663E\u793A\u540D> [--subject <\u5B66\u79D1>] [--avatar <emoji|\u56FE\u7247\u76F8\u5BF9\u8DEF\u5F84>] [--hidden]   \u52A0\u4E00\u4F4D\u81EA\u5BB6\u7684\u8001\u5E08:\u51FA\u6A21\u677F\u6587\u4EF6\u3001\u8FDB cotutor.json\u3001\u5EFA\u76EE\u5F55(\u540D\u5B57\u4EE5 -tutor \u7ED3\u5C3E\u7684\u662F\u8001\u5E08,figshot \u7ED9\u5B83\u505A\u5934\u50CF)\n  cotutor add-theme <\u4E3B\u9898\u540D> [--from <\u4E3B\u9898>] [--workspace <dir>]       \u52A0\u4E00\u4E2A\u81EA\u5BB6\u7684\u4E3B\u9898:\u62F7\u4E00\u4EFD(\u7F3A\u7701\u51FA\u5382\u7684 default)\u5230 themes/<\u4E3B\u9898\u540D>/,\u6539 cotutor.json \u7684 kid.theme \u6362\u8FC7\u53BB\n  cotutor serve [--workspace <dir>] [--port <n>] [--http] [--trace] [--open-qr]   \u8D77\u670D\u52A1(\u4E00 workspace \u4E00\u8FDB\u7A0B;~/.config/cotutor/certs/ \u6709\u8BC1\u4E66\u5C31\u8D70 HTTPS;--trace \u6BCF\u4E00\u8F6E\u7684\u4E8B\u4EF6\u6309\u9053\u6253\u5370;/dev/qr \u662F\u626B\u7801\u9875,--open-qr \u987A\u624B\u6253\u5F00)\n  cotutor pin [off | status] [--pin <\u6570\u5B57>] [--json]                       \u5BB6\u957F\u7AEF /parent \u4E0E\u5DE5\u4F5C\u53F0 /dev \u7684\u9501:\u673A\u5668\u7EA7 PIN(\u6240\u6709 workspace \u5171\u7528),iPad \u4E0A\u8F93\u4E00\u6B21\u3001\u8FD9\u53F0\u7535\u8111\u514D\u5BC6;\u6CA1\u8BBE\u5C31\u5168\u5F00(\u5BB6\u957F\u5728\u65C1\u8FB9\u53EF\u4EE5\u4E0D\u8BBE);off \u64A4\u6389\n  cotutor cert [--host <\u540D\u6216IP>]...                                      \u7528 mkcert \u5EFA\u8FD9\u53F0\u673A\u5668\u7684\u81EA\u7B7E\u8BC1\u4E66\u5230 ~/.config/cotutor/certs/(iPad / iPhone \u4E0A\u5F55\u97F3\u8981 HTTPS;\u6240\u6709 workspace \u5171\u7528)\n  cotutor send <\u8001\u5E08> [<\u6D88\u606F>] [--from kid|system] [--runtime <\u540D>] [--new] [--photo a.jpg,b.png] [--activity <\u540D> [--param '\u540D=\u503C;\u540D=\u503C']] [--lane main,tts] [--quiet]   \u7EC8\u7AEF\u91CC\u53D1\u4E00\u6761,\u73B0\u573A\u6309\u9053\u6253\u5370\u6BCF\u9053\u5DE5\u5E8F\u7684\u4E8B\u4EF6,\u8BF4\u5B8C\u6253\u5370\u7ED3\u679C(\u4E0E\u9875\u9762\u540C\u4E00\u6761\u8DEF;--new \u5F00\u65B0\u8BDD\u9898;--photo \u5E26\u4F5C\u4E1A\u7167\u7247,\u62F7\u8FDB captures/,\u6709\u7167\u7247\u65F6\u6D88\u606F\u53EF\u4EE5\u7A7A;--activity \u50CF\u5B69\u5B50\u70B9\u4E86\u9996\u9875\u7684 activity \u6309\u94AE,\u65B0\u5F00\u8BDD\u9898,\u53C2\u6570\u540C\u6309\u94AE\u4E0B\u9762\u90A3\u51E0\u884C;--quiet \u53EA\u8981\u7ED3\u679C)\n  cotutor pack <\u8001\u5E08> [<\u6D88\u606F>] [--from kid|system] [--at <ISO\u65F6\u95F4>] [--activity <\u540D> [--param '\u540D=\u503C;\u540D=\u503C']] [--json]   \u5E72\u8DD1\u4E0A\u4E0B\u6587\u5305(--activity \u770B activity \u8BDD\u9898\u7B2C\u4E00\u6761\u8001\u5E08\u62FF\u5230\u4EC0\u4E48):\u4E0D\u8D77\u6A21\u578B,\u6253\u5370\u73B0\u5728\u4F1A\u53D1\u7ED9\u8001\u5E08\u7684\u90A3\u4EFD + \u6BCF\u6BB5\u6765\u81EA\u54EA\u4E2A\u6587\u4EF6\u3001\u90A3\u91CC\u4E00\u5171\u51E0\u6761\u3001\u6309\u653F\u7B56\u5E26\u4E86\u51E0\u6761(\u6539\u4E86\u6863\u6848 / \u65E5\u8BB0 / \u8BA1\u5212\u7ACB\u523B\u770B\u6548\u679C)\n  cotutor replay <\u8001\u5E08> <job> [<\u65E5\u671F>] [--runtime <\u540D>] [--json]   \u56DE\u653E\u4E00\u8F6E:\u540C\u4E00\u95EE\u6309\u73B0\u5728\u7684 vault \u4E0E\u63D0\u793A\u8BCD\u518D\u8DD1\u4E00\u904D(\u843D evals/,\u4E0D\u8FDB\u5B69\u5B50\u7684\u5BF9\u8BDD\u3001\u4E0D\u914D\u97F3),\u8DD1\u5B8C\u5E76\u6392\u6253\u5370\u4E0A\u4E0B\u6587\u5305 / \u8BB2\u7A3F / \u5361 / \u8BFB\u4E86\u4EC0\u4E48\u7684 diff\n  cotutor compare <\u8001\u5E08> [<evalJob>] [<\u65E5\u671F>] [--json]                   \u518D\u770B\u4E00\u6B21\u56DE\u653E\u7684\u5BF9\u7167(\u4E0D\u7ED9 evalJob \u5C31\u5217\u8FD9\u5929\u56DE\u653E\u8FC7\u54EA\u4E9B)\n  cotutor show <\u8001\u5E08> <job> [<\u65E5\u671F>] [--json] [--evals] [--workspace <dir>]   \u770B\u4E00\u8F6E:\u95EE\u4E86\u4EC0\u4E48\u3001\u4E0A\u4E0B\u6587\u5305\u3001\u5F53\u65F6\u7684\u8001\u5E08\u6587\u4EF6\u4E0E\u6280\u80FD hash\u3001\u8BB2\u7A3F\u4E0E\u5361\u3001\u8BFB\u4E86\u4EC0\u4E48\u3001token \u4E0E\u7528\u65F6\u3001\u7ED9\u5BB6\u957F\u7684\u5C3E\u5DF4;--json \u662F\u5BB6\u957F\u7AEF\u300C\u770B\u539F\u6587\u300D\u540C\u4E00\u4EFD\u6570\u636E,\u7ED9\u7F16\u7A0B\u52A9\u624B\u5206\u6790\u7528\n  cotutor trace <\u8001\u5E08> <job> [<\u65E5\u671F>] [--lane \u2026] [--workspace <dir>]     \u56DE\u653E\u4E00\u8F6E\u7684\u4E8B\u4EF6(<\u65E5\u671F>.<job>.events.jsonl;\u6392\u67E5\u6628\u5929\u90A3\u8F6E\u7528)\n  cotutor rate <\u8001\u5E08> <\u8BDD\u9898> <1-5> [--date <\u65E5\u671F>]                       \u7ED9\u4E00\u4E2A\u8BDD\u9898\u6253\u661F(\u4E0E\u5BB6\u957F\u7AEF\u540C\u4E00\u6761\u8DEF;\u2265 vault.keepScore \u7684\u8BDD\u9898\u8BB0\u8D26\u65F6\u6458\u8981\u624D\u8FDB\u65E5\u8BB0)\n  cotutor bookkeep <\u8001\u5E08> [--date <\u65E5\u671F>] [--thread <\u8BDD\u9898>]...           \u8BB0\u8D26:\u8FD9\u5929\u6BCF\u4E2A\u8FD8\u6CA1\u8BB0\u8FC7\u7684\u8BDD\u9898\u5404\u8D77\u4E00\u8F6E\u8BB0\u8D26\u4EFB\u52A1,\u8001\u5E08\u56DE\u300C## \u8BB0\u8D26\u300D,\u5E94\u7528\u5199\u8FDB vault \u7684\u65E5\u8BB0(\u8BDD\u9898\u540D\u3001\u5B69\u5B50\u95EE\u3001\u6458\u8981\u3001\u89C2\u5BDF)\n  cotutor home check [--published] [--json]                           \u68C0\u67E5\u9996\u9875\u8349\u7A3F home/draft.md(\u6216\u5DF2\u53D1\u5E03\u7684\u90A3\u4EFD):\u5B69\u5B50\u4F1A\u770B\u5230\u54EA\u51E0\u5F20\u5361\u3001\u6BCF\u4F4D\u8001\u5E08\u7684\u6309\u94AE\u3001\u8981\u6539\u7684\u4E0E\u63D0\u9192(\u5E26\u884C\u53F7);\u4E0D\u82B1\u94B1\n  cotutor home publish [--force] [--from <\u6587\u4EF6>] [--json]              \u53D1\u5E03\u9996\u9875:\u68C0\u67E5 \u2192 \u7559\u5386\u53F2 home/history/<id>.md \u2192 \u5199 home/published.json(\u5B69\u5B50\u7AEF\u53EA\u8BFB\u5B83);\u6709\u8981\u6539\u7684\u4E0D\u53D1,--force \u4E22\u6389\u90A3\u51E0\u5F20\u7167\u53D1;--from \u53D1\u53E6\u4E00\u4EFD(\u5982\u5386\u53F2)\n  cotutor home show [--json]                                          \u73B0\u5728\u53D1\u5E03\u7684\u662F\u54EA\u4EFD\u3001\u51E0\u5929\u524D\u3001\u6BCF\u4E2A\u6309\u94AE\u88AB\u70B9\u4E86\u51E0\u6B21(\u54EA\u5929\u3001\u54EA\u4E2A\u8BDD\u9898)\n  cotutor activity check [<\u8001\u5E08> [<\u540D>]] [--json]                      \u68C0\u67E5 activity \u6587\u4EF6(agents/<\u8001\u5E08>/activities/<\u540D>.md):\u5BB6\u957F\u586B\u7684\u3001\u5E94\u7528\u7B97\u7684\u3001\u5E94\u7528\u62E6\u7684\u3001\u88C1\u6BB5\u3001\u63D2\u69FD\u3001\u6B63\u6587\u7528\u7684\u5361\u3001\u7B2C\u4E00\u53E5\u4E0E\u6536(\u5E26\u884C\u53F7);\u4E0D\u82B1\u94B1\n  cotutor activity eval <\u8001\u5E08> <\u540D> [--runs <n>] [--only <\u4F8B\u5B50>] [--kid-model <\u5343\u95EE\u6A21\u578B>] [--json]   \u7167 <\u540D>.\u4F8B\u5B50.md \u8DD1:\u771F\u8001\u5E08 + \u6A21\u62DF\u5B69\u5B50(\u5343\u95EE,\u7F3A\u7701 qwen3.8-flash,\u6709 Token Plan \u8D70\u5B83)\u591A\u8F6E,\u5224\u53EA\u770B\u677F\u4E66;\u4E00\u4E2A\u4F8B\u5B50\u8DD1 n \u6B21(\u7F3A\u7701 3)\u6B21\u6B21\u90FD\u8FC7\u624D\u7B97\u8FC7;\u843D evals/,\u753B\u5BB6\u662F\u5047\u7684;\u82B1\u94B1\n  cotutor chalk <check|build|bake|snap|dub> <scene.ts|\u8BFE\u5305 id> [...]   \u505A\u5C0F\u8BFE\u5802\u7684\u8BFE\u5305:check \u6821\u9A8C\u573A\u666F\u3001build \u51FA\u8BFE\u5305\u5230 bundles/\u3001bake \u70E4\u753B\u9762\u3001snap \u6BCF\u6B65\u622A\u56FE\u3001dub \u914D\u97F3(cotutor chalk \u770B\u5404\u81EA\u7684\u9009\u9879;bake / snap \u8981\u672C\u673A\u7684 Chrome)\n  cotutor mock [--port <n>] [--scenario normal|nokey] [--delay <ms>] [--http]   \u4E0D\u7ECF\u771F\u5B9E\u8001\u5E08\u4E0E\u767E\u70BC,\u7528\u56FA\u5B9A\u7684\u677F\u4E66 JSON \u8D77\u5B69\u5B50\u7AEF,\u6D4B\u524D\u7AEF\u4EA4\u4E92\u4E0E\u6E32\u67D3(\u4E0D\u9700\u8981 workspace;\u8001\u5E08\u90FD\u8D70\u5B9E\u65F6\u8001\u5E08\u9875,\u5047\u5634\u7167\u811A\u672C\u5FF5\u9759\u97F3\u7684\u58F0\u97F3;nokey = \u6CA1\u914D\u767E\u70BC,\u5B69\u5B50\u7AEF\u53EA\u51FA\u300C\u8001\u5E08\u4EEC\u8FD8\u6CA1\u5230\u300D)\n  cotutor --version | --help\nworkspace\u89E3\u6790:--workspace > COTUTOR_WORKSPACE > cwd \u6216\u7956\u5148\u6709 cotutor.json > ~/.config/cotutor/config.json > ~/cotutor/ \u4E0B\u552F\u4E00\u7684\u5B69\u5B50\u76EE\u5F55\n";

package/dist/app/cli/usage.js

@@ -0,0 +1,30 @@
+/** 命令用法(cotutor --help;技能 cotutor-analyze 的 references/命令与文件.md 从这里取分析用的那几行,所以放单独文件,别的模块 import 不会跑到 CLI) */
+export const USAGE = `用法:
+  cotutor init <slug> [--dir <path>] [--name <孩子名>] [--grade <1-6>] [--port <n>]   建 ~/cotutor/<slug>/ 骨架(幂等补缺;默认二年级教学包)
+  cotutor grades [--json]                                          列出本包可安装的年级教学包
+  cotutor doctor [--workspace <dir>] [--json] [--live]                 逐项体检;--live 真起一次老师与配音(花一分钱)把 API 层的坑摆出来
+  cotutor upgrade [--workspace <dir>] [--force <老师>]...                老师文件、activity 与 skill 换新版:没改过的直接换,改过的只报 diff(--force <老师> 或 --force <老师>/<名> 才覆盖,原文留 .bak)
+  cotutor upgrade --config [--dry-run] [--workspace <dir>]              cotutor.json 补缺:新出厂老师 / 运行时 / 命令模板旗标(只加缺的,你改过的值不动)
+  cotutor add <老师名> --display <显示名> [--subject <学科>] [--avatar <emoji|图片相对路径>] [--hidden]   加一位自家的老师:出模板文件、进 cotutor.json、建目录(名字以 -tutor 结尾的是老师,figshot 给它做头像)
+  cotutor add-theme <主题名> [--from <主题>] [--workspace <dir>]       加一个自家的主题:拷一份(缺省出厂的 default)到 themes/<主题名>/,改 cotutor.json 的 kid.theme 换过去
+  cotutor serve [--workspace <dir>] [--port <n>] [--http] [--trace] [--open-qr]   起服务(一 workspace 一进程;~/.config/cotutor/certs/ 有证书就走 HTTPS;--trace 每一轮的事件按道打印;/dev/qr 是扫码页,--open-qr 顺手打开)
+  cotutor pin [off | status] [--pin <数字>] [--json]                       家长端 /parent 与工作台 /dev 的锁:机器级 PIN(所有 workspace 共用),iPad 上输一次、这台电脑免密;没设就全开(家长在旁边可以不设);off 撤掉
+  cotutor cert [--host <名或IP>]...                                      用 mkcert 建这台机器的自签证书到 ~/.config/cotutor/certs/(iPad / iPhone 上录音要 HTTPS;所有 workspace 共用)
+  cotutor send <老师> [<消息>] [--from kid|system] [--runtime <名>] [--new] [--photo a.jpg,b.png] [--activity <名> [--param '名=值;名=值']] [--lane main,tts] [--quiet]   终端里发一条,现场按道打印每道工序的事件,说完打印结果(与页面同一条路;--new 开新话题;--photo 带作业照片,拷进 captures/,有照片时消息可以空;--activity 像孩子点了首页的 activity 按钮,新开话题,参数同按钮下面那几行;--quiet 只要结果)
+  cotutor pack <老师> [<消息>] [--from kid|system] [--at <ISO时间>] [--activity <名> [--param '名=值;名=值']] [--json]   干跑上下文包(--activity 看 activity 话题第一条老师拿到什么):不起模型,打印现在会发给老师的那份 + 每段来自哪个文件、那里一共几条、按政策带了几条(改了档案 / 日记 / 计划立刻看效果)
+  cotutor replay <老师> <job> [<日期>] [--runtime <名>] [--json]   回放一轮:同一问按现在的 vault 与提示词再跑一遍(落 evals/,不进孩子的对话、不配音),跑完并排打印上下文包 / 讲稿 / 卡 / 读了什么的 diff
+  cotutor compare <老师> [<evalJob>] [<日期>] [--json]                   再看一次回放的对照(不给 evalJob 就列这天回放过哪些)
+  cotutor show <老师> <job> [<日期>] [--json] [--evals] [--workspace <dir>]   看一轮:问了什么、上下文包、当时的老师文件与技能 hash、讲稿与卡、读了什么、token 与用时、给家长的尾巴;--json 是家长端「看原文」同一份数据,给编程助手分析用
+  cotutor trace <老师> <job> [<日期>] [--lane …] [--workspace <dir>]     回放一轮的事件(<日期>.<job>.events.jsonl;排查昨天那轮用)
+  cotutor rate <老师> <话题> <1-5> [--date <日期>]                       给一个话题打星(与家长端同一条路;≥ vault.keepScore 的话题记账时摘要才进日记)
+  cotutor bookkeep <老师> [--date <日期>] [--thread <话题>]...           记账:这天每个还没记过的话题各起一轮记账任务,老师回「## 记账」,应用写进 vault 的日记(话题名、孩子问、摘要、观察)
+  cotutor home check [--published] [--json]                           检查首页草稿 home/draft.md(或已发布的那份):孩子会看到哪几张卡、每位老师的按钮、要改的与提醒(带行号);不花钱
+  cotutor home publish [--force] [--from <文件>] [--json]              发布首页:检查 → 留历史 home/history/<id>.md → 写 home/published.json(孩子端只读它);有要改的不发,--force 丢掉那几张照发;--from 发另一份(如历史)
+  cotutor home show [--json]                                          现在发布的是哪份、几天前、每个按钮被点了几次(哪天、哪个话题)
+  cotutor activity check [<老师> [<名>]] [--json]                      检查 activity 文件(agents/<老师>/activities/<名>.md):家长填的、应用算的、应用拦的、裁段、插槽、正文用的卡、第一句与收(带行号);不花钱
+  cotutor activity eval <老师> <名> [--runs <n>] [--only <例子>] [--kid-model <千问模型>] [--json]   照 <名>.例子.md 跑:真老师 + 模拟孩子(千问,缺省 qwen3.8-flash,有 Token Plan 走它)多轮,判只看板书;一个例子跑 n 次(缺省 3)次次都过才算过;落 evals/,画家是假的;花钱
+  cotutor chalk <check|build|bake|snap|dub> <scene.ts|课包 id> [...]   做小课堂的课包:check 校验场景、build 出课包到 bundles/、bake 烤画面、snap 每步截图、dub 配音(cotutor chalk 看各自的选项;bake / snap 要本机的 Chrome)
+  cotutor mock [--port <n>] [--scenario normal|nokey] [--delay <ms>] [--http]   不经真实老师与百炼,用固定的板书 JSON 起孩子端,测前端交互与渲染(不需要 workspace;老师都走实时老师页,假嘴照脚本念静音的声音;nokey = 没配百炼,孩子端只出「老师们还没到」)
+  cotutor --version | --help
+workspace解析:--workspace > COTUTOR_WORKSPACE > cwd 或祖先有 cotutor.json > ~/.config/cotutor/config.json > ~/cotutor/ 下唯一的孩子目录
+`;

package/dist/app/dictation/recognize.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 旧路径与接线:拍照认词的规则在 src/scenes/dictation/recognize.ts,看图的请求在 src/media/vision.ts;recognizePhoto 把两样接起来(路由、测试用)
+ */
+import type { DictationLang } from '../../board/cards/index.ts';
+import { type PhotoProgress, type Recognized } from '../../scenes/dictation/recognize.ts';
+export * from '../../scenes/dictation/recognize.ts';
+export declare function recognizePhoto(image: {
+    data: Buffer;
+    mime: string;
+}, onProgress?: (p: PhotoProgress) => void, opts?: {
+    env?: NodeJS.ProcessEnv;
+    endpoint?: string;
+    model?: string;
+    prompt?: readonly string[];
+    text?: string;
+    timeoutMs?: number;
+    lang?: DictationLang;
+}): Promise<Recognized>;

package/dist/app/dictation/recognize.js

@@ -0,0 +1,6 @@
+import { lookAt } from "../../media/vision.js";
+import { recognizeWith } from "../../scenes/dictation/recognize.js";
+export * from "../../scenes/dictation/recognize.js";
+export function recognizePhoto(image, onProgress = () => { }, opts = {}) {
+    return recognizeWith(lookAt, image, onProgress, opts);
+}

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

@@ -0,0 +1,52 @@
+import { type DictationLang, type DictationProps, type DictationWord } from '../../board/cards/index.ts';
+import type { AppContext, RouteResult } from '../http/app.ts';
+import { type InkPoint } from '../../scenes/dictation/match.ts';
+import { type Recognize } from './recognize.ts';
+import { type CharInk, type Session } from '../../scenes/dictation/store.ts';
+export interface DictationDeps {
+    /** workspace 根 */
+    root: string;
+    now(): Date;
+    /** 首页 home 里的第 n 张听写卡(0 起);home 不是现在发布的那份、没有这张 → null */
+    card(home: string | null, n: number): Promise<DictationProps | null>;
+    /** 谁念:卡上写的老师在就用他,不然语文老师,再不然第一位配了音色的;都没有 null */
+    reader(tutor: string | undefined): string | null;
+    /** 老师的显示名(听写页的气泡上) */
+    display(tutor: string | null): string;
+    /** 胶囊上的老师:颜色、首字、名字;没有这位老师 → null */
+    face(tutor: string | null): {
+        color: string;
+        initial: string;
+        display: string;
+    } | null;
+    /** 合成一句的音频文件;没有音色、合成失败 → null */
+    say(text: string, tutor: string | null): Promise<string | null>;
+    /** 念的老师配了音色没有:没有就孩子端直接提示叫家长,不念浏览器合成声 */
+    voiced(tutor: string | null): boolean;
+    /** 一个字的笔画中线(hanzi-writer-data);数据里没有 → null */
+    medians(ch: string): Promise<number[][][] | null>;
+    /** 认一张照片(流式,每认出一项回调一次);lang = en 认英文单词 */
+    recognize: Recognize;
+}
+/** 真服务的依赖:首页从 home/published.json 读,音色从 cotutor.json,配音缓存在 .cotutor/tts/(和卡的配音同一份) */
+export declare function dictationDeps(ctx: AppContext): DictationDeps;
+/**
+ * 认词的要求:workspace 里头上写着这一页(page: dictation / dictation-en)、有「认字收到什么」的那份听写 activity(按老师排第一份);
+ * 没有 → null(照出厂的要求)
+ */
+export declare function dictationTemplate(root: string, lang: DictationLang): Promise<string | null>;
+/** app.ts 接的那一行 */
+export declare function dictationRoute(method: string, url: URL, ctx: AppContext, body: unknown): Promise<RouteResult | null>;
+/** 页面交来的一个词:每个格 {strokes: [[x,y,t]...], undos, gone?: [{t, pts}]};格数要对上 */
+export declare function parseChars(v: unknown, size: number): CharInk[] | null;
+/** 孩子端看到的:交卷前只有几个词、每个词几个字、写了哪几个;交了才有字、问不问再写一遍、最近写的那遍 */
+export declare function kidView(s: Session, display: string, voiced: boolean): unknown;
+/**
+ * 一格的笔迹缩成一条 SVG path(家长端记录的听写格子画它):点取整、隔一个丢一个(首尾留着),不要时刻。
+ * 坐标照原样(汉字是 hanzi-writer 的 1024 尺、y 朝上;英文是 2048 × 512、y 朝下),画的那头自己翻
+ */
+export declare function inkPath(strokes: InkPoint[][]): string;
+/** 拍照开始时页面交来的词:1–20 个,每个 1–4 个汉字(lang = en:一个英文单词),念法可有可无(超长的丢掉念法);一种也不能混 */
+export declare function parseWords(v: unknown, lang?: DictationLang): DictationWord[] | null;
+export declare function photosIdle(): Promise<void>;
+export declare function handleDictation(method: string, url: URL, deps: DictationDeps, body: unknown): Promise<RouteResult | null>;