@walkhi/code-relax 0.1.0-beta.68 → 0.1.0-beta.69

package/dist/src/service-power.mjs

@@ -1,58 +1,58 @@
-import path from 'node:path';
-import { readRecord, writeRecord } from './service-lifecycle.mjs';
-import { launchPowerInhibitor } from './platform/power-inhibitor.mjs';
-
-export const powerConfigPath = stateRoot => path.join(stateRoot, 'keep-awake.json');
-export const powerEnabled = stateRoot => readRecord(powerConfigPath(stateRoot))?.enabled !== false;
-
-export function createPowerManager(stateRoot, { launch = launchPowerInhibitor, report = console.error } = {}) {
-  let enabled = powerEnabled(stateRoot), active = false, error = '', child = null, closed, stopping = false;
-  let queue = Promise.resolve();
-  const snapshot = () => ({ enabled, active, error });
-  async function release() {
-    if (!child) return;
-    stopping = true;
-    child.stdin.end();
-    await closed;
-  }
-  async function acquire() {
-    if (child || !enabled) return;
-    error = '';
-    try {
-      const process = launch();
-      stopping = false;
-      child = process;
-      let stderr = '', output = '';
-      process.stderr.on('data', data => { stderr = (stderr + data).slice(-2048); });
-      process.stdin.on('error', cause => { if (cause.code !== 'EPIPE') report(`保持唤醒通道异常：${cause.message}`); });
-      closed = new Promise(resolve => process.once('close', code => {
-        if (active && !stopping) { error = stderr.trim() || `保持唤醒进程意外退出（${code}）`; report(error); }
-        child = null; active = false; resolve();
-      }));
-      await new Promise((resolve, reject) => {
-        const timer = setTimeout(() => { process.kill(); reject(new Error('保持唤醒申请超时')); }, 8000);
-        const finish = cause => { clearTimeout(timer); cause ? reject(cause) : resolve(); };
-        process.once('error', finish);
-        process.once('close', code => {
-          finish(new Error(stderr.trim() || `保持唤醒进程已退出（${code}）`));
-        });
-        process.stdout.on('data', data => {
-          output += data;
-          if (output.includes('ready\n') || output.includes('ready\r\n')) { active = true; finish(); }
-        });
-      });
-    } catch (cause) { error = cause.message; report(`保持唤醒未生效：${error}`); }
-  }
-  const serial = task => { const result = queue.then(task); queue = result.catch(() => {}); return result; };
-  return {
-    snapshot,
-    start: () => serial(async () => { await acquire(); return snapshot(); }),
-    setEnabled: value => serial(async () => {
-      writeRecord(powerConfigPath(stateRoot), { enabled: value });
-      enabled = value;
-      if (enabled) await acquire(); else { await release(); error = ''; }
-      return snapshot();
-    }),
-    close: () => serial(async () => { enabled = false; await release(); }),
-  };
-}
+import path from 'node:path';
+import { readRecord, writeRecord } from './service-lifecycle.mjs';
+import { launchPowerInhibitor } from './platform/power-inhibitor.mjs';
+
+export const powerConfigPath = stateRoot => path.join(stateRoot, 'keep-awake.json');
+export const powerEnabled = stateRoot => readRecord(powerConfigPath(stateRoot))?.enabled !== false;
+
+export function createPowerManager(stateRoot, { launch = launchPowerInhibitor, report = console.error } = {}) {
+  let enabled = powerEnabled(stateRoot), active = false, error = '', child = null, closed, stopping = false;
+  let queue = Promise.resolve();
+  const snapshot = () => ({ enabled, active, error });
+  async function release() {
+    if (!child) return;
+    stopping = true;
+    child.stdin.end();
+    await closed;
+  }
+  async function acquire() {
+    if (child || !enabled) return;
+    error = '';
+    try {
+      const process = launch();
+      stopping = false;
+      child = process;
+      let stderr = '', output = '';
+      process.stderr.on('data', data => { stderr = (stderr + data).slice(-2048); });
+      process.stdin.on('error', cause => { if (cause.code !== 'EPIPE') report(`保持唤醒通道异常：${cause.message}`); });
+      closed = new Promise(resolve => process.once('close', code => {
+        if (active && !stopping) { error = stderr.trim() || `保持唤醒进程意外退出（${code}）`; report(error); }
+        child = null; active = false; resolve();
+      }));
+      await new Promise((resolve, reject) => {
+        const timer = setTimeout(() => { process.kill(); reject(new Error('保持唤醒申请超时')); }, 8000);
+        const finish = cause => { clearTimeout(timer); cause ? reject(cause) : resolve(); };
+        process.once('error', finish);
+        process.once('close', code => {
+          finish(new Error(stderr.trim() || `保持唤醒进程已退出（${code}）`));
+        });
+        process.stdout.on('data', data => {
+          output += data;
+          if (output.includes('ready\n') || output.includes('ready\r\n')) { active = true; finish(); }
+        });
+      });
+    } catch (cause) { error = cause.message; report(`保持唤醒未生效：${error}`); }
+  }
+  const serial = task => { const result = queue.then(task); queue = result.catch(() => {}); return result; };
+  return {
+    snapshot,
+    start: () => serial(async () => { await acquire(); return snapshot(); }),
+    setEnabled: value => serial(async () => {
+      writeRecord(powerConfigPath(stateRoot), { enabled: value });
+      enabled = value;
+      if (enabled) await acquire(); else { await release(); error = ''; }
+      return snapshot();
+    }),
+    close: () => serial(async () => { enabled = false; await release(); }),
+  };
+}

package/dist/src/service-restart.mjs

@@ -1,81 +1,81 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { randomUUID } from 'node:crypto';
-import { fileURLToPath } from 'node:url';
-import { setTimeout as delay } from 'node:timers/promises';
-import { startBackground } from './background-process.mjs';
-import { lifecycle, readRecord, writeRecord } from './service-lifecycle.mjs';
-import * as host from './platform/service-host.mjs';
-import { desktopHost } from './platform/desktop-host.mjs';
-
-const script = fileURLToPath(import.meta.url);
-const sameProcess = (expected, actual) => expected && actual && expected.pid === actual.pid &&
-  expected.created === actual.created && expected.executable === actual.executable;
-async function processIdentity(pid) {
-  const current = await desktopHost.process(pid);
-  return current ? { pid: current.pid, created: current.created, executable: current.executable } : null;
-}
-
-export async function requestServiceRestart(stateRoot) {
-  const lock = path.join(stateRoot, 'service-restart.lock');
-  const operationId = randomUUID();
-  const owner = await processIdentity(process.pid);
-  if (!owner) throw new Error('无法确认桌面服务重启请求进程。');
-  const previous = readRecord(lock);
-  if (previous) {
-    const actual = previous.owner?.pid ? await processIdentity(previous.owner.pid) : null;
-    if (sameProcess(previous.owner, actual) || readRecord(lock)?.operationId !== previous.operationId) {
-      throw new Error('桌面服务已在重启中。');
-    }
-    fs.rmSync(lock);
-  }
-  const temporary = `${lock}.${operationId}.tmp`;
-  try {
-    fs.writeFileSync(temporary, JSON.stringify({ operationId, owner, requestedAt: new Date().toISOString() }),
-      { flag: 'wx', mode: 0o600 });
-    // Publish a complete record exclusively; a crash cannot leave a half-written lock.
-    fs.linkSync(temporary, lock);
-  } catch (error) {
-    if (error.code === 'EEXIST') throw new Error('桌面服务已在重启中。');
-    throw error;
-  } finally { fs.rmSync(temporary, { force: true }); }
-  try {
-    const log = path.join(stateRoot, 'service-restart.log');
-    const pid = await startBackground(process.execPath, [script, '--worker', stateRoot, operationId], process.env, [log, log]);
-    const worker = await processIdentity(pid);
-    if (!worker) throw new Error('桌面服务重启进程未启动。');
-    const current = readRecord(lock);
-    if (current?.operationId !== operationId) throw new Error('桌面服务重启实例已失效。');
-    writeRecord(lock, { ...current, owner: worker });
-    return { operationId, status: 'scheduled', message: '桌面服务重启已安排。' };
-  } catch (error) {
-    const current = readRecord(lock);
-    if (current?.operationId === operationId && sameProcess(current.owner, owner)) fs.rmSync(lock, { force: true });
-    throw error;
-  }
-}
-
-async function run(stateRoot, operationId) {
-  const lock = path.join(stateRoot, 'service-restart.lock');
-  try {
-    const deadline = Date.now() + 30000;
-    while (true) {
-      const record = readRecord(lock);
-      if (record?.operationId !== operationId) throw new Error('桌面服务重启实例已失效。');
-      if (record.owner?.pid === process.pid) break;
-      if (Date.now() >= deadline) throw new Error('桌面服务重启进程交接超时。');
-      await delay(100);
-    }
-    const service = lifecycle({ stateRoot, host });
-    await delay(1000);
-    await service.stop();
-    await service.start();
-  } finally {
-    if (readRecord(lock)?.operationId === operationId) fs.rmSync(lock, { force: true });
-  }
-}
-
-if (process.argv[1] && path.resolve(process.argv[1]) === script && process.argv[2] === '--worker') {
-  const [stateRoot, operationId] = process.argv.slice(3);
-  run(stateRoot, operationId).catch(error => { console.error(error.message); process.exitCode = 1; });
-}
+import fs from 'node:fs';
+import path from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { fileURLToPath } from 'node:url';
+import { setTimeout as delay } from 'node:timers/promises';
+import { startBackground } from './background-process.mjs';
+import { lifecycle, readRecord, writeRecord } from './service-lifecycle.mjs';
+import * as host from './platform/service-host.mjs';
+import { desktopHost } from './platform/desktop-host.mjs';
+
+const script = fileURLToPath(import.meta.url);
+const sameProcess = (expected, actual) => expected && actual && expected.pid === actual.pid &&
+  expected.created === actual.created && expected.executable === actual.executable;
+async function processIdentity(pid) {
+  const current = await desktopHost.process(pid);
+  return current ? { pid: current.pid, created: current.created, executable: current.executable } : null;
+}
+
+export async function requestServiceRestart(stateRoot) {
+  const lock = path.join(stateRoot, 'service-restart.lock');
+  const operationId = randomUUID();
+  const owner = await processIdentity(process.pid);
+  if (!owner) throw new Error('无法确认桌面服务重启请求进程。');
+  const previous = readRecord(lock);
+  if (previous) {
+    const actual = previous.owner?.pid ? await processIdentity(previous.owner.pid) : null;
+    if (sameProcess(previous.owner, actual) || readRecord(lock)?.operationId !== previous.operationId) {
+      throw new Error('桌面服务已在重启中。');
+    }
+    fs.rmSync(lock);
+  }
+  const temporary = `${lock}.${operationId}.tmp`;
+  try {
+    fs.writeFileSync(temporary, JSON.stringify({ operationId, owner, requestedAt: new Date().toISOString() }),
+      { flag: 'wx', mode: 0o600 });
+    // Publish a complete record exclusively; a crash cannot leave a half-written lock.
+    fs.linkSync(temporary, lock);
+  } catch (error) {
+    if (error.code === 'EEXIST') throw new Error('桌面服务已在重启中。');
+    throw error;
+  } finally { fs.rmSync(temporary, { force: true }); }
+  try {
+    const log = path.join(stateRoot, 'service-restart.log');
+    const pid = await startBackground(process.execPath, [script, '--worker', stateRoot, operationId], process.env, [log, log]);
+    const worker = await processIdentity(pid);
+    if (!worker) throw new Error('桌面服务重启进程未启动。');
+    const current = readRecord(lock);
+    if (current?.operationId !== operationId) throw new Error('桌面服务重启实例已失效。');
+    writeRecord(lock, { ...current, owner: worker });
+    return { operationId, status: 'scheduled', message: '桌面服务重启已安排。' };
+  } catch (error) {
+    const current = readRecord(lock);
+    if (current?.operationId === operationId && sameProcess(current.owner, owner)) fs.rmSync(lock, { force: true });
+    throw error;
+  }
+}
+
+async function run(stateRoot, operationId) {
+  const lock = path.join(stateRoot, 'service-restart.lock');
+  try {
+    const deadline = Date.now() + 30000;
+    while (true) {
+      const record = readRecord(lock);
+      if (record?.operationId !== operationId) throw new Error('桌面服务重启实例已失效。');
+      if (record.owner?.pid === process.pid) break;
+      if (Date.now() >= deadline) throw new Error('桌面服务重启进程交接超时。');
+      await delay(100);
+    }
+    const service = lifecycle({ stateRoot, host });
+    await delay(1000);
+    await service.stop();
+    await service.start();
+  } finally {
+    if (readRecord(lock)?.operationId === operationId) fs.rmSync(lock, { force: true });
+  }
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === script && process.argv[2] === '--worker') {
+  const [stateRoot, operationId] = process.argv.slice(3);
+  run(stateRoot, operationId).catch(error => { console.error(error.message); process.exitCode = 1; });
+}

package/dist/src/service-update-worker.mjs

@@ -1,42 +1,42 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { spawn } from 'node:child_process';
-import { setTimeout as delay } from 'node:timers/promises';
-
-// Copied outside both npm and service directories before launch. Builtins only.
-const jobFile = process.argv[2];
-const job = JSON.parse(fs.readFileSync(jobFile, 'utf8'));
-process.chdir(path.dirname(jobFile));
-const read = () => JSON.parse(fs.readFileSync(job.statusFile, 'utf8'));
-function update(values) {
-  const current = read();
-  if (current.operationId !== job.operationId) throw new Error('更新操作已被替换');
-  const temporary = `${job.statusFile}.${process.pid}.tmp`;
-  fs.writeFileSync(temporary, JSON.stringify({ ...current, ...values }), { mode: 0o600 });
-  fs.renameSync(temporary, job.statusFile);
-}
-try {
-  const deadline = Date.now() + 30000;
-  while (read().owner?.pid !== process.pid) {
-    if (Date.now() >= deadline) throw new Error('独立更新进程交接超时');
-    await delay(100);
-  }
-  await delay(1500);
-  update({ status: 'running', startedAt: new Date().toISOString() });
-  const args = [job.npmCliPath, 'install', '--global', `@walkhi/code-relax@${job.targetVersion}`,
-    '--foreground-scripts', '--allow-scripts=@walkhi/code-relax,node-datachannel,sharp', '--registry=https://registry.npmjs.org'];
-  if (job.npmPrefix) args.push('--prefix', job.npmPrefix);
-  const child = spawn(job.nodeExecutable, args, { cwd: path.dirname(jobFile), windowsHide: true,
-    stdio: ['ignore', 'inherit', 'inherit'] });
-  const code = await new Promise((resolve, reject) => {
-    child.once('error', reject); child.once('exit', (code, signal) => resolve(code ?? `signal ${signal}`));
-  });
-  if (code !== 0) throw new Error(`npm 安装失败（${code}），请查看桌面服务更新日志。`);
-  const installed = JSON.parse(fs.readFileSync(path.join(job.serviceRoot, 'installation.json'), 'utf8'));
-  if (installed.version !== job.targetVersion) throw new Error('安装结束，但桌面服务版本与目标版本不一致。');
-  update({ status: 'completed', finishedAt: new Date().toISOString(), installedVersion: installed.version });
-} catch (error) {
-  console.error(error.stack || error.message);
-  update({ status: 'failed', finishedAt: new Date().toISOString(), error: error.message });
-  process.exitCode = 1;
-}
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+import { setTimeout as delay } from 'node:timers/promises';
+
+// Copied outside both npm and service directories before launch. Builtins only.
+const jobFile = process.argv[2];
+const job = JSON.parse(fs.readFileSync(jobFile, 'utf8'));
+process.chdir(path.dirname(jobFile));
+const read = () => JSON.parse(fs.readFileSync(job.statusFile, 'utf8'));
+function update(values) {
+  const current = read();
+  if (current.operationId !== job.operationId) throw new Error('更新操作已被替换');
+  const temporary = `${job.statusFile}.${process.pid}.tmp`;
+  fs.writeFileSync(temporary, JSON.stringify({ ...current, ...values }), { mode: 0o600 });
+  fs.renameSync(temporary, job.statusFile);
+}
+try {
+  const deadline = Date.now() + 30000;
+  while (read().owner?.pid !== process.pid) {
+    if (Date.now() >= deadline) throw new Error('独立更新进程交接超时');
+    await delay(100);
+  }
+  await delay(1500);
+  update({ status: 'running', startedAt: new Date().toISOString() });
+  const args = [job.npmCliPath, 'install', '--global', `@walkhi/code-relax@${job.targetVersion}`,
+    '--foreground-scripts', '--allow-scripts=@walkhi/code-relax,node-datachannel,sharp', '--registry=https://registry.npmjs.org'];
+  if (job.npmPrefix) args.push('--prefix', job.npmPrefix);
+  const child = spawn(job.nodeExecutable, args, { cwd: path.dirname(jobFile), windowsHide: true,
+    stdio: ['ignore', 'inherit', 'inherit'] });
+  const code = await new Promise((resolve, reject) => {
+    child.once('error', reject); child.once('exit', (code, signal) => resolve(code ?? `signal ${signal}`));
+  });
+  if (code !== 0) throw new Error(`npm 安装失败（${code}），请查看桌面服务更新日志。`);
+  const installed = JSON.parse(fs.readFileSync(path.join(job.serviceRoot, 'installation.json'), 'utf8'));
+  if (installed.version !== job.targetVersion) throw new Error('安装结束，但桌面服务版本与目标版本不一致。');
+  update({ status: 'completed', finishedAt: new Date().toISOString(), installedVersion: installed.version });
+} catch (error) {
+  console.error(error.stack || error.message);
+  update({ status: 'failed', finishedAt: new Date().toISOString(), error: error.message });
+  process.exitCode = 1;
+}

package/dist/src/service-update.mjs

@@ -1,80 +1,80 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { startBackground } from './background-process.mjs';
-import { readRecord, writeRecord } from './service-lifecycle.mjs';
-import { runtimePaths } from './platform/runtime-paths.mjs';
-import { desktopHost } from './platform/desktop-host.mjs';
-import releaseVersion from '../shared/release-version.cjs';
-
-const versionPattern = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/;
-const statusPath = root => path.join(root, 'service-update.json');
-const installation = () => readRecord(path.join(runtimePaths().serviceRoot, 'installation.json'));
-export function publicUpdateOperation(record, installedVersion) {
-  if (!record) return null;
-  return { operationId: record.operationId, targetVersion: record.targetVersion,
-    status: record.status, targetInstalled: Boolean(installedVersion && installedVersion === record.targetVersion),
-    error: record.status === 'failed' ? '上次更新未完整完成，请查看桌面服务更新日志。' : null,
-    installedVersion: record.installedVersion || null };
-}
-export function serviceUpdateStatus(root) {
-  const record = readRecord(statusPath(root));
-  const installed = installation();
-  return { supported: Boolean(installed?.npmCliPath && fs.existsSync(installed.npmCliPath)),
-    currentVersion: installed?.version || null,
-    operation: publicUpdateOperation(record, installed?.version) };
-}
-export async function checkServiceUpdate(root) {
-  const result = await fetch('https://registry.npmjs.org/@walkhi%2fcode-relax/latest', { signal: AbortSignal.timeout(12000) });
-  if (!result.ok) throw new Error(`查询桌面服务版本失败：HTTP ${result.status}`);
-  const latest = await result.json();
-  if (!versionPattern.test(latest.version || '') || releaseVersion.compare(latest.version, latest.version) !== 0) throw new Error('npm 返回的版本号无效');
-  const status = serviceUpdateStatus(root);
-  return { ...status, latestVersion: latest.version,
-    updateAvailable: releaseVersion.compare(latest.version, status.currentVersion) > 0 };
-}
-let scheduling = false;
-export async function requestServiceUpdate(root, body) {
-  if (body.confirmed !== true || !/^[0-9a-f-]{36}$/i.test(body.operationId || '') || !versionPattern.test(body.targetVersion || '')) {
-    throw new Error('请确认桌面服务更新及目标版本后再继续。');
-  }
-  if (scheduling) throw new Error('桌面服务更新正在安排。');
-  scheduling = true;
-  try {
-    const previous = readRecord(statusPath(root));
-    if (previous?.operationId === body.operationId) return serviceUpdateStatus(root);
-    if (previous && ['scheduled', 'running'].includes(previous.status)) {
-      const actual = previous.owner?.pid ? await desktopHost.process(previous.owner.pid) : null;
-      if (actual && actual.created === previous.owner.created && actual.executable === previous.owner.executable) {
-        throw new Error('桌面服务已有更新正在执行。');
-      }
-      writeRecord(statusPath(root), { ...previous, status: 'failed', error: '更新进程已退出，未确认安装完成。' });
-    }
-    const latest = await checkServiceUpdate(root);
-    if (!latest.supported) throw new Error('当前安装缺少 npm 路径，请先安装支持手机更新的过渡版。');
-    if (latest.latestVersion !== body.targetVersion) throw new Error('最新版本已变化，请重新检查后确认。');
-    if (!latest.updateAvailable) throw new Error('没有高于当前安装版本的桌面服务更新。');
-    const installed = installation();
-    const directory = path.join(root, 'service-updates', body.operationId);
-    fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
-    const worker = path.join(directory, 'worker.mjs');
-    fs.copyFileSync(fileURLToPath(new URL('./service-update-worker.mjs', import.meta.url)), worker);
-    const jobFile = path.join(directory, 'job.json');
-    writeRecord(jobFile, { ...body, statusFile: statusPath(root), npmCliPath: installed.npmCliPath,
-      npmPrefix: installed.npmPrefix, nodeExecutable: installed.nodeExecutable, serviceRoot: runtimePaths().serviceRoot });
-    writeRecord(statusPath(root), { operationId: body.operationId, targetVersion: body.targetVersion,
-      status: 'scheduled', requestedAt: new Date().toISOString() });
-    try {
-      const log = path.join(directory, 'update.log');
-      const pid = await startBackground(installed.nodeExecutable, [worker, jobFile], process.env, [log, log]);
-      const owner = await desktopHost.process(pid);
-      if (!owner) throw new Error('独立更新进程未启动。');
-      writeRecord(statusPath(root), { ...readRecord(statusPath(root)), owner: {
-        pid: owner.pid, created: owner.created, executable: owner.executable } });
-    } catch (error) {
-      writeRecord(statusPath(root), { ...readRecord(statusPath(root)), status: 'failed', error: error.message });
-      throw new Error('桌面服务更新启动未完成，请查看桌面服务更新日志；结果确认前不要重复提交。');
-    }
-    return serviceUpdateStatus(root);
-  } finally { scheduling = false; }
-}
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { startBackground } from './background-process.mjs';
+import { readRecord, writeRecord } from './service-lifecycle.mjs';
+import { runtimePaths } from './platform/runtime-paths.mjs';
+import { desktopHost } from './platform/desktop-host.mjs';
+import releaseVersion from '../shared/release-version.cjs';
+
+const versionPattern = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/;
+const statusPath = root => path.join(root, 'service-update.json');
+const installation = () => readRecord(path.join(runtimePaths().serviceRoot, 'installation.json'));
+export function publicUpdateOperation(record, installedVersion) {
+  if (!record) return null;
+  return { operationId: record.operationId, targetVersion: record.targetVersion,
+    status: record.status, targetInstalled: Boolean(installedVersion && installedVersion === record.targetVersion),
+    error: record.status === 'failed' ? '上次更新未完整完成，请查看桌面服务更新日志。' : null,
+    installedVersion: record.installedVersion || null };
+}
+export function serviceUpdateStatus(root) {
+  const record = readRecord(statusPath(root));
+  const installed = installation();
+  return { supported: Boolean(installed?.npmCliPath && fs.existsSync(installed.npmCliPath)),
+    currentVersion: installed?.version || null,
+    operation: publicUpdateOperation(record, installed?.version) };
+}
+export async function checkServiceUpdate(root) {
+  const result = await fetch('https://registry.npmjs.org/@walkhi%2fcode-relax/latest', { signal: AbortSignal.timeout(12000) });
+  if (!result.ok) throw new Error(`查询桌面服务版本失败：HTTP ${result.status}`);
+  const latest = await result.json();
+  if (!versionPattern.test(latest.version || '') || releaseVersion.compare(latest.version, latest.version) !== 0) throw new Error('npm 返回的版本号无效');
+  const status = serviceUpdateStatus(root);
+  return { ...status, latestVersion: latest.version,
+    updateAvailable: releaseVersion.compare(latest.version, status.currentVersion) > 0 };
+}
+let scheduling = false;
+export async function requestServiceUpdate(root, body) {
+  if (body.confirmed !== true || !/^[0-9a-f-]{36}$/i.test(body.operationId || '') || !versionPattern.test(body.targetVersion || '')) {
+    throw new Error('请确认桌面服务更新及目标版本后再继续。');
+  }
+  if (scheduling) throw new Error('桌面服务更新正在安排。');
+  scheduling = true;
+  try {
+    const previous = readRecord(statusPath(root));
+    if (previous?.operationId === body.operationId) return serviceUpdateStatus(root);
+    if (previous && ['scheduled', 'running'].includes(previous.status)) {
+      const actual = previous.owner?.pid ? await desktopHost.process(previous.owner.pid) : null;
+      if (actual && actual.created === previous.owner.created && actual.executable === previous.owner.executable) {
+        throw new Error('桌面服务已有更新正在执行。');
+      }
+      writeRecord(statusPath(root), { ...previous, status: 'failed', error: '更新进程已退出，未确认安装完成。' });
+    }
+    const latest = await checkServiceUpdate(root);
+    if (!latest.supported) throw new Error('当前安装缺少 npm 路径，请先安装支持手机更新的过渡版。');
+    if (latest.latestVersion !== body.targetVersion) throw new Error('最新版本已变化，请重新检查后确认。');
+    if (!latest.updateAvailable) throw new Error('没有高于当前安装版本的桌面服务更新。');
+    const installed = installation();
+    const directory = path.join(root, 'service-updates', body.operationId);
+    fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
+    const worker = path.join(directory, 'worker.mjs');
+    fs.copyFileSync(fileURLToPath(new URL('./service-update-worker.mjs', import.meta.url)), worker);
+    const jobFile = path.join(directory, 'job.json');
+    writeRecord(jobFile, { ...body, statusFile: statusPath(root), npmCliPath: installed.npmCliPath,
+      npmPrefix: installed.npmPrefix, nodeExecutable: installed.nodeExecutable, serviceRoot: runtimePaths().serviceRoot });
+    writeRecord(statusPath(root), { operationId: body.operationId, targetVersion: body.targetVersion,
+      status: 'scheduled', requestedAt: new Date().toISOString() });
+    try {
+      const log = path.join(directory, 'update.log');
+      const pid = await startBackground(installed.nodeExecutable, [worker, jobFile], process.env, [log, log]);
+      const owner = await desktopHost.process(pid);
+      if (!owner) throw new Error('独立更新进程未启动。');
+      writeRecord(statusPath(root), { ...readRecord(statusPath(root)), owner: {
+        pid: owner.pid, created: owner.created, executable: owner.executable } });
+    } catch (error) {
+      writeRecord(statusPath(root), { ...readRecord(statusPath(root)), status: 'failed', error: error.message });
+      throw new Error('桌面服务更新启动未完成，请查看桌面服务更新日志；结果确认前不要重复提交。');
+    }
+    return serviceUpdateStatus(root);
+  } finally { scheduling = false; }
+}