@walkhi/code-relax 0.1.0-beta.14 → 0.1.0-beta.16

package/README.md

@@ -20,12 +20,11 @@ npm i -g @walkhi/code-relax@beta --allow-scripts=@walkhi/code-relax --foreground
 relax start           # 启动/复用 Bridge、受管 Codex 内核和已配置中继
 relax pair            # 启动/复用服务并打开配对二维码
 relax doctor          # 集中查看服务、登录自启和最近恢复结果
-relax stop
 ```
 
 Codex 内核由官方 `codex app-server --listen ws://127.0.0.1:45839` 提供执行服务，Desktop 和 Bridge 均可连接；它只监听回环地址。Bridge 独立报告内核健康、Desktop 接入和手机可写状态；Desktop 退出后，手机仍可操作内核中的任务。同一 thread 已被另一个实例持有时，手机只读且可重新检测。
 
-手机工作站详情可确认让 Desktop 接入 Codex 内核，独立进程逐步执行并保留 Bridge/中继连接，见[启用流程](../docs/shared-recovery.md)。本机恢复命令为 `relax shared-recover --confirm`，查看恢复结果用 `relax doctor`。Bridge 状态匹配且健康时直接复用；未知进程占用 45831/45839 时拒绝接管。`stop` 只停止 Bridge，不停止 Desktop 或受管 app-server。
+手机工作站详情可确认让 Desktop 接入 Codex 内核，独立进程逐步执行并保留 Bridge/中继连接，见[启用流程](../docs/shared-recovery.md)。本机恢复命令为 `relax desktop-recover --confirm`，查看恢复结果用 `relax doctor`。Bridge 状态匹配且健康时直接复用；未知进程占用 45831/45839 时拒绝接管。
 
 受管 app-server 通过隐藏控制台启动，使后续控制台子进程继承隐藏窗口。手机的项目、任务列表和新建任务均使用受管内核，不依赖 Desktop 工具管道；项目和任务 ID 保持原生值。
 
@@ -52,7 +51,7 @@ Bridge 的局域网端口仅提供鉴权 WebSocket，普通 HTTP 请求返回 40
 npm i -g @walkhi/code-relax@beta --allow-scripts=@walkhi/code-relax --foreground-scripts
 ```
 
-`setup` 先暂存并校验新版本，再短暂停止 Bridge/中继完成切换；原服务此前正在运行时会自动恢复，新版本启动失败则回滚并启动旧版本。无需提前执行 `stop`。Node 路径变化或原 Node 被删除后需重新 setup。升级可能因 Node 可执行文件路径变化而再次触发 Windows 防火墙授权。
+`setup` 先暂存并校验新版本，再短暂停止 Bridge/中继完成切换；原服务此前正在运行时会自动恢复，新版本启动失败则回滚并启动旧版本。无需提前停止服务。Node 路径变化或原 Node 被删除后需重新 setup。升级可能因 Node 可执行文件路径变化而再次触发 Windows 防火墙授权。
 
 卸载：
 

package/dist/bin/codex-remote.mjs

@@ -25,15 +25,12 @@ const help = `Code Relax（Windows）
 常用指令：
   start   启动或复用 Bridge 和 Codex 内核，并恢复已配置的私有中继
   pair    启动或复用工作站服务，并打开一次性配对二维码
-  stop    停止服务
 维护指令：
   setup   部署并启动固定目录服务、受管 app-server 和登录自启动；安全配置 Desktop 后续接入
   doctor  检查服务、登录自启、最近恢复结果、网络和 Skill
-  shared-recover --confirm 重新打开 Desktop 并接入 Codex 内核；不强制重启已有内核
+  desktop-recover --confirm 重新打开 Desktop 并接入 Codex 内核；不强制重启已有内核
   uninstall 停止并移除固定目录服务和本包 Skill，清理自有 Desktop 环境变量，保留其他配置与附件
-其他指令：
-  autostart-enable 启用当前用户登录启动
-默认监听 0.0.0.0，移动端与电脑需在同一受信任局域网。
+默认监听 0.0.0.0，移动端与电脑需在同一受信任局域网。
 --json 输出机器可读结果；统一二维码不含 LAN 地址、Bridge Token 或中继地址。`;
 
 async function main() {
@@ -42,8 +39,8 @@ async function main() {
     console.log(help);
     return;
   }
-  if (!['autostart-enable', 'shared-recover', 'setup', 'doctor', 'uninstall', 'start', 'pair', 'stop'].includes(command)
-    || flags.some(flag => flag !== '--json' && !(command === 'shared-recover' && flag === '--confirm'))) {
+  if (!['desktop-recover', 'setup', 'doctor', 'uninstall', 'start', 'pair'].includes(command)
+    || flags.some(flag => flag !== '--json' && !(command === 'desktop-recover' && flag === '--confirm'))) {
     throw new Error('无效命令或参数。使用 --help 查看用法。');
   }
   if (process.platform !== 'win32') throw new Error('当前被控端仅支持 Windows。');
@@ -51,7 +48,7 @@ async function main() {
   const paths = runtimePaths();
   const { stateRoot, serviceRoot } = paths;
   const installedEntry = path.join(serviceRoot, 'dist/bin/codex-remote.mjs');
-  if (['autostart-enable', 'shared-recover', 'start', 'pair', 'stop'].includes(command) && path.resolve(fileURLToPath(import.meta.url)).toLowerCase() !== installedEntry.toLowerCase()) {
+  if (['desktop-recover', 'start', 'pair'].includes(command) && path.resolve(fileURLToPath(import.meta.url)).toLowerCase() !== installedEntry.toLowerCase()) {
     if (!fs.existsSync(installedEntry)) throw new Error('尚未部署服务，请先执行 relax setup。');
     const executable = readRecord(path.join(serviceRoot, 'installation.json'))?.nodeExecutable;
     if (!executable || !fs.existsSync(executable)) throw new Error('安装时选用的 Node 不存在，请重新执行 relax setup。');
@@ -61,31 +58,25 @@ async function main() {
     return;
   }
   const service = lifecycle({ stateRoot, host });
-  if (command.startsWith('autostart-')) {
+  const ensureAutostart = async () => {
     const installation = readRecord(path.join(serviceRoot, 'installation.json'));
     if (!installation?.nodeExecutable) throw new Error('请先执行 setup。');
-    const action = command.slice('autostart-'.length);
-    let environment;
-    if (action === 'enable') {
-      const running = await service.status();
-      if (!running.running) await service.start();
-      const deadline = Date.now() + 35000;
-      while (true) {
-        const ready = await service.status();
-        if (ready.running && ready.managedAppServer?.ready) break;
-        if (Date.now() >= deadline) throw new Error('Codex 内核未就绪，未启用 Desktop 自动接入。');
-        await delay(250);
-      }
+    const current = await residentStartup({ serviceRoot, nodeExecutable: installation.nodeExecutable }, 'status');
+    if (current.enabled) return { ...current, repaired: false };
+    const running = await service.status();
+    if (!running.running) await service.start();
+    const deadline = Date.now() + 35000;
+    while (true) {
+      const ready = await service.status();
+      if (ready.running && ready.managedAppServer?.ready) break;
+      if (Date.now() >= deadline) throw new Error('Codex 内核未就绪，未启用 Desktop 自动接入。');
+      await delay(250);
     }
-    const result = await residentStartup({ serviceRoot, nodeExecutable: installation.nodeExecutable }, action);
-    if (action === 'enable' && (await desktopHost.inspect()).desktop) environment = await configureManagedEnvironment(stateRoot);
-    const output = { ...result, ...(environment ? { environment } : {}) };
-    const environmentText = environment?.preserved ? '；用户自定义的 Desktop 地址已保留，请自行核对' :
-      environment?.removed ? '；已清除 Code Relax 设置的 Desktop 地址' :
-        environment?.configured ? '；已配置 Desktop 接入地址' : '';
-    console.log(json ? JSON.stringify(output) : `登录启动：${result.enabled ? '已启用' : '已关闭'}${environmentText}`); return;
-  }
-  if (command === 'shared-recover') {
+    const result = await residentStartup({ serviceRoot, nodeExecutable: installation.nodeExecutable }, 'enable');
+    if ((await desktopHost.inspect()).desktop) await configureManagedEnvironment(stateRoot);
+    return { ...result, repaired: true };
+  };
+  if (command === 'desktop-recover') {
     if (!flags.includes('--confirm')) throw new Error(recoveryWarning + ' 使用 --confirm 确认。');
     const result = await requestRecovery(stateRoot, { confirmed: true });
     console.log(json ? JSON.stringify(result) : `${result.message || result.status}${result.error ? '\n' + result.error : ''}\n${result.operationId || ''}`.trim());
@@ -98,6 +89,7 @@ async function main() {
       bridge = await service.status();
     }
     if (!bridge.running) throw new Error('Code Relax 工作站服务未能启动。');
+    await ensureAutostart();
     const result = await selfRelay('relay-pair', stateRoot);
     if (!json && result.qrPath) {
       const viewer = spawn('explorer.exe', [result.qrPath], { detached: true, stdio: 'ignore', windowsHide: true });
@@ -107,7 +99,7 @@ async function main() {
     return;
   }
   if (command === 'doctor') {
-    const result = await doctor({ paths, host, service });
+    const result = await doctor({ paths, host, service, ensureAutostart });
     console.log(json ? JSON.stringify(result) : result.checks.map(item => `[${item.status}] ${item.message}`).join('\n'));
     if (!result.ready) process.exitCode = 1;
     return;
@@ -256,13 +248,9 @@ async function main() {
     console.log(json ? JSON.stringify({ ...installed, nextSteps: desktopSetupSteps, displayText: `${migrationText}${desktopSetupSteps.join('\n')}\n${restartText}` }) : `服务已安装：${installed.serviceRoot}\n使用已安装的 Node：${installed.nodeExecutable}\n受管 app-server 已就绪；首次联网可能需要 Windows 防火墙授权。\n${migrationText}${desktopSetupSteps.join('\n')}\n${restartText}`);
     return;
   }
-  if (command === 'stop') {
-    const result = await service.stop();
-    console.log(json ? JSON.stringify(result) : result.message);
-    return;
-  }
   if (!json && command === 'start') console.log('正在检查电脑连接并准备 Bridge…');
   const result = await service[command]();
+  await ensureAutostart();
   const { accessUrl, qrPath: _legacyQrPath, ...metadata } = result;
   const notice = '本机服务检查通过，移动端连通性尚未验证。若电脑弹出 Node 网络访问提示，请先处理 Windows 防火墙授权，再用移动端连接。';
   let relay;

package/dist/skills/code-relax/SKILL.md

@@ -5,9 +5,9 @@ description: 启动、检查或停止 Code Relax 工作站服务，生成并展
 
 # Code Relax
 
-- `relax start --json` 启动 Bridge 和受管 Codex 内核，无需打开 Desktop；支持纯 CLI 安装。Desktop 正常打开后接入已配置内核；需要重新接入时使用 App 的“重启 Codex Desktop”或经确认的 `relax shared-recover --confirm`。已配置 Code Relax 中继时，启动命令同时恢复中继连接器和已有设备授权。
+- `relax start --json` 启动 Bridge 和受管 Codex 内核，无需打开 Desktop；支持纯 CLI 安装。Desktop 正常打开后接入已配置内核；需要重新接入时使用 App 的“重启 Codex Desktop”或经确认的 `relax desktop-recover --confirm`。已配置 Code Relax 中继时，启动命令同时恢复中继连接器和已有设备授权。
 - npm 全局安装会自动执行服务部署和 Skill 安装；修复安装时运行 `relax setup --json`。
-- `setup` 默认启用当前用户登录启动工作站服务，不自动打开 Codex；用 `doctor` 查看、`autostart-enable` 恢复登录启动。恢复完整控制会保留 Bridge 和中继，但仍须明确确认可能中断全部完整控制任务。
+- `setup` 默认启用当前用户登录启动工作站服务，不自动打开 Codex；`start`、`pair`、`setup` 和 `doctor` 在自启缺失时自动恢复。恢复完整控制会保留 Bridge 和中继，但仍须明确确认可能中断全部完整控制任务。
 - 用户要求启动 Code Relax 时，执行一次 `relax start --json`。用户要求二维码或当前启动结果包含二维码时，展示 CLI 返回的 `qrPath` 和 `displayText`；没有设备授权时可用 `relax pair --json` 生成新的配对二维码。
 - 配对二维码是短期 HTTPS 邀请，不属于工作站或某一台移动设备，也不含 LAN IP、端口、Bridge Token 或中继地址。新增设备不撤销已有设备。
 - 已授权设备可直接使用 Code Relax 中继。App 以工作站名显示已配对电脑，进入后选择局域网、Code Relax 中继或 OpenAI 中继。启动命令会经已认证中继临时刷新当前 LAN 候选；App 只保存设备凭据验证成功的网络记录。

package/dist/src/service-doctor.mjs

@@ -2,10 +2,9 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { readRecord } from './service-lifecycle.mjs';
 import { inspectSkill } from './skill-install.mjs';
-import { residentStartup } from './platform/windows/desktop-host.mjs';
 import { recoveryStatus } from './shared-recovery.mjs';
 
-export async function doctor({ paths, host, service, skillTarget }) {
+export async function doctor({ paths, host, service, skillTarget, ensureAutostart }) {
   const checks = [];
   let installedVersion;
   const add = (id, status, message) => checks.push({ id, status, message });
@@ -28,6 +27,10 @@ export async function doctor({ paths, host, service, skillTarget }) {
     if (!address) throw Error('未找到局域网 IPv4；请连接受信任的 Wi-Fi 或有线网络。');
     add('network', 'ok', `局域网地址：${address}`);
   });
+  await check('autostart', async () => {
+    const state = await ensureAutostart();
+    add('autostart', 'ok', `当前用户登录自启：${state.repaired ? '已自动恢复' : '已启用'}。`);
+  });
   await check('service', async () => {
     const state = await service.status();
     add('service', state.running ? 'ok' : 'warning', state.running
@@ -43,12 +46,6 @@ export async function doctor({ paths, host, service, skillTarget }) {
     if (state.managedAppServer?.launcherRestartRequired) add('managed-app-server-launcher', 'warning',
       '安装文件已经更新，但当前 app-server 仍由旧启动链创建；隐藏控制台等运行时修复尚未生效，请执行 relax setup 或重启 Windows。');
   });
-  await check('autostart', async () => {
-    const record = readRecord(path.join(paths.serviceRoot, 'installation.json'));
-    if (!record?.nodeExecutable) throw Error('尚未安装服务，无法检查登录自启。');
-    const state = await residentStartup({ serviceRoot: paths.serviceRoot, nodeExecutable: record.nodeExecutable }, 'status');
-    add('autostart', state.enabled ? 'ok' : 'warning', `当前用户登录自启：${state.enabled ? '已启用' : '未启用'}。`);
-  });
   await check('desktop-recovery', async () => {
     const state = await recoveryStatus(paths.stateRoot);
     add('desktop-recovery', state.status === 'failed' ? 'warning' : 'ok',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walkhi/code-relax",
-  "version": "0.1.0-beta.14",
+  "version": "0.1.0-beta.16",
   "license": "UNLICENSED",
   "type": "module",
   "scripts": {