cotutor 0.3.0 → 0.4.0

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;

package/dist/runtime/home/store.js

@@ -10,10 +10,10 @@ import { UsageError } from "../../shared/errors.js";
 import { localDate } from "../../shared/time.js";
 import { conversationFiles, threads } from "../../schema/index.js";
 import { kidQuestions } from "../../memory/diary.js";
-import { activityFile } from "../activities.js";
+import { activityName, findActivityFile } from "../activities.js";
 import { lintActivity, parseActivity, resolveParams } from "../activity.js";
-import { arrangeHome, dropFixes, homeActivities, homeOwners, faceTutor, homeId, homeIssues, homeLectures, homeRefs, homeTutors, kidButtons, parseHome, threadKey, todayResumes } from "./home.js";
-import { HOME_ID_RE, LECTURE_ACTIVITY, PublishedHomeSchema } from "../../schema/index.js";
+import { arrangeHome, dropFixes, homeActivities, homeOwners, faceTutor, homeId, homeIssues, homeLectures, homeRefs, homeTutors, kidButtons, kidTiles, parseHome, threadKey, todayResumes } from "./home.js";
+import { HOME_ID_RE, HOME_TILES, LECTURE_ACTIVITY, PublishedHomeSchema, tutorTiles } from "../../schema/index.js";
 import { listDates, readCardStates, readIndex } from "../journal/store.js";
 import { bakeSoon, inspectLecture, readLecture } from "../lecture.js";
 export function homeFiles(ws) {
@@ -78,10 +78,10 @@ async function checkContext(ws, doc, now) {
     }
     const activities = new Map();
     for (const r of homeActivities(doc)) {
-        const text = await readFile(activityFile(ws.root, r.tutor, r.name), 'utf8').catch(() => null);
+        const text = await readFile(findActivityFile(ws.root, r.tutor, r.name), 'utf8').catch(() => null);
         if (text === null)
             continue;
-        const { activity, issues } = lintActivity(text, { fileName: r.name, tutorCards: ws.config.tutors[r.tutor]?.cards });
+        const { activity, issues } = lintActivity(text, { fileName: activityName(ws.root, r.tutor, r.name), tutorCards: ws.config.tutors[r.tutor]?.cards });
         activities.set(`${r.tutor}/${r.name}`, { activity, fixes: issues.filter((i) => i.level === 'fix').length });
     }
     return { tutors: tutorInfos(ws), threads: await liveThreads(ws, homeRefs(doc)), lectures, lectureProblems, unbaked, today: localDate(now), activities };
@@ -93,10 +93,10 @@ export async function checkHome(ws, md, now) {
 }
 /** 孩子端能不能用这个 activity:文件在、检查没有「要改」(提醒不算);用不了 → null */
 export async function usableActivity(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);
     if (text === null)
         return null;
-    const { activity, issues } = lintActivity(text, { fileName: name, tutorCards: ws.config.tutors[tutor]?.cards });
+    const { activity, issues } = lintActivity(text, { fileName: activityName(ws.root, tutor, name), tutorCards: ws.config.tutors[tutor]?.cards });
     return issues.some((i) => i.level === 'fix') ? null : activity;
 }
 /** 已发布那份里现在还坏着的引用(doctor 与家长端用) */
@@ -112,7 +112,7 @@ export async function publishHome(ws, opts) {
     const f = homeFiles(ws);
     const src = opts.from ? (isAbsolute(opts.from) ? opts.from : resolve(ws.root, opts.from)) : f.draft;
     const md = await readFile(src, 'utf8').catch(() => null);
-    const shown = relative(ws.root, src) || src;
+    const shown = relative(ws.root, src).split(sep).join('/') || src;
     if (md === null)
         throw new UsageError(opts.from ? `读不到 ${opts.from}` : '还没有草稿 home/draft.md(用 cotutor-home 技能写一份)');
     return publishHomeMd(ws, md, shown, opts);
@@ -233,8 +233,9 @@ export async function kidHomeView(ws, now, opts = {}) {
             continue;
         }
         const name = String(c.props.tutor);
+        const resumes = await resumesOf(ws, name, today);
         const buttons = kidButtons((c.props.buttons ?? []), {
-            resumes: await resumesOf(ws, name, today),
+            resumes,
             alive: (date, thread) => alive.has(threadKey(name, date, thread)),
             lecture: (bundle) => Boolean(lectures.get(bundle)),
             activity: (a, params) => { const act = usable.get(`${name}/${a}`); return Boolean(act) && resolveParams(act, params).issues.length === 0; },
@@ -244,7 +245,12 @@ export async function kidHomeView(ws, now, opts = {}) {
         // 橙点:这份首页给他排了按钮或卡,而发布以来孩子还没找过他
         const arranged = buttons.some((b) => typeof b.id === 'number') || cards.some((x) => x.kind !== 'tutor' && owners.get(x) === name);
         const news = Boolean(publishedAt && arranged && !(await talkedSince(ws, name, publishedAt, now)));
-        out.push({ kind: 'tutor', props: { tutor: name, buttons, ...(news ? { news: true } : {}) } });
+        // 常驻的方砖(预习、检查作业、复习):不经发布,家里有那个 activity、没关掉就在
+        const tiles = [];
+        for (const t of HOME_TILES)
+            if (tutorTiles(ws.config.tutors[name] ?? {}).includes(t.id) && (await usableActivity(ws, name, t.activity)))
+                tiles.push(t.id);
+        out.push({ kind: 'tutor', props: { tutor: name, buttons, tiles: kidTiles(tiles, { usable: () => true, resumes }), ...(news ? { news: true } : {}) } });
     }
     return { home: id, cards: out };
 }
@@ -259,7 +265,23 @@ export async function resolveVia(ws, tutor, via) {
         return { kind: 'new', label: '新话题' };
     if (via.button === 'recent')
         return { kind: 'recent', label: '接着刚才的' };
-    if (via.home === null)
+    // activity 的参数在点的那一刻按 activity 文件解析、补缺省,跟着话题走(家长后来改了只管以后的话题);文件不在、参数不对 → null
+    const runOf = async (name, params) => {
+        const text = await readFile(findActivityFile(ws.root, tutor, name), 'utf8').catch(() => null);
+        if (text === null)
+            return null;
+        const r = resolveParams(parseActivity(text).activity, params);
+        return r.issues.length ? null : { name, params: r.values };
+    };
+    // 方砖:不看是哪份首页(缺省首页也有);关掉了、家里那个 activity 用不了 → null。参数全用缺省(三份都可空,老师先请孩子拍材料)
+    const tile = HOME_TILES.find((t) => t.id === via.button);
+    if (tile) {
+        if (!tutorTiles(ws.config.tutors[tutor] ?? {}).includes(tile.id) || !(await usableActivity(ws, tutor, tile.activity)))
+            return null;
+        const run = await runOf(tile.activity, {});
+        return run ? { kind: 'activity', label: tile.activity, activity: tile.activity, params: run.params } : null;
+    }
+    if (via.home === null || typeof via.button !== 'number')
         return null;
     const { home } = await readPublished(ws);
     if (!home || home.id !== via.home)
@@ -271,14 +293,6 @@ export async function resolveVia(ws, tutor, via) {
     const brief = b.brief ? { brief: b.brief } : {};
     if (b.kind === 'start')
         return { kind: 'start', label: b.label, ...brief };
-    // activity 的参数在点的那一刻按 activity 文件解析、补缺省,跟着话题走(家长后来改了只管以后的话题);文件不在、参数不对 → null
-    const runOf = async (name, params) => {
-        const text = await readFile(activityFile(ws.root, tutor, name), 'utf8').catch(() => null);
-        if (text === null)
-            return null;
-        const r = resolveParams(parseActivity(text).activity, params);
-        return r.issues.length ? null : { name, params: r.values };
-    };
     // 小课堂看完照哪个 activity 聊:写了 activity: 是它,没写是这位老师的「小课堂」;文件不在 → null
     if (b.kind === 'lecture') {
         const run = await runOf(b.activity ?? LECTURE_ACTIVITY, {});
@@ -393,7 +407,8 @@ export function formatCheck(ws, check, title, kid) {
             const ref = b.kind === 'continue' ? ` → ${b.date} ${b.thread}` : b.kind === 'lecture' ? ` → 小课堂 ${b.bundle}` : act?.kind === 'activity' ? ` → activity ${act.activity}${Object.keys(act.params).length ? `(${Object.entries(act.params).map(([k, v]) => `${k}: ${v}`).join(';')})` : ''}` : '';
             return `${BUTTON_ICON[b.kind]} ${b.label}${ref}${brief}`;
         });
-        out.push(`  ${display(name)} ${name}${written.has(name) ? '' : '(没写,应用补)'}:${buttons.join(' | ')}`);
+        const tiles = (c.props.tiles ?? []).map((x) => `▦ ${x.label}`);
+        out.push(`  ${display(name)} ${name}${written.has(name) ? '' : '(没写,应用补)'}:${[...buttons.slice(0, 1), ...tiles, ...buttons.slice(1)].join(' | ')}${tiles.length ? '(▦ 是常驻的方砖,不用写)' : ''}`);
     }
     const rest = kid.cards.filter((x) => x.kind !== 'tutor');
     if (rest.length) {
@@ -424,7 +439,7 @@ export function formatStats(ws, s) {
     const h = s.home;
     const tutorsN = h.cards.filter((c) => c.kind === 'tutor').length;
     const out = [`已发布 ${h.id}(${s.days === 0 ? '今天' : `${s.days} 天前`}${h.for ? `,for ${h.for}` : ''})· ${tutorsN} 张老师卡 · ${h.cards.length - tutorsN} 张别的卡 · 原文 ${h.source}`];
-    const icon = (b) => (b === 'new' ? '✨' : b === 'recent' ? '↻' : '·');
+    const icon = (b) => (b === 'new' ? '✨' : b === 'recent' ? '↻' : typeof b === 'string' ? '▦' : '·');
     for (const c of s.clicks) {
         const who = ws.config.tutors[c.tutor]?.display ?? c.tutor;
         out.push(`  ${who} ${icon(c.button)} ${c.label}:${c.uses.length ? `点了 ${c.uses.length} 次(${c.uses.map((u) => `${u.date} ${u.thread}`).join('、')})` : '没点过'}`);

package/dist/runtime/journal/mix.d.ts

@@ -20,14 +20,23 @@ export declare function playingOf(segs: {
     start: number;
     end: number;
 }[]): [number, number][];
-/** 两边混成一条(PCM16 单声道 24k,长到 ms 为止;挂断那一刻还没放完的老师的声音不要) */
+/** 混出来的一条 + 老师出声的时段 + 孩子有声的时段 */
+export interface Mixed {
+    pcm: Buffer;
+    playing: [number, number][];
+    kidVoice: [number, number][];
+}
+/** 一口气混完(测试、短的) */
 export declare function mixCall(o: {
     kid: Chunk[];
     tutor: Chunk[];
     flushes: number[];
     ms: number;
-}): {
-    pcm: Buffer;
-    playing: [number, number][];
-    kidVoice: [number, number][];
-};
+}): Mixed;
+/** 分片混:结果同 mixCall,中间让出事件循环(通话里落录像走这个) */
+export declare function mixCallSliced(o: {
+    kid: Chunk[];
+    tutor: Chunk[];
+    flushes: number[];
+    ms: number;
+}): Promise<Mixed>;

package/dist/runtime/journal/mix.js

@@ -53,36 +53,77 @@ export function playingOf(segs) {
     }
     return out.map(([a, b]) => [Math.round(a), Math.round(b)]);
 }
-/** 两边混成一条(PCM16 单声道 24k,长到 ms 为止;挂断那一刻还没放完的老师的声音不要) */
-export function mixCall(o) {
+/** 分片混:每混这么多个采样(10 秒)让一下事件循环——通话中切段时就在混,不能卡住正在说的那一路 */
+const SLICE_SAMPLES = MIX_RATE * 10;
+/**
+ * 两边混成一条(PCM16 单声道 24k,长到 ms 为止;挂断那一刻还没放完的老师的声音不要)。
+ * 直接往 Int16 里加、加一次削一次顶(两边叠着才会削,和先加完再削只差一个最低位);不另开整段的 Float32(一个钟头就是 345 MB)。
+ * 生成器:每混 SLICE_SAMPLES 个采样 yield 一次,mixCall 一口气跑完,mixCallSliced 每次 yield 让一下事件循环
+ */
+function* mixing(o) {
     const n = Math.max(0, Math.round((o.ms * MIX_RATE) / 1000));
-    const acc = new Float32Array(n);
-    const put = (at, i16, len) => {
-        const base = Math.round((at * MIX_RATE) / 1000);
-        for (let k = 0; k < len; k++) {
-            const j = base + k;
-            if (j >= 0 && j < n)
-                acc[j] += i16(k);
-        }
+    const pcm = Buffer.alloc(n * 2);
+    let work = 0;
+    const add = (j, v) => {
+        const s = pcm.readInt16LE(j * 2) + Math.round(v);
+        pcm.writeInt16LE(s > 32767 ? 32767 : s < -32768 ? -32768 : s, j * 2);
     };
+    const voiced = [];
     for (const c of o.kid) {
         const m = samplesOf(c.pcm);
         if (!m)
             continue;
         const len = Math.floor((m * MIX_RATE) / KID_RATE);
         const at = c.t - (m * 1000) / KID_RATE;
-        put(at, (k) => {
+        const base = Math.round((at * MIX_RATE) / 1000);
+        for (let k = 0; k < len; k++) {
+            const j = base + k;
+            if (j < 0 || j >= n)
+                continue;
             const x = (k * KID_RATE) / MIX_RATE, i = Math.floor(x), f = x - i;
             const a = c.pcm.readInt16LE(Math.min(i, m - 1) * 2), b = c.pcm.readInt16LE(Math.min(i + 1, m - 1) * 2);
-            return a + (b - a) * f;
-        }, len);
+            add(j, a + (b - a) * f);
+        }
+        if (rms(c.pcm) >= KID_VOICE)
+            voiced.push({ start: at, end: c.t });
+        work += len;
+        if (work >= SLICE_SAMPLES) {
+            work = 0;
+            yield;
+        }
     }
     const segs = scheduleTutor(o.tutor, o.flushes).filter((s) => s.start < o.ms);
-    for (const s of segs)
-        put(s.start, (k) => s.pcm.readInt16LE(k * 2), samplesOf(s.pcm));
-    const pcm = Buffer.alloc(n * 2);
-    for (let j = 0; j < n; j++)
-        pcm.writeInt16LE(Math.max(-32768, Math.min(32767, Math.round(acc[j]))), j * 2);
-    const voiced = o.kid.filter((c) => rms(c.pcm) >= KID_VOICE).map((c) => ({ start: c.t - (samplesOf(c.pcm) * 1000) / KID_RATE, end: c.t }));
+    for (const s of segs) {
+        const base = Math.round((s.start * MIX_RATE) / 1000);
+        const len = samplesOf(s.pcm);
+        for (let k = 0; k < len; k++) {
+            const j = base + k;
+            if (j >= 0 && j < n)
+                add(j, s.pcm.readInt16LE(k * 2));
+        }
+        work += len;
+        if (work >= SLICE_SAMPLES) {
+            work = 0;
+            yield;
+        }
+    }
     return { pcm, playing: playingOf(segs.map((s) => ({ start: s.start, end: Math.min(s.end, o.ms) }))), kidVoice: playingOf(voiced) };
 }
+/** 一口气混完(测试、短的) */
+export function mixCall(o) {
+    const g = mixing(o);
+    let r = g.next();
+    while (!r.done)
+        r = g.next();
+    return r.value;
+}
+/** 分片混:结果同 mixCall,中间让出事件循环(通话里落录像走这个) */
+export async function mixCallSliced(o) {
+    const g = mixing(o);
+    let r = g.next();
+    while (!r.done) {
+        await new Promise((resolve) => setImmediate(resolve));
+        r = g.next();
+    }
+    return r.value;
+}