@walkhi/code-relax 0.1.0-beta.4 → 0.1.0-beta.41

package/dist/src/workstation-downloads.mjs

@@ -0,0 +1,120 @@
+import fs from 'node:fs/promises';
+import { constants } from 'node:fs';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { fileRevision, FILE_PART_BYTES, FILE_READ_LIMIT } from './file-transfer-range.mjs';
+import { readRecord, writeRecord } from './service-lifecycle.mjs';
+
+const fail = (message, statusCode = 400) => { throw Object.assign(new Error(message), { statusCode }); };
+const pathKey = value => process.platform === 'win32' ? value.toLowerCase() : value;
+const validName = value => typeof value === 'string' && value.length > 0
+  && !/[<>:"/\\|?*\x00-\x1f]/.test(value) && !/[ .]$/.test(value) && !['.', '..'].includes(value)
+  && !/^(?:con|prn|aux|nul|com[1-9¹²³]|lpt[1-9¹²³])(?:\.|$)/i.test(value);
+
+// A saved copy belongs to the authorized external asset, rather than its current chat page.
+export class WorkstationDownloads {
+  constructor(stateRoot) {
+    this.recordPath = path.join(stateRoot, 'external-file-copies.json');
+    this.copies = readRecord(this.recordPath) || {};
+  }
+
+  async copy(sourceId) {
+    const record = this.copies[sourceId];
+    if (!record) return null;
+    try {
+      const stat = await fs.stat(record.path);
+      return stat.isFile() && fileRevision(stat) === record.revision && stat.size === record.size ? record : null;
+    } catch (error) { if (['ENOENT', 'ENOTDIR'].includes(error.code)) return null; throw error; }
+  }
+
+  async folder(rpc, locations, selection) {
+    let root;
+    if (selection.target === 'downloads') root = locations.downloads;
+    else if (selection.target === 'project' && typeof selection.projectId === 'string' && selection.projectId) {
+      const { project } = await rpc('project/read', { projectId: selection.projectId });
+      const selected = selection.root || project.roots[0]?.path;
+      root = project.roots.find(item => pathKey(item.path) === pathKey(selected))?.path;
+    }
+    if (!root || !path.isAbsolute(root)) fail('请选择电脑项目或下载目录。');
+    const relative = selection.path || '';
+    if (typeof relative !== 'string' || relative.split('/').some(part => part && !validName(part))) fail('子文件夹路径无效。');
+    const realRoot = await fs.realpath(root), target = path.join(realRoot, ...relative.split('/'));
+    const realTarget = await fs.realpath(target), difference = path.relative(realRoot, realTarget);
+    if (difference === '..' || difference.startsWith('..' + path.sep) || path.isAbsolute(difference)) fail('只能选择当前目录内的子文件夹。');
+    if (!(await fs.stat(realTarget)).isDirectory()) fail('所选路径不是文件夹。');
+    return { root, path: relative, absolutePath: target, realPath: realTarget,
+      parent: relative ? relative.split('/').slice(0, -1).join('/') : null };
+  }
+
+  async browse(rpc, locations, selection) {
+    const folder = await this.folder(rpc, locations, selection);
+    const entries = (await fs.readdir(folder.realPath, { withFileTypes: true })).filter(entry => entry.isDirectory())
+      .map(entry => ({ name: entry.name, path: [folder.path, entry.name].filter(Boolean).join('/') }))
+      .sort((a, b) => a.name.localeCompare(b.name, 'zh-CN', { numeric: true }));
+    const { realPath, ...visible } = folder;
+    return { ...visible, entries };
+  }
+
+  async save(rpc, locations, selection, asset, readPart, signal) {
+    const folder = await this.folder(rpc, locations, selection);
+    const partial = path.join(folder.realPath, `.code-relax-${crypto.randomUUID()}.download.part`);
+    let handle, result, created = false;
+    try {
+      signal?.throwIfAborted();
+      handle = await fs.open(partial, 'wx', 0o600);
+      created = true;
+      let offset = 0, size, revision, name, mimeType;
+      do {
+        signal?.throwIfAborted();
+        const query = new URLSearchParams({ offset: String(offset), length: String(FILE_PART_BYTES) });
+        if (revision) query.set('revision', revision);
+        const part = await readPart(asset, query);
+        signal?.throwIfAborted();
+        if (offset === 0) {
+          size = part.size; revision = part.revision; name = part.name || asset.name; mimeType = part.mimeType || asset.mimeType;
+          if (!validName(name)) fail('文件名无效，请修正来源文件的名称。');
+          if (!Number.isSafeInteger(size) || size < 1 || size > FILE_READ_LIMIT || !revision) fail('文件大小无效或超过 20 MiB 上限。');
+        }
+        if (part.size !== size || part.revision !== revision || part.offset !== offset
+          || !part.bytes?.length || part.bytes.length > Math.min(FILE_PART_BYTES, size - offset)) fail('文件内容发生变化或分片不完整。', 409);
+        let written = 0;
+        while (written < part.bytes.length) {
+          const { bytesWritten } = await handle.write(part.bytes, written, part.bytes.length - written, offset + written);
+          if (!bytesWritten) fail('电脑文件写入不完整。', 502);
+          written += bytesWritten;
+        }
+        offset += part.bytes.length;
+      } while (offset < size);
+      await handle.close(); handle = null;
+      signal?.throwIfAborted();
+      // Recheck the destination after the remote read, before creating the final copy.
+      const current = await this.folder(rpc, locations, selection);
+      if (pathKey(current.realPath) !== pathKey(folder.realPath)) fail('目标目录发生变化，请重新选择。', 409);
+      const extension = path.extname(name), body = name.slice(0, name.length - extension.length);
+      for (let number = 0; ; number++) {
+        const filename = number ? `${body} (${number})${extension}` : name;
+        const destination = path.join(folder.realPath, filename);
+        try {
+          await fs.copyFile(partial, destination, constants.COPYFILE_EXCL);
+          const stat = await fs.stat(destination);
+          if (stat.size !== size) { await fs.unlink(destination); fail('电脑副本大小核对失败。', 502); }
+          result = { path: destination, name: filename, size, revision: fileRevision(stat), mimeType };
+          break;
+        } catch (error) { if (error.code !== 'EEXIST') throw error; }
+      }
+      this.copies[asset.id] = result;
+      try { writeRecord(this.recordPath, this.copies); }
+      catch (error) { result.warning = '文件已保存，副本记录未能持久保存；重启后请从原文件重新选择。'; console.error('电脑副本记录保存失败', error); }
+      return result;
+    } finally {
+      await handle?.close();
+      if (created) {
+        try { await fs.rm(partial, { force: true }); }
+        catch (error) {
+          if (!result) throw error;
+          result.warning = '文件已保存，下载临时文件未能清理。'; console.error('电脑下载临时文件清理失败', error);
+        }
+      }
+    }
+  }
+}

package/package.json

@@ -1,50 +1,48 @@
-{
+{
   "name": "@walkhi/code-relax",
-  "version": "0.1.0-beta.4",
+  "version": "0.1.0-beta.41",
+  "private": false,
   "license": "UNLICENSED",
-  "type": "module",
-  "scripts": {
-    "postinstall": "node ./tools/postinstall.mjs",
-    "relay:demo": "node ./bin/self-relay-demo.mjs",
-    "relay:check": "node ./bin/self-relay-demo.mjs --check",
-    "probe:app-server": "node ./tools/probe-app-server.mjs",
-    "probe:app-server-tasks": "node ./tools/probe-app-server-tasks.mjs",
-    "build": "node ./tools/build-package.mjs",
-    "prepack": "npm run build"
-  },
-  "dependencies": {
-    "node-datachannel": "0.33.4",
-    "qrcode": "1.5.4",
-    "sharp": "0.35.4",
-    "ws": "8.21.3"
-  },
+  "type": "module",
+  "scripts": {
+    "postinstall": "node ./tools/postinstall.mjs"
+  },
+  "dependencies": {
+    "mysql2": "^3.24.4",
+    "node-datachannel": "0.33.4",
+    "qrcode": "1.5.4",
+    "sharp": "0.35.5",
+    "ws": "8.21.3"
+  },
   "bin": {
     "relax": "dist/bin/codex-remote.mjs",
     "code-relax": "dist/bin/codex-remote.mjs"
   },
-  "description": "Windows Code Relax LAN Bridge and CLI",
-  "engines": {
-    "node": ">=22.12.0"
-  },
-  "os": [
-    "win32"
-  ],
-  "cpu": [
-    "x64"
-  ],
-  "files": [
-    "dist/",
-    "tools/postinstall.mjs"
-  ],
-  "bundleDependencies": [
-    "node-datachannel",
-    "qrcode",
-    "sharp",
-    "ws"
+  "description": "Code Relax Windows, macOS and Linux workstation service",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "os": [
+    "win32",
+    "darwin",
+    "linux"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "files": [
+    "dist/",
+    "tools/postinstall.mjs"
   ],
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org",
     "tag": "beta"
+  },
+  "optionalDependencies": {
+    "@walkhi/code-relax-native-win32-x64": "0.1.0-beta.41",
+    "@walkhi/code-relax-native-darwin-arm64": "0.1.0-beta.41",
+    "@walkhi/code-relax-native-darwin-x64": "0.1.0-beta.41"
   }
 }

package/tools/postinstall.mjs

@@ -4,9 +4,10 @@ import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
-const serviceRoot = path.join(process.env.LOCALAPPDATA || path.join(os.homedir(), 'AppData', 'Local'),
-  'Programs', 'CodexRemote', 'service');
-const stateRoot = path.join(process.env.LOCALAPPDATA || path.join(os.homedir(), 'AppData', 'Local'), 'CodexRemote');
+// 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) {
@@ -33,12 +34,12 @@ function systemSummary() {
     + `osArch=${os.arch()} processArch=${process.arch} node=${process.version} npmUserAgent=${npm}`;
 }
 
-function runStage(entry, stage, args) {
+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(output); appendLog(`[${stage}] stdout\n${output.trimEnd()}`); }
+    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()}`); }
@@ -48,6 +49,57 @@ function runStage(entry, stage, args) {
   }
 }
 
+export function formatSetupOutput(output) {
+  try {
+    const result = JSON.parse(output);
+    const migration = result.managedAppServerMigration || {};
+    return `Code Relax ${result.version || '未知版本'} 服务安装完成。\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 };
@@ -88,31 +140,43 @@ function setupFailureGuidance(previous, current) {
   return '这是首次安装，尚未形成可确认的固定服务。\n修复上方错误后重新运行 npm 安装命令；无需执行卸载。';
 }
 
-function skillFailureGuidance(previous, current) {
-  const service = current.valid
-    ? `${previous.valid ? `服务已从 ${previous.version} 更新到` : '固定服务已安装为'} ${current.version}`
-    : 'setup 已返回成功，但当前固定服务记录无法确认';
-  return `${service}；Codex Skill 安装失败。\n请执行 relax skill-install，再执行 relax doctor；无需重新卸载服务。`;
-}
-
-if (process.env.npm_config_global === 'true') {
+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();
-  let stage = 'setup';
   appendLog(`[postinstall] start package=${process.env.npm_package_version || 'unknown'} ${systemSummary()}`);
+  let setupStarted = false;
   try {
-    runStage(entry, stage, ['setup', '--json']);
-    stage = 'skill-install';
-    runStage(entry, stage, ['skill-install', '--json']);
-    appendLog('[postinstall] success');
+    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']); }
+    catch (error) {
+      console.error('服务安装已完成，但安装后健康检查未通过；请查看上方诊断与安装日志。');
+      process.exitCode = 1;
+    }
+    console.log(`安装日志：${installLog}`);
+    appendLog(process.exitCode ? '[postinstall] failed stage=doctor' : '[postinstall] success');
   } catch (error) {
     const current = installationSnapshot();
-    console.error(`\nCode Relax 安装未完全完成：\n${stage === 'setup'
-      ? setupFailureGuidance(previous, current)
-      : skillFailureGuidance(previous, current)}`);
+    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=${stage}`);
+    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}`);
+    }
   }
 }