xuym-codex-collab 0.10.0 → 0.10.2

package/README.md

@@ -15,6 +15,8 @@ codex-collab setup
 
 安装后，先运行 `codex-collab setup`。已有业务项目时，进入项目目录再运行可自动带入信息；没有本机 clone 时可让向导拉取。以后直接运行 `codex-collab` 也会打开向导。上面的 `--foreground-scripts` 会让 npm 显示安装完成后的下一步提示。安装过程不会自动打开浏览器或修改项目；未使用此参数时 npm 可能隐藏提示，使用 `--ignore-scripts` 时会跳过提示，都可以直接运行 `codex-collab setup` 开始。
 
+升级 npm 包后重新运行 `codex-collab setup`，向导会检查后台服务版本，自动切换到本次安装的版本并打开新链接。同版本重复打开会复用现有服务，已有项目配置、对话绑定和独立运行的机器人连接保留。
+
 向导每屏只处理一个动作。管理员选择“接入一个项目”，确认目录和自动识别的分支、验证命令，再填写 Bot ID/Secret；成员选择“接受同事的邀请”，读取接入包后确认项目目录。群身份验证、等待审批和本机配置会自动衔接。最后复制指令到指定 Codex 对话，页面依据实际绑定和轮询记录显示完成。已在使用旧配置的成员可在首页“其他接入方式”中选择“导入已有配置”。命令启动后台工作台后退出，可以关闭终端和浏览器。macOS 默认设置登录自启；Linux 尝试配置 systemd 用户服务，失败时明确提示。工作台每 15 秒检查一次已开启的机器人进程，意外退出时恢复并在失败后退避重试；手动停止的连接保持停止。
 
 | 谁 | 在工作台做什么 | 接入后需要保留什么 |
@@ -26,7 +28,7 @@ codex-collab setup
 
 协作远程与业务基准分支自动识别；不要求 `origin/main`。有多个不同远程或默认分支不明确时，管理员选择一次。成员与新增机器人继承签名团队基准，各自可使用不同远程别名。每个新任务固定创建时的 commit，排队和重试期间不会漂移；管理员可在团队设置里为后续任务修改基准分支。
 
-工作台首页按项目汇总，同一仓库的多个本机机器人共用一张项目卡片。打开项目后，所有团队机器人展示在同一列表里，自己的标记“我的”；本机已接入的机器人可继续配置或管理，其他机器人的职责来自签名团队记录。分支、诊断、重置和团队分配设置按需展开。首页以“让 Codex 组队工作”为入口：在企业微信群里连接你和同事的 Codex 会话，按角色分工、接力完成任务。界面提供纸白、夜色两种配色，以及从本机加载的 Three.js 星尘背景、轻微鼠标视差与短尾迹；触屏和系统减少动态效果设置下显示静态星点，页面进入后台时暂停动画。
+工作台首页按项目汇总，同一仓库的多个本机机器人共用一张项目卡片。打开项目后，所有团队机器人展示在同一列表里，自己的标记“我的”；本机已接入的机器人可继续配置或管理，其他机器人的职责来自签名团队记录。分支、诊断、重置和团队分配设置按需展开。首页以“让 Codex 组队工作”为入口：在企业微信群里连接你和同事的 Codex 会话，按角色分工、接力完成任务。界面提供纸白、夜色两种配色，首次打开默认夜色，并记住用户的选择；背景使用从本机加载的 Three.js 星尘效果、轻微鼠标视差与短尾迹。触屏和系统减少动态效果设置下显示静态星点，页面进入后台时暂停动画。
 
 同一个真人可以拥有多个 Agent，每个 Agent 使用独立机器人、签名身份、业务 clone 和 Codex 对话。管理员在项目页点击“添加我的机器人”，验证同一个企业微信账号后自动接入，无需下载包或填写包密码；给同事分配时仍使用加密接入包，同事可以领取多份。相同 userid 不会合并 Agent 权限，审核通知会指明应使用的机器人。
 

package/apps/onboarding/main.mjs

@@ -8,8 +8,11 @@ import { SetupManager, savePrivate } from './manager.mjs';
 import { RunnerSupervisor } from './supervisor.mjs';
 import { workspaceHome } from './workspace.mjs';
 import { configureStartup, startupStatus } from './startup.mjs';
-import { alive } from '../peer/process.mjs';
+import { alive, acquireRunnerControl } from '../peer/process.mjs';
 const entry = fileURLToPath(import.meta.url);
+const { version } = JSON.parse(await readFile(new URL('../../package.json', import.meta.url), 'utf8'));
+const runtime = { version, entry, node: process.execPath };
+const sameRuntime = (state) => Object.entries(runtime).every(([key, value]) => state.runtime?.[key] === value);
 function openBrowser(url) {
   const command = process.platform === 'darwin' ? ['open', url] : process.platform === 'win32' ? ['cmd', '/c', 'start', '', url] : ['xdg-open', url];
   const child = spawn(command[0], command.slice(1), { stdio: 'ignore' }); child.on('error', () => {}); child.unref();
@@ -38,7 +41,7 @@ export async function runService({ home = workspaceHome() } = {}) {
   try {
     const manager = new SetupManager({ home });
     app = await startSetupServer({ manager });
-    await lock.writeFile(JSON.stringify({ pid: process.pid, url: app.url, started_at: new Date().toISOString() }) + '\n'); await lock.close();
+    await lock.writeFile(JSON.stringify({ pid: process.pid, url: app.url, started_at: new Date().toISOString(), runtime }) + '\n'); await lock.close();
     const supervisor = new RunnerSupervisor(manager);
     const tick = async () => {
       try { await manager.exclusive(() => supervisor.tick()); } catch { /* Local diagnostics show missing/invalid profiles without logging secrets. */ }
@@ -53,9 +56,49 @@ export async function runService({ home = workspaceHome() } = {}) {
     return { ...app, stop };
   } catch (error) { await lock.close().catch(() => {}); await rm(path, { force: true }); if (app) await app.close(); throw error; }
 }
+async function stopOutdatedService(home, state) {
+  // A private lock can outlive its process. Authenticate the loopback service
+  // before signalling a legacy PID; never terminate an unrelated process.
+  let verified = false;
+  try {
+    const url = new URL(state.url);
+    if (url.protocol !== 'http:' || url.hostname !== '127.0.0.1' || !url.port || url.username || url.password || !/^#[a-f0-9]{64}$/.test(url.hash)) throw new Error();
+    const response = await fetch(`${url.origin}/api/session`, {
+      method: 'POST', redirect: 'error', signal: AbortSignal.timeout(5000),
+      headers: { Origin: url.origin, 'Content-Type': 'application/json' },
+      body: JSON.stringify({ token: url.hash.slice(1) }),
+    });
+    verified = response.ok && (await response.json()).ok === true;
+  } catch { /* Keep private service URLs and network errors out of diagnostics. */ }
+  if (!verified) throw new Error('无法确认旧版向导服务的身份，请检查后台服务后重试。');
+  const current = await serviceState(home);
+  if (!current || current.pid !== state.pid || current.url !== state.url) return;
+  try { process.kill(state.pid, 'SIGTERM'); }
+  catch (error) { if (error.code !== 'ESRCH') throw error; }
+  for (let attempt = 0; attempt < 150; attempt++) {
+    if (!alive(state.pid)) return;
+    await delay(100);
+  }
+  throw new Error('旧版向导服务尚未退出，请稍后重新运行 codex-collab setup。');
+}
 export async function runLocalSetup({ open = true, home = workspaceHome(), cwd = process.cwd(), foreground = false, startup = true } = {}) {
-  home = resolve(home); await savePrivate(join(home, 'context.json'), { cwd: resolve(cwd) });
+  home = resolve(home); await mkdir(home, { recursive: true, mode: 0o700 });
+  // Serialize launchers so two setup commands cannot both stop a service that
+  // another launcher has just upgraded. Runner processes keep their own locks.
+  const release = await acquireRunnerControl(join(home, 'launcher'), entry);
+  try {
+    await savePrivate(join(home, 'context.json'), { cwd: resolve(cwd) });
+    return await launchLocalSetup({ open, home, foreground, startup });
+  } finally { await release(); }
+}
+async function launchLocalSetup({ open, home, foreground, startup }) {
   let state = await serviceState(home);
+  if (state && !sameRuntime(state)) {
+    await stopOutdatedService(home, state);
+    state = await serviceState(home);
+    if (state && !sameRuntime(state)) throw new Error('向导服务正在更新，请稍后重新运行 codex-collab setup。');
+    console.log('已更新本机向导服务。');
+  }
   if (foreground) {
     if (state) { console.log(`本机工作台已运行：${state.url}`); if (open) openBrowser(state.url); return; }
     const app = await runService({ home }); if (app) { console.log(`Codex Collab 工作台：${app.url}`); if (open) openBrowser(app.url); } return app;

package/apps/onboarding/web/app.js

@@ -611,7 +611,7 @@ function initializeAppearance() {
     for (const choice of document.querySelectorAll('[data-theme-choice]')) choice.setAttribute('aria-pressed', String(choice.dataset.themeChoice === theme));
     try { localStorage.setItem('codex-collab-theme', theme); } catch {}
   }
-  let theme = 'day';
+  let theme = 'night';
   try { theme = new URL(location.href).searchParams.get('theme') || localStorage.getItem('codex-collab-theme') || theme; } catch {}
   apply(theme);
   for (const choice of document.querySelectorAll('[data-theme-choice]')) choice.onclick = () => apply(choice.dataset.themeChoice);

package/apps/onboarding/web/index.html

@@ -9,7 +9,7 @@
 <link rel="stylesheet" href="/style.css">
 <link rel="stylesheet" href="/effects.css">
 </head>
-<body data-theme="day">
+<body data-theme="night">
 <div id="ambient" aria-hidden="true">
 <div class="ambient-light light-one"></div>
 <div class="ambient-light light-two"></div>
@@ -664,10 +664,10 @@
 <footer class="demo-footer">
 <span>企业微信 · 本机协作</span>
 <div class="theme-picker" role="group" aria-label="页面配色">
-<button class="theme-choice" data-theme-choice="day" aria-pressed="true">
+<button class="theme-choice" data-theme-choice="day" aria-pressed="false">
 <i aria-hidden="true">
 </i>纸白</button>
-<button class="theme-choice" data-theme-choice="night" aria-pressed="false">
+<button class="theme-choice" data-theme-choice="night" aria-pressed="true">
 <i aria-hidden="true">
 </i>夜色</button>
 </div>

package/docs/releases/0.10.1.md

@@ -0,0 +1,16 @@
+# 0.10.1
+
+修复升级 npm 包后重新打开向导时，旧后台服务仍被复用，导致星尘资源无法加载、页面样式不完整的问题。旧服务持有旧的路由表，却读取安装目录里更新后的 HTML，新增资源会返回 401 或 404。
+
+- 后台服务记录启动时的软件版本、入口和 Node 路径。setup 在复用服务前检查这些信息；旧版本和未记录版本的服务会经过本机令牌验证，再正常退出并由新版替换。
+- 并发执行多个 setup 会串行处理升级，同版本继续复用同一个服务。无法确认旧服务身份或旧服务未及时退出时停止升级，不强制结束进程。
+- 服务切换保留项目配置、Codex 对话绑定、机器人运行意图和独立 Runner；打开向导时使用切换后的链接。
+
+升级后运行：
+
+```sh
+npm install --global xuym-codex-collab@0.10.1 --prefer-online
+codex-collab setup
+```
+
+回归覆盖旧服务迁移、版本不一致时替换、并发打开、同版本复用，以及无法验证身份时保留原进程；检查升级后的全部星尘与 Three.js 资源可访问，业务 API 仍要求登录。

package/docs/releases/0.10.2.md

@@ -0,0 +1,10 @@
+# 0.10.2：向导默认夜色主题
+
+向导首次打开时默认显示夜色，减少首次进入时的主题选择步骤。夜色和纸白的手动切换保持不变，选择保存在本机浏览器；URL 中有效的 `theme=day` 或 `theme=night` 仍会优先应用。历史上已移除的主题值继续回退到纸白。
+
+升级：
+
+```sh
+npm install --global xuym-codex-collab@0.10.2 --prefer-online
+codex-collab setup
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xuym-codex-collab",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "description": "Git-backed collaboration tools for Codex teams, with MCP, WeCom, and local runners.",
   "repository": {
     "type": "git",