@dadigua/web-terminal 0.1.3 → 0.1.4

package/README.md

@@ -48,11 +48,15 @@ CLI 默认使用 `~/.web-terminal/config.yaml`，相对路径以配置文件所
 
 CLI 只停止自己登记且启动标识匹配的进程，不接管 `pnpm start` 或 systemd 启动的外部服务。外部服务可以连接，重启时会提示使用原管理器。
 
+## 发布
+
+推送与 `package.json` 版本一致的 `v*` 标签后，`.github/workflows/publish.yaml` 自动检查、构建、打包，并通过 npm Trusted Publishing 发布，再创建 GitHub Release 和上传附件。npm 仅信任 `laopo001/web-terminal` 仓库中的此工作流，不需要发布 token。手动运行工作流只验证和生成产物。
+
 ## 使用
 
 1. 首次打开时选择已有会话，或点击“新建 Shell”进入普通命令行；不会自动接入第一条历史会话。通过“＋”选择工作目录；VS Code 中可快捷选择工作区目录。
 2. 在终端里运行 `codex`，照常操作 CLI。 底部输入框点击“发送”或按 Enter 会写入文字并提交一次；中文输入法选词时不会提交。
-3. 粘贴截图、拖入图片，或点击工具栏的附件按钮。图片保存到服务器的 `.data/uploads/<会话ID>/`，附件区显示预览、上传状态与移除按钮；点击“发送”时，将文字与附件路径一起送入当前终端。支持多图和全部清除。
+3. 粘贴截图、拖入图片，或点击工具栏的附件按钮。图片默认保存到服务器的 `~/.web-terminal/uploads/<12位短文件名>.png`（扩展名随图片格式变化，可通过 `uploadDir` 配置目录），附件区显示预览、上传状态与移除按钮；点击“发送”时，将文字与附件路径一起送入当前终端。支持多图和全部清除。
 4. 悬停图片路径查看缩略图；在浏览器中点击文件路径，弹出图片或文本预览对话框，可复制路径、下载文件，按 Esc 或点击遮罩关闭。Markdown、代码和 YAML 等文本按原文显示，最多 1 MiB。VS Code 内点击路径会交给编辑器打开文件。
 5. VS Code、Electron 和浏览器连接同一服务器并选择同一会话，就会共用一个终端；两端输入会进入同一个 Shell，当前操作的窗口控制尺寸，其他窗口按相同行列数显示。关闭浏览器不会结束会话。默认直接运行 Shell，重启 Web 服务会结束普通 Shell；点击会话的结束按钮才会终止 Shell 并删除该会话上传的图片。
 
@@ -90,11 +94,21 @@ ssh -N -L 3840:127.0.0.1:3840 user@server
 
 ### VS Code
 
+安装全局 CLI 后，用一条命令安装 npm 包自带的插件：
+
+```bash
+web-terminal install-vscode
+```
+
+自动安装到检测到的 VS Code Stable 和 Insiders；WSL 下同时安装 WSL 扩展宿主和 Windows 宿主。已打开的窗口需运行 `Developer: Reload Window` 加载插件。可用 `web-terminal install-vscode --vsix /path/web-terminal.vsix` 安装指定文件。
+
+本地开发打包并安装：
+
 ```bash
-pnpm package:vscode
+pnpm install:vscode
 ```
 
-在 VS Code 的扩展菜单选择“从 VSIX 安装”，打开 `release/web-terminal.vsix`。点击活动栏终端图标或运行 `Web Terminal: Show Sidebar` 打开侧边窗口；`Web Terminal: Open` 在编辑器标签页打开。两处均加载现有 Web 页面。默认地址为 `http://localhost:3840`；通过 `Web Terminal: Set Server URL` 或设置 `webTerminal.serverUrl` 修改，`Web Terminal: Reload` 重载；侧栏及编辑器标题栏的重启按钮重启后台并等待就绪。Remote WSL/SSH 在扩展宿主所在机器检测和启动，再使用 VS Code 的端口转发能力。Windows 本机默认先查本机全局 CLI，再查默认 WSL；可通过 `webTerminal.runtime` 和 `webTerminal.cliPath` 调整。
+也可运行 `pnpm package:vscode`，在 VS Code 的扩展菜单选择“从 VSIX 安装”，打开 `release/web-terminal.vsix`。点击活动栏终端图标或运行 `Web Terminal: Show Sidebar` 打开侧边窗口；`Web Terminal: Open` 在编辑器标签页打开。两处均加载现有 Web 页面。默认地址为 `http://localhost:3840`；通过 `Web Terminal: Set Server URL` 或设置 `webTerminal.serverUrl` 修改，`Web Terminal: Reload` 重载；侧栏及编辑器标题栏的重启按钮重启后台并等待就绪。Remote WSL/SSH 在扩展宿主所在机器检测和启动，再使用 VS Code 的端口转发能力。Windows 本机默认先查本机全局 CLI，再查默认 WSL；可通过 `webTerminal.runtime` 和 `webTerminal.cliPath` 调整。
 
 选中编辑器中的文本后，右键选择“发送选中文本到 Web Terminal”，以附件形式加入当前会话，带有文件路径、语言与行号。点击发送后送入终端。
 
@@ -105,7 +119,7 @@ pnpm electron
 pnpm package:electron:win
 ```
 
-开发命令打开桌面客户端；Windows 命令生成 `release/Web-Terminal-0.1.3-win-x64.zip`，解压后运行 `Web Terminal.exe`。菜单“连接 → 打开连接配置”打开 `client.yaml`，只需修改 `serverUrl`，再选择“重新加载服务器”；“重启后台服务”通过全局 CLI 重启。`client.yaml` 的 `runtime` 可选 auto、native、wsl，`cliPath` 可指定本机 CLI 路径。也可用 `WEB_TERMINAL_URL` 临时覆盖地址。Linux 目录包通过 `pnpm package:electron:linux` 生成。
+开发命令打开桌面客户端；Windows 命令生成 `release/Web-Terminal-0.1.4-win-x64.zip`，解压后运行 `Web Terminal.exe`。菜单“连接 → 打开连接配置”打开 `client.yaml`，只需修改 `serverUrl`，再选择“重新加载服务器”；“重启后台服务”通过全局 CLI 重启。`client.yaml` 的 `runtime` 可选 auto、native、wsl，`cliPath` 可指定本机 CLI 路径。也可用 `WEB_TERMINAL_URL` 临时覆盖地址。Linux 目录包通过 `pnpm package:electron:linux` 生成。
 
 浏览器、VS Code、Electron 各自首次在同一 Web 登录页输入 token，验证后保存在各自 Webview 的持久 localStorage 中。客户端配置不保存 token。Electron 远程页面开启 sandbox/contextIsolation、关闭 Node 集成；VS Code 通过专用 `/?embed=vscode` 入口加载，普通入口仍禁止 iframe 嵌入。
 

package/config.example.yaml

@@ -5,3 +5,5 @@ port: 3840
 # defaultCwd: /home/yourname/projects
 # shell: /bin/zsh
 dataDir: .data
+# 图片默认保存在 ~/.web-terminal/uploads，可指定其他目录。
+# uploadDir: /home/yourname/.web-terminal/uploads

package/dist-server/{app-TCUYGJ4K.js → app-3OE4ER7S.js}

@@ -2,7 +2,7 @@ import {
   serviceName,
   serviceProtocol,
   serviceVersion
-} from "./chunk-R33XRLBM.js";
+} from "./chunk-TD3NJESY.js";
 
 // src/server/app.ts
 import express from "express";
@@ -44,9 +44,10 @@ function authenticate(token) {
 
 // src/server/files.ts
 import { constants } from "node:fs";
-import { mkdir, readdir, open, realpath, rename, unlink } from "node:fs/promises";
+import { mkdir, readdir, open, realpath, unlink, writeFile, appendFile, readFile, rm } from "node:fs/promises";
 import { resolve, basename, dirname, join } from "node:path";
-import { randomUUID } from "node:crypto";
+import { randomBytes } from "node:crypto";
+import { parse, stringify } from "yaml";
 import sharp from "sharp";
 var HttpError = class extends Error {
   constructor(status, message) {
@@ -129,15 +130,43 @@ var Files = class {
       if (!meta.width || !meta.height) throw new HttpError(415, "\u56FE\u7247\u65E0\u6CD5\u89E3\u7801");
       const folder = join(this.config.dataDir, "uploads", sessionId);
       await mkdir(folder, { recursive: true, mode: 448 });
+      await mkdir(this.config.uploadDir, { recursive: true, mode: 448 });
       const ext = { "image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif" }[mime];
-      const path = join(folder, `${randomUUID()}${ext}`);
-      await rename(temporary, path);
+      let path;
+      for (; ; ) {
+        path = join(this.config.uploadDir, `${randomBytes(6).toString("hex")}${ext}`);
+        try {
+          await writeFile(path, bytes, { flag: "wx", mode: 384 });
+          break;
+        } catch (error) {
+          if (error.code !== "EEXIST") throw error;
+        }
+      }
+      try {
+        await appendFile(join(folder, "files.yaml"), stringify([path]), { mode: 384 });
+      } catch (error) {
+        await unlink(path);
+        throw error;
+      }
       return { path, name: basename(originalName).replace(/[\x00-\x1f\x7f]/g, "").slice(0, 160) || basename(path), size: bytes.length, mime, isImage: true, width: meta.width, height: meta.height };
     } finally {
       await unlink(temporary).catch(() => {
       });
     }
   }
+  async removeUploads(sessionId) {
+    const folder = join(this.config.dataDir, "uploads", sessionId);
+    let paths;
+    try {
+      paths = parse(await readFile(join(folder, "files.yaml"), "utf8"));
+    } catch (error) {
+      if (error.code !== "ENOENT") throw error;
+    }
+    if (Array.isArray(paths)) {
+      await Promise.all(paths.filter((path) => typeof path === "string" && /^[a-f0-9]{12}\.(?:png|jpg|webp|gif)$/.test(basename(path))).map((path) => rm(path, { force: true })));
+    }
+    await rm(folder, { recursive: true, force: true });
+  }
 };
 function imageMime(bytes) {
   if (bytes.subarray(0, 8).equals(Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]))) return "image/png";
@@ -148,10 +177,9 @@ function imageMime(bytes) {
 
 // src/server/sessions.ts
 import { readFileSync, writeFileSync, renameSync, existsSync } from "node:fs";
-import { rm } from "node:fs/promises";
 import { join as join2 } from "node:path";
-import { randomUUID as randomUUID2 } from "node:crypto";
-import { parse, stringify } from "yaml";
+import { randomUUID } from "node:crypto";
+import { parse as parse2, stringify as stringify2 } from "yaml";
 import * as pty from "node-pty";
 
 // src/shared/terminalInput.ts
@@ -161,12 +189,12 @@ function pasteText(text, bracketedPaste) {
 }
 
 // src/server/processInfo.ts
-import { readFile, readlink } from "node:fs/promises";
+import { readFile as readFile2, readlink } from "node:fs/promises";
 import { basename as basename2 } from "node:path";
 async function foregroundInfo(pid, fallback) {
   let foreground = pid;
   try {
-    const stat = await readFile(`/proc/${pid}/stat`, "utf8");
+    const stat = await readFile2(`/proc/${pid}/stat`, "utf8");
     const group = Number(stat.slice(stat.lastIndexOf(")") + 2).split(" ")[5]);
     if (Number.isInteger(group) && group > 0) foreground = group;
   } catch {
@@ -182,7 +210,7 @@ async function foregroundInfo(pid, fallback) {
     if (/\/claude\/versions\//.test(executable)) processName = "claude";
     else if (basename2(executable) === "codex") processName = "codex";
     else if (/^(node|nodejs|bun)$/.test(basename2(executable))) {
-      const argv = (await readFile(`/proc/${foreground}/cmdline`, "utf8")).split("\0", 2);
+      const argv = (await readFile2(`/proc/${foreground}/cmdline`, "utf8")).split("\0", 2);
       if (/[/\\](?:@anthropic-ai[/\\]claude-code|claude-code)[/\\]/.test(argv[1] || "")) processName = "claude";
       else if (/[/\\]@openai[/\\]codex[/\\]/.test(argv[1] || "")) processName = "codex";
     }
@@ -344,7 +372,7 @@ var Sessions = class {
     this.files = files;
     const saved = join2(config.dataDir, "sessions.yaml");
     if (existsSync(saved)) {
-      const records = parse(readFileSync(saved, "utf8"));
+      const records = parse2(readFileSync(saved, "utf8"));
       if (!Array.isArray(records)) throw new Error("sessions.yaml \u683C\u5F0F\u65E0\u6548");
       for (const record of records) {
         if (!/^[a-f0-9-]{36}$/.test(record.id)) continue;
@@ -369,7 +397,7 @@ var Sessions = class {
   }
   save() {
     const file = join2(this.config.dataDir, "sessions.yaml");
-    writeFileSync(`${file}.tmp`, stringify([...this.entries.values()].map((s) => s.info)), { mode: 384 });
+    writeFileSync(`${file}.tmp`, stringify2([...this.entries.values()].map((s) => s.info)), { mode: 384 });
     renameSync(`${file}.tmp`, file);
   }
   get(id) {
@@ -397,7 +425,7 @@ var Sessions = class {
     if (name !== void 0 && (typeof name !== "string" || name.length > 80)) throw new HttpError(400, "\u4F1A\u8BDD\u540D\u79F0\u6700\u591A 80 \u5B57\u7B26");
     if (cwd !== void 0 && typeof cwd !== "string") throw new HttpError(400, "\u5DE5\u4F5C\u76EE\u5F55\u65E0\u6548");
     const dir = await this.files.directory(cwd || this.config.defaultCwd);
-    const id = randomUUID2();
+    const id = randomUUID();
     const info = { id, name: name?.trim() || `\u7EC8\u7AEF ${this.entries.size + 1}`, cwd: dir, createdAt: (/* @__PURE__ */ new Date()).toISOString(), running: true };
     const session = this.makeSession(info);
     try {
@@ -526,7 +554,7 @@ var Sessions = class {
     this.entries.delete(id);
     this.save();
     await session.screen.dispose();
-    await rm(join2(this.config.dataDir, "uploads", id), { recursive: true, force: true });
+    await this.files.removeUploads(id);
   }
   async shutdown() {
     this.shuttingDown = true;
@@ -570,12 +598,12 @@ function embeddingHeaders(path, embed, dev) {
 }
 
 // src/server/app.ts
-import { randomUUID as randomUUID3 } from "node:crypto";
+import { randomUUID as randomUUID2 } from "node:crypto";
 import { fileURLToPath } from "node:url";
 async function createApp(config, options = {}) {
   mkdirSync(config.dataDir, { recursive: true, mode: 448 });
   const app = express();
-  const instanceId = randomUUID3();
+  const instanceId = randomUUID2();
   app.disable("x-powered-by");
   const server = createServer(app);
   const files = new Files(config);

package/dist-server/{chunk-R33XRLBM.js → chunk-TD3NJESY.js}

@@ -1,7 +1,7 @@
 // package.json
 var package_default = {
   name: "@dadigua/web-terminal",
-  version: "0.1.3",
+  version: "0.1.4",
   type: "module",
   scripts: {
     dev: "tsx src/server/index.ts --dev",
@@ -11,10 +11,11 @@ var package_default = {
     check: "tsc --noEmit",
     "build:clients": "tsx scripts/build-clients.ts",
     "package:vscode": "pnpm build:clients && tsx scripts/package-vscode.ts",
+    "install:vscode": "pnpm package:vscode && tsx src/cli.ts install-vscode",
     electron: "pnpm build:clients && electron dist-clients/electron",
     "package:electron:win": "pnpm build:clients && tsx scripts/package-electron.ts --win",
     "package:electron:linux": "pnpm build:clients && tsx scripts/package-electron.ts --linux",
-    prepack: "pnpm build"
+    prepack: "pnpm build && pnpm package:vscode"
   },
   dependencies: {
     "@xterm/addon-fit": "^0.11.0",
@@ -50,7 +51,7 @@ var package_default = {
   engines: {
     node: ">=22"
   },
-  packageManager: "pnpm@11.12.0",
+  packageManager: "pnpm@11.28.2",
   bin: {
     "web-terminal": "bin/web-terminal.mjs"
   },
@@ -58,6 +59,7 @@ var package_default = {
     "bin/",
     "dist-server/",
     "dist/",
+    "release/web-terminal.vsix",
     "config.example.yaml",
     "README.md",
     "API.md"

package/dist-server/cli.js

@@ -2,7 +2,7 @@ import {
   serviceName,
   serviceProtocol,
   serviceVersion
-} from "./chunk-R33XRLBM.js";
+} from "./chunk-TD3NJESY.js";
 
 // src/cli.ts
 import { fileURLToPath } from "node:url";
@@ -34,11 +34,13 @@ function loadConfig(defaults = {}) {
   if (!token || token.length > 1024) throw new Error("token \u4E0D\u80FD\u4E3A\u7A7A\uFF0C\u4E14\u6700\u591A 1024 \u4E2A\u5B57\u7B26");
   const port = Number(process.env.PORT || input.port || 3840);
   if (!Number.isInteger(port) || port < 1 || port > 65535) throw new Error("port \u65E0\u6548");
+  const uploadHome = resolve(process.env.WEB_TERMINAL_HOME || resolve(homedir(), ".web-terminal"));
   return {
     host: String(process.env.HOST || input.host || "127.0.0.1"),
     port,
     dataDir,
     token,
+    uploadDir: resolve(input.uploadDir || defaults.uploadDir || resolve(uploadHome, "uploads")),
     defaultCwd: realpathSync(resolve(input.defaultCwd || homedir())),
     shell: String(input.shell || process.env.SHELL || (process.platform === "win32" ? "powershell.exe" : "/bin/bash")),
     machineId: `${hostname()}-${createHash("sha256").update(dataDir).digest("hex").slice(0, 8)}`,
@@ -292,7 +294,8 @@ async function main() {
     home: { type: "string" },
     config: { type: "string" },
     version: { type: "boolean" },
-    help: { type: "boolean" }
+    help: { type: "boolean" },
+    vsix: { type: "string" }
   } });
   if (values.version) {
     console.log(JSON.stringify({ service: serviceName, version: serviceVersion }));
@@ -300,9 +303,16 @@ async function main() {
   }
   const action = positionals[0] || "start";
   if (values.help) {
-    console.log("web-terminal [start|restart|stop|status] [--url http://localhost:3840] [--config /path/config.yaml] [--home /path/state]\n\u914D\u7F6E\u3001token\u3001\u8FDB\u7A0B\u72B6\u6001\u548C\u65E5\u5FD7\u9ED8\u8BA4\u4F4D\u4E8E ~/.web-terminal/\u3002\u91CD\u542F\u4F1A\u7ED3\u675F\u666E\u901A Shell \u4F1A\u8BDD\u3002");
+    console.log("web-terminal [start|restart|stop|status] [--url http://localhost:3840] [--config /path/config.yaml] [--home /path/state]\nweb-terminal install-vscode [--vsix /path/web-terminal.vsix]\n\u5B89\u88C5\u81EA\u5E26\u63D2\u4EF6\u5230\u5DF2\u68C0\u6D4B\u5230\u7684 VS Code Stable/Insiders\uFF1BWSL \u4E0B\u540C\u65F6\u5B89\u88C5 Windows \u5BBF\u4E3B\u3002\n\u914D\u7F6E\u3001token\u3001\u8FDB\u7A0B\u72B6\u6001\u548C\u65E5\u5FD7\u9ED8\u8BA4\u4F4D\u4E8E ~/.web-terminal/\u3002\u91CD\u542F\u4F1A\u7ED3\u675F\u666E\u901A Shell \u4F1A\u8BDD\u3002");
     return;
   }
+  if (action === "install-vscode") {
+    const { installVSCodeExtension } = await import("./vscodeInstaller-WIM5VHDI.js");
+    await installVSCodeExtension({ vsixPath: values.vsix, onInstalled: (result) => console.log(`${result.target} \u5DF2\u5B89\u88C5 ${result.extension}`) });
+    console.log("\u8BF7\u5728\u5DF2\u6253\u5F00\u7684 VS Code \u7A97\u53E3\u8FD0\u884C Developer: Reload Window \u4EE5\u52A0\u8F7D\u63D2\u4EF6\u3002");
+    return;
+  }
+  if (values.vsix) throw new Error("--vsix \u4EC5\u7528\u4E8E install-vscode");
   const url = normalizeServerUrl(values.url);
   if (action === "status") {
     console.log(JSON.stringify(await probeService(url)));
@@ -319,11 +329,11 @@ async function main() {
   const configFile = resolve3(values.config || process.env.WEB_TERMINAL_CONFIG || paths.config);
   process.env.WEB_TERMINAL_CONFIG = configFile;
   process.chdir(dirname(configFile));
-  const config = loadConfig({ dataDir: join2(paths.directory, "data") });
+  const config = loadConfig({ dataDir: join2(paths.directory, "data"), uploadDir: join2(paths.base, "uploads") });
   config.host = new URL(url).hostname === "localhost" ? "127.0.0.1" : new URL(url).hostname.replace(/^\[|\]$/g, "");
   config.port = Number(new URL(url).port || 80);
   const instanceId = randomUUID2();
-  const { createApp } = await import("./app-TCUYGJ4K.js");
+  const { createApp } = await import("./app-3OE4ER7S.js");
   const runtime = await createApp(config, { managed: true, instanceId, staticDir: fileURLToPath(new URL("../dist/", import.meta.url)) });
   const stamp = await processStamp(process.pid);
   if (!stamp) throw new Error("\u65E0\u6CD5\u53D6\u5F97\u8FDB\u7A0B\u542F\u52A8\u6807\u8BC6\uFF0C\u62D2\u7EDD\u542F\u52A8\u4E0D\u53EF\u5B89\u5168\u7BA1\u7406\u7684\u540E\u53F0");

package/dist-server/vscodeInstaller-WIM5VHDI.js

@@ -0,0 +1,210 @@
+import {
+  serviceVersion
+} from "./chunk-TD3NJESY.js";
+
+// src/vscodeInstaller.ts
+import { execFile } from "node:child_process";
+import { access, readFile, readdir, stat } from "node:fs/promises";
+import { constants } from "node:fs";
+import { homedir } from "node:os";
+import { delimiter, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { promisify } from "node:util";
+var execute = promisify(execFile);
+var extensionId = "dadigua.web-terminal";
+var psQuote = (value) => `'${value.replaceAll("'", "''")}'`;
+async function exists(path) {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function findServerLauncher(root) {
+  const cliRoot = join(root, "cli/servers");
+  let recent = [];
+  try {
+    const value = JSON.parse(await readFile(join(cliRoot, "lru.json"), "utf8"));
+    if (Array.isArray(value)) recent = value.filter((item) => typeof item === "string" && !item.includes("/") && !item.includes("\\"));
+  } catch {
+  }
+  const candidates = [
+    ...(await readdir(cliRoot).catch(() => [])).map((name) => ({ name, path: join(cliRoot, name, "server") })),
+    ...(await readdir(join(root, "bin")).catch(() => [])).map((name) => ({ name, path: join(root, "bin", name) }))
+  ];
+  const available = [];
+  for (const candidate of candidates) {
+    const entry = join(candidate.path, "out/server-main.js");
+    if (!await exists(entry)) continue;
+    available.push({ ...candidate, entry, mtime: (await stat(candidate.path)).mtimeMs });
+  }
+  available.sort((a, b) => {
+    const rank = (name) => recent.includes(name) ? recent.indexOf(name) : Infinity;
+    return rank(a.name) - rank(b.name) || b.mtime - a.mtime;
+  });
+  const server = available[0];
+  if (!server) return void 0;
+  const node = join(server.path, "node");
+  return { file: await exists(node) ? node : process.execPath, args: [server.entry, "--extensions-dir", join(root, "extensions")] };
+}
+async function findCommand(command) {
+  for (const directory of (process.env.PATH || "").split(delimiter)) {
+    const candidate = resolve(directory, command);
+    try {
+      await access(candidate, constants.X_OK);
+      return candidate;
+    } catch {
+    }
+  }
+  return void 0;
+}
+async function isWsl() {
+  if (process.platform !== "linux") return false;
+  if (process.env.WSL_DISTRO_NAME) return true;
+  return (await readFile("/proc/version", "utf8").catch(() => "")).toLowerCase().includes("microsoft");
+}
+async function localLaunchers(options, wsl) {
+  const launchers = [];
+  for (const [channel, command, override, folder] of [
+    ["Stable", "code", options.codeCommand, ".vscode-server"],
+    ["Insiders", "code-insiders", options.codeInsidersCommand, ".vscode-server-insiders"]
+  ]) {
+    if (override) {
+      launchers.push({ label: `\u672C\u673A ${channel}`, file: override, args: [] });
+      continue;
+    }
+    if (process.platform === "linux") {
+      const defaultRoot = join(homedir(), folder);
+      const agentRoot = process.env.VSCODE_AGENT_FOLDER;
+      const root = agentRoot && agentRoot.includes("insiders") === (channel === "Insiders") ? agentRoot : defaultRoot;
+      const server = await findServerLauncher(root);
+      if (server) {
+        launchers.push({ label: `${wsl ? "WSL" : "Remote"} ${channel}`, ...server });
+        continue;
+      }
+    }
+    const file = await findCommand(command);
+    if (file && !(wsl && (file.startsWith("/mnt/") || file.includes("/remote-cli/")))) {
+      launchers.push({ label: `\u672C\u673A ${channel}`, file, args: [] });
+    }
+  }
+  return launchers;
+}
+async function invoke(launcher, args) {
+  const { stdout } = await execute(launcher.file, [...launcher.args, ...args], {
+    timeout: 6e4,
+    windowsHide: true,
+    maxBuffer: 4 * 1024 * 1024
+  });
+  if (stdout.includes("Command is only available in WSL or inside a Visual Studio Code terminal")) {
+    throw new Error(stdout.trim());
+  }
+  return stdout;
+}
+function verifyExtension(output, version) {
+  const extension = output.split(/\r?\n/).map((line) => line.trim()).find((line) => line.toLowerCase().startsWith(`${extensionId}@`));
+  if (!extension || version && extension !== `${extensionId}@${version}`) {
+    throw new Error(`\u5B89\u88C5\u540E\u672A\u627E\u5230 ${extensionId}${version ? `@${version}` : ""}\uFF0C\u6269\u5C55\u5217\u8868\uFF1A
+${output.trim()}`);
+  }
+  return extension;
+}
+async function installWindows(vsix, wsl, version) {
+  const source = wsl ? (await execute("wslpath", ["-w", vsix])).stdout.trim() : vsix;
+  const script = `
+$ErrorActionPreference = 'Stop'
+$temporary = $null
+try {
+  Set-Location $env:SystemDrive\\
+  $vsix = ${psQuote(source)}
+  if (${wsl ? "$true" : "$false"}) {
+    $temporary = Join-Path $env:TEMP ('web-terminal-' + [guid]::NewGuid() + '.vsix')
+    Copy-Item -LiteralPath $vsix -Destination $temporary
+    $vsix = $temporary
+  }
+  $results = @()
+  $failures = @()
+  foreach ($channel in @(
+    @{ Name = 'Stable'; Command = 'code.cmd'; Folder = 'Microsoft VS Code' },
+    @{ Name = 'Insiders'; Command = 'code-insiders.cmd'; Folder = 'Microsoft VS Code Insiders' }
+  )) {
+    $command = (Get-Command $channel.Command -ErrorAction SilentlyContinue | Select-Object -First 1).Source
+    if (-not $command) {
+      foreach ($base in @((Join-Path $env:LOCALAPPDATA 'Programs'), $env:ProgramFiles, [Environment]::GetEnvironmentVariable('ProgramFiles(x86)'))) {
+        if (-not $base) { continue }
+        $candidate = Join-Path $base ($channel.Folder + '\\bin\\' + $channel.Command)
+        if (Test-Path -LiteralPath $candidate) { $command = $candidate; break }
+      }
+    }
+    if (-not $command) { continue }
+    try {
+      & $command --install-extension $vsix --force | Out-Host
+      if ($LASTEXITCODE -ne 0) { throw ('\u5B89\u88C5\u547D\u4EE4\u9000\u51FA\u7801\uFF1A' + $LASTEXITCODE) }
+      $extensions = & $command --list-extensions --show-versions
+      if ($LASTEXITCODE -ne 0) { throw ('\u6269\u5C55\u5217\u8868\u547D\u4EE4\u9000\u51FA\u7801\uFF1A' + $LASTEXITCODE) }
+      $match = $extensions | Where-Object { $_ -like '${extensionId}@*' } | Select-Object -First 1
+      if (-not $match${version ? ` -or $match -ne ${psQuote(`${extensionId}@${version}`)}` : ""}) { throw '\u5B89\u88C5\u540E\u672A\u627E\u5230\u6307\u5B9A\u7248\u672C\u7684 Web Terminal \u6269\u5C55' }
+      $results += @{ target = ('Windows ' + $channel.Name); extension = $match }
+    } catch { $failures += ('Windows ' + $channel.Name + ': ' + $_.Exception.Message) }
+  }
+  Write-Output ('WEB_TERMINAL_INSTALL::' + (ConvertTo-Json -Compress -Depth 4 -InputObject @{ installed = @($results); failures = @($failures) }))
+} catch { Write-Error $_ -ErrorAction Continue; exit 1 }
+finally { if ($temporary) { Remove-Item -LiteralPath $temporary -Force -ErrorAction SilentlyContinue } }
+`;
+  const powershell = wsl ? "/mnt/c/Windows/System32/WindowsPowerShell/v1.0/powershell.exe" : "powershell.exe";
+  const { stdout } = await execute(powershell, ["-NoProfile", "-NonInteractive", "-EncodedCommand", Buffer.from(script, "utf16le").toString("base64")], {
+    timeout: 18e4,
+    windowsHide: true,
+    maxBuffer: 4 * 1024 * 1024
+  });
+  const marker = stdout.split(/\r?\n/).find((line) => line.startsWith("WEB_TERMINAL_INSTALL::"));
+  if (!marker) throw new Error(`Windows \u5B89\u88C5\u6CA1\u6709\u8FD4\u56DE\u9A8C\u8BC1\u7ED3\u679C\uFF1A
+${stdout.trim()}`);
+  const result = JSON.parse(marker.slice("WEB_TERMINAL_INSTALL::".length));
+  for (const installed of result.installed) verifyExtension(installed.extension, version);
+  if (result.failures.length) throw new Error([...result.installed.map((item) => `${item.target} \u5DF2\u5B89\u88C5 ${item.extension}`), ...result.failures].join("\n"));
+  return result.installed;
+}
+async function installVSCodeExtension(options = {}) {
+  const path = options.vsixPath ? resolve(options.vsixPath) : fileURLToPath(new URL("../release/web-terminal.vsix", import.meta.url));
+  if (!await exists(path)) throw new Error(`\u672A\u627E\u5230 VSIX\uFF1A${path}\u3002\u672C\u5730\u5F00\u53D1\u8BF7\u8FD0\u884C pnpm package:vscode\uFF0C\u6216\u7528 --vsix \u6307\u5B9A\u6587\u4EF6\u3002`);
+  const version = options.vsixPath ? void 0 : serviceVersion;
+  const wsl = await isWsl();
+  const installed = [];
+  const failures = [];
+  const record = (result) => {
+    installed.push(result);
+    options.onInstalled?.(result);
+  };
+  if (process.platform !== "win32") {
+    for (const launcher of await localLaunchers(options, wsl)) {
+      try {
+        await invoke(launcher, ["--install-extension", path, "--force"]);
+        const extension = verifyExtension(await invoke(launcher, ["--list-extensions", "--show-versions"]), version);
+        record({ target: launcher.label, extension });
+      } catch (error) {
+        failures.push(`${launcher.label}\uFF1A${errorDetail(error)}`);
+      }
+    }
+  }
+  if (process.platform === "win32" || (options.installWindowsHost ?? wsl)) {
+    try {
+      for (const result of await installWindows(path, wsl, version)) record(result);
+    } catch (error) {
+      failures.push(errorDetail(error));
+    }
+  }
+  if (failures.length) throw new Error(`\u63D2\u4EF6\u5B89\u88C5\u672A\u5168\u90E8\u5B8C\u6210\uFF1A
+${failures.join("\n")}`);
+  if (!installed.length) throw new Error("\u672A\u627E\u5230\u53EF\u7528\u7684 VS Code\u3002\u8BF7\u5B89\u88C5 VS Code \u5E76\u5C06 code \u52A0\u5165 PATH\uFF1BWSL \u6269\u5C55\u5BBF\u4E3B\u9700\u5148\u7528 Remote WSL \u8FDE\u63A5\u4E00\u6B21\u3002");
+  return installed;
+}
+function errorDetail(error) {
+  const failure = error;
+  return [error instanceof Error ? error.message : String(error), failure.stderr?.trim(), failure.stdout?.trim()].filter(Boolean).join("\n");
+}
+export {
+  findServerLauncher,
+  installVSCodeExtension
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dadigua/web-terminal",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "type": "module",
   "scripts": {
     "dev": "tsx src/server/index.ts --dev",
@@ -10,10 +10,11 @@
     "check": "tsc --noEmit",
     "build:clients": "tsx scripts/build-clients.ts",
     "package:vscode": "pnpm build:clients && tsx scripts/package-vscode.ts",
+    "install:vscode": "pnpm package:vscode && tsx src/cli.ts install-vscode",
     "electron": "pnpm build:clients && electron dist-clients/electron",
     "package:electron:win": "pnpm build:clients && tsx scripts/package-electron.ts --win",
     "package:electron:linux": "pnpm build:clients && tsx scripts/package-electron.ts --linux",
-    "prepack": "pnpm build"
+    "prepack": "pnpm build && pnpm package:vscode"
   },
   "dependencies": {
     "@xterm/addon-fit": "^0.11.0",
@@ -49,7 +50,7 @@
   "engines": {
     "node": ">=22"
   },
-  "packageManager": "pnpm@11.12.0",
+  "packageManager": "pnpm@11.28.2",
   "bin": {
     "web-terminal": "bin/web-terminal.mjs"
   },
@@ -57,6 +58,7 @@
     "bin/",
     "dist-server/",
     "dist/",
+    "release/web-terminal.vsix",
     "config.example.yaml",
     "README.md",
     "API.md"