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

package/dist/src/service-doctor.mjs

@@ -1,148 +1,148 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-import { readRecord } from './service-lifecycle.mjs';
-import { inspectSkill } from './skill-install.mjs';
-import { recoveryStatus } from './shared-recovery.mjs';
-
-export function packageDeploymentCheck(cliVersion, installedVersion) {
-  if (!cliVersion) return { id: 'package-version', status: 'warning', message: '无法读取当前 CLI 包版本，未确认本次部署版本。' };
-  if (cliVersion !== installedVersion) return { id: 'package-version', status: 'error',
-    message: `当前 CLI 包为 ${cliVersion}，固定服务为 ${installedVersion || '未确认'}；本次包尚未完整部署。安装脚本可能未执行或执行失败，不能仅凭 npm 警告判断。请查看 install.log；确认允许部署并中断相关任务后，执行 relax setup，再运行 relax doctor。无需放开全局 npm 脚本权限。` };
-  return { id: 'package-version', status: 'ok', message: `CLI 与固定服务版本一致：${cliVersion}。这不单独证明本次 postinstall 执行过；当前可用性以下方服务和内核检查为准。` };
-}
-
-export async function doctor({ paths, host, service, skillTarget, ensureAutostart, cliVersion, diagnostics = false }) {
-  const checks = [];
-  let installedVersion;
-  let kernelUpdate = null;
-  let desktopRecovery = null;
-  let serviceState = null;
-  const add = (id, status, message) => checks.push({ id, status, message });
-  const check = async (id, task) => {
-    try { await task(); } catch (error) { add(id, 'error', error.message); }
-  };
-  await check('installation', async () => {
-    const record = readRecord(path.join(paths.serviceRoot, 'installation.json'));
-    if (!record || !fs.existsSync(path.join(paths.serviceRoot, 'dist/bin/codex-remote.mjs'))) throw Error('尚未完整部署服务；安装脚本可能未执行或执行失败。请查看 install.log，确认部署后执行 relax setup，再运行 relax doctor；不能仅凭 npm 警告判断原因。');
-    if (!record.nodeExecutable || !fs.existsSync(record.nodeExecutable)) throw Error('记录的 Node 已失效，请用可用的 Node 重新安装 Code Relax。');
-    installedVersion = record.version;
-    add('installation', 'ok', `已安装版本：${record.version}；Node：${record.nodeExecutable}`);
-  });
-  checks.push(packageDeploymentCheck(cliVersion, installedVersion));
-  await check('bridge-runtime', async () => {
-    await host.bridgeEnvironment();
-    add('bridge-runtime', 'ok', '桌面服务启动环境正常。');
-  });
-  await check('network', async () => {
-    const address = await host.lanAddress();
-    if (!address) { add('network', 'warning', '未连接局域网；需要局域网连接时，请接入 Wi-Fi 或有线网络。'); return; }
-    add('network', 'ok', `局域网地址：${address}`);
-  });
-  await check('autostart', async () => {
-    const state = await ensureAutostart();
-    add('autostart', 'ok', `当前用户登录自启：${state.repaired ? '已自动恢复' : '已启用'}。`);
-  });
-  await check('service', async () => {
-    const state = await service.status();
-    serviceState = state;
-    if (state.keepAwake) {
-      const power = state.keepAwake;
-      add('keep-awake', power.enabled && !power.active ? 'warning' : 'ok',
-        power.active ? '保持唤醒已生效，允许屏幕熄灭。' : !power.enabled ? '保持唤醒已由 CLI 关闭。'
-          : `保持唤醒未生效：${power.error || '未知原因'}；可执行 relax keep-awake on 重新申请。`);
-    }
-    add('service', state.running ? 'ok' : 'error', state.running
-      ? `本机服务正常：${state.mode}，端口 ${state.port}，运行版本：${state.version || '未知'}` : '服务未就绪；安装后执行 relax start。');
-    if (state.running && installedVersion && state.version !== installedVersion) add('service-version', 'error', state.version
-      ? `已安装版本 ${installedVersion}，但当前运行版本为 ${state.version}；请重新执行安装或重启工作站服务。`
-      : `已安装版本 ${installedVersion}，但无法确认运行服务版本；请保留诊断结果核查，不能据此认定旧进程或自动重启。`);
-    if (state.running) add('execution', state.execution?.ready === true && state.execution?.canWrite === true ? 'ok' : 'error',
-      state.execution?.ready === true && state.execution?.canWrite === true
-        ? 'Codex 完整控制通道已就绪；单个对话的写入权限需在打开该对话时确认。' : 'Codex 完整控制尚未确认就绪且可写；请查看内核和连接诊断，不能仅凭服务在线判定健康。');
-    if (state.running && state.desktop) {
-      const descriptions = {
-        managed: '桌面端已接入 Code Relax 内核。',
-        ordinary: '桌面端正在独立运行，未接入 Code Relax 内核；若同一对话报写入冲突，请核对桌面端占用。',
-        stopped: '桌面端未启动；手机可独立使用已就绪的内核。',
-        unsupported: '当前平台未提供桌面端接入。',
-      };
-      add('desktop', 'ok', state.desktop.installed === false && state.desktop.state !== 'unsupported'
-        ? '未安装桌面端；手机可独立使用已就绪的内核。'
-        : descriptions[state.desktop.state] || '桌面端接入状态暂未确认。');
-    }
-    const currentVersion = state.managedAppServer?.version || null;
-    const selectedVersion = state.managedAppServer?.selectedVersion || null;
-    if (state.managedAppServer) kernelUpdate = { pending: state.managedAppServer.updatePending === true,
-      currentVersion, selectedVersion,
-      command: state.managedAppServer.updatePending ? 'relax kernel-restart --confirm' : null };
-    if (state.running) add('managed-app-server', state.managedAppServer?.state === 'ready' ? 'ok' : 'error',
-      state.managedAppServer?.state === 'ready' ? `Codex 内核已就绪：版本 ${currentVersion || '未知'}。`
-        : `${state.managedAppServer?.error || 'Codex 内核尚未就绪。'} 请执行 relax setup 修复；若提示未安装或未登录 Codex，请先完成安装和登录。`);
-    if (state.managedAppServer?.updatePending) {
-      const versionDetail = currentVersion && selectedVersion && currentVersion === selectedVersion
-        ? `内核版本号未变（${currentVersion}），重启后将使用更新后的安装文件`
-        : `当前内核 ${currentVersion || '未知'}，待应用 ${selectedVersion || '未知'}`;
-      add('managed-app-server-update', 'warning',
-        `Codex 更新待应用：${versionDetail}；执行 relax kernel-restart --confirm 应用更新。`);
-    }
-    if (state.managedAppServer?.launcherRestartRequired) add('managed-app-server-launcher', 'warning',
-      '工作站更新尚未完全生效，请执行 relax setup。');
-  });
-  if (diagnostics) {
-    try { desktopRecovery = await recoveryStatus(paths.stateRoot); }
-    catch (error) { desktopRecovery = { status: 'unknown', error: error.message }; }
-  }
-  await check('skill', async () => {
-    const state = inspectSkill(skillTarget);
-    add('skill', state.managed ? 'ok' : 'warning', state.managed ? '本包管理的 Skill 已安装。'
-      : state.installed ? '存在同名自定义 Skill，本包不会覆盖。' : 'Skill 未安装；重新执行 relax setup。');
-  });
-  return { ready: !checks.some(item => item.status === 'error'), kernelUpdate, checks, ...(diagnostics ? { desktopRecovery, diagnostics: {
-    collectedAt: new Date().toISOString(), platform: process.platform, arch: process.arch, osRelease: os.release(),
-    nodeVersion: process.version, nodeExecutable: process.execPath, serviceRoot: paths.serviceRoot,
-    servicePid: serviceState?.pid || null, port: serviceState?.port || null, serviceVersion: serviceState?.version || null,
-    kernel: serviceState?.managedAppServer ? {
-      version: serviceState.managedAppServer.version || null,
-      executable: serviceState.managedAppServer.executable || null,
-      selectedVersion: serviceState.managedAppServer.selectedVersion || null,
-      preferredExecutable: serviceState.managedAppServer.preferredExecutable || null,
-      selectedSource: serviceState.managedAppServer.source || null,
-    } : null,
-  } } : {}) };
-}
-
-export function formatDoctorOutput(result, detail = false) {
-  const labels = { 'keep-awake': '保持唤醒', installation: '安装文件', 'bridge-runtime': '运行环境', network: '局域网',
-    autostart: '登录自启动', service: '工作站服务', 'managed-app-server': 'Codex 内核',
-    execution: '完整控制', desktop: 'Codex 桌面端', 'package-version': '安装包版本', 'service-version': '服务版本', 'managed-app-server-update': 'Codex 更新',
-    'managed-app-server-launcher': '工作站更新', skill: 'Codex Skill' };
-  const byId = id => result.checks.find(item => item.id === id);
-  const summary = (id, success) => {
-    const item = byId(id);
-    return `${labels[id]}：${!item ? '未检查（工作站服务尚未启动）' : item.status === 'ok' ? success : '异常，见下方处理方法'}`;
-  };
-  const issues = result.checks.filter(item => item.status !== 'ok');
-  const lines = [result.ready ? '工作站检查通过。' : '工作站检查发现问题。',
-    summary('installation', '完整'), summary('package-version', 'CLI 与固定服务一致'), summary('service', '正在运行'), summary('managed-app-server', '已就绪'), summary('execution', '通道已就绪（不代表每个对话均可写）')];
-  if (issues.length) lines.push('', '需要处理或留意：', ...issues.map(item => `- ${labels[item.id] || item.id}：${item.message}`));
-  if (detail) {
-    const info = result.diagnostics || {};
-    lines.unshift('Code Relax 诊断报告（供客服或技术人员排查）', `采集时间：${info.collectedAt || '未知'}`,
-      `系统：${info.platform || process.platform} ${info.arch || process.arch} ${info.osRelease || ''}`,
-      `Node：${info.nodeVersion || process.version}；${info.nodeExecutable || process.execPath}`,
-      `服务目录：${info.serviceRoot || '未知'}`, `服务进程：${info.servicePid || '未运行'}；端口：${info.port || '未知'}`, '');
-    lines.push('', '检查详情：', ...result.checks.filter(item => item.status === 'ok').map(item => `- ${labels[item.id] || item.id}：${item.message}`));
-    if (info.kernel) lines.push('',
-      `运行内核：${info.kernel.version || '未知'}；${info.kernel.executable || '路径未知'}`,
-      `候选内核：${info.kernel.selectedVersion || '未知'}；来源 ${info.kernel.selectedSource || '未知'}；${info.kernel.preferredExecutable || '路径未知'}`);
-    const recovery = result.desktopRecovery;
-    if (recovery && !['none', 'unsupported'].includes(recovery.status)) {
-      const status = { failed: '未完成', completed: '已完成', succeeded: '已完成', running: '进行中', unknown: '无法读取' }[recovery.status] || recovery.status;
-      lines.push('', `Desktop 接入排障记录（仅用于排查上次接入，不代表当前服务状态）：上次 Codex Desktop 接入${status}。`);
-      if (recovery.error) lines.push(`记录原因：${recovery.error}`);
-    }
-  }
-  lines.push('', result.ready ? '添加手机：运行 relax pair 生成配对二维码。' : '按上述方法处理后，再运行 relax doctor。');
-  return lines.join('\n');
-}
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { readRecord } from './service-lifecycle.mjs';
+import { inspectSkill } from './skill-install.mjs';
+import { recoveryStatus } from './shared-recovery.mjs';
+
+export function packageDeploymentCheck(cliVersion, installedVersion) {
+  if (!cliVersion) return { id: 'package-version', status: 'warning', message: '无法读取当前 CLI 包版本，未确认本次部署版本。' };
+  if (cliVersion !== installedVersion) return { id: 'package-version', status: 'error',
+    message: `当前 CLI 包为 ${cliVersion}，固定服务为 ${installedVersion || '未确认'}；本次包尚未完整部署。安装脚本可能未执行或执行失败，不能仅凭 npm 警告判断。请查看 install.log；确认允许部署并中断相关任务后，执行 relax setup，再运行 relax doctor。无需放开全局 npm 脚本权限。` };
+  return { id: 'package-version', status: 'ok', message: `CLI 与固定服务版本一致：${cliVersion}。这不单独证明本次 postinstall 执行过；当前可用性以下方服务和内核检查为准。` };
+}
+
+export async function doctor({ paths, host, service, skillTarget, ensureAutostart, cliVersion, diagnostics = false }) {
+  const checks = [];
+  let installedVersion;
+  let kernelUpdate = null;
+  let desktopRecovery = null;
+  let serviceState = null;
+  const add = (id, status, message) => checks.push({ id, status, message });
+  const check = async (id, task) => {
+    try { await task(); } catch (error) { add(id, 'error', error.message); }
+  };
+  await check('installation', async () => {
+    const record = readRecord(path.join(paths.serviceRoot, 'installation.json'));
+    if (!record || !fs.existsSync(path.join(paths.serviceRoot, 'dist/bin/codex-remote.mjs'))) throw Error('尚未完整部署服务；安装脚本可能未执行或执行失败。请查看 install.log，确认部署后执行 relax setup，再运行 relax doctor；不能仅凭 npm 警告判断原因。');
+    if (!record.nodeExecutable || !fs.existsSync(record.nodeExecutable)) throw Error('记录的 Node 已失效，请用可用的 Node 重新安装 Code Relax。');
+    installedVersion = record.version;
+    add('installation', 'ok', `已安装版本：${record.version}；Node：${record.nodeExecutable}`);
+  });
+  checks.push(packageDeploymentCheck(cliVersion, installedVersion));
+  await check('bridge-runtime', async () => {
+    await host.bridgeEnvironment();
+    add('bridge-runtime', 'ok', '桌面服务启动环境正常。');
+  });
+  await check('network', async () => {
+    const address = await host.lanAddress();
+    if (!address) { add('network', 'warning', '未连接局域网；需要局域网连接时，请接入 Wi-Fi 或有线网络。'); return; }
+    add('network', 'ok', `局域网地址：${address}`);
+  });
+  await check('autostart', async () => {
+    const state = await ensureAutostart();
+    add('autostart', 'ok', `当前用户登录自启：${state.repaired ? '已自动恢复' : '已启用'}。`);
+  });
+  await check('service', async () => {
+    const state = await service.status();
+    serviceState = state;
+    if (state.keepAwake) {
+      const power = state.keepAwake;
+      add('keep-awake', power.enabled && !power.active ? 'warning' : 'ok',
+        power.active ? '保持唤醒已生效，允许屏幕熄灭。' : !power.enabled ? '保持唤醒已由 CLI 关闭。'
+          : `保持唤醒未生效：${power.error || '未知原因'}；可执行 relax keep-awake on 重新申请。`);
+    }
+    add('service', state.running ? 'ok' : 'error', state.running
+      ? `本机服务正常：${state.mode}，端口 ${state.port}，运行版本：${state.version || '未知'}` : '服务未就绪；安装后执行 relax start。');
+    if (state.running && installedVersion && state.version !== installedVersion) add('service-version', 'error', state.version
+      ? `已安装版本 ${installedVersion}，但当前运行版本为 ${state.version}；请重新执行安装或重启工作站服务。`
+      : `已安装版本 ${installedVersion}，但无法确认运行服务版本；请保留诊断结果核查，不能据此认定旧进程或自动重启。`);
+    if (state.running) add('execution', state.execution?.ready === true && state.execution?.canWrite === true ? 'ok' : 'error',
+      state.execution?.ready === true && state.execution?.canWrite === true
+        ? 'Codex 完整控制通道已就绪；单个对话的写入权限需在打开该对话时确认。' : 'Codex 完整控制尚未确认就绪且可写；请查看内核和连接诊断，不能仅凭服务在线判定健康。');
+    if (state.running && state.desktop) {
+      const descriptions = {
+        managed: '桌面端已接入 Code Relax 内核。',
+        ordinary: '桌面端正在独立运行，未接入 Code Relax 内核；若同一对话报写入冲突，请核对桌面端占用。',
+        stopped: '桌面端未启动；手机可独立使用已就绪的内核。',
+        unsupported: '当前平台未提供桌面端接入。',
+      };
+      add('desktop', 'ok', state.desktop.installed === false && state.desktop.state !== 'unsupported'
+        ? '未安装桌面端；手机可独立使用已就绪的内核。'
+        : descriptions[state.desktop.state] || '桌面端接入状态暂未确认。');
+    }
+    const currentVersion = state.managedAppServer?.version || null;
+    const selectedVersion = state.managedAppServer?.selectedVersion || null;
+    if (state.managedAppServer) kernelUpdate = { pending: state.managedAppServer.updatePending === true,
+      currentVersion, selectedVersion,
+      command: state.managedAppServer.updatePending ? 'relax kernel-restart --confirm' : null };
+    if (state.running) add('managed-app-server', state.managedAppServer?.state === 'ready' ? 'ok' : 'error',
+      state.managedAppServer?.state === 'ready' ? `Codex 内核已就绪：版本 ${currentVersion || '未知'}。`
+        : `${state.managedAppServer?.error || 'Codex 内核尚未就绪。'} 请执行 relax setup 修复；若提示未安装或未登录 Codex，请先完成安装和登录。`);
+    if (state.managedAppServer?.updatePending) {
+      const versionDetail = currentVersion && selectedVersion && currentVersion === selectedVersion
+        ? `内核版本号未变（${currentVersion}），重启后将使用更新后的安装文件`
+        : `当前内核 ${currentVersion || '未知'}，待应用 ${selectedVersion || '未知'}`;
+      add('managed-app-server-update', 'warning',
+        `Codex 更新待应用：${versionDetail}；执行 relax kernel-restart --confirm 应用更新。`);
+    }
+    if (state.managedAppServer?.launcherRestartRequired) add('managed-app-server-launcher', 'warning',
+      '工作站更新尚未完全生效，请执行 relax setup。');
+  });
+  if (diagnostics) {
+    try { desktopRecovery = await recoveryStatus(paths.stateRoot); }
+    catch (error) { desktopRecovery = { status: 'unknown', error: error.message }; }
+  }
+  await check('skill', async () => {
+    const state = inspectSkill(skillTarget);
+    add('skill', state.managed ? 'ok' : 'warning', state.managed ? '本包管理的 Skill 已安装。'
+      : state.installed ? '存在同名自定义 Skill，本包不会覆盖。' : 'Skill 未安装；重新执行 relax setup。');
+  });
+  return { ready: !checks.some(item => item.status === 'error'), kernelUpdate, checks, ...(diagnostics ? { desktopRecovery, diagnostics: {
+    collectedAt: new Date().toISOString(), platform: process.platform, arch: process.arch, osRelease: os.release(),
+    nodeVersion: process.version, nodeExecutable: process.execPath, serviceRoot: paths.serviceRoot,
+    servicePid: serviceState?.pid || null, port: serviceState?.port || null, serviceVersion: serviceState?.version || null,
+    kernel: serviceState?.managedAppServer ? {
+      version: serviceState.managedAppServer.version || null,
+      executable: serviceState.managedAppServer.executable || null,
+      selectedVersion: serviceState.managedAppServer.selectedVersion || null,
+      preferredExecutable: serviceState.managedAppServer.preferredExecutable || null,
+      selectedSource: serviceState.managedAppServer.source || null,
+    } : null,
+  } } : {}) };
+}
+
+export function formatDoctorOutput(result, detail = false) {
+  const labels = { 'keep-awake': '保持唤醒', installation: '安装文件', 'bridge-runtime': '运行环境', network: '局域网',
+    autostart: '登录自启动', service: '工作站服务', 'managed-app-server': 'Codex 内核',
+    execution: '完整控制', desktop: 'Codex 桌面端', 'package-version': '安装包版本', 'service-version': '服务版本', 'managed-app-server-update': 'Codex 更新',
+    'managed-app-server-launcher': '工作站更新', skill: 'Codex Skill' };
+  const byId = id => result.checks.find(item => item.id === id);
+  const summary = (id, success) => {
+    const item = byId(id);
+    return `${labels[id]}：${!item ? '未检查（工作站服务尚未启动）' : item.status === 'ok' ? success : '异常，见下方处理方法'}`;
+  };
+  const issues = result.checks.filter(item => item.status !== 'ok');
+  const lines = [result.ready ? '工作站检查通过。' : '工作站检查发现问题。',
+    summary('installation', '完整'), summary('package-version', 'CLI 与固定服务一致'), summary('service', '正在运行'), summary('managed-app-server', '已就绪'), summary('execution', '通道已就绪（不代表每个对话均可写）')];
+  if (issues.length) lines.push('', '需要处理或留意：', ...issues.map(item => `- ${labels[item.id] || item.id}：${item.message}`));
+  if (detail) {
+    const info = result.diagnostics || {};
+    lines.unshift('Code Relax 诊断报告（供客服或技术人员排查）', `采集时间：${info.collectedAt || '未知'}`,
+      `系统：${info.platform || process.platform} ${info.arch || process.arch} ${info.osRelease || ''}`,
+      `Node：${info.nodeVersion || process.version}；${info.nodeExecutable || process.execPath}`,
+      `服务目录：${info.serviceRoot || '未知'}`, `服务进程：${info.servicePid || '未运行'}；端口：${info.port || '未知'}`, '');
+    lines.push('', '检查详情：', ...result.checks.filter(item => item.status === 'ok').map(item => `- ${labels[item.id] || item.id}：${item.message}`));
+    if (info.kernel) lines.push('',
+      `运行内核：${info.kernel.version || '未知'}；${info.kernel.executable || '路径未知'}`,
+      `候选内核：${info.kernel.selectedVersion || '未知'}；来源 ${info.kernel.selectedSource || '未知'}；${info.kernel.preferredExecutable || '路径未知'}`);
+    const recovery = result.desktopRecovery;
+    if (recovery && !['none', 'unsupported'].includes(recovery.status)) {
+      const status = { failed: '未完成', completed: '已完成', succeeded: '已完成', running: '进行中', unknown: '无法读取' }[recovery.status] || recovery.status;
+      lines.push('', `Desktop 接入排障记录（仅用于排查上次接入，不代表当前服务状态）：上次 Codex Desktop 接入${status}。`);
+      if (recovery.error) lines.push(`记录原因：${recovery.error}`);
+    }
+  }
+  lines.push('', result.ready ? '添加手机：运行 relax pair 生成配对二维码。' : '按上述方法处理后，再运行 relax doctor。');
+  return lines.join('\n');
+}

package/dist/src/service-install.mjs

@@ -1,97 +1,97 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { randomUUID } from 'node:crypto';
-import { execFile } from 'node:child_process';
-import { promisify } from 'node:util';
-import { readRecord, writeRecord } from './service-lifecycle.mjs';
-import { assertPlainPath } from './skill-install.mjs';
-
-const exec = promisify(execFile);
-export function packageRoot(from) {
-  let directory = path.resolve(from);
-  while (true) {
-    if (readRecord(path.join(directory, 'package.json'))?.name === '@walkhi/code-relax') return directory;
-    const parent = path.dirname(directory);
-    if (parent === directory) throw new Error('找不到 Code Relax 安装包。');
-    directory = parent;
-  }
-}
-
-export async function installService(source, target, executable, stateRoot, hooks = {}) {
-  assertPlainPath(target);
-  if (!fs.existsSync(path.join(source, 'dist/bin/codex-remote.mjs'))) throw new Error('缺少发布构建；源码目录请先执行 npm run build。');
-  const build = readRecord(path.join(source, 'dist/build-platform.json'));
-  if (build?.platform !== process.platform || build?.arch !== process.arch)
-    throw new Error('构建产物与本机系统或 CPU 不匹配，请在目标工作站安装依赖并重新构建。');
-  if (!fs.existsSync(path.join(source, 'node_modules'))) throw new Error('缺少包依赖，请重新安装完整 npm 包。');
-  const parent = path.dirname(target);
-  fs.mkdirSync(parent, { recursive: true });
-  const stage = path.join(parent, `service-stage-${randomUUID()}`);
-  const backup = path.join(parent, `service-backup-${randomUUID()}`);
-  fs.mkdirSync(stage);
-  try {
-    for (const name of ['dist', 'node_modules', 'package.json', 'README.md']) {
-      fs.cpSync(path.join(source, name), path.join(stage, name), { recursive: true });
-    }
-    await exec(executable, [path.join(stage, 'dist/bin/codex-remote.mjs'), '--help'], { windowsHide: true });
-    await exec(executable, ['-e', 'const r=require("node:module").createRequire(process.argv[1]); r("sharp"); r("qrcode"); r("ws"); r("node-datachannel");', path.join(stage, 'package.json')], { windowsHide: true });
-    const previousInstallation = readRecord(path.join(target, 'installation.json'));
-    const npmCliPath = process.env.npm_execpath || previousInstallation?.npmCliPath;
-    const npmPrefix = process.env.npm_config_prefix || previousInstallation?.npmPrefix;
-    writeRecord(path.join(stage, 'installation.json'), {
-      npmCliPath: npmCliPath && path.isAbsolute(npmCliPath) && fs.existsSync(npmCliPath) ? fs.realpathSync(npmCliPath) : null,
-      npmPrefix: npmPrefix && path.isAbsolute(npmPrefix) ? npmPrefix : null,
-      installedAt: new Date().toISOString(), source, nodeExecutable: executable, stateRoot,
-      version: readRecord(path.join(source, 'package.json')).version });
-    const previous = fs.existsSync(target);
-    let previousMoved = false, activated = false;
-    try {
-      await hooks.beforeActivate?.();
-      if (previous) { fs.renameSync(target, backup); previousMoved = true; }
-      fs.renameSync(stage, target); activated = true;
-      await hooks.verifyActivation?.({ serviceRoot: target, nodeExecutable: executable,
-        version: readRecord(path.join(target, 'package.json')).version });
-    } catch (error) {
-      try {
-        if (activated && fs.existsSync(target)) fs.rmSync(target, { recursive: true });
-        if (previousMoved) fs.renameSync(backup, target);
-        await hooks.restoreActivation?.();
-      } catch (restoreError) {
-        throw new AggregateError([error, restoreError], `服务更新失败，旧版本恢复也未完成：${restoreError.message}`);
-      }
-      throw error;
-    }
-    if (previous) {
-      if (path.dirname(backup) !== parent || !path.basename(backup).startsWith('service-backup-')) throw new Error('Invalid backup path');
-      fs.rmSync(backup, { recursive: true });
-    }
-    return { serviceRoot: target, nodeExecutable: executable, version: readRecord(path.join(target, 'package.json')).version };
-  } finally {
-    // Only this invocation's generated sibling stage may be cleaned up.
-    if (path.dirname(stage) !== parent || !path.basename(stage).startsWith('service-stage-')) throw new Error('Invalid stage path');
-    fs.rmSync(stage, { recursive: true, force: true });
-  }
-}
-
-export async function uninstallService({ serviceRoot, stateRoot, uploadsRoot, credentialsRoot }, service, beforeRemove = async () => {}) {
-  const target = path.resolve(serviceRoot);
-  assertPlainPath(target);
-  if (path.basename(target) !== 'service' || path.basename(path.dirname(target)) !== 'CodexRemote') throw new Error('拒绝删除未识别的服务目录。');
-  const preserved = [stateRoot, uploadsRoot, credentialsRoot].filter(Boolean);
-  for (const data of preserved) {
-    const relative = path.relative(target, path.resolve(data));
-    if (!relative || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative))) throw new Error('服务目录包含用户数据，拒绝删除。');
-  }
-  if (!fs.existsSync(target)) {
-    await service.stop();
-    await beforeRemove();
-    return { removed: false, serviceRoot: target, preserved };
-  }
-  const pkg = readRecord(path.join(target, 'package.json'));
-  const record = readRecord(path.join(target, 'installation.json'));
-  if (pkg?.name !== '@walkhi/code-relax' || !record?.installedAt || !record?.nodeExecutable) throw new Error('缺少有效安装记录，未删除服务目录。');
-  await service.stop();
-  await beforeRemove();
-  fs.rmSync(target, { recursive: true });
-  return { removed: true, serviceRoot: target, preserved };
-}
+import fs from 'node:fs';
+import path from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { readRecord, writeRecord } from './service-lifecycle.mjs';
+import { assertPlainPath } from './skill-install.mjs';
+
+const exec = promisify(execFile);
+export function packageRoot(from) {
+  let directory = path.resolve(from);
+  while (true) {
+    if (readRecord(path.join(directory, 'package.json'))?.name === '@walkhi/code-relax') return directory;
+    const parent = path.dirname(directory);
+    if (parent === directory) throw new Error('找不到 Code Relax 安装包。');
+    directory = parent;
+  }
+}
+
+export async function installService(source, target, executable, stateRoot, hooks = {}) {
+  assertPlainPath(target);
+  if (!fs.existsSync(path.join(source, 'dist/bin/codex-remote.mjs'))) throw new Error('缺少发布构建；源码目录请先执行 npm run build。');
+  const build = readRecord(path.join(source, 'dist/build-platform.json'));
+  if (build?.platform !== process.platform || build?.arch !== process.arch)
+    throw new Error('构建产物与本机系统或 CPU 不匹配，请在目标工作站安装依赖并重新构建。');
+  if (!fs.existsSync(path.join(source, 'node_modules'))) throw new Error('缺少包依赖，请重新安装完整 npm 包。');
+  const parent = path.dirname(target);
+  fs.mkdirSync(parent, { recursive: true });
+  const stage = path.join(parent, `service-stage-${randomUUID()}`);
+  const backup = path.join(parent, `service-backup-${randomUUID()}`);
+  fs.mkdirSync(stage);
+  try {
+    for (const name of ['dist', 'node_modules', 'package.json', 'README.md']) {
+      fs.cpSync(path.join(source, name), path.join(stage, name), { recursive: true });
+    }
+    await exec(executable, [path.join(stage, 'dist/bin/codex-remote.mjs'), '--help'], { windowsHide: true });
+    await exec(executable, ['-e', 'const r=require("node:module").createRequire(process.argv[1]); r("sharp"); r("qrcode"); r("ws"); r("node-datachannel");', path.join(stage, 'package.json')], { windowsHide: true });
+    const previousInstallation = readRecord(path.join(target, 'installation.json'));
+    const npmCliPath = process.env.npm_execpath || previousInstallation?.npmCliPath;
+    const npmPrefix = process.env.npm_config_prefix || previousInstallation?.npmPrefix;
+    writeRecord(path.join(stage, 'installation.json'), {
+      npmCliPath: npmCliPath && path.isAbsolute(npmCliPath) && fs.existsSync(npmCliPath) ? fs.realpathSync(npmCliPath) : null,
+      npmPrefix: npmPrefix && path.isAbsolute(npmPrefix) ? npmPrefix : null,
+      installedAt: new Date().toISOString(), source, nodeExecutable: executable, stateRoot,
+      version: readRecord(path.join(source, 'package.json')).version });
+    const previous = fs.existsSync(target);
+    let previousMoved = false, activated = false;
+    try {
+      await hooks.beforeActivate?.();
+      if (previous) { fs.renameSync(target, backup); previousMoved = true; }
+      fs.renameSync(stage, target); activated = true;
+      await hooks.verifyActivation?.({ serviceRoot: target, nodeExecutable: executable,
+        version: readRecord(path.join(target, 'package.json')).version });
+    } catch (error) {
+      try {
+        if (activated && fs.existsSync(target)) fs.rmSync(target, { recursive: true });
+        if (previousMoved) fs.renameSync(backup, target);
+        await hooks.restoreActivation?.();
+      } catch (restoreError) {
+        throw new AggregateError([error, restoreError], `服务更新失败，旧版本恢复也未完成：${restoreError.message}`);
+      }
+      throw error;
+    }
+    if (previous) {
+      if (path.dirname(backup) !== parent || !path.basename(backup).startsWith('service-backup-')) throw new Error('Invalid backup path');
+      fs.rmSync(backup, { recursive: true });
+    }
+    return { serviceRoot: target, nodeExecutable: executable, version: readRecord(path.join(target, 'package.json')).version };
+  } finally {
+    // Only this invocation's generated sibling stage may be cleaned up.
+    if (path.dirname(stage) !== parent || !path.basename(stage).startsWith('service-stage-')) throw new Error('Invalid stage path');
+    fs.rmSync(stage, { recursive: true, force: true });
+  }
+}
+
+export async function uninstallService({ serviceRoot, stateRoot, uploadsRoot, credentialsRoot }, service, beforeRemove = async () => {}) {
+  const target = path.resolve(serviceRoot);
+  assertPlainPath(target);
+  if (path.basename(target) !== 'service' || path.basename(path.dirname(target)) !== 'CodexRemote') throw new Error('拒绝删除未识别的服务目录。');
+  const preserved = [stateRoot, uploadsRoot, credentialsRoot].filter(Boolean);
+  for (const data of preserved) {
+    const relative = path.relative(target, path.resolve(data));
+    if (!relative || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative))) throw new Error('服务目录包含用户数据，拒绝删除。');
+  }
+  if (!fs.existsSync(target)) {
+    await service.stop();
+    await beforeRemove();
+    return { removed: false, serviceRoot: target, preserved };
+  }
+  const pkg = readRecord(path.join(target, 'package.json'));
+  const record = readRecord(path.join(target, 'installation.json'));
+  if (pkg?.name !== '@walkhi/code-relax' || !record?.installedAt || !record?.nodeExecutable) throw new Error('缺少有效安装记录，未删除服务目录。');
+  await service.stop();
+  await beforeRemove();
+  fs.rmSync(target, { recursive: true });
+  return { removed: true, serviceRoot: target, preserved };
+}