@walkhi/code-relax 0.1.0-beta.30 → 0.1.0-beta.32

package/dist/src/platform/windows/user-environment.mjs

@@ -1,50 +1,50 @@
-import path from 'node:path';
-import fs from 'node:fs';
-import { readRecord, writeRecord } from '../../service-lifecycle.mjs';
-import { runScript } from './desktop-host.mjs';
-import { managedAppServerUrl } from '../../managed-app-server.mjs';
-
-const ownershipFile = 'managed-environment.json';
-
-export async function readManagedEnvironment() {
-  return JSON.parse(await runScript('user-environment.ps1', ['-Action', 'Read']));
-}
-
-export async function configureManagedEnvironment(stateRoot) {
-  const current = await readManagedEnvironment();
-  const ownershipPath = path.join(stateRoot, ownershipFile);
-  const ownership = readRecord(ownershipPath);
-  if (current.forceCliUser === '1' || current.forceCliMachine === '1') {
-    throw new Error('CODEX_APP_SERVER_FORCE_CLI=1 会让 Codex 忽略当前内核地址；未修改该配置。');
-  }
-  if (current.userValue && current.userValue !== managedAppServerUrl) {
-    throw new Error(`用户已有 CODEX_APP_SERVER_WS_URL=${current.userValue}；未覆盖该配置。`);
-  }
-  if (current.userValue === managedAppServerUrl) {
-    const owned = ownership?.value === managedAppServerUrl;
-    return { configured: true, value: current.userValue, changed: false, owned };
-  }
-  const applied = JSON.parse(await runScript('user-environment.ps1', ['-Action', 'Set', '-Value', managedAppServerUrl]));
-  writeRecord(ownershipPath, { name: 'CODEX_APP_SERVER_WS_URL', value: managedAppServerUrl,
-    configuredAt: new Date().toISOString() });
-  return { configured: true, value: applied.userValue, changed: true, owned: true };
-}
-
-export async function clearManagedEnvironment(stateRoot) {
-  const ownershipPath = path.join(stateRoot, ownershipFile);
-  const ownership = readRecord(ownershipPath);
-  const current = await readManagedEnvironment();
-  if (!current.userValue) {
-    fs.rmSync(ownershipPath, { force: true });
-    return { removed: false, preserved: false, reason: 'already-empty' };
-  }
-  if (ownership?.value !== managedAppServerUrl || current.userValue !== managedAppServerUrl) {
-    fs.rmSync(ownershipPath, { force: true });
-    return { removed: false, preserved: true, value: current.userValue,
-      reason: ownership?.value === managedAppServerUrl ? 'user-modified' : 'not-owned' };
-  }
-  const result = JSON.parse(await runScript('user-environment.ps1', ['-Action', 'Clear']));
-  if (result.userValue) throw new Error('CODEX_APP_SERVER_WS_URL 清理后读回仍不为空。');
-  fs.rmSync(ownershipPath, { force: true });
-  return { removed: true, preserved: false, reason: 'removed' };
-}
+import path from 'node:path';
+import fs from 'node:fs';
+import { readRecord, writeRecord } from '../../service-lifecycle.mjs';
+import { runScript } from './desktop-host.mjs';
+import { managedAppServerUrl } from '../../managed-app-server.mjs';
+
+const ownershipFile = 'managed-environment.json';
+
+export async function readManagedEnvironment() {
+  return JSON.parse(await runScript('user-environment.ps1', ['-Action', 'Read']));
+}
+
+export async function configureManagedEnvironment(stateRoot) {
+  const current = await readManagedEnvironment();
+  const ownershipPath = path.join(stateRoot, ownershipFile);
+  const ownership = readRecord(ownershipPath);
+  if (current.forceCliUser === '1' || current.forceCliMachine === '1') {
+    throw new Error('CODEX_APP_SERVER_FORCE_CLI=1 会让 Codex 忽略当前内核地址；未修改该配置。');
+  }
+  if (current.userValue && current.userValue !== managedAppServerUrl) {
+    throw new Error(`用户已有 CODEX_APP_SERVER_WS_URL=${current.userValue}；未覆盖该配置。`);
+  }
+  if (current.userValue === managedAppServerUrl) {
+    const owned = ownership?.value === managedAppServerUrl;
+    return { configured: true, value: current.userValue, changed: false, owned };
+  }
+  const applied = JSON.parse(await runScript('user-environment.ps1', ['-Action', 'Set', '-Value', managedAppServerUrl]));
+  writeRecord(ownershipPath, { name: 'CODEX_APP_SERVER_WS_URL', value: managedAppServerUrl,
+    configuredAt: new Date().toISOString() });
+  return { configured: true, value: applied.userValue, changed: true, owned: true };
+}
+
+export async function clearManagedEnvironment(stateRoot) {
+  const ownershipPath = path.join(stateRoot, ownershipFile);
+  const ownership = readRecord(ownershipPath);
+  const current = await readManagedEnvironment();
+  if (!current.userValue) {
+    fs.rmSync(ownershipPath, { force: true });
+    return { removed: false, preserved: false, reason: 'already-empty' };
+  }
+  if (ownership?.value !== managedAppServerUrl || current.userValue !== managedAppServerUrl) {
+    fs.rmSync(ownershipPath, { force: true });
+    return { removed: false, preserved: true, value: current.userValue,
+      reason: ownership?.value === managedAppServerUrl ? 'user-modified' : 'not-owned' };
+  }
+  const result = JSON.parse(await runScript('user-environment.ps1', ['-Action', 'Clear']));
+  if (result.userValue) throw new Error('CODEX_APP_SERVER_WS_URL 清理后读回仍不为空。');
+  fs.rmSync(ownershipPath, { force: true });
+  return { removed: true, preserved: false, reason: 'removed' };
+}

package/dist/src/platform/windows/user-environment.ps1

@@ -1,41 +1,41 @@
-param(
-    [ValidateSet('Read', 'Set', 'Clear')][string]$Action = 'Read',
-    [string]$Value = ''
-)
-$ErrorActionPreference = 'Stop'
-[Console]::OutputEncoding = New-Object System.Text.UTF8Encoding($false)
-$name = 'CODEX_APP_SERVER_WS_URL'
-
-function Broadcast-EnvironmentChange {
-    if (-not ('CodeRelax.EnvironmentBroadcast' -as [type])) {
-        Add-Type -Namespace CodeRelax -Name EnvironmentBroadcast -MemberDefinition @'
-[System.Runtime.InteropServices.DllImport("user32.dll", CharSet=System.Runtime.InteropServices.CharSet.Unicode, SetLastError=true)]
-public static extern System.IntPtr SendMessageTimeout(
-    System.IntPtr hWnd, uint Msg, System.UIntPtr wParam, string lParam,
-    uint flags, uint timeout, out System.UIntPtr result);
-'@
-    }
-    [UIntPtr]$result = [UIntPtr]::Zero
-    [void][CodeRelax.EnvironmentBroadcast]::SendMessageTimeout(
-        [IntPtr]0xffff, 0x001A, [UIntPtr]::Zero, 'Environment', 0x0002, 5000, [ref]$result)
-}
-
-if ($Action -eq 'Set') {
-    if ([string]::IsNullOrWhiteSpace($Value)) { throw 'Environment value is required.' }
-    [Environment]::SetEnvironmentVariable($name, $Value, 'User')
-    Broadcast-EnvironmentChange
-} elseif ($Action -eq 'Clear') {
-    [Environment]::SetEnvironmentVariable($name, $null, 'User')
-    Broadcast-EnvironmentChange
-}
-
-$userValue = [Environment]::GetEnvironmentVariable($name, 'User')
-$result = @{
-    userValue = $userValue
-    machineValue = [Environment]::GetEnvironmentVariable($name, 'Machine')
-    forceCliUser = [Environment]::GetEnvironmentVariable('CODEX_APP_SERVER_FORCE_CLI', 'User')
-    forceCliMachine = [Environment]::GetEnvironmentVariable('CODEX_APP_SERVER_FORCE_CLI', 'Machine')
-}
-if ($Action -eq 'Set' -and $userValue -ne $Value) { throw 'Environment value verification failed.' }
-if ($Action -eq 'Clear' -and -not [string]::IsNullOrEmpty($userValue)) { throw 'Environment removal verification failed.' }
-$result | ConvertTo-Json -Compress
+param(
+    [ValidateSet('Read', 'Set', 'Clear')][string]$Action = 'Read',
+    [string]$Value = ''
+)
+$ErrorActionPreference = 'Stop'
+[Console]::OutputEncoding = New-Object System.Text.UTF8Encoding($false)
+$name = 'CODEX_APP_SERVER_WS_URL'
+
+function Broadcast-EnvironmentChange {
+    if (-not ('CodeRelax.EnvironmentBroadcast' -as [type])) {
+        Add-Type -Namespace CodeRelax -Name EnvironmentBroadcast -MemberDefinition @'
+[System.Runtime.InteropServices.DllImport("user32.dll", CharSet=System.Runtime.InteropServices.CharSet.Unicode, SetLastError=true)]
+public static extern System.IntPtr SendMessageTimeout(
+    System.IntPtr hWnd, uint Msg, System.UIntPtr wParam, string lParam,
+    uint flags, uint timeout, out System.UIntPtr result);
+'@
+    }
+    [UIntPtr]$result = [UIntPtr]::Zero
+    [void][CodeRelax.EnvironmentBroadcast]::SendMessageTimeout(
+        [IntPtr]0xffff, 0x001A, [UIntPtr]::Zero, 'Environment', 0x0002, 5000, [ref]$result)
+}
+
+if ($Action -eq 'Set') {
+    if ([string]::IsNullOrWhiteSpace($Value)) { throw 'Environment value is required.' }
+    [Environment]::SetEnvironmentVariable($name, $Value, 'User')
+    Broadcast-EnvironmentChange
+} elseif ($Action -eq 'Clear') {
+    [Environment]::SetEnvironmentVariable($name, $null, 'User')
+    Broadcast-EnvironmentChange
+}
+
+$userValue = [Environment]::GetEnvironmentVariable($name, 'User')
+$result = @{
+    userValue = $userValue
+    machineValue = [Environment]::GetEnvironmentVariable($name, 'Machine')
+    forceCliUser = [Environment]::GetEnvironmentVariable('CODEX_APP_SERVER_FORCE_CLI', 'User')
+    forceCliMachine = [Environment]::GetEnvironmentVariable('CODEX_APP_SERVER_FORCE_CLI', 'Machine')
+}
+if ($Action -eq 'Set' -and $userValue -ne $Value) { throw 'Environment value verification failed.' }
+if ($Action -eq 'Clear' -and -not [string]::IsNullOrEmpty($userValue)) { throw 'Environment removal verification failed.' }
+$result | ConvertTo-Json -Compress

package/dist/src/project-archive.mjs

@@ -0,0 +1,30 @@
+import { sharedThreadProjectId, dotsThreadProjectId } from './shared-catalog.mjs';
+
+// Enumerate metadata, not the sidebar's limited window or conversation bodies.
+export async function projectArchiveCandidates(server, dotsServer, projectId) {
+  const projects = await server.projects();
+  const project = projects.find(value => value.id === projectId);
+  if (!project) throw Object.assign(new Error('项目不存在，请刷新列表。'), { statusCode: 404 });
+  const local = [];
+  let cursor;
+  do {
+    const page = await server.request('thread/list', { limit: 100, archived: false,
+      sortKey: 'recency_at', sortDirection: 'desc', ...(cursor ? { cursor } : {}) });
+    local.push(...page.data); cursor = page.nextCursor;
+  } while (cursor);
+  let hosted = [], catalogError = '';
+  if (dotsServer) {
+    try { hosted = await dotsServer.taskCatalog(false, true); }
+    catch (error) { catalogError = `云端目录读取失败，本次仅包含本机对话：${error.message}`; }
+  }
+  const threads = [];
+  for (const [hostId, values, group] of [['local', local, sharedThreadProjectId], ['durable', hosted, dotsThreadProjectId]]) {
+    for (const thread of values) {
+      if (thread.threadSource === 'aeon' || group(thread, projects) !== projectId) continue;
+      const status = typeof thread.status === 'string' ? thread.status : thread.status?.type || 'unknown';
+      threads.push({ id: thread.id, hostId, projectId, threadSource: thread.threadSource,
+        title: thread.name || thread.preview || thread.id, status });
+    }
+  }
+  return { projectId, threads, ...(catalogError ? { catalogError } : {}) };
+}

package/dist/src/project-create.mjs

@@ -1,119 +1,121 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import { createHash } from 'node:crypto';
-import { readRecord, writeRecord } from './service-lifecycle.mjs';
-import { projectRoots, projectSummary } from './project-management.mjs';
-import { projectLocations } from './platform/project-locations.mjs';
-import { withDesktopProjectRegistration } from './platform/desktop-project-registration.mjs';
-
-const pending = new Map();
-const uuid = /^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i;
-const fail = message => { throw Object.assign(new Error(message), { statusCode: 400 }); };
-const pathKey = value => process.platform === 'win32' ? path.normalize(value).toLowerCase() : path.normalize(value);
-
-function defaultName(name) {
-  let value = path.basename(name).trim().replace(/[<>:"/\\|?*\x00-\x1f]/g, '_').replace(/[ .]+$/g, '') || 'New project';
-  if (/^(?:con|prn|aux|nul|com[1-9¹²³]|lpt[1-9¹²³])(?:\.|$)/i.test(value)) value = `_${value}`;
-  return value;
-}
-
-export async function createWorkstationProject(server, stateRoot, codexDataRoot, body, dependencies = {}) {
-  if (!uuid.test(body.idempotencyKey || '')) fail('项目创建标识无效。');
-  const name = typeof body.name === 'string' ? body.name.trim() : '';
-  if (!name) fail('请输入项目名称。');
-  if (!Array.isArray(body.roots) || body.roots.some(root => typeof root?.path !== 'string' || !path.isAbsolute(root.path.trim()))) {
-    fail('项目文件夹路径无效。');
-  }
-  const roots = body.roots.map(root => ({ path: path.normalize(root.path.trim()) }));
-  const signature = createHash('sha256').update(JSON.stringify({ name, roots })).digest('hex');
-  const directory = path.join(stateRoot, 'project-create-operations');
-  const record = path.join(directory, `${body.idempotencyKey}.json`);
-  const running = pending.get(record);
-  if (running) {
-    if (running.signature !== signature) fail('同一个创建请求不能修改项目名称或目录。');
-    return running.promise;
-  }
-  const promise = perform().finally(() => pending.delete(record));
-  pending.set(record, { signature, promise });
-  return promise;
-
-  async function perform() {
-    await fs.mkdir(directory, { recursive: true });
-    let operation = readRecord(record);
-    if (operation && operation.signature !== signature) fail('项目创建标识已用于其他内容，请重新打开项目编辑器。');
-    if (operation?.result) return operation.result;
-    operation ||= { signature, name, roots };
-    const save = () => writeRecord(record, operation);
-    const rpc = (method, params) => server.request(method, params);
-    const register = dependencies.registration || withDesktopProjectRegistration;
-    try {
-      return await register({ stateRoot, codexDataRoot, operationId: body.idempotencyKey,
-        confirmed: body.confirmDesktopRestart === true, serverUrl: server.url }, async desktop => {
-        // The restart confirmation and state checks happen before any
-        // directory or project write. Existing folders are never moved or copied.
-        if (!operation.resolvedRoots) {
-          operation.resolvedRoots = await projectRoots(rpc, roots);
-          if (!operation.resolvedRoots.length) {
-            const locations = await (dependencies.locations || projectLocations)();
-            await rpc('fs/createDirectory', { path: locations.defaultParent, recursive: true });
-            const entries = (await rpc('fs/readDirectory', { path: locations.defaultParent })).entries;
-            const names = new Set(entries.map(entry => entry.fileName.toLowerCase()));
-            const base = defaultName(name);
-            let folder = base;
-            for (let suffix = 2; names.has(folder.toLowerCase()); suffix++) folder = `${base} ${suffix}`;
-            operation.defaultDirectory = path.join(locations.defaultParent, folder);
-            operation.resolvedRoots = [{ path: operation.defaultDirectory }];
-          }
-          save();
-        }
-        if (operation.defaultDirectory && !operation.directoryCreated) {
-          if (operation.directoryAttempted) {
-            // On an explicit retry, keep the originally allocated directory. Never
-            // allocate another name after an interrupted createDirectory response.
-            await projectRoots(rpc, operation.resolvedRoots);
-          } else {
-            operation.directoryAttempted = true; save();
-            await rpc('fs/createDirectory', { path: operation.defaultDirectory, recursive: false });
-          }
-          operation.directoryCreated = true; save();
-          try {
-            const result = await rpc('command/exec', { command: ['git', 'init'], cwd: operation.defaultDirectory, timeoutMs: 10000 });
-            if (result.exitCode !== 0) throw new Error(result.stderr || result.stdout || `退出码 ${result.exitCode}`);
-          } catch (error) { operation.gitWarning = `项目目录已创建，Git 初始化未完成：${error.message}`; save(); }
-        }
-        const resolvedRoots = await projectRoots(rpc, operation.resolvedRoots);
-        if (!operation.projectId) {
-          operation.createAttempted = true; save();
-          // Native project/create owns idempotency; a retry uses this exact key
-          // and original roots on the same server, never a second transport.
-          const created = await rpc('project/create', { name, roots: resolvedRoots, idempotencyKey: body.idempotencyKey });
-          operation.projectId = created.project.id; save();
-        }
-        const { project } = await rpc('project/read', { projectId: operation.projectId });
-        if (project.id !== operation.projectId || project.name !== name || project.roots.length !== resolvedRoots.length
-          || project.roots.some((root, index) => pathKey(root.path) !== pathKey(resolvedRoots[index].path))) {
-          throw new Error('已创建项目的名称或目录发生变化，未覆盖其内容。');
-        }
-        if (!operation.ordered) {
-          const first = (await rpc('project/list', { limit: 1, sortKey: 'position', sortDirection: 'asc' })).data[0];
-          if (first && first.id !== project.id) await rpc('project/move', { projectId: project.id, beforeProjectId: first.id });
-          operation.ordered = true; save();
-        }
-        const desktopRegistration = await desktop.register(project, operation, save);
-        operation.result = { project: projectSummary(project), desktopRegistration,
-          ...(operation.gitWarning ? { warning: operation.gitWarning } : {}) };
-        save();
-        return operation.result;
-      });
-    } catch (error) {
-      if (operation.projectId || operation.createAttempted || operation.directoryAttempted) {
-        error.details = { ...error.details, projectCreationPending: true,
-          ...(operation.projectId ? { createdProjectId: operation.projectId } : {}) };
-        error.message += operation.projectId
-          ? ' 项目已创建，请继续完成桌面登记；会沿用同一项目，不会重复创建。'
-          : ' 请继续核对本次创建；会沿用原请求标识和目录。';
-      } else error.details = { ...error.details, projectCreationPending: false };
-      throw error;
-    }
-  }
-}
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+import { readRecord, writeRecord } from './service-lifecycle.mjs';
+import { projectRoots, projectSummary } from './project-management.mjs';
+import { projectLocations } from './platform/project-locations.mjs';
+import { withDesktopProjectRegistration } from './platform/desktop-project-registration.mjs';
+
+const pending = new Map();
+const uuid = /^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i;
+const fail = message => { throw Object.assign(new Error(message), { statusCode: 400 }); };
+const pathKey = value => process.platform === 'win32' ? path.normalize(value).toLowerCase() : path.normalize(value);
+
+function defaultName(name) {
+  let value = path.basename(name).trim().replace(/[<>:"/\\|?*\x00-\x1f]/g, '_').replace(/[ .]+$/g, '') || 'New project';
+  if (/^(?:con|prn|aux|nul|com[1-9¹²³]|lpt[1-9¹²³])(?:\.|$)/i.test(value)) value = `_${value}`;
+  return value;
+}
+
+export async function createWorkstationProject(server, stateRoot, codexDataRoot, body, dependencies = {}) {
+  if (!uuid.test(body.idempotencyKey || '')) fail('项目创建标识无效。');
+  const name = typeof body.name === 'string' ? body.name.trim() : '';
+  if (!name) fail('请输入项目名称。');
+  if (!Array.isArray(body.roots) || body.roots.some(root => typeof root?.path !== 'string' || !path.isAbsolute(root.path.trim()))) {
+    fail('项目文件夹路径无效。');
+  }
+  const roots = body.roots.map(root => ({ path: path.normalize(root.path.trim()) }));
+  const signature = createHash('sha256').update(JSON.stringify({ name, roots })).digest('hex');
+  const directory = path.join(stateRoot, 'project-create-operations');
+  const record = path.join(directory, `${body.idempotencyKey}.json`);
+  const running = pending.get(record);
+  if (running) {
+    if (running.signature !== signature) fail('同一个创建请求不能修改项目名称或目录。');
+    return running.promise;
+  }
+  const promise = perform().finally(() => pending.delete(record));
+  pending.set(record, { signature, promise });
+  return promise;
+
+  async function perform() {
+    await fs.mkdir(directory, { recursive: true });
+    let operation = readRecord(record);
+    if (operation && operation.signature !== signature) fail('项目创建标识已用于其他内容，请重新打开项目编辑器。');
+    if (operation?.result) return operation.result;
+    operation ||= { signature, name, roots };
+    const save = () => writeRecord(record, operation);
+    const rpc = (method, params) => server.request(method, params);
+    const register = dependencies.registration || withDesktopProjectRegistration;
+    try {
+      return await register({ stateRoot, codexDataRoot, operationId: body.idempotencyKey,
+        confirmed: body.confirmDesktopRestart === true, serverUrl: server.url }, async desktop => {
+        // The restart confirmation and state checks happen before any
+        // directory or project write. Existing folders are never moved or copied.
+        let validatedRoots;
+        if (!operation.resolvedRoots) {
+          validatedRoots = await projectRoots(rpc, roots);
+          operation.resolvedRoots = validatedRoots;
+          if (!operation.resolvedRoots.length) {
+            const locations = await (dependencies.locations || projectLocations)();
+            await rpc('fs/createDirectory', { path: locations.defaultParent, recursive: true });
+            const entries = (await rpc('fs/readDirectory', { path: locations.defaultParent })).entries;
+            const names = new Set(entries.map(entry => entry.fileName.toLowerCase()));
+            const base = defaultName(name);
+            let folder = base;
+            for (let suffix = 2; names.has(folder.toLowerCase()); suffix++) folder = `${base} ${suffix}`;
+            operation.defaultDirectory = path.join(locations.defaultParent, folder);
+            operation.resolvedRoots = [{ path: operation.defaultDirectory }];
+          }
+          save();
+        }
+        if (operation.defaultDirectory && !operation.directoryCreated) {
+          if (operation.directoryAttempted) {
+            // On an explicit retry, keep the originally allocated directory. Never
+            // allocate another name after an interrupted createDirectory response.
+            await projectRoots(rpc, operation.resolvedRoots);
+          } else {
+            operation.directoryAttempted = true; save();
+            await rpc('fs/createDirectory', { path: operation.defaultDirectory, recursive: false });
+          }
+          operation.directoryCreated = true; save();
+          try {
+            const result = await rpc('command/exec', { command: ['git', 'init'], cwd: operation.defaultDirectory, timeoutMs: 10000 });
+            if (result.exitCode !== 0) throw new Error(result.stderr || result.stdout || `退出码 ${result.exitCode}`);
+          } catch (error) { operation.gitWarning = `项目目录已创建，Git 初始化未完成：${error.message}`; save(); }
+        }
+        const resolvedRoots = validatedRoots?.length ? validatedRoots : await projectRoots(rpc, operation.resolvedRoots);
+        if (!operation.projectId) {
+          operation.createAttempted = true; save();
+          // Native project/create owns idempotency; a retry uses this exact key
+          // and original roots on the same server, never a second transport.
+          const created = await rpc('project/create', { name, roots: resolvedRoots, idempotencyKey: body.idempotencyKey });
+          operation.projectId = created.project.id; save();
+        }
+        const { project } = await rpc('project/read', { projectId: operation.projectId });
+        if (project.id !== operation.projectId || project.name !== name || project.roots.length !== resolvedRoots.length
+          || project.roots.some((root, index) => pathKey(root.path) !== pathKey(resolvedRoots[index].path))) {
+          throw new Error('已创建项目的名称或目录发生变化，未覆盖其内容。');
+        }
+        if (!operation.ordered) {
+          const first = (await rpc('project/list', { limit: 1, sortKey: 'position', sortDirection: 'asc' })).data[0];
+          if (first && first.id !== project.id) await rpc('project/move', { projectId: project.id, beforeProjectId: first.id });
+          operation.ordered = true; save();
+        }
+        const desktopRegistration = await desktop.register(project, operation, save);
+        operation.result = { project: projectSummary(project), desktopRegistration,
+          ...(operation.gitWarning ? { warning: operation.gitWarning } : {}) };
+        save();
+        return operation.result;
+      });
+    } catch (error) {
+      if (operation.projectId || operation.createAttempted || operation.directoryAttempted) {
+        error.details = { ...error.details, projectCreationPending: true,
+          ...(operation.projectId ? { createdProjectId: operation.projectId } : {}) };
+        error.message += operation.projectId
+          ? ' 项目已创建，请继续完成桌面登记；会沿用同一项目，不会重复创建。'
+          : ' 请继续核对本次创建；会沿用原请求标识和目录。';
+      } else error.details = { ...error.details, projectCreationPending: false };
+      throw error;
+    }
+  }
+}

package/dist/src/project-management.mjs

@@ -1,69 +1,59 @@
-import path from 'node:path';
-
-const fail = (message, statusCode = 400) => { throw Object.assign(new Error(message), { statusCode }); };
-const pathKey = value => process.platform === 'win32' ? value.toLowerCase() : value;
-
-function absoluteDirectory(value) {
-  if (typeof value !== 'string' || !value.trim() || !path.isAbsolute(value.trim())) fail('请输入电脑上的绝对文件夹路径。');
-  return path.normalize(value.trim());
-}
-
-async function directory(rpc, value) {
-  const target = absoluteDirectory(value);
-  const stat = await rpc('fs/getMetadata', { path: target });
-  if (!stat.isDirectory) fail(`此路径不是文件夹：${target}`);
-  return target;
-}
-
-function folderName(value) {
-  if (typeof value !== 'string' || !value.trim() || /[<>:"/\\|?*\x00-\x1f]/.test(value) || /[ .]$/.test(value)
-    || /^(?:con|prn|aux|nul|com[1-9¹²³]|lpt[1-9¹²³])(?:\.|$)/i.test(value) || ['.', '..'].includes(value)) {
-    fail('文件夹名称无效，请勿使用路径分隔符或系统保留名称。');
-  }
-  return value;
-}
-
-export async function projectRoots(rpc, roots) {
-  if (!Array.isArray(roots)) fail('项目文件夹列表无效。');
-  const result = [], seen = new Set();
-  for (const root of roots) {
-    const target = await directory(rpc, root?.path);
-    const key = pathKey(target);
-    if (seen.has(key)) fail(`重复的项目文件夹：${target}`);
-    seen.add(key); result.push({ path: target });
-  }
-  return result;
-}
-
-export function projectSummary(project) {
-  return { projectId: project.id, name: project.name, label: project.name, roots: project.roots,
-    path: project.roots[0]?.path || '', cwd: project.roots[0]?.path || '', hostId: 'local' };
-}
-
-export async function browseProjectFolders(rpc, locations, value) {
-  const target = await directory(rpc, value || locations.home);
-  const entries = (await rpc('fs/readDirectory', { path: target })).entries
-    .filter(entry => entry.isDirectory).map(entry => ({ name: entry.fileName, path: path.join(target, entry.fileName) }))
-    .sort((a, b) => a.name.localeCompare(b.name, 'zh-CN', { numeric: true }));
-  return { path: target, parent: path.dirname(target) === target ? null : path.dirname(target), entries, ...locations };
-}
-
-export async function createProjectFolder(rpc, body) {
-  const parent = await directory(rpc, body.parent);
-  const name = folderName(body.name);
-  const entries = (await rpc('fs/readDirectory', { path: parent })).entries;
-  if (entries.some(entry => pathKey(entry.fileName) === pathKey(name))) fail('同名文件夹已存在，请选择它或使用其他名称。', 409);
-  const target = path.join(parent, name);
-  await rpc('fs/createDirectory', { path: target, recursive: false });
-  return { path: target };
-}
-
-export async function saveProject(rpc, locations, body, projectId = null) {
-  // Native creation and Desktop registration are coordinated by project-create.mjs.
-  if (!projectId) fail('新建项目必须通过工作站项目创建流程。', 503);
-  const name = typeof body.name === 'string' ? body.name.trim() : '';
-  if (!name) fail('请输入项目名称。');
-  const roots = await projectRoots(rpc, body.roots);
-  const result = await rpc('project/update', { name, roots, projectId });
-  return { project: projectSummary(result.project) };
-}
+import path from 'node:path';
+
+const fail = (message, statusCode = 400) => { throw Object.assign(new Error(message), { statusCode }); };
+const pathKey = value => process.platform === 'win32' ? value.toLowerCase() : value;
+
+function absoluteDirectory(value) {
+  if (typeof value !== 'string' || !value.trim() || !path.isAbsolute(value.trim())) fail('请输入电脑上的绝对文件夹路径。');
+  return path.normalize(value.trim());
+}
+
+async function directory(rpc, value) {
+  const target = absoluteDirectory(value);
+  const stat = await rpc('fs/getMetadata', { path: target });
+  if (!stat.isDirectory) fail(`此路径不是文件夹：${target}`);
+  return target;
+}
+
+function folderName(value) {
+  if (typeof value !== 'string' || !value.trim() || /[<>:"/\\|?*\x00-\x1f]/.test(value) || /[ .]$/.test(value)
+    || /^(?:con|prn|aux|nul|com[1-9¹²³]|lpt[1-9¹²³])(?:\.|$)/i.test(value) || ['.', '..'].includes(value)) {
+    fail('文件夹名称无效，请勿使用路径分隔符或系统保留名称。');
+  }
+  return value;
+}
+
+export async function projectRoots(rpc, roots) {
+  if (!Array.isArray(roots)) fail('项目文件夹列表无效。');
+  const result = [], seen = new Set();
+  for (const root of roots) {
+    const target = await directory(rpc, root?.path);
+    const key = pathKey(target);
+    if (seen.has(key)) fail(`重复的项目文件夹：${target}`);
+    seen.add(key); result.push({ path: target });
+  }
+  return result;
+}
+
+export function projectSummary(project) {
+  return { projectId: project.id, name: project.name, label: project.name, roots: project.roots,
+    path: project.roots[0]?.path || '', cwd: project.roots[0]?.path || '', hostId: 'local' };
+}
+
+export async function browseProjectFolders(rpc, locations, value) {
+  const target = absoluteDirectory(value || locations?.home);
+  const entries = (await rpc('fs/readDirectory', { path: target })).entries
+    .filter(entry => entry.isDirectory).map(entry => ({ name: entry.fileName, path: path.join(target, entry.fileName) }))
+    .sort((a, b) => a.name.localeCompare(b.name, 'zh-CN', { numeric: true }));
+  return { path: target, parent: path.dirname(target) === target ? null : path.dirname(target), entries, ...(locations || {}) };
+}
+
+export async function createProjectFolder(rpc, body) {
+  const parent = await directory(rpc, body.parent);
+  const name = folderName(body.name);
+  const entries = (await rpc('fs/readDirectory', { path: parent })).entries;
+  if (entries.some(entry => pathKey(entry.fileName) === pathKey(name))) fail('同名文件夹已存在，请选择它或使用其他名称。', 409);
+  const target = path.join(parent, name);
+  await rpc('fs/createDirectory', { path: target, recursive: false });
+  return { path: target };
+}