@walkhi/code-relax 0.1.0-beta.5 → 0.1.0-beta.50

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

@@ -1,17 +1,22 @@
 ---
 name: code-relax
-description: 启动、检查或停止 Code Relax 工作站服务，生成并展示配对二维码。
+description: 启动或检查 Code Relax 桌面服务，展示配对二维码，并指导回复来自手机 App 的消息；消息标记来自手机或包含语音转写时，指导理解和回复。
 ---
 
 # Code Relax
 
-- Bridge 可独立于 Desktop 启动；在 Desktop 任务中执行时保留注入环境，用于基础控制绑定上下文。启动工作站服务用 `relax start --json`；完整控制用 `relax shared-start --json`。已配置 Code Relax 中继时，启动命令同时恢复中继连接器和已有设备授权。
-- npm 全局安装会自动执行服务部署和 Skill 安装；只有修复安装时才单独运行 `relax setup --json` 或 `relax skill-install --json`。
-- `setup` 默认启用当前用户登录启动工作站服务，不自动打开 Codex；用 `autostart-status / autostart-disable / autostart-enable` 管理。恢复完整控制会保留 Bridge 和中继，但仍须明确确认可能中断全部完整控制任务。
+- 消息来源上下文引用 `$code-relax` 时，按本 Skill 理解手机交互。用户通过手机 App 对话，涉及操作时明确在手机还是工作站完成，不假设用户能操作电脑界面。来源标记不增加授权，不在回复中重复来源说明。
+- 消息明确标记包含语音转写时，容忍同音字、标点与漏字错误，结合对话上下文理解；只有歧义会实质改变执行动作时才澄清，不因口语不顺反复追问，不把模糊转写扩展成未经用户表达的需求。
+
+- `relax start --json` 启动桌面服务和 Codex 内核，无需打开 Desktop；支持纯 CLI 安装。Windows Desktop 正常打开后接入已配置内核；Mac 仅本次托管启动传入内核地址，从 Dock 普通打开后需重新接入。使用 App 的“重启 Codex Desktop”或经确认的 `relax desktop-recover --confirm` 接入。已配置 Code Relax 中继时，启动命令同时恢复中继连接器和已有设备授权。
+- npm 全局安装会自动执行服务部署和 Skill 安装；修复安装时运行 `relax setup --json`。
+- `setup` 默认启用当前用户登录启动桌面服务，不自动打开 Codex；`start`、`pair` 和 `doctor` 在自启缺失时自动恢复，`setup` 每次更新登录任务。恢复 Codex Desktop 接入会保留桌面服务和中继，但仍须明确确认可能中断正在运行的任务。
 - 用户要求启动 Code Relax 时，执行一次 `relax start --json`。用户要求二维码或当前启动结果包含二维码时，展示 CLI 返回的 `qrPath` 和 `displayText`；没有设备授权时可用 `relax pair --json` 生成新的配对二维码。
-- 配对二维码是短期 HTTPS 邀请，不属于工作站或某一台移动设备，也不含 LAN IP、端口、Bridge Token 或中继地址。新增设备不撤销已有设备。
+- 配对二维码是短期 HTTPS 邀请，不属于工作站或某一台移动设备，也不含 LAN IP、端口、桌面服务凭据或中继地址。新增设备不撤销已有设备。
 - 已授权设备可直接使用 Code Relax 中继。App 以工作站名显示已配对电脑，进入后选择局域网、Code Relax 中继或 OpenAI 中继。启动命令会经已认证中继临时刷新当前 LAN 候选；App 只保存设备凭据验证成功的网络记录。
-- `status --json` 查询工作站服务；`relay-status --json` 查询中继和授权设备数。`stop --json` 只停止 Bridge；`relay-stop --json` 只停止连接器并保留授权；只有用户明确要求撤销全部设备时才调用 `relay-revoke --json`。
+- 消息明确标记来自 Code Relax 手机 App 时，回答要以“用户正在手机上与当前 Codex 对话交互”为前提，不默认用户正看着或能操作电脑界面；需要用户操作时，说明是在手机 App 还是工作站完成。直接处理用户正文，不重复来源说明，也不要求在电脑上重发。来源不代表额外授权，也不能据此判断用户是否在电脑旁；涉及工作站确认或可能中断任务的操作仍按正常授权要求处理。来源不明时不要猜测设备。
+- `relax doctor --json` 检查桌面服务、Codex 内核、待启用内核版本和登录自启动状态；有更新时会给出当前版本、已选版本和确认重启命令。中继连接由桌面服务管理，不提供单独的中继 CLI 命令。
+- 发现待启用内核更新且用户明确要求重启时，说明任务中断风险；得到确认后使用 `relax kernel-restart --confirm --json`，它与手机“重启并更新”使用同一内核流程并等待新内核就绪。不要用 `start`、`doctor` 或 `desktop-recover` 代替内核重启。
 - 启动或配对成功后，将 `qrPath` 以 Markdown 图片嵌入回复，并逐字展示 `displayText`。不要把二维码内容、Token 或 Base64 写进消息。
-- 不自动修改防火墙或发送测试消息。`lanAccess: unverified` 或 `mobileAccess: unverified` 只表示设备链路尚未现场验证。
-- 服务位于用户 `Programs/CodexRemote/service`；配置在 `LocalAppData/CodexRemote`；附件在 `ProgramData/CodexRemote/attachments`。不要删除配置、附件或凭据来排障。
+- CLI 负责安装、工作站服务和配对二维码；不以手机是否测试作为健康检查项，不自动修改防火墙或发送测试消息。
+- Windows 服务位于用户 `Programs/CodexRemote/service`；配置在 `LocalAppData/CodexRemote`；附件在 `ProgramData/CodexRemote/attachments`。Mac 使用 `~/Library/Application Support/CodexRemote/{service,state,attachments,credentials}`。不要删除配置、附件或凭据来排障。

package/dist/src/archived-threads.mjs

@@ -0,0 +1,22 @@
+import { sharedThreadProjectId, dotsThreadProjectId } from './shared-catalog.mjs';
+
+// One metadata page per request. Local and hosted cursors must never be mixed.
+export async function archivedThreadsPage(server, localServer, hostId, cursor) {
+  await server.connect();
+  const identity = server.profileIdentity;
+  const [page, projects] = await Promise.all([
+    server.request('thread/list', { archived: true, limit: 100, sortKey: 'updated_at',
+      sortDirection: 'desc', ...(hostId === 'local' ? { useStateDbOnly: true } : {}),
+      ...(cursor ? { cursor } : {}) }),
+    localServer.projects(),
+  ]);
+  if (hostId === 'durable' && identity !== server.profileIdentity) throw new Error('云端账号已变化，请重新读取归档列表。');
+  const group = hostId === 'durable' ? dotsThreadProjectId : sharedThreadProjectId;
+  return { nextCursor: page.nextCursor || null,
+    threads: page.data.filter(thread => hostId === 'durable' ? thread.threadSource === 'aeon_child' : thread.threadSource !== 'aeon')
+      .map(thread => ({ id: thread.id, hostId, kind: 'codex', threadSource: thread.threadSource,
+        title: thread.name || thread.preview || '', projectId: group(thread, projects),
+        cwd: thread.cwd, updatedAt: thread.updatedAt, recencyAt: thread.recencyAt ?? thread.updatedAt,
+        status: typeof thread.status === 'string' ? thread.status : thread.status?.type || 'unknown',
+        activeFlags: Array.isArray(thread.status?.activeFlags) ? thread.status.activeFlags : [] })) };
+}

package/dist/src/bounded-process-log.mjs

@@ -0,0 +1,63 @@
+import fs from 'node:fs';
+
+export const processLogMaxBytes = 8 * 1024 * 1024;
+const retryMs = 30_000;
+
+// The broker drains output even when storage fails, so logging cannot crash
+// the child or build an unbounded in-memory queue.
+export function attachProcessLog(stream, file, { maxBytes = processLogMaxBytes, now = Date.now } = {}) {
+  let retryAt = 0, dropped = 0, lastError = '';
+  function append(bytes) {
+    let size = 0;
+    try { size = fs.statSync(file).size; }
+    catch (error) { if (error.code !== 'ENOENT') throw error; }
+    // Apply the same retention bound to a log left by an earlier launch.
+    if (size > maxBytes) {
+      const fd = fs.openSync(file, 'r+');
+      try {
+        const tail = Buffer.alloc(maxBytes);
+        const count = fs.readSync(fd, tail, 0, maxBytes, size - maxBytes);
+        fs.ftruncateSync(fd, 0);
+        writeAll(fd, tail.subarray(0, count));
+        size = count;
+      } finally { fs.closeSync(fd); }
+    }
+    for (let offset = 0; offset < bytes.length;) {
+      if (size >= maxBytes) {
+        fs.rmSync(`${file}.2`, { force: true });
+        try { fs.renameSync(`${file}.1`, `${file}.2`); }
+        catch (error) { if (error.code !== 'ENOENT') throw error; }
+        fs.renameSync(file, `${file}.1`);
+        size = 0;
+      }
+      const part = bytes.subarray(offset, offset + maxBytes - size);
+      const fd = fs.openSync(file, 'a');
+      try { writeAll(fd, part); } finally { fs.closeSync(fd); }
+      offset += part.length;
+      size += part.length;
+    }
+  }
+  stream.on('data', chunk => {
+    const bytes = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+    if (now() < retryAt) { dropped += bytes.length; return; }
+    try {
+      if (dropped) append(Buffer.from(`\n[log recovered ${new Date(now()).toISOString()}; previous error: ${lastError}; discarded output bytes: ${dropped}]\n`));
+      append(bytes);
+      dropped = 0;
+      retryAt = 0;
+    } catch (error) {
+      dropped += bytes.length;
+      lastError = error.code || error.message;
+      retryAt = now() + retryMs;
+    }
+  });
+}
+
+function writeAll(fd, bytes) {
+  let offset = 0;
+  while (offset < bytes.length) {
+    const count = fs.writeSync(fd, bytes, offset, bytes.length - offset);
+    if (!count) throw new Error('Log write made no progress.');
+    offset += count;
+  }
+}

package/dist/src/celsius-client.mjs

@@ -0,0 +1,107 @@
+import { EventEmitter } from 'node:events';
+import WebSocket from 'ws';
+
+// Shared Celsius framing and acknowledged topic lifecycle; callers own identity and HTTP.
+export class CelsiusClient extends EventEmitter {
+  constructor({ getConnection, topics = [] }) {
+    super(); this.getConnection = getConnection; this.initialTopics = topics;
+    this.generation = 0; this.topics = new Map(); this.commands = new Map();
+    this.nextId = 0; this.topicLoads = new Map();
+  }
+  async connect() {
+    if (this.ready) return;
+    if (this.connecting) return this.connecting;
+    const generation = this.generation;
+    const work = (async () => {
+      const value = await this.getConnection();
+      if (generation !== this.generation) throw new Error('消息连接已变化。');
+      const url = new URL(value.websocket_url);
+      if (url.protocol !== 'wss:' || url.username || url.password) throw new Error('消息推送地址无效。');
+      await new Promise((resolve, reject) => {
+        const socket = new WebSocket(url, { handshakeTimeout: 15000, maxPayload: 8 * 1024 * 1024 });
+        this.socket = socket;
+        const timer = setTimeout(() => { reject(new Error('消息推送订阅超时。')); socket.terminate(); }, 30000);
+        const current = () => this.socket === socket && generation === this.generation;
+        socket.on('error', () => {}); // Do not expose the signed URL in library errors.
+        socket.on('open', async () => {
+          try {
+            await this.command({ type: 'connect', presence: { type: 'presence', state: 'background' } });
+            for (const topic of this.initialTopics) await this.subscribe(topic);
+            if (!current()) throw new Error('消息连接已变化。');
+            this.ready = true; clearTimeout(timer); resolve(); this.emit('connected');
+          } catch (error) { clearTimeout(timer); reject(error); socket.terminate(); }
+        });
+        socket.on('message', data => {
+          if (!current()) return;
+          let frames; try { frames = JSON.parse(data.toString()); } catch { return; }
+          if (!Array.isArray(frames)) return;
+          for (const frame of frames) {
+            if (frame.type === 'message') this.receive(frame);
+            else if (frame.id != null) this.commands.get(frame.id)?.resolve(frame.reply);
+          }
+        });
+        socket.on('close', code => {
+          clearTimeout(timer); reject(new Error('消息推送连接已断开。'));
+          if (!current()) return;
+          this.ready = false; this.socket = null;
+          for (const entry of this.commands.values()) entry.reject(new Error('消息推送连接已断开。'));
+          this.commands.clear(); this.topics.clear(); this.topicLoads.clear();
+          this.emit('disconnected', { source: 'celsius', code });
+        });
+      });
+    })();
+    this.connecting = work;
+    try { await work; } finally { if (this.connecting === work) this.connecting = null; }
+  }
+
+  command(command) {
+    if (this.socket?.readyState !== WebSocket.OPEN) return Promise.reject(new Error('消息推送尚未连接。'));
+    const id = ++this.nextId;
+    const socket = this.socket;
+    return new Promise((resolve, reject) => {
+      const finish = (error, value) => {
+        if (!this.commands.has(id)) return;
+        clearTimeout(timer); this.commands.delete(id);
+        if (error) reject(error); else resolve(value);
+      };
+      const timer = setTimeout(() => { finish(new Error('消息推送请求超时。')); socket.terminate(); }, 30000);
+      this.commands.set(id, { resolve: value => finish(null, value), reject: error => finish(error) });
+      socket.send(JSON.stringify([{ id, command }]), error => { if (error) finish(new Error('消息推送连接已断开。')); });
+    });
+  }
+
+  async subscribe(name, { offset, requireRecovery = false } = {}) {
+    if (this.topics.has(name)) return;
+    if (this.topicLoads.has(name)) return this.topicLoads.get(name);
+    const generation = this.generation, socket = this.socket;
+    // Every transport reconnection invalidates chat snapshots and reads a new
+    // latest window. An old offset never certifies the new snapshot by itself.
+    const work = this.command({ type: 'subscribe', topic_id: name, ...(offset == null ? {} : { offset }) }).then(reply => {
+      if (socket !== this.socket || generation !== this.generation) throw new Error('消息连接已变化。');
+      if (reply?.type !== 'subscribe' || reply.topic_id !== name) throw new Error('消息推送订阅未确认。');
+      if (requireRecovery && !reply.recovered) throw new Error('ChatGPT 输出历史未完整接续，请核对原消息。');
+      this.topics.set(name, reply.last_offset || null);
+      if (reply.recovered) for (const message of reply.catchups || []) this.receive(message);
+    });
+    this.topicLoads.set(name, work);
+    try { await work; } finally { if (this.topicLoads.get(name) === work) this.topicLoads.delete(name); }
+  }
+
+  async unsubscribe(name) {
+    if (!this.topics.delete(name) || this.socket?.readyState !== WebSocket.OPEN) return;
+    await this.command({ type: 'unsubscribe', topic_id: name });
+  }
+
+  receive(frame) {
+    if (frame.offset) this.topics.set(frame.topic_id, frame.offset);
+    this.emit('message', frame.topic_id, frame.payload);
+  }
+
+
+  close() {
+    this.generation++; this.ready = false; this.connecting = null;
+    const socket = this.socket; this.socket = null; socket?.terminate();
+    for (const entry of this.commands.values()) entry.reject(new Error('消息推送连接已结束。'));
+    this.commands.clear(); this.topics.clear(); this.topicLoads.clear();
+  }
+}

package/dist/src/code-browser.mjs

@@ -0,0 +1,100 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { execFile } from 'node:child_process';
+import protocol from '../shared/code-browser.cjs';
+import { fileRange, fileRevision } from './file-transfer-range.mjs';
+
+async function checkedPath(root, relative) {
+  const target = protocol.child(root, relative);
+  return fs.realpath(target);
+}
+
+function git(cwd, args) {
+  return new Promise((resolve, reject) => execFile('git', ['--no-optional-locks', '--literal-pathspecs', '-c', 'core.quotePath=false', ...args],
+    { cwd, encoding: 'utf8', maxBuffer: protocol.maxBytes, timeout: 15000, windowsHide: true },
+    (error, stdout, stderr) => {
+      if (error) reject(Object.assign(new Error(error.code === 'ERR_CHILD_PROCESS_STDIO_MAXBUFFER'
+        ? 'Git 输出超过预览上限（1 MiB）。' : String(stderr || error.message).trim()), { statusCode: 422 }));
+      else resolve(stdout);
+    }));
+}
+
+export async function browseCode(rpc, operation, query) {
+  if (operation === 'change') return protocol.change(rpc, query);
+  if (operation === 'changes') return protocol.changes(rpc, query);
+  if (operation === 'roots') return { ...await protocol.context(rpc, query), workspaceDiff: true, sizeCheckedBeforeRead: true };
+  const root = query.get('root');
+  if (typeof root !== 'string' || !path.isAbsolute(root)) protocol.fail('请输入电脑上的绝对目录路径。');
+  if (operation === 'workspace' || operation === 'workspace-file') {
+    const realRoot = await checkedPath(root, '');
+    const repository = (await git(realRoot, ['rev-parse', '--show-toplevel'])).trim();
+    const scope = path.relative(repository, realRoot).replaceAll('\\', '/') || '.';
+    if (scope.startsWith('..') || path.isAbsolute(scope)) protocol.fail('无法确认 Git 仓库范围。', 403);
+    const toRelative = name => protocol.relative(realRoot, path.resolve(repository, name));
+    if (operation === 'workspace-file') {
+      const group = query.get('group');
+      if (!['staged', 'unstaged'].includes(group)) protocol.fail('未知的变更来源。');
+      const names = [query.get('path'), query.get('oldPath')].filter(Boolean);
+      if (!names.length) protocol.fail('请选择变更文件。');
+      const paths = names.map(name => path.relative(repository, protocol.child(realRoot, name)).replaceAll('\\', '/'));
+      const diff = await git(repository, ['diff', ...(group === 'staged' ? ['--cached'] : []), '--no-ext-diff', '--no-textconv', '--no-color', names.length > 1 ? '--find-renames' : '--no-renames', '--', ...paths]);
+      return { diff, scope: group === 'staged' ? '当前工作区 · 已暂存' : '当前工作区 · 未暂存' };
+    }
+    const entries = [];
+    for (const group of ['unstaged', 'staged']) {
+      const fields = (await git(repository, ['diff', ...(group === 'staged' ? ['--cached'] : []), '--name-status', '-z', '--find-renames', '--no-ext-diff', '--no-textconv', '--', scope])).split('\0');
+      for (let i = 0; i < fields.length && fields[i];) {
+        const status = fields[i++], first = fields[i++];
+        const renamed = /^[RC]/.test(status), last = renamed ? fields[i++] : first;
+        const name = toRelative(last), oldPath = renamed ? toRelative(first) : null;
+        if (name == null) { if (oldPath != null) entries.push({ path: oldPath, oldPath: null, status: 'D', group }); continue; }
+        entries.push({ path: name, oldPath, status: renamed && oldPath == null ? 'A' : status, group });
+      }
+    }
+    for (const name of (await git(repository, ['ls-files', '--others', '--exclude-standard', '-z', '--', scope])).split('\0').filter(Boolean)) {
+      const relative = toRelative(name);
+      if (relative != null) entries.push({ path: relative, status: '?', group: 'untracked' });
+    }
+    if (entries.length > protocol.maxEntries) protocol.fail('变更文件超过 4000 项，暂不支持展示。', 413);
+    return { root, entries, scope: '当前工作区快照 · 非本次任务归属' };
+  }
+  const relative = query.get('path') || '';
+  const target = await checkedPath(root, relative);
+  if ((operation === 'image' || operation === 'binary')) {
+    const handle = await fs.open(target, 'r');
+    try {
+      const before = await handle.stat();
+      if (!before.isFile()) protocol.fail('请选择普通文件。', 415);
+      if (before.size > protocol.maxFileBytes) protocol.fail('文件超过预览上限（20 MiB）。', 413);
+      if (!before.size) protocol.fail('文件为空。', 415);
+      const revision = fileRevision(before);
+      const { offset, length } = fileRange(query, before.size, revision);
+      const header = Buffer.alloc(12);
+      await handle.read(header, 0, header.length, 0);
+      const mimeType = operation === 'binary' ? 'application/octet-stream' : protocol.imageMime(header);
+      const data = Buffer.alloc(length);
+      const { bytesRead } = await handle.read(data, 0, data.length, offset);
+      const real = await checkedPath(root, relative), after = await handle.stat(), onDisk = await fs.stat(real);
+      if (real !== target || bytesRead !== data.length || after.mtimeMs !== before.mtimeMs || after.ctimeMs !== before.ctimeMs || after.size !== before.size || onDisk.ino !== before.ino || onDisk.dev !== before.dev || onDisk.mtimeMs !== before.mtimeMs || onDisk.size !== before.size) protocol.fail('读取期间文件发生变化，请重新打开。', 409);
+      return { name: path.basename(target), size: before.size, offset, revision, mimeType, data };
+    } finally { await handle.close(); }
+  }
+  if (operation === 'directory') {
+    const entries = await fs.readdir(target, { withFileTypes: true });
+    const result = { entries: entries.map(entry => ({ fileName: entry.name, isDirectory: entry.isDirectory(), isFile: entry.isFile() })) };
+    await checkedPath(root, relative);
+    return protocol.directory(result);
+  }
+  if (operation === 'file') {
+    const before = await fs.stat(target);
+    if (!before.isFile()) protocol.fail('请选择普通文件。', 415);
+    if (before.size > protocol.maxBytes) protocol.fail('文件超过只读预览上限（1 MiB）。', 413);
+    const result = { dataBase64: (await fs.readFile(target)).toString('base64') };
+    const real = await checkedPath(root, relative), after = await fs.stat(real);
+    if (real !== target || before.size !== after.size || before.mtimeMs !== after.mtimeMs || before.ino !== after.ino) {
+      protocol.fail('读取期间文件发生变化，请刷新。', 409);
+    }
+    return { ...protocol.fromBase64(result.dataBase64), modifiedAtMs: after.mtimeMs };
+  }
+  protocol.fail('未知的代码浏览操作。', 404);
+}

package/dist/src/desktop-launcher.mjs

@@ -1,51 +1,62 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { setTimeout as delay } from 'node:timers/promises';
-import { readRecord, writeRecord } from './service-lifecycle.mjs';
-import { ManagedAppServer, managedAppServerUrl as sharedUrl, managedPortAvailable as portAvailable } from './managed-app-server.mjs';
+import { readRecord, lifecycle } from './service-lifecycle.mjs';
+import * as serviceHost from './platform/service-host.mjs';
+import { managedPortAvailable as portAvailable } from './managed-app-server.mjs';
+import { readManagedEndpoint } from './managed-endpoint.mjs';
 export { portAvailable };
-export async function launchDesktop(mode, { stateRoot, host, environment = process.env, available = portAvailable, wait = delay, timeout = 30000, recoveryId, progress = () => {} }) {
-  if (!['shared', 'ordinary'].includes(mode)) throw new Error('无效的 Desktop 启动模式。');
+function desktopEnvironment(stateRoot, environment) {
+  const childEnv = { ...environment };
+  for (const key of ['CODEX_APP_SERVER_WS_URL', 'CODEX_APP_SERVER_FORCE_CLI', 'CODEX_APP_TOOLS_PIPE_PATH']) delete childEnv[key];
+  const runtime = readRecord(path.join(stateRoot, 'codex-runtime.json'));
+  if (runtime?.codexHome) childEnv.CODEX_HOME = runtime.codexHome;
+  childEnv.CODEX_APP_SERVER_WS_URL = readManagedEndpoint(stateRoot);
+  return childEnv;
+}
+
+// Opening the optional UI does not start, restart or supervise the kernel.
+export async function startDesktop({ stateRoot, host, environment = process.env, restart = false }) {
+  const info = await host.inspect();
+  if (!info.desktop) throw new Error('未安装 Codex 桌面端。');
+  if (info.running && !restart) return { status: 'running', message: 'Codex 桌面端已启动。' };
+  if (info.running) await host.closeDesktop(info.desktop);
+  await host.startDesktop(info.desktop, desktopEnvironment(stateRoot, environment));
+  return { status: 'accepted', message: restart ? '已提交 Codex 桌面端重启请求。' : '已提交 Codex 桌面端启动请求。' };
+}
+
+export async function launchDesktop({ stateRoot, host, environment = process.env, wait = delay, timeout = 30000, recoveryId, progress = () => {}, service = lifecycle({ stateRoot, host: serviceHost }) }) {
   fs.mkdirSync(stateRoot, { recursive: true });
   const recovery = readRecord(path.join(stateRoot, 'shared-recovery.lock'));
-  if (recovery && recovery.operationId !== recoveryId) throw new Error('完整控制正在启动，请先查看 shared-recovery-status。');
-  const lock = path.join(stateRoot, 'desktop-launch.lock');
+  if (recovery && recovery.operationId !== recoveryId) throw new Error('Codex 内核正在启动，请用 relax doctor 查看恢复状态。');
+  const lock = path.join(stateRoot, 'desktop-launch.lock');
   let descriptor;
-  let managed;
-  try { descriptor = fs.openSync(lock, 'wx'); }
-  catch (error) {
-    if (error.code === 'EEXIST') throw new Error('另一个 Desktop 启动操作正在进行；若上次异常退出，请确认没有启动器运行后移除 desktop-launch.lock。');
-    throw error;
-  }
-  try {
-    const info = await host.inspect();
-    const connected = await host.sharedServiceUrl();
-    if (info.running) {
-      if ((mode === 'shared') === Boolean(connected)) {
-        writeRecord(path.join(stateRoot, 'execution-mode.json'), { mode });
-        return { reused: true, mode };
-      }
-      throw new Error('请先保存任务并完全退出 Codex Desktop，再切换模式；不会自动结束正在运行的任务。');
-    }
-    const childEnv = { ...environment };
-    for (const key of ['CODEX_APP_SERVER_WS_URL', 'CODEX_APP_SERVER_FORCE_CLI', 'CODEX_APP_TOOLS_PIPE_PATH']) delete childEnv[key];
-    if (mode === 'shared') {
-      progress('starting-app-server');
-      managed = new ManagedAppServer({ stateRoot, host, environment, available, wait, timeout });
-      if (!await managed.start()) throw new Error(managed.snapshot().error || '受管 app-server 未就绪。');
-      childEnv.CODEX_APP_SERVER_WS_URL = sharedUrl;
-    }
-    // Ordinary Desktop must not terminate a shared server that may still be executing tasks.
+  try { descriptor = fs.openSync(lock, 'wx'); }
+  catch (error) {
+    if (error.code === 'EEXIST') throw new Error('另一个 Desktop 启动操作正在进行；若上次异常退出，请确认没有启动器运行后移除 desktop-launch.lock。');
+    throw error;
+  }
+  try {
+    const info = await host.inspect();
+    if (!info.desktop) throw new Error('未安装 Codex Desktop，请使用 relax start 启动工作站。');
+    const connected = await host.sharedServiceUrl();
+    if (info.running) {
+      if (connected) return { reused: true };
+      throw new Error('请先保存任务并完全退出 Codex Desktop，再接入 Codex 内核；不会自动结束正在运行的任务。');
+    }
+    progress('starting-app-server');
+    const health = await service.status();
+    if (!health.running || !health.managedAppServer?.ready) throw new Error(health.managedAppServer?.error || '工作站 Codex 内核未就绪。');
+    const childEnv = desktopEnvironment(stateRoot, environment);
     progress('starting-desktop');
-    await host.start(info.desktop, [], childEnv, []);
-    const deadline = Date.now() + timeout;
-    while (true) {
-      const ready = mode === 'shared' ? await host.sharedServiceUrl() : (await host.inspect()).running;
-      if (ready) break;
-      if (Date.now() >= deadline) throw new Error('Desktop 尚未按所选模式就绪，未启动 Bridge。请查看 Desktop 窗口后重试。');
-      await wait(500);
-    }
-    writeRecord(path.join(stateRoot, 'execution-mode.json'), { mode });
-    return { reused: false, mode };
-  } finally { managed?.close(); fs.closeSync(descriptor); fs.rmSync(lock, { force: true }); }
+    await host.startDesktop(info.desktop, childEnv);
+    const deadline = Date.now() + timeout;
+    while (true) {
+      const ready = await host.desktopReady();
+      if (ready) break;
+      if (Date.now() >= deadline) throw new Error('Desktop 尚未接入 Codex 内核。请查看 Desktop 窗口后重试。');
+      await wait(500);
+    }
+    return { reused: false };
+  } finally { fs.closeSync(descriptor); fs.rmSync(lock, { force: true }); }
 }

package/dist/src/dots-approval-timeline.mjs

@@ -0,0 +1,99 @@
+const itemTime = item => item.dotsReceipt?.sentAt ? Date.parse(item.dotsReceipt.sentAt)
+  : item.startedAtMs ?? item.receivedAtMs;
+const terminal = status => ['resolved', 'expired'].includes(status);
+
+// Approval records have their own official room source. Keep them with the
+// account-scoped hosted cache, then place them in the chat's observed positions.
+export class DotsApprovalTimeline {
+  constructor(server) { this.server = server; this.states = new Map(); }
+
+  async state(threadId) {
+    const scope = this.server.historyScope(threadId);
+    if (!scope) throw new Error('读取点点审批历史需要账号身份。');
+    let state = this.states.get(scope);
+    if (!state) {
+      state = { scope, threadId, epoch: this.server.epoch, records: new Map() };
+      state.ready = (async () => {
+        const saved = await this.server.historyCache?.get(scope, 'approval-records');
+        for (const record of saved?.data || []) {
+          // A display record never reactivates an old pending request.
+          state.records.set(this.key(record), terminal(record.status) ? record : { ...record, status: 'expired' });
+        }
+      })();
+      this.states.set(scope, state);
+    }
+    await state.ready;
+    this.check(threadId, state);
+    return state;
+  }
+
+  check(threadId, state) {
+    if (state.scope !== this.server.historyScope(threadId) || state.epoch !== this.server.epoch) throw new Error('点点审批历史的账号连接已变化。');
+  }
+
+  key(item) { return JSON.stringify([typeof item.requestId, item.requestId]); }
+
+  merge(state, incoming) {
+    let changed = false;
+    for (const item of incoming) {
+      const key = this.key(item), previous = state.records.get(key);
+      const merged = { ...previous, ...item, id: previous?.id || item.id,
+        receivedAtMs: previous?.receivedAtMs ?? item.receivedAtMs,
+        ...(previous?.result && item.result == null ? { result: previous.result } : {}),
+        ...(previous?.afterItemId ? { afterItemId: previous.afterItemId } : {}) };
+      if (JSON.stringify(previous) !== JSON.stringify(merged)) { state.records.set(key, merged); changed = true; }
+    }
+    return changed;
+  }
+
+  save(state) {
+    return this.server.historyCache?.put(state.scope, 'approval-records', { data: [...state.records.values()] });
+  }
+
+  targets(sourceThreadId) {
+    return [...this.states.values()].filter(state => state.scope === this.server.historyScope(state.threadId)
+      && [...state.records.values()].some(record => record.params.threadId === sourceThreadId)).map(state => state.threadId);
+  }
+
+  async observe(threadId, records, turns) {
+    const state = await this.state(threadId);
+    const incoming = records.map(record => {
+      const turn = turns?.find(turn => turn.id === record.turnId);
+      const afterItemId = turn?.items.filter(item => item.type !== 'approval').at(-1)?.id;
+      return { ...record, ...(afterItemId ? { afterItemId } : {}) };
+    });
+    if (this.merge(state, incoming)) await this.save(state);
+    this.check(threadId, state);
+  }
+
+  overlay(threadId, turns, range = {}) {
+    const state = this.states.get(this.server.historyScope(threadId));
+    if (!state) return turns;
+    const ids = new Set([...state.records.values()].map(item => item.id));
+    const result = turns.map(turn => ({ ...turn, items: turn.items.filter(item => item.type !== 'approval' || !ids.has(item.id)) }));
+    for (const approval of [...state.records.values()].sort((a, b) => a.receivedAtMs - b.receivedAtMs)) {
+      if (Number.isFinite(range.fromMs) && approval.receivedAtMs < range.fromMs
+        || Number.isFinite(range.toMs) && approval.receivedAtMs > range.toMs) continue;
+      let turn = result.find(turn => turn.id === approval.roomMessageId || turn.id === approval.turnId);
+      if (!turn) {
+        if (!Number.isFinite(range.fromMs)) continue;
+        const positions = result.flatMap(turn => turn.items.map(item => ({ turn, item, time: itemTime(item) })))
+          .filter(position => Number.isFinite(position.time));
+        turn = positions.filter(position => position.time <= approval.receivedAtMs).at(-1)?.turn || positions[0]?.turn;
+      }
+      if (!turn) continue;
+      const after = turn.items.findIndex(item => item.id === approval.afterItemId);
+      if (after >= 0) {
+        let index = after + 1;
+        while (turn.items[index]?.type === 'approval' && turn.items[index].receivedAtMs <= approval.receivedAtMs) index++;
+        turn.items.splice(index, 0, approval);
+      } else {
+        const next = turn.items.findIndex(item => Number.isFinite(itemTime(item)) && itemTime(item) > approval.receivedAtMs);
+        turn.items.splice(next < 0 ? turn.items.length : next, 0, approval);
+      }
+    }
+    return result;
+  }
+
+  clear() { this.states.clear(); }
+}

package/dist/src/dots-avatar.mjs

@@ -0,0 +1,42 @@
+import sharp from 'sharp';
+
+// Resolve Desktop's saved snapshot on the workstation. Signed URLs never go to the phone.
+export function createDotsAvatarReader(localServer) {
+  const cache = new Map();
+  return async (profile, identity) => {
+    if (!profile.avatarFileId) return '';
+    const key = JSON.stringify([identity.accountId, identity.userId, profile.avatarFileId]);
+    if (!cache.has(key)) {
+      const work = (async () => {
+        const auth = await localServer.request('getAuthStatus', { includeToken: true, refreshToken: false });
+        const principal = JSON.parse(Buffer.from(auth.authToken.split('.')[1], 'base64url'))['https://api.openai.com/auth'];
+        if (principal?.chatgpt_account_id !== identity.accountId || principal.chatgpt_user_id !== identity.userId) {
+          throw new Error('头像账号已变化，请刷新对话。');
+        }
+        const response = await fetch(`https://chatgpt.com/backend-api/files/download/${encodeURIComponent(profile.avatarFileId)}?download_intent=false&inline=true`, {
+          headers: { Authorization: `Bearer ${auth.authToken}`, 'ChatGPT-Account-Id': identity.accountId },
+          redirect: 'error', signal: AbortSignal.timeout(15000),
+        });
+        if (!response.ok) { await response.body?.cancel(); throw new Error(`点点头像资料读取失败（${response.status}）`); }
+        const { download_url: downloadUrl } = await response.json();
+        const url = new URL(downloadUrl);
+        const authenticated = url.origin === 'https://chatgpt.com' && url.pathname === '/backend-api/estuary/content';
+        if (url.protocol !== 'https:' || !(authenticated || url.hostname.endsWith('.oaiusercontent.com'))) throw new Error('点点头像下载地址无效。');
+        const image = await fetch(url, { redirect: 'error', signal: AbortSignal.timeout(15000),
+          ...(authenticated ? { headers: { Authorization: `Bearer ${auth.authToken}`, 'ChatGPT-Account-Id': identity.accountId } } : {}) });
+        if (!image.ok) { await image.body?.cancel(); throw new Error(`点点头像下载失败（${image.status}）`); }
+        const chunks = []; let size = 0;
+        for await (const chunk of image.body) {
+          size += chunk.length;
+          if (size > 4 * 1024 * 1024) throw new Error('点点头像超过 4 MiB。');
+          chunks.push(chunk);
+        }
+        const thumbnail = await sharp(Buffer.concat(chunks)).resize(96, 96, { fit: 'inside', withoutEnlargement: true }).webp().toBuffer();
+        return `data:image/webp;base64,${thumbnail.toString('base64')}`;
+      })();
+      cache.set(key, work);
+      work.catch(() => { if (cache.get(key) === work) cache.delete(key); });
+    }
+    return cache.get(key);
+  };
+}

package/dist/src/dots-chat-projection.mjs

@@ -0,0 +1,50 @@
+import { createHash } from 'node:crypto';
+import { dotsImageReference } from './dots-message-images.mjs';
+
+const nonempty = value => typeof value === 'string' && value.trim().length > 0;
+
+export function dotsChatRevision(turns) {
+  const latest = dotsChatTailRevision(turns);
+  const message = dotsChatMessageRevision(turns);
+  // A message can keep streaming while a later agent action is already visible.
+  return !latest || latest === message ? latest
+    : createHash('sha256').update(JSON.stringify([latest, message])).digest('hex');
+}
+
+// A bounded disk-head probe compares the same last visible item on both sides.
+// The full transcript revision also tracks an earlier streaming message.
+export function dotsChatTailRevision(turns) {
+  return chatItemRevision(turns.at(-1)?.items.at(-1));
+}
+
+export function dotsChatMessageRevision(turns) {
+  for (let turnIndex = turns.length - 1; turnIndex >= 0; turnIndex--) {
+    const items = turns[turnIndex].items;
+    for (let itemIndex = items.length - 1; itemIndex >= 0; itemIndex--) {
+      const item = items[itemIndex];
+      if (item.type === 'userMessage' || item.type === 'agentMessage') return chatItemRevision(item);
+    }
+  }
+  // A recent window containing only agent actions cannot acknowledge a chat message.
+  return undefined;
+}
+
+function chatItemRevision(item) {
+  if (!item) return '';
+  const content = item.type === 'userMessage' ? item.content.map(part => {
+    const reference = dotsImageReference(part);
+    if (!reference?.url) return part;
+    // Renewing an official storage signature does not create a new message.
+    const url = new URL(reference.url);
+    return { ...part, url: url.origin + url.pathname };
+  }) : item.type === 'subAgentActivity' ? [item.kind, item.agentThreadId, item.agentPath]
+    : [item.text || '', item.attachments || []];
+  // Identity and displayed content survive reconnects; internal work does not affect this marker.
+  return createHash('sha256').update(JSON.stringify([item.id, item.type, content])).digest('hex');
+}
+// Execution events remain separate from room user/agent messages.
+export function projectDotsChatItem(item) {
+  if (item?.type !== 'subAgentActivity' || !nonempty(item.id) || !nonempty(item.agentThreadId)
+    || !['started', 'interacted', 'completed', 'interrupted'].includes(item.kind)) return null;
+  return { type: item.type, id: item.id, kind: item.kind, agentThreadId: item.agentThreadId, agentPath: item.agentPath || '' };
+}