glasspane-install 1.16.4 → 1.19.0

package/cli.js

@@ -4,7 +4,7 @@
  *
  * 流程：terminal onboarding 横幅 → 环境预检（node/swift/git/open）→ 定位项目
  * 根目录 → npm 依赖（有 package-lock.json 走 npm ci，见 npmDepsCommand）→ 编译 TS
- * （kernel → mcp-shell）→ swift
+ * （mcp-shell；内核是已发布的 `iterate-kernel` 依赖，捆进它的 bundle，不再是仓内 workspace）→ swift
  * build -c release（engine）→ make-app.sh 打包**并签名**两个 .app → 安置到
  * ~/Applications → 以 bundle 内可执行注册 launchd 自启并启动 daemon → 打开
  * GlassPane.app 设置面板进入权限引导（授权对象是 daemon，见 P1 v1.2 §11）→
@@ -70,7 +70,7 @@ export const INSTALL_SH_URL =
 /** 发布线锚点（版本真源 = 根 package.json，由 scripts/set-version.mjs 统一改写，
  *  勿手改）：npx 形态下本地没有仓库时，引导 clone 的就是这个 tag，与 install.sh
  *  的 `GLASSPANE_RELEASE` 同值——两条一键入口必须拿到同一份源码。 */
-export const RELEASE_VERSION = '1.16.4'
+export const RELEASE_VERSION = '1.19.0'
 /** 发布 ref（tag 名）。GLASSPANE_REF 环境变量可覆盖（追主干用 `main`）。 */
 export const REPO_REF = `v${RELEASE_VERSION}`
 
@@ -324,22 +324,24 @@ export function checkEnvironment({ nodePath = process.execPath } = {}) {
 /** 汇总预检结果：缺项按严重程度排序返回可读描述（空数组 = 全部通过）。 */
 export function preflightIssues(env) {
   const issues = []
+  // 每一行都要带上"下一步能跑的动作"：`未找到 npm` 单独一句是把诊断交给读者，而预检失败
+  // 时汇总只补一句通用的"修复后重新运行即可"——四行里只有 swift 那条说得出该装什么。
   if (env.nodeMajor === 0) {
-    issues.push(`无法解析 Node.js 版本（${env.nodeMajor === 0 ? '执行失败' : ''}）`)
+    issues.push('无法解析 Node.js 版本（`node --version` 跑不起来）：装一个 >= 18 的 Node（brew install node，或 nvm install --lts 后 nvm use）再重跑')
   } else if (!env.nodeOk) {
-    issues.push(`Node.js 需要 >= ${MIN_NODE_MAJOR}，当前为 ${env.nodeMajor}`)
+    issues.push(`Node.js 需要 >= ${MIN_NODE_MAJOR}，当前为 ${env.nodeMajor}：换够格的 Node 版本再重跑（brew upgrade node 或 nvm use 22）`)
   }
   if (!env.npm) {
-    issues.push('未找到 npm')
+    issues.push('未找到 npm（它随 Node 一起装：brew install node）')
   }
   if (!env.swift) {
     issues.push('未找到 swift（需安装 Xcode Command Line Tools：xcode-select --install）')
   }
   if (!env.git) {
-    issues.push('未找到 git')
+    issues.push('未找到 git（xcode-select --install 会带上它，或 brew install git）')
   }
   if (!env.open) {
-    issues.push('未找到 open（本安装器面向 macOS）')
+    issues.push('未找到 open（本安装器面向 macOS：Linux/Windows 上没有可装的东西，请在 macOS 14+ 上重跑）')
   }
   return issues
 }
@@ -481,7 +483,7 @@ export function classifyKillResult({ status, stderr = '', error = null } = {}) {
 }
 
 /** 这个 pid 是不是**僵尸**（已死、等父进程回收）：`kill -0` 对僵尸回 0，光靠信号探测会把
- *  一个已经不服务 socket 的进程报成"还活着、请你 sudo kill"。状态读不出来时保守回 false
+ *  一个已经不服务 socket 的进程报成"还活着、请你去收尾"。状态读不出来时保守回 false
  *  （宁可多报一个幸存者，也不放走真的还在跑的进程）。 */
 export function isZombiePid(pid, { spawn = spawnSync } = {}) {
   try {
@@ -534,13 +536,13 @@ export function terminatePids(pids, { spawn = spawnSync, sleepMs = 1000, reprobe
     let after = state(pid)
     if (after !== 'gone') {
       // 刚被 SIGKILL 的进程要等它的父进程回收（父进程正 `wait` 着的话是毫秒级）；
-      // 立刻探一次会把它读成"还活着"，于是红字让人去 sudo kill 一个已经没了的 pid。
+      // 立刻探一次会把它读成"还活着"，于是红字让人去收尾一个已经没了的 pid。
       // 给一次**有界**的再探窗口，只有窗口过后还在的才算幸存者。
       if (sleep) sleep(reprobeMs)
       else spawn('sleep', [String(reprobeMs / 1000)], { encoding: 'utf8' })
       after = state(pid)
       // 还"活着"但状态是 Z = 它已经死了，只差父进程 wait() 收尸：这种东西不持有 socket、
-      // 不需要人去 sudo kill，报成幸存者就是把人支到一条没用的命令上。
+      // 不需要人去做任何收尾动作，报成幸存者就是把人支到一条没用的命令上。
       if (after === 'alive' && isZombiePid(pid, { spawn })) after = 'gone'
     }
     if (after === 'gone') {
@@ -554,11 +556,15 @@ export function terminatePids(pids, { spawn = spawnSync, sleepMs = 1000, reprobe
   return { terminated, forced, survivors }
 }
 
-/** 幸存者（安装器发不动信号的进程）的红字（finding 5，纯函数）。
- *  这里给的必须是**人能直接执行**的动作，而不是"请检查权限"：安装器没有 root 权限，
- *  所以只有坐在键盘前的这个人能 `sudo kill -9`；他知道 pid、知道为什么必须他做、
- *  也知道做完要重跑什么。socket 还挂在这些 pid 上，所以本轮的产物从未接管——
- *  收尾那次版本核对会把这件事再钉一次。 */
+/** 幸存者（安装器收不掉的进程）的红字（finding 5，纯函数）。
+ *  这里给的必须是**能直接执行**的动作，而不是"请检查权限"；而本产品的红线是：
+ *  补救文案一律不发提权命令。发信号这条本来就分两档，两档都如实写出来——
+ *  ① 当前账号自己就能做的 `/bin/kill -9 <pid>`（安装器已经试过 TERM 与 KILL，
+ *     再报一次只是给人一个能手敲的等价动作，它不越权）；
+ *  ② 它被 EPERM 拒掉 = 这些 pid 不属于当前账号，那一步**只有坐在键盘前的这个人
+ *     能做**。这一步归人，不归脚本：本产品保留给真人的就是这种物理动作。
+ *  socket 还挂在这些 pid 上，所以本轮的产物从未接管——收尾那次版本核对会把这件
+ *  事再钉一次。退出码契约不变（调用方仍按失败说）。 */
 export function survivorText(survivors, { socketPath } = {}) {
   const pids = survivors.map((entry) => entry.pid).join(' ')
   return [
@@ -566,8 +572,10 @@ export function survivorText(survivors, { socketPath } = {}) {
     + survivors.map((entry) => `pid ${entry.pid} — ${entry.reason}`).join('；'),
     `安装器无权向这些进程发信号（它们不属于当前账号，典型是 root 拉起的旧 daemon）。`
     + `上面"已结束"那句只对确实已经不在的 pid 成立，不含这些。`,
-    `由人来收尾：先看清是谁起的 \`ps -o pid=,user=,lstart=,command= -p ${pids}\`，`
-    + `再 \`sudo kill -9 ${pids}\`，然后重跑本安装器并加 --replace-daemon。`,
+    `先试当前账号自己就能做的那条（不提权）：\`/bin/kill -9 ${pids}\`。`
+    + `它若仍被拒，就只能由坐在键盘前的人来结束这些进程——本安装器不发放提权命令，`
+    + `这一步归人。先看清是谁起的 \`ps -o pid=,user=,lstart=,command= -p ${pids}\`，`
+    + `由本人结束它们，然后重跑本安装器并加 --replace-daemon。`,
   ].join('\n')
 }
 
@@ -1776,8 +1784,11 @@ export function usageText() {
     '     （--no-daemon 且 --no-launchd）',
     '  1  收尾未通过 hello 校验（daemon 没起来/不应答），或构建/产物/launchd 出错',
     '  2  命令行参数错误',
-    '  注：install.sh 用 exec 委托本文件，退出码原样透传，所以 `curl | sh` 的',
-    '      $? 就是这里的结论。',
+    '  注：install.sh 用 exec 委托本文件，所以**脚本自己跑完了**之后，退出码原样透传。',
+    '      但 `curl … | sh` 的 $? 只在 curl 成功时才是这里的结论：curl 取不到脚本时 sh 读到的',
+    '      是空输入，直接 EOF 退 0（本机实测 curl 退 7、管道退 0）；中途断流时 sh 只执行了',
+    '      收到的前半截，回的是最后一条命令的状态。要拿退出码当结论就分两步跑：',
+    '      curl -fsSL <install.sh> -o /tmp/gp-install.sh && sh /tmp/gp-install.sh',
     '',
   ].join('\n')
 }
@@ -1862,7 +1873,7 @@ export function nextStepsText({
     `   作业被 bootout（等授权期间常发生）后的恢复**不需要手敲 launchctl**：`,
     `   node "${path.join(rootDir, 'installer', 'cli.js')}" --restore-launchd`,
     `   （检测→bootstrap→hello 校验自报席位；勾完 TCC 框重跑即自动换进程复验）`,
-`4. entryName 核对：设置面板「Daemon 状态 → 主体」应与上面「${entryName}」一致；不一致说明连到了别的构建实例。`,
+`4. 主体名核对：设置面板「Daemon 状态 → 主体」应与上面「${entryName}」一致；不一致说明连到了别的构建实例。`,
     '5. registry 发布形态：MCP 服务器已可独立安装（`npm i -g glasspane-mcp`，命令名',
     '   glasspane-mcp）；但它只是转发层，daemon 与权限仍由本次安装产出，缺 daemon 时',
     '   工具调用会返回带补救步骤的结构化错误。',
@@ -2372,13 +2383,10 @@ export async function install({
     const hasLockfile = fs.existsSync(path.join(rootDir, 'package-lock.json'))
     const depsCmd = npmDepsCommand({ hasLockfile })
     printStep(hasLockfile
-      ? '安装 npm 依赖（workspaces: kernel / mcp-shell / installer）——按提交过的 package-lock.json 走 npm ci……'
-      : '安装 npm 依赖（workspaces: kernel / mcp-shell / installer）——该树没有 package-lock.json，退回 npm install（依赖树未经 CI 那一份 lock 的 attest）……')
+      ? '安装 npm 依赖（workspaces: mcp-shell / installer / updater）——按提交过的 package-lock.json 走 npm ci……'
+      : '安装 npm 依赖（workspaces: mcp-shell / installer / updater）——该树没有 package-lock.json，退回 npm install（依赖树未经 CI 那一份 lock 的 attest）……')
     await run('npm', depsCmd, { cwd: rootDir })
 
-    printStep('编译 kernel……')
-    await run('npm', ['run', 'build', '--workspace', '@iterate/kernel'], { cwd: rootDir })
-
     printStep('编译 mcp-shell……')
     await run('npm', ['run', 'build', '--workspace', 'glasspane-mcp'], { cwd: rootDir })
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glasspane-install",
-  "version": "1.16.4",
+  "version": "1.19.0",
   "description": "GlassPane one-command installer: terminal onboarding → install deps → build TS + Swift engine → start daemon → open settings GUI for permission guide",
   "type": "module",
   "license": "MIT",