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

package/README.md

@@ -19,13 +19,13 @@ npm i -g @walkhi/code-relax@beta --allow-scripts=@walkhi/code-relax --foreground
 ```powershell
 relax start           # 启动/复用 Bridge、受管 Codex 内核和已配置中继
 relax pair            # 启动/复用服务并打开配对二维码
-relax status
+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 shared-recovery-status`。Bridge 状态匹配且健康时直接复用；未知进程占用 45831/45839 时拒绝接管。`stop` 只停止 Bridge，不停止 Desktop 或受管 app-server。
+手机工作站详情可确认让 Desktop 接入 Codex 内核，独立进程逐步执行并保留 Bridge/中继连接，见[启用流程](../docs/shared-recovery.md)。本机恢复命令为 `relax shared-recover --confirm`，查看恢复结果用 `relax doctor`。Bridge 状态匹配且健康时直接复用；未知进程占用 45831/45839 时拒绝接管。`stop` 只停止 Bridge，不停止 Desktop 或受管 app-server。
 
 受管 app-server 通过隐藏控制台启动，使后续控制台子进程继承隐藏窗口。手机的项目、任务列表和新建任务均使用受管内核，不依赖 Desktop 工具管道；项目和任务 ID 保持原生值。
 
@@ -37,14 +37,10 @@ Codex 内核由官方 `codex app-server --listen ws://127.0.0.1:45839` 提供执
 
 ```powershell
 relax start --json
-relax relay-start --json
-relax relay-status --json
 relax pair --json
-relax relay-stop --json
-relax relay-revoke --json
 ```
 
-`start` 启动内核和 Bridge，并恢复已配置中继；`relay-start` 单独管理中继连接器。每台移动设备通过 `pair` 配对一次；新增设备不替换已有设备。连接器把 Windows hostname 和当前 Wi-Fi/有线网络候选经已认证 WebSocket 临时发送给手机，手机本地保存电脑名，只在设备身份验证通过后保存可达地址；服务器不持久化这些 Code Relax 中继 hostname、IP 或网络名。OpenAI 官方认证和设备配对仍直接访问 OpenAI；完成后，手机使用统一配对产生的设备凭据，通过独立元数据 WebSocket 把官方环境 ID、名称和 hostname 写入设备记录，不上传 OpenAI access token、配对码或登录态。停止连接器不撤销授权。
+`start` 启动内核和 Bridge，并在 Bridge 内恢复已配置中继。每台移动设备通过 `pair` 配对一次；新增设备不替换已有设备。Bridge 把 Windows hostname 和当前 Wi-Fi/有线网络候选经已认证 WebSocket 临时发送给手机，手机本地保存电脑名，只在设备身份验证通过后保存可达地址；服务器不持久化这些 Code Relax 中继 hostname、IP 或网络名。OpenAI 官方认证和设备配对仍直接访问 OpenAI；完成后，手机使用统一配对产生的设备凭据，通过独立元数据 WebSocket 把官方环境 ID、名称和 hostname 写入设备记录，不上传 OpenAI access token、配对码或登录态。
 
 Bridge 的局域网端口仅提供鉴权 WebSocket，普通 HTTP 请求返回 404；手机聊天页面随 HAP 安装。
 

package/dist/bin/codex-remote.mjs

@@ -4,7 +4,7 @@ import { lifecycle, readRecord } from '../src/service-lifecycle.mjs';
 import { runtimePaths } from '../src/platform/windows/runtime-paths.mjs';
 import * as host from '../src/platform/windows/service-host.mjs';
 import { installService, uninstallService, packageRoot } from '../src/service-install.mjs';
-import { installSkill, removeSkill, inspectSkill } from '../src/skill-install.mjs';
+import { installSkill, removeSkill, inspectSkill } from '../src/skill-install.mjs';
 import { doctor } from '../src/service-doctor.mjs';
 import { launchDesktop } from '../src/desktop-launcher.mjs';
 import { desktopHost, removeDesktopShortcut, residentStartup, resolveStateRoot } from '../src/platform/windows/desktop-host.mjs';
@@ -14,31 +14,25 @@ import path from 'node:path';
 import fs from 'node:fs';
 import { spawn } from 'node:child_process';
 import { setTimeout as delay } from 'node:timers/promises';
-import { requestRecovery, recoveryStatus, recoveryWarning } from '../src/shared-recovery.mjs';
-import { configureManagedEnvironment, clearManagedEnvironment, readManagedEnvironment } from '../src/platform/windows/user-environment.mjs';
+import { requestRecovery, recoveryWarning } from '../src/shared-recovery.mjs';
+import { configureManagedEnvironment, clearManagedEnvironment } from '../src/platform/windows/user-environment.mjs';
 import { resolveCodexRuntime } from '../src/platform/windows/codex-runtime.mjs';
-import { managedAppServerUrl } from '../src/managed-app-server.mjs';
 import { controlRequest } from '../src/service-control.mjs';
 import { processAlive } from '../src/background-process.mjs';
 
 const help = `Code Relax（Windows）
 用法：relax <命令> [--json]；下列命令均可用
-  setup   部署并启动固定目录服务、受管 app-server 和登录自启动；安全配置 Desktop 后续接入
+常用指令：
   start   启动或复用 Bridge 和 Codex 内核，并恢复已配置的私有中继
-  shared-recover --confirm 重新打开 Desktop 并接入 Codex 内核；不强制重启已有内核
-  shared-recovery-status 查看最近一次恢复的实际阶段和结果
-  autostart-enable / autostart-disable / autostart-status 管理当前用户登录时启动 Bridge
   pair    启动或复用工作站服务，并打开一次性配对二维码
-  status  查看服务健康状态
-  stop    停止服务
-  relay-start 启动或复用私有中继，已有授权直接恢复，首次授权生成二维码
-  relay-status 查看私有中继连接器及移动端连接状态
-  relay-stop 停止私有中继连接器，不停止 Bridge 或 Codex
-  relay-revoke 撤销这台电脑的全部移动设备授权（停止连接器不会撤销授权）
-  doctor  检查安装、Node、Codex 内核、网络和 Skill，提示防火墙处理方式
-  skill-install 安装/更新当前用户的 Codex Skill，不覆盖自定义文件
-  skill-remove  移除本包安装且未修改的 Skill
+  stop    停止服务
+维护指令：
+  setup   部署并启动固定目录服务、受管 app-server 和登录自启动；安全配置 Desktop 后续接入
+  doctor  检查服务、登录自启、最近恢复结果、网络和 Skill
+  shared-recover --confirm 重新打开 Desktop 并接入 Codex 内核；不强制重启已有内核
   uninstall 停止并移除固定目录服务和本包 Skill，清理自有 Desktop 环境变量，保留其他配置与附件
+其他指令：
+  autostart-enable 启用当前用户登录启动
 默认监听 0.0.0.0，移动端与电脑需在同一受信任局域网。
 --json 输出机器可读结果；统一二维码不含 LAN 地址、Bridge Token 或中继地址。`;
 
@@ -48,7 +42,7 @@ async function main() {
     console.log(help);
     return;
   }
-  if (!['autostart-enable', 'autostart-disable', 'autostart-status', 'shared-recover', 'shared-recovery-status', 'relay-revoke', 'relay-start', 'relay-status', 'relay-stop', 'setup', 'doctor', 'skill-install', 'skill-remove', 'uninstall', 'start', 'pair', 'status', 'stop'].includes(command)
+  if (!['autostart-enable', 'shared-recover', 'setup', 'doctor', 'uninstall', 'start', 'pair', 'stop'].includes(command)
     || flags.some(flag => flag !== '--json' && !(command === 'shared-recover' && flag === '--confirm'))) {
     throw new Error('无效命令或参数。使用 --help 查看用法。');
   }
@@ -56,13 +50,8 @@ async function main() {
   const json = flags.includes('--json');
   const paths = runtimePaths();
   const { stateRoot, serviceRoot } = paths;
-  if (['relay-revoke', 'relay-start', 'relay-status', 'relay-stop'].includes(command)) {
-    const result = await selfRelay(command, stateRoot);
-    console.log(json ? JSON.stringify(result) : `${result.displayText}${result.qrPath ? '\n二维码：' + result.qrPath : ''}`);
-    return;
-  }
   const installedEntry = path.join(serviceRoot, 'dist/bin/codex-remote.mjs');
-  if (['autostart-enable', 'autostart-disable', 'autostart-status', 'shared-recover', 'shared-recovery-status', 'start', 'pair', 'status', 'stop'].includes(command) && path.resolve(fileURLToPath(import.meta.url)).toLowerCase() !== installedEntry.toLowerCase()) {
+  if (['autostart-enable', 'shared-recover', 'start', 'pair', 'stop'].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。');
@@ -77,13 +66,6 @@ async function main() {
     if (!installation?.nodeExecutable) throw new Error('请先执行 setup。');
     const action = command.slice('autostart-'.length);
     let environment;
-    if (action === 'disable') {
-      environment = await clearManagedEnvironment(stateRoot);
-      const current = await readManagedEnvironment();
-      if (current.userValue === managedAppServerUrl || (!current.userValue && current.machineValue === managedAppServerUrl)) {
-        throw new Error('Desktop 仍会连接 Code Relax 内核；请先处理非本包管理的 CODEX_APP_SERVER_WS_URL，未关闭登录启动。');
-      }
-    }
     if (action === 'enable') {
       const running = await service.status();
       if (!running.running) await service.start();
@@ -103,10 +85,9 @@ async function main() {
         environment?.configured ? '；已配置 Desktop 接入地址' : '';
     console.log(json ? JSON.stringify(output) : `登录启动：${result.enabled ? '已启用' : '已关闭'}${environmentText}`); return;
   }
-  if (command === 'shared-recover' || command === 'shared-recovery-status') {
-    if (command === 'shared-recover' && !flags.includes('--confirm')) throw new Error(recoveryWarning + ' 使用 --confirm 确认。');
-    const result = command === 'shared-recover'
-      ? await requestRecovery(stateRoot, { confirmed: true }) : await recoveryStatus(stateRoot);
+  if (command === 'shared-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());
     return;
   }
@@ -131,13 +112,6 @@ async function main() {
     if (!result.ready) process.exitCode = 1;
     return;
   }
-  if (command === 'skill-install' || command === 'skill-remove') {
-    const result = command === 'skill-install'
-      ? installSkill(path.join(packageRoot(path.dirname(fileURLToPath(import.meta.url))), 'dist/skills/code-relax/SKILL.md'))
-      : removeSkill();
-    console.log(json ? JSON.stringify(result) : `${result.message}\n${result.target}`);
-    return;
-  }
   if (command === 'uninstall') {
     const skill = inspectSkill();
     let environment;
@@ -253,6 +227,7 @@ async function main() {
       }
     }
     const autostart = await residentStartup(installed, 'enable');
+    const skill = installSkill(path.join(serviceRoot, 'dist/skills/code-relax/SKILL.md'));
     if (desktopNeedsAttach && !desktopRestarted) {
       const currentDesktop = await desktopHost.inspect();
       if (currentDesktop.running) await desktopHost.closeDesktop(currentDesktop.desktop);
@@ -262,6 +237,7 @@ async function main() {
       bridge = await service.status();
     }
     installed.autostart = autostart;
+    installed.skill = skill;
     installed.restarted = resumeAfterUpdate;
     installed.environment = environment;
     installed.managedAppServer = bridge.managedAppServer;
@@ -287,11 +263,6 @@ async function main() {
   }
   if (!json && command === 'start') console.log('正在检查电脑连接并准备 Bridge…');
   const result = await service[command]();
-  if (command === 'status') {
-    console.log(json ? JSON.stringify(result) : result.running
-      ? `服务正常：${result.mode}，版本 ${result.version || '未知'}，端口 ${result.port}，PID ${result.pid}` : '服务未就绪。');
-    return;
-  }
   const { accessUrl, qrPath: _legacyQrPath, ...metadata } = result;
   const notice = '本机服务检查通过，移动端连通性尚未验证。若电脑弹出 Node 网络访问提示，请先处理 Windows 防火墙授权，再用移动端连接。';
   let relay;

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

@@ -6,12 +6,12 @@ description: 启动、检查或停止 Code Relax 工作站服务，生成并展
 # Code Relax
 
 - `relax start --json` 启动 Bridge 和受管 Codex 内核，无需打开 Desktop；支持纯 CLI 安装。Desktop 正常打开后接入已配置内核；需要重新接入时使用 App 的“重启 Codex Desktop”或经确认的 `relax shared-recover --confirm`。已配置 Code Relax 中继时，启动命令同时恢复中继连接器和已有设备授权。
-- npm 全局安装会自动执行服务部署和 Skill 安装；只有修复安装时才单独运行 `relax setup --json` 或 `relax skill-install --json`。
-- `setup` 默认启用当前用户登录启动工作站服务，不自动打开 Codex；用 `autostart-status / autostart-disable / autostart-enable` 管理。恢复完整控制会保留 Bridge 和中继，但仍须明确确认可能中断全部完整控制任务。
+- npm 全局安装会自动执行服务部署和 Skill 安装；修复安装时运行 `relax setup --json`。
+- `setup` 默认启用当前用户登录启动工作站服务，不自动打开 Codex；用 `doctor` 查看、`autostart-enable` 恢复登录启动。恢复完整控制会保留 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 只保存设备凭据验证成功的网络记录。
-- `status --json` 查询工作站服务；`relay-status --json` 查询中继和授权设备数。`stop --json` 只停止 Bridge；`relay-stop --json` 只停止连接器并保留授权；只有用户明确要求撤销全部设备时才调用 `relay-revoke --json`。
+- `status --json` 查询工作站服务；`stop --json` 停止 Bridge，不停止受管 Codex 内核。中继连接由 Bridge 管理，不提供单独的中继 CLI 命令。
 - 启动或配对成功后，将 `qrPath` 以 Markdown 图片嵌入回复，并逐字展示 `displayText`。不要把二维码内容、Token 或 Base64 写进消息。
 - 不自动修改防火墙或发送测试消息。`lanAccess: unverified` 或 `mobileAccess: unverified` 只表示设备链路尚未现场验证。
 - 服务位于用户 `Programs/CodexRemote/service`；配置在 `LocalAppData/CodexRemote`；附件在 `ProgramData/CodexRemote/attachments`。不要删除配置、附件或凭据来排障。

package/dist/src/desktop-launcher.mjs

@@ -7,7 +7,7 @@ export { portAvailable };
 export async function launchDesktop({ stateRoot, host, environment = process.env, available = portAvailable, wait = delay, timeout = 30000, recoveryId, progress = () => {} }) {
   fs.mkdirSync(stateRoot, { recursive: true });
   const recovery = readRecord(path.join(stateRoot, 'shared-recovery.lock'));
-  if (recovery && recovery.operationId !== recoveryId) throw new Error('Codex 内核正在启动，请先查看 shared-recovery-status。');
+  if (recovery && recovery.operationId !== recoveryId) throw new Error('Codex 内核正在启动，请用 relax doctor 查看恢复状态。');
   const lock = path.join(stateRoot, 'desktop-launch.lock');
   let descriptor;
   let managed;

package/dist/src/self-relay/lifecycle.mjs

@@ -111,7 +111,7 @@ async function createRelayRuntime(stateRoot) {
       bridgeReady: health.status === 'ok' && health.execution?.ready === true && health.sharedAppServerConnected === true, bridgeError,
       expiresAt: expiresAt ? new Date(expiresAt).toISOString() : null,
       ...(available ? { qrPath } : {}), mobileAccess: 'unverified', lastError,
-      displayText: `Code Relax 中继 · ${health.transportMode === 'lan-shared' ? 'Codex 内核已就绪' : 'Codex 内核未就绪'}\n${next}\n停止连接器保留授权：relax relay-stop --json。撤销全部移动设备：relax relay-revoke --json。` };
+      displayText: `Code Relax 中继 · ${health.transportMode === 'lan-shared' ? 'Codex 内核已就绪' : 'Codex 内核未就绪'}\n${next}` };
   };
   async function shutdown() {
     if (closing) return;

package/dist/src/service-doctor.mjs

@@ -2,6 +2,8 @@ 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 }) {
   const checks = [];
@@ -41,10 +43,21 @@ 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',
+      `最近 Desktop 接入：${state.message || state.status}${state.error ? `；${state.error}` : ''}`);
+  });
   await check('skill', async () => {
     const state = inspectSkill(skillTarget);
     add('skill', state.managed ? 'ok' : 'warning', state.managed ? '本包管理的 Skill 已安装。'
-      : state.installed ? '存在同名自定义 Skill，本包不会覆盖。' : '可执行 relax skill-install 安装 Skill。');
+      : state.installed ? '存在同名自定义 Skill，本包不会覆盖。' : 'Skill 未安装；重新执行 relax setup。');
   });
   add('firewall', 'warning', '移动端连通性未验证。首次启动请允许记录的 Node 在受信任的专用网络通信；若曾拒绝，可在 Windows 安全中心的防火墙“允许应用通过防火墙”中检查该 Node。不要关闭整个防火墙。');
   return { ready: !checks.some(item => item.status === 'error'), lanAccess: 'unverified', checks };

package/package.json

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

package/tools/postinstall.mjs

@@ -66,13 +66,6 @@ export function formatSetupOutput(output, previous = {}) {
   } catch { return output; }
 }
 
-export function formatSkillOutput(output) {
-  try {
-    const result = JSON.parse(output);
-    return `Code Relax Skill：${result.message || (result.installed ? '已安装' : '已检查')}\n`;
-  } catch { return output; }
-}
-
 function installationSnapshot() {
   const recordPath = path.join(serviceRoot, 'installation.json');
   if (!fs.existsSync(serviceRoot)) return { exists: false, valid: false };
@@ -113,34 +106,22 @@ 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；无需重新卸载服务。`;
-}
-
 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()}`);
   try {
-    runStage(entry, stage, ['setup', '--json'], output => formatSetupOutput(output, previous));
-    stage = 'skill-install';
-    runStage(entry, stage, ['skill-install', '--json'], formatSkillOutput);
+    runStage(entry, 'setup', ['setup', '--json'], output => formatSetupOutput(output, previous));
     console.log(`安装日志：${installLog}`);
     appendLog('[postinstall] success');
   } catch (error) {
     const current = installationSnapshot();
-    console.error(`\nCode Relax 安装未完全完成：\n${stage === 'setup'
-      ? setupFailureGuidance(previous, current)
-      : skillFailureGuidance(previous, current)}`);
+    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;
   }
 }