@tedbrain/vlink 0.1.83 → 0.1.85

package/README.md

@@ -77,6 +77,38 @@ npm exec --registry=https://registry.npmmirror.com \
 npx --registry=https://registry.npmmirror.com -y @tedbrain/vlink@latest install --no-setup
 ```
 
+## 安装 TedBrain MCP
+
+已安装原生 vlink 后，可以通过现有 npm 包注册 MCP：
+
+```bash
+npx -y @tedbrain/vlink@latest mcp install
+npx -y @tedbrain/vlink@latest mcp install claude
+npx -y @tedbrain/vlink@latest mcp install codex
+```
+
+省略 Agent 时使用 vlink 的交互多选；也支持透传 `--proxy-url` 等原生安装参数。
+入口查找 PATH 中的原生 vlink，再检查用户安装目录（支持 `VLINK_INSTALL_DIR`），
+不使用 npm 缓存二进制注册 MCP。缺少原生 vlink 时会提示先执行
+`npx -y @tedbrain/vlink@latest install --no-setup`。
+
+注册前使用 `vlink update --json` 查询运行时最新正式 release，并要求本机版本
+不低于该 release。npm 的 `@latest` 标签或包版本不能代替这次检查。
+版本过旧时显示当前版本、最新版本和程序路径，说明升级可能停止 daemon、
+回退到用户安装目录，再询问 `是否升级 vlink 并继续安装 MCP？[y/N]`。
+只有明确输入 `y` 或 `yes` 才会执行 `vlink update --apply --json`；
+随后重新检查升级后的程序，验证通过才调用其绝对路径执行 `mcp install`。
+版本已达标时直接注册，不降级较新版本。
+
+拒绝升级、无法确认 release、版本检查被跳过、升级失败或 Windows 后台替换
+尚未完成时停止，不注册 MCP。需要升级的非交互环境也会停止，提示手动运行
+`vlink update --apply` 后重试；`npx -y` 只确认 npm 包获取，不代表同意升级 vlink。
+`mcp install --help` 直接显示原生帮助，不查询 release 或触发升级。
+
+Agent 最终启动的是持久安装的 `vlink mcp run`，不依赖 npx 缓存。
+注册项及安装记录仍由 vlink 管理，卸载使用 `vlink mcp uninstall codex`
+或 `vlink mcp uninstall claude`。此入口不修改模型供应商配置。
+
 ## 从旧版全局 npm 安装迁移
 
 旧版 npm 包会注册 `vlink`、`vlink.cmd`、`vlink.ps1` 入口。新版改为由 npm

package/bin/vlink.js

@@ -35,6 +35,12 @@ async function main() {
     verbose(`argv=${JSON.stringify(diagnosticArgs(args))}`);
   }
 
+  if (args[0] === 'mcp' && args[1] === 'install') {
+    const { runMcpInstaller } = require('../mcp-installer');
+    await runMcpInstaller(args.slice(2));
+    return;
+  }
+
   const { ensureBinary, VERSION } = require('../install');
   const { runInstallerFromArgs } = require('../installer');
   if (diagnostic) verbose(`package version=${VERSION}`);

package/binaries.json

@@ -1,12 +1,12 @@
 {
-  "version": "0.1.83",
+  "version": "0.1.85",
   "binaries": {
-    "linux-x86_64": "1bff42798cd5ad5d52907030da04acfef215f4c653a42e05a9affd4436835b63",
-    "linux-x86_64-glibc2.17": "3d8c90a8b4157b466919eca03c1666634afb9c45bc93e4e201030ccf8a7f76d9",
-    "linux-aarch64": "b50ce98491dfc3b5ed7d6d9192eafa1574bda59859dc3d97db4b45500e1551c9",
-    "macos-x86_64": "0eb571f7ef7f025e3391bf0c33835d1e556d5c19018f7aecf8ee12cbb8862083",
-    "macos-aarch64": "59eb8807dee646264eef00b425b848c5fd8c18bf61a2aced2fdfeb9327fdb2f9",
-    "windows-x86_64.exe": "2b35c5e0b01aecbbd50969329e78fc578b8b5fd2acef2d2df5a2f4106613cafd",
-    "windows-aarch64.exe": "38a1ed711828ee5f8e4f1d716b9eb38fd50f928e9fd7bc6dd6c06a860159fd04"
+    "linux-x86_64": "9667555f9cf3a2ecef6be8d562ebf15a1d28fb6f5cfd99f7531ca04e301cf2a0",
+    "linux-x86_64-glibc2.17": "ab7b76dde34b52d6ce92e97784f0213906d600fbd172112fe3f5385ea5443dc5",
+    "linux-aarch64": "35eadcb1bfca715cdf49f2c1b107b75ccac384e55447b0a0b55edd254caba451",
+    "macos-x86_64": "d8d4765aa2c1be19d0888ca02526063bbc370c612e8f6c056e3aef073171de39",
+    "macos-aarch64": "ce07019e0ee0c2d98193f85017eebd22d14df2e1d98f47aae1eb3583fce59ca1",
+    "windows-x86_64.exe": "64177f28f47ef23b2fac1871e1225834f9a44cffc6c7848435ad222e0127e149",
+    "windows-aarch64.exe": "7c24504d79a0440cdb42ae8c815645f8e65750a60abc0002201af431b3b28059"
   }
 }

package/mcp-installer.js

@@ -0,0 +1,154 @@
+'use strict';
+
+const path = require('path');
+const readline = require('readline');
+const { spawnSync } = require('child_process');
+const {
+  defaultInstallDir, findOnPath, isExecutableFile, isVlinkWrapper, VlinkSetupError
+} = require('./installer');
+
+const RETRY_HINT = '请手动运行 vlink update --apply，完成后重新执行 MCP 安装。';
+
+function parseVersion(value) {
+  const match = typeof value === 'string' && value.match(
+    /^v?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/
+  );
+  if (!match) throw new VlinkSetupError('无法确认有效的 vlink 版本，未安装 MCP。');
+  const prerelease = match[4] ? match[4].split('.') : [];
+  if (prerelease.some((part) => /^0\d+$/.test(part))) {
+    throw new VlinkSetupError('无法确认有效的 vlink 预发布版本，未安装 MCP。');
+  }
+  return { core: match.slice(1, 4).map(BigInt), prerelease };
+}
+
+function compareVersions(left, right) {
+  const a = parseVersion(left);
+  const b = parseVersion(right);
+  for (let i = 0; i < 3; i += 1) {
+    if (a.core[i] !== b.core[i]) return a.core[i] > b.core[i] ? 1 : -1;
+  }
+  if (!a.prerelease.length || !b.prerelease.length) {
+    return Number(!a.prerelease.length) - Number(!b.prerelease.length);
+  }
+  for (let i = 0; i < Math.max(a.prerelease.length, b.prerelease.length); i += 1) {
+    const x = a.prerelease[i];
+    const y = b.prerelease[i];
+    if (x === y) continue;
+    if (x === undefined || y === undefined) return x === undefined ? -1 : 1;
+    const nx = /^\d+$/.test(x);
+    const ny = /^\d+$/.test(y);
+    if (nx !== ny) return nx ? -1 : 1;
+    return (nx ? BigInt(x) > BigInt(y) : x > y) ? 1 : -1;
+  }
+  return 0;
+}
+
+function confirmUpgrade(input, output) {
+  return new Promise((resolve) => {
+    const reader = readline.createInterface({ input, output, terminal: true });
+    reader.once('close', () => resolve(false));
+    reader.once('SIGINT', () => reader.close());
+    reader.question('是否升级 vlink 并继续安装 MCP？[y/N] ', (answer) => {
+      resolve(/^(y|yes)$/i.test(answer.trim()));
+      reader.close();
+    });
+  });
+}
+
+async function runMcpInstaller(args, options = {}) {
+  const env = options.env || process.env;
+  const platform = options.platform || process.platform;
+  const input = options.input || process.stdin;
+  const output = options.output || process.stderr;
+  const run = options.spawnSync || spawnSync;
+  const binaryName = platform === 'win32' ? 'vlink.exe' : 'vlink';
+  const discovery = { env, platform };
+  const fallback = path.join(defaultInstallDir({ platform }, env, options.home), binaryName);
+  let binary = findOnPath(binaryName, discovery);
+  if (!binary && isExecutableFile(fallback, platform) && !isVlinkWrapper(fallback)) {
+    binary = fallback;
+  }
+  if (!binary) {
+    throw new VlinkSetupError(
+      '未找到已安装的原生 vlink。请先运行 npx -y @tedbrain/vlink@latest install --no-setup。'
+    );
+  }
+  binary = path.resolve(binary);
+
+  function execute(command, commandArgs, capture = true) {
+    const result = run(command, commandArgs, {
+      env,
+      encoding: 'utf8',
+      stdio: capture ? ['ignore', 'pipe', 'pipe'] : 'inherit'
+    });
+    if (capture && result.stderr) output.write(result.stderr);
+    if (result.error || result.status !== 0) {
+      throw new VlinkSetupError(
+        `vlink ${commandArgs[0]} 失败（${result.error?.message || result.signal || result.status}）。` +
+        (commandArgs[0] === 'update' ? RETRY_HINT : '请检查原生 vlink 的错误信息后重试。')
+      );
+    }
+    return result.stdout;
+  }
+
+  function updateReport(command, apply = false) {
+    const raw = execute(command, ['update', ...(apply ? ['--apply'] : []), '--json']);
+    let report;
+    try {
+      report = JSON.parse(raw);
+    } catch {
+      throw new VlinkSetupError(`vlink update 未返回有效 JSON。${RETRY_HINT}`);
+    }
+    if (!report || report.ok !== true || typeof report.update_required !== 'boolean') {
+      throw new VlinkSetupError(`vlink update 未返回成功的版本检查结果。${RETRY_HINT}`);
+    }
+    // A skipped check or a build-date guard is not proof of the minimum release version.
+    parseVersion(report.local_version);
+    parseVersion(report.latest_version);
+    if (parseVersion(report.latest_version).prerelease.length) {
+      throw new VlinkSetupError(`未获取到最新正式 release。${RETRY_HINT}`);
+    }
+    return report;
+  }
+
+  // Help must remain read-only and work without a release lookup.
+  if (args.includes('--help') || args.includes('-h')) {
+    execute(binary, ['mcp', 'install', ...args], false);
+    return;
+  }
+
+  const checked = updateReport(binary);
+  output.write(`[TedBrain] vlink: ${binary}\n当前版本: ${checked.local_version}\n最新 release: ${checked.latest_version}\n`);
+  if (compareVersions(checked.local_version, checked.latest_version) < 0) {
+    if (!checked.update_required) {
+      throw new VlinkSetupError(`当前版本低于最新 release，但更新被跳过：${checked.skip_reason || '原因未知'}。${RETRY_HINT}`);
+    }
+    output.write('继续将升级上述 vlink；原生更新器可能回退到用户安装目录，并停止现有 daemon。\n');
+    if (!input.isTTY || !output.isTTY) {
+      throw new VlinkSetupError(`非交互环境无法确认升级，未安装 MCP。${RETRY_HINT}`);
+    }
+    const confirmed = await (options.confirmUpgrade || confirmUpgrade)(input, output);
+    if (!confirmed) throw new VlinkSetupError(`已取消升级，未安装 MCP。${RETRY_HINT}`);
+    output.write('[TedBrain] 正在升级 vlink…\n');
+    const applied = updateReport(binary, true);
+    if (applied.update_scheduled) {
+      throw new VlinkSetupError('vlink 更新已交给后台程序，尚未确认替换完成，未安装 MCP。请完成更新后重新执行 MCP 安装。');
+    }
+    if (applied.applied !== true || typeof applied.installed_path !== 'string' ||
+        !path.isAbsolute(applied.installed_path) ||
+        !isExecutableFile(applied.installed_path, platform) || isVlinkWrapper(applied.installed_path)) {
+      throw new VlinkSetupError(`vlink 升级未返回有效的已安装程序路径，未安装 MCP。${RETRY_HINT}`);
+    }
+    binary = applied.installed_path;
+    const verified = updateReport(binary);
+    if (compareVersions(verified.local_version, checked.latest_version) < 0 ||
+        compareVersions(verified.local_version, applied.latest_version) < 0 ||
+        compareVersions(verified.local_version, verified.latest_version) < 0) {
+      throw new VlinkSetupError(`升级后的 vlink 仍低于最新 release，未安装 MCP。${RETRY_HINT}`);
+    }
+  }
+  output.write(`[TedBrain] 使用 ${binary} 安装 MCP\n`);
+  execute(binary, ['mcp', 'install', ...args], false);
+}
+
+module.exports = { runMcpInstaller, confirmUpgrade };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tedbrain/vlink",
-  "version": "0.1.83",
+  "version": "0.1.85",
   "description": "vlink Virtuoso bridge CLI installer. Installs the matching platform binary at npm install time, like Claude Code / Codex.",
   "license": "UNLICENSED",
   "bin": {
@@ -10,6 +10,7 @@
     "bin/",
     "install.js",
     "installer.js",
+    "mcp-installer.js",
     "npm-shims.js",
     "binaries.json",
     "README.md"