cotutor 0.1.0 → 0.3.0

package/skills/cotutor-board/references/word.md

@@ -0,0 +1,91 @@
+# word — 单词卡
+
+## 是什么
+
+单词卡:孩子问「X 英语怎么说」、一节里教新词时用的卡。一张卡一个英文单词,写在四线三格里,讲到这张卡时一笔一笔写一遍。卡上没有中文。点开是慢速:慢念,再按自然拼读一段一段慢写。
+
+## 什么时候用 / 别用
+
+- 用:孩子问「X 英语怎么说」「X 怎么拼」。
+- 用:一节里的新词,一个词一张。
+- 用:短词组也行,如 `ice cream`、`T-shirt`。
+- 别用:一串词一起跟读 → `read`。
+- 别用:句子、课文 → `read`。
+- 别用:中文意思写进卡里 → 说在讲稿里,英文在前、中文在后。
+
+## 写法
+
+- 第一行:emoji 和英文单词,如 `🍎 apple`。
+- 能画出来的东西配一个 emoji。抽象的词(like、the)不用配。
+- 第二行:自然拼读分段,用 `-` 隔开,如 `ap-ple`、`sh-ee-p`。
+- 分段拼起来要和单词一模一样。一个字母一段也行,如 `c-a-t`。
+- 一张卡一个词,最多三个词、16 个字母。
+- 只写字母、空格、撇号和连字符。不写音标,不写中文谐音。
+
+## 例子
+
+<!-- expect {"kind":"word","props":{"word":"apple","chunks":["ap","ple"],"emoji":"🍎"}} -->
+```word
+🍎 apple
+ap-ple
+```
+
+<!-- expect {"kind":"word","props":{"word":"sheep","chunks":["sh","ee","p"],"emoji":"🐑"}} -->
+```word
+🐑 sheep
+sh-ee-p
+```
+
+<!-- expect {"kind":"word","props":{"word":"ice cream","chunks":["ice ","cr","ea","m"],"emoji":"🍦"}} -->
+```word
+🍦 ice cream
+ice cr-ea-m
+```
+
+<!-- expect {"kind":"word","props":{"word":"like"}} -->
+```word
+like
+```
+
+## 反例
+
+写了中文意思,中文会被去掉,卡照常出:
+
+<!-- expect {"kind":"word","props":{"word":"apple","emoji":"🍎"}} -->
+```word
+🍎 apple 苹果
+```
+
+分段拼不回这个词,分段不要了,卡照常出:
+
+<!-- expect {"kind":"word","props":{"word":"apple"}} -->
+```word
+apple
+a-pl
+```
+
+整句写不进一张单词卡,会退成一段文字:
+
+<!-- expect {"kind":"text","warning":true} -->
+```word
+I like apples very much
+```
+
+只有中文也解析不成:
+
+<!-- expect {"kind":"text","warning":true} -->
+```word
+苹果
+```
+
+## 孩子看到什么
+
+卡上是 emoji 和四线三格里的单词,右边一个「听」。讲到这张卡时一笔一笔写一遍。点「听」按正常速度念这个词。点卡打开大的:一边慢念,一边按分段一段一段慢写,两段两个颜色,写完合拢成一个词、颜色退掉,再慢念一遍。孩子点哪一段,那段再慢写一遍。讲稿的 `[apple]` 落在这张卡上,讲到时这张卡亮起来,词上不画荧光。
+
+## 你会收回什么
+
+没有——单词卡不记状态(点了几遍不告诉你)。
+
+## 状态的形状
+
+没有。

package/skills/cotutor-home/SKILL.md

@@ -0,0 +1,169 @@
+---
+name: cotutor-home
+description: 排 cotutor 孩子端的首页。孩子学完之后,家长在 workspace 根开编程助手说「总结一下今天」「排明天的首页」「给语文老师加个预习按钮」「把那几个字放首页」「上次推荐的他点了没有」时用。读今天的对话、说清学了什么停在哪,商量下次从哪几个按钮进、首页放哪几张卡;家长点头才写草稿,家长明说才发布。不是:改老师的提示词或 vault(→ cotutor-tune)、查老师为什么那样答(→ cotutor-analyze)。
+---
+
+<!-- 给人看
+谁读:家长在 workspace 根开的编程助手
+能改:机器件,upgrade 覆盖;references/ 下的首页语法.md、命令.md、tutor.md 由 src/app/skills/home-doc.ts 与 cards/tutor/card.md 生成
+改了:在试用 workspace 里开编程助手说一句「总结一下今天」(《写提示词.md》§一)
+-->
+
+# 排首页
+
+你在一个 cotutor workspace 的根目录(有 cotutor.json)。
+
+孩子端打开就是首页:
+
+- 老师的头像叠在一起,一次只展开一位老师的卡,卡上几个按钮。孩子点哪个,就带着哪个意思进那位老师。
+- 一进来展开的是草稿里第一张老师卡的那位。最想让孩子先做的,写在最前面。
+- 还有几张给孩子看的卡:一段字、几个字的田字格、一张图、一段点读。
+
+首页由你和家长商量,**家长批准后发布**。孩子只看得到发布的那份。
+
+## 铁律
+
+- **发布要家长在这次对话里明说**(「发吧」「可以发布」)。草稿随便改;cotutor home publish 只在明说之后跑。
+- 不写 vault。总结要留下来,走记账(第二步),由应用落进日记。
+- 不改 conversations/、ledger/、cotutor.json、老师文件。
+- home/published.json 与 home/history/ 是机器件,不手改。
+- 孩子看得到的字(按钮、卡)不评判:不写对错、分数、名次、「真棒」「聪明」「最…」。
+- agents/<name>.md 是老师文件,由 cotutor 读正文传给 Qwen。不要当子代理派,也不要替老师回答孩子。
+
+## 一、看今天
+
+1. `cotutor home show`:现在发布的是哪份、每个按钮被点了几次。先知道上次推荐的,孩子选了什么。
+2. 有脸的老师逐位读 conversations/<老师>/<今天>.json。有脸的老师 = cotutor.json 里键以 -tutor 结尾、enabled、不 hidden 的。要看的:
+   - 话题(thread)。
+   - 孩子的话(from: kid)。带 via、且 button 是数字的那条,是按钮上的字,不是孩子说的。
+   - 每轮的 kidText 与 section.cards。
+   - parentText:老师写给家长的。
+   - remembered。
+3. 细看一轮,用 `cotutor show <老师> <job>`。卡的 id(`<job>/<n>`)在「卡」那一行。
+4. 孩子在卡上做的:conversations/<老师>/<日期>.<job>.cards/<n>.json。
+
+总结在对话里说,不落文件。每位老师两三行:学了什么、停在哪、哪里卡住。引孩子的原话,或卡上做的。
+
+## 二、记账
+
+要留下来的,走记账:
+
+1. 家长给值得记的话题打星:`cotutor rate <老师> <话题> <1-5>`。到 vault.keepScore 的,摘要才进日记。
+2. 再跑 `cotutor bookkeep <老师>`。
+
+- 记账每个话题起老师一轮;记完,每位有记忆的老师再整理一轮记忆,结果直接落进记忆文件。**花钱,先问。**
+- 家长说不记,就跳过。
+- 记完读当天日记核对一眼。日记在 vault 的 `paths.diary` 下,缺省 `日记/<日期>.md`。
+
+## 三、商量下次
+
+先在对话里列提案,不写文件。
+
+材料:
+
+- 今天停在哪。
+- 日记最近的「- 观察:」。
+- 本周计划里各位老师那段、课程表。
+- 这科这学期的入口文件与教材:下一课是什么。
+- 上次首页被点了什么。
+
+### 老师卡
+
+每位老师一张。不写的,应用会补一张只有「新话题」的。
+
+- 按钮最多 4 个。「新话题」应用自己加,不写。
+- 孩子看的字最多 16 个,孩子的口吻:「我要预习小蝌蚪找妈妈」「接着写看图写话」「再练两道退位减法」。
+- 每个按钮下一行「讲法:」,写给老师:从哪开始、重点是什么、讲到哪收。孩子看不到。
+- 「接着」要指到那一天的那个话题:日期 + 话题 id。老师会拿到那个话题最后一节的讲稿与卡。今天的话题,就是接着聊。
+- 「小课堂」要指到 `bundles/` 里一份课包,或 `lectures/` 里一份视频的 id。孩子先从头看完这一课,才能问老师。
+- 看完怎么聊,在这位老师的 `agents/<老师>/activities/小课堂.md`;没有这份,小课堂按钮不出(首页检查报)。
+- 小课堂的讲法写孩子在这一课常卡在哪,别写课里已经讲过的。
+- 「activity」是老师的一种做法,写在 `agents/<老师>/activities/<名>.md`(如语文老师的「你说我画」)。`cotutor activity check <老师>` 列出这位老师有哪些、每个要家长填什么。
+- 看图说话、你说我画都是语文老师的 activity:`activity 看图说话`、`activity 你说我画`。孩子在新话题里拍看图说话,老师不走那套;要他照那套说,就摆按钮。
+- 小课堂看完要接着照某个 activity 聊(如看图说话的课),在小课堂按钮下面挂一行 `activity: 看图说话`。
+- activity 按钮写 `activity <名> [孩子看到的字]`,下面一行一个参数(`词: 播种、羞愧`),照那个文件「## 家长填的」填;同一个 activity 填不同的参数可以是两个按钮(你说我画、我来出题)。
+- 家长想改 activity 本身怎么带,不在这里改,用 cotutor-tune。
+
+### 老师想要的小课堂
+
+老师讲到要画出来才讲得清的题,会在给家长的尾巴里写一段 `## 想要小课堂`:`题面:` 和 `讲法:`。
+
+- 家长问「老师想要哪些小课堂」,在 `conversations/<老师>/<日期>.json` 里找 `parentText` 带「## 想要小课堂」的消息,从近往远列。
+- 照题面和讲法做一堂课包小课堂(下一节),挂到那位老师的卡上。
+
+### 课包小课堂
+
+- 课包用 `cotutor chalk` 做:场景怎么写看 chalk-scene 技能,怎么讲看 chalk-teaching,命令看 chalk-cli。`build` 直接出到 `bundles/<id>/`,再 `dub` 配音。
+- 画面上孩子可能画到的东西,在场景里起名字:几笔合起来是一样东西写 `groups`,单独一笔写 `label`。写法见 chalk-scene。
+- 名字用讲稿里的说法,如「散的 3 根小棒」。
+<!-- 为什么:孩子在它上面画了,老师拿到的是这个名字;不起名字只能说「第 1 步画的 3 条线」。 -->
+- 起了名字要重新 build。配音不用重配。
+- 挂首页之前烤一下画面:`cotutor chalk bake <id>`(跑过 snap 就已经烤了)。烤过的课包,孩子端不用现画,iPad 上顺;首页检查会提醒没烤的。
+- 改了画面要重烤;只改讲稿、重配音不用。
+
+### 视频小课堂
+
+家长要放一段现成的视频当小课堂,在 `lectures/<id>/` 放两个文件:
+
+- `video.mp4`:声音烧在视频里。
+- `lecture.md`:第一行 `# 标题`,下面一行一句「分:秒 原话」,是这一句在视频里的起点和说的话。
+- 原话照视频里说的抄,老师靠它知道课里讲了什么。
+- 句子按时间排,第一句从 `0:00` 起。
+- 可以在开头写 frontmatter `subject: 数学`,首页检查拿它对老师的科目。
+- id 用小写字母、数字、连字符,如 `2026-10-06-pingjunfen`。
+
+```markdown
+---
+subject: 数学
+---
+# 平均分:一个一个轮着分
+
+0:00 12 块饼干分给 3 个小朋友,怎么分才公平?
+0:05 一个一个轮着分:你一块、我一块、他一块。
+0:11 分完了,每人 4 块,一样多。这就是平均分。
+```
+
+写好挂上首页按钮,`cotutor home check` 会说哪里不对。
+- 没什么要推荐的老师,不写按钮。
+
+### 其余的卡
+
+按需,一两张就够。写在哪,孩子就在哪看到:
+
+- 写在某张老师卡后面:只在那位老师展开时看到。跟这位老师的事有关的,写在他后面。
+- 写在所有老师卡前面:谁展开都看得到。只放今晚先看一眼的那一句。
+- 听写卡写了老师(`dictation chinese-tutor`),就归那位老师,不看写在哪。
+
+- 要孩子今晚先看一眼的一句话:`text`。
+- 要再写一遍的字:`tianzige`。
+- 一张图:`image`。
+- 一段要读的:`read`。
+
+每条提案带一句「为什么」。家长改、删、加,直到点头。
+
+## 四、写草稿、检查、预览
+
+1. 家长点头后,写 home/draft.md,整份覆盖。
+   - 先读已发布那份的原文当底稿:home/published.json 里 `source` 指的那个文件。家长可能在家长端改过首页(加了开场按钮、设了这周的词、调了老师的先后),那些都在原文里,不在 draft.md 里。家长没说要删的,照留。
+   - 按钮下面的 `留到: <日期>` 是家长定的留多久,过了的按钮可以去掉。
+   - 写法见 references/首页语法.md,老师卡的细则在 references/tutor.md。
+   - 最后写「## 为什么这么排」,把第三步每条的「为什么」放进去。这段给家长,孩子看不到。
+2. `cotutor home check`。「要改」的改到没有;「提醒」的跟家长说一声。
+3. 想先看样子:`cotutor home check` 列出孩子会看到的每张卡、每位老师的按钮与讲法;要看真页面,发布后在孩子端首页看,不满意改草稿再发(每次发布留一份历史,`--from` 能回去)。
+4. 家长要改就改草稿,再 check。
+
+## 五、发布
+
+家长明说之后:`cotutor home publish`。
+
+- 它再检查一遍、留历史,打印发布的 id。
+- 孩子端刷新就是新首页,不用重起服务。
+- 发完告诉家长:发了哪几张卡、哪几条提醒还在。
+
+回到以前的某份:`cotutor home publish --from home/history/<id>.md`,同样先问。
+
+## 报告怎么写
+
+1. 总结先行:每位老师两三行。
+2. 再是下次的提案:按卡列,带为什么。
+3. 最后是做了什么:记没记账、花了多少、草稿写没写、check 结果、发没发布。

package/skills/cotutor-home/references/dictation.md

@@ -0,0 +1,97 @@
+# dictation — 听写
+
+## 是什么
+
+听写卡:首页上一张,写着「听写 · 6 个词」。孩子点开,老师一个词一个词念,孩子用 Apple Pencil 在田字格里写。全部写完,书上的字淡淡叠在孩子写的上面,孩子自己对。只用在首页。
+
+## 什么时候用 / 别用
+
+- 用:孩子今天要听写生字词,家长把词表给你。
+- 用:上次听写没写全的词,排进下一次。
+- 别用:教一个字怎么写 → `tianzige`。
+- 用:英语单词听写:一张卡里都写英文单词,孩子在四线三格里写整个单词。
+- 别用:板书里 → 只能用在首页。
+
+## 写法
+
+围栏标签 `dictation <老师的键>`。老师的键可以不写,不写就用语文老师的声音。
+
+正文一行一个词:
+
+- 词是一到四个汉字,不带拼音和标点。
+- 要说明怎么念,在词后面空一格接着写。例如 `鼓励 鼓励,老师鼓励我的鼓励`。
+- 同音的、单个字的词,都写上念法。例如 `叶 树叶的叶`。
+- 念法是孩子听到的全部。它会被念两遍。
+- 最多 20 个词。
+- 英文单词前面可以配一个 emoji,如 `🚌 bus a red bus`。能画出来的东西才配,抽象的词(like、the)不配。孩子写完对答案时才看到。
+
+## 例子
+
+<!-- expect {"kind":"dictation","props":{"tutor":"chinese-tutor","words":[{"chars":"春天"},{"chars":"鼓励","say":"鼓励,老师鼓励我的鼓励"},{"chars":"叶","say":"树叶的叶"}]}} -->
+```dictation chinese-tutor
+春天
+鼓励 鼓励,老师鼓励我的鼓励
+叶 树叶的叶
+```
+
+不写老师,用语文老师的声音:
+
+<!-- expect {"kind":"dictation","props":{"words":[{"chars":"花朵"},{"chars":"雪花"}]}} -->
+```dictation
+花朵
+雪花
+```
+
+英文单词,英语老师的声音念:
+
+<!-- expect {"kind":"dictation","props":{"tutor":"english-tutor","lang":"en","words":[{"chars":"red"},{"chars":"yellow","say":"yellow, a yellow bus"},{"chars":"ice-cream","emoji":"🍦"}]}} -->
+```dictation english-tutor
+red
+yellow yellow, a yellow bus
+🍦 ice-cream
+```
+
+## 反例
+
+词里夹了拼音,解析不成,整张卡退成一段文字:
+
+<!-- expect {"kind":"text","warning":true} -->
+```dictation
+鼓励gǔlì
+```
+
+汉字的词和英文单词写在一张卡里,解析不成:
+
+<!-- expect {"kind":"text","warning":true} -->
+```dictation
+春天
+red
+```
+
+一个词超过四个字,解析不成:
+
+<!-- expect {"kind":"text","warning":true} -->
+```dictation
+画蛇添足画
+```
+
+## 孩子看到什么
+
+首页上一张卡,写着「听写」和几个词,看不到字。点开后:
+
+1. 老师念第一个词,念两遍。孩子听不清可以点「再念」。
+2. 左边是听写本,一个词一行;右边一个大田字格,一次写一个字,写好点「这个字写好了」。
+3. 不会写可以点「不会写,给答案」:书上的字一笔一笔写给他看,再照着灰色描红写一遍。
+4. 全部写完,书上的字淡淡叠在孩子写的字上。孩子点一个字,书上的字就在他写的字上一笔一笔写一遍。
+5. 少写了笔、多写了笔、空着的词,卡上问一句「这个再写一遍?」,不画叉,不打分。看过答案的词不再问。
+6. 孩子可以对任何一个词说「我想再写」。
+
+英文单词:一个单词一个四线三格,写整个单词;写完正确的单词淡淡叠在上面,配了 emoji 的放在旁边,孩子自己对,不逐个字母比,也不问「再写一遍?」,想再写自己点。
+
+## 你会收回什么
+
+孩子写的每一笔都会记下来,连同时刻。应用逐字对照书上的笔画,记下少了哪一笔、多了几笔、笔顺对不对、写得偏不偏、哪个字看了答案。家长在 `/dictation/parent` 看结果,在 `/dictation/reel` 看录像。卡上没有状态。
+
+## 状态的形状
+
+没有。

package/skills/cotutor-home/references/tutor.md

@@ -0,0 +1,148 @@
+# tutor — 老师卡
+
+## 是什么
+
+老师卡:首页上一位老师一张,卡上几个按钮,孩子点哪个就带着哪个意思进这位老师——新开一个话题、接着以前的某个话题、说一句开场话让老师照家长备好的讲法讲起来,或者先看一堂做好的小课堂。只用在首页。
+
+## 什么时候用 / 别用
+
+- 用:排首页时,给每位要推荐下一步的老师写一张:预习下一课、接着没讲完的、再练一练。
+- 用:同一位老师有两三件事,写在同一张卡上,一行一个按钮。
+- 别用:在板书里写老师卡 → 板书里退成一段文字;老师之间不互相推荐。
+- 别用:没什么要推荐的老师不必写 → 应用会补一张只有「新话题」的。
+- 别用:同一位老师写两张 → 只认第一张,检查会让你合并。
+
+## 写法
+
+围栏标签 `tutor <老师的键>`(cotutor.json tutors 里的英文名,如 `chinese-tutor`)。正文一行一个按钮,孩子看到的字就是这一行,最多 16 个字,孩子的口吻;最多 4 个按钮。
+
+- 普通的一行 = **开场按钮**:孩子点了,这行字就作为孩子的第一句发给老师,新开一个话题。
+- `接着 <日期> <话题> <孩子看到的字>` = **接着按钮**:接着那天的那个话题(话题 = 那个话题第一条消息的 job,如 `1930-1`,`cotutor show` 与对话索引里都有)。今天的话题就是接着聊;以前的新开一个会话,老师会拿到那个话题最后一节的讲稿与卡。
+- `小课堂 <课包或视频的 id> <孩子看到的字>` = **小课堂按钮**:孩子点了先铺满看这一课(课包 `bundles/<id>/`,或视频 `lectures/<id>/`),看完才能开口;开口那句新开一个话题,老师拿到课的每句原话与孩子看的情况。
+- `activity <名> [孩子看到的字]` = **activity 按钮**:进这位老师的一个 activity(`agents/<老师>/activities/<名>.md`,如你说我画)。字不写就是 activity 的名字。孩子点了和开场按钮一样,新开一个话题,老师照那个 activity 文件带。
+- 小课堂按钮下面可以挂一行 `activity: <名>`:孩子看完课开口那条起,老师照那个 activity 带(参数用缺省)。如看图说话的课,挂 `activity: 看图说话`。
+- activity 按钮下面 `名: 值` 的行是这个 activity 的参数(家长填的),一行一个。有哪些参数、什么类型、能不能空,看那个文件的「## 家长填的」;检查会对。孩子看不到。
+- `讲法: …` 挂在上一个按钮下面,写给老师的:从哪开始、重点是什么、讲到哪收。可以写多行。孩子看不到。
+- `留到: <日期>` 挂在上一个按钮下面:这个按钮留到那天(含那天),过了孩子就看不到。不写就一直留着。
+- `新话题` 不用写,应用永远放第一个。
+
+## 例子
+
+<!-- expect {"kind":"tutor","props":{"tutor":"chinese-tutor","buttons":[{"kind":"start","label":"我要预习小蝌蚪找妈妈","brief":"第 22 课。先带他把 1–3 自然段读顺,重点字 塘、脑、袋"},{"kind":"continue","label":"接着写看图写话","date":"2026-09-16","thread":"1930-1","brief":"上次第二句卡住了,先把他写的两句念给他听"}]}} -->
+```tutor chinese-tutor
+我要预习小蝌蚪找妈妈
+讲法: 第 22 课。先带他把 1–3 自然段读顺,重点字 塘、脑、袋
+接着 2026-09-16 1930-1 接着写看图写话
+讲法: 上次第二句卡住了,先把他写的两句念给他听
+```
+
+小课堂按钮(课包在 `bundles/` 里,或视频在 `lectures/` 里,检查会查):
+
+<!-- expect {"kind":"tutor","props":{"tutor":"math-tutor","buttons":[{"kind":"lecture","label":"13 减 8 怎么拆","bundle":"2026-09-18-po13-jian-8","brief":"他常把 13 当成 1 和 3"}]}} -->
+```tutor math-tutor
+小课堂 2026-09-18-po13-jian-8 13 减 8 怎么拆
+讲法: 他常把 13 当成 1 和 3
+```
+
+小课堂看完接着照 activity 带:
+
+<!-- expect {"kind":"tutor","props":{"tutor":"chinese-tutor","buttons":[{"kind":"lecture","label":"看图说话怎么说","bundle":"2026-10-08-kantu","activity":"看图说话"}]}} -->
+```tutor chinese-tutor
+小课堂 2026-10-08-kantu 看图说话怎么说
+activity: 看图说话
+```
+
+只今天用的开场按钮:
+
+<!-- expect {"kind":"tutor","props":{"tutor":"chinese-tutor","buttons":[{"kind":"start","label":"我要读课文","brief":"第 22 课,读顺 1–3 自然段","until":"2026-10-10"}]}} -->
+```tutor chinese-tutor
+我要读课文
+讲法: 第 22 课,读顺 1–3 自然段
+留到: 2026-10-10
+```
+
+activity 按钮(你说我画;填了「词」就是我来出题):
+
+<!-- expect {"kind":"tutor","props":{"tutor":"chinese-tutor","buttons":[{"kind":"activity","label":"你说我画","activity":"你说我画","params":{}},{"kind":"activity","label":"我来出题","activity":"你说我画","params":{"词":"播种、睡大觉、满满、羞愧"},"brief":"他上周把羞愧说成害羞,落到幅上时问一句"}]}} -->
+```tutor chinese-tutor
+activity 你说我画
+activity 你说我画 我来出题
+词: 播种、睡大觉、满满、羞愧
+讲法: 他上周把羞愧说成害羞,落到幅上时问一句
+```
+
+只要「新话题」的老师,正文空着(也可以不写这张卡):
+
+<!-- expect {"kind":"tutor","props":{"tutor":"english-tutor","buttons":[]}} -->
+```tutor english-tutor
+```
+
+## 反例
+
+按钮的字太长(要跟老师说的话写进了按钮)解析不成,整张卡退成一段文字,检查报「要改」:
+
+<!-- expect {"kind":"text","warning":true} -->
+```tutor math-tutor
+再练两道退位减法,先让他说怎么想,跨十那一步慢一点
+```
+
+`接着` 没写日期和话题:
+
+<!-- expect {"kind":"text","warning":true} -->
+```tutor chinese-tutor
+接着 小蝌蚪找妈妈
+```
+
+`小课堂` 后面只写了课名,没写课包 id:
+
+<!-- expect {"kind":"text","warning":true} -->
+```tutor math-tutor
+小课堂 13减8怎么拆
+```
+
+课包 id 写错(或课包还没做),解析得过,首页检查报「要改」:`bundles/<id>/` 不在或读不出来。
+
+`留到:` 后面写的不是日期:
+
+<!-- expect {"kind":"text","warning":true} -->
+```tutor chinese-tutor
+我要读课文
+留到: 明天
+```
+
+`activity` 后面没写名字:
+
+<!-- expect {"kind":"text","warning":true} -->
+```tutor chinese-tutor
+activity
+```
+
+`activity:` 挂在开场按钮下面(只能挂在小课堂按钮下面):
+
+<!-- expect {"kind":"text","warning":true} -->
+```tutor chinese-tutor
+我要看图说话
+activity: 看图说话
+```
+
+activity 的名字写错、参数写错或少了要填的,解析得过,首页检查报「要改」(对的是那个 activity 文件)。
+
+`讲法:` 前面没有按钮:
+
+<!-- expect {"kind":"text","warning":true} -->
+```tutor chinese-tutor
+讲法: 先读课文
+我要预习小蝌蚪找妈妈
+```
+
+## 孩子看到什么
+
+首页最上面,一位老师一张卡:头像、名字,下面一个学科色大气泡「新话题 · 想问我什么?」,然后是你写的(开场按钮与 activity 按钮是带 ▶ 的大胶囊,接着按钮带 ↻;小课堂是一张带预览图的海报,图上一个播放键,下面写课名与课长)。点开场或接着按钮,老师页打开、按钮上的字立刻发出去,老师接着就讲;点新话题是空白的老师页,等孩子开口。今天从同一个按钮聊过的,在老师页的空白板上接(新话题一个胶囊;activity、小课堂先问接着还是重新开始),不占按钮。今天的条数用完、或服务不通,整张卡变灰。讲法孩子永远看不到。
+
+## 你会收回什么
+
+没有卡上的状态。孩子点了哪个按钮,记在那条消息的 `via` 上(`cotutor home show` 汇总);老师那边,开场与接着按钮的那条消息的上下文包里有 `home:`(按钮的字与讲法),接着以前话题的还有 `continue:`,小课堂看完开口那条还有 `lecture:`(课的每句原话与看的情况);activity 按钮起的话题,每条都有 `activity:`(哪个 activity、家长填的参数、应用算的);那个文件「老师怎么带」一节就是这个话题的系统提示,人设、卡、记忆都是它自己的。
+
+## 状态的形状
+
+没有。

package/skills/cotutor-home/references//345/221/275/344/273/244.md

@@ -0,0 +1,21 @@
+# 命令(机器生成,别改)
+
+在 workspace 根跑;完整用法 cotutor --help。
+
+```
+  cotutor show <老师> <job> [<日期>] [--json] [--evals] [--workspace <dir>]   看一轮:问了什么、上下文包、当时的老师文件与技能 hash、讲稿与卡、读了什么、token 与用时、给家长的尾巴;--json 是家长端「看原文」同一份数据,给编程助手分析用
+  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]                                          现在发布的是哪份、几天前、每个按钮被点了几次(哪天、哪个话题)
+```
+
+## 文件
+
+| 文件 | 是什么 |
+|---|---|
+| `home/draft.md` | 草稿:你写、家长可改;孩子端不读 |
+| `home/published.json` | 已发布的那份(publish 生成,机器件,别手改);孩子端只读它 |
+| `home/history/<id>.md` | 每次发布的原文 |
+| `conversations/<老师>/<日期>.json` | 一天的对话索引;消息的 `via` = 从首页哪个按钮进来的(`{home, button, label}`),`continues` = 接着哪天哪个话题 |