@tedbrain/vlink 0.1.69 → 0.1.71

package/README.md

@@ -66,6 +66,28 @@ npm exec --registry=https://registry.npmmirror.com \
 npx --registry=https://registry.npmmirror.com -y @tedbrain/vlink@latest install --no-setup
 ```
 
+## 安装 Web 通道
+
+用于网页接入、终端和协议命令调用时，执行：
+
+```bash
+npx --registry=https://registry.npmmirror.com -y @tedbrain/vlink@latest install --web
+```
+
+该选项复用原生二进制下载、更新、安装路径、PATH 和补全配置，跳过
+`vlink setup tedbrain`，随后使用安装后的二进制绝对路径依次执行：
+
+```bash
+vlink channel web install-protocol
+vlink channel web start
+```
+
+协议注册或服务启动失败时，安装命令返回非零退出码。
+`--web` 可与 `--verbose`、`--no-setup` 一起使用；`--no-setup`
+仅控制 TedBrain 向导，不会禁用 Web 初始化。
+服务已运行时沿用 `channel web start` 的幂等复用行为，不强制重启现有终端。
+该选项启动当前服务并注册 `vlink://` 唤起入口，不配置开机自启动。
+
 ## 下载地址
 
 安装脚本优先从 Gitee Release 解析当前版本对应平台的附件并下载；Gitee 不可用、

package/bin/vlink.js

@@ -15,7 +15,7 @@ function verbose(message) {
 }
 
 function diagnosticArgs(args) {
-  const safe = new Set(['install', '--verbose', '--no-setup', '--help', '-h']);
+  const safe = new Set(['install', '--verbose', '--no-setup', '--web', '--help', '-h']);
   return args.map((arg) => {
     if (safe.has(arg)) return arg;
     if (arg.startsWith('--')) return arg.split('=', 1)[0];

package/binaries.json

@@ -1,12 +1,12 @@
 {
-  "version": "0.1.69",
+  "version": "0.1.71",
   "binaries": {
-    "linux-x86_64": "2164a91d468721580169be9f86a1f6da81231d6b524e94ba39976520116a1784",
-    "linux-x86_64-glibc2.17": "108655953bead4ae476298704a8660116403b9901490a25aada2a69e85dbea55",
-    "linux-aarch64": "0240adcbf151ee25f6addbc84ad6f4c81d9dd83a87b175fb21e3674c468da81a",
-    "macos-x86_64": "d3a355ed4619adda489e3cc648c101dcf06758080ed5b646835bc8c6681c2d1b",
-    "macos-aarch64": "a48cb73a8eb673d1e917f85f2b9aad9ca627a4b676074dd4a155f3eee81be3ef",
-    "windows-x86_64.exe": "7cce4b670152450ccdbf419dcec33ceb617f9f3376be461b782fc504a502fff3",
-    "windows-aarch64.exe": "8831deb04f46f2095d6e105808aad18da2ac8bc687567479e2efbf62eaf0e4f2"
+    "linux-x86_64": "db8e756fdaaa42409708a4016c62ec3dbb858d44df480a14243f08ac944c4c5f",
+    "linux-x86_64-glibc2.17": "7e036c611021b237c8f6e7e6589022569f2888de4b8e4b225bdfa020cde42231",
+    "linux-aarch64": "af8420be1c1b72f7a9b143846f587fb66eb6e0e5a5bfa7529c6ffef5d499695e",
+    "macos-x86_64": "2f4febce4497ed090aa17e5444e9fba523110396bb09a83595be40b524924c07",
+    "macos-aarch64": "8f3dd2fabb4508779b5add6adc7f521423cf94fb33d07ccd7c9c820fedb6ea14",
+    "windows-x86_64.exe": "b95983ee9a03c3b226c708c1d4a170fe48a779a712562b0978c6207cb312fe7d",
+    "windows-aarch64.exe": "10d849842530a362bce1622e17a16874695f584c7c65f462492e28bd9db867aa"
   }
 }

package/installer.js

@@ -435,7 +435,8 @@ 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 web = Boolean(options.web);
+  const skipSetup = web || Boolean(options.skipSetup);
   const verbose = verboseEnabled(options);
   const home = options.home || os.homedir();
   const fsImpl = options.fs || fs;
@@ -578,19 +579,34 @@ async function runInstaller(options = {}) {
     verboseLog('setup stage: completed successfully', sharedOptions);
   }
 
+  if (web) {
+    for (const operation of ['install-protocol', 'start']) {
+      const args = ['channel', 'web', operation];
+      log(operation === 'install-protocol'
+        ? 'registering the vlink:// protocol'
+        : 'starting the Web channel service', output);
+      verboseLog(`web stage: executing ${vlinkPath} ${args.join(' ')}`, sharedOptions);
+      const result = spawnSyncImpl(vlinkPath, args, { env, stdio: 'inherit' });
+      const failure = commandFailure(result, `vlink ${args.join(' ')}`);
+      if (failure) throw new VlinkSetupError(failure);
+    }
+    log('Web channel is ready', output);
+  }
+
   log(`installation complete: ${vlinkPath}`, output);
   log('open a new terminal to use the updated PATH', output);
-  return { installDir, vlinkPath, commandShimPath, setupSkipped: skipSetup };
+  return { installDir, vlinkPath, commandShimPath, setupSkipped: skipSetup, webStarted: web };
 }
 
 function printInstallHelp(output = process.stdout) {
   output.write(
     [
-      'Usage: npx --registry=https://registry.npmmirror.com -y @tedbrain/vlink@latest install [--no-setup] [--verbose]',
+      'Usage: npx --registry=https://registry.npmmirror.com -y @tedbrain/vlink@latest install [--no-setup] [--web] [--verbose]',
       '',
       'Installs or updates vlink and adds it to the user PATH.',
       '',
       '  --no-setup  Install without starting the TedBrain setup wizard.',
+      '  --web       Register vlink:// and start the Web channel instead of TedBrain setup.',
       '  --verbose   Print diagnostics for every installation stage.'
     ].join('\n') + '\n'
   );
@@ -603,10 +619,13 @@ async function runInstallerFromArgs(args, options = {}) {
   }
 
   let skipSetup = false;
+  let web = false;
   let verbose = verboseEnabled(options);
   for (const arg of args) {
     if (arg === '--no-setup') {
       skipSetup = true;
+    } else if (arg === '--web') {
+      web = true;
     } else if (arg === '--verbose') {
       verbose = true;
     } else {
@@ -614,7 +633,7 @@ async function runInstallerFromArgs(args, options = {}) {
       throw new VlinkSetupError(`unknown install option: ${displayArg}`);
     }
   }
-  return runInstaller({ ...options, skipSetup, verbose });
+  return runInstaller({ ...options, skipSetup, web, verbose });
 }
 
 module.exports = {

package/package.json

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