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

package/dist/src/project-create.mjs

@@ -1,121 +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.
-        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;
-    }
-  }
-}
+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

@@ -56,4 +56,4 @@ export async function createProjectFolder(rpc, body) {
   const target = path.join(parent, name);
   await rpc('fs/createDirectory', { path: target, recursive: false });
   return { path: target };
-}
+}

package/dist/src/project-remove.mjs

@@ -1,55 +1,55 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import { readRecord, writeRecord } from './service-lifecycle.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;
-
-export async function removeWorkstationProject(server, stateRoot, codexDataRoot, projectId, body, dependencies = {}) {
-  if (!projectId || !uuid.test(body.idempotencyKey || '')) throw Object.assign(new Error('项目移除标识无效。'), { statusCode: 400 });
-  const record = path.join(stateRoot, 'project-remove-operations', `${body.idempotencyKey}.json`);
-  const running = pending.get(record);
-  if (running) {
-    if (running.projectId !== projectId) throw Object.assign(new Error('同一请求不能移除其他项目。'), { statusCode: 409 });
-    return running.promise;
-  }
-  const promise = perform().finally(() => pending.delete(record));
-  pending.set(record, { projectId, promise });
-  return promise;
-
-  async function perform() {
-    await fs.mkdir(path.dirname(record), { recursive: true });
-    const operation = readRecord(record) || { projectId };
-    if (operation.projectId !== projectId) throw Object.assign(new Error('移除标识已用于其他项目。'), { statusCode: 409 });
-    if (operation.result) return operation.result;
-    const save = () => writeRecord(record, operation);
-    const registration = dependencies.registration || withDesktopProjectRegistration;
-    return registration({ stateRoot, codexDataRoot, operationId: body.idempotencyKey, operation: 'remove',
-      confirmed: body.confirmDesktopRestart === true, serverUrl: server.url }, async desktop => {
-      if (!operation.project) {
-        operation.project = (await server.request('project/read', { projectId })).project;
-        if (operation.project.id !== projectId) throw new Error('项目身份不一致，未执行移除。');
-        save();
-      }
-      const removeNative = async () => {
-        if (operation.nativeDeleted) return;
-        if (operation.deleteAttempted) {
-          // An explicit retry first resolves an earlier unknown response.
-          try { await server.request('project/read', { projectId }); }
-          catch (error) {
-            if (error.message !== `project not found: ${projectId}`) throw error;
-            operation.nativeDeleted = true; save(); return;
-          }
-        }
-        operation.deleteAttempted = true; save();
-        await server.request('project/delete', { projectId });
-        operation.nativeDeleted = true; save();
-      };
-      const desktopRemoval = await desktop.remove(operation.project, operation, save, removeNative);
-      operation.result = { projectId, desktopRemoval };
-      save();
-      return operation.result;
-    });
-  }
-}
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { readRecord, writeRecord } from './service-lifecycle.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;
+
+export async function removeWorkstationProject(server, stateRoot, codexDataRoot, projectId, body, dependencies = {}) {
+  if (!projectId || !uuid.test(body.idempotencyKey || '')) throw Object.assign(new Error('项目移除标识无效。'), { statusCode: 400 });
+  const record = path.join(stateRoot, 'project-remove-operations', `${body.idempotencyKey}.json`);
+  const running = pending.get(record);
+  if (running) {
+    if (running.projectId !== projectId) throw Object.assign(new Error('同一请求不能移除其他项目。'), { statusCode: 409 });
+    return running.promise;
+  }
+  const promise = perform().finally(() => pending.delete(record));
+  pending.set(record, { projectId, promise });
+  return promise;
+
+  async function perform() {
+    await fs.mkdir(path.dirname(record), { recursive: true });
+    const operation = readRecord(record) || { projectId };
+    if (operation.projectId !== projectId) throw Object.assign(new Error('移除标识已用于其他项目。'), { statusCode: 409 });
+    if (operation.result) return operation.result;
+    const save = () => writeRecord(record, operation);
+    const registration = dependencies.registration || withDesktopProjectRegistration;
+    return registration({ stateRoot, codexDataRoot, operationId: body.idempotencyKey, operation: 'remove',
+      confirmed: body.confirmDesktopRestart === true, serverUrl: server.url }, async desktop => {
+      if (!operation.project) {
+        operation.project = (await server.request('project/read', { projectId })).project;
+        if (operation.project.id !== projectId) throw new Error('项目身份不一致，未执行移除。');
+        save();
+      }
+      const removeNative = async () => {
+        if (operation.nativeDeleted) return;
+        if (operation.deleteAttempted) {
+          // An explicit retry first resolves an earlier unknown response.
+          try { await server.request('project/read', { projectId }); }
+          catch (error) {
+            if (error.message !== `project not found: ${projectId}`) throw error;
+            operation.nativeDeleted = true; save(); return;
+          }
+        }
+        operation.deleteAttempted = true; save();
+        await server.request('project/delete', { projectId });
+        operation.nativeDeleted = true; save();
+      };
+      const desktopRemoval = await desktop.remove(operation.project, operation, save, removeNative);
+      operation.result = { projectId, desktopRemoval };
+      save();
+      return operation.result;
+    });
+  }
+}

package/dist/src/project-update.mjs

@@ -1,59 +1,59 @@
-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 { withDesktopProjectRegistration } from './platform/desktop-project-registration.mjs';
-
-const pending = new Map();
-const fail = message => { throw Object.assign(new Error(message), { statusCode: 409 }); };
-const rootKey = roots => JSON.stringify(roots.map(root => process.platform === 'win32' ? path.normalize(root.path).toLowerCase() : path.normalize(root.path)));
-const same = (a, b) => a.name === b.name && rootKey(a.roots) === rootKey(b.roots);
-
-export async function updateWorkstationProject(server, stateRoot, codexDataRoot, projectId, body, dependencies = {}) {
-  const name = typeof body.name === 'string' ? body.name.trim() : '';
-  if (!name || !Array.isArray(body.roots) || body.roots.some(root => typeof root?.path !== 'string' || !path.isAbsolute(root.path.trim()))
-    || !/^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i.test(body.idempotencyKey || '')) fail('项目名称、文件夹或操作标识无效。');
-  const target = { name, roots: body.roots.map(root => ({ path: path.normalize(root.path.trim()) })) };
-  const signature = createHash('sha256').update(JSON.stringify({ projectId, ...target })).digest('hex');
-  const record = path.join(stateRoot, 'project-update-operations', `${body.idempotencyKey}.json`);
-  const active = pending.get(record);
-  if (active) { if (active.signature !== signature) fail('同一请求不能修改其他项目内容。'); return active.promise; }
-  const promise = perform().finally(() => pending.delete(record));
-  pending.set(record, { signature, promise }); return promise;
-
-  async function perform() {
-    await fs.mkdir(path.dirname(record), { recursive: true });
-    const operation = readRecord(record) || { signature };
-    if (operation.signature !== signature) fail('项目编辑标识已用于其他内容。');
-    if (operation.result) return operation.result;
-    const save = () => writeRecord(record, operation);
-    const rpc = (method, params) => server.request(method, params);
-    try {
-      return await (dependencies.registration || withDesktopProjectRegistration)({ stateRoot, codexDataRoot,
-        operationId: body.idempotencyKey, operation: 'update', confirmed: body.confirmDesktopRestart === true, serverUrl: server.url }, async desktop => {
-        const current = (await rpc('project/read', { projectId })).project;
-        if (current.id !== projectId) fail('项目身份不一致。');
-        if (current.roots.length && rootKey(current.roots.slice(0, 1)) !== rootKey(target.roots.slice(0, 1))) {
-          fail('编辑项目不能修改或移除主目录。');
-        }
-        operation.previousProject ||= current;
-        if (!same(current, operation.previousProject) && !same(current, target)) fail('项目已被其他操作修改，请刷新后重新编辑。');
-        let project = current;
-        if (!same(current, target)) {
-          const rootsChanged = rootKey(current.roots) !== rootKey(target.roots);
-          const roots = rootsChanged ? await projectRoots(rpc, target.roots) : current.roots;
-          operation.updateAttempted = true; save();
-          project = (await rpc('project/update', { projectId, name, roots })).project;
-        }
-        save();
-        const desktopRegistration = await desktop.register(project, operation, save);
-        operation.result = { project: projectSummary(project), desktopRegistration }; save(); return operation.result;
-      });
-    } catch (error) {
-      error.details = { ...error.details, projectUpdatePending: operation.updateAttempted === true };
-      if (operation.updateAttempted) error.message += ' 请继续完成本次同步，会先核对已有修改。';
-      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 { withDesktopProjectRegistration } from './platform/desktop-project-registration.mjs';
+
+const pending = new Map();
+const fail = message => { throw Object.assign(new Error(message), { statusCode: 409 }); };
+const rootKey = roots => JSON.stringify(roots.map(root => process.platform === 'win32' ? path.normalize(root.path).toLowerCase() : path.normalize(root.path)));
+const same = (a, b) => a.name === b.name && rootKey(a.roots) === rootKey(b.roots);
+
+export async function updateWorkstationProject(server, stateRoot, codexDataRoot, projectId, body, dependencies = {}) {
+  const name = typeof body.name === 'string' ? body.name.trim() : '';
+  if (!name || !Array.isArray(body.roots) || body.roots.some(root => typeof root?.path !== 'string' || !path.isAbsolute(root.path.trim()))
+    || !/^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i.test(body.idempotencyKey || '')) fail('项目名称、文件夹或操作标识无效。');
+  const target = { name, roots: body.roots.map(root => ({ path: path.normalize(root.path.trim()) })) };
+  const signature = createHash('sha256').update(JSON.stringify({ projectId, ...target })).digest('hex');
+  const record = path.join(stateRoot, 'project-update-operations', `${body.idempotencyKey}.json`);
+  const active = pending.get(record);
+  if (active) { if (active.signature !== signature) fail('同一请求不能修改其他项目内容。'); return active.promise; }
+  const promise = perform().finally(() => pending.delete(record));
+  pending.set(record, { signature, promise }); return promise;
+
+  async function perform() {
+    await fs.mkdir(path.dirname(record), { recursive: true });
+    const operation = readRecord(record) || { signature };
+    if (operation.signature !== signature) fail('项目编辑标识已用于其他内容。');
+    if (operation.result) return operation.result;
+    const save = () => writeRecord(record, operation);
+    const rpc = (method, params) => server.request(method, params);
+    try {
+      return await (dependencies.registration || withDesktopProjectRegistration)({ stateRoot, codexDataRoot,
+        operationId: body.idempotencyKey, operation: 'update', confirmed: body.confirmDesktopRestart === true, serverUrl: server.url }, async desktop => {
+        const current = (await rpc('project/read', { projectId })).project;
+        if (current.id !== projectId) fail('项目身份不一致。');
+        if (current.roots.length && rootKey(current.roots.slice(0, 1)) !== rootKey(target.roots.slice(0, 1))) {
+          fail('编辑项目不能修改或移除主目录。');
+        }
+        operation.previousProject ||= current;
+        if (!same(current, operation.previousProject) && !same(current, target)) fail('项目已被其他操作修改，请刷新后重新编辑。');
+        let project = current;
+        if (!same(current, target)) {
+          const rootsChanged = rootKey(current.roots) !== rootKey(target.roots);
+          const roots = rootsChanged ? await projectRoots(rpc, target.roots) : current.roots;
+          operation.updateAttempted = true; save();
+          project = (await rpc('project/update', { projectId, name, roots })).project;
+        }
+        save();
+        const desktopRegistration = await desktop.register(project, operation, save);
+        operation.result = { project: projectSummary(project), desktopRegistration }; save(); return operation.result;
+      });
+    } catch (error) {
+      error.details = { ...error.details, projectUpdatePending: operation.updateAttempted === true };
+      if (operation.updateAttempted) error.message += ' 请继续完成本次同步，会先核对已有修改。';
+      throw error;
+    }
+  }
+}

package/dist/src/relay-config-import.mjs

@@ -1,45 +1,45 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { execFile } from 'node:child_process';
-import { promisify } from 'node:util';
-import { credentialStore } from './platform/credential-store.mjs';
-import { readRecord } from './service-lifecycle.mjs';
-
-const exec = promisify(execFile);
-
-// One-time installation transfer. Execute the previously installed reader at
-// its original location before replacing it; the new runtime never uses a vault.
-export async function importRelayConfig(serviceRoot, stateRoot, nodeExecutable = process.execPath) {
-  const configuredId = readRecord(path.join(stateRoot, 'self-relay-config.json'))?.deviceId;
-  const validate = record => {
-    if (record?.version !== 2 || !record.devices || typeof record.devices !== 'object' || Array.isArray(record.devices)
-        || Object.entries(record.devices).some(([id, item]) => !/^[\w-]{16,128}$/.test(id) || item?.id !== id
-          || !/^[A-Za-z0-9_-]{43}$/.test(item.secret || '') || typeof item.registered !== 'boolean')
-        || (configuredId && configuredId !== 'new' && !record.devices[configuredId])) {
-      throw new Error('工作站身份配置不完整或与当前工作站不一致，未停止旧服务。');
-    }
-  };
-  const current = credentialStore('load', undefined, stateRoot).record;
-  if (current) { validate(current); return { status: 'already-configured' }; }
-  const legacy = path.join(serviceRoot, 'dist/src/platform', process.platform === 'win32' ? 'windows'
-    : process.platform === 'darwin' ? 'macos' : 'linux', 'credential-store.mjs');
-  if (!fs.existsSync(legacy)) {
-    if (configuredId && configuredId !== 'new') throw new Error('缺少当前工作站身份配置，未停止旧服务；请先完成原配对转存。');
-    return { status: 'not-needed' };
-  }
-  let record;
-  try {
-    const script = 'import { pathToFileURL } from "node:url"; const {credentialStore} = await import(pathToFileURL(process.argv[1])); '
-      + 'process.stdout.write(JSON.stringify((await credentialStore("load")).record));';
-    const { stdout } = await exec(nodeExecutable, ['--input-type=module', '-e', script, legacy],
-      { windowsHide: true, timeout: 65000, maxBuffer: 1024 * 1024 });
-    record = JSON.parse(stdout.replace(/^\uFEFF/, ''));
-    if (record === null && !configuredId) return { status: 'not-found' };
-    validate(record);
-  } catch {
-    // Never log execFile's error: it can contain stdout with the old identity.
-    throw new Error('原设备配对配置转存失败，未停止旧服务。无人值守更新已中止，未更换工作站身份；请先完成原配对转存。');
-  }
-  credentialStore('save', record, stateRoot);
-  return { status: 'imported' };
-}
+import fs from 'node:fs';
+import path from 'node:path';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { credentialStore } from './platform/credential-store.mjs';
+import { readRecord } from './service-lifecycle.mjs';
+
+const exec = promisify(execFile);
+
+// One-time installation transfer. Execute the previously installed reader at
+// its original location before replacing it; the new runtime never uses a vault.
+export async function importRelayConfig(serviceRoot, stateRoot, nodeExecutable = process.execPath) {
+  const configuredId = readRecord(path.join(stateRoot, 'self-relay-config.json'))?.deviceId;
+  const validate = record => {
+    if (record?.version !== 2 || !record.devices || typeof record.devices !== 'object' || Array.isArray(record.devices)
+        || Object.entries(record.devices).some(([id, item]) => !/^[\w-]{16,128}$/.test(id) || item?.id !== id
+          || !/^[A-Za-z0-9_-]{43}$/.test(item.secret || '') || typeof item.registered !== 'boolean')
+        || (configuredId && configuredId !== 'new' && !record.devices[configuredId])) {
+      throw new Error('工作站身份配置不完整或与当前工作站不一致，未停止旧服务。');
+    }
+  };
+  const current = credentialStore('load', undefined, stateRoot).record;
+  if (current) { validate(current); return { status: 'already-configured' }; }
+  const legacy = path.join(serviceRoot, 'dist/src/platform', process.platform === 'win32' ? 'windows'
+    : process.platform === 'darwin' ? 'macos' : 'linux', 'credential-store.mjs');
+  if (!fs.existsSync(legacy)) {
+    if (configuredId && configuredId !== 'new') throw new Error('缺少当前工作站身份配置，未停止旧服务；请先完成原配对转存。');
+    return { status: 'not-needed' };
+  }
+  let record;
+  try {
+    const script = 'import { pathToFileURL } from "node:url"; const {credentialStore} = await import(pathToFileURL(process.argv[1])); '
+      + 'process.stdout.write(JSON.stringify((await credentialStore("load")).record));';
+    const { stdout } = await exec(nodeExecutable, ['--input-type=module', '-e', script, legacy],
+      { windowsHide: true, timeout: 65000, maxBuffer: 1024 * 1024 });
+    record = JSON.parse(stdout.replace(/^\uFEFF/, ''));
+    if (record === null && !configuredId) return { status: 'not-found' };
+    validate(record);
+  } catch {
+    // Never log execFile's error: it can contain stdout with the old identity.
+    throw new Error('原设备配对配置转存失败，未停止旧服务。无人值守更新已中止，未更换工作站身份；请先完成原配对转存。');
+  }
+  credentialStore('save', record, stateRoot);
+  return { status: 'imported' };
+}