@microi.net/cli 5.9.2 → 5.9.4

package/.codebuddy-plugin/marketplace.json

@@ -5,13 +5,13 @@
     "url": "https://microi.net"
   },
   "description": "Microi吾码官方 AI 插件市场",
-  "version": "5.9.2",
+  "version": "5.9.4",
   "plugins": [
     {
       "name": "microi",
       "source": ".",
       "description": "Microi吾码 AI 开发插件：服务器连接、Skills、MCP、V8 全量同步与低代码交付",
-      "version": "5.9.2",
+      "version": "5.9.4",
       "strict": true
     }
   ]

package/.codebuddy-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "microi",
-  "version": "5.9.2",
+  "version": "5.9.4",
   "description": "Microi吾码 AI 开发插件：服务器连接、Skills、MCP、V8 全量同步与低代码交付",
   "author": {
     "name": "Microi.Net",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "microi",
-  "version": "5.9.2",
+  "version": "5.9.4",
   "description": "Microi吾码低代码平台的 Codex 开发插件，共享 VS Code/CLI 的连接、同步、MCP、V8 与交付能力。",
   "author": {
     "name": "Microi.Net",

package/.mcp.json

@@ -4,7 +4,7 @@
       "command": "node",
       "args": [
         "-e",
-        "/*\n * Codex CLI 仍不会把 plugin .mcp.json 的相对路径定位到插件根。\n * 本脚本作为 `node -e` 内容运行：CodeBuddy/WorkBuddy 优先使用宿主注入的\n * plugin root；Codex 则回退到官方 plugin cache，并统一执行双清单校验。\n */\nconst fs = require('node:fs');\nconst os = require('node:os');\nconst path = require('node:path');\nconst primaryPackageName = '@microi.net/cli';\nconst legacyPackageName = '@microi.net/codex-plugin';\n\nfunction readJson(filePath) {\n  try { return JSON.parse(fs.readFileSync(filePath, 'utf8')); }\n  catch { return undefined; }\n}\nfunction validPluginRoot(root) {\n  const manifest = readJson(path.join(root, '.codex-plugin', 'plugin.json'));\n  const pkg = readJson(path.join(root, 'package.json'));\n  const adapter = path.join(root, 'scripts', 'mcp-codex-stdio-adapter.js');\n  const router = path.join(root, 'scripts', 'microi-codex-router.js');\n  if (manifest?.name !== 'microi' || ![primaryPackageName, legacyPackageName].includes(pkg?.name)) return undefined;\n  if (!manifest.version || manifest.version !== pkg.version) return undefined;\n  if (!fs.existsSync(adapter) || !fs.existsSync(router)) return undefined;\n  return {\n    root,\n    adapter,\n    router,\n    packagePriority: pkg.name === primaryPackageName ? 1 : 0,\n    modifiedAt: Math.max(fs.statSync(adapter).mtimeMs, fs.statSync(router).mtimeMs),\n  };\n}\n\nfunction findPluginRoot() {\n  const explicitRoots = [\n    ['MICROI_CODEX_PLUGIN_ROOT', process.env.MICROI_CODEX_PLUGIN_ROOT],\n    ['CODEBUDDY_PLUGIN_ROOT', process.env.CODEBUDDY_PLUGIN_ROOT],\n    ['WORKBUDDY_PLUGIN_ROOT', process.env.WORKBUDDY_PLUGIN_ROOT],\n    ['CLAUDE_PLUGIN_ROOT', process.env.CLAUDE_PLUGIN_ROOT],\n  ];\n  for (const [source, value] of explicitRoots) {\n    const explicit = String(value || '').trim();\n    if (!explicit) continue;\n    const validated = validPluginRoot(path.resolve(explicit));\n    if (!validated) throw new Error(`${source} 不是有效的 Microi Plugin：${explicit}`);\n    return validated;\n  }\n\n  const codexHome = path.resolve(process.env.CODEX_HOME || path.join(os.homedir(), '.codex'));\n  const cacheRoot = path.join(codexHome, 'plugins', 'cache');\n  const candidates = [];\n  if (fs.existsSync(cacheRoot)) {\n    for (const marketplace of fs.readdirSync(cacheRoot, { withFileTypes: true }).filter(entry => entry.isDirectory())) {\n      const pluginDir = path.join(cacheRoot, marketplace.name, 'microi');\n      if (!fs.existsSync(pluginDir)) continue;\n      for (const version of fs.readdirSync(pluginDir, { withFileTypes: true }).filter(entry => entry.isDirectory())) {\n        const candidateRoot = path.resolve(pluginDir, version.name);\n        const relative = path.relative(cacheRoot, candidateRoot);\n        if (relative.startsWith('..') || path.isAbsolute(relative)) continue;\n        const validated = validPluginRoot(candidateRoot);\n        if (validated) candidates.push(validated);\n      }\n    }\n  }\n  candidates.sort((left, right) => right.packagePriority - left.packagePriority || right.modifiedAt - left.modifiedAt);\n  if (!candidates[0]) {\n    throw new Error(`未在 Codex plugin cache 找到有效的 Microi Agentx Plugin：${cacheRoot}`);\n  }\n  return candidates[0];\n}\n\ntry {\n  const plugin = findPluginRoot();\n  process.env.MICROI_CODEX_PLUGIN_ROOT = plugin.root;\n  process.argv[2] = plugin.router;\n  require(plugin.adapter);\n} catch (error) {\n  console.error(`[microi-codex-bootstrap] ${error instanceof Error ? error.message : String(error)}`);\n  process.exit(1);\n}\n"
+        "/*\r\n * Codex CLI 仍不会把 plugin .mcp.json 的相对路径定位到插件根。\r\n * 本脚本作为 `node -e` 内容运行：CodeBuddy/WorkBuddy 优先使用宿主注入的\r\n * plugin root；Codex 则回退到官方 plugin cache，并统一执行双清单校验。\r\n */\r\nconst fs = require('node:fs');\r\nconst os = require('node:os');\r\nconst path = require('node:path');\r\nconst primaryPackageName = '@microi.net/cli';\r\nconst legacyPackageName = '@microi.net/codex-plugin';\r\n\r\nfunction readJson(filePath) {\r\n  try { return JSON.parse(fs.readFileSync(filePath, 'utf8')); }\r\n  catch { return undefined; }\r\n}\r\nfunction validPluginRoot(root) {\r\n  const manifest = readJson(path.join(root, '.codex-plugin', 'plugin.json'));\r\n  const pkg = readJson(path.join(root, 'package.json'));\r\n  const adapter = path.join(root, 'scripts', 'mcp-codex-stdio-adapter.js');\r\n  const router = path.join(root, 'scripts', 'microi-codex-router.js');\r\n  if (manifest?.name !== 'microi' || ![primaryPackageName, legacyPackageName].includes(pkg?.name)) return undefined;\r\n  if (!manifest.version || manifest.version !== pkg.version) return undefined;\r\n  if (!fs.existsSync(adapter) || !fs.existsSync(router)) return undefined;\r\n  return {\r\n    root,\r\n    adapter,\r\n    router,\r\n    packagePriority: pkg.name === primaryPackageName ? 1 : 0,\r\n    modifiedAt: Math.max(fs.statSync(adapter).mtimeMs, fs.statSync(router).mtimeMs),\r\n  };\r\n}\r\n\r\nfunction findPluginRoot() {\r\n  const explicitRoots = [\r\n    ['MICROI_CODEX_PLUGIN_ROOT', process.env.MICROI_CODEX_PLUGIN_ROOT],\r\n    ['CODEBUDDY_PLUGIN_ROOT', process.env.CODEBUDDY_PLUGIN_ROOT],\r\n    ['WORKBUDDY_PLUGIN_ROOT', process.env.WORKBUDDY_PLUGIN_ROOT],\r\n    ['CLAUDE_PLUGIN_ROOT', process.env.CLAUDE_PLUGIN_ROOT],\r\n  ];\r\n  for (const [source, value] of explicitRoots) {\r\n    const explicit = String(value || '').trim();\r\n    if (!explicit) continue;\r\n    const validated = validPluginRoot(path.resolve(explicit));\r\n    if (!validated) throw new Error(`${source} 不是有效的 Microi Plugin：${explicit}`);\r\n    return validated;\r\n  }\r\n\r\n  const codexHome = path.resolve(process.env.CODEX_HOME || path.join(os.homedir(), '.codex'));\r\n  const cacheRoot = path.join(codexHome, 'plugins', 'cache');\r\n  const candidates = [];\r\n  if (fs.existsSync(cacheRoot)) {\r\n    for (const marketplace of fs.readdirSync(cacheRoot, { withFileTypes: true }).filter(entry => entry.isDirectory())) {\r\n      const pluginDir = path.join(cacheRoot, marketplace.name, 'microi');\r\n      if (!fs.existsSync(pluginDir)) continue;\r\n      for (const version of fs.readdirSync(pluginDir, { withFileTypes: true }).filter(entry => entry.isDirectory())) {\r\n        const candidateRoot = path.resolve(pluginDir, version.name);\r\n        const relative = path.relative(cacheRoot, candidateRoot);\r\n        if (relative.startsWith('..') || path.isAbsolute(relative)) continue;\r\n        const validated = validPluginRoot(candidateRoot);\r\n        if (validated) candidates.push(validated);\r\n      }\r\n    }\r\n  }\r\n  candidates.sort((left, right) => right.packagePriority - left.packagePriority || right.modifiedAt - left.modifiedAt);\r\n  if (!candidates[0]) {\r\n    throw new Error(`未在 Codex plugin cache 找到有效的 Microi Agentx Plugin：${cacheRoot}`);\r\n  }\r\n  return candidates[0];\r\n}\r\n\r\ntry {\r\n  const plugin = findPluginRoot();\r\n  process.env.MICROI_CODEX_PLUGIN_ROOT = plugin.root;\r\n  process.argv[2] = plugin.router;\r\n  require(plugin.adapter);\r\n} catch (error) {\r\n  console.error(`[microi-codex-bootstrap] ${error instanceof Error ? error.message : String(error)}`);\r\n  process.exit(1);\r\n}\r\n"
       ]
     }
   }

package/.workbuddy-plugin/marketplace.json

@@ -5,13 +5,13 @@
     "url": "https://microi.net"
   },
   "description": "Microi吾码官方 AI 插件市场",
-  "version": "5.9.2",
+  "version": "5.9.4",
   "plugins": [
     {
       "name": "microi",
       "source": ".",
       "description": "Microi吾码 AI 开发插件：服务器连接、Skills、MCP、V8 全量同步与低代码交付",
-      "version": "5.9.2",
+      "version": "5.9.4",
       "strict": true
     }
   ]

package/.workbuddy-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "microi",
-  "version": "5.9.2",
+  "version": "5.9.4",
   "description": "Microi吾码 AI 开发插件：服务器连接、Skills、MCP、V8 全量同步与低代码交付",
   "author": {
     "name": "Microi.Net",

package/assets/build-meta.json

@@ -1,6 +1,6 @@
 {
-  "builtAt": "2026-10-11T08:09:47.299Z",
-  "version": "5.9.2",
+  "builtAt": "2026-10-13T11:15:11.646Z",
+  "version": "5.9.4",
   "sourceProducts": [
     "vscode-extension",
     "microi-cli",
@@ -10,10 +10,10 @@
   "commands": 55,
   "skills": 68,
   "hashes": {
-    "mcpServer": "daf65060b88bc1a52bc0333e0f2a4c7aba2b0c97aa6c53c3d6c5189d40c15950",
+    "mcpServer": "f0d0bd5bc2301f3103d9642fa93c70e5c968f58aab71868ee1611505a8fcacbf",
     "cli": "f9f346bce30623280ce56afd4d0d516918a869f8e264ae55863c8f5d7c28002b",
-    "router": "761b54007451348da5f6491245635c15c33663cae6c1811005839bc2312886e2",
-    "broker": "fffe3a7bbbc0c842d69c2eda09a0490ce0055a060f56d6a6d6230046e8952749",
-    "dshBundle": "8f7a9b90bc278a6e5e8eadff122006909cd3167dd398a26b9988df27616ca74c"
+    "router": "3d46e39d6eee958347e0b2be3a103c3689d26674b6082c6a4c21fd6a80eee222",
+    "broker": "ed04bbcc5bc7d62e447d82946889d1f72af653a9016675f81a01ef6cd88051b0",
+    "dshBundle": "525c82cf21b14c94082ebba77831bc5e5ac442ae7a49a549fc491e2c2cb9910f"
   }
 }

package/cordis.patch.yml

@@ -7,7 +7,7 @@
         serverName: microi
         transport: stdio
         command: !!js process.execPath
-        args: ["-e","/*\n * DeepSeek Harness 通过 profile bundle 加载此 `node -e` 引导脚本。\n * DSH 不保证 MCP 子进程 cwd 位于 npm 包根，因此按 DSH_HOME/profile 定位\n * 当前版本的 @microi.net/cli，再复用 Codex 同源适配器与多连接路由器。\n */\nconst fs = require('node:fs');\nconst os = require('node:os');\nconst path = require('node:path');\nconst packageName = '@microi.net/cli';\nconst expectedVersion = '5.9.2';\n\nfunction readJson(filePath) {\n  try { return JSON.parse(fs.readFileSync(filePath, 'utf8')); }\n  catch { return undefined; }\n}\n\nfunction expandHome(value) {\n  if (value === '~') return os.homedir();\n  if (value.startsWith('~/') || value.startsWith('~\\\\')) return path.join(os.homedir(), value.slice(2));\n  return value;\n}\n\nfunction validRoot(value) {\n  const root = path.resolve(value);\n  const pkg = readJson(path.join(root, 'package.json'));\n  const patch = path.join(root, 'cordis.patch.yml');\n  const adapter = path.join(root, 'scripts', 'mcp-codex-stdio-adapter.js');\n  const router = path.join(root, 'scripts', 'microi-codex-router.js');\n  if (pkg?.name !== packageName || pkg?.version !== expectedVersion) return undefined;\n  if (pkg?.dsh?.bundle?.patch !== './cordis.patch.yml') return undefined;\n  if (![patch, adapter, router].every(filePath => fs.existsSync(filePath))) return undefined;\n  return { root: fs.realpathSync(root), adapter, router, modifiedAt: fs.statSync(router).mtimeMs };\n}\n\nfunction findPlugin() {\n  const explicit = String(process.env.MICROI_DSH_PLUGIN_ROOT || '').trim();\n  if (explicit) {\n    const plugin = validRoot(explicit);\n    if (!plugin) throw new Error(`MICROI_DSH_PLUGIN_ROOT 不是版本 ${expectedVersion} 的有效 Microi DSH bundle：${explicit}`);\n    return plugin;\n  }\n  const configuredHome = String(process.env.DSH_HOME || '').trim();\n  const dshHome = path.resolve(expandHome(configuredHome || path.join(os.homedir(), '.dsh')));\n  const profilesRoot = path.join(dshHome, 'profiles');\n  const candidates = [];\n  if (fs.existsSync(profilesRoot)) {\n    for (const entry of fs.readdirSync(profilesRoot, { withFileTypes: true })) {\n      if (!entry.isDirectory() || entry.name === 'node_modules') continue;\n      const root = path.join(profilesRoot, entry.name, 'node_modules', '@microi.net', 'cli');\n      const plugin = validRoot(root);\n      if (plugin) candidates.push(plugin);\n    }\n  }\n  candidates.sort((left, right) => right.modifiedAt - left.modifiedAt);\n  if (!candidates[0]) throw new Error(`未在 ${profilesRoot} 找到版本 ${expectedVersion} 的 ${packageName}`);\n  return candidates[0];\n}\n\ntry {\n  const plugin = findPlugin();\n  process.env.MICROI_DSH_PLUGIN_ROOT = plugin.root;\n  process.env.MICROI_CODEX_PLUGIN_ROOT = plugin.root;\n  process.env.MICROI_TOOL_SOURCE = 'dsh';\n  process.env.MICROI_TOOL_VERSION = expectedVersion;\n  process.env.MICROI_WORKSPACE_ROOT = process.env.MICROI_WORKSPACE_ROOT || process.cwd();\n  process.argv[2] = plugin.router;\n  require(plugin.adapter);\n} catch (error) {\n  console.error(`[microi-dsh-bootstrap] ${error instanceof Error ? error.message : String(error)}`);\n  process.exit(1);\n}\n"]
+        args: ["-e","/*\r\n * DeepSeek Harness 通过 profile bundle 加载此 `node -e` 引导脚本。\r\n * DSH 不保证 MCP 子进程 cwd 位于 npm 包根，因此按 DSH_HOME/profile 定位\r\n * 当前版本的 @microi.net/cli，再复用 Codex 同源适配器与多连接路由器。\r\n */\r\nconst fs = require('node:fs');\r\nconst os = require('node:os');\r\nconst path = require('node:path');\r\nconst packageName = '@microi.net/cli';\r\nconst expectedVersion = '5.9.4';\r\n\r\nfunction readJson(filePath) {\r\n  try { return JSON.parse(fs.readFileSync(filePath, 'utf8')); }\r\n  catch { return undefined; }\r\n}\r\n\r\nfunction expandHome(value) {\r\n  if (value === '~') return os.homedir();\r\n  if (value.startsWith('~/') || value.startsWith('~\\\\')) return path.join(os.homedir(), value.slice(2));\r\n  return value;\r\n}\r\n\r\nfunction validRoot(value) {\r\n  const root = path.resolve(value);\r\n  const pkg = readJson(path.join(root, 'package.json'));\r\n  const patch = path.join(root, 'cordis.patch.yml');\r\n  const adapter = path.join(root, 'scripts', 'mcp-codex-stdio-adapter.js');\r\n  const router = path.join(root, 'scripts', 'microi-codex-router.js');\r\n  if (pkg?.name !== packageName || pkg?.version !== expectedVersion) return undefined;\r\n  if (pkg?.dsh?.bundle?.patch !== './cordis.patch.yml') return undefined;\r\n  if (![patch, adapter, router].every(filePath => fs.existsSync(filePath))) return undefined;\r\n  return { root: fs.realpathSync(root), adapter, router, modifiedAt: fs.statSync(router).mtimeMs };\r\n}\r\n\r\nfunction findPlugin() {\r\n  const explicit = String(process.env.MICROI_DSH_PLUGIN_ROOT || '').trim();\r\n  if (explicit) {\r\n    const plugin = validRoot(explicit);\r\n    if (!plugin) throw new Error(`MICROI_DSH_PLUGIN_ROOT 不是版本 ${expectedVersion} 的有效 Microi DSH bundle：${explicit}`);\r\n    return plugin;\r\n  }\r\n  const configuredHome = String(process.env.DSH_HOME || '').trim();\r\n  const dshHome = path.resolve(expandHome(configuredHome || path.join(os.homedir(), '.dsh')));\r\n  const profilesRoot = path.join(dshHome, 'profiles');\r\n  const candidates = [];\r\n  if (fs.existsSync(profilesRoot)) {\r\n    for (const entry of fs.readdirSync(profilesRoot, { withFileTypes: true })) {\r\n      if (!entry.isDirectory() || entry.name === 'node_modules') continue;\r\n      const root = path.join(profilesRoot, entry.name, 'node_modules', '@microi.net', 'cli');\r\n      const plugin = validRoot(root);\r\n      if (plugin) candidates.push(plugin);\r\n    }\r\n  }\r\n  candidates.sort((left, right) => right.modifiedAt - left.modifiedAt);\r\n  if (!candidates[0]) throw new Error(`未在 ${profilesRoot} 找到版本 ${expectedVersion} 的 ${packageName}`);\r\n  return candidates[0];\r\n}\r\n\r\ntry {\r\n  const plugin = findPlugin();\r\n  process.env.MICROI_DSH_PLUGIN_ROOT = plugin.root;\r\n  process.env.MICROI_CODEX_PLUGIN_ROOT = plugin.root;\r\n  process.env.MICROI_TOOL_SOURCE = 'dsh';\r\n  process.env.MICROI_TOOL_VERSION = expectedVersion;\r\n  process.env.MICROI_WORKSPACE_ROOT = process.env.MICROI_WORKSPACE_ROOT || process.cwd();\r\n  process.argv[2] = plugin.router;\r\n  require(plugin.adapter);\r\n} catch (error) {\r\n  console.error(`[microi-dsh-bootstrap] ${error instanceof Error ? error.message : String(error)}`);\r\n  process.exit(1);\r\n}\r\n"]
         env:
           MICROI_TOOL_SOURCE: dsh
         cwd: !!js process.cwd()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microi.net/cli",
-  "version": "5.9.2",
+  "version": "5.9.4",
   "description": "Microi吾码 AI 开发 CLI 与多宿主 Plugin：服务器连接、Skills、MCP、V8 同步和低代码交付",
   "license": "MIT",
   "homepage": "https://microi.net/doc/v8-engine/vs-code-plugin.html",

package/scripts/codex-marketplace.json

@@ -1,20 +1,20 @@
-{
-  "name": "microi-net",
-  "interface": {
-    "displayName": "Microi.Net"
-  },
-  "plugins": [
-    {
-      "name": "microi",
-      "source": {
-        "source": "local",
-        "path": "./plugins/microi"
-      },
-      "policy": {
-        "installation": "AVAILABLE",
-        "authentication": "ON_USE"
-      },
-      "category": "developer-tools"
-    }
-  ]
-}
+{
+  "name": "microi-net",
+  "interface": {
+    "displayName": "Microi.Net"
+  },
+  "plugins": [
+    {
+      "name": "microi",
+      "source": {
+        "source": "local",
+        "path": "./plugins/microi"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_USE"
+      },
+      "category": "developer-tools"
+    }
+  ]
+}

package/scripts/mcp-codex-stdio-adapter.js

@@ -1,189 +1,189 @@
-#!/usr/bin/env node
-/*
- * Codex MCP stdio adapter for the bundled Microi MCP server.
- *
- * The MCP SDK version used by Microi currently speaks newline-delimited
- * JSON-RPC over stdio. Some Codex runtimes send and expect Content-Length
- * framed JSON-RPC. This adapter bridges both formats without changing the
- * normal VS Code/Cursor/Trae/Claude MCP configuration.
- */
-
-const childProcess = require('node:child_process');
-const path = require('node:path');
-
-const target = process.argv[2];
-if (!target) {
-  console.error('[microi-mcp-adapter] Missing target MCP server path.');
-  process.exit(1);
-}
-
-const child = childProcess.spawn(process.execPath, [target, ...process.argv.slice(3)], {
-  cwd: process.cwd(),
-  env: process.env,
-  stdio: ['pipe', 'pipe', 'pipe'],
-  windowsHide: true,
-});
-
-let inputBuffer = Buffer.alloc(0);
-let outputBuffer = Buffer.alloc(0);
-let clientFraming = null; // 'content-length' | 'line'
-let shutdownRequested = false;
-let requestedExitCode = 0;
-let forceExitTimer = null;
-
-function stopChildAndExit(exitCode = 0) {
-  if (shutdownRequested) return;
-  shutdownRequested = true;
-  requestedExitCode = exitCode;
-
-  if (!child.stdin.destroyed) {
-    child.stdin.end();
-  }
-
-  if (child.exitCode !== null) {
-    process.exit(requestedExitCode);
-  }
-
-  try {
-    child.kill('SIGTERM');
-  } catch {
-    process.exit(requestedExitCode);
-  }
-
-  forceExitTimer = setTimeout(() => {
-    try {
-      child.kill('SIGKILL');
-    } catch {
-      // 子进程可能已在超时边界退出。
-    }
-    process.exit(requestedExitCode);
-  }, 2000);
-}
-
-// Codex 会为每个 MCP 连接启动一个适配器。客户端退出、重载或异常断开时，
-// 必须同步终止其子 MCP 服务，否则孤儿进程会持续累积并挤占前端构建内存。
-process.stdin.on('end', () => stopChildAndExit(0));
-process.stdin.on('error', () => stopChildAndExit(1));
-process.stdout.on('error', error => {
-  stopChildAndExit(error && error.code === 'EPIPE' ? 0 : 1);
-});
-process.on('disconnect', () => stopChildAndExit(0));
-for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
-  process.on(signal, () => stopChildAndExit(0));
-}
-
-const parentPid = process.ppid;
-if (parentPid > 1) {
-  const parentWatchTimer = setInterval(() => {
-    try {
-      process.kill(parentPid, 0);
-    } catch (error) {
-      if (error && error.code === 'ESRCH') {
-        stopChildAndExit(0);
-      }
-    }
-  }, 5000);
-  parentWatchTimer.unref();
-}
-
-process.on('exit', () => {
-  if (child.exitCode === null) {
-    try {
-      child.kill('SIGKILL');
-    } catch {
-      // 退出阶段只做尽力清理。
-    }
-  }
-});
-
-function writeLineToChild(jsonText) {
-  if (!child.stdin.destroyed) {
-    child.stdin.write(jsonText.trimEnd() + '\n');
-  }
-}
-
-function writeToClient(jsonText) {
-  const text = jsonText.trim();
-  if (!text) return;
-
-  if (clientFraming === 'line') {
-    process.stdout.write(text + '\n');
-    return;
-  }
-
-  const bytes = Buffer.byteLength(text, 'utf8');
-  process.stdout.write(`Content-Length: ${bytes}\r\n\r\n${text}`);
-}
-
-function processInputBuffer() {
-  while (inputBuffer.length > 0) {
-    const asText = inputBuffer.toString('utf8');
-
-    if (/^Content-Length:/i.test(asText)) {
-      clientFraming = 'content-length';
-      const headerEnd = asText.indexOf('\r\n\r\n');
-      if (headerEnd < 0) return;
-
-      const header = asText.slice(0, headerEnd);
-      const match = header.match(/Content-Length:\s*(\d+)/i);
-      if (!match) {
-        console.error('[microi-mcp-adapter] Invalid Content-Length header.');
-        stopChildAndExit(1);
-        return;
-      }
-
-      const length = Number(match[1]);
-      const bodyStart = Buffer.byteLength(asText.slice(0, headerEnd + 4), 'utf8');
-      if (inputBuffer.length < bodyStart + length) return;
-
-      const body = inputBuffer.slice(bodyStart, bodyStart + length).toString('utf8');
-      writeLineToChild(body);
-      inputBuffer = inputBuffer.slice(bodyStart + length);
-      continue;
-    }
-
-    clientFraming = clientFraming || 'line';
-    const newline = inputBuffer.indexOf(0x0a);
-    if (newline < 0) return;
-
-    const line = inputBuffer.slice(0, newline + 1).toString('utf8').trim();
-    inputBuffer = inputBuffer.slice(newline + 1);
-    if (line) {
-      writeLineToChild(line);
-    }
-  }
-}
-
-process.stdin.on('data', chunk => {
-  inputBuffer = Buffer.concat([inputBuffer, chunk]);
-  processInputBuffer();
-});
-
-child.stdout.on('data', chunk => {
-  outputBuffer = Buffer.concat([outputBuffer, chunk]);
-  let newlineIndex;
-  while ((newlineIndex = outputBuffer.indexOf(0x0a)) >= 0) {
-    const line = outputBuffer.slice(0, newlineIndex).toString('utf8').trim();
-    outputBuffer = outputBuffer.slice(newlineIndex + 1);
-    if (line) writeToClient(line);
-  }
-});
-
-child.stderr.on('data', chunk => {
-  process.stderr.write(chunk);
-});
-
-child.on('exit', code => {
-  if (forceExitTimer) {
-    clearTimeout(forceExitTimer);
-  }
-  if (outputBuffer.length > 0) {
-    writeToClient(outputBuffer.toString('utf8'));
-  }
-  process.exit(shutdownRequested ? requestedExitCode : (code || 0));
-});
-
-child.on('error', err => {
-  console.error(`[microi-mcp-adapter] Failed to start ${path.basename(target)}: ${err.message}`);
-  stopChildAndExit(1);
-});
+#!/usr/bin/env node
+/*
+ * Codex MCP stdio adapter for the bundled Microi MCP server.
+ *
+ * The MCP SDK version used by Microi currently speaks newline-delimited
+ * JSON-RPC over stdio. Some Codex runtimes send and expect Content-Length
+ * framed JSON-RPC. This adapter bridges both formats without changing the
+ * normal VS Code/Cursor/Trae/Claude MCP configuration.
+ */
+
+const childProcess = require('node:child_process');
+const path = require('node:path');
+
+const target = process.argv[2];
+if (!target) {
+  console.error('[microi-mcp-adapter] Missing target MCP server path.');
+  process.exit(1);
+}
+
+const child = childProcess.spawn(process.execPath, [target, ...process.argv.slice(3)], {
+  cwd: process.cwd(),
+  env: process.env,
+  stdio: ['pipe', 'pipe', 'pipe'],
+  windowsHide: true,
+});
+
+let inputBuffer = Buffer.alloc(0);
+let outputBuffer = Buffer.alloc(0);
+let clientFraming = null; // 'content-length' | 'line'
+let shutdownRequested = false;
+let requestedExitCode = 0;
+let forceExitTimer = null;
+
+function stopChildAndExit(exitCode = 0) {
+  if (shutdownRequested) return;
+  shutdownRequested = true;
+  requestedExitCode = exitCode;
+
+  if (!child.stdin.destroyed) {
+    child.stdin.end();
+  }
+
+  if (child.exitCode !== null) {
+    process.exit(requestedExitCode);
+  }
+
+  try {
+    child.kill('SIGTERM');
+  } catch {
+    process.exit(requestedExitCode);
+  }
+
+  forceExitTimer = setTimeout(() => {
+    try {
+      child.kill('SIGKILL');
+    } catch {
+      // 子进程可能已在超时边界退出。
+    }
+    process.exit(requestedExitCode);
+  }, 2000);
+}
+
+// Codex 会为每个 MCP 连接启动一个适配器。客户端退出、重载或异常断开时，
+// 必须同步终止其子 MCP 服务，否则孤儿进程会持续累积并挤占前端构建内存。
+process.stdin.on('end', () => stopChildAndExit(0));
+process.stdin.on('error', () => stopChildAndExit(1));
+process.stdout.on('error', error => {
+  stopChildAndExit(error && error.code === 'EPIPE' ? 0 : 1);
+});
+process.on('disconnect', () => stopChildAndExit(0));
+for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
+  process.on(signal, () => stopChildAndExit(0));
+}
+
+const parentPid = process.ppid;
+if (parentPid > 1) {
+  const parentWatchTimer = setInterval(() => {
+    try {
+      process.kill(parentPid, 0);
+    } catch (error) {
+      if (error && error.code === 'ESRCH') {
+        stopChildAndExit(0);
+      }
+    }
+  }, 5000);
+  parentWatchTimer.unref();
+}
+
+process.on('exit', () => {
+  if (child.exitCode === null) {
+    try {
+      child.kill('SIGKILL');
+    } catch {
+      // 退出阶段只做尽力清理。
+    }
+  }
+});
+
+function writeLineToChild(jsonText) {
+  if (!child.stdin.destroyed) {
+    child.stdin.write(jsonText.trimEnd() + '\n');
+  }
+}
+
+function writeToClient(jsonText) {
+  const text = jsonText.trim();
+  if (!text) return;
+
+  if (clientFraming === 'line') {
+    process.stdout.write(text + '\n');
+    return;
+  }
+
+  const bytes = Buffer.byteLength(text, 'utf8');
+  process.stdout.write(`Content-Length: ${bytes}\r\n\r\n${text}`);
+}
+
+function processInputBuffer() {
+  while (inputBuffer.length > 0) {
+    const asText = inputBuffer.toString('utf8');
+
+    if (/^Content-Length:/i.test(asText)) {
+      clientFraming = 'content-length';
+      const headerEnd = asText.indexOf('\r\n\r\n');
+      if (headerEnd < 0) return;
+
+      const header = asText.slice(0, headerEnd);
+      const match = header.match(/Content-Length:\s*(\d+)/i);
+      if (!match) {
+        console.error('[microi-mcp-adapter] Invalid Content-Length header.');
+        stopChildAndExit(1);
+        return;
+      }
+
+      const length = Number(match[1]);
+      const bodyStart = Buffer.byteLength(asText.slice(0, headerEnd + 4), 'utf8');
+      if (inputBuffer.length < bodyStart + length) return;
+
+      const body = inputBuffer.slice(bodyStart, bodyStart + length).toString('utf8');
+      writeLineToChild(body);
+      inputBuffer = inputBuffer.slice(bodyStart + length);
+      continue;
+    }
+
+    clientFraming = clientFraming || 'line';
+    const newline = inputBuffer.indexOf(0x0a);
+    if (newline < 0) return;
+
+    const line = inputBuffer.slice(0, newline + 1).toString('utf8').trim();
+    inputBuffer = inputBuffer.slice(newline + 1);
+    if (line) {
+      writeLineToChild(line);
+    }
+  }
+}
+
+process.stdin.on('data', chunk => {
+  inputBuffer = Buffer.concat([inputBuffer, chunk]);
+  processInputBuffer();
+});
+
+child.stdout.on('data', chunk => {
+  outputBuffer = Buffer.concat([outputBuffer, chunk]);
+  let newlineIndex;
+  while ((newlineIndex = outputBuffer.indexOf(0x0a)) >= 0) {
+    const line = outputBuffer.slice(0, newlineIndex).toString('utf8').trim();
+    outputBuffer = outputBuffer.slice(newlineIndex + 1);
+    if (line) writeToClient(line);
+  }
+});
+
+child.stderr.on('data', chunk => {
+  process.stderr.write(chunk);
+});
+
+child.on('exit', code => {
+  if (forceExitTimer) {
+    clearTimeout(forceExitTimer);
+  }
+  if (outputBuffer.length > 0) {
+    writeToClient(outputBuffer.toString('utf8'));
+  }
+  process.exit(shutdownRequested ? requestedExitCode : (code || 0));
+});
+
+child.on('error', err => {
+  console.error(`[microi-mcp-adapter] Failed to start ${path.basename(target)}: ${err.message}`);
+  stopChildAndExit(1);
+});