cotutor 0.4.2 → 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

@@ -219,6 +219,19 @@ ${BRAND_CSS}
   }
   .upd { position:relative; display:flex; flex-direction:column; gap:6px; margin:0 0 12px; padding:12px 14px; border-radius:14px; background:var(--card); box-shadow:0 0 0 1px var(--line); font-size:15px; }
   .upd.bad { box-shadow:0 0 0 1px var(--accent); }
+  .setup { position:relative; display:flex; flex-direction:column; gap:2px; margin:0 0 12px; padding:12px 14px; border-radius:14px; background:var(--card); box-shadow:0 0 0 1px var(--line); font-size:15px; }
+  .setup > b { padding-right:64px; }
+  .setup .sp { display:flex; gap:10px; padding:8px 0; border-top:1px solid var(--line); }
+  .setup .sp:first-of-type { border-top:0; }
+  .setup .mk { flex:none; width:20px; text-align:center; color:var(--dim); }
+  .setup .sp.on .mk { color:var(--accent); }
+  .setup .sp.on b { font-weight:500; color:var(--dim); }
+  .setup .tx { display:flex; flex-direction:column; gap:4px; min-width:0; flex:1; }
+  .setup small { color:var(--dim); font-size:14px; line-height:1.5; }
+  .setup pre { margin:2px 0 0; padding:10px 12px; border-radius:10px; background:var(--paper); font:13px/1.6 ui-monospace,Menlo,Consolas,monospace; white-space:pre-wrap; overflow-wrap:anywhere; user-select:all; -webkit-user-select:all; }
+  .setup .gr { display:flex; flex-wrap:wrap; gap:6px; margin-top:2px; }
+  .setup .gr button { min-height:44px; padding:0 12px; border:0; border-radius:10px; background:var(--paper); box-shadow:0 0 0 1px var(--line); color:inherit; font-size:15px; cursor:pointer; }
+  .setup .hide { position:absolute; top:6px; right:6px; min-height:44px; padding:0 10px; border:0; background:transparent; color:var(--accent); font-size:15px; cursor:pointer; }
   .upd ul { margin:0; padding-left:18px; font-size:14px; }
   .upd .sub { color:var(--dim); font-size:14px; padding-right:64px; }
   .upd pre { margin:2px 0 0; padding:10px 12px; border-radius:10px; background:var(--paper); font:13px/1.6 ui-monospace,Menlo,Consolas,monospace; white-space:pre-wrap; overflow-wrap:anywhere; user-select:all; -webkit-user-select:all; }
@@ -227,6 +240,7 @@ ${BRAND_CSS}
 <div class="wrap" id="main">
   <div class="top"><span class="ttl"><span id="ct-mark" class="ct-draw ct-hover">${titleLogo(true)}</span><b id="title">家长</b></span><nav class="seg"><a class="on" href="/parent/home">首页</a><a href="/parent">记录</a><a href="/parent/settings">设置</a></nav><small id="pub"></small><a class="devl" href="/dev" target="_blank" title="工作台:细调老师文件、activity(新窗口)">工作台<svg width="11" height="11" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" aria-hidden="true"><path d="M4 2h6v6"/><path d="M10 2 3 9"/></svg></a></div>
   <div id="troublebar"></div>
+  <div id="setupbar"></div>
   <div id="updatebar"></div>
   <div id="qrtop"></div>
   <div class="main">
@@ -351,29 +365,58 @@ ${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 ? ' ' : '') + '还没有平板连进来过,所以这块先开着;连过以后自动收起。'));
   };
 
   // 有新版本(服务每天问一次 npm,machine/update.ts):只在家长端说,孩子端不说;点「知道了」这个版本不再提,读不了 localStorage 就每次都说
   const UPGRADE_STEPS = ${JSON.stringify(upgradeSteps())};
+  // 还差几步(parent-setup.ts):第一次打开家长端,告诉家长接下来做什么。必需的都好了就只剩建议,「知道了」以后不再提
+  const showSetup = async () => {
+    const box = $('#setupbar');
+    const d = await api('GET', '/api/parent/setup').catch(() => null);
+    if (!d) { box.replaceChildren(); return; }
+    let hidden = false;
+    try { hidden = localStorage.getItem('cotutor.setupHidden') === '1'; } catch {}
+    const must = d.steps.filter((s) => s.required);
+    const left = must.filter((s) => !s.done);
+    const extra = d.steps.filter((s) => !s.required && !s.done);
+    if (!left.length && (hidden || !extra.length)) { box.replaceChildren(); return; }
+    const pickGrade = async (g) => {
+      try { await api('POST', '/api/parent/setup/grade', { grade: g }); toast('记下了:' + g + ' 年级'); } catch (e) { toast(e.message); }
+      showSetup();
+    };
+    const row = (s) => h('div', { class: 'sp' + (s.done ? ' on' : '') },
+      h('span', { class: 'mk' }, s.done ? '✓' : '○'),
+      h('span', { class: 'tx' }, h('b', {}, s.title),
+        s.done ? null : h('small', {}, s.detail, s.link ? ' ' : null, s.link ? h('a', { class: 'lnk', href: s.link.href, target: '_blank', rel: 'noopener' }, s.link.text) : null),
+        !s.done && s.commands ? h('pre', {}, s.commands.map((c) => h('div', {}, c))) : null,
+        !s.done && s.grades ? h('span', { class: 'gr' }, [1, 2, 3, 4, 5, 6].map((g) => h('button', { type: 'button', on: { click: () => pickGrade(g) } }, g + ' 年级'))) : null));
+    box.replaceChildren(h('div', { class: 'setup' },
+      h('b', {}, left.length ? '还差 ' + left.length + ' 步,孩子就能用了' : '都好了,还有几件可以做的'),
+      ...(left.length ? must.concat(extra) : extra).map(row),
+      left.length ? null : h('button', { type: 'button', class: 'hide', on: { click: () => { try { localStorage.setItem('cotutor.setupHidden', '1'); } catch {} box.replaceChildren(); } } }, '知道了')));
+  };
   // 跑起来以后百炼出的问题(欠费、key 失效、连不上,machine/bailian.ts):配好了不等于用得了。试连通了就没了
   const showTrouble = (hh) => {
     const box = $('#troublebar');
@@ -406,6 +449,7 @@ ${pageDomJs(3200)}
   };
   const load = async () => {
     showUpdate();
+    showSetup();
     try { D = await api('GET', '/api/parent/home'); } catch (e) { toast('读不到:' + e.message); return; }
     BL.st = await api('GET', '/api/parent/bailian').catch(() => null);
     QR.d = await api('GET', '/api/parent/qr').catch(() => null);

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

@@ -1,5 +1,5 @@
 /**
- * 家长端「设置」(/parent/settings):设一次就不常动的。现在只有一项——孩子的平板上,按住说话那一栏放哪边(cotutor.json 的 kid.hand)。
+ * 家长端「设置」(/parent/settings):设一次就不常动的。备份和诊断信息也放这(parent-setup.ts)。孩子的平板上,按住说话那一栏放哪边(cotutor.json 的 kid.hand)。
  * 两张示意图(不是截图,页面现画的 SVG):横着的平板,窄的一栏是老师头像 + 按住说话,宽的一边是写字的白纸;点一张就存。
  * 孩子端首页的接口带着它(/api/kid/home 的 hand),孩子下次进老师页就换过来;画板那一列工具跟着一起挪。
  * 零依赖内联脚本,只走 /api/parent/settings(GET 读,PATCH {kid: {hand}} 改)。
@@ -32,6 +32,10 @@ ${BRAND_CSS}
   .seg > * { flex:1; height:36px; border-radius:9px; font-size:15px; color:var(--dim); display:flex; align-items:center; justify-content:center; text-decoration:none; }
   .seg > .on { background:#fff; color:var(--ink); font-weight:600; box-shadow:0 1px 2px rgba(0,0,0,.08); }
   .gh { font-size:13px; color:var(--mute); padding:8px 16px 6px; }
+  .acts { display:flex; flex-wrap:wrap; gap:8px; padding:0 3px 12px; }
+  .act { display:inline-flex; align-items:center; min-height:44px; padding:0 14px; border:0; border-radius:10px; background:var(--paper, transparent); box-shadow:0 0 0 1px var(--line); color:inherit; font-size:15px; text-decoration:none; cursor:pointer; }
+  .act[disabled] { opacity:.5; }
+  #rep-text { margin:0 3px 12px; padding:10px 12px; max-height:320px; overflow:auto; border-radius:10px; box-shadow:0 0 0 1px var(--line); font:12px/1.55 ui-monospace,Menlo,Consolas,monospace; white-space:pre-wrap; overflow-wrap:anywhere; }
   .grp { background:var(--card); border-radius:14px; padding:14px; display:flex; flex-direction:column; gap:12px; }
   .q { font-size:16px; font-weight:500; padding:0 2px; }
   .hands { display:grid; grid-template-columns:1fr 1fr; gap:12px; }
@@ -63,6 +67,22 @@ ${BRAND_CSS}
       <div class="note">平板横着用的时候,老师页上那一栏(老师的头像、按住说话)放在这边,另一边留给写字;画板上那一列工具也跟着放这边。孩子下次进老师页就换过来。</div>
     </div>
   </div>
+  <div>
+    <div class="gh">备份</div>
+    <div class="grp">
+      <div class="note" id="bk-note">读取中……</div>
+      <div class="acts"><button type="button" class="act" id="bk-go">现在备份一份</button></div>
+    </div>
+  </div>
+  <div>
+    <div class="gh">遇到问题</div>
+    <div class="grp">
+      <div class="note">生成一份诊断信息,发给开发者或帮你的 AI 助手,不用来回问。里面没有孩子的对话、照片、录音、档案和 key,名字和 IP 已经抹掉。不会自动发出去,你可以先看一遍。</div>
+      <div class="acts"><button type="button" class="act" id="rep-go">生成诊断信息</button></div>
+      <pre id="rep-text" hidden></pre>
+      <div class="acts" id="rep-acts" hidden><button type="button" class="act" id="rep-copy">复制</button><a class="act" href="https://github.com/TarsLab/cotutor/issues/new?template=bug.yml" target="_blank" rel="noopener">到 GitHub 反馈</a></div>
+    </div>
+  </div>
   ${BRAND_FOOTER}
 </div>
 <div id="toast"></div>
@@ -125,8 +145,52 @@ ${pageDomJs(3200)}
     if (S) { document.title = S.title + ' · 家长 · 设置'; $('#title').textContent = S.title; }
     draw();
   };
+  // 备份:只读和「现在备一份」;恢复要停服务,在终端里做,这里说怎么做
+  const bkLoad = async () => {
+    const d = await api('GET', '/api/parent/backups').catch(() => null);
+    const note = $('#bk-note');
+    if (!d) { note.textContent = '读不到备份的情况'; return; }
+    const last = d.list[0];
+    const mb = (n) => (n / 1024 / 1024).toFixed(1) + ' MB';
+    note.textContent = (last ? '最近一份 ' + new Date(last.at).toLocaleString() + ',' + last.files + ' 个文件,' + mb(last.bytes) + ';一共留着 ' + d.list.length + ' 份。' : '还没有备份。') + '放在 ' + d.dir + '。服务开着时每天自动备一份,升级前也备一份;录音占地方,不在备份里。要恢复:在这台电脑的终端里跑 ' + d.commands.list + ' 看有哪些,再 ' + d.commands.restore + '。';
+  };
+  $('#bk-go').addEventListener('click', async () => {
+    const b = $('#bk-go');
+    b.disabled = true;
+    try { await api('POST', '/api/parent/backups', {}); toast('备份好了'); } catch (e) { toast('没备份成:' + e.message); }
+    b.disabled = false;
+    bkLoad();
+  });
+  // 诊断信息:先给人看,复制是人点的;不自动发
+  $('#rep-go').addEventListener('click', async () => {
+    const b = $('#rep-go');
+    b.disabled = true;
+    try {
+      const r = await api('GET', '/api/parent/report');
+      $('#rep-text').textContent = r.text;
+      $('#rep-text').hidden = false;
+      $('#rep-acts').hidden = false;
+    } catch (e) { toast('没生成成:' + e.message); }
+    b.disabled = false;
+  });
+  $('#rep-copy').addEventListener('click', async () => {
+    const text = $('#rep-text').textContent;
+    try {
+      await navigator.clipboard.writeText(text);
+      toast('复制好了');
+    } catch {
+      // 不是 https 的地址没有剪贴板接口:选中,让人自己复制
+      const range = document.createRange();
+      range.selectNodeContents($('#rep-text'));
+      const sel = getSelection();
+      sel.removeAllRanges();
+      sel.addRange(range);
+      toast('已选中,按复制');
+    }
+  });
   draw();
   load();
+  bkLoad();
 })();
 </script>
 </body></html>

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) }
+}