cotutor 0.2.0 → 0.4.0

package/dist/cli/main.js

@@ -1,243 +0,0 @@
-/**
- * cotutor CLI 入口。命令:init / doctor / serve;全局 --workspace <dir>、--json。
- * exit:0 通过 / 1 体检不过 / 2 用法错误 / 4 内部错误。
- */
-import { readFileSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
-import { doctorWorkspace } from "./doctor.js";
-import { initWorkspace } from "./init.js";
-import { makeCert } from "./cert.js";
-import { addTutorFile, upgradeTutors } from "./tutors.js";
-import { upgradeSkills, writeToolShim } from "./skills.js";
-import { patchConfig } from "../server/store.js";
-import { resolveRoot } from "./workspace.js";
-import { serveWorkspace } from "./serve.js";
-import { serveMock } from "../server/mock.js";
-import { UsageError, loadWorkspace, redactDeep, redactHome, workspaceReport } from "./workspace.js";
-import { createContext } from "../server/app.js";
-import { MESSAGE_FROM } from "../schema/index.js";
-const USAGE = `用法:
-  cotutor init <slug> [--dir <path>] [--name <孩子名>] [--port <n>]   建 ~/cotutor/<slug>/ 骨架(幂等补缺)
-  cotutor doctor [--workspace <dir>] [--json] [--live]                 逐项体检;--live 真起一次老师与配音(花一分钱)把 API 层的坑摆出来
-  cotutor upgrade [--workspace <dir>] [--force <老师>]...                老师文件换新版:没改过的直接换,改过的只报 diff(--force 才覆盖,原文留 .bak)
-  cotutor add <老师名> --display <显示名> [--subject <学科>] [--avatar <emoji>] [--hidden]   加一位自家的老师:出模板文件、进 cotutor.json、建目录
-  cotutor serve [--workspace <dir>] [--port <n>] [--http]               起服务(一 workspace 一进程;~/.config/cotutor/certs/ 有证书就走 HTTPS)
-  cotutor cert [--host <名或IP>]...                                      用 mkcert 建这台机器的自签证书到 ~/.config/cotutor/certs/(iPad 上录音要 HTTPS;所有 workspace 共用)
-  cotutor send <老师> <消息> [--from parent|kid|system] [--runtime <名>]   终端里发一条,等老师说完打印结果(与页面同一条路)
-  cotutor mock [--port <n>] [--scenario normal|limit|offline] [--delay <ms>] [--http]   不经真实老师与配音,用固定的板书 JSON 起孩子端,测前端交互与渲染(不需要 workspace)
-  cotutor --version | --help
-workspace解析:--workspace > COTUTOR_WORKSPACE > cwd 或祖先有 cotutor.json > ~/.config/cotutor/config.json > ~/cotutor/ 下唯一的孩子目录
-`;
-function version() {
-    const pkg = JSON.parse(readFileSync(fileURLToPath(new URL('../../package.json', import.meta.url)), 'utf8'));
-    return pkg.version;
-}
-function parseArgs(argv, valued) {
-    const flags = {};
-    const positionals = [];
-    let cmd;
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        if (a.startsWith('--')) {
-            const key = a.slice(2);
-            if (valued.includes(key)) {
-                const next = argv[i + 1];
-                if (next === undefined || next.startsWith('--'))
-                    throw new UsageError(`选项 --${key} 需要一个值。\n${USAGE}`);
-                flags[key] = next;
-                i++;
-            }
-            else
-                flags[key] = true;
-        }
-        else if (cmd === undefined)
-            cmd = a;
-        else
-            positionals.push(a);
-    }
-    return { cmd, positionals, flags };
-}
-export async function main(argv) {
-    let json = false;
-    try {
-        const { cmd, positionals, flags } = parseArgs(argv, ['workspace', 'dir', 'name', 'port', 'from', 'runtime', 'force', 'display', 'subject', 'avatar', 'description', 'scenario', 'delay']);
-        json = flags.json === true;
-        const workspace = typeof flags.workspace === 'string' ? flags.workspace : undefined;
-        // --version / --help 是旗标不是命令,parseArgs 把它们收进 flags,cmd 拿不到,所以在 switch 前处理
-        if (flags.version === true || cmd === '-v') {
-            process.stdout.write(`${version()}\n`);
-            return;
-        }
-        if (flags.help === true || cmd === undefined || cmd === '-h') {
-            process.stdout.write(USAGE);
-            return;
-        }
-        switch (cmd) {
-            case 'init': {
-                const slug = positionals[0];
-                if (!slug || !/^[a-z0-9][a-z0-9-]*$/.test(slug))
-                    throw new UsageError(`init 需要一个 slug(小写字母数字连字符,是短名不是真名),如 cotutor init ming。\n${USAGE}`);
-                const port = typeof flags.port === 'string' ? Number(flags.port) : undefined;
-                if (port !== undefined && !(Number.isInteger(port) && port > 0 && port < 65536))
-                    throw new UsageError('--port 要是 1–65535 的整数');
-                const r = await initWorkspace({ slug, dir: typeof flags.dir === 'string' ? flags.dir : undefined, name: typeof flags.name === 'string' ? flags.name : undefined, port });
-                if (json)
-                    process.stdout.write(`${JSON.stringify(redactDeep(r), null, 2)}\n`);
-                else {
-                    process.stdout.write(`cotutor init → ${redactHome(r.root)}\n`);
-                    for (const s of r.steps)
-                        process.stdout.write(`  ${s.action.padEnd(7)} ${s.item}${s.note ? `  (${s.note})` : ''}\n`);
-                    process.stdout.write('下一步:\n');
-                    for (const s of r.suggestions)
-                        process.stdout.write(`  - ${s}\n`);
-                }
-                return;
-            }
-            case 'doctor': {
-                const r = await doctorWorkspace(workspace, { live: flags.live === true });
-                if (json)
-                    process.stdout.write(`${JSON.stringify(redactDeep(r), null, 2)}\n`);
-                else {
-                    for (const c of r.checks) {
-                        process.stdout.write(`${c.ok ? '✓' : c.required ? '✗' : '!'} ${c.name.padEnd(28)} ${c.detail}\n`);
-                        if (!c.ok && c.fix)
-                            process.stdout.write(`    修复:${c.fix}\n`);
-                    }
-                    process.stdout.write(r.ok ? '体检通过\n' : '体检不过(✗ 是必需项)\n');
-                }
-                if (!r.ok)
-                    process.exitCode = 1;
-                return;
-            }
-            case 'serve': {
-                const port = typeof flags.port === 'string' ? Number(flags.port) : undefined;
-                const r = await serveWorkspace({ workspace, port, http: flags.http === true });
-                process.stdout.write(`cotutor serve ${JSON.stringify(workspaceReport(r.ws))}\n`);
-                for (const w of r.warnings)
-                    process.stdout.write(`  ! ${w}\n`);
-                if (!r.https)
-                    process.stdout.write('  ! HTTP:iPad Safari 上按住说话要 HTTPS;cotutor cert 建证书后重启即走 HTTPS\n');
-                for (const u of r.urls)
-                    process.stdout.write(`  ${u}\n`);
-                process.stdout.write(`  孩子端 /,家长端 /parent\n`);
-                return;
-            }
-            case 'mock': {
-                const port = typeof flags.port === 'string' ? Number(flags.port) : undefined;
-                if (port !== undefined && !(Number.isInteger(port) && port > 0 && port < 65536))
-                    throw new UsageError('--port 要是 1–65535 的整数');
-                const scenario = typeof flags.scenario === 'string' ? flags.scenario : 'normal';
-                if (!['normal', 'limit', 'offline'].includes(scenario))
-                    throw new UsageError('--scenario 只能是 normal / limit / offline');
-                const delayMs = typeof flags.delay === 'string' ? Number(flags.delay) : undefined;
-                if (delayMs !== undefined && !(Number.isInteger(delayMs) && delayMs >= 0))
-                    throw new UsageError('--delay 要是非负整数(毫秒)');
-                const r = await serveMock({ port, scenario: scenario, delayMs, http: flags.http === true });
-                process.stdout.write(`cotutor mock 场景 ${scenario}(不经真实老师与配音;配音退回浏览器合成声)\n`);
-                if (!r.https)
-                    process.stdout.write('  ! HTTP:iPad Safari 上按住说话要 HTTPS;cotutor cert 建证书后重启即走 HTTPS\n');
-                for (const u of r.urls)
-                    process.stdout.write(`  ${u}\n`);
-                process.stdout.write('  孩子端 /;直接开某位老师并停在某句:/?tutor=chinese-tutor&step=0.3\n');
-                return;
-            }
-            case 'add': {
-                const name = positionals[0];
-                const display = typeof flags.display === 'string' ? flags.display : undefined;
-                if (!name || !display)
-                    throw new UsageError(`add 需要老师名和 --display 显示名,如 cotutor add science-tutor --display 科学老师 --subject 科学 --avatar 🔬。\n${USAGE}`);
-                const ws = loadWorkspace(workspace);
-                if (ws.config.tutors[name])
-                    throw new UsageError(`cotutor.json 里已经有 ${name} 了;要改人设去老师团页或直接改文件`);
-                const subject = typeof flags.subject === 'string' ? flags.subject : undefined;
-                const r = await addTutorFile(ws.root, { name, display, subject, description: typeof flags.description === 'string' ? flags.description : undefined });
-                await patchConfig(ws, { tutors: { [name]: { display, ...(subject ? { subject } : {}), ...(typeof flags.avatar === 'string' ? { avatar: flags.avatar } : {}), enabled: true, ...(flags.hidden === true ? { hidden: true } : {}) } } });
-                if (json)
-                    process.stdout.write(`${JSON.stringify(redactDeep(r), null, 2)}\n`);
-                else {
-                    process.stdout.write(`加了 ${display}(${name}):\n  ${redactHome(r.file)}  ← 老师文件,打开把括号里那句换成这位老师的性子\n  cotutor.json tutors.${name}  ← 人设与政策(老师团页也能改)\n  ${redactHome(r.home)}/  ← 它的家\n`);
-                    process.stdout.write('服务不用重启;孩子端和家长端刷新就有。\n');
-                }
-                return;
-            }
-            case 'upgrade': {
-                const { root } = resolveRoot(workspace);
-                const force = typeof flags.force === 'string' ? [flags.force, ...positionals] : positionals;
-                const steps = await upgradeTutors(root, { force });
-                const skillSteps = await upgradeSkills(root);
-                await writeToolShim(root);
-                if (json)
-                    process.stdout.write(`${JSON.stringify(redactDeep({ root, steps, skills: skillSteps }), null, 2)}\n`);
-                else {
-                    const word = { upgraded: '已换新', latest: '已是最新', 'kept-custom': '自定义,保留', forced: '已覆盖(原文 .bak)', installed: '补上了', unavailable: 'drawtell-skills 没装,没法换' };
-                    for (const s of skillSteps)
-                        process.stdout.write(`${s.action === 'kept-custom' || s.action === 'unavailable' ? '!' : '✓'} skill ${s.name.padEnd(18)} ${word[s.action]}${s.basedOn && s.action !== 'latest' ? `(基于 ${s.basedOn})` : ''}\n`);
-                    for (const s of steps) {
-                        process.stdout.write(`${s.action === 'kept-custom' ? '!' : '✓'} ${s.name.padEnd(18)} ${word[s.action]}${s.basedOn && s.action !== 'latest' ? `(基于 ${s.basedOn})` : ''}\n`);
-                        if (s.diff?.length) {
-                            process.stdout.write(`    你的 vs 新版(- 你的 / + 新版),想用新版:cotutor upgrade --force ${s.name}\n`);
-                            for (const l of s.diff.slice(0, 40))
-                                process.stdout.write(`    ${l}\n`);
-                            if (s.diff.length > 40)
-                                process.stdout.write(`    …还有 ${s.diff.length - 40} 行\n`);
-                        }
-                    }
-                }
-                return;
-            }
-            case 'cert': {
-                const r = await makeCert(positionals.concat(typeof flags.host === 'string' ? [flags.host] : []));
-                if (json)
-                    process.stdout.write(`${JSON.stringify(redactDeep(r), null, 2)}\n`);
-                else {
-                    process.stdout.write(`证书:${redactHome(r.cert)}\n私钥:${redactHome(r.key)}\n主机:${r.hosts.join(' ')}\n`);
-                    process.stdout.write(`iPad 要先信任这台机器的根证书:把 ${redactHome(r.caRoot)}/rootCA.pem 隔空投送到 iPad → 设置里安装描述文件 → 通用 › 关于本机 › 证书信任设置里打开;然后重启 cotutor serve,用 https 打开。\n`);
-                }
-                return;
-            }
-            case 'send': {
-                const [tutor, ...words] = positionals;
-                const text = words.join(' ');
-                if (!tutor || !text)
-                    throw new UsageError(`send 需要老师名和消息,如 cotutor send math-tutor "这一步为什么要借位"。\n${USAGE}`);
-                const from = typeof flags.from === 'string' ? flags.from : 'parent';
-                if (!MESSAGE_FROM.includes(from))
-                    throw new UsageError(`--from 只能是 ${MESSAGE_FROM.join(' / ')}`);
-                const ctx = createContext(loadWorkspace(workspace));
-                const started = await ctx.runner.send(tutor, { from: from, text, runtime: typeof flags.runtime === 'string' ? flags.runtime : undefined });
-                if (!json)
-                    process.stdout.write(`→ ${tutor} ${started.date} ${started.job}(${started.plan.runtime}${started.plan.resume ? ',resume ' + started.plan.session : ',新会话'})…\n`);
-                const index = await started.done;
-                const m = index.messages.find((x) => x.job === started.job);
-                if (json)
-                    process.stdout.write(`${JSON.stringify({ tutor, date: started.date, job: started.job, runtime: started.plan.runtime, resume: started.plan.resume, message: m, session: index.session, costUsd: index.costUsd }, null, 2)}\n`);
-                else if (!m || m.result !== 'ok') {
-                    process.stdout.write(`本轮出错:${m?.error ?? '未知'};看 conversations/${tutor}/${started.date}.${started.job}.err.log\n`);
-                    process.exitCode = 1;
-                }
-                else {
-                    process.stdout.write(`孩子看到:${m.kidText ?? '(没有给孩子的话)'}\n`);
-                    if (m.holdup)
-                        process.stdout.write(`待裁量:${m.holdup.question}${m.holdup.options.length ? ' → ' + m.holdup.options.map((o) => o.label).join(' / ') : ''}\n`);
-                    if (m.handoff)
-                        process.stdout.write(`转交:${m.handoff.to}${m.handoff.why ? ' — ' + m.handoff.why : ''}\n`);
-                    process.stdout.write(`会话 ${index.session?.id ?? '?'} · 本轮 $${(m.costUsd ?? 0).toFixed(2)} · 今日 $${index.costUsd.toFixed(2)}\n`);
-                }
-                return;
-            }
-            default:
-                throw new UsageError(`未知命令 '${cmd}'。\n${USAGE}`);
-        }
-    }
-    catch (err) {
-        if (err instanceof UsageError) {
-            if (json)
-                process.stdout.write(`${JSON.stringify({ ok: false, error: 'usage', message: err.message })}\n`);
-            else
-                process.stderr.write(`cotutor: ${err.message}\n`);
-            process.exitCode = 2;
-            return;
-        }
-        throw err;
-    }
-}

package/dist/cli/serve.d.ts

@@ -1,30 +0,0 @@
-import { type Server } from 'node:http';
-import { type AppContext } from '../server/app.ts';
-import { type ResolveOptions, type Workspace } from './workspace.ts';
-export interface ServeOptions extends ResolveOptions {
-    workspace?: string;
-    port?: number;
-    host?: string;
-    /** 强制走 HTTP(哪怕证书在) */
-    http?: boolean;
-}
-export interface ServeResult {
-    server: Server;
-    ctx: AppContext;
-    ws: Workspace;
-    port: number;
-    https: boolean;
-    /** 本机名与局域网 IPv4 各一条 */
-    urls: string[];
-    /** 兼容:urls[0] */
-    url: string;
-    warnings: string[];
-}
-/** 证书路径:cotutor.json 的 server.https 优先(相对 workspace 根),否则机器级 ~/.config/cotutor/certs/;都没有 → null */
-export declare function httpsFiles(ws: Workspace): {
-    cert: string;
-    key: string;
-} | null;
-/** 局域网 IPv4(iPad 用它访问;.local 名不一定解析得到) */
-export declare function lanAddresses(): string[];
-export declare function serveWorkspace(opts?: ServeOptions): Promise<ServeResult>;

package/dist/cli/serve.js

@@ -1,56 +0,0 @@
-/**
- * cotutor serve:一 workspace 一进程(2026-09-08 拍板),端口读 cotutor.json(--port 覆盖)。
- * 启动打印解析结果与体检警告(配置坏了直接不起,骨架缺失只警告)。
- * HTTPS(iPad 上录音要):server.https 指了证书就用它(单个 workspace 的例外);没指就看机器级 ~/.config/cotutor/certs/(cotutor cert 用 mkcert 建);都没有走 HTTP。
- */
-import { readFileSync } from 'node:fs';
-import { createServer as createHttp } from 'node:http';
-import { createServer as createHttps } from 'node:https';
-import { hostname, networkInterfaces } from 'node:os';
-import { join } from 'node:path';
-import { doctorWorkspace } from "./doctor.js";
-import { createContext, createHandler } from "../server/app.js";
-import { USER_CERT_DIR, expandPath, loadWorkspace } from "./workspace.js";
-/** 证书路径:cotutor.json 的 server.https 优先(相对 workspace 根),否则机器级 ~/.config/cotutor/certs/;都没有 → null */
-export function httpsFiles(ws) {
-    const h = ws.config.server.https;
-    if (h)
-        return { cert: expandPath(h.cert, ws.root), key: expandPath(h.key, ws.root) };
-    const cert = join(USER_CERT_DIR, 'cert.pem');
-    const key = join(USER_CERT_DIR, 'key.pem');
-    try {
-        readFileSync(cert);
-        readFileSync(key);
-        return { cert, key };
-    }
-    catch {
-        return null;
-    }
-}
-/** 局域网 IPv4(iPad 用它访问;.local 名不一定解析得到) */
-export function lanAddresses() {
-    const out = [];
-    for (const list of Object.values(networkInterfaces()))
-        for (const i of list ?? [])
-            if (i.family === 'IPv4' && !i.internal)
-                out.push(i.address);
-    return out;
-}
-export async function serveWorkspace(opts = {}) {
-    const ws = loadWorkspace(opts.workspace, opts);
-    const report = await doctorWorkspace(ws.root, { ...opts, probeEnv: false });
-    const warnings = report.checks.filter((c) => !c.ok).map((c) => `${c.name}:${c.detail}${c.fix ? `(${c.fix})` : ''}`);
-    const port = opts.port ?? ws.config.server.port;
-    const ctx = createContext(ws);
-    const handler = createHandler(ctx);
-    const tls = opts.http ? null : httpsFiles(ws);
-    const server = tls ? createHttps({ cert: readFileSync(tls.cert), key: readFileSync(tls.key) }, handler) : createHttp(handler);
-    await new Promise((resolveListen, reject) => {
-        server.once('error', reject);
-        server.listen(port, opts.host ?? '0.0.0.0', () => resolveListen());
-    });
-    const actual = server.address().port;
-    const scheme = tls ? 'https' : 'http';
-    const urls = [hostname(), ...lanAddresses()].map((h) => `${scheme}://${h}:${actual}/`);
-    return { server, ctx, ws, port: actual, https: Boolean(tls), urls, url: urls[0], warnings };
-}

package/dist/cli/skeleton.d.ts

@@ -1,39 +0,0 @@
-export declare const DIRS: readonly ["agents", "ledger", "conversations", ".claude/agents", ".qwen/agents", "scenes", "bundles", "snaps"];
-export declare const LEDGER_FILES: readonly ["ledger/observations.jsonl", "ledger/artifacts.jsonl"];
-/** 本包自带的老师文件目录(仓库检出与 npm 安装都在包根 agents/) */
-export declare const PACKAGE_AGENTS_DIR: string;
-/** 本包版本(出厂件的 hash 记录带它,升级时知道基于哪版) */
-export declare const PACKAGE_VERSION: string;
-export interface ShippedAgent {
-    name: string;
-    file: string;
-    description: string;
-}
-export declare function shippedAgents(dir?: string): Promise<ShippedAgent[]>;
-export declare const GITIGNORE = "# \u8F6C\u5F55\u65E5\u5FD7\u4F53\u79EF\u5927\u3001\u53EF\u4ECE\u5BF9\u8BDD\u7D22\u5F15\u91CD\u5EFA\u5173\u952E\u4FE1\u606F;\u8981\u7559\u5168\u6863\u5C31\u5220\u6389\u4E0B\u9762\u8FD9\u884C\nconversations/**/*.log\n# \u914D\u97F3\u53EF\u91CD\u65B0\u5408\u6210\nconversations/**/*.mp3\n# \u8BFE\u5305\u4E0E\u622A\u56FE\u662F drawtell build / snap \u7684\u6D3E\u751F\u7269,\u573A\u666F\u6E90\u5728 scenes/\nbundles/\nsnaps/\nnode_modules/\n.DS_Store\n";
-/** 家规:所有老师常驻(CLAUDE.md 与 QWEN.md 同一份)。故意短。 */
-export declare const RULES = "# \u5BB6\u89C4\n\n- \u5173\u4E8E\u5B69\u5B50\u7684\u89C2\u5BDF,\u5199\u4E00\u6761\u5230 ledger/observations.jsonl(\u4E00\u884C JSON:id\u3001date\u3001author=\u4F60\u7684\u540D\u5B57\u3001claim \u4E00\u53E5\u8BDD\u3001evidence \u6307\u5411\u5BF9\u8BDD\u6216\u4EA7\u7269),\u522B\u7684\u8001\u5E08\u548C\u89C4\u5212\u8001\u5E08\u4ECE\u90A3\u91CC\u8BFB\u3002\n- \u4F60\u81EA\u5DF1\u7684\u7ECF\u9A8C\u8BB0\u8FDB\u4F60\u7684\u8BB0\u5FC6\u76EE\u5F55(MEMORY.md \u4E00\u884C\u7D22\u5F15 + \u4E3B\u9898\u6587\u4EF6)\u3002\n- \u56DE\u590D\u6B63\u6587\u5C31\u662F\u5B69\u5B50\u770B\u5230\u7684\u677F\u4E66:\u666E\u901A\u6BB5\u843D\u662F\u4F60\u8BF4\u7ED9\u5B69\u5B50\u542C\u7684\u8BDD(\u4E00\u884C\u4E00\u53E5,\u4F1A\u88AB\u5FF5\u51FA\u6765;\u65B9\u62EC\u53F7\u6807\u51FA\u8981\u5728\u677F\u4E0A\u6572\u7684\u8BCD;\u672B\u53E5\u662F\u95EE\u53E5\u5C31\u505C\u4E0B\u7B49\u5B69\u5B50),\u56F4\u680F\u662F\u677F\u4E0A\u7684\u5361(\u56F4\u680F\u6807\u7B7E\u662F\u5361\u7684\u79CD\u7C7B;\u5361\u7684\u5199\u6CD5\u5728\u8001\u5E08\u6587\u4EF6\u91CC)\u3002\u968F\u53E3\u95EE\u7B54\u5C31\u4E00\u4E24\u53E5\u8BDD,\u6CA1\u6709\u5361\u3002\u677F\u4E66\u5199\u5B8C\u5C31\u505C,\u4E0D\u518D\u8865\u8BDD\u3001\u4E0D\u518D\u7528\u5DE5\u5177\u2014\u2014\u5B69\u5B50\u770B\u5230\u7684\u53EA\u662F\u8FD9\u8F6E\u6700\u540E\u4E00\u6BB5\u8BDD\u3002\n- \u5BF9\u5BB6\u957F\u8BF4\u7684\u8BDD\u5199\u6210\u4E00\u6BB5\u300C## \u5BB6\u957F\u300D;\u9700\u8981\u5BB6\u957F\u62CD\u677F\u7684\u4E8B\u5199\u6210\u4E00\u6BB5\u300C## \u5F85\u88C1\u91CF\u300D(question: \u4E00\u53E5\u8BDD;options: \u5217\u8868),\u4E0D\u8981\u505C\u4E0B\u6765\u7B49;\u8981\u4EA4\u7ED9\u522B\u7684\u8001\u5E08\u7684\u4E8B\u5199\u6210\u4E00\u6BB5\u300C## \u8F6C\u4EA4\u300D(to: \u8001\u5E08\u540D;why: \u4E00\u53E5\u8BDD;refs: \u76F8\u5173\u6587\u4EF6),\u7B2C\u4E00\u671F\u53EA\u5141\u8BB8\u4E00\u8DF3;**\u8F6C\u4EA4\u53EA\u5199\u8FD9\u4E2A\u6BB5,\u4E0D\u8981\u81EA\u5DF1\u7528 Task / \u5B50\u4EE3\u7406\u53BB\u53EB\u90A3\u4F4D\u8001\u5E08**\u2014\u2014\u5E94\u7528\u770B\u5230\u6BB5\u4F1A\u81EA\u52A8\u8D77\u5979\u7684\u4E00\u8F6E\u3002\u8FD9\u4E09\u4E2A\u6BB5\u653E\u5728\u6B63\u6587\u672B\u5C3E,\u5B69\u5B50\u770B\u4E0D\u5230\u3002\n- \u5BF9\u8BDD\u6309\u5929,\u660E\u5929\u4ECE\u8D26\u672C\u548C\u4F60\u7684\u8BB0\u5FC6\u63A5\u7740\u6765,\u4E0D\u8981\u6307\u671B\u4ECA\u5929\u7684\u5BF9\u8BDD\u8FD8\u5728\u3002\n";
-export interface TutorTemplateInput {
-    name: string;
-    display: string;
-    subject?: string;
-    description?: string;
-}
-/**
- * 家长自己加老师时的文件模板:与出厂老师同一套约定(cwd、账本、家规、上下文包、问答 / 讲解 / 任务三种回复、
- * 板书写法、不评判、不造课件、家长 / 待裁量 / 转交段),只有第一句人设是这位老师自己的。
- */
-export declare function tutorTemplate(t: TutorTemplateInput): string;
-export interface ConfigTemplateInput {
-    slug: string;
-    name?: string;
-    port?: number;
-    tutors: ShippedAgent[];
-}
-/** cotutor.json 模板:只在文件不存在时写入;政策文件永不自动重建或覆盖(家长的决定不由机器替她拍板)。 */
-export declare function configTemplate(input: ConfigTemplateInput): string;
-/** 把 JSON Schema 写进 workspace(机器文件,每次 init / upgrade 都刷新) */
-/** 给老师看的板书语法表:从卡的注册表现生成,机器文件,init / upgrade 每次刷新;老师文件正文让老师讲解前读它 */
-export declare const SYNTAX_FILE = ".cotutor/\u677F\u4E66\u8BED\u6CD5.md";
-export declare function writeSyntaxFile(root: string): Promise<string>;
-export declare function writeSchemaFile(root: string): Promise<string>;

package/dist/cli/skeleton.js

@@ -1,184 +0,0 @@
-/**
- * workspace骨架清单:init 建、doctor 查,同一张清单(两边各写一遍必然漂移)。
- * 布局见《cotutor-agent层设计.md》§2:
- *   cotutor.json / CLAUDE.md QWEN.md(家规)/ .claude/agents(老师文件,拷自本包 agents/,是家长的)/ .qwen/agents(相对链)/ .cotutor/shipped.json(出厂 hash)
- *   agents/<name>/(老师的家 = 会话 cwd)/ ledger/(两本账)/ conversations/(对话索引与转录)
- */
-import { readFileSync } from 'node:fs';
-import { readFile, readdir } from 'node:fs/promises';
-import { join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { parseAgentFile } from "../lib/agent-file.js";
-import { CONFIG_SCHEMA_FILE, TTS_DEFAULT, cotutorJsonSchema } from "../schema/index.js";
-import { boardSyntaxDoc } from "../cards/index.js";
-import { mkdir, writeFile } from 'node:fs/promises';
-export const DIRS = ['agents', 'ledger', 'conversations', '.claude/agents', '.qwen/agents', 'scenes', 'bundles', 'snaps'];
-export const LEDGER_FILES = ['ledger/observations.jsonl', 'ledger/artifacts.jsonl'];
-/** 本包自带的老师文件目录(仓库检出与 npm 安装都在包根 agents/) */
-export const PACKAGE_AGENTS_DIR = fileURLToPath(new URL('../../agents/', import.meta.url));
-/** 本包版本(出厂件的 hash 记录带它,升级时知道基于哪版) */
-export const PACKAGE_VERSION = JSON.parse(readFileSync(fileURLToPath(new URL('../../package.json', import.meta.url)), 'utf8')).version;
-export async function shippedAgents(dir = PACKAGE_AGENTS_DIR) {
-    const out = [];
-    for (const f of (await readdir(dir)).filter((f) => f.endsWith('.md')).sort()) {
-        const file = join(dir, f);
-        const { frontmatter } = parseAgentFile(await readFile(file, 'utf8'));
-        if (frontmatter.name)
-            out.push({ name: frontmatter.name, file, description: frontmatter.description ?? '' });
-    }
-    return out;
-}
-export const GITIGNORE = `# 转录日志体积大、可从对话索引重建关键信息;要留全档就删掉下面这行
-conversations/**/*.log
-# 配音可重新合成
-conversations/**/*.mp3
-# 课包与截图是 drawtell build / snap 的派生物,场景源在 scenes/
-bundles/
-snaps/
-node_modules/
-.DS_Store
-`;
-/** 家规:所有老师常驻(CLAUDE.md 与 QWEN.md 同一份)。故意短。 */
-export const RULES = `# 家规
-
-- 关于孩子的观察,写一条到 ledger/observations.jsonl(一行 JSON:id、date、author=你的名字、claim 一句话、evidence 指向对话或产物),别的老师和规划老师从那里读。
-- 你自己的经验记进你的记忆目录(MEMORY.md 一行索引 + 主题文件)。
-- 回复正文就是孩子看到的板书:普通段落是你说给孩子听的话(一行一句,会被念出来;方括号标出要在板上敲的词;末句是问句就停下等孩子),围栏是板上的卡(围栏标签是卡的种类;卡的写法在老师文件里)。随口问答就一两句话,没有卡。板书写完就停,不再补话、不再用工具——孩子看到的只是这轮最后一段话。
-- 对家长说的话写成一段「## 家长」;需要家长拍板的事写成一段「## 待裁量」(question: 一句话;options: 列表),不要停下来等;要交给别的老师的事写成一段「## 转交」(to: 老师名;why: 一句话;refs: 相关文件),第一期只允许一跳;**转交只写这个段,不要自己用 Task / 子代理去叫那位老师**——应用看到段会自动起她的一轮。这三个段放在正文末尾,孩子看不到。
-- 对话按天,明天从账本和你的记忆接着来,不要指望今天的对话还在。
-`;
-/**
- * 家长自己加老师时的文件模板:与出厂老师同一套约定(cwd、账本、家规、上下文包、问答 / 讲解 / 任务三种回复、
- * 板书写法、不评判、不造课件、家长 / 待裁量 / 转交段),只有第一句人设是这位老师自己的。
- */
-export function tutorTemplate(t) {
-    const what = t.subject ? `${t.subject}的事` : '孩子问的事';
-    return `---
-name: ${t.name}
-description: ${t.description ?? `${t.display}。${what}都找它;随口问的一两句答完,要讲的在板书上一节一节讲`}
-maxTurns: 40
-permissionMode: bypassPermissions
-memory: project
----
-你是这个家的${t.display},面对的是一个小学生和他的家长。cwd 是你的家(agents/${t.name}/),账本在 ../../ledger/,家规在 ../../CLAUDE.md。消息前面有一段 \`cotutor:\` 开头的上下文包(谁在说、几点、正在看什么、本周计划、最近观察),先看它再答。
-
-(在这里写这位老师自己的性子和讲法:比如「说话慢一点,爱打比方」「英文后面跟中文」。一两句就够。)
-
-回复有三种,先分清:
-- **问答**(缺省,孩子或家长随口问):一两句大白话,不超过三句,没有卡;不用工具,不读账本(上下文包里已经给了),想到的就直接说。
-- **讲解**(孩子说「讲讲 / 教我 / 不会」、家长发来一道题、或者一句话答不完):写一节板书,格式见下面;讲完一节停下问孩子,孩子答了或按「继续」你再写下一节。
-- **任务**(上下文包里 \`from: system\`,或家长明确写了「记账 / 做计划」):按任务做,做完在正文里报告结果。
-
-现在没有别的课件通道:**不要写文件、不要造课件**,板书就是你的课件。
-
-## 板书怎么写(讲解时)
-
-回复正文就是孩子看到的板书,只有两种东西:
-
-- **普通段落 = 你说的话。** 一行一句,每句会被念出来、显示在字幕行,所以不要写标题、列表、粗体、括号注释。句子里用方括号标出要在板上敲的词,那个词要在某张卡上出现。末句写成问句就停下等孩子。
-- **围栏 = 板上的卡。** 围栏的语言标签是卡的种类,正文按各种卡的写法。卡写在讲它的那句话前面,卡与话交错。
-- **板书写完就停。** 最后一个字是给孩子的那句问话,后面不要再补一句总结、不要再用工具、不要再说「我讲完了」——孩子看到的是你这轮最后一段话,再补一句板书就丢了。
-
-卡有哪几种、各自怎么写,在 ../../.cotutor/板书语法.md(text / read / choice / fill / image…);第一次讲解前读一遍,之后不用再读。上下文包里 \`board: off\` 时只说话不出卡。
-
-一节 4–8 张卡、6–12 句话;一次只讲一个想法,讲完就问。孩子的话不上板;孩子答了,你的口头回应直接写成一句话。不打分、不说「错了」:答对了直接往下讲,答偏了就从他的答案往回讲一步。
-
-例子(一节的骨架):
-
-\`\`\`\`
-开场的一句话。
-
-\`\`\`text cover
-标题
-副标题
-\`\`\`
-
-讲这张卡的一句话,[要敲的词]在卡上。
-
-\`\`\`choice
-问题?
-- [ ] 选项一
-- [x] 选项二
-\`\`\`
-
-末句是问句?
-\`\`\`\`
-
-对家长说的话、要拍板的事、要转交的事,用「## 家长」「## 待裁量」(question: 一句话;options: 列表)「## 转交」三个段放在正文末尾,孩子看不到;不要停下来等家长。
-
-记账与记忆(只在任务里做,问答和讲解不做):值得别的老师知道的观察,追加一行到 ../../ledger/observations.jsonl;你自己的经验记进你的记忆目录。
-`;
-}
-const TUTOR_DEFAULTS = {
-    'math-tutor': { display: '数学老师', subject: '数学', avatar: '🧮' },
-    'chinese-tutor': { display: '语文老师', subject: '语文', avatar: '📚' },
-    'reading-tutor': { display: '朗读老师', subject: '英语', avatar: '📖' },
-    'homework-tutor': { display: '作业老师', avatar: '📷' },
-    planner: { display: '规划老师', avatar: '🗓', hidden: true },
-    'scene-maker': { display: '画图老师', avatar: '🎨', hidden: true, runtime: 'claude-scene' },
-};
-/** cotutor.json 模板:只在文件不存在时写入;政策文件永不自动重建或覆盖(家长的决定不由机器替她拍板)。 */
-export function configTemplate(input) {
-    const tutors = {};
-    for (const a of input.tutors) {
-        const p = TUTOR_DEFAULTS[a.name];
-        tutors[a.name] = p
-            ? { display: p.display, ...(p.subject ? { subject: p.subject } : {}), avatar: p.avatar, enabled: true, ...(p.hidden ? { hidden: true } : {}), ...(p.runtime ? { runtime: p.runtime } : {}) }
-            : { display: a.name, enabled: true };
-    }
-    const cfg = {
-        $schema: CONFIG_SCHEMA_FILE,
-        version: 1,
-        title: input.name ? `${input.name}的老师们` : 'cotutor',
-        kid: { slug: input.slug, ...(input.name ? { name: input.name } : {}) },
-        server: { port: input.port ?? 5180 },
-        paths: {},
-        policyDefaults: {},
-        tutors,
-        runtimes: {
-            default: 'claude',
-            // 普通老师不许派子代理(--disallowedTools Agent):claude 会把 .claude/agents/ 里的老师文件当可派的子代理,老师自己去叫 scene-maker 就把预算烧在自己这轮里;转交只写「## 转交」段
-            claude: {
-                run: ['claude', '--agent', '{agent}', '-p', '{prompt}', '--dangerously-skip-permissions', '--disallowedTools', 'Agent', '--output-format', 'stream-json', '--verbose', '--include-partial-messages', '--max-budget-usd', '2'],
-                resume: ['claude', '--agent', '{agent}', '-p', '--resume', '{session}', '{prompt}', '--dangerously-skip-permissions', '--disallowedTools', 'Agent', '--output-format', 'stream-json', '--verbose', '--include-partial-messages', '--max-budget-usd', '2'],
-            },
-            qwen: {
-                run: ['qwen', '-p', '{prompt}', '--append-system-prompt', '{agentBody}', '--yolo', '--output-format', 'stream-json', '--max-wall-time', '10m'],
-                resume: ['qwen', '-p', '{prompt}', '--resume', '{session}', '--append-system-prompt', '{agentBody}', '--yolo', '--output-format', 'stream-json', '--max-wall-time', '10m'],
-            },
-            // 场景作业(scene-maker):分钟级、几美元一个,预算与时限比问答大;老师条目 runtime 指到它
-            'claude-scene': {
-                run: ['claude', '--agent', '{agent}', '-p', '{prompt}', '--dangerously-skip-permissions', '--output-format', 'stream-json', '--verbose', '--max-budget-usd', '8'],
-                resume: ['claude', '--agent', '{agent}', '-p', '--resume', '{session}', '{prompt}', '--dangerously-skip-permissions', '--output-format', 'stream-json', '--verbose', '--max-budget-usd', '8'],
-            },
-            'qwen-scene': {
-                run: ['qwen', '-p', '{prompt}', '--append-system-prompt', '{agentBody}', '--yolo', '--output-format', 'stream-json', '--max-wall-time', '25m'],
-                resume: ['qwen', '-p', '{prompt}', '--resume', '{session}', '--append-system-prompt', '{agentBody}', '--yolo', '--output-format', 'stream-json', '--max-wall-time', '25m'],
-            },
-        },
-        tts: TTS_DEFAULT,
-        _note: '一孩一 workspace 的政策文件,家长改这里;机器不会自动重建或覆盖,写坏了靠 git 回退,cotutor doctor 可体检。' +
-            'tutors = 老师表(key 与 .claude/agents/<key>.md 的 name 一致):display 显示名、avatar、voice 用 voxtell 音色 id、enabled 开关、hidden 孩子端不露、policy 覆盖 policyDefaults。' +
-            'policyDefaults 缺省:replyMaxChars 60(每句)、dailyMessages 30、dailyRegen 3、reviewGate false、contextPack {recent 10, planLines 10}、board auto(off = 只说话不出卡)。' +
-            'paths = 角色映射:vault 指 Obsidian vault 根(一孩一 vault),photos/diary/plans/profile/timetable 相对 vault。' +
-            'runtimes = 运行时,占位 {agent} {agentBody} {prompt} {session};政策旋钮(预算、时限、模型)写进模板;老师条目的 runtime 可指定用哪个(scene-maker 用 claude-scene:预算 8 美元)。scenes.dailyMax(缺省 2)= 每天最多起几个场景作业。' +
-            'tts = 配音命令,占位 {text} {voice} {out};老师没配 voice 就不合成,孩子端用浏览器的声。' +
-            'server.https = {cert, key} 只给这个 workspace 用的证书路径(相对 workspace 根);不配则用机器级 ~/.config/cotutor/certs/(cotutor cert 用 mkcert 建,所有 workspace 共用)。',
-    };
-    return `${JSON.stringify(cfg, null, 2)}\n`;
-}
-/** 把 JSON Schema 写进 workspace(机器文件,每次 init / upgrade 都刷新) */
-/** 给老师看的板书语法表:从卡的注册表现生成,机器文件,init / upgrade 每次刷新;老师文件正文让老师讲解前读它 */
-export const SYNTAX_FILE = '.cotutor/板书语法.md';
-export async function writeSyntaxFile(root) {
-    const file = join(root, SYNTAX_FILE);
-    await mkdir(join(root, '.cotutor'), { recursive: true });
-    await writeFile(file, boardSyntaxDoc());
-    return file;
-}
-export async function writeSchemaFile(root) {
-    const file = join(root, CONFIG_SCHEMA_FILE);
-    await mkdir(join(root, '.cotutor'), { recursive: true });
-    await writeFile(file, `${JSON.stringify(cotutorJsonSchema(), null, 2)}\n`);
-    return file;
-}

package/dist/cli/skills.d.ts

@@ -1,40 +0,0 @@
-export declare const SHIPPED_SKILLS: readonly ["drawtell-scene", "drawtell-teaching", "drawtell-cli", "drawtell-verify"];
-export type ShippedSkillName = (typeof SHIPPED_SKILLS)[number];
-/** drawtell-skills 包的 skills/ 目录;包没装 → null(doctor 点名,init 跳过) */
-export declare function packageSkillsDir(): string | null;
-/** drawtell CLI 的入口(本包 node_modules 里);没装 → null */
-export declare function drawtellBin(): string | null;
-export declare const TOOL_SHIM = ".cotutor/drawtell";
-/** 一个目录的内容 hash:相对路径 + 内容,按路径排序 */
-export declare function dirHash(dir: string): Promise<string>;
-export type SkillState = 'latest' | 'upgradable' | 'custom' | 'untracked' | 'missing' | 'unavailable';
-export interface SkillStatus {
-    name: ShippedSkillName;
-    state: SkillState;
-    dir: string;
-    basedOn?: string;
-}
-export declare function skillDirs(root: string, name: string): {
-    claude: string;
-    qwen: string;
-};
-export declare function skillStatuses(root: string): Promise<SkillStatus[]>;
-export interface SkillStep {
-    item: string;
-    action: 'created' | 'exists' | 'kept' | 'replaced';
-    note?: string;
-}
-/** init 用:缺的拷,有的不动;drawtell-skills 没装就只报一行 */
-export declare function installSkills(root: string): Promise<SkillStep[]>;
-export interface SkillUpgradeStep {
-    name: string;
-    action: 'upgraded' | 'latest' | 'kept-custom' | 'installed' | 'unavailable';
-    basedOn?: string;
-}
-/** upgrade 用:latest 跳过;upgradable 换新;custom / untracked 保留只报;缺的补 */
-export declare function upgradeSkills(root: string): Promise<SkillUpgradeStep[]>;
-/** .cotutor/drawtell:壳脚本,老师在 agents/<name>/ 里用 ../../.cotutor/drawtell 跑 drawtell CLI;机器文件,init / upgrade 每次刷新 */
-export declare function writeToolShim(root: string): Promise<{
-    file: string;
-    available: boolean;
-}>;