@tedbrain/vlink 0.1.68 → 0.1.70

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.68",
+  "version": "0.1.70",
   "binaries": {
-    "linux-x86_64": "a343f0527b5bf6dc40c0fa9ad9deebc581425febb590b7633f9e75ae8c596340",
-    "linux-x86_64-glibc2.17": "c7827b953f04c06605d7bbc0f406a9b219f7956e894e023a712e0ba4982edf39",
-    "linux-aarch64": "7aa32e07649b1b7c397236c6afebb6917ee0c49b07ff0a9092547e788db38dbb",
-    "macos-x86_64": "5cb8d8af713b37c710fa4e681b72a81dbe601bdf37930cf59420653aa9c4e4c8",
-    "macos-aarch64": "80bdc545abb01f0640c060cdd291dfa7946c977eb2f6fcdbc9d334c43a9adf17",
-    "windows-x86_64.exe": "bf14fd9f61674dc14026a80afb335ff30f839a77f45cbbdccb67a80ae4ea533a",
-    "windows-aarch64.exe": "9c3fe4a6362948a20a04ba13b5b6bcf57613bdf95dd43701f0934ec31dc81378"
+    "linux-x86_64": "f529d9a7f9570be4037468c1f5380fbf829c26303fcbd1b74dca960e1f021812",
+    "linux-x86_64-glibc2.17": "a5a971f8f8a582b47eb278e053c67a9e9064d7d4a81f6ff3451b97a581cb6156",
+    "linux-aarch64": "b63ba5fb4671de00f03d7374098f9afa49df54bc2fddc8d71d697644d8ed2735",
+    "macos-x86_64": "74018d79749e1bf70a3351ae7f570393e98bd277ce30551a5e04200e2a49ec86",
+    "macos-aarch64": "0960f17cb2e2367372a068d3acaf55aec4f5739a8801863dc820fa29130b3d89",
+    "windows-x86_64.exe": "e6727f3748cc9d54274429cbcd121a7c32bba6367fee7a0bd376aeafcc07747c",
+    "windows-aarch64.exe": "71f430f714772917510c010439260fe5805b22a70465c5ac4f695582edebe357"
   }
 }

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.68",
+  "version": "0.1.70",
   "description": "vlink Virtuoso bridge CLI installer. Installs the matching platform binary at npm install time, like Claude Code / Codex.",
   "license": "UNLICENSED",
   "bin": {