pi-web-ui 0.21.1 → 0.21.2

package/bin/pi-web-ui.mjs

@@ -172,12 +172,24 @@ function parseFlags(argv) {
 
 /** Open a URL in the OS default browser; failures are ignored (best-effort). */
 function openBrowser(url) {
+	let res;
 	if (isMac) {
-		spawnSync("open", [url], { stdio: "ignore" });
+		res = spawnSync("open", [url], { stdio: "ignore" });
 	} else if (isWin) {
-		spawnSync("cmd", ["/c", "start", "", url], { stdio: "ignore" });
+		res = spawnSync("cmd", ["/c", "start", "", url], { stdio: "ignore" });
 	} else {
-		spawnSync("xdg-open", [url], { stdio: "ignore" });
+		res = spawnSync("xdg-open", [url], { stdio: "ignore" });
+	}
+	// spawnSync 不抛异常：命令缺失（headless 服务器）时在返回对象里带 error 字段。
+	if (res?.error) {
+		if (res.error.code === "ENOENT") {
+			console.warn(
+				`[browser] 未找到打开器 (${res.error.path || "command not found"})，` +
+					"headless 服务器可用 --no-browser 关闭自动打开"
+			);
+		} else {
+			console.warn("[browser] 打开浏览器失败:", res.error.message);
+		}
 	}
 }
 

package/extensions/webui.ts

@@ -76,17 +76,25 @@ function parseArgs(args: string): { port?: number; cwd?: string; noBrowser: bool
 /** 打开浏览器 */
 async function openBrowser(url: string): Promise<void> {
 	const { platform } = process;
-	const cmd =
+	const [cmd, ...rest] =
 		platform === "darwin"
 			? ["open", url]
 			: platform === "win32"
 				? ["cmd", "/c", "start", "", url]
 				: ["xdg-open", url];
-	try {
-		spawn(cmd[0], cmd.slice(1), { stdio: "ignore", detached: true }).unref();
-	} catch {
-		/* 忽略打开失败（headless 等场景） */
-	}
+	// 无界面环境缺少 xdg-open 等打开器时，ENOENT 以异步 'error' 事件触发，
+	// try/catch 拦不住会崩掉整个进程 —— 必须挂 error 监听。
+	spawn(cmd, rest, { stdio: "ignore", detached: true })
+		.on("error", (err) => {
+			if ((err as NodeJS.ErrnoException)?.code === "ENOENT") {
+				console.warn(
+					`[webui] 未找到浏览器打开器 (${(err as NodeJS.ErrnoException).path || "command not found"})，请用 --no-browser 关闭自动打开`
+				);
+			} else {
+				console.warn("[webui] 打开浏览器失败:", err.message);
+			}
+		})
+		.unref();
 }
 
 export default function (pi: ExtensionAPI): void {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-web-ui",
-  "version": "0.21.1",
+  "version": "0.21.2",
   "description": "Web chat interface for the pi coding agent, powered by the pi SDK (@earendil-works/pi-coding-agent) — one-command run, Docker/systemd/launchd deployable",
   "license": "MIT",
   "type": "module",