cotutor 0.4.3 → 0.4.4

package/dist/ui/kid/kid-page.js

@@ -3674,6 +3674,8 @@ __REEL_DOCK_JS__
     location.reload();
   };
   setInterval(() => { staleReload(); if (S.tutor) { if (!S.pending) loadDay(true); } else loadHome(); }, 5000);
+  // 离线页(offline-sw.ts):电脑关了、睡着了时,点开主屏幕图标看到「老师们还没到」,不是浏览器的报错。只在 https(或 localhost)上有;回放、预览里不装
+  if (!REEL && !PREVIEW && window.isSecureContext && 'serviceWorker' in navigator) navigator.serviceWorker.register('/sw.js').catch(() => {});
   document.addEventListener('visibilitychange', () => { if (!document.hidden) (S.tutor ? loadDay(true) : loadHome()); });
   // 孩子端刷新(手动的、Safari 自己重载的)回到手上这位老师;在首页刷新就回首页。只读回放不记(重载回来是今天的)
   if (!REEL && !PREVIEW) window.addEventListener('pagehide', () => { try { if (S.tutor && !S.readonly) sessionStorage.setItem('kid-resume', S.tutor.name); else sessionStorage.removeItem('kid-resume'); } catch {} });

package/dist/ui/kid/offline-sw.d.ts

@@ -0,0 +1 @@
+export declare const KID_SW_JS: string;

package/dist/ui/kid/offline-sw.js

@@ -0,0 +1,42 @@
+/**
+ * 孩子端的离线页(Service Worker,GET /sw.js):电脑关了、睡着了、服务没在跑时,平板上打开孩子端看到的不是浏览器的报错,是「老师们休息中」。
+ * 和页面开着时断线的样子(kid-page 的 #rest)同一句:都是「电脑那边连不上」;「老师们还没到」是百炼没配好,另一回事。
+ * 孩子端永远没有错误:这一页只说老师们休息、叫爸爸妈妈,不说连接、不说服务器。
+ * 页面开着时断线由页面自己管(灰掉、「老师们休息中」);这一页只在重新打开(iPad 把网页 App 清出内存后再点开、刷新)时出现。
+ *
+ * 只接管孩子端那几页的打开(导航);接口、静态文件、别的页面一律不碰。不缓存任何东西:平时原样走网络,孩子看不到旧页面;
+ * 连不上或 12 秒没回应才给离线页,它每 5 秒问一次 /api/health,通了就自己刷新回去。
+ * Service Worker 只在安全上下文里有(https 且平板信任了根证书,或 localhost);http 时孩子端照旧,什么都不变。
+ * 改了这个文件就改 VERSION:平板上的旧 worker 靠脚本内容变了才换。
+ */
+const VERSION = '2';
+/** 离线页本身:没有网可取,样式、脚本都内联 */
+const OFFLINE_HTML = [
+    '<!doctype html><html lang="zh-CN"><head><meta charset="utf-8">',
+    '<meta name="viewport" content="width=device-width,initial-scale=1,viewport-fit=cover">',
+    '<meta name="apple-mobile-web-app-capable" content="yes"><title>老师们休息中</title>',
+    '<style>html,body{height:100%;margin:0}body{display:flex;align-items:center;justify-content:center;background:#f7f3ea;color:#3a352c;',
+    'font:22px/1.6 -apple-system,"PingFang SC","Microsoft YaHei",sans-serif;text-align:center;-webkit-user-select:none;user-select:none}',
+    'p{margin:0 24px}small{display:block;margin-top:12px;font-size:17px;color:#8a8273}</style></head>',
+    '<body><p id="off">老师们休息中<small>叫爸爸妈妈来看一下:家里那台电脑是不是关了、睡着了</small></p>',
+    '<script>setInterval(function(){fetch("/api/health",{cache:"no-store"}).then(function(r){if(r.ok)location.reload()}).catch(function(){})},5000)</script>',
+    '</body></html>',
+].join('');
+export const KID_SW_JS = `// cotutor 孩子端的离线页 v${VERSION}(src/ui/kid/offline-sw.ts)
+const KID = new Set(['/', '/dictation', '/dictation/', '/talk', '/talk/']);
+const WAIT_MS = 12000;
+const OFFLINE = ${JSON.stringify(OFFLINE_HTML)};
+self.addEventListener('install', () => { self.skipWaiting(); });
+self.addEventListener('activate', (e) => { e.waitUntil(self.clients.claim()); });
+self.addEventListener('fetch', (e) => {
+  const r = e.request;
+  if (r.mode !== 'navigate' || r.method !== 'GET') return;
+  const u = new URL(r.url);
+  if (u.origin !== self.location.origin || !KID.has(u.pathname)) return;
+  const offline = () => new Response(OFFLINE, { status: 200, headers: { 'content-type': 'text/html; charset=utf-8', 'cache-control': 'no-store' } });
+  e.respondWith(Promise.race([
+    fetch(r).catch(() => null),
+    new Promise((resolve) => { setTimeout(() => resolve(null), WAIT_MS); }),
+  ]).then((res) => res || offline()));
+});
+`;

package/dist/ui/parent/parent-home-page.js

@@ -365,24 +365,27 @@ ${pageDomJs(3200)}
         h('span', { style: 'flex:none;display:flex', html: QR_ICON }), h('span', { class: 'tx' }, h('b', {}, '扫码打开'), h('small', {}, seen)), h('span', { class: 'lnk', style: 'font-size:14px' }, '展开'))));
       return;
     }
-    const kid = QR.to === 'kid', c = kid ? d : (d.parent || d);
+    if (QR.to === 'ca' && !d.ca) QR.to = 'kid';
+    const kid = QR.to === 'kid', ca = QR.to === 'ca', c = kid ? d : ca ? d.ca : (d.parent || d);
     const useIp = QR.ip && c.ip;
-    const seg = h('div', { class: 'seg', role: 'group', 'aria-label': '给谁扫' }, ...[['kid', '孩子的平板'], ['parent', '我的手机']].map(([k, l]) =>
+    // 装证书(serve.ts 的 http 那一面给根证书):平板第一次用之前扫一次;有证书、找得到根证书才有这一格
+    const tabs = [['kid', '孩子的平板'], ['parent', '我的手机']].concat(d.ca ? [['ca', '装证书']] : []);
+    const seg = h('div', { class: 'seg', role: 'group', 'aria-label': '给谁扫' }, ...tabs.map(([k, l]) =>
       h('button', { type: 'button', class: QR.to === k ? 'on' : '', 'aria-pressed': QR.to === k ? 'true' : 'false', on: { click: () => { QR.to = k; qrDraw(); } } }, l)));
     const print = '/parent/qr?' + new URLSearchParams(Object.assign({}, useIp ? { via: 'ip' } : {}, kid ? {} : { to: 'parent' })).toString();
     qrEl.replaceChildren(
       h('div', { class: 'gh' }, h('span', {}, '扫码打开'), h('button', { type: 'button', class: 'x', 'aria-expanded': 'true', on: { click: () => qrToggle(false) } }, '收起')),
       h('div', { class: 'grp' }, h('div', { class: 'box' }, seg,
         h('div', { class: 'qrrow' }, h('div', { class: 'qrimg', html: (useIp ? c.svgIp : c.svg) || '' }),
-          h('b', { style: 'font-weight:600' }, kid ? '用孩子平板的相机扫一下' : '用你自己的手机扫一下'),
-          h('span', { class: 'lbl', style: 'line-height:1.5' }, kid ? '打开的就是孩子的首页。在 Safari 里「添加到主屏幕」,以后点图标就进来。' : '打开的是家长端:看记录、排首页。也可以添加到主屏幕。')),
+          h('b', { style: 'font-weight:600' }, kid ? '用孩子平板的相机扫一下' : ca ? '平板第一次用:先扫这张装证书' : '用你自己的手机扫一下'),
+          h('span', { class: 'lbl', style: 'line-height:1.5' }, kid ? '打开的就是孩子的首页。在 Safari 里「添加到主屏幕」,以后点图标就进来。' : ca ? '扫了点「允许」下载描述文件;到「设置」最上面点「已下载描述文件」装上;再到「设置 › 通用 › 关于本机 › 证书信任设置」把开关打开。装好再扫「孩子的平板」那张。每台平板做一次。' : '打开的是家长端:看记录、排首页。也可以添加到主屏幕。')),
         h('div', { class: 'qrurl' }, useIp ? c.ip : c.url),
         d.https ? null : h('div', { class: 'qrwarn' }, d.notes[0] || ''),
         h('div', { class: 'row2', style: 'font-size:14px' },
           c.ip ? h('button', { type: 'button', class: 'x', style: 'height:auto;padding:0;font-size:14px;text-align:left', on: { click: () => { QR.ip = !QR.ip; qrDraw(); } } }, useIp ? '换回 ' + host(c.url) : '扫了打不开?换成 ' + host(c.ip)) : h('span'),
           h('span', { style: 'display:flex;gap:14px;flex:none' },
             h('a', { class: 'lnk kidl', style: 'font-size:14px', href: '/', target: '_blank' }, '孩子端 ↗'),
-            h('a', { class: 'lnk', style: 'font-size:14px', href: print, target: '_blank' }, '打印 ›'))))),
+            ca ? null : h('a', { class: 'lnk', style: 'font-size:14px', href: print, target: '_blank' }, '打印 ›'))))),
       h('div', { class: 'note' }, d.https ? (d.notes[0] || '') : '', d.devices ? '' : (d.https ? ' ' : '') + '还没有平板连进来过,所以这块先开着;连过以后自动收起。'));
   };
 

package/install.ps1

@@ -0,0 +1,66 @@
+# cotutor 一行安装(Windows,在 PowerShell 里粘贴):
+#   irm https://raw.githubusercontent.com/TarsLab/cotutor/main/install.ps1 | iex
+# 连不上 GitHub 就换这个:
+#   irm https://cdn.jsdelivr.net/npm/cotutor@latest/install.ps1 | iex
+# 顺手建好孩子的文件夹、装好后台服务(短名 称呼 年级):
+#   & ([scriptblock]::Create((irm https://raw.githubusercontent.com/TarsLab/cotutor/main/install.ps1))) ming 小明 2
+#
+# 只做这几件事:查 Node 的版本;npm 连不上就用国内镜像;装 cotutor。
+# 不要管理员,不改执行策略:npm、cotutor 都用 .cmd 跑(PowerShell 缺省策略会拦 .ps1)。Node 没装或太旧时只说怎么装,不替你装。
+$ErrorActionPreference = 'Stop'
+
+function Say($text) { Write-Host $text }
+function Stop-Here($text) { Write-Host $text; throw 'cotutor-install-stopped' }
+
+$needMajor = 22
+$needMinor = 18
+
+try {
+  # ---- 1. Node ----
+  if (-not (Get-Command node -ErrorAction SilentlyContinue)) {
+    Stop-Here "这台电脑还没有 Node.js:到 https://nodejs.org 下载 LTS 版(Windows 安装程序)装上,或者跑 winget install OpenJS.NodeJS.LTS;装完重开 PowerShell 再跑这一行。"
+  }
+  $v = (& node -p 'process.versions.node').Trim()
+  $parts = $v.Split('.')
+  if ([int]$parts[0] -lt $needMajor -or ([int]$parts[0] -eq $needMajor -and [int]$parts[1] -lt $needMinor)) {
+    Stop-Here "Node.js 是 $v,cotutor 要 $needMajor.$needMinor 以上:到 https://nodejs.org 装新的 LTS 版,重开 PowerShell 再跑这一行。"
+  }
+  if (-not (Get-Command npm.cmd -ErrorAction SilentlyContinue)) { Stop-Here '有 Node.js 但找不到 npm:到 https://nodejs.org 重新装一次 LTS 版。' }
+  Say "Node.js $v"
+
+  # ---- 2. npm 连得上吗(国内常连不上,换镜像) ----
+  $registry = $null
+  try { Invoke-WebRequest -UseBasicParsing -TimeoutSec 8 'https://registry.npmjs.org/cotutor/latest' | Out-Null }
+  catch { $registry = 'https://registry.npmmirror.com'; Say "npm 连不上或太慢,用国内镜像 $registry" }
+
+  # ---- 3. 装 ----
+  Say '正在下载 cotutor,要一会儿……'
+  $npmArgs = @('i', '-g', 'cotutor', '--no-audit', '--no-fund')
+  if ($registry) { $npmArgs += "--registry=$registry" }
+  & npm.cmd @npmArgs
+  if ($LASTEXITCODE -ne 0) { Stop-Here 'npm 没装成:看上面的报错;连不上就过一会儿再试。' }
+  # 刚装上的 cotutor.cmd 在 npm 的全局目录里;这个窗口的 PATH 可能还没有它
+  $globalDir = (& npm.cmd prefix -g).Trim()
+  if (-not (Get-Command cotutor.cmd -ErrorAction SilentlyContinue)) { $env:Path = "$globalDir;$env:Path" }
+  if (-not (Get-Command cotutor.cmd -ErrorAction SilentlyContinue)) { Stop-Here "装好了但找不到 cotutor:重开 PowerShell 再试;还不行,把 $globalDir 加进 PATH。" }
+  Say ('cotutor ' + (& cotutor.cmd --version).Trim() + ' 装好了')
+
+  # ---- 4. 带了孩子的信息就接着建文件夹、装后台服务 ----
+  if ($args.Count -ge 1) {
+    $initArgs = @('init', $args[0])
+    if ($args.Count -ge 2 -and $args[1]) { $initArgs += @('--name', $args[1]) }
+    if ($args.Count -ge 3 -and $args[2]) { $initArgs += @('--grade', [string]$args[2]) }
+    & cotutor.cmd @initArgs
+    if ($LASTEXITCODE -ne 0) { Stop-Here '建孩子的文件夹没成:看上面的报错。' }
+    & cotutor.cmd service install
+    Say ''
+    Say '好了。家长端已经在浏览器里打开;以后点任务栏右下角 ^ 里的 cotutor 图标,或者跑 cotutor.cmd open。'
+  } else {
+    Say ''
+    Say '接下来(短名用小写字母,不用真名;年级 1 到 6):'
+    Say '  cotutor.cmd init ming --name 小明 --grade 2'
+    Say '  cotutor.cmd service install'
+  }
+} catch {
+  if ($_.Exception.Message -ne 'cotutor-install-stopped') { Write-Host ('出错了:' + $_.Exception.Message) }
+}

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