cotutor 0.3.0 → 0.4.1

package/dist/brain/{cli/types.d.ts → types.d.ts}

@@ -1,12 +1,10 @@
 /**
- * CLI 适配器:一个 agent CLI 一个文件,写「这个 CLI 怎么说话」——
- * 输出流怎么读、消息怎么写进 stdin、工具叫什么怎么关、思考量怎么调、起进程要什么环境、出厂模板长什么样。
- * 选哪个模型、预算、时限还在 cotutor.json 的运行时模板里(数据);应用的其余部分只认这里的统一事件,不认哪家的 JSON。
- * 接一个新 CLI:照 qwen.ts 写一个文件,在 index.ts 的 ADAPTERS 里登记。
+ * 脑的统一事件与工具:API 脑(./api.ts)写进 .log、孩子端的流式板书、家长端看原文、转录都只认这些。
+ * 名字里的 Cli 是 2026-11-02 以前起 Qwen Code 时留下的;那时的 .log 是 stream-json,由 ./stream-json.ts 读成同样的事件。
  */
-import type { CliRuntime, Policy } from '../../schema/index.ts';
 /** 工具的类别:应用要知道「读了哪个文件」「是不是用技能回读板书写法」时按类别认,不比工具名 */
 export type ToolKind = 'read' | 'shell' | 'search' | 'edit' | 'skill' | 'other';
+export declare const toolKind: (name: string) => ToolKind;
 /**
  * 这轮带不带工具(政策 tools 与消息种类定):off 一个不带;read 只读(看照片、读 vault、查教材);
  * on 与 read 一样只读,不提供 shell 与写入工具
@@ -99,46 +97,3 @@ export type CliEvent = {
     kind: 'result';
     final: CliFinal;
 };
-/** 运行时模板里与适配器有关的占位能拿到的值 */
-export interface PlanContext {
-    /** workspace 根(适配器的私有文件放在它的 .cotutor/ 下);测试与不关心的调用可以不给 */
-    root?: string;
-    effort: Policy['effort'];
-    /** 这轮带不带工具 */
-    tools: ToolSet;
-}
-export interface CliAdapter {
-    /** 适配器名:运行时的 cli 字段,或 run[0] 的文件名 */
-    name: string;
-    /** 一行原始输出 → 统一事件;读不懂的行返回 [] */
-    parse(line: string): CliEvent[];
-    /** stdin 模式(运行时 stdin: "stream-json")下写进 stdin 的那一行用户消息,带换行 */
-    stdinMessage(prompt: string): string;
-    /** 模板里 `{tools}` 填什么(一个参数里的文字) */
-    toolList(set: ToolSet): string;
-    /** 模板里独占一个参数的 `{toolArgs}` 展开成哪几个参数(可以是零个);readDirs = 这轮该读得到的目录(workspace 根、vault),会话 cwd 是老师目录,它们在 cwd 外面 */
-    toolArgs(set: ToolSet, ctx: {
-        readDirs: readonly string[];
-    }): string[];
-    toolKind(name: string): ToolKind;
-    /** 这轮带或不带工具时,进程起来报的工具表(init 事件)应该正好是哪几样;多出来的记提醒(CLI 升版本会带进新工具)。不给 = 不核对 */
-    expectedTools?(set: ToolSet): readonly string[];
-    /** 起进程前把这个 CLI 在 workspace 里要的机器文件备好(幂等,内容一样就不写) */
-    prepare?(root: string): Promise<void>;
-    /** 由这轮的计划定下来的环境变量(进预热的比对:变了的备用进程不能用);没有就不写 */
-    planEnv?(ctx: PlanContext): Record<string, string>;
-    /** 起进程前最后过一遍环境(认证等);不改就原样返回 */
-    env(env: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
-    /** cotutor doctor 查这个 CLI 时多看几样(version 是 `--version` 的第一行);不给就只查装没装 */
-    check?(ctx: {
-        version: string;
-        env: NodeJS.ProcessEnv;
-    }): {
-        name: string;
-        ok: boolean;
-        detail: string;
-        fix?: string;
-    }[];
-    /** 出厂运行时模板:键是运行时名 */
-    runtimes(): Record<string, CliRuntime>;
-}

package/dist/brain/types.js

@@ -0,0 +1,14 @@
+/**
+ * 脑的统一事件与工具:API 脑(./api.ts)写进 .log、孩子端的流式板书、家长端看原文、转录都只认这些。
+ * 名字里的 Cli 是 2026-11-02 以前起 Qwen Code 时留下的;那时的 .log 是 stream-json,由 ./stream-json.ts 读成同样的事件。
+ */
+/** 工具名 → 类别:API 脑的三样(./api-tools.ts)与旧轮次里 Qwen Code、Claude Code 的工具名;不认识的是 other */
+const TOOL_KINDS = {
+    read_file: 'read', read_many_files: 'read', zoom_image: 'read', list_directory: 'read', glob: 'search', grep_search: 'search',
+    run_shell_command: 'shell', edit: 'edit', write_file: 'edit', notebook_edit: 'edit', skill: 'skill',
+    Read: 'read', Bash: 'shell', Grep: 'search', Glob: 'search', Edit: 'edit', Write: 'edit', NotebookEdit: 'edit', MultiEdit: 'edit', Skill: 'skill',
+};
+export const toolKind = (name) => TOOL_KINDS[name] ?? 'other';
+/** 一条回复的正文段 / 工具调用 */
+export const textsOf = (parts) => parts.flatMap((p) => (p.type === 'text' ? [p.text] : []));
+export const toolsOf = (parts) => parts.flatMap((p) => (p.type === 'tool' ? [p.tool] : []));

package/dist/chalk/glyphs/skeleton.d.ts

@@ -35,9 +35,9 @@ export interface GlyphPenOptions {
     /** 采样步长(归一化单位);缺省 SAMPLE_STEP。调小更平滑,但动画 DOM 体积约按平方涨 */
     sampleStep?: number;
     /**
-     * 字形表(provider):缺省内置拉丁包(a–z / A–Z)。扩展字形数据包
-     * (如 drawtell-glyphs-hanzi)导出同构的 Map,从这里传入即共用同一支笔——
-     * 归一化约定由各包自定并写明(拉丁 = 四线三格;汉字 = 格子高 1、底线 y=0、顶 y=-1)。
+     * 字形表(provider):缺省内置拉丁包(a–z / A–Z)。别的字形做成同构的 Map 从这里传入,就和字母共用同一支笔;
+     * 归一化约定由传入方定并写明(拉丁 = 四线三格;汉字可取格子高 1、底线 y=0、顶 y=-1)。
+     * 汉字要逐笔写时从 hanzi-writer-data 的 medians 现做(本包已依赖它,田字格卡就读它),不另挑字表。
      */
     glyphs?: ReadonlyMap<string, Glyph>;
 }

package/dist/chalk/glyphs/skeleton.js

@@ -45,7 +45,7 @@ export class UnknownGlyphError extends Error {
     /** node 的 strip-only 类型擦除不支持构造函数参数属性,字段显式声明 */
     ch;
     constructor(ch) {
-        super(`字形表未收录 '${ch}'。内置包只有 a–z 与 A–Z;汉字等扩展字形经 glyphs 选项传入(如 drawtell-glyphs-hanzi)。`);
+        super(`字形表未收录 '${ch}'。内置包只有 a–z 与 A–Z;别的字形做成同构的 Map 经 glyphs 选项传入。`);
         this.ch = ch;
     }
 }

package/dist/lib/index.d.ts

@@ -11,5 +11,5 @@ export * from '../memory/plan.ts';
 export * from '../runtime/journal/ledger.ts';
 export * from '../runtime/journal/conversation.ts';
 export * from '../shared/time.ts';
-export * from '../brain/cli/run-plan.ts';
+export * from '../brain/runtime.ts';
 export * from '../memory/timetable.ts';

package/dist/lib/index.js

@@ -11,5 +11,5 @@ export * from "../memory/plan.js";
 export * from "../runtime/journal/ledger.js";
 export * from "../runtime/journal/conversation.js";
 export * from "../shared/time.js";
-export * from "../brain/cli/run-plan.js";
+export * from "../brain/runtime.js";
 export * from "../memory/timetable.js";

package/dist/memory/diary.js

@@ -1,11 +1,11 @@
-import { threads } from "../schema/index.js";
+import { threads, viaSendsLabel } from "../schema/index.js";
 /** 孩子在这个话题里说的话:from: kid、不是「继续」/ 交答案这种动作、非空;多行并成一行 */
 export function kidQuestions(messages, thread) {
     const ths = threads(messages);
     const out = [];
     messages.forEach((m, i) => {
-        // 首页的开场 / 接着按钮发的是按钮上的字,不是孩子说的
-        if (ths[i] !== thread || m.from !== 'kid' || m.action || (m.via && typeof m.via.button === 'number'))
+        // 首页的开场 / 接着按钮、方砖发的是按钮上的字,不是孩子说的
+        if (ths[i] !== thread || m.from !== 'kid' || m.action || (m.via && viaSendsLabel(m.via)))
             return;
         const text = m.text.replace(/\s+/g, ' ').trim();
         if (text && text !== '继续')

package/dist/realtime/bailian.d.ts

@@ -55,7 +55,7 @@ export interface RealtimeEvents {
     onError?(message: string): void;
     onClose?(reason: string): void;
 }
-/** 百炼按量的 key 与业务空间 id(Token Plan 没有 omni realtime;key 怎么找见 src/shared/qianwen.ts,业务空间 id 先看家长端配的、再看环境、再看 voxtell 的配置) */
+/** 百炼按量的 key 与业务空间 id(Token Plan 没有 omni realtime;都在 ~/.config/cotutor/bailian.json,见 src/shared/qianwen.ts) */
 export declare function dashscopeAuth(env?: NodeJS.ProcessEnv): {
     key: string;
     workspaceId: string;

package/dist/realtime/bailian.js

@@ -28,7 +28,7 @@ export const OUTPUT_RATE = 24000;
 export const MAX_IMAGE_B64 = 262144 - 1024;
 const TRANSCRIBE_MODEL = 'qwen3-asr-flash-realtime';
 const HEARTBEAT_PCM = Buffer.alloc(INPUT_RATE * 2);
-/** 百炼按量的 key 与业务空间 id(Token Plan 没有 omni realtime;key 怎么找见 src/shared/qianwen.ts,业务空间 id 先看家长端配的、再看环境、再看 voxtell 的配置) */
+/** 百炼按量的 key 与业务空间 id(Token Plan 没有 omni realtime;都在 ~/.config/cotutor/bailian.json,见 src/shared/qianwen.ts) */
 export function dashscopeAuth(env = process.env) {
     const key = qianwenKeys(env).payg;
     const workspaceId = bailianWorkspaceId(env);
@@ -95,8 +95,9 @@ export class RealtimeSession {
     async connect() {
         let url = this.opts.endpoint;
         let key = '';
+        // 指了端点的是测试与探针的假百炼,不看 key
         if (url)
-            key = this.opts.env?.DASHSCOPE_API_KEY ?? 'sk-test';
+            key = 'sk-test';
         else {
             const auth = this.opts.auth ?? dashscopeAuth(this.opts.env);
             if (!auth)

package/dist/realtime/preview.js

@@ -17,7 +17,7 @@ export async function previewVoice(o) {
     });
     const why = await s.connect();
     if (why !== null)
-        return { error: why === 'no_auth' ? '没有百炼的 key 或业务空间 id(DASHSCOPE_API_KEY、DASHSCOPE_WORKSPACE_ID)' : `连不上:${why}` };
+        return { error: why === 'no_auth' ? '没有百炼的 key 或业务空间 id(家长端「首页」里填,存在 ~/.config/cotutor/bailian.json)' : `连不上:${why}` };
     s.createResponse(readCue([o.text]));
     const until = Date.now() + (o.timeoutMs ?? 20_000);
     while (!done && !err && Date.now() < until)

package/dist/realtime/voices.d.ts

@@ -11,6 +11,8 @@ export interface RealtimeVoice {
     voice: string;
     /** 官方的中文名 */
     name: string;
+    /** 男 / 女:官方表没有这一栏,照名字与描述标;看不出的三个(Theo Calm、Arda、longanlingxin)2026-11-03 真念一句量了音高 */
+    gender: '男' | '女';
     trait: string;
     lang: string;
 }

package/dist/realtime/voices.js

@@ -6,64 +6,64 @@
  * 英语老师的讲稿是中文里夹英文(「apple 苹果,banana 香蕉」):2026-10-20 真连(照念 → 转写回字)Serena、Tina、Maia、Liora Mira、Mione、Theo Calm 都念对,
  * Jennifer、Mia 的中文带英文腔(Jennifer:「腿」成了 tway,「它是什么颜色」没了),trait 里记着。
  */
-const v = (voice, name, trait, lang = '普通话') => ({ voice, name, trait, lang });
+const v = (voice, name, gender, trait, lang = '普通话') => ({ voice, name, gender, trait, lang });
 export const REALTIME_VOICES = [
-    v('Tina', '甜甜', '甜美温暖,解决问题果断(缺省)'),
-    v('Cindy', '林欣宜', '台湾腔嗲嗲的小姐姐', '台湾口音'),
-    v('Liora Mira', '清欢', '温柔的烟火人间感'),
-    v('Raymond', '林川野', '声音清亮,爱吃外卖的宅男'),
-    v('Zane', '泽恩', '磁性迷人'),
-    v('Katerina', '卡捷琳娜', '御姐音,韵律感强'),
-    v('Ryan', '甜茶', '节奏感强,戏感足'),
-    v('Mia', '舒然', '细腻,生活美学风格的温柔博主;中英夹着说时中文带英文腔'),
-    v('Cici', '绵绵', '邻家妹妹,活泼软糯'),
-    v('Theo Calm', '予安', '沉静,治愈感'),
-    v('Serena', '苏瑶', '温柔小姐姐'),
-    v('Maia', '四月', '知性与温柔'),
-    v('Evan', '江晨', '男大学生,年下奶狗'),
-    v('Qiao', '小乔妹', '表面甜妹,个性十足', '台湾口音'),
-    v('Momo', '茉兔', '撒娇搞怪'),
-    v('Wil', '伟伦', '深圳长大的港台腔小哥哥'),
-    v('Angel', '安琪', '带台式口音,甜美'),
-    v('Li Cassian', '李公公', '话中有留白,善察言观色'),
-    v('Joyner', '阿逗', '搞笑、夸张、接地气'),
-    v('Gold', '金爷', '西海岸黑人说唱歌手风格'),
-    v('Jennifer', '詹妮弗', '电影质感的美语女声;中英夹着说时中文带英文腔(苹果念成 pingguo)'),
-    v('Aiden', '艾登', '精通厨艺的美语大男孩'),
-    v('Mione', '敏儿', '成熟知性的英国邻家妹妹'),
-    v('Sunny', '晴儿', '甜美的川妹子', '四川话'),
-    v('Dylan', '晓东', '北京胡同长大的少年', '北京话'),
-    v('Eric', '程川', '成都市井男子,跳脱', '四川话'),
-    v('Peter', '李彼得', '天津相声,专业捧哏', '天津话'),
-    v('Joseph Chen', '阿樸伯', '南洋老华侨', '闽南话'),
-    v('Marcus', '秦川', '老陕风格,面宽话短', '陕西话'),
-    v('Li', '老李', '南京话伯伯,爱骂骂咧咧', '南京话'),
-    v('Rocky', '阿强', '幽默风趣,在线陪聊', '粤语'),
-    v('Kiki', '阿清', '甜美的港妹闺蜜', '粤语'),
-    v('Sohee', '素熙', '温柔开朗的韩国欧尼'),
-    v('Eliška', '艾莉卡', '中欧风格'),
-    v('Alek', '阿列克', '战斗民族的冷与暖'),
-    v('Arda', '阿尔达', '干净利落,温润'),
-    v('Dolce', '多尔切', '慵懒的意大利大叔'),
-    v('Lenn', '莱恩', '德国青年,理性中带叛逆'),
-    v('Ono Anna', '小野杏', '鬼灵精怪的青梅竹马'),
-    v('Sonrisa', '索尼莎', '热情开朗的拉美大姐'),
-    v('Bodega', '博德加', '热情的西班牙大叔'),
-    v('Andre', '安德雷', '磁性、沉稳的男生'),
-    v('Radio Gol', '拉迪奥·戈尔', '足球解说风格'),
-    v('Rizky', '阿力', '印尼青年,声线个性'),
-    v('Roya', '萝雅', '热爱运动的女孩'),
-    v('Hana', '阿幸', '越南成熟姐姐'),
-    v('Jakub', '雅克', '波兰文艺青年,声线磁性'),
-    v('Griet', '海娜', '荷兰成熟文艺女性'),
-    v('Marina', '玛丽娜', '多元文化城市长大的女孩'),
-    v('Siiri', '西芮', '内敛温柔,语速舒缓'),
-    v('Ingrid', '林恩', '挪威乡村姑娘'),
-    v('Sigga', '海娜', '冰岛小镇知性女青年'),
-    v('Bea', '雅娜', '爱喝咖啡的甜美姐姐'),
-    v('Chloe', '思怡', '马来西亚白领女生'),
-    v('Emilien', '埃米尔安', '浪漫的法国大哥哥'),
-    v('longanlingxin', '龙安灵心', '知心温暖音'),
+    v('Tina', '甜甜', '女', '甜美温暖,解决问题果断(缺省)'),
+    v('Cindy', '林欣宜', '女', '台湾腔嗲嗲的小姐姐', '台湾口音'),
+    v('Liora Mira', '清欢', '女', '温柔的烟火人间感'),
+    v('Raymond', '林川野', '男', '声音清亮,爱吃外卖的宅男'),
+    v('Zane', '泽恩', '男', '磁性迷人'),
+    v('Katerina', '卡捷琳娜', '女', '御姐音,韵律感强'),
+    v('Ryan', '甜茶', '男', '节奏感强,戏感足'),
+    v('Mia', '舒然', '女', '细腻,生活美学风格的温柔博主;中英夹着说时中文带英文腔'),
+    v('Cici', '绵绵', '女', '邻家妹妹,活泼软糯'),
+    v('Theo Calm', '予安', '男', '沉静,治愈感'),
+    v('Serena', '苏瑶', '女', '温柔小姐姐'),
+    v('Maia', '四月', '女', '知性与温柔'),
+    v('Evan', '江晨', '男', '男大学生,年下奶狗'),
+    v('Qiao', '小乔妹', '女', '表面甜妹,个性十足', '台湾口音'),
+    v('Momo', '茉兔', '女', '撒娇搞怪'),
+    v('Wil', '伟伦', '男', '深圳长大的港台腔小哥哥'),
+    v('Angel', '安琪', '女', '带台式口音,甜美'),
+    v('Li Cassian', '李公公', '男', '话中有留白,善察言观色'),
+    v('Joyner', '阿逗', '男', '搞笑、夸张、接地气'),
+    v('Gold', '金爷', '男', '西海岸黑人说唱歌手风格'),
+    v('Jennifer', '詹妮弗', '女', '电影质感的美语女声;中英夹着说时中文带英文腔(苹果念成 pingguo)'),
+    v('Aiden', '艾登', '男', '精通厨艺的美语大男孩'),
+    v('Mione', '敏儿', '女', '成熟知性的英国邻家妹妹'),
+    v('Sunny', '晴儿', '女', '甜美的川妹子', '四川话'),
+    v('Dylan', '晓东', '男', '北京胡同长大的少年', '北京话'),
+    v('Eric', '程川', '男', '成都市井男子,跳脱', '四川话'),
+    v('Peter', '李彼得', '男', '天津相声,专业捧哏', '天津话'),
+    v('Joseph Chen', '阿樸伯', '男', '南洋老华侨', '闽南话'),
+    v('Marcus', '秦川', '男', '老陕风格,面宽话短', '陕西话'),
+    v('Li', '老李', '男', '南京话伯伯,爱骂骂咧咧', '南京话'),
+    v('Rocky', '阿强', '男', '幽默风趣,在线陪聊', '粤语'),
+    v('Kiki', '阿清', '女', '甜美的港妹闺蜜', '粤语'),
+    v('Sohee', '素熙', '女', '温柔开朗的韩国欧尼'),
+    v('Eliška', '艾莉卡', '女', '中欧风格'),
+    v('Alek', '阿列克', '男', '战斗民族的冷与暖'),
+    v('Arda', '阿尔达', '男', '干净利落,温润'),
+    v('Dolce', '多尔切', '男', '慵懒的意大利大叔'),
+    v('Lenn', '莱恩', '男', '德国青年,理性中带叛逆'),
+    v('Ono Anna', '小野杏', '女', '鬼灵精怪的青梅竹马'),
+    v('Sonrisa', '索尼莎', '女', '热情开朗的拉美大姐'),
+    v('Bodega', '博德加', '男', '热情的西班牙大叔'),
+    v('Andre', '安德雷', '男', '磁性、沉稳的男生'),
+    v('Radio Gol', '拉迪奥·戈尔', '男', '足球解说风格'),
+    v('Rizky', '阿力', '男', '印尼青年,声线个性'),
+    v('Roya', '萝雅', '女', '热爱运动的女孩'),
+    v('Hana', '阿幸', '女', '越南成熟姐姐'),
+    v('Jakub', '雅克', '男', '波兰文艺青年,声线磁性'),
+    v('Griet', '海娜', '女', '荷兰成熟文艺女性'),
+    v('Marina', '玛丽娜', '女', '多元文化城市长大的女孩'),
+    v('Siiri', '西芮', '女', '内敛温柔,语速舒缓'),
+    v('Ingrid', '林恩', '女', '挪威乡村姑娘'),
+    v('Sigga', '海娜', '女', '冰岛小镇知性女青年'),
+    v('Bea', '雅娜', '女', '爱喝咖啡的甜美姐姐'),
+    v('Chloe', '思怡', '女', '马来西亚白领女生'),
+    v('Emilien', '埃米尔安', '男', '浪漫的法国大哥哥'),
+    v('longanlingxin', '龙安灵心', '女', '知心温暖音'),
 ];
 /** 这个模型认不认这个音色(工作台、doctor 拦写错的) */
 export function isRealtimeVoice(voice) {

package/dist/runtime/activities.d.ts

@@ -12,6 +12,18 @@ export declare const EXAMPLES_SUFFIX = ".\u4F8B\u5B50";
 export declare function listActivities(agentsDir: string, tutor?: string, opts?: {
     examples?: boolean;
 }): Promise<ActivityRef[]>;
-/** workspace 里那份的位置 */
+/** workspace 里那份的位置(就是这个名字,不认改过的名;装、升级、写都用它) */
 export declare function activityFile(root: string, tutor: string, name: string): string;
+/**
+ * 改过名的出厂 activity:旧名 → 新名。2026-11-03 批改 → 检查作业(孩子端方砖上的字)。
+ * upgrade 把 workspace 里的旧文件挪成新名(src/app/cli/activities.ts);旧草稿里的 `activity 批改`、旧话题记的名字照样认(activityName)
+ */
+export declare const ACTIVITY_RENAMES: Readonly<Record<string, string>>;
+/**
+ * 这个名字在这位老师家里实际是哪个文件:有同名的就是它;旧名的文件挪走了认新名;新名的还没有(没 upgrade 过)认旧名。都没有 → 原样
+ * (读的时候用:跑话题、首页检查、方砖;lint 的 fileName 也要用这个,不然 name 对不上)
+ */
+export declare function activityName(root: string, tutor: string, name: string): string;
+/** 读的时候找的那份:认改过的名(activityName) */
+export declare function findActivityFile(root: string, tutor: string, name: string): string;
 export declare function activityRunFor(root: string, tutor: string, name: string, raw?: string): Promise<ActivityRun>;

package/dist/runtime/activities.js

@@ -2,6 +2,7 @@
  * 读 activity 文件(从 app/cli/activities.ts 拆出来,2026-10-29,行为不变):在哪、每位老师有哪几个、按「名=值」的参数拼成一次跑。
  * 运行层每轮都要读,所以不放在命令行那一层;装、升级、还原、检查仍在 app/cli/activities.ts。
  */
+import { existsSync } from 'node:fs';
 import { readFile, readdir } from 'node:fs/promises';
 import { join } from 'node:path';
 import { parseActivity, resolveParams } from "./activity.js";
@@ -22,12 +23,37 @@ export async function listActivities(agentsDir, tutor, opts = {}) {
     }
     return out;
 }
-/** workspace 里那份的位置 */
+/** workspace 里那份的位置(就是这个名字,不认改过的名;装、升级、写都用它) */
 export function activityFile(root, tutor, name) {
     return join(root, 'agents', tutor, ACTIVITIES_DIR, `${name}.md`);
 }
+/**
+ * 改过名的出厂 activity:旧名 → 新名。2026-11-03 批改 → 检查作业(孩子端方砖上的字)。
+ * upgrade 把 workspace 里的旧文件挪成新名(src/app/cli/activities.ts);旧草稿里的 `activity 批改`、旧话题记的名字照样认(activityName)
+ */
+export const ACTIVITY_RENAMES = { 批改: '检查作业' };
+/**
+ * 这个名字在这位老师家里实际是哪个文件:有同名的就是它;旧名的文件挪走了认新名;新名的还没有(没 upgrade 过)认旧名。都没有 → 原样
+ * (读的时候用:跑话题、首页检查、方砖;lint 的 fileName 也要用这个,不然 name 对不上)
+ */
+export function activityName(root, tutor, name) {
+    const has = (n) => existsSync(activityFile(root, tutor, n));
+    if (has(name))
+        return name;
+    const to = ACTIVITY_RENAMES[name];
+    if (to && has(to))
+        return to;
+    const from = Object.keys(ACTIVITY_RENAMES).find((k) => ACTIVITY_RENAMES[k] === name);
+    if (from && has(from))
+        return from;
+    return name;
+}
+/** 读的时候找的那份:认改过的名(activityName) */
+export function findActivityFile(root, tutor, name) {
+    return activityFile(root, tutor, activityName(root, tutor, name));
+}
 export async function activityRunFor(root, tutor, name, raw = '') {
-    const file = activityFile(root, tutor, name);
+    const file = findActivityFile(root, tutor, name);
     const text = await readFile(file, 'utf8').catch(() => null);
     if (text === null)
         throw new UsageError(`${file} 不在;cotutor activity check ${tutor} 看这位老师有哪些`);

package/dist/runtime/activity-state.js

@@ -3,7 +3,7 @@
  * 数这个话题画了几张、今天还剩几张、上一张为什么没画。纯判断在 src/runtime/activity.ts(gatePasses / failingGate),这里只管读盘。
  */
 import { readFile } from 'node:fs/promises';
-import { activityFile } from "./activities.js";
+import { findActivityFile } from "./activities.js";
 import { failingGate, parseActivity } from "./activity.js";
 import { threads } from "../schema/index.js";
 import {} from "../schema/index.js";
@@ -15,7 +15,7 @@ export function threadActivity(messages, thread) {
 }
 /** 读 workspace 里那份 activity 文件;不在 → null */
 export async function readActivity(ws, tutor, name) {
-    const text = await readFile(activityFile(ws.root, tutor, name), 'utf8').catch(() => null);
+    const text = await readFile(findActivityFile(ws.root, tutor, name), 'utf8').catch(() => null);
     return text === null ? null : parseActivity(text).activity;
 }
 /** 这个话题里的画图卡,文件顺序:哪一轮第几张 */

package/dist/runtime/agent-file.d.ts

@@ -1,9 +1,9 @@
 /**
  * 老师文件(agents/<name>.md):YAML frontmatter + 正文即系统提示。
- * 这里只认平铺的 `key: value` frontmatter(两个 CLI 的公共子集:name / description / maxTurns / permissionMode / memory);
- * 正文给没有 --agent 的 CLI 经 {agentBody} 塞进 --append-system-prompt。
+ * 这里只认平铺的 `key: value` frontmatter(name / description / maxTurns / permissionMode / memory,当初两个 CLI 的公共子集,应用只读 name);
+ * 正文是系统提示的前半(后面接板书写法)。
  */
-/** 两个 CLI 的公共子集:老师文件 frontmatter 只写这几个键(人设 / 政策 / 开关在 cotutor.json);技能 cotutor-tune 的字段表从这里取 */
+/** 老师文件 frontmatter 只写这几个键(人设 / 政策 / 开关在 cotutor.json);技能 cotutor-tune 的字段表从这里取 */
 export declare const AGENT_FRONTMATTER_KEYS: readonly ["name", "description", "maxTurns", "permissionMode", "memory"];
 export interface AgentFile {
     frontmatter: Record<string, string>;

package/dist/runtime/agent-file.js

@@ -1,9 +1,9 @@
 /**
  * 老师文件(agents/<name>.md):YAML frontmatter + 正文即系统提示。
- * 这里只认平铺的 `key: value` frontmatter(两个 CLI 的公共子集:name / description / maxTurns / permissionMode / memory);
- * 正文给没有 --agent 的 CLI 经 {agentBody} 塞进 --append-system-prompt。
+ * 这里只认平铺的 `key: value` frontmatter(name / description / maxTurns / permissionMode / memory,当初两个 CLI 的公共子集,应用只读 name);
+ * 正文是系统提示的前半(后面接板书写法)。
  */
-/** 两个 CLI 的公共子集:老师文件 frontmatter 只写这几个键(人设 / 政策 / 开关在 cotutor.json);技能 cotutor-tune 的字段表从这里取 */
+/** 老师文件 frontmatter 只写这几个键(人设 / 政策 / 开关在 cotutor.json);技能 cotutor-tune 的字段表从这里取 */
 export const AGENT_FRONTMATTER_KEYS = ['name', 'description', 'maxTurns', 'permissionMode', 'memory'];
 export function parseAgentFile(text) {
     const open = /^---[^\S\n]*\n/.exec(text);

package/dist/runtime/context/tutor-rules.d.ts

@@ -15,8 +15,8 @@ export declare function boardGuideBody(skillMd: string): string;
 /** 上下文包 boardGuide: 行在预载时写的话(事实陈述,不让老师自查) */
 export declare const BOARD_GUIDE_IN_SYSTEM = "\u5DF2\u5728\u4F60\u7684\u7CFB\u7EDF\u63D0\u793A\u91CC(\u300C# \u677F\u4E66\u600E\u4E48\u5199\u300D),\u4E0D\u7528\u8BFB";
 /**
- * 回归检查(与 CLI 无关):板书写法已经递到手里,老师这轮还用工具去读它 → 预载没起作用(换模型 / 换 CLI / 升版本后最先坏的地方)。
- * 认三种:技能工具(claude 的 Skill、qwen 的 skill,按 src/brain/cli/ 的工具类别认)点名 cotutor-board;任何工具的参数里带 cotutor-board/SKILL.md(Read、cat、别家 CLI 的读文件工具),或按老师裁的那份 .cotutor/board/。
+ * 回归检查:板书写法已经在系统提示里,老师这轮还用工具去读它 → 系统提示里那份没起作用(换模型后最先坏的地方)。
+ * 认三种:技能工具(旧轮次 claude 的 Skill、qwen 的 skill,按工具类别认)点名 cotutor-board;任何工具的参数里带 cotutor-board/SKILL.md(read_file 等),或旧轮次按老师裁的那份 .cotutor/board/。
  * references/<种类>.md 是按需读的,不算。
  */
 export declare function boardGuideReads(tools: readonly {

package/dist/runtime/context/tutor-rules.js

@@ -7,7 +7,7 @@ import { parseAgentFile } from "../agent-file.js";
 import { stripHumanNotes } from "../../shared/human-notes.js";
 import { applyCardGuards } from "../../board/card-guards.js";
 import { BOARD_CARD_KINDS } from "../../schema/config.js";
-import { toolKind } from "../../brain/cli/adapters.js";
+import { toolKind } from "../../brain/index.js";
 import { SKILLS_DIR } from "../../schema/workspace.js";
 export const TUTOR_SKILL = 'cotutor-tutor';
 /** 相对 workspace 根 */
@@ -38,8 +38,8 @@ export function boardGuideBody(skillMd) {
 /** 上下文包 boardGuide: 行在预载时写的话(事实陈述,不让老师自查) */
 export const BOARD_GUIDE_IN_SYSTEM = '已在你的系统提示里(「# 板书怎么写」),不用读';
 /**
- * 回归检查(与 CLI 无关):板书写法已经递到手里,老师这轮还用工具去读它 → 预载没起作用(换模型 / 换 CLI / 升版本后最先坏的地方)。
- * 认三种:技能工具(claude 的 Skill、qwen 的 skill,按 src/brain/cli/ 的工具类别认)点名 cotutor-board;任何工具的参数里带 cotutor-board/SKILL.md(Read、cat、别家 CLI 的读文件工具),或按老师裁的那份 .cotutor/board/。
+ * 回归检查:板书写法已经在系统提示里,老师这轮还用工具去读它 → 系统提示里那份没起作用(换模型后最先坏的地方)。
+ * 认三种:技能工具(旧轮次 claude 的 Skill、qwen 的 skill,按工具类别认)点名 cotutor-board;任何工具的参数里带 cotutor-board/SKILL.md(read_file 等),或旧轮次按老师裁的那份 .cotutor/board/。
  * references/<种类>.md 是按需读的,不算。
  */
 export function boardGuideReads(tools) {

package/dist/runtime/home/home.d.ts

@@ -3,7 +3,7 @@
  * 解析走板书同一个解析器(place = home);永不抛错,问题都带行号(1 起)与修法。要读盘的引用(话题在不在)由调用方查好传进来。
  */
 import type { TutorButton } from '../../board/cards/index.ts';
-import { type Activity } from '../../schema/index.ts';
+import { type Activity, type HomeTileId } from '../../schema/index.ts';
 import type { BoardCard } from '../../board/presentation.ts';
 export type HomeIssueLevel = 'fix' | 'note';
 export interface HomeIssue {
@@ -130,6 +130,17 @@ export type KidHomeButton = {
     video?: true;
     resume?: Resume;
 };
+/** 孩子端老师卡上常驻的一块方砖(HOME_TILES):label = activity 的名字;resume = 今天从这个 activity 进去的话题(和 activity 按钮同一个入口) */
+export interface KidHomeTile {
+    id: HomeTileId;
+    label: string;
+    resume?: Resume;
+}
+/** 这位老师牌上的方砖:开着的(on,牌上的先后)里,家里那个 activity 用得了的才出 */
+export declare function kidTiles(on: readonly HomeTileId[], opts: {
+    usable: (activity: string) => boolean;
+    resumes?: ReadonlyMap<string, Resume>;
+}): KidHomeTile[];
 export declare const NEW_THREAD_LABEL = "\u65B0\u8BDD\u9898";
 /** 一个话题是从哪个入口进去的:小课堂(按课包)、activity(按名字,参数不比)、自由话题(新话题按钮或没有按钮);别的按钮(开场、接着)进去的 → null */
 export declare function resumeKey(first: {

package/dist/runtime/home/home.js

@@ -1,4 +1,4 @@
-import { LECTURE_ACTIVITY } from "../../schema/index.js";
+import { HOME_TILES, LECTURE_ACTIVITY } from "../../schema/index.js";
 import { resolveParams } from "../activity.js";
 import { parseBoard } from "../../board/parse.js";
 const DAY_RE = /^\d{4}-\d{2}-\d{2}$/;
@@ -227,6 +227,13 @@ export function homeOwners(cards, tutors) {
         return who ?? cur;
     });
 }
+/** 这位老师牌上的方砖:开着的(on,牌上的先后)里,家里那个 activity 用得了的才出 */
+export function kidTiles(on, opts) {
+    return HOME_TILES.filter((t) => on.includes(t.id) && opts.usable(t.activity)).map((t) => {
+        const r = opts.resumes?.get(`activity:${t.activity}`);
+        return { id: t.id, label: t.activity, ...(r ? { resume: r } : {}) };
+    });
+}
 export const NEW_THREAD_LABEL = '新话题';
 const RESUME_MAX = 10;
 /** 一个话题是从哪个入口进去的:小课堂(按课包)、activity(按名字,参数不比)、自由话题(新话题按钮或没有按钮);别的按钮(开场、接着)进去的 → null */

package/dist/runtime/home/store.d.ts

@@ -116,7 +116,7 @@ export declare function messageVia(via: HomeVia, r: ResolvedVia): MessageVia;
 export declare function continueContext(ws: Workspace, tutor: string, date: string, thread: string): Promise<NonNullable<ContextPack['continue']> | null>;
 export interface HomeClick {
     tutor: string;
-    button: number | 'new' | 'recent';
+    button: HomeVia['button'];
     label: string;
     uses: {
         date: string;