@tedbrain/vlink 0.1.42 → 0.1.44

package/README.md

@@ -5,20 +5,29 @@ Codex 一样按当前平台下载对应的 vlink 二进制。推荐统一使用
 和 TedBrain 初始化：
 
 ```bash
-npx -y @tedbrain/vlink@latest install
+npx --registry=https://registry.npmmirror.com -y @tedbrain/vlink@latest install
 ```
 
-该命令会识别平台和架构、安装或更新 vlink、配置用户 PATH，并启动
-`vlink setup tedbrain`。安装完成后可直接运行：
+该命令会识别平台和架构，始终安装与当前 npm 包版本一致的 vlink，配置用户
+PATH，并启动 `vlink setup tedbrain`。安装完成后可直接运行：
 
 ```bash
 vlink --version
 ```
 
+Windows 会在 `vlink.exe` 旁同时生成 `vlink.cmd`。安装目录加入用户 PATH 后，
+可在 PowerShell 或 cmd 中直接运行 `vlink ...`，也可显式使用 `vlink.cmd ...`。
+
 也可以只把 npm 包作为临时 CLI 使用：
 
 ```bash
-npx -y @tedbrain/vlink@latest --version
+npx --registry=https://registry.npmmirror.com -y @tedbrain/vlink@latest --version
+```
+
+手动配置 Agent 时可以只安装或更新 vlink，并跳过 TedBrain 配置向导：
+
+```bash
+npx --registry=https://registry.npmmirror.com -y @tedbrain/vlink@latest install --no-setup
 ```
 
 ## 下载地址
@@ -35,19 +44,19 @@ release 不存在或校验失败时，自动回退到 d01 下载服务器：
 
 ```bash
 # 跳过 Gitee，直接使用 d01/自定义下载源
-VLINK_SKIP_GITEE=1 npx -y @tedbrain/vlink@latest install
+VLINK_SKIP_GITEE=1 npx --registry=https://registry.npmmirror.com -y @tedbrain/vlink@latest install
 
 # d01 回退源改用开发通道
-VLINK_DOWNLOAD_CHANNEL=oss-dev npx -y @tedbrain/vlink@latest install
+VLINK_DOWNLOAD_CHANNEL=oss-dev npx --registry=https://registry.npmmirror.com -y @tedbrain/vlink@latest install
 
 # 自定义回退下载根路径（会自动拼接 <channel>/vlink/<version>/vlink-<platform>）
-VLINK_DOWNLOAD_BASE=https://internal.example/downloads npx -y @tedbrain/vlink@latest install
+VLINK_DOWNLOAD_BASE=https://internal.example/downloads npx --registry=https://registry.npmmirror.com -y @tedbrain/vlink@latest install
 
 # 自定义回退下载目录（会自动拼接 vlink-<platform>）
-VLINK_DOWNLOAD_URL=https://internal.example/vlink npx -y @tedbrain/vlink@latest install
+VLINK_DOWNLOAD_URL=https://internal.example/vlink npx --registry=https://registry.npmmirror.com -y @tedbrain/vlink@latest install
 
 # 指定不同版本（同时影响 Gitee release tag 与 d01 回退路径）
-VLINK_VERSION=0.1.21 npx -y @tedbrain/vlink@latest install
+VLINK_VERSION=0.1.21 npx --registry=https://registry.npmmirror.com -y @tedbrain/vlink@latest install
 ```
 
 ## 平台映射

package/binaries.json

@@ -1,12 +1,12 @@
 {
-  "version": "0.1.42",
+  "version": "0.1.44",
   "binaries": {
-    "linux-x86_64": "a5ea94730528e9781d6187a0a25fc3470bdf893288e196ee50b0d5b01da1f073",
-    "linux-x86_64-glibc2.17": "9bf3d5e27bf22fb45764c1bf979ab9789db853eb293e69fe24177745546f037d",
-    "linux-aarch64": "3baf4ffe4985203a518158d773a9893655954476c4637d73ddb55231196b2d50",
-    "macos-x86_64": "1497f16bc14502be3669313170f9e11010cbefbffc7c4c42cae5236c5a175628",
-    "macos-aarch64": "f71d44aa3bcf31d1968ce7b046adb5e7ec79ae125cfccb06a6ac29b93ec1ad77",
-    "windows-x86_64.exe": "eb77aef209afa83916d1f728115a7468b8ddcdbf2e65755fdbf43c6ca19a501c",
-    "windows-aarch64.exe": "de2f3bdb8514025e0473c88feb400acc6aa9d072f713713bd7a428a7dadcab8e"
+    "linux-x86_64": "935a98d64be6530c01d3e4c5a9ed24f672f8f3881889dc0970398978cdd8647c",
+    "linux-x86_64-glibc2.17": "eac985196bb3c31e2029b43a35e576b3fb02256b1a86fb2cdf40e2fd6cf80ffb",
+    "linux-aarch64": "45c11039633f881bdf889bef4da90d5f6275c9beaeb6066d0734e7eb0736845b",
+    "macos-x86_64": "ed1143ffa8bdce153f02a7a987d24033e31e604e0ef2653cf454fa470077c3cf",
+    "macos-aarch64": "d9c590290b1c383c60685feb7c9e88f6f6f52ba2c49bed5d0cf1f3e79b773cd8",
+    "windows-x86_64.exe": "b38582348385131acba91abec301f7249b65ef3eb880179185a976c2f9038ebc",
+    "windows-aarch64.exe": "815ef8fad0c2ab9ae83ca080e2f28109bb956ec4829bd3cae765d9097339f7e0"
   }
 }

package/installer.js

@@ -318,6 +318,45 @@ function installBinary(sourcePath, targetPath, options = {}) {
   return targetPath;
 }
 
+function windowsCommandShimPath(vlinkPath) {
+  return path.join(path.dirname(vlinkPath), 'vlink.cmd');
+}
+
+function windowsCommandShimContents() {
+  return [
+    '@echo off',
+    '"%~dp0vlink.exe" %*',
+    'exit /b %ERRORLEVEL%',
+    ''
+  ].join('\r\n');
+}
+
+function installWindowsCommandShim(vlinkPath, options = {}) {
+  const platform = options.platform || process.platform;
+  if (platform !== 'win32') return null;
+
+  const fsImpl = options.fs || fs;
+  const output = options.output || process.stderr;
+  const commandPath = windowsCommandShimPath(vlinkPath);
+  const temporary = `${commandPath}.install-${process.pid}-${Date.now()}`;
+
+  try {
+    fsImpl.writeFileSync(temporary, windowsCommandShimContents(), 'utf8');
+    if (fsImpl.existsSync(commandPath)) {
+      fsImpl.rmSync(commandPath, { force: true });
+    }
+    fsImpl.renameSync(temporary, commandPath);
+  } catch (error) {
+    fsImpl.rmSync(temporary, { force: true });
+    throw new VlinkSetupError(
+      `failed to install Windows command shim at ${commandPath}: ${error.message}`
+    );
+  }
+
+  log(`installed Windows command shim at ${commandPath}`, output);
+  return commandPath;
+}
+
 function binaryIsStaticElf(binaryPath, options = {}) {
   if ((options.platform || process.platform) !== 'linux') return false;
   const spawnSyncImpl = options.spawnSync || spawnSync;
@@ -346,6 +385,7 @@ async function runInstaller(options = {}) {
   const env = options.env || process.env;
   const platform = options.platform || env.VLINK_PLATFORM || process.platform;
   const arch = options.arch || env.VLINK_ARCH || process.arch;
+  const skipSetup = Boolean(options.skipSetup);
   const home = options.home || os.homedir();
   const fsImpl = options.fs || fs;
   const output = options.output || process.stderr;
@@ -381,71 +421,64 @@ async function runInstaller(options = {}) {
   });
 
   if (vlinkPath) {
-    log(`found vlink at ${vlinkPath}`, output);
+    log(
+      `found vlink at ${vlinkPath}; installing vlink ${installModule.VERSION}`,
+      output
+    );
   } else if (isExecutableFile(targetPath, platform, fsImpl)) {
     vlinkPath = targetPath;
     ensureUserPath(installDir, sharedOptions);
-    log(`found vlink at ${vlinkPath}`, output);
+    log(
+      `found vlink at ${vlinkPath}; installing vlink ${installModule.VERSION}`,
+      output
+    );
   } else {
     log(`installing vlink ${installModule.VERSION}`, output);
-    const sourcePath = await ensureBinary({});
-    installBinary(sourcePath, targetPath, {
-      ...sharedOptions,
-      stopDaemon: false
-    });
-    ensureUserPath(installDir, sharedOptions);
-    vlinkPath = targetPath;
   }
 
-  const update = runVlinkUpdate(vlinkPath, { spawnSync: spawnSyncImpl });
-  if (update.supported) {
-    if (update.updateRequired) {
-      log('a newer vlink release is available; applying it', output);
-      if (
-        update.installedPath &&
-        isExecutableFile(update.installedPath, platform, fsImpl)
-      ) {
-        vlinkPath = update.installedPath;
-        if (samePath(path.dirname(vlinkPath), installDir, platform)) {
-          ensureUserPath(installDir, sharedOptions);
-        }
-      }
-    } else {
-      log('vlink is up to date', output);
-    }
-  } else {
-    log('installed vlink does not support update checks; installing the latest release', output);
-    const sourcePath = await ensureBinary({});
-    installBinary(sourcePath, targetPath, {
-      ...sharedOptions,
-      stopDaemon: true
-    });
+  const replacingExisting = Boolean(vlinkPath);
+  const installTarget = vlinkPath || targetPath;
+  const sourcePath = await ensureBinary({});
+  installBinary(sourcePath, installTarget, {
+    ...sharedOptions,
+    stopDaemon: replacingExisting
+  });
+  if (
+    !replacingExisting ||
+    samePath(path.dirname(installTarget), installDir, platform)
+  ) {
     ensureUserPath(installDir, sharedOptions);
-    vlinkPath = targetPath;
   }
+  vlinkPath = installTarget;
 
   vlinkPath = await migrateStaticVlink(vlinkPath, spec, {
     ...sharedOptions,
     ensureBinary
   });
+  const commandShimPath = installWindowsCommandShim(vlinkPath, sharedOptions);
 
-  log('starting TedBrain Agent setup', output);
-  const setup = spawnSyncImpl(vlinkPath, ['setup', 'tedbrain'], {
-    stdio: 'inherit'
-  });
-  const failure = commandFailure(setup, 'vlink setup tedbrain');
-  if (failure) throw new VlinkSetupError(failure);
+  if (skipSetup) {
+    log('skipping TedBrain Agent setup', output);
+  } else {
+    log('starting TedBrain Agent setup', output);
+    const setup = spawnSyncImpl(vlinkPath, ['setup', 'tedbrain'], {
+      stdio: 'inherit'
+    });
+    const failure = commandFailure(setup, 'vlink setup tedbrain');
+    if (failure) throw new VlinkSetupError(failure);
+  }
 
-  return { installDir, vlinkPath };
+  return { installDir, vlinkPath, commandShimPath, setupSkipped: skipSetup };
 }
 
 function printInstallHelp(output = process.stdout) {
   output.write(
     [
-      'Usage: npx -y @tedbrain/vlink@latest install',
+      'Usage: npx --registry=https://registry.npmmirror.com -y @tedbrain/vlink@latest install [--no-setup]',
+      '',
+      'Installs or updates vlink and adds it to the user PATH.',
       '',
-      'Installs or updates vlink, adds it to the user PATH, and starts',
-      'the TedBrain setup wizard.'
+      '  --no-setup  Install without starting the TedBrain setup wizard.'
     ].join('\n') + '\n'
   );
 }
@@ -455,10 +488,16 @@ async function runInstallerFromArgs(args, options = {}) {
     printInstallHelp(options.output || process.stdout);
     return null;
   }
-  if (args.length > 0) {
-    throw new VlinkSetupError(`unknown install option: ${args[0]}`);
+
+  let skipSetup = false;
+  for (const arg of args) {
+    if (arg === '--no-setup') {
+      skipSetup = true;
+    } else {
+      throw new VlinkSetupError(`unknown install option: ${arg}`);
+    }
   }
-  return runInstaller(options);
+  return runInstaller({ ...options, skipSetup });
 }
 
 module.exports = {
@@ -472,6 +511,8 @@ module.exports = {
   ensureUserPath,
   runVlinkUpdate,
   installBinary,
+  windowsCommandShimPath,
+  installWindowsCommandShim,
   binaryIsStaticElf,
   runInstaller,
   runInstallerFromArgs,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tedbrain/vlink",
-  "version": "0.1.42",
+  "version": "0.1.44",
   "description": "vlink Virtuoso bridge CLI installer. Installs the matching platform binary at npm install time, like Claude Code / Codex.",
   "license": "UNLICENSED",
   "bin": {