made-bridge 0.2.3 → 0.3.1

package/src/server.mjs

@@ -10,7 +10,7 @@ import { fileURLToPath } from 'node:url';
 import { loadConfig, packageRoots, ROOT, ensureUserConfig } from './config.mjs';
 import { JobStore } from './jobs.mjs';
 import { VIBE_SESSION_ID } from './sessions.mjs';
-import { createRunner, providerStates, isBuiltinAgent } from './providers.mjs';
+import { createRunner, providerStates } from './providers.mjs';
 import { loadLanguageSettings, saveLanguageSettings, validateLocale } from './language-settings.mjs';
 import { translateKnownMessage, localizeStatus } from './i18n.mjs';
 import { transcribe as transcribeVoice, transcriptionState, validateVoiceWav } from './transcribe.mjs';
@@ -22,11 +22,13 @@ import { TunnelManager } from './tunnel.mjs';
 import { UsbReceiver, USB_DIRECT_AUTHORITY, USB_RECEIVER_AUTHORITY } from './usb-receiver.mjs';
 
 import { createPluginRegistry, loadConfiguredPlugins } from './plugins/registry.mjs';
+import { watchPlugins } from './plugins/hot-reload.mjs';
 import { createEnhancement } from './plugins/enhance.mjs';
 import { listInstalled, listThemes, removePlugin, removeTheme, savePluginSettings, setPluginEnabled, themeExists } from './installed.mjs';
 import { createBoardLink } from './board-link.mjs';
 import { spriteChunk } from './agent-sprites.mjs';
 import { createScreenshotStore, rgb565ToPng, validateScreenshotParams, MAX_UPLOAD } from './board-screenshot.mjs';
+import { createFirmwareStore } from './firmware-store.mjs';
 import { initializeSpeechSettings, saveSpeechSettings } from './speech-settings.mjs';
 import { builtinSpeechRecognizers } from './speech/index.mjs';
 const PAIRED_DISCOVERY_REQUEST = /^VIBE_DISCOVER_PAIRED_V2 ([0-9a-f]{12}) ([0-9a-f]{32})$/;
@@ -228,8 +230,10 @@ export function createApp(config, { run, transcribe, tunnel: providedTunnel, ena
   const publicSession = (session, locale = config.locale) => ({ ...session,
     ...(session.autoTitlePending ? { title: message(session.title, locale) } : {}) });
   const publicJob = (job, locale = config.locale) => {
-    const builtin = isBuiltinAgent(config.pluginsRuntime.agent(job.provider));
-    return { ...job, ...(builtin ? { progress: message(job.progress, locale), error: message(job.error, locale),
+    // 桥接器规范文案（bridgeStrings 插件）在输出边界翻译；第三方插件自有的
+    // 进度与错误原样返回。
+    const canonical = config.pluginsRuntime.agent(job.provider)?.bridgeStrings === true;
+    return { ...job, ...(canonical ? { progress: message(job.progress, locale), error: message(job.error, locale),
       ...(job.handoffReadError ? { handoffReadError: message(job.handoffReadError, locale) } : {}) } : {}) };
   };
   const publicVoice = () => {
@@ -256,6 +260,13 @@ export function createApp(config, { run, transcribe, tunnel: providedTunnel, ena
   const pairing = new PairingStore(config.stateDir);
   const boardLink = createBoardLink();
   const screenshots = createScreenshotStore(path.join(config.stateDir, 'screenshots'));
+  const firmware = createFirmwareStore(path.join(config.stateDir, 'firmware'));
+  let firmwareSync = null;
+  const ensureLocalFirmware = async () => {
+    if (firmware.deviceOffer().path || !firmware.summary().otaUrl) return;
+    firmwareSync ||= firmware.syncFromUrl().finally(() => { firmwareSync = null; });
+    await firmwareSync;
+  };
   // 增强运行时：回合管道与生命周期通知给 JobStore 用，bridge 句柄给插件上下文用。
   const enhance = createEnhancement(config);
   const tunnel = providedTunnel || new TunnelManager({
@@ -310,12 +321,12 @@ export function createApp(config, { run, transcribe, tunnel: providedTunnel, ena
     defaultProvider: config.defaultProvider,
     maxParallel: config.maxParallelJobs,
     maxAutoRetries: config.maxAutoRetries,
-    pluginsRuntime: config.pluginsRuntime,
+    pluginsRuntime: () => config.pluginsRuntime,
     run: run || createRunner(config),
     hooks: enhance,
     // Keep stored built-in failures canonical; each client localizes at its output boundary.
     providerAvailable: (id) => ({ ...providerStates(config, 'zh-CN').find((item) => item.id === id),
-      preserveMessage: !isBuiltinAgent(config.pluginsRuntime.agent(id)) }),
+      preserveMessage: config.pluginsRuntime.agent(id)?.bridgeStrings !== true }),
   });
   // 任务存储与板侧链路就绪后，把句柄露给管控插件。
   enhance.attach({ jobs: store, board: boardLink, themes: () => listThemes(config) });
@@ -358,6 +369,10 @@ export function createApp(config, { run, transcribe, tunnel: providedTunnel, ena
         send(res, 200, await listInstalled(config), false);
         return;
       }
+      if (req.method === 'GET' && url.pathname === '/api/firmware') {
+        send(res, 200, firmware.summary(), false);
+        return;
+      }
       if (req.method === 'GET' && url.pathname === '/api/state') {
         send(res, 200, {
           locale: config.locale,
@@ -371,6 +386,8 @@ export function createApp(config, { run, transcribe, tunnel: providedTunnel, ena
           tunnel: publicTunnel(),
           voice: publicVoice(),
           models: publicModels(config),
+          // 行动系统：deviceId → 可用动作名列表（板侧上报的最新一份）。
+          deviceActions: boardLink.allActions(),
         });
         return;
       }
@@ -584,6 +601,42 @@ export function createApp(config, { run, transcribe, tunnel: providedTunnel, ena
           }
           throw new Error('码得未在 15 秒内回传截图（固件需要更新到支持 debug.screenshot 的版本）');
         }
+        if (url.pathname === '/api/firmware') {
+          const type = String(req.headers['content-type'] || '');
+          if (type.startsWith('application/octet-stream')) {
+            const version = String(req.headers['x-firmware-version'] || '');
+            let bytes;
+            try {
+              bytes = await binaryBody(req, 8 * 1024 * 1024);
+            } catch (error) {
+              if (error.message === '录音超过 30 秒上限') throw new Error('固件文件超过 8MB');
+              throw error;
+            }
+            send(res, 200, firmware.importBuffer({
+              version, bytes, notes: String(req.headers['x-firmware-notes'] || ''),
+            }), false);
+            return;
+          }
+          const payload = await body(req);
+          const action = payload && typeof payload.action === 'string' ? payload.action : '';
+          if (action === 'url') {
+            send(res, 200, firmware.setOtaUrl(payload.otaUrl), false);
+            return;
+          }
+          if (action === 'sync') {
+            send(res, 200, await firmware.syncFromUrl(), false);
+            return;
+          }
+          if (action === 'current') {
+            send(res, 200, firmware.setCurrent(payload.id), false);
+            return;
+          }
+          if (action === 'delete') {
+            send(res, 200, firmware.remove(payload.id), false);
+            return;
+          }
+          throw new Error('固件操作无效');
+        }
         const pairAction = url.pathname.match(/^\/api\/pair\/([0-9a-f]{12})\/(confirm|reject)$/);
         if (pairAction) {
           const { nonce } = await body(req);
@@ -724,7 +777,37 @@ export function createApp(config, { run, transcribe, tunnel: providedTunnel, ena
         deviceSend(res, 401, { error: '设备未授权' });
         return;
       }
+      if (req.method === 'GET' && url.pathname === '/device/firmware/current') {
+        try { await ensureLocalFirmware(); } catch (error) {
+          console.error(`[trace] fw-sync ${error?.message || error} ${new Date().toISOString()}`);
+        }
+        const offset = Number(url.searchParams.get('offset') || '0');
+        const length = Number(url.searchParams.get('length') || '131072');
+        if (!Number.isInteger(offset) || offset < 0 || offset > 8 * 1024 * 1024) {
+          console.error(`[trace] fw-get off=${url.searchParams.get('offset') ?? '-'} len=${url.searchParams.get('length') ?? '-'} -> 400 ${new Date().toISOString()}`);
+          deviceSend(res, 400, { error: '固件偏移无效' });
+          return;
+        }
+        const slice = firmware.readCurrent(offset, Number.isInteger(length) ? length : 128 * 1024);
+        console.error(`[trace] fw-get off=${offset} len=${Number.isInteger(length) ? length : 131072} -> ${slice ? slice.bytes.length : -1}B total=${slice ? slice.item.size : '-'} ${new Date().toISOString()}`);
+        if (!slice) {
+          deviceSend(res, 404, { error: '没有可更新的固件' });
+          return;
+        }
+        res.writeHead(200, {
+          'Content-Type': 'application/octet-stream',
+          'Content-Length': slice.bytes.length,
+          'Cache-Control': 'no-store',
+          'X-Content-Type-Options': 'nosniff',
+          'X-Firmware-Offset': String(slice.offset),
+          'X-Firmware-Size': String(slice.item.size),
+          'X-Firmware-Sha256': slice.item.sha256,
+        });
+        res.end(slice.bytes);
+        return;
+      }
       if (req.method === 'GET' && url.pathname === '/device/heartbeat') {
+        console.error(`[trace] hb upMs=${url.searchParams.get('upMs') ?? '-'} wifiReason=${url.searchParams.get('wifiReason') ?? '-'} wifiDrops=${url.searchParams.get('wifiDrops') ?? '-'} wifiSelf=${url.searchParams.get('wifiSelf') ?? '-'} wifiHist=${url.searchParams.get('wifiHist') ?? '-'} heap=${url.searchParams.get('heap') ?? '-'} minHeap=${url.searchParams.get('minHeap') ?? '-'} psram=${url.searchParams.get('psram') ?? '-'} psramMin=${url.searchParams.get('psramMin') ?? '-'} fwStage=${url.searchParams.get('fwStage') ?? '-'} fwWhy=${url.searchParams.get('fwWhy') ?? '-'} fwResult=${url.searchParams.get('fwResult') ?? '-'} fwWritten=${url.searchParams.get('fwWritten') ?? '-'} fwSize=${url.searchParams.get('fwSize') ?? '-'} fwHttp=${url.searchParams.get('fwHttp') ?? '-'} fwTasks=${url.searchParams.get('fwTasks') ?? '-'} fwTask=${url.searchParams.get('fwTask') ?? '-'} ${new Date().toISOString()}`);
         if (process.env.VIBE_UI_DIAGNOSTICS === '1') {
           const fields = Object.fromEntries(['uiStage', 'uiAge', 'bootAge', 'exit', 'provider', 'displayStage', 'displayCount']
             .map((key) => [key, url.searchParams.get(key)])
@@ -742,6 +825,8 @@ export function createApp(config, { run, transcribe, tunnel: providedTunnel, ena
         deviceSend(res, 200, { events: boardLink.subscription(deviceId, config.pluginsRuntime, config) });
         return;
       }
+      // 行动系统：可用动作由设备并入命令清单（action.<名> 条目）上报，
+      // 不单开通道；名单从清单派生（boardLink.actionsOf）。
       if (req.method === 'POST' && url.pathname === '/device/events') {
         await boardLink.handleEvent(deviceId, await body(req), config.pluginsRuntime, config, enhance.bridge());
         deviceSend(res, 200, { accepted: true });
@@ -797,6 +882,11 @@ export function createApp(config, { run, transcribe, tunnel: providedTunnel, ena
               result: result.text,
               resultTruncated: result.truncated,
               error: devicePreview(job.error.slice(-200), 96),
+              attachments: (job.attachments || []).map((a) => ({
+                type: a.type === 'image' ? 'image' : 'link',
+                url: String(a.url || '').slice(0, 2048),
+                text: String(a.text || '').slice(0, 120),
+              })).filter((a) => a.url),
             };
           }),
         });
@@ -831,6 +921,7 @@ export function createApp(config, { run, transcribe, tunnel: providedTunnel, ena
       }
       if (req.method === 'GET' && url.pathname === '/device/config') {
         const voice = transcriptionState(config);
+        const firmwareSummary = firmware.summary();
         // Firmware creates sessions in the default project; the full project
         // picker lives on the desktop. Keep room for twelve bounded bitmaps.
         const payload = {
@@ -839,19 +930,30 @@ export function createApp(config, { run, transcribe, tunnel: providedTunnel, ena
           projects: config.projects.filter(({ id }) => id === config.defaultProject).map(({ id, label }) => ({ id, label: devicePreview(label, 64) })),
           defaultProject: config.defaultProject,
           voice: { mode: voice.mode, available: voice.available },
+          // 只有固件仓库里存在已导入的当前包（有 sha/版本）才 advertise OTA：
+          // 只配了 otaUrl 却没传固件时，设备会拿到无 sha 的 url → 永远 nomark
+          // → 弹更新确认 → waiting_confirmation 任务常驻 → 素材 preload 被门禁
+          // 拦死（GIF 动作等新文件永远下载不到）。
+          firmwareUrl: firmwareSummary.current ? firmwareSummary.otaUrl : '',
+          firmwareVersion: firmwareSummary.current?.version || '',
+          firmwareSha256: firmwareSummary.current?.sha256 || '',
+          firmwareSize: firmwareSummary.current?.size || 0,
           board: { events: boardLink.subscription(pairing.deviceIdForToken(token), config.pluginsRuntime, config) },
           // 桥接器重启会丢掉板侧命令清单：让板子看到 announce 后重新上报。
           announce: !boardLink.hasCatalog(pairing.deviceIdForToken(token)),
         };
         if (Buffer.byteLength(JSON.stringify(payload)) > 32 * 1024) throw new Error('码得配置超过 32 KB，请检查助手元数据');
+        console.error(`[trace] fw-config url=${payload.firmwareUrl || '-'} ver=${payload.firmwareVersion || '-'} sha=${(payload.firmwareSha256 || '-').slice(0, 12)} size=${payload.firmwareSize || 0} ${new Date().toISOString()}`);
         if (process.env.VIBE_UI_DIAGNOSTICS === '1') console.info('[device-config]', deviceId, 'announce=', payload.announce,
           'providers=', payload.providers.map((p, i) => `${i}:${p.id}${p.sprite ? '@' + p.sprite.version : ''}`).join(' ') || 'none');
         deviceSend(res, 200, payload);
         return;
       }
       // 形象素材分片拉取：单次 ≤192KB，兼容 USB 帧转发 256KB 上限（docs/SPRITES.md）。
+      // 扩展名含 .gif：GIF 动作素材（actions[].gif）也在 files 清单里，路由
+      // 只放行 .png 的话设备永远拉不到，playAction 报 gif_unavailable。
       const spriteMatch = req.method === 'GET' &&
-        url.pathname.match(/^\/device\/sprite\/([a-z0-9][a-z0-9_-]{0,39})\/([A-Za-z0-9_-]+\.png|manifest\.json)$/);
+        url.pathname.match(/^\/device\/sprite\/([a-z0-9][a-z0-9_-]{0,39})\/([A-Za-z0-9_-]+\.(?:png|gif)|manifest\.json)$/);
       if (spriteMatch) {
         const plugin = config.pluginsRuntime.agent(spriteMatch[1]);
         if (spriteMatch[2] === 'manifest.json') {
@@ -862,6 +964,8 @@ export function createApp(config, { run, transcribe, tunnel: providedTunnel, ena
           deviceSend(res, 200, {
             version: plugin.sprite.version, canvas: plugin.sprite.canvas,
             layers: plugin.sprite.layers, ...(plugin.sprite.motion ? { motion: plugin.sprite.motion } : {}),
+            ...(plugin.sprite.emotions ? { emotions: plugin.sprite.emotions } : {}),
+            ...(plugin.sprite.actions ? { actions: plugin.sprite.actions } : {}),
           });
           return;
         }
@@ -874,6 +978,7 @@ export function createApp(config, { run, transcribe, tunnel: providedTunnel, ena
         const chunk = plugin?.sprite ? spriteChunk(plugin.sprite, spriteMatch[2],
           Number(url.searchParams.get('offset')) || 0,
           requested === undefined ? SPRITE_DEVICE_CHUNK : Math.min(requested, SPRITE_DEVICE_CHUNK)) : null;
+        console.error(`[trace] sprite ${spriteMatch[1]}/${spriteMatch[2]} off=${url.searchParams.get('offset') ?? 0} -> ${chunk ? chunk.length : -1}B ${new Date().toISOString()}`);
         if (process.env.VIBE_UI_DIAGNOSTICS) {
           console.log(`[device-sprite] ${spriteMatch[2]} offset=${url.searchParams.get('offset') ?? 0} len=${url.searchParams.get('len') ?? '-'} -> ${chunk ? chunk.length : -1}B`);
         }
@@ -1024,11 +1129,13 @@ if (isEntry) {
     }
     const config = loadConfig();
     config.pluginsRuntime = await loadConfiguredPlugins(config);
+    const pluginsWatch = watchPlugins(config);
     const app = createApp(config, { enableUsb: true });
     let shuttingDown = false;
     const shutdown = () => {
       if (shuttingDown) return;
       shuttingDown = true;
+      pluginsWatch.close();
       app.close().then(() => { process.exitCode = 0; }).catch((error) => {
         console.error(error.message);
         process.exitCode = 1;

package/src/sessions.mjs

@@ -1,7 +1,6 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { randomUUID } from 'node:crypto';
-import { builtinAgent } from './agents/index.mjs';
 
 export const VIBE_SESSION_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 export const CLI_SESSION_ID = /^[A-Za-z0-9_-]{6,128}$/;
@@ -33,7 +32,7 @@ function firstTurnTitle(instruction) {
 
 export class SessionStore {
   constructor({ file, projects, defaultProject, defaultProvider, pluginsRuntime, agent }) {
-    this.agent = agent || (pluginsRuntime ? (id) => pluginsRuntime.agent(id) : builtinAgent);
+    this.agent = agent || (pluginsRuntime ? (id) => pluginsRuntime.agent(id) : () => undefined);
     this.file = file;
     this.projects = projects;
     this.defaultProject = defaultProject;

package/src/usb-receiver.mjs

@@ -25,6 +25,8 @@ const VOICE_TIMEOUT_MS = 150_000;
 const HELLO_TIMEOUT_MS = 7_000;
 const DISCOVERY_INTERVAL_MS = 2_000;
 const REJECTED_PORT_COOLDOWN_MS = 60_000;
+// 没握手的端口（码得平时只把 USB 当日志口）不能一直占着，否则烧录和串口监视都打不开。
+const IDLE_PORT_COOLDOWN_MS = 3_000;
 const BASE64 = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;
 // Probe only the native ESP USB device and the WCH bridge verified on the
 // supported C3 receiver. A matching USB ID is a candidate, not a ready peer:
@@ -52,25 +54,45 @@ function limitedText(value, limit = 128) {
   return typeof value === 'string' && value.length <= limit && !/[\r\n\x00-\x1f\x7f]/.test(value);
 }
 
-export function parseMacUsbSerialPorts(output) {
-  const ports = new Set();
+function usbId(vendor, product) {
+  return `${vendor.toString(16)}:${product.toString(16)}`;
+}
+
+// 码得的原生 USB Serial/JTAG 不看波特率。对它跑 stty 会改 DTR/RTS，
+// ESP32-S3 因此复位，正在用的 Wi-Fi 连接被拔掉。WCH 才是真串口，要设波特率。
+export function usbSerialNeedsLineCoding(id) {
+  return id !== '303a:1001';
+}
+
+export function parseMacUsbSerialDevices(output) {
+  const devices = [];
+  const seen = new Set();
   const blocks = String(output).split(/(?=^[\s|]*\+-o [^\n]*<class IOUSBHostDevice,)/m);
   for (const block of blocks) {
     if (!block.includes('<class IOUSBHostDevice,')) continue;
     const vendor = block.match(/"idVendor"\s*=\s*(\d+)/);
     const product = block.match(/"idProduct"\s*=\s*(\d+)/);
-    if (!supportedUsbDevice(Number(vendor?.[1]), Number(product?.[1]))) continue;
+    const vendorId = Number(vendor?.[1]);
+    const productId = Number(product?.[1]);
+    if (!supportedUsbDevice(vendorId, productId)) continue;
+    const id = usbId(vendorId, productId);
     for (const match of block.matchAll(/"IOCalloutDevice"\s*=\s*"(\/dev\/cu\.[A-Za-z0-9._-]+)"/g)) {
-      ports.add(match[1]);
+      if (seen.has(match[1])) continue;
+      seen.add(match[1]);
+      devices.push({ path: match[1], id });
     }
   }
-  return [...ports];
+  return devices;
+}
+
+export function parseMacUsbSerialPorts(output) {
+  return parseMacUsbSerialDevices(output).map((device) => device.path);
 }
 
-export function linuxUsbSerialPorts({ sysTtyRoot = '/sys/class/tty', devRoot = '/dev' } = {}) {
-  const ports = [];
+export function linuxUsbSerialDevices({ sysTtyRoot = '/sys/class/tty', devRoot = '/dev' } = {}) {
+  const devices = [];
   let names;
-  try { names = fs.readdirSync(sysTtyRoot); } catch { return ports; }
+  try { names = fs.readdirSync(sysTtyRoot); } catch { return devices; }
   for (const name of names) {
     if (!/^tty(?:ACM|USB)\d+$/.test(name)) continue;
     let directory;
@@ -82,29 +104,37 @@ export function linuxUsbSerialPorts({ sysTtyRoot = '/sys/class/tty', devRoot = '
         const product = Number.parseInt(fs.readFileSync(path.join(directory, 'idProduct'), 'utf8'), 16);
         if (supportedUsbDevice(vendor, product)) {
           const device = path.join(devRoot, name);
-          if (fs.existsSync(device)) ports.push(device);
+          if (fs.existsSync(device)) devices.push({ path: device, id: usbId(vendor, product) });
           break;
         }
       } catch { /* Walk to the USB device parent. */ }
       directory = path.dirname(directory);
     }
   }
-  return ports;
+  return devices;
 }
 
-export async function discoverUsbSerialPorts(platform = process.platform) {
+export function linuxUsbSerialPorts(options) {
+  return linuxUsbSerialDevices(options).map((device) => device.path);
+}
+
+export async function discoverUsbSerialDevices(platform = process.platform) {
   if (platform === 'darwin') {
     try {
       const result = await execFileAsync('ioreg', ['-p', 'IOService', '-r', '-c', 'IOUSBHostDevice', '-l', '-t', '-w0'], {
         encoding: 'utf8', timeout: 3000, maxBuffer: 8 * 1024 * 1024,
       });
-      return parseMacUsbSerialPorts(result.stdout).filter((port) => fs.existsSync(port));
+      return parseMacUsbSerialDevices(result.stdout).filter((device) => fs.existsSync(device.path));
     } catch { return []; }
   }
-  if (platform === 'linux') return linuxUsbSerialPorts();
+  if (platform === 'linux') return linuxUsbSerialDevices();
   return [];
 }
 
+export async function discoverUsbSerialPorts(platform = process.platform) {
+  return (await discoverUsbSerialDevices(platform)).map((device) => device.path);
+}
+
 async function configureSerial(port, platform = process.platform) {
   if (!['darwin', 'linux'].includes(platform)) return;
   const settings = ['921600', 'raw', '-echo', 'cs8', '-parenb', '-cstopb',
@@ -228,6 +258,9 @@ export class UsbReceiverProtocol {
       // 会插进来。只有「看着像帧」的坏行才算协议错误；日志必须原样放行，
       // 否则板子一打日志就会掐掉正在传输的响应（素材分片下载失败即此因）。
       if (!line.startsWith('{')) {
+        if (/ESP-ROM|rst:0x|boot:0x/.test(line)) {
+          console.error(`[trace] usb-boot ${new Date().toISOString()} ${line.slice(0, 180)}`);
+        }
         console.error(`[usb-link] log: ${line.slice(0, 240)}`);
         return;
       }
@@ -541,16 +574,17 @@ export class UsbReceiver {
     if (this.polling || this.stopped || this.state.status === 'disabled') return;
     this.polling = true;
     try {
-      const candidates = this.portPath ? [this.portPath] : await discoverUsbSerialPorts();
+      const devices = this.portPath ? [{ path: this.portPath, id: '' }] : await discoverUsbSerialDevices();
       if (this.stopped) return;
-      if (!candidates.length) {
+      if (!devices.length) {
         if (!this.links.size) {
           this.state.port = this.portPath;
           this.state.error = this.portPath ? 'USB 设备未连接' : '未发现受支持的 USB 设备；可设置 VIBE_USB_PORT';
         }
         return;
       }
-      for (const port of candidates) {
+      for (const device of devices) {
+        const port = device.path;
         if (this.stopped) break;
         if (this.links.has(port)) continue;
         if (Date.now() < (this.cooldown.get(port) || 0)) continue;
@@ -562,9 +596,12 @@ export class UsbReceiver {
           const fd = fs.openSync(port, fs.constants.O_RDWR | fs.constants.O_NONBLOCK |
             (fs.constants.O_NOCTTY || 0));
           unregisteredFd = fd;
+          const lineCoding = usbSerialNeedsLineCoding(device.id);
+          console.error(`[trace] usb-open port=${port} id=${device.id || '-'} stty=${lineCoding} ${new Date().toISOString()}`);
           // WCH resets the baud rate when its final handle closes. Keep our
           // handle open while stty opens, configures and closes its own handle.
-          await configureSerial(port);
+          // 码得自己的口跳过这一步，避免插入 USB 时把 Wi-Fi 连接复位掉。
+          if (lineCoding) await configureSerial(port);
           if (this.stopped) break;
           const link = { fd, port, helloTimer: null, inputTimer: null,
             protocol: null, writeQueue: Promise.resolve() };
@@ -624,6 +661,10 @@ export class UsbReceiver {
             refreshAuthenticatedVoice: this.refreshAuthenticatedVoice,
           });
           const inputBuffer = Buffer.allocUnsafe(4096);
+          // macOS 的 CDC 驱动偶发返回 0 字节读（并非拔线）。连续空读超过
+          // ~1s 才判死，否则一次抖动就把链路拆掉重连（实机表现为「时不时断开」）。
+          const ZERO_READ_LIMIT = 50;
+          link.zeroReads = 0;
           const readAvailable = () => {
             if (this.links.get(port) !== link) return;
             // TTY drivers may return only 1 KiB even when more data is ready.
@@ -631,11 +672,16 @@ export class UsbReceiver {
             for (let reads = 0; reads < 64; reads += 1) {
               try {
                 const length = fs.readSync(fd, inputBuffer, 0, inputBuffer.length, null);
-                if (length > 0) link.protocol.feed(inputBuffer.subarray(0, length));
-                else { this.disconnect(link, 'USB 设备已断开'); return; }
+                if (length > 0) {
+                  link.zeroReads = 0;
+                  link.protocol.feed(inputBuffer.subarray(0, length));
+                } else if (this.links.get(port) === link && ++link.zeroReads >= ZERO_READ_LIMIT) {
+                  this.disconnect(link, 'USB 设备已断开');
+                  return;
+                } else break;
               } catch (error) {
                 if (error.code === 'EAGAIN' || error.code === 'EWOULDBLOCK') break;
-                this.disconnect(link, 'USB 设备已断开');
+                this.disconnect(link, `USB 读取错误 ${error.code || error.message}`);
                 return;
               }
             }
@@ -647,12 +693,11 @@ export class UsbReceiver {
           link.inputTimer = setTimeout(readAvailable, 20);
           link.inputTimer.unref?.();
           link.helloTimer = setTimeout(() => {
-            if (this.link === link && this.state.status !== 'connected') {
-              // A round display only says hello while Vibe is open. Keep this
-              // nonblocking reader alive so opening Vibe is detected at once,
-              // without reopening/resetting the board or delaying other ports.
-              this.state.error = 'USB 已连接，等待打开码得应用的 USB 直连';
-            }
+            if (this.links.get(port) !== link || this.state.status === 'connected') return;
+            // 没握手就先放开串口，烧录可以插空占用。冷却只有几秒，板子每 3 秒
+            // 发一次 hello，下一轮打开就能接上，不用对准打开的时刻。
+            this.cooldown.set(port, Date.now() + IDLE_PORT_COOLDOWN_MS);
+            this.disconnect(link, '未握手，已暂时释放串口，马上会再试');
           }, HELLO_TIMEOUT_MS);
           link.helloTimer.unref?.();
         } catch {
@@ -672,6 +717,9 @@ export class UsbReceiver {
 
   disconnect(link, error = '') {
     if (this.links.get(link.port) !== link) return;
+    // 断开原因必须留痕：连接状态只存最后一条 error，没有这行日志就查不到
+    // 「时不时断开」到底是空读判死、写超时还是心跳超时。
+    console.error(`[usb-link] disconnect port=${link.port} reason=${error || '未指定'} lastSeen=${this.state.lastSeen || 'never'}`);
     this.links.delete(link.port);
     clearTimeout(link.helloTimer);
     link.protocol?.dispose();

package/src/agents/codex.mjs

@@ -1,94 +0,0 @@
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { builtinAgentIcons } from '../agent-icons.mjs';
-import { probeCli, runCli, gitState } from './shared.mjs';
-import { jsonLineEvents, toolActivity } from './events.mjs';
-
-// `codex login status` 只认 ChatGPT/OAuth 登录。当用户在 ~/.codex/config.toml 里配置了
-// 自定义 model_provider（experimental_bearer_token 或 env_key 指向的环境变量）时，
-// CLI 实际可用但登录状态仍显示未登录。这里补充识别这类鉴权方式，避免误报“请先登录”。
-function hasCustomProviderAuth() {
-  try {
-    const config = fs.readFileSync(path.join(os.homedir(), '.codex', 'config.toml'), 'utf8');
-    const bearer = config.match(/experimental_bearer_token\s*=\s*"([^"]+)"/);
-    if (bearer?.[1]) return true;
-    const envKey = config.match(/env_key\s*=\s*"([^"]+)"/);
-    return Boolean(envKey?.[1] && process.env[envKey[1]]);
-  } catch {
-    return false;
-  }
-}
-
-const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-
-export function createEvents(onProgress, onSession) {
-  return jsonLineEvents((event, state) => {
-    const sessionId = event.type === 'thread.started' ? event.thread_id : undefined;
-    if (event.item?.type === 'agent_message' && event.type === 'item.completed' && typeof event.item.text === 'string') state.lastMessage = event.item.text;
-    if (event.type === 'turn.failed' || event.type === 'error') state.terminalError = '编程工具报告任务失败';
-    let activity = '';
-    if (event.type === 'turn.started') activity = '正在分析任务';
-    if (event.type === 'turn.completed') activity = '正在整理结果';
-    if (event.type.startsWith('item.')) {
-      const completed = event.type === 'item.completed';
-      switch (event.item?.type) {
-        case 'command_execution': activity = toolActivity('command', completed); break;
-        case 'file_change': activity = toolActivity('edit', completed); break;
-        case 'web_search': activity = completed ? '资料检索完成' : '正在查找资料'; break;
-        case 'mcp_tool_call': case 'collab_tool_call': activity = toolActivity('', completed); break;
-        case 'todo_list': if (completed) activity = '已更新任务步骤'; break;
-        case 'agent_message': if (completed) activity = '正在整理答复'; break;
-      }
-    }
-    return { sessionId, activity };
-  }, onProgress, onSession);
-}
-
-const adapter = {
-  label: 'Codex', createEvents,
-  command({ cwd, instruction, config, model, sessionId }) {
-    const args = ['exec', '--json', '--sandbox', 'workspace-write', '-C', cwd];
-    if (sessionId) args.push('resume');
-    const selected = model ?? config.codexModel;
-    if (selected) args.push('-m', selected);
-    if (sessionId) args.push(sessionId);
-    args.push('-');
-    return { command: 'codex', args, stdin: instruction };
-  },
-  classifyExit({ job, project, stderr, output, startingGitSnapshot }) {
-    const activeWriter = /Failed to create session:\s*thread-store conflict:\s*thread [A-Za-z0-9_-]{6,128} already has an active writer/;
-    if (job.sessionId && activeWriter.test(`${stderr}\n${output.rawTail}`)) {
-      let unchanged = false;
-      try { unchanged = gitState(project.path).snapshot === startingGitSnapshot; }
-      catch { /* An unreadable or changed repository cannot be retried safely. */ }
-      if (!unchanged) return new Error('Codex 对话正被使用，项目文件也发生变化。请先检查改动。');
-      const error = new Error('此 Codex 对话正在另一窗口或进程使用；结束后再次确认即可继续');
-      error.code = 'CODEX_SESSION_ACTIVE_WRITER';
-      error.retryable = true;
-      return error;
-    }
-    if (/model is not supported when using Codex|Model metadata for/.test(output.rawTail)) {
-      return new Error('Codex 当前模型不能用于这个登录账号。请在电脑桥接页面的“编程助手模型”中选择该账号可用的模型。');
-    }
-  },
-};
-
-export default {
-  apiVersion: 1, kind: 'coding-agent', id: 'codex', label: 'Codex', icon: builtinAgentIcons.fox,
-  capabilities: { session: 'native', model: true, cancel: true, progress: true },
-  model: { default: 'gpt-6-astra', required: true },
-  sessionIdPattern: UUID,
-  probe: () => {
-    const state = probeCli('codex', ['login', 'status']);
-    if (state.available || !hasCustomProviderAuth()) return state;
-    return { available: true, mode: 'local_cli', reason: '' };
-  },
-  run: (context) => runCli(context, adapter),
-  createEvents,
-  syncJobState(job) {
-    if (job.error === 'Codex 当前模型不能用于这个登录账号。请设置 VIBE_CODEX_MODEL 为该账号在 CLI 中可用的模型。') {
-      job.error = 'Codex 当前模型不能用于这个登录账号。请在电脑桥接页面的“编程助手模型”中选择该账号可用的模型。';
-    }
-  },
-};

package/src/agents/cursor.mjs

@@ -1,31 +0,0 @@
-import { builtinAgentIcons } from '../agent-icons.mjs';
-import { probeCli, runCli } from './shared.mjs';
-import { jsonLineEvents, assistantEvent, streamActivity } from './events.mjs';
-
-export function createEvents(onProgress, onSession) {
-  return jsonLineEvents((event, state) => {
-    assistantEvent(event, state, { append: true });
-    return { sessionId: event.session_id, activity: streamActivity(event) };
-  }, onProgress, onSession);
-}
-
-const adapter = {
-  label: 'Cursor', createEvents,
-  command({ cwd, instruction, model, sessionId }) {
-    const args = ['--print', '--trust', '--output-format', 'stream-json', '--stream-partial-output', '--sandbox', 'enabled', '--auto-review', '--workspace', cwd];
-    if (sessionId) args.push('--resume', sessionId);
-    if (model) args.push('--model', model);
-    args.push(instruction);
-    return { command: 'cursor-agent', args };
-  },
-};
-
-export default {
-  apiVersion: 1, kind: 'coding-agent', id: 'cursor', label: 'Cursor', icon: builtinAgentIcons.rabbit,
-  capabilities: { session: 'native', model: true, cancel: true, progress: true },
-  model: { default: '', required: false },
-  sessionIdPattern: /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,
-  probe: () => probeCli('cursor-agent', ['status']),
-  run: (context) => runCli(context, adapter),
-  createEvents,
-};

package/src/agents/index.mjs

@@ -1,7 +0,0 @@
-import codex from './codex.mjs';
-import cursor from './cursor.mjs';
-import qoder from './qoder.mjs';
-import workbuddy from './workbuddy.mjs';
-
-export const builtinAgents = Object.freeze([codex, cursor, qoder, workbuddy]);
-export function builtinAgent(id) { return builtinAgents.find((plugin) => plugin.id === id); }

package/src/agents/qoder.mjs

@@ -1,34 +0,0 @@
-import { builtinAgentIcons } from '../agent-icons.mjs';
-import { probeCli, runCli } from './shared.mjs';
-import { jsonLineEvents, assistantEvent, streamActivity } from './events.mjs';
-
-export function createEvents(onProgress, onSession) {
-  return jsonLineEvents((event, state) => {
-    assistantEvent(event, state);
-    return {
-      sessionId: event.type === 'system' && event.subtype === 'init' ? event.session_id || event.data?.session_id : undefined,
-      activity: streamActivity(event),
-    };
-  }, onProgress, onSession);
-}
-
-const adapter = {
-  label: 'Qoder', createEvents,
-  command({ cwd, instruction, model, sessionId }) {
-    const args = ['--print', '--output-format', 'stream-json', '--permission-mode', 'accept_edits', '--cwd', cwd];
-    if (sessionId) args.push('--session-id', sessionId);
-    if (model) args.push('--model', model);
-    args.push(instruction);
-    return { command: 'qoder', args };
-  },
-};
-
-export default {
-  apiVersion: 1, kind: 'coding-agent', id: 'qoder', label: 'Qoder', icon: builtinAgentIcons.owl,
-  capabilities: { session: 'native', model: true, cancel: true, progress: true },
-  model: { default: '', required: false },
-  sessionIdPattern: /^[A-Za-z0-9_-]{6,128}$/,
-  probe: () => probeCli('qoder'),
-  run: (context) => runCli(context, adapter),
-  createEvents,
-};