@walkhi/code-relax 0.1.0-beta.50 → 0.1.0-beta.59

package/tools/postinstall.mjs

@@ -1,186 +1,186 @@
-import { execFileSync } from 'node:child_process';
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-// The same path adapter is available in published dist and in a source checkout.
-const pathsModule = new URL('../dist/src/platform/runtime-paths.mjs', import.meta.url);
-const { runtimePaths } = await import(fs.existsSync(pathsModule) ? pathsModule : new URL('../src/platform/runtime-paths.mjs', import.meta.url));
-const { serviceRoot, stateRoot } = runtimePaths();
-const installLog = path.join(stateRoot, 'install.log');
-
-function sanitizeLog(value) {
-  let result = String(value).replace(/npm_[A-Za-z0-9]+/gu, '[redacted npm token]')
-    .replace(/([?&]token=)[^&\s"']+/giu, '$1[redacted]');
-  const paths = [['LOCALAPPDATA', process.env.LOCALAPPDATA], ['APPDATA', process.env.APPDATA],
-    ['USERPROFILE', process.env.USERPROFILE], ['TEMP', process.env.TEMP], ['TMP', process.env.TMP]]
-    .filter(([, item]) => item).sort((left, right) => right[1].length - left[1].length);
-  for (const [name, item] of paths) {
-    const pattern = item.replace(/[.*+?^${}()|[\]\\]/gu, '\\$&');
-    result = result.replace(new RegExp(pattern, 'giu'), `%${name}%`);
-  }
-  return result;
-}
-
-function appendLog(message) {
-  fs.mkdirSync(stateRoot, { recursive: true });
-  fs.appendFileSync(installLog, `${new Date().toISOString()} ${sanitizeLog(message)}\n`, 'utf8');
-}
-
-function systemSummary() {
-  const npm = String(process.env.npm_config_user_agent || 'unknown').replace(/[\r\n]/gu, ' ');
-  return `platform=${process.platform} osRelease=${os.release()} osVersion=${os.version()} `
-    + `osArch=${os.arch()} processArch=${process.arch} node=${process.version} npmUserAgent=${npm}`;
-}
-
-function runStage(entry, stage, args, formatOutput = value => value) {
-  appendLog(`[${stage}] start`);
-  try {
-    const output = execFileSync(process.execPath, [entry, ...args], { encoding: 'utf8', windowsHide: true,
-      stdio: ['inherit', 'pipe', 'pipe'] });
-    if (output) { process.stdout.write(formatOutput(output)); appendLog(`[${stage}] stdout\n${output.trimEnd()}`); }
-    appendLog(`[${stage}] success`);
-  } catch (error) {
-    if (error?.stdout) { process.stdout.write(error.stdout); appendLog(`[${stage}] stdout\n${String(error.stdout).trimEnd()}`); }
-    if (error?.stderr) { process.stderr.write(error.stderr); appendLog(`[${stage}] stderr\n${String(error.stderr).trimEnd()}`); }
-    appendLog(`[${stage}] failed: ${error?.stack || error?.message || String(error)}`);
-    throw error;
-  }
-}
-
-export function formatSetupOutput(output) {
-  try {
-    const result = JSON.parse(output);
-    const migration = result.managedAppServerMigration || {};
-    return `Code Relax ${result.version || '未知版本'} setup 已完成；接下来执行安装后健康检查。\n`
-      + '工作站服务和 Codex 内核已就绪，已启用登录自启。\n'
-      + (result.preserveCodex ? '过渡版保留当前 Codex 和内核运行状态；待手机发起下一次完整更新。\n' : migration.restarted ? `Codex 内核已更新：${migration.previousVersion || '未知'} → ${result.managedAppServer?.version || '未知'}（PID ${migration.previousPid} → ${migration.currentPid}）。\n` : 'Codex 内核已是当前选定版本，无需切换。\n')
-      + (result.preserveCodex ? '' : result.desktopRestarted ? '电脑版 Codex 已重启，并确认连接到工作站内核。\n' : '安装前未运行电脑版 Codex，保持关闭。\n')
-      + (result.desktopRestartRecommended ? 'Codex Desktop：请完全退出后重新打开。\n' : '');
-  } catch { return output; }
-}
-
-// npm owns command links. Inspect them without changing the user's shell configuration.
-export function commandDiagnostics(entry, { prefix, env = process.env, platform = process.platform } = {}) {
-  const windows = platform === 'win32';
-  const bin = windows ? prefix : path.join(prefix, 'bin');
-  const command = path.join(bin, windows ? 'relax.cmd' : 'relax');
-  const lines = [`命令入口：${command}`];
-  let linkReady = false;
-  try {
-    if (windows) {
-      const shim = fs.readFileSync(command, 'utf8');
-      linkReady = shim.replaceAll('\\', '/').includes('node_modules/@walkhi/code-relax/dist/bin/codex-remote.mjs') && fs.existsSync(entry);
-    } else {
-      linkReady = fs.realpathSync(command) === fs.realpathSync(entry);
-      fs.accessSync(command, fs.constants.X_OK);
-    }
-    lines.push(linkReady ? '命令链接：正常' : '命令链接：目标与本次安装不一致');
-  } catch (error) {
-    linkReady = false;
-    lines.push(`命令链接：不可用（${error.code || error.message}）`);
-  }
-  const normalize = value => {
-    let resolved;
-    try { resolved = fs.realpathSync(value); } catch { resolved = path.resolve(value); }
-    return windows ? resolved.toLowerCase() : resolved;
-  };
-  const pathValue = Object.entries(env).find(([key]) => key.toLowerCase() === 'path')?.[1] || '';
-  const onPath = pathValue.split(windows ? ';' : ':').filter(Boolean)
-    .some(value => normalize(value.replace(/^"|"$/g, '')) === normalize(bin));
-  lines.push(`安装进程 PATH：${onPath ? '包含' : '未包含'}全局命令目录`);
-  lines.push('注：npm 会调整安装进程 PATH；当前终端能否直接找到命令仍以终端为准。');
-  if (!linkReady) lines.push('CLI 入口异常；服务状态请以上方健康检查为准，请保留本次诊断输出。');
-  else if (!onPath) lines.push('全局命令目录未在 PATH 中，可先使用下方完整路径命令。');
-  const quote = value => "'" + value.replaceAll("'", windows ? "''" : "'\"'\"'") + "'";
-  const direct = `${windows ? '& ' : ''}${quote(process.execPath)} ${quote(entry)}`;
-  lines.push(`无需依赖 relax 命令的检查入口${windows ? '（PowerShell）' : ''}：`, `${direct} doctor`);
-  lines.push('生成配对二维码：', `${direct} pair`);
-  return lines.join('\n') + '\n';
-}
-
-function installationSnapshot() {
-  const recordPath = path.join(serviceRoot, 'installation.json');
-  if (!fs.existsSync(serviceRoot)) return { exists: false, valid: false };
-  try {
-    const record = JSON.parse(fs.readFileSync(recordPath, 'utf8').replace(/^\uFEFF/u, ''));
-    return { exists: true, valid: Boolean(record?.installedAt && record?.version),
-      version: record?.version, installedAt: record?.installedAt };
-  } catch {
-    return { exists: true, valid: false };
-  }
-}
-
-function sameInstallation(left, right) {
-  return left.valid && right.valid && left.version === right.version && left.installedAt === right.installedAt;
-}
-
-function setupFailureGuidance(previous, current) {
-  if (previous.valid && sameInstallation(previous, current)) {
-    return `检测到旧安装 ${previous.version}；新版本部署未完成，旧安装记录仍保留。\n`
-      + '请先执行 relax doctor；修复报错原因后重新运行 npm 安装命令，无需卸载旧版本。';
-  }
-  if (previous.valid && current.valid) {
-    return `检测到旧安装 ${previous.version}；服务文件已更新为 ${current.version}，但 setup 后续步骤失败。\n`
-      + '请执行 relax doctor 确认当前状态，修复后执行 relax setup；无需先卸载。';
-  }
-  if (previous.exists && current.valid) {
-    return `检测到既有服务目录，但无法确认有效的旧安装记录；服务文件现已写入 ${current.version}，setup 后续步骤仍失败。\n`
-      + '请执行 relax doctor 确认当前状态，修复后执行 relax setup；不要直接删除配置目录。';
-  }
-  if (previous.exists) {
-    return '检测到既有服务目录，但无法确认有效的旧安装记录；本次部署未完成。\n'
-      + '请执行 relax doctor，根据检查结果修复后重新运行 npm 安装命令，不要直接删除配置目录。';
-  }
-  if (current.valid) {
-    return `这是首次安装；服务文件 ${current.version} 已写入，但 setup 后续步骤失败。\n`
-      + '如果 relax 命令仍可用，请执行 relax doctor，再执行 relax setup；否则修复原因后重新运行 npm 安装命令。';
-  }
-  return '这是首次安装，尚未形成可确认的固定服务。\n修复上方错误后重新运行 npm 安装命令；无需执行卸载。';
-}
-
-const invokedDirectly = process.argv[1]
-  && path.resolve(process.argv[1]) === path.resolve(fileURLToPath(import.meta.url));
-if (invokedDirectly && process.env.npm_config_global === 'true') {
-  const entry = fileURLToPath(new URL('../dist/bin/codex-remote.mjs', import.meta.url));
-  const previous = installationSnapshot();
-  appendLog(`[postinstall] start package=${process.env.npm_package_version || 'unknown'} ${systemSummary()}`);
-  let setupStarted = false;
-  try {
-    const { prepareNativePackage } = await import('../dist/src/platform/native-package.mjs');
-    prepareNativePackage(fileURLToPath(new URL('../', import.meta.url)));
-    setupStarted = true;
-    runStage(entry, 'setup', ['setup', '--json'], output => formatSetupOutput(output));
-    try {
-      runStage(entry, 'doctor', ['doctor']);
-      console.log('Code Relax 自动安装成功：setup 与安装后健康检查均已通过，无需重复执行 setup。');
-      console.log('npm 的脚本安全提示与安装结果分别判断；本次安装脚本已实际执行，未修改 npm 安全配置。');
-    }
-    catch (error) {
-      console.error('服务安装已完成，但安装后健康检查未通过；请查看上方诊断与安装日志。');
-      process.exitCode = Number.isInteger(error?.status) && error.status > 0 ? error.status : 1;
-    }
-    console.log(`安装日志：${installLog}`);
-    appendLog(process.exitCode ? '[postinstall] failed stage=doctor' : '[postinstall] success');
-  } catch (error) {
-    const current = installationSnapshot();
-    if (!setupStarted) console.error(`平台组件检查失败：${error.message}`);
-    console.error(`\nCode Relax 安装未完全完成：\n${setupFailureGuidance(previous, current)}`);
-    if (error?.code && error.code !== 'ERR_CHILD_PROCESS_STDIO_MAXBUFFER') console.error(`启动安装步骤失败：${error.message}`);
-    console.error(`安装日志：${installLog}`);
-    appendLog('[postinstall] failed stage=setup');
-    process.exitCode = Number.isInteger(error?.status) && error.status > 0 ? error.status : 1;
-  } finally {
-    try {
-      const prefix = execFileSync(process.execPath, [process.env.npm_execpath, 'prefix', '--global'],
-        { encoding: 'utf8', windowsHide: true, stdio: ['ignore', 'pipe', 'pipe'] }).trim();
-      const output = commandDiagnostics(entry, { prefix });
-      process.stdout.write(output);
-      appendLog(`[command-diagnostics]\n${output}`);
-    } catch (error) {
-      console.error(`命令入口诊断失败：${error.message}`);
-      appendLog(`[command-diagnostics] failed: ${error.message}`);
-    }
-  }
-}
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+// The same path adapter is available in published dist and in a source checkout.
+const pathsModule = new URL('../dist/src/platform/runtime-paths.mjs', import.meta.url);
+const { runtimePaths } = await import(fs.existsSync(pathsModule) ? pathsModule : new URL('../src/platform/runtime-paths.mjs', import.meta.url));
+const { serviceRoot, stateRoot } = runtimePaths();
+const installLog = path.join(stateRoot, 'install.log');
+
+function sanitizeLog(value) {
+  let result = String(value).replace(/npm_[A-Za-z0-9]+/gu, '[redacted npm token]')
+    .replace(/([?&]token=)[^&\s"']+/giu, '$1[redacted]');
+  const paths = [['LOCALAPPDATA', process.env.LOCALAPPDATA], ['APPDATA', process.env.APPDATA],
+    ['USERPROFILE', process.env.USERPROFILE], ['TEMP', process.env.TEMP], ['TMP', process.env.TMP]]
+    .filter(([, item]) => item).sort((left, right) => right[1].length - left[1].length);
+  for (const [name, item] of paths) {
+    const pattern = item.replace(/[.*+?^${}()|[\]\\]/gu, '\\$&');
+    result = result.replace(new RegExp(pattern, 'giu'), `%${name}%`);
+  }
+  return result;
+}
+
+function appendLog(message) {
+  fs.mkdirSync(stateRoot, { recursive: true });
+  fs.appendFileSync(installLog, `${new Date().toISOString()} ${sanitizeLog(message)}\n`, 'utf8');
+}
+
+function systemSummary() {
+  const npm = String(process.env.npm_config_user_agent || 'unknown').replace(/[\r\n]/gu, ' ');
+  return `platform=${process.platform} osRelease=${os.release()} osVersion=${os.version()} `
+    + `osArch=${os.arch()} processArch=${process.arch} node=${process.version} npmUserAgent=${npm}`;
+}
+
+function runStage(entry, stage, args, formatOutput = value => value) {
+  appendLog(`[${stage}] start`);
+  try {
+    const output = execFileSync(process.execPath, [entry, ...args], { encoding: 'utf8', windowsHide: true,
+      stdio: ['inherit', 'pipe', 'pipe'] });
+    if (output) { process.stdout.write(formatOutput(output)); appendLog(`[${stage}] stdout\n${output.trimEnd()}`); }
+    appendLog(`[${stage}] success`);
+  } catch (error) {
+    if (error?.stdout) { process.stdout.write(error.stdout); appendLog(`[${stage}] stdout\n${String(error.stdout).trimEnd()}`); }
+    if (error?.stderr) { process.stderr.write(error.stderr); appendLog(`[${stage}] stderr\n${String(error.stderr).trimEnd()}`); }
+    appendLog(`[${stage}] failed: ${error?.stack || error?.message || String(error)}`);
+    throw error;
+  }
+}
+
+export function formatSetupOutput(output) {
+  try {
+    const result = JSON.parse(output);
+    const migration = result.managedAppServerMigration || {};
+    return `Code Relax ${result.version || '未知版本'} setup 已完成；接下来执行安装后健康检查。\n`
+      + '工作站服务和 Codex 内核已就绪，已启用登录自启。\n'
+      + (result.preserveCodex ? '过渡版保留当前 Codex 和内核运行状态；待手机发起下一次完整更新。\n' : migration.restarted ? `Codex 内核已更新：${migration.previousVersion || '未知'} → ${result.managedAppServer?.version || '未知'}（PID ${migration.previousPid} → ${migration.currentPid}）。\n` : 'Codex 内核已是当前选定版本，无需切换。\n')
+      + (result.preserveCodex ? '' : result.desktopRestarted ? '电脑版 Codex 已重启，并确认连接到工作站内核。\n' : '安装前未运行电脑版 Codex，保持关闭。\n')
+      + (result.desktopRestartRecommended ? 'Codex Desktop：请完全退出后重新打开。\n' : '');
+  } catch { return output; }
+}
+
+// npm owns command links. Inspect them without changing the user's shell configuration.
+export function commandDiagnostics(entry, { prefix, env = process.env, platform = process.platform } = {}) {
+  const windows = platform === 'win32';
+  const bin = windows ? prefix : path.join(prefix, 'bin');
+  const command = path.join(bin, windows ? 'relax.cmd' : 'relax');
+  const lines = [`命令入口：${command}`];
+  let linkReady = false;
+  try {
+    if (windows) {
+      const shim = fs.readFileSync(command, 'utf8');
+      linkReady = shim.replaceAll('\\', '/').includes('node_modules/@walkhi/code-relax/dist/bin/codex-remote.mjs') && fs.existsSync(entry);
+    } else {
+      linkReady = fs.realpathSync(command) === fs.realpathSync(entry);
+      fs.accessSync(command, fs.constants.X_OK);
+    }
+    lines.push(linkReady ? '命令链接：正常' : '命令链接：目标与本次安装不一致');
+  } catch (error) {
+    linkReady = false;
+    lines.push(`命令链接：不可用（${error.code || error.message}）`);
+  }
+  const normalize = value => {
+    let resolved;
+    try { resolved = fs.realpathSync(value); } catch { resolved = path.resolve(value); }
+    return windows ? resolved.toLowerCase() : resolved;
+  };
+  const pathValue = Object.entries(env).find(([key]) => key.toLowerCase() === 'path')?.[1] || '';
+  const onPath = pathValue.split(windows ? ';' : ':').filter(Boolean)
+    .some(value => normalize(value.replace(/^"|"$/g, '')) === normalize(bin));
+  lines.push(`安装进程 PATH：${onPath ? '包含' : '未包含'}全局命令目录`);
+  lines.push('注：npm 会调整安装进程 PATH；当前终端能否直接找到命令仍以终端为准。');
+  if (!linkReady) lines.push('CLI 入口异常；服务状态请以上方健康检查为准，请保留本次诊断输出。');
+  else if (!onPath) lines.push('全局命令目录未在 PATH 中，可先使用下方完整路径命令。');
+  const quote = value => "'" + value.replaceAll("'", windows ? "''" : "'\"'\"'") + "'";
+  const direct = `${windows ? '& ' : ''}${quote(process.execPath)} ${quote(entry)}`;
+  lines.push(`无需依赖 relax 命令的检查入口${windows ? '（PowerShell）' : ''}：`, `${direct} doctor`);
+  lines.push('生成配对二维码：', `${direct} pair`);
+  return lines.join('\n') + '\n';
+}
+
+function installationSnapshot() {
+  const recordPath = path.join(serviceRoot, 'installation.json');
+  if (!fs.existsSync(serviceRoot)) return { exists: false, valid: false };
+  try {
+    const record = JSON.parse(fs.readFileSync(recordPath, 'utf8').replace(/^\uFEFF/u, ''));
+    return { exists: true, valid: Boolean(record?.installedAt && record?.version),
+      version: record?.version, installedAt: record?.installedAt };
+  } catch {
+    return { exists: true, valid: false };
+  }
+}
+
+function sameInstallation(left, right) {
+  return left.valid && right.valid && left.version === right.version && left.installedAt === right.installedAt;
+}
+
+function setupFailureGuidance(previous, current) {
+  if (previous.valid && sameInstallation(previous, current)) {
+    return `检测到旧安装 ${previous.version}；新版本部署未完成，旧安装记录仍保留。\n`
+      + '请先执行 relax doctor；修复报错原因后重新运行 npm 安装命令，无需卸载旧版本。';
+  }
+  if (previous.valid && current.valid) {
+    return `检测到旧安装 ${previous.version}；服务文件已更新为 ${current.version}，但 setup 后续步骤失败。\n`
+      + '请执行 relax doctor 确认当前状态，修复后执行 relax setup；无需先卸载。';
+  }
+  if (previous.exists && current.valid) {
+    return `检测到既有服务目录，但无法确认有效的旧安装记录；服务文件现已写入 ${current.version}，setup 后续步骤仍失败。\n`
+      + '请执行 relax doctor 确认当前状态，修复后执行 relax setup；不要直接删除配置目录。';
+  }
+  if (previous.exists) {
+    return '检测到既有服务目录，但无法确认有效的旧安装记录；本次部署未完成。\n'
+      + '请执行 relax doctor，根据检查结果修复后重新运行 npm 安装命令，不要直接删除配置目录。';
+  }
+  if (current.valid) {
+    return `这是首次安装；服务文件 ${current.version} 已写入，但 setup 后续步骤失败。\n`
+      + '如果 relax 命令仍可用，请执行 relax doctor，再执行 relax setup；否则修复原因后重新运行 npm 安装命令。';
+  }
+  return '这是首次安装，尚未形成可确认的固定服务。\n修复上方错误后重新运行 npm 安装命令；无需执行卸载。';
+}
+
+const invokedDirectly = process.argv[1]
+  && path.resolve(process.argv[1]) === path.resolve(fileURLToPath(import.meta.url));
+if (invokedDirectly && process.env.npm_config_global === 'true') {
+  const entry = fileURLToPath(new URL('../dist/bin/codex-remote.mjs', import.meta.url));
+  const previous = installationSnapshot();
+  appendLog(`[postinstall] start package=${process.env.npm_package_version || 'unknown'} ${systemSummary()}`);
+  let setupStarted = false;
+  try {
+    const { prepareNativePackage } = await import('../dist/src/platform/native-package.mjs');
+    prepareNativePackage(fileURLToPath(new URL('../', import.meta.url)));
+    setupStarted = true;
+    runStage(entry, 'setup', ['setup', '--json'], output => formatSetupOutput(output));
+    try {
+      runStage(entry, 'doctor', ['doctor']);
+      console.log('Code Relax 自动安装成功：setup 与安装后健康检查均已通过，无需重复执行 setup。');
+      console.log('npm 的脚本安全提示与安装结果分别判断；本次安装脚本已实际执行，未修改 npm 安全配置。');
+    }
+    catch (error) {
+      console.error('服务安装已完成，但安装后健康检查未通过；请查看上方诊断与安装日志。');
+      process.exitCode = Number.isInteger(error?.status) && error.status > 0 ? error.status : 1;
+    }
+    console.log(`安装日志：${installLog}`);
+    appendLog(process.exitCode ? '[postinstall] failed stage=doctor' : '[postinstall] success');
+  } catch (error) {
+    const current = installationSnapshot();
+    if (!setupStarted) console.error(`平台组件检查失败：${error.message}`);
+    console.error(`\nCode Relax 安装未完全完成：\n${setupFailureGuidance(previous, current)}`);
+    if (error?.code && error.code !== 'ERR_CHILD_PROCESS_STDIO_MAXBUFFER') console.error(`启动安装步骤失败：${error.message}`);
+    console.error(`安装日志：${installLog}`);
+    appendLog('[postinstall] failed stage=setup');
+    process.exitCode = Number.isInteger(error?.status) && error.status > 0 ? error.status : 1;
+  } finally {
+    try {
+      const prefix = execFileSync(process.execPath, [process.env.npm_execpath, 'prefix', '--global'],
+        { encoding: 'utf8', windowsHide: true, stdio: ['ignore', 'pipe', 'pipe'] }).trim();
+      const output = commandDiagnostics(entry, { prefix });
+      process.stdout.write(output);
+      appendLog(`[command-diagnostics]\n${output}`);
+    } catch (error) {
+      console.error(`命令入口诊断失败：${error.message}`);
+      appendLog(`[command-diagnostics] failed: ${error.message}`);
+    }
+  }
+}