cotutor 0.1.0 → 0.3.0

package/skills/cotutor-tutor/references//344/270/212/344/270/213/346/226/207/345/214/205.md

@@ -0,0 +1,78 @@
+<!-- 给人看
+谁读:有脸的老师按需 Read;workspace 里的编程助手(cotutor-analyze)查「老师看到了什么」
+能改:机器件,upgrade 覆盖。形状的真相在 src/schema/context-pack.ts;加一个字段,这里就要加一行(tests/skills.test.ts 查)
+-->
+
+# 上下文包每一行是什么
+
+消息前面 `cotutor:` 开头的那段 YAML,是应用替你备好的。它后面接几段原文,再是 `---`,再是消息本身。
+
+怎么用这些行,见守则(`<cotutor-rules>`)。
+
+## 每一行
+
+| 行 | 是什么 | 什么时候有 |
+|---|---|---|
+| `at` | 本地时间,分钟精度,如 `2026-09-08T16:20` | 每条 |
+| `slot` | 课程表命中的时段,如「数学 16:00-17:00」 | 命中时 |
+| `focus` | `focus.card` 是孩子发消息时正开着的那张卡(`<job>/<n>`) | 开着卡时 |
+| `rules` | 老师守则在哪,后面跟状态 | 有脸的老师 |
+| `boardGuide` | 板书写法在哪:「已在你的系统提示里」,或一个路径加状态 | 板书没关时 |
+| `activityGuide` | 这个话题的 activity:「已在你的系统提示里」,或文件路径加状态(原文在 `<cotutor-activity>`) | activity 话题 |
+| `semester` | 当前学期,如「二年级上」。应用按档案算好的,你不用再推 | 算得出时 |
+| `profile` | 档案的路径(相对 vault 根),后面跟状态 | 每条 |
+| `child` | 孩子的记忆的路径,后面跟状态:关于孩子本人、换一科也成立的,所有老师共用一篇;「还没有」= 谁都还没记过 | 有脸的老师 |
+| `entry` | 你这一科这学期入口文件的路径,后面跟状态 | 有脸的老师 |
+| `memory` | 你的记忆文件的路径,后面跟状态;「还没有」= 你还没记过东西 | 每条 |
+| `lesson` | 家长写的那一课的口径在哪(教材路径加课题),后面跟状态;原文在 `<vault-note role="lesson">` | 孩子提到那一课、或问到那一课要会写的字时 |
+| `refs` | 参考资料的绝对路径:这科这学期的教材,加档案与入口文件里链到的笔记。**只给路径**,用到才读 | 有资料、这轮带工具时 |
+| `plan` | 本周计划里你的行 | 计划里有你时 |
+| `recent` | 最近 14 天日记里本学科的「- 观察:」行,取最新的几条 | 有观察时 |
+| `lookup` | 应用替你查好的,一条一行:孩子问到的字在这学期生字表的哪一课、会认还是会写(「不在这学期的识字、写字表里」= 不是这学期的字);以前讲过那一课的骨架 | 孩子问字、提到某一课,教材里查得到时 |
+| `board` | `off` = 只说话,不出卡 | 家长关了板书时 |
+| `cards` | 上一轮之后孩子在卡上做的,一张卡一行:编号、种类、标题、做了什么、答案。交了画板的,行里有几笔(各颜色几笔)、画了多久、清空重画过几次,和那张图、清掉的那几版的绝对路径,**Read 用它** | 孩子动过卡时 |
+| `lecture` | 孩子刚看完的小课堂:`title` 课名,`source` 哪一课(`bundle <id>` 是课包,`video <id>` 是视频),`length` 课长,`lines` 每句的起点与原话(「0:18 …」),`watched` 他怎么看的(看完没、停过几次、画了几处),`marks` 他画的每一处(停在同一刻画的几笔):那一刻在讲哪句、截图是 `photos` 里第几张;课包的还说画的地方盖着什么 | 看完后的第一条;问过以后再看一遍又画了的那条 |
+| `home` | 孩子从首页的按钮进来:`button` 是按钮上的字,`brief` 是家长备好的讲法 | 只在按钮发来的那条 |
+| `live` | 这一轮走实时:你的讲稿交给嘴(realtime 模型)照念、不配音。`caught` 是嘴先说的那句(只有拍照时有:「我看一看图片」);`cut` 是上一轮你的讲稿念到第几句被孩子打断(0 = 一句都没念到,孩子没听到你上一轮写的)。口语课还有:`warmup` 热身的摸底,一拍一行(应用按转写记,不说明发音);`phone` 打电话打了几分钟;`app` 这一轮不是孩子说的(`call` 你念了 `[[call]]`,现在开始打电话;`quiet` 热身里孩子连着两拍没开口)。交画的那一轮还有 `draw`:这张画画着的时候孩子说的和你(嘴)说的,一句一行(「孩子:…」「你:…」) | 实时老师的每一轮 |
+| `drawing` | 孩子从左栏的纸上交来的画:是 `photos` 第几张、几笔(各颜色几笔)、画了多久、清空重画过的话清掉的那几版是第几张 | 孩子交了纸上的画时 |
+| `continue` | 接着以前某天的某个话题:`from` 哪天哪个话题,`title` 话题名,`said` / `cards` 那个话题最后一节的讲稿与卡(卡带孩子做的与答案),`index` 那天的对话索引 | 只在新话题的第一条 |
+| `activity` | 孩子从首页的 activity 进来的话题:`name` 是哪个,`params` 是家长填的,`state` 是应用算好的(如还能画几张)。在最后几行 | activity 话题的每一条 |
+| `photos` | 这条带的作业照片,相对 workspace 根。写在卡上用 | 孩子拍了照片时 |
+| `photoFiles` | 同一批照片的绝对路径,顺序一一对应。**Read 用它** | 同上 |
+| `vault` | 家长的 Obsidian 仓库在哪:`root` 是绝对路径,`diary` / `plans` / `timetable` / `reference` 相对 `root` | 配了 vault、这轮带工具时 |
+
+## 路径后面的状态
+
+`rules`、`boardGuide`、`activityGuide`、`profile`、`child`、`entry`、`memory`、`lesson` 的路径后面可能跟一段括号:
+
+| 写着 | 意思 | 你怎么做 |
+|---|---|---|
+| 只有路径 | 原文就在后面的原文段里 | 看原文段 |
+| 「未变」 | 这个话题前面已经给过原文,内容没改 | 往前看,别再 Read |
+| 「截到 N」 | 原文太长,只带了前面 N 字 | 用带来的这些;这轮带工具才 Read 全文 |
+| 「只带最近 N」 | 记忆(或孩子的记忆)太长,截掉的是前面旧的 | 同上 |
+| 「缺:…」 | 没有这篇,冒号后面写着为什么 | 照常教,别编 |
+
+## 原文段
+
+YAML 后面、`---` 前面,整篇原文照登:
+
+| 标签 | 是什么 |
+|---|---|
+| `<cotutor-rules>` | 老师守则 |
+| `<cotutor-board>` | 板书写法(没进系统提示时才有) |
+| `<cotutor-activity>` | 这个 activity 怎么带(没进系统提示时才有);后面可能接「这个 activity 多用的卡」的写法 |
+| `<vault-note role="profile">` | 档案 |
+| `<vault-note role="child">` | 孩子的记忆:所有老师共用,和档案对不上时以档案为准 |
+| `<vault-note role="entry">` | 你这一科这学期的入口文件 |
+| `<vault-note role="memory">` | 你的记忆 |
+| `<vault-note role="lesson">` | 家长写的那一课怎么讲(教材那一节的 `### 口径`) |
+
+- 守则与笔记只在话题第一条带,或者话题里原文改过了才再带。
+- 家长写的字是真相。
+
+## 拼 vault 里的路径
+
+- 路径拼法:`<vault.root>/<相对路径>`。
+- `root` 可能含空格。
+- 别猜缺省名,别去读 cotutor.json。

package/themes/default/kid.css

@@ -0,0 +1,86 @@
+/*
+ * cotutor 出厂主题 default —— 孩子端板书的样子:板、卡、笔、舞台壳。
+ * 这份是家长的(init 拷进 workspace 的 themes/default/,改了刷新就有;没改过的随 cotutor upgrade 更新)。
+ * 槽的名字在旁边的 theme.json:底色槽 → .c[data-tint="<名>"],字形槽 → .c[data-look="<名>"],笔 → .mk-<名> / .pen-<名>;
+ * 名字对不上的卡落回 paper / plain(.c 的缺省)。页面骨架(首页、头部、字幕行、输入条)在页面里,这里只管板书。
+ * 各种卡自己的结构样式(选项行、空、图、缩略图)在包里 cards/<kind>/card.css,服务把它们拼在这份前面——这里写同名选择器就能盖过去。
+ */
+
+/* ---- 值:板、六个底色槽、五支笔、选中态 ---- */
+:root {
+  --paper:#faf9f4; --ink:#2b2b2b; --dim:#8a8781; --line:#e2dfd6; --card:#ffffff; --kid:#dbeeff; --tutor:#fff3d6; --accent:#e8743b; --hi:#ffe3a8; --blue:#eef4ff; --cream:#f7f1e3; --ok:#e8f6ee; --ok-ink:#1f8a4c; --purple:#efe9fb; --purple-ink:#7a4fc9; --grey:#eeece6;
+  --tint-paper-bg:#ffffff; --tint-paper-line:#e2dfd6; --tint-paper-head:#6b675f;
+  --tint-sky-bg:#e9f1fb;   --tint-sky-line:#c6d9f0;   --tint-sky-head:#2f5e9e;
+  --tint-moss-bg:#e5f4ea;  --tint-moss-line:#bddcc8;  --tint-moss-head:#1f8a4c;
+  --tint-sand-bg:#f9f1de;  --tint-sand-line:#e7d7b2;  --tint-sand-head:#8a5a12;
+  --tint-plum-bg:#efe9fb;  --tint-plum-line:#d3c6f0;  --tint-plum-head:#7a4fc9;
+  --tint-night-bg:#2b3a4a; --tint-night-line:#2b3a4a; --tint-night-head:#ffffff;
+  --pen-marker:#ffd66b; --pen-tint:#b9e6c8; --pen-underline:#e8743b; --pen-box:#7a4fc9; --pen-circle:#1f8a4c;
+  --sel:#e8743b; --sel-halo:rgba(232,116,59,0.22);
+  --serif:"Songti SC","Times New Roman",serif;
+}
+
+/* ---- 节:头一行 + 行(行是页面按卡的宽度排的) ---- */
+.sec { display:flex; flex-direction:column; gap:12px; }
+.sec + .sec { margin-top:12px; }
+.sh { display:flex; align-items:center; gap:8px; padding:6px 4px 0; font-size:13px; color:var(--dim); white-space:nowrap; }
+.sh::after { content:""; flex:1; height:1px; background:var(--line); }
+.row { display:grid; gap:12px; grid-template-columns:repeat(1,minmax(0,1fr)); }
+.heading { font-size:16px; font-weight:700; padding:8px 4px 0; }
+
+/* ---- 卡:底色槽 + 同系描边,不用阴影;选中态主色描边 + 外晕,不放大 ---- */
+.c { position:relative; display:flex; flex-direction:column; gap:4px; padding:14px 16px; border-radius:16px; background:var(--tint-paper-bg); border:1.5px solid var(--tint-paper-line); font-size:17px; line-height:1.6; box-sizing:border-box; -webkit-user-select:text; user-select:text; transition:border-color .2s, box-shadow .2s; }
+.c .ct { font-size:13px; font-weight:700; color:var(--tint-paper-head); letter-spacing:.3px; }
+.c .cb { white-space:pre-line; }
+.c[data-tint="sky"] { background:var(--tint-sky-bg); border-color:var(--tint-sky-line); } .c[data-tint="sky"] .ct { color:var(--tint-sky-head); }
+.c[data-tint="moss"] { background:var(--tint-moss-bg); border-color:var(--tint-moss-line); } .c[data-tint="moss"] .ct { color:var(--tint-moss-head); }
+.c[data-tint="sand"] { background:var(--tint-sand-bg); border-color:var(--tint-sand-line); } .c[data-tint="sand"] .ct { color:var(--tint-sand-head); }
+.c[data-tint="plum"] { background:var(--tint-plum-bg); border-color:var(--tint-plum-line); } .c[data-tint="plum"] .ct { color:var(--tint-plum-head); }
+.c[data-tint="night"] { background:var(--tint-night-bg); border-color:var(--tint-night-line); color:#ffffff; } .c[data-tint="night"] .ct { color:var(--tint-night-head); }
+.c.now { border-color:var(--sel); box-shadow:0 0 0 3px var(--sel-halo), inset 0 0 0 .5px var(--sel); }
+/* 字形槽 */
+.c[data-look="title"] .cb { font-size:21px; font-weight:700; text-align:center; line-height:1.45; }
+.c[data-look="formula"] .cb { font-family:var(--serif); font-size:22px; text-align:center; letter-spacing:.5px; line-height:1.5; }
+.c[data-look="quote"] .cb { font-style:italic; text-align:center; color:#5a5650; }
+.c[data-tint="night"][data-look="quote"] .cb { color:#ffffffcc; }
+
+/* ---- 笔:面类一下子涂上;线条类是 SVG 路径,念到时描出来 ---- */
+.mk-marker { background:linear-gradient(transparent 30%, var(--pen-marker) 30%, var(--pen-marker) 90%, transparent 90%); padding:0 3px; border-radius:2px; }
+.c[data-tint="night"] .mk-marker { background:linear-gradient(transparent 30%, #ffd66b99 30%, #ffd66b99 90%, transparent 90%); }
+.mk-tint { background:var(--pen-tint); padding:0 4px; border-radius:5px; }
+.mk-underline, .mk-box, .mk-circle { padding:0 2px; }
+.mk-box { padding:1px 5px; }
+.pen { position:absolute; pointer-events:none; overflow:visible; }
+.pen path { fill:none; stroke-width:2.4; stroke-linecap:round; stroke-linejoin:round; }
+.pen-underline path { stroke:var(--pen-underline); }
+.pen-box path { stroke:var(--pen-box); stroke-width:2.2; }
+.pen-circle path { stroke:var(--pen-circle); }
+.pen.draw path { transition:stroke-dashoffset .55s ease-out; }
+.mk-marker, .mk-tint { animation:pen .25s ease-out; }
+@keyframes pen { from { opacity:0; } to { opacity:1; } }
+
+/* ---- 舞台:盖住板书那块,留 8px 边;顶栏 = 卡的名字 + 关闭;字幕行与输入条还在下面 ---- */
+#stage { position:absolute; inset:8px; border-radius:20px; background:#ffffff; box-shadow:0 8px 30px #00000029; display:none; flex-direction:column; z-index:5; overflow:hidden; }
+#stage.on { display:flex; }
+#stage .top { display:flex; align-items:center; gap:10px; padding:12px 14px 12px 20px; border-bottom:1px solid var(--line); }
+#stage .top .ttl { flex:1; min-width:0; font-size:17px; font-weight:600; white-space:nowrap; overflow:hidden; text-overflow:ellipsis; }
+#stage .top .kd { font-size:12px; color:var(--dim); border:1px solid var(--line); border-radius:10px; padding:1px 8px; }
+#st-x { width:40px; height:40px; display:grid; place-items:center; color:var(--dim); }
+#st-body { flex:1; min-height:0; overflow:auto; padding:20px; display:flex; flex-direction:column; gap:14px; -webkit-overflow-scrolling:touch; }
+#st-body[hidden] { display:none; }
+#st-body .c { font-size:20px; line-height:1.6; padding:18px 20px; }
+#st-body .c[data-look="title"] .cb { font-size:26px; } #st-body .c[data-look="formula"] .cb { font-size:28px; } #st-body .rd { font-size:22px; }
+#st-act { padding:12px 20px 16px; display:flex; align-items:center; justify-content:flex-end; gap:12px; border-top:1px solid var(--line); }
+#st-act .note { flex:1; font-size:14px; color:var(--dim); text-align:right; }
+#st-act[hidden] { display:none; }
+#st-go { padding:0 22px; height:48px; border-radius:24px; background:var(--accent); color:#fff; font-size:17px; font-weight:600; }
+#st-go:disabled { opacity:.35; }
+body.limit #st-go, body.pending #st-go { opacity:.35; pointer-events:none; }
+#st-frame { flex:1; min-height:0; width:100%; border:0; display:block; background:#ffffff; }
+#st-frame[hidden] { display:none; }
+
+/* ---- 平板横屏 ---- */
+@media (min-width:900px) and (orientation:landscape) {
+  #stage { left:50%; transform:translateX(-50%); width:min(1040px, calc(100% - 16px)); }
+  #st-body { padding:28px 40px; }
+}

package/themes/default/theme.json

@@ -0,0 +1,26 @@
+{
+  "name": "default",
+  "_note": "cotutor 出厂主题的清单。tints = 卡的底色槽、looks = 字形槽、pens = 五支笔;槽想要几个就几个,每个一个名字 + 一句「给什么用」(写课文件、排版时照这句挑),default 是素版与回退用的槽。颜色的值在旁边的 kid.css 里,这里只登记名字。",
+  "default": "paper",
+  "tints": {
+    "paper": { "use": "公式、图、代码:白底,不抢" },
+    "sky": { "use": "结论、定义、要记住的一句" },
+    "moss": { "use": "方法、那一下、验算" },
+    "sand": { "use": "事实、例子、列表、引言" },
+    "plum": { "use": "题目、要孩子做的" },
+    "night": { "use": "封面、反面、一节的收尾" }
+  },
+  "looks": {
+    "plain": { "use": "缺省:小标题 + 正文" },
+    "title": { "use": "一句话看懂:大字居中" },
+    "formula": { "use": "算式:衬线居中" },
+    "quote": { "use": "引一句原文:斜体居中" }
+  },
+  "pens": {
+    "marker": { "use": "荧光笔:要记住的一句 / 一个公式" },
+    "tint": { "use": "术语底:正在定义的词" },
+    "underline": { "use": "下划线:事实里的关键数字 / 词" },
+    "box": { "use": "方框:列表的引导词、选项" },
+    "circle": { "use": "圈:并列几项里点到的那个" }
+  }
+}

package/agents/chinese-teacher.md

@@ -1,19 +0,0 @@
----
-name: chinese-teacher
-description: 语文老师。生字、词语、课文、写话都找它;先一两句大白话回答,要范读要示范的以后再出课件
-maxTurns: 40
-permissionMode: bypassPermissions
-memory: project
----
-你是这个家的语文老师,面对的是一个小学生和他的家长。cwd 是你的家(agents/chinese-teacher/),账本在 ../../ledger/,家规在 ../../CLAUDE.md。消息前面有一段 `cotutor:` 开头的上下文包,先看它再答。孩子问「这个字怎么读 / 什么意思」这类,直接答。
-
-回复只有两种,先分清:
-- **问答**(缺省,孩子或家长随口问):这次回复就是一两句大白话,不超过三句;不用工具,不读账本(上下文包里已经给了时段、正在看什么、本周计划、最近观察),想到的就直接说。
-- **任务**(消息前的上下文包里 `from: system`,或家长明确写了「出课包 / 补讲 / 记账 / 做计划」):按任务做,做完在最后一段报告结果。
-
-现在还没有出课件的通道(R5 才接上):**不要自己写 HTML 或任何课件文件**。要画要讲的,在最后一段对孩子说「这个要画给你看,等我准备好会出现在你的今天里」就够了。
-
-你说给孩子听的话放在回复的**最后一段**;孩子只看得到最后一段,中间的话和工具过程只有家长看。永远不评价孩子答得对不对,不打分;把孩子的话当问题,不当答案。
-
-记账与记忆(只在任务里做,问答不做):值得别的老师知道的观察,追加一行到 ../../ledger/observations.jsonl;你自己的经验记进你的记忆目录。
-需要家长拍板的事写成一段「## 待裁量」(question: 一句话;options: 列表),不要停下来等。

package/agents/homework-aide.md

@@ -1,17 +0,0 @@
----
-name: homework-aide
-description: 作业助教。家长拍的作业照片先到它这里:认学科、认题号、交给对应的学科老师;自己不讲题
-maxTurns: 30
-permissionMode: bypassPermissions
-memory: project
----
-你是这个家的作业助教,只和家长打交道。cwd 是你的家(agents/homework-aide/),账本在 ../../ledger/,家规在 ../../CLAUDE.md。消息前面有一段 `cotutor:` 开头的上下文包,先看它再答。
-
-你的活:
-- 家长发来作业照片或素材集引用时,看照片认学科、认有几道题、哪几道错了,写一句结论。
-- 然后写一段「## 转交」交给学科老师(to: math-teacher / chinese-teacher / reading-teacher;why: 一句话;refs: 照片或素材集路径)。第一期只允许一跳,你自己不讲题。
-- 认不出学科、或照片糊了拍不全,写一段「## 待裁量」问家长(question + options),不要猜。
-- 把「哪天、什么作业、错了几道」追加一行到 ../../ledger/observations.jsonl。
-- 家长随口问你别的,一两句话答,不用工具。
-
-回复的最后一段留给家长看的一句话结论。

package/agents/math-teacher.md

@@ -1,19 +0,0 @@
----
-name: math-teacher
-description: 数学老师。孩子问数学题、家长发数学作业都找它;先一两句大白话回答,要画要讲的以后再出课包或补讲
-maxTurns: 40
-permissionMode: bypassPermissions
-memory: project
----
-你是这个家的数学老师,面对的是一个小学生和他的家长。cwd 是你的家(agents/math-teacher/),账本在 ../../ledger/,家规在 ../../CLAUDE.md。消息前面有一段 `cotutor:` 开头的上下文包(谁在说、几点、正在看什么、本周计划、最近观察),先看它再答。
-
-回复只有两种,先分清:
-- **问答**(缺省,孩子或家长随口问):这次回复就是一两句大白话,不超过三句;不用工具,不读账本(上下文包里已经给了时段、正在看什么、本周计划、最近观察),想到的就直接说。
-- **任务**(消息前的上下文包里 `from: system`,或家长明确写了「出课包 / 补讲 / 记账 / 做计划」):按任务做,做完在最后一段报告结果。
-
-现在还没有出课件的通道(R5 才接上):**不要自己写 HTML 或任何课件文件**。要画要讲的,在最后一段对孩子说「这个要画给你看,等我准备好会出现在你的今天里」就够了。
-
-你说给孩子听的话放在回复的**最后一段**;孩子只看得到最后一段,中间的话和工具过程只有家长看。永远不评价孩子答得对不对,不打分;把孩子的话当问题,不当答案。
-
-记账与记忆(只在任务里做,问答不做):值得别的老师知道的观察,追加一行到 ../../ledger/observations.jsonl;你自己的经验记进你的记忆目录。
-需要家长拍板的事写成一段「## 待裁量」(question: 一句话;options: 列表),不要停下来等。

package/agents/planner.md

@@ -1,18 +0,0 @@
----
-name: planner
-description: 规划老师。读账本和上周计划,出下周计划草稿到 vault 的计划目录;孩子端不露面
-maxTurns: 40
-permissionMode: bypassPermissions
-memory: project
----
-你是这个家的规划老师,只和家长打交道,孩子看不到你。cwd 是你的家(agents/planner/),账本在 ../../ledger/,家规在 ../../CLAUDE.md。消息前面有一段 `cotutor:` 开头的上下文包,先看它再答。
-
-你的活:
-- 家长说「做下周计划」(或 `from: system` 的定时任务)时,读 ../../ledger/observations.jsonl(最近两周)、../../ledger/artifacts.jsonl、上周的计划文件,写下周计划**草稿**。
-- 计划文件放 vault 的计划目录(cotutor.json 的 paths.plans),文件名 `<YYYY-Www>.md`,形状固定:
-  frontmatter `week: 2026-W37`、`status: draft`、`author: planner`;正文按老师**显示名**分 `## 数学老师` `## 语文老师` `## 朗读老师` `## 家长`,每段几行,宁少勿多。
-- 家长改成 `status: confirmed` 才算数;你不改别人的计划文件。
-- 别的老师的记忆目录也是本地文件,想读可以读,但以账本为准。
-- 家长随口问你别的,一两句话答,不用工具。
-
-回复的最后一段写一句:计划草稿放在哪里、几条。

package/agents/reading-teacher.md

@@ -1,19 +0,0 @@
----
-name: reading-teacher
-description: 朗读老师(英语)。教材页、单词、句子、跟读都找它;回答尽量短,英文后面跟中文
-maxTurns: 40
-permissionMode: bypassPermissions
-memory: project
----
-你是这个家的英语朗读老师,面对的是一个刚开始学英语的小学生和他的家长。cwd 是你的家(agents/reading-teacher/),账本在 ../../ledger/,家规在 ../../CLAUDE.md。消息前面有一段 `cotutor:` 开头的上下文包,先看它再答。孩子问单词、句子怎么读怎么说,直接答:英文一句,后面跟中文意思,总共不超过两句。
-
-回复只有两种,先分清:
-- **问答**(缺省,孩子或家长随口问):这次回复就是一两句大白话,不超过三句;不用工具,不读账本(上下文包里已经给了时段、正在看什么、本周计划、最近观察),想到的就直接说。
-- **任务**(消息前的上下文包里 `from: system`,或家长明确写了「出课包 / 补讲 / 记账 / 做计划」):按任务做,做完在最后一段报告结果。
-
-现在还没有出课件的通道(R5 才接上):**不要自己写 HTML 或任何课件文件**。要画要讲的,在最后一段对孩子说「这个要画给你看,等我准备好会出现在你的今天里」就够了。
-
-你说给孩子听的话放在回复的**最后一段**;孩子只看得到最后一段,中间的话和工具过程只有家长看。永远不评价孩子答得对不对,不打分;把孩子的话当问题,不当答案。
-
-记账与记忆(只在任务里做,问答不做):值得别的老师知道的观察,追加一行到 ../../ledger/observations.jsonl;你自己的经验记进你的记忆目录。
-需要家长拍板的事写成一段「## 待裁量」(question: 一句话;options: 列表),不要停下来等。

package/dist/cli/doctor.d.ts

@@ -1,19 +0,0 @@
-import { type ResolveOptions, type RootSource } from './workspace.ts';
-export interface DoctorCheck {
-    name: string;
-    ok: boolean;
-    required: boolean;
-    detail: string;
-    fix?: string;
-}
-export interface DoctorReport {
-    ok: boolean;
-    root: string | null;
-    source: RootSource | null;
-    checks: DoctorCheck[];
-}
-/** 预设的 CLI 名(run[0] 的 basename):决定链在 .claude 还是 .qwen 下 */
-export declare function presetCli(run: readonly string[]): string;
-export declare function doctorWorkspace(override?: string, opts?: ResolveOptions & {
-    probeEnv?: boolean;
-}): Promise<DoctorReport>;

package/dist/cli/doctor.js

@@ -1,190 +0,0 @@
-/**
- * cotutor doctor:环境 + 工作区逐项体检,失败项附修复命令(错误信息即修复指南)。
- * 静默失败摆到明面:配置坏了、老师链断了、账本有坏行、角色指向踩空。
- * exit 约定同 drawtell / voxtell doctor:必需项全过 exit 0,否则 1;--json 带 ok 与整份 checks。
- */
-import { execFile } from 'node:child_process';
-import { readFile, readdir, stat } from 'node:fs/promises';
-import { basename, join } from 'node:path';
-import { promisify } from 'node:util';
-import { parseAgentFile } from "../lib/agent-file.js";
-import { parseArtifactEvents, parseObservations } from "../lib/ledger.js";
-import { DIRS } from "./skeleton.js";
-import { CONFIG_FILE, ConfigError, USER_CONFIG, UsageError, assembleWorkspace, expandPath, parseConfig, readJson, redactHome, resolveRoot, } from "./workspace.js";
-const execFileP = promisify(execFile);
-async function statOrNull(p) {
-    return stat(p).catch(() => null);
-}
-async function evictedCount(dir) {
-    try {
-        return (await readdir(dir)).filter((f) => f.endsWith('.icloud')).length;
-    }
-    catch {
-        return 0;
-    }
-}
-/** 预设的 CLI 名(run[0] 的 basename):决定链在 .claude 还是 .qwen 下 */
-export function presetCli(run) {
-    return basename(run[0] ?? '');
-}
-export async function doctorWorkspace(override, opts = {}) {
-    const probeEnv = opts.probeEnv ?? true;
-    const checks = [];
-    const push = (c) => checks.push(c);
-    const [maj, min] = process.versions.node.split('.').map(Number);
-    const nodeOk = maj > 22 || (maj === 22 && min >= 18);
-    push({ name: 'node', ok: nodeOk, required: true, detail: `node ${process.versions.node}`, fix: nodeOk ? undefined : '需要 Node ≥ 22.18' });
-    let root = null;
-    let source = null;
-    try {
-        ({ root, source } = resolveRoot(override, opts));
-    }
-    catch (err) {
-        if (!(err instanceof UsageError))
-            throw err;
-        push({
-            name: err instanceof ConfigError ? 'user-config' : 'workspace',
-            ok: false,
-            required: true,
-            detail: err.message,
-            fix: err instanceof ConfigError ? `修复 ${redactHome(err.file)} 的 JSON,或删掉它` : 'cotutor init <slug>,或用 --workspace / COTUTOR_WORKSPACE 指定',
-        });
-        return { ok: false, root: null, source: null, checks };
-    }
-    push({ name: 'workspace', ok: true, required: true, detail: `${redactHome(root)}(来源:${source})` });
-    // ---- cotutor.json ----
-    let ws = null;
-    const configFile = join(root, CONFIG_FILE);
-    try {
-        const raw = readJson(configFile);
-        if (raw === null) {
-            push({ name: CONFIG_FILE, ok: false, required: true, detail: '不存在', fix: `cotutor init <slug> --dir ${redactHome(root)}(已有文件不动)` });
-        }
-        else {
-            const config = parseConfig(raw, configFile);
-            ws = assembleWorkspace(root, source, config);
-            push({
-                name: CONFIG_FILE,
-                ok: true,
-                required: true,
-                detail: `kid ${config.kid.slug}、${Object.keys(config.teachers).length} 位老师、预设 ${config.agents.default}、端口 ${config.server.port}`,
-            });
-        }
-    }
-    catch (err) {
-        if (!(err instanceof ConfigError))
-            throw err;
-        push({ name: CONFIG_FILE, ok: false, required: true, detail: err.message, fix: '按上面逐条修;政策文件机器不重建,改坏了靠 git 回退' });
-    }
-    // ---- 骨架 ----
-    const missing = [];
-    for (const d of DIRS)
-        if (!(await statOrNull(join(root, d)))?.isDirectory())
-            missing.push(`${d}/`);
-    push({
-        name: 'skeleton',
-        ok: missing.length === 0,
-        required: true,
-        detail: missing.length ? `缺 ${missing.join(' ')}` : [...DIRS].map((d) => `${d}/`).join(' '),
-        fix: missing.length ? `cotutor init <slug> --dir ${redactHome(root)}(幂等补缺)` : undefined,
-    });
-    const rulesMissing = (await Promise.all(['CLAUDE.md', 'QWEN.md'].map(async (f) => ((await statOrNull(join(root, f))) ? null : f)))).filter(Boolean);
-    push({
-        name: 'rules',
-        ok: rulesMissing.length === 0,
-        required: false,
-        detail: rulesMissing.length ? `缺家规 ${rulesMissing.join(' ')}(老师少了常驻指令)` : '家规 CLAUDE.md QWEN.md 在',
-        fix: rulesMissing.length ? 'cotutor init 补上(已有的不动)' : undefined,
-    });
-    if (ws) {
-        // ---- 老师:定义链 + 名字一致 + 老师目录 ----
-        const defaultCli = presetCli(ws.config.agents[ws.config.agents.default]?.run ?? []);
-        for (const name of Object.keys(ws.config.teachers)) {
-            for (const [cli, dir] of [
-                ['claude', ws.dirs.claudeAgents],
-                ['qwen', ws.dirs.qwenAgents],
-            ]) {
-                const file = join(dir, `${name}.md`);
-                const required = cli === defaultCli;
-                let detail;
-                let ok = false;
-                try {
-                    const { frontmatter } = parseAgentFile(await readFile(file, 'utf8'));
-                    ok = frontmatter.name === name;
-                    detail = ok ? `${redactHome(file)} name 一致` : `${redactHome(file)} 的 frontmatter name 是 "${frontmatter.name ?? ''}",与老师键 ${name} 不一致`;
-                }
-                catch {
-                    detail = `${redactHome(file)} 读不到(链断了或没建)`;
-                }
-                push({
-                    name: `teacher.${name}.${cli}`,
-                    ok,
-                    required,
-                    detail,
-                    fix: ok ? undefined : `cotutor init 重链(链到本包 agents/${name}.md),或把老师键改成文件里的 name`,
-                });
-            }
-            const home = join(ws.dirs.agents, name);
-            const there = (await statOrNull(home))?.isDirectory() ?? false;
-            push({ name: `teacher.${name}.home`, ok: there, required: true, detail: there ? `agents/${name}/ 在(会话 cwd)` : `agents/${name}/ 不在`, fix: there ? undefined : 'cotutor init 补建' });
-        }
-        // ---- paths 角色指向:配了就该在 ----
-        for (const [role, value] of Object.entries(ws.config.paths)) {
-            const target = ws.paths[role] ?? expandPath(value, ws.root);
-            const st = await statOrNull(target);
-            if (!st) {
-                push({ name: `paths.${role}`, ok: false, required: true, detail: `指向不存在:${redactHome(target)}`, fix: `mkdir -p 该目录,或修正 cotutor.json 的 paths.${role};指向 Obsidian vault 时确认 vault 已建、iCloud 已同步` });
-                continue;
-            }
-            const evicted = target.includes('Mobile Documents') && st.isDirectory() ? await evictedCount(target) : 0;
-            push({ name: `paths.${role}`, ok: evicted === 0, required: false, detail: `${redactHome(target)}${evicted ? `——有 ${evicted} 个 .icloud 占位` : ''}`, fix: evicted ? '关掉 iCloud「优化 Mac 储存空间」,或把该目录下载到本地' : undefined });
-        }
-        // ---- 账本:坏行必须响(不可再生,别删)----
-        for (const [name, file, parse] of [
-            ['observations', ws.files.observations, parseObservations],
-            ['artifacts', ws.files.artifacts, parseArtifactEvents],
-        ]) {
-            try {
-                const text = await readFile(file, 'utf8');
-                const { rows, errors } = parse(text);
-                push({ name: `ledger.${name}`, ok: errors.length === 0, required: true, detail: errors.length ? errors.slice(0, 3).join(';') : `${rows.length} 行`, fix: errors.length ? '修那几行,或 git checkout 回退;账本不可再生,不要删了重来' : undefined });
-            }
-            catch {
-                push({ name: `ledger.${name}`, ok: true, required: false, detail: '没有(还没记过);cotutor init 会建空文件' });
-            }
-        }
-        // ---- 预设的 CLI 在不在 ----
-        if (probeEnv) {
-            for (const [preset, p] of Object.entries(ws.config.agents)) {
-                if (preset === 'default' || typeof p === 'string')
-                    continue;
-                const bin = presetCli(p.run);
-                const required = preset === ws.config.agents.default;
-                try {
-                    const { stdout } = await execFileP(bin, ['--version'], { timeout: 8000 });
-                    push({ name: `agents.${preset}`, ok: true, required, detail: `${bin} ${stdout.trim().split('\n')[0]}` });
-                }
-                catch {
-                    push({ name: `agents.${preset}`, ok: false, required, detail: `PATH 里没有 ${bin}`, fix: required ? `装 ${bin},或把 agents.default 改成装了的那个预设` : undefined });
-                }
-            }
-        }
-    }
-    // ---- 用户配置 ----
-    try {
-        const text = await readFile(USER_CONFIG, 'utf8');
-        try {
-            const u = JSON.parse(text);
-            push({ name: 'user-config', ok: true, required: false, detail: u.workspace ? `workspace → ${redactHome(expandPath(u.workspace, root))}` : '有,但未设 workspace' });
-        }
-        catch {
-            push({ name: 'user-config', ok: false, required: false, detail: `${redactHome(USER_CONFIG)} 解析失败`, fix: '修复 JSON 或删掉它' });
-        }
-    }
-    catch {
-        push({ name: 'user-config', ok: true, required: false, detail: `未配置(可选):{"workspace": "…"} 写进 ${redactHome(USER_CONFIG)};cotutor init 会代劳` });
-    }
-    const gitThere = (await statOrNull(join(root, '.git'))) !== null;
-    push({ name: 'git', ok: gitThere, required: false, detail: gitThere ? '工作区是 git 仓' : '工作区不在 git 里', fix: gitThere ? undefined : '建议 git init:老师记忆、账本、政策都是不可再生状态' });
-    return { ok: checks.filter((c) => c.required).every((c) => c.ok), root, source, checks };
-}

package/dist/cli/init.js

@@ -1,114 +0,0 @@
-/**
- * cotutor init <slug>:建 ~/cotutor/<slug>/ 骨架。语义是**幂等补缺**——已有的文件与目录一律不动,缺什么补什么。
- * 三条边界(沿 drawtell init):政策文件只在缺失时写模板;用户配置只在还没指定 workspace 时补;不动 git。
- * 老师定义不拷贝,**链**到本包 agents/(共享的是定义,不共享记忆与账本);链已存在(哪怕是实体文件)就不动。
- */
-import { mkdir, readFile, stat, symlink, writeFile } from 'node:fs/promises';
-import { basename, dirname, join, resolve } from 'node:path';
-import { DIRS, GITIGNORE, LEDGER_FILES, RULES, configTemplate, shippedAgents } from "./skeleton.js";
-import { CONFIG_FILE, HOME_ROOT, USER_CONFIG, expandPath } from "./workspace.js";
-async function exists(p) {
-    return (await stat(p).catch(() => null)) !== null;
-}
-async function lexists(p) {
-    const { lstat } = await import('node:fs/promises');
-    return (await lstat(p).catch(() => null)) !== null;
-}
-export async function initWorkspace(opts) {
-    const root = opts.dir ? expandPath(opts.dir, resolve(process.cwd())) : join(HOME_ROOT, opts.slug);
-    const steps = [];
-    const agents = await shippedAgents();
-    const rootExisted = await exists(root);
-    if (!rootExisted)
-        await mkdir(root, { recursive: true });
-    steps.push({ item: '.', action: rootExisted ? 'exists' : 'created' });
-    for (const dir of DIRS) {
-        const p = join(root, dir);
-        if (await exists(p)) {
-            steps.push({ item: `${dir}/`, action: 'exists' });
-            continue;
-        }
-        await mkdir(p, { recursive: true });
-        steps.push({ item: `${dir}/`, action: 'created' });
-    }
-    for (const a of agents) {
-        const home = join(root, 'agents', a.name);
-        if (await exists(home)) {
-            steps.push({ item: `agents/${a.name}/`, action: 'exists' });
-        }
-        else {
-            await mkdir(home, { recursive: true });
-            await writeFile(join(home, '.gitkeep'), '');
-            steps.push({ item: `agents/${a.name}/`, action: 'created' });
-        }
-        for (const sub of ['.claude/agents', '.qwen/agents']) {
-            const link = join(root, sub, basename(a.file));
-            if (await lexists(link)) {
-                steps.push({ item: `${sub}/${basename(a.file)}`, action: 'exists' });
-                continue;
-            }
-            await symlink(a.file, link);
-            steps.push({ item: `${sub}/${basename(a.file)}`, action: 'created', note: `→ ${a.file}` });
-        }
-    }
-    for (const f of LEDGER_FILES) {
-        const p = join(root, f);
-        if (await exists(p))
-            steps.push({ item: f, action: 'exists' });
-        else {
-            await writeFile(p, '');
-            steps.push({ item: f, action: 'created' });
-        }
-    }
-    const config = join(root, CONFIG_FILE);
-    if (await exists(config))
-        steps.push({ item: CONFIG_FILE, action: 'kept', note: '政策文件不覆盖(家长的决定)' });
-    else {
-        await writeFile(config, configTemplate({ slug: opts.slug, name: opts.name, port: opts.port, teachers: agents }));
-        steps.push({ item: CONFIG_FILE, action: 'created' });
-    }
-    for (const f of ['CLAUDE.md', 'QWEN.md']) {
-        const p = join(root, f);
-        if (await exists(p))
-            steps.push({ item: f, action: 'kept', note: '家规已有,不覆盖' });
-        else {
-            await writeFile(p, RULES);
-            steps.push({ item: f, action: 'created' });
-        }
-    }
-    const gitignore = join(root, '.gitignore');
-    if (await exists(gitignore))
-        steps.push({ item: '.gitignore', action: 'kept' });
-    else {
-        await writeFile(gitignore, GITIGNORE);
-        steps.push({ item: '.gitignore', action: 'created' });
-    }
-    // 用户配置:补缺不改向;解析不了也不动(doctor 去体检)
-    let user = null;
-    let userBroken = false;
-    try {
-        user = JSON.parse(await readFile(USER_CONFIG, 'utf8'));
-    }
-    catch (err) {
-        userBroken = err.code !== 'ENOENT';
-    }
-    const configured = user && typeof user.workspace === 'string' && user.workspace ? user.workspace : null;
-    if (userBroken)
-        steps.push({ item: 'user-config', action: 'kept', note: '解析失败,未动(cotutor doctor 可体检)' });
-    else if (configured) {
-        steps.push(expandPath(configured, root) === root
-            ? { item: 'user-config', action: 'exists', note: '已指向本工作区' }
-            : { item: 'user-config', action: 'kept', note: '已指向别的工作区,未改;多孩子时一 workspace 一进程,用 --workspace / COTUTOR_WORKSPACE 指定' });
-    }
-    else {
-        await mkdir(dirname(USER_CONFIG), { recursive: true });
-        await writeFile(USER_CONFIG, `${JSON.stringify({ ...(user ?? {}), workspace: root }, null, 2)}\n`);
-        steps.push({ item: 'user-config', action: 'created', note: 'workspace 指向本工作区' });
-    }
-    const suggestions = [];
-    if (!(await exists(join(root, '.git'))))
-        suggestions.push('git init(建议:老师记忆、账本、政策都是不可再生状态,git 是破坏后的兜底)');
-    suggestions.push(`改 ${CONFIG_FILE}:paths.vault 指到孩子的 Obsidian vault,teachers.*.voice 填 voxtell 音色 id`);
-    suggestions.push('cotutor doctor 逐项体检;cotutor serve 起服务');
-    return { root, steps, suggestions };
-}