@microi.net/cli 4.6.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Microi吾码
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# Microi吾码 CLI（microi.net/cli）
+
+`microi.net/cli` 是产品展示名，npm 中合法的安装包名是 `@microi.net/cli`。它面向偏好 Codex CLI、Claude Code、Trae 或普通终端的 Microi 开发者，与 Microi吾码 VS Code 插件共用工作区配置、Token、AI 规则、Skills、MCP 配置和 V8 同步目录；两者可以同时安装并交替使用。
+
+## 安装与首次初始化
+
+```bash
+npm install -g @microi.net/cli
+cd 你的项目目录
+microi init --pull
+```
+
+`microi init` 会依次添加服务器、提示输入帐号和密码、在服务器启用时显示验证码图片路径、登录、注入 AI 配置并配置 MCP。密码只存在于当前 CLI 进程内，不写入文件；长期使用的是工作区内受 Git 排除保护的 Token 文件。
+
+如果只初始化 AI/MCP、不立即拉取 V8 代码，执行 `microi init`。首次生成 Codex MCP 配置后，需要新开一个 Codex 对话，当前已打开的对话通常不会热加载新工具。
+
+## 常用命令
+
+```bash
+microi profile list
+microi profile add
+microi auth login --profile 1
+microi ai init
+microi mcp init
+microi pull --scope all --profile 1
+microi sync status --scope all --profile 1
+microi push "Microi-V8-Engine/.../接口.js"
+microi doctor
+```
+
+自动化脚本可加 `--json`，并用 `--workspace D:\path\to\project` 指定工作区。`push` 是显式远端写入命令，不会因普通文件保存自动执行。
+
+## 与 VS Code 插件的关系
+
+- 共用 `Microi-V8-Engine/.microi-config.json` 和 `.microi-mcp-tokens.json`。
+- 共用 `Microi-V8-Engine/` 下的 V8 源码和同步基线。
+- MCP 写入采用合并方式，只替换由 Microi 管理的 server，不删除其他 MCP。
+- 配置和 Token 使用原子写入并保留未知字段；MCP 记录来源/版本，交替使用不同版本时保留较新的内置 Server。
+- `microi doctor` 会显示 MCP 提供者是 CLI、VS Code 还是旧版 `legacy`。历史旧版不能被新代码隔空修复；运行旧工具后，再在较新一端运行 `microi mcp init` 即可恢复新版配置。
+- CLI 负责无 IDE 的连接、登录、AI/MCP 初始化、拉取、差异检查和显式推送；可视化树、编辑器按钮和逐行调试 UI 仍由 VS Code 插件提供。
+
+完整文档：<https://microi.net/doc/v8-engine/vs-code-plugin.html>
+
+## 维护者发布
+
+CLI 与 VSIX 使用同一版本号。仓库根目录执行 `node publish.js --package-only --no-bump` 会构建并校验 VSIX 与 CLI npm tarball，但不会改版本或上传。
+
+首次发布前，先在 npm 创建免费公开组织 `microi.net`，再登录。两个插件市场使用环境变量 `VSCE_PAT` / `OVSX_PAT`，或已被 Git 忽略的 `publish-tokens.local.json`：
+
+```bash
+cd Microi.VSCode/cli
+npm login --registry=https://registry.npmjs.org/
+npm whoami --registry=https://registry.npmjs.org/
+cd ..
+npm run publish:preflight
+```
+
+预检通过后执行 `npm run publish`。脚本会在递增版本前验证 npm、Visual Studio Marketplace 和 Open VSX 三方权限，同时更新插件/CLI/Skills 版本，优先发布 CLI，并在结束时回读三端公开版本。旧的 `publish-tokens.json` 曾被 Git 跟踪，必须废弃其 PAT，把新 PAT 放入环境变量或 `publish-tokens.local.json`，再删除旧文件并从 Git 索引移除；脚本不再读取它。
+
+如果当前版本的 VS Marketplace 与 Open VSX 已经发布、只需补发 CLI，不要再次运行普通发布命令；执行：
+
+```bash
+npm run publish:cli:resume
+```
+
+如果 CLI 已发布、扩展市场失败，可用 `npm run publish:extensions:resume`、`npm run publish:vsce:resume` 或 `npm run publish:ovsx:resume`。补发只能用于同一份源码/产物；中断后若代码已改动，必须发布下一个新版本。

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

@@ -0,0 +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);
+});