cotutor 0.4.2 → 0.4.4

package/install.sh

@@ -0,0 +1,84 @@
+#!/bin/sh
+# cotutor 一行安装(macOS、Linux):
+#   curl -fsSL https://raw.githubusercontent.com/TarsLab/cotutor/main/install.sh | sh
+# 连不上 GitHub 就换这个:
+#   curl -fsSL https://cdn.jsdelivr.net/npm/cotutor@latest/install.sh | sh
+# 顺手建好孩子的文件夹、装好后台服务(短名 称呼 年级):
+#   curl -fsSL https://raw.githubusercontent.com/TarsLab/cotutor/main/install.sh | sh -s -- ming 小明 2
+#
+# 只做这几件事:查 Node 的版本;npm 连不上就用国内镜像;全局目录写不了就换到自己家目录下(不用 sudo);装 cotutor。
+# 不用 sudo,不改系统设置。Node 没装或太旧时只说怎么装,不替你装。
+set -eu
+
+say() { printf '%s\n' "$*"; }
+die() { say "$*"; exit 1; }
+
+NEED_MAJOR=22
+NEED_MINOR=18
+
+# ---- 1. Node ----
+command -v node >/dev/null 2>&1 || die "这台电脑还没有 Node.js:到 https://nodejs.org 下载 LTS 版装上,重开终端再跑这一行。"
+v=$(node -p 'process.versions.node')
+major=${v%%.*}
+rest=${v#*.}
+minor=${rest%%.*}
+if [ "$major" -lt "$NEED_MAJOR" ] || { [ "$major" -eq "$NEED_MAJOR" ] && [ "$minor" -lt "$NEED_MINOR" ]; }; then
+  die "Node.js 是 $v,cotutor 要 $NEED_MAJOR.$NEED_MINOR 以上:到 https://nodejs.org 装新的 LTS 版,重开终端再跑这一行。"
+fi
+command -v npm >/dev/null 2>&1 || die "有 Node.js 但找不到 npm:到 https://nodejs.org 重新装一次 LTS 版。"
+say "Node.js $v"
+
+# ---- 2. npm 连得上吗(国内常连不上,换镜像) ----
+REGISTRY=""
+if ! curl -fsS -o /dev/null --max-time 8 https://registry.npmjs.org/cotutor/latest 2>/dev/null; then
+  REGISTRY="https://registry.npmmirror.com"
+  say "npm 连不上或太慢,用国内镜像 $REGISTRY"
+fi
+
+# ---- 3. 全局目录写得了吗(官网的 Mac 安装包装在 /usr/local,要 sudo 才能写;不用 sudo,换到家目录下) ----
+root=$(npm root -g)
+target=$root
+[ -d "$target" ] || target=$(dirname "$target")
+if [ ! -w "$target" ]; then
+  prefix="$HOME/.npm-global"
+  say "npm 的全局目录 $root 这个账户写不了,改装到 $prefix(不用 sudo)"
+  mkdir -p "$prefix"
+  npm config set prefix "$prefix"
+  case "${SHELL:-}" in
+    */zsh) rc="$HOME/.zshrc" ;;
+    */bash) if [ "$(uname)" = Darwin ]; then rc="$HOME/.bash_profile"; else rc="$HOME/.bashrc"; fi ;;
+    *) rc="$HOME/.profile" ;;
+  esac
+  line='export PATH="$HOME/.npm-global/bin:$PATH"'
+  if ! grep -qsF "$line" "$rc"; then
+    printf '\n# cotutor 安装脚本加的:npm 全局命令装在家目录下\n%s\n' "$line" >> "$rc"
+    say "在 $rc 里加了一行 PATH,新开的终端就认得 cotutor"
+  fi
+  PATH="$prefix/bin:$PATH"
+  export PATH
+fi
+
+# ---- 4. 装 ----
+say "正在下载 cotutor,要一会儿……"
+if [ -n "$REGISTRY" ]; then npm i -g cotutor --no-audit --no-fund --registry="$REGISTRY"; else npm i -g cotutor --no-audit --no-fund; fi
+command -v cotutor >/dev/null 2>&1 || die "装好了但找不到 cotutor 命令:重开终端再试;还不行,把 $(npm prefix -g)/bin 加进 PATH。"
+say "cotutor $(cotutor --version) 装好了"
+
+# ---- 5. 带了孩子的信息就接着建文件夹、装后台服务 ----
+if [ $# -ge 1 ]; then
+  slug=$1
+  set -- "$@" "" ""
+  name=$2
+  grade=$3
+  if [ -n "$name" ] && [ -n "$grade" ]; then cotutor init "$slug" --name "$name" --grade "$grade"
+  elif [ -n "$name" ]; then cotutor init "$slug" --name "$name"
+  else cotutor init "$slug"; fi
+  cotutor service install
+  say ""
+  say "好了。家长端已经在浏览器里打开;以后点菜单栏的 cotutor 图标,或在终端跑 cotutor open。"
+else
+  say ""
+  say "接下来(短名用小写字母,不用真名;年级 1 到 6):"
+  say "  cotutor init ming --name 小明 --grade 2"
+  say "  cotutor service install"
+fi

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "cotutor",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "releaseNotes": [
-    "百炼欠费、key 失效或连不上时,图标和家长端会说清楚,孩子那边会请爸爸妈妈来看,不再一直转",
-    "升级只要一条命令 cotutor update,几个孩子一次升好,孩子在通话时不动",
-    "用 Homebrew 装 Node 的电脑:Node 升级后服务和图标不会再起不来",
-    "有新版本时能直接看到这次改了什么"
+    "装得快多了:安装从 275 个包变成 15 个,Windows 上第一次装从 3 分钟左右变成 1 分钟左右",
+    "平板第一次用:在家长端「扫码打开」点「装证书」,用平板相机扫一下就能装根证书",
+    "电脑关了或睡着时,孩子在平板上打开看到「老师们还没到」,不再是浏览器的报错;电脑好了自己回来",
+    "有了一行安装命令(Mac、Windows 都有),README 里也写了怎么卸载"
   ],
   "description": "AI tutors that co-teach with parents at home: real-time voice, an interactive whiteboard, and learning memory in your own Obsidian vault. Self-hosted; built for China's elementary curriculum.",
   "type": "module",
@@ -59,7 +59,10 @@
     "skills",
     "README.md",
     "LICENSE",
-    "NOTICE"
+    "NOTICE",
+    "install.sh",
+    "install.ps1",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "gen:skills": "node --experimental-strip-types scripts/gen-skills.ts",
@@ -75,18 +78,18 @@
   },
   "dependencies": {
     "@ai-sdk/alibaba": "2.0.78",
-    "@excalidraw/excalidraw": "0.18.1",
     "ai": "7.0.155",
     "hanzi-writer-data": "2.0.1",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
     "typescript": "^5.6.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {
+    "@excalidraw/excalidraw": "0.18.1",
     "@types/node": "^22.20.1",
     "@types/react": "^18.3.31",
     "@types/react-dom": "^18.3.7",
-    "esbuild": "^0.28.2"
+    "esbuild": "^0.28.2",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
   }
 }

package/skills/cotutor-analyze/references//345/221/275/344/273/244/344/270/216/346/226/207/344/273/266.md

@@ -3,7 +3,7 @@
 ## 分析用的命令(在 workspace 根跑;完整用法 cotutor --help)
 
 ```
-  cotutor doctor [--workspace <dir>] [--json] [--live]                 逐项体检;--live 真连一次百炼实时模型、真合成一句配音(花一分钱)把 API 层的坑摆出来(真跑老师用 cotutor send);--json 里不过的项带 cmd(能直接跑)或 human(要人来)
+  cotutor doctor [--workspace <dir>] [--json] [--live] [--fix]                 逐项体检;--live 真连一次百炼实时模型、真合成一句配音(花一分钱)把 API 层的坑摆出来(真跑老师用 cotutor send);--json 里不过的项带 cmd(能直接跑)或 human(要人来);--fix 把带 cmd 的一条条修掉,要人来的留着
   cotutor send <老师> [<消息>] [--from kid|system] [--runtime <名>] [--new] [--photo a.jpg,b.png] [--activity <名> [--param '名=值;名=值']] [--lane main,tts] [--quiet]   终端里发一条,现场按道打印每道工序的事件,说完打印结果(孩子的话照实时写,同孩子端:上下文包带 live:、不补提问卡,只是没有嘴;--from system 不算;--new 开新话题;--photo 带作业照片,拷进 captures/,有照片时消息可以空;--activity 像孩子点了首页的 activity 按钮,新开话题,参数同按钮下面那几行;--quiet 只要结果)
   cotutor pack <老师> [<消息>] [--from kid|system] [--at <ISO时间>] [--activity <名> [--param '名=值;名=值']] [--json]   干跑上下文包(--activity 看 activity 话题第一条老师拿到什么):不起模型,打印现在会发给老师的那份 + 每段来自哪个文件、那里一共几条、按政策带了几条(改了档案 / 日记 / 计划立刻看效果)
   cotutor replay <老师> <job> [<日期>] [--runtime <名>] [--json]   回放一轮:同一问按现在的 vault 与提示词再跑一遍(落 evals/,不进孩子的对话、不配音),跑完并排打印上下文包 / 讲稿 / 卡 / 读了什么的 diff

package/skills/cotutor-tune/references//345/255/227/346/256/265.md

@@ -41,7 +41,7 @@ frontmatter 只写应用支持的这几个键:`name`、`description`、`maxTurns
 ## 相关命令(完整用法 cotutor --help)
 
 ```
-  cotutor doctor [--workspace <dir>] [--json] [--live]                 逐项体检;--live 真连一次百炼实时模型、真合成一句配音(花一分钱)把 API 层的坑摆出来(真跑老师用 cotutor send);--json 里不过的项带 cmd(能直接跑)或 human(要人来)
+  cotutor doctor [--workspace <dir>] [--json] [--live] [--fix]                 逐项体检;--live 真连一次百炼实时模型、真合成一句配音(花一分钱)把 API 层的坑摆出来(真跑老师用 cotutor send);--json 里不过的项带 cmd(能直接跑)或 human(要人来);--fix 把带 cmd 的一条条修掉,要人来的留着
   cotutor upgrade [--workspace <dir>] [--force <老师>]...                老师文件、activity 与 skill 换新版:没改过的直接换,改过的只报 diff(--force <老师> 或 --force <老师>/<名> 才覆盖,原文留 .bak)
   cotutor upgrade --config [--dry-run] [--workspace <dir>]              cotutor.json 补缺:新出厂老师 / 运行时 / 命令模板旗标(只加缺的,你改过的值不动)
   cotutor add <老师名> --display <显示名> [--subject <学科>] [--avatar <emoji|图片相对路径>] [--hidden]   加一位自家的老师:出模板文件、进 cotutor.json、建目录(名字以 -tutor 结尾的是老师,figshot 给它做头像)