pi-web-ui 0.63.4 → 0.64.0

package/dist/server/files-service.js

@@ -710,6 +710,48 @@ export class FilesService {
             emitErr(`上传文件失败：${err.message}`);
         }
     }
+    /**
+     * Create a folder. Accepts absolute, ~-prefixed or session-relative paths
+     * (same expansion rules as completePath — the cwd picker may browse outside
+     * the session root, and set_cwd itself accepts any directory). Answers
+     * with a notice; the picker refreshes its listing on its own.
+     */
+    async makeDir(input) {
+        try {
+            const fs = await import("node:fs/promises");
+            const { resolve, sep, isAbsolute } = await import("node:path");
+            const { homedir } = await import("node:os");
+            const home = homedir();
+            let expanded = input.trim();
+            if (!expanded)
+                throw new Error("路径为空");
+            if (expanded === "~" || expanded === "~\\") {
+                expanded = home;
+            }
+            else if (expanded.startsWith("~/") || expanded.startsWith("~\\")) {
+                expanded = home + sep + expanded.slice(2);
+            }
+            else if (!isAbsolute(expanded)) {
+                expanded = resolve(this.host.getCwd(), expanded);
+            }
+            const abs = resolve(expanded);
+            await fs.mkdir(abs, { recursive: true });
+            this.host.emit({
+                type: "notice",
+                level: "info",
+                text: `已创建文件夹：${abs}`,
+                textEn: `Folder created: ${abs}`,
+            });
+        }
+        catch (err) {
+            this.host.emit({
+                type: "notice",
+                level: "error",
+                text: `创建文件夹失败：${err.message}`,
+                textEn: `Failed to create folder: ${err.message}`,
+            });
+        }
+    }
     /**
      * Path completion for the cwd input: expand ~/relative paths, list the parent
      * directory, and return prefix matches (dirs first, capped).

package/dist/server/index.js

@@ -664,6 +664,9 @@ wss.on("connection", (ws) => {
             case "complete_path":
                 void cs.completePath(msg.path);
                 break;
+            case "make_dir":
+                void cs.makeDir(msg.path);
+                break;
             case "check_update":
                 void cs.checkUpdate();
                 break;

package/dist/server/marker-service.js

@@ -33,7 +33,8 @@ export class MarkerService {
             return false;
         if ((name === "rename" || name === "title") && this.settings.disabledMarkers.includes("conv"))
             return false;
-        if (name === "conv" && (this.settings.disabledMarkers.includes("rename") || this.settings.disabledMarkers.includes("title")))
+        if (name === "conv" &&
+            (this.settings.disabledMarkers.includes("rename") || this.settings.disabledMarkers.includes("title")))
             return false;
         return !this.settings.disabledMarkers.includes(name);
     }

package/dist/server/markers/builtins/rename.js

@@ -56,9 +56,7 @@ export const renameMarker = {
 /** 别名：[[rename:set:标题]] 等同 [[conv:rename:标题]]，方便模型直觉书写。 */
 export const renameAliasMarker = {
     name: "rename",
-    guidance: [
-        "- [[rename:set:<新标题>]] 同 [[conv:rename:<新标题>]]：重命名当前对话。",
-    ],
+    guidance: ["- [[rename:set:<新标题>]] 同 [[conv:rename:<新标题>]]：重命名当前对话。"],
     async apply(token, ctx) {
         // 兼容任意 op：只要能取到标题就重命名
         const title = extractTitle(token) || token.op?.trim() || "";

package/dist/server/markers/builtins/services.js

@@ -21,7 +21,9 @@ function findService(state, id) {
     return state.services.find((s) => s.id === id);
 }
 function lineOf(s) {
-    const meta = [s.pid !== undefined ? `pid ${s.pid}` : "", s.port !== undefined ? `:${s.port}` : ""].filter(Boolean).join(" ");
+    const meta = [s.pid !== undefined ? `pid ${s.pid}` : "", s.port !== undefined ? `:${s.port}` : ""]
+        .filter(Boolean)
+        .join(" ");
     return `${s.stopped ? "[x]" : "[ ]"} #${s.id}: ${s.name}${meta ? ` (${meta})` : ""}${s.command ? ` — ${s.command}` : ""}`;
 }
 export function describeServices(state) {
@@ -53,7 +55,9 @@ export const servicesMarker = {
                     stopped: false,
                 };
                 state.services.push(svc);
-                const meta = [svc.pid !== undefined ? `pid ${svc.pid}` : "", svc.port !== undefined ? `:${svc.port}` : ""].filter(Boolean).join(" ");
+                const meta = [svc.pid !== undefined ? `pid ${svc.pid}` : "", svc.port !== undefined ? `:${svc.port}` : ""]
+                    .filter(Boolean)
+                    .join(" ");
                 return { applied: true, feedback: `Registered #${svc.id}: ${name}${meta ? ` (${meta})` : ""}` };
             }
             case "stop": {

package/dist/server/markers/builtins/todo.js

@@ -16,10 +16,14 @@ function parseId(raw) {
 }
 function formatStatus(s) {
     switch (s) {
-        case "pending": return "pending";
-        case "in_progress": return "in_progress";
-        case "completed": return "completed";
-        default: return s;
+        case "pending":
+            return "pending";
+        case "in_progress":
+            return "in_progress";
+        case "completed":
+            return "completed";
+        default:
+            return s;
     }
 }
 export function describeTodos(state, includeDeleted = false) {

package/dist/server/settings-service.js

@@ -212,7 +212,11 @@ export class SettingsService {
                 presets: this.presets.map((p) => ({ ...p })),
                 ...(this.host.getMarkerState
                     ? this.host.getMarkerState()
-                    : { markersEnabled: true, disabledMarkers: [], markers: [] }),
+                    : {
+                        markersEnabled: true,
+                        disabledMarkers: [],
+                        markers: [],
+                    }),
                 subagentTemplates: this.templates.list(),
                 subagentDefaultTemplates: DEFAULT_TEMPLATES.map((t) => t.name),
             },

package/dist/server/terminals.js

@@ -1532,10 +1532,10 @@ export const TERMINAL_TOOL_NAMES = [
 /** System-prompt guidance teaching the model WHEN to prefer the terminal tools
  *  over one-shot bash. Without it models almost never pick them — bash returns
  *  complete output in a single call, so it always wins on convenience. */
-export const TERMINAL_TOOLS_GUIDANCE = `Persistent interactive terminal tools are available (terminal_create / terminal_list / terminal_close / terminal_input / terminal_key / terminal_read / terminal_wait). The bash tool stays the DEFAULT for ordinary commands - it runs in a visible terminal and returns the full output (persist=false, one-shot terminal that exits when the command finishes). Switch to the bash tool's persist=true, or to the terminal tools, when:
-- The program is interactive or TUI-based (REPLs like python/node, vim/htop, installers asking y/n, anything waiting on stdin). For these, prefer bash({ persist: true }) which runs it in the persistent 'ai-bash' terminal and returns immediately; then drive it with terminal_input / terminal_key (and terminal_read) on terminalId='ai-bash'.
-- You start a long-running server or watcher and want to keep watching its output (terminal_read with waitMs), send keys to it later (e.g. interrupt via terminal_key with Ctrl+c), or block until a backgrounded command finishes without polling (terminal_wait).
-- The user explicitly asks you to work in the visible terminal panel.
+export const TERMINAL_TOOLS_GUIDANCE = `Persistent interactive terminal tools are available (terminal_create / terminal_list / terminal_close / terminal_input / terminal_key / terminal_read / terminal_wait). The bash tool stays the DEFAULT for ordinary commands - it runs in a visible terminal and returns the full output (persist=false, one-shot terminal that exits when the command finishes). Switch to the bash tool's persist=true, or to the terminal tools, when:
+- The program is interactive or TUI-based (REPLs like python/node, vim/htop, installers asking y/n, anything waiting on stdin). For these, prefer bash({ persist: true }) which runs it in the persistent 'ai-bash' terminal and returns immediately; then drive it with terminal_input / terminal_key (and terminal_read) on terminalId='ai-bash'.
+- You start a long-running server or watcher and want to keep watching its output (terminal_read with waitMs), send keys to it later (e.g. interrupt via terminal_key with Ctrl+c), or block until a backgrounded command finishes without polling (terminal_wait).
+- The user explicitly asks you to work in the visible terminal panel.
 Use head/tail on bash to trim verbose output instead of piping through head/tail. Liveness watchdog: terminals you touched (create/input/key) are monitored - if one goes silent with no new output while you are working (default 15s), an automatic system reminder is injected into the conversation. Treat it as a prompt to check that terminal (terminal_read), respond to an input prompt (terminal_input / terminal_key), or close it (terminal_close) if it is no longer needed.`;
 /** Build the agent-facing persistent terminal tools for one conversation. */
 export function makePersistentTerminalTools(terminals, cwd) {

package/dist/server/vision-bridge.js

@@ -35,15 +35,15 @@ export function findVisionModels(runtime) {
  * Exported so the settings panel can offer a custom prompt (append to this
  * default or replace it entirely).
  */
-export const SYSTEM_PROMPT = `You are a vision bridge for a text-only language model. You receive one or more images and must transcribe them into precise, structured text evidence so another model that cannot see images can answer questions about them accurately.
-
-Follow these rules:
-1. Transcribe ALL visible text verbatim, preserving wording, spelling, punctuation and line breaks. This is the most important part — the reader relies on your transcription, not on the image.
-2. Describe the layout in reading order: headers, paragraphs, lists, tables, buttons, panels — say what appears where.
-3. For tables/charts/diagrams: read axes, scales (note log scale), legend entries, series names, highlighted points and their coordinates, and any data values you can discern.
-4. Name entities: people, products, companies, colors, style, objects, actions.
-5. If part of the image is too blurry/low-resolution to read, say "（读不清）" or "unclear" for that part — NEVER invent or guess content you cannot see.
-6. If there are multiple images, address them in order (图 1 / Image 1, 图 2 / Image 2, ...).
+export const SYSTEM_PROMPT = `You are a vision bridge for a text-only language model. You receive one or more images and must transcribe them into precise, structured text evidence so another model that cannot see images can answer questions about them accurately.
+
+Follow these rules:
+1. Transcribe ALL visible text verbatim, preserving wording, spelling, punctuation and line breaks. This is the most important part — the reader relies on your transcription, not on the image.
+2. Describe the layout in reading order: headers, paragraphs, lists, tables, buttons, panels — say what appears where.
+3. For tables/charts/diagrams: read axes, scales (note log scale), legend entries, series names, highlighted points and their coordinates, and any data values you can discern.
+4. Name entities: people, products, companies, colors, style, objects, actions.
+5. If part of the image is too blurry/low-resolution to read, say "（读不清）" or "unclear" for that part — NEVER invent or guess content you cannot see.
+6. If there are multiple images, address them in order (图 1 / Image 1, 图 2 / Image 2, ...).
 7. Output only the transcript. No preamble, no commentary about the image itself.`;
 /**
  * Assemble the final vision-model system prompt from the settings-panel prefs.

package/extensions/webui.ts

@@ -1,190 +1,190 @@
-/**
- * pi-web-ui 的 pi 扩展 —— 提供命令行集成。
- *
- * 能力：
- *   /webui                      启动本机 pi-web-ui 服务器，打开浏览器访问
- *   /webui --port 9000          指定端口启动
- *   /webui --no-browser         启动但不开浏览器
- *   /webui stop                 停止已启动的服务器
- *   /webui status               查看运行状态 / URL
- *
- * 实现说明：
- *   - 不依赖全局 bin（pi install 后 pi-web-ui 命令不一定在 PATH），直接用
- *     node 调包内 dist/server/index.js，通过环境变量 PORT / PI_WEB_CWD /
- *     PI_WEB_DATA_DIR 控制。
- *   - 工作目录默认用当前 pi 会话的 ctx.cwd；可用 --cwd / path 覆盖。
- *   - 服务器作为子进程后台运行，/webui 不阻塞 pi。
- *   - 每个 pi 会话管理一个子进程；session_shutdown 时清理，避免孤儿进程。
- */
-
-import { spawn } from "node:child_process";
-import { existsSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import net from "node:net";
-import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
-
-// 本文件位于 <pkg>/extensions/webui.ts → 包根在上一级
-const PKG_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
-const SERVER_ENTRY = join(PKG_ROOT, "dist", "server", "index.js");
-const NODE = process.execPath;
-
-/** 每个会话的服务器子进程 + 元数据 */
-interface RunningServer {
-	proc: ReturnType<typeof spawn>;
-	port: number;
-	cwd: string;
-	url: string;
-}
-
-// 会话 → 运行实例（模块级 Map；每会话一个会话对象，无需清理全局）
-const running = new Map<string, RunningServer>();
-
-/** 找一个空闲端口 */
-function findFreePort(from = 8787): Promise<number> {
-	return new Promise((resolve_, reject) => {
-		const srv = net.createServer();
-		srv.listen(from, () => {
-			const port = (srv.address() as net.AddressInfo).port;
-			srv.close(() => resolve_(port));
-		});
-		srv.on("error", () => {
-			// 端口被占则顺延
-			findFreePort(from + 1).then(resolve_, reject);
-		});
-	});
-}
-
-/** 解析 --key value / --flag 参数 */
-function parseArgs(args: string): { port?: number; cwd?: string; noBrowser: boolean } {
-	const out: { port?: number; cwd?: string; noBrowser: boolean } = { noBrowser: false };
-	const toks = args.split(/\s+/).filter(Boolean);
-	for (let i = 0; i < toks.length; i++) {
-		const t = toks[i];
-		if ((t === "--port" || t === "-p") && toks[i + 1]) {
-			const n = Number(toks[++i]);
-			if (Number.isInteger(n) && n > 0 && n < 65536) out.port = n;
-		} else if (t === "--cwd" && toks[i + 1]) {
-			out.cwd = resolve(toks[++i]);
-		} else if (t === "--no-browser") {
-			out.noBrowser = true;
-		}
-	}
-	return out;
-}
-
-/** 打开浏览器 */
-async function openBrowser(url: string): Promise<void> {
-	const { platform } = process;
-	const [cmd, ...rest] =
-		platform === "darwin" ? ["open", url] : platform === "win32" ? ["cmd", "/c", "start", "", url] : ["xdg-open", url];
-	// 无界面环境缺少 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 {
-	pi.registerCommand("webui", {
-		description: "启动本机 pi-web-ui Web 界面（/webui [--port N] [--cwd PATH] [--no-browser] | stop | status）",
-		handler: async (args: string, ctx: ExtensionCommandContext) => {
-			const sid = ctx.sessionManager.getSessionId();
-			const opts = parseArgs(args);
-			const action = (args.split(/\s+/)[0] || "start").toLowerCase();
-
-			// 停止
-			if (action === "stop" || action === "kill") {
-				const inst = running.get(sid);
-				if (!inst) {
-					ctx.ui.notify("没有正在运行的本机 pi-web-ui 服务器", "info");
-					return;
-				}
-				inst.proc.kill("SIGTERM");
-				running.delete(sid);
-				ctx.ui.notify(`已停止 pi-web-ui (${inst.url})`, "info");
-				return;
-			}
-
-			// 状态
-			if (action === "status") {
-				const inst = running.get(sid);
-				if (!inst) {
-					ctx.ui.notify("本机 pi-web-ui 未运行", "info");
-					return;
-				}
-				const alive = inst.proc.exitCode === null;
-				ctx.ui.notify(
-					alive
-						? `pi-web-ui 运行中 → ${inst.url}\n端口 ${inst.port} · cwd ${inst.cwd}`
-						: `已退出(exit=${inst.proc.exitCode})`,
-					alive ? "info" : "warning",
-				);
-				return;
-			}
-
-			// 默认 start
-			if (action !== "start" && action !== "run") {
-				ctx.ui.notify(`未知动作 ${action}（可用 start|stop|status）`, "warning");
-				return;
-			}
-
-			// 已运行则提示
-			const existing = running.get(sid);
-			if (existing && existing.proc.exitCode === null) {
-				ctx.ui.notify(`pi-web-ui 已在运行 → ${existing.url}`, "info");
-				return;
-			}
-
-			// 检查是否已构建
-			if (!existsSync(SERVER_ENTRY)) {
-				ctx.ui.notify(
-					"缺少 dist/ 产物（当前安装未包含已构建前端）。请运行 `npm run build` 后重试，或用 pi-web-ui 官方 npm 包。",
-					"warning",
-				);
-				return;
-			}
-
-			const port = opts.port ?? (await findFreePort());
-			const cwd = opts.cwd ?? ctx.cwd;
-			const url = `http://localhost:${port}`;
-
-			const env = {
-				...process.env,
-				PORT: String(port),
-				PI_WEB_CWD: cwd,
-				...(process.env.PI_WEB_DATA_DIR ? {} : { PI_WEB_DATA_DIR: join(cwd, ".pi-web") }),
-			};
-			const proc = spawn(NODE, [SERVER_ENTRY], { cwd, env, stdio: "ignore", detached: true });
-			proc.unref();
-			running.set(sid, { proc, port, cwd, url });
-
-			ctx.ui.notify(`pi-web-ui 启动中 → ${url}\n端口 ${port} · cwd ${cwd}\n(几秒后可用，/webui status 查看)`);
-
-			if (!opts.noBrowser) await openBrowser(url);
-
-			// 进程退出时清理
-			proc.on("exit", () => {
-				if (running.get(sid)?.proc === proc) running.delete(sid);
-			});
-		},
-	});
-
-	// 会话结束清理子进程，避免孤儿
-	pi.on("session_shutdown", async (_event, ctx) => {
-		const sid = ctx.sessionManager.getSessionId();
-		const inst = running.get(sid);
-		if (inst && inst.proc.exitCode === null) {
-			inst.proc.kill("SIGTERM");
-			running.delete(sid);
-		}
-	});
-}
+/**
+ * pi-web-ui 的 pi 扩展 —— 提供命令行集成。
+ *
+ * 能力：
+ *   /webui                      启动本机 pi-web-ui 服务器，打开浏览器访问
+ *   /webui --port 9000          指定端口启动
+ *   /webui --no-browser         启动但不开浏览器
+ *   /webui stop                 停止已启动的服务器
+ *   /webui status               查看运行状态 / URL
+ *
+ * 实现说明：
+ *   - 不依赖全局 bin（pi install 后 pi-web-ui 命令不一定在 PATH），直接用
+ *     node 调包内 dist/server/index.js，通过环境变量 PORT / PI_WEB_CWD /
+ *     PI_WEB_DATA_DIR 控制。
+ *   - 工作目录默认用当前 pi 会话的 ctx.cwd；可用 --cwd / path 覆盖。
+ *   - 服务器作为子进程后台运行，/webui 不阻塞 pi。
+ *   - 每个 pi 会话管理一个子进程；session_shutdown 时清理，避免孤儿进程。
+ */
+
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import net from "node:net";
+import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+
+// 本文件位于 <pkg>/extensions/webui.ts → 包根在上一级
+const PKG_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const SERVER_ENTRY = join(PKG_ROOT, "dist", "server", "index.js");
+const NODE = process.execPath;
+
+/** 每个会话的服务器子进程 + 元数据 */
+interface RunningServer {
+	proc: ReturnType<typeof spawn>;
+	port: number;
+	cwd: string;
+	url: string;
+}
+
+// 会话 → 运行实例（模块级 Map；每会话一个会话对象，无需清理全局）
+const running = new Map<string, RunningServer>();
+
+/** 找一个空闲端口 */
+function findFreePort(from = 8787): Promise<number> {
+	return new Promise((resolve_, reject) => {
+		const srv = net.createServer();
+		srv.listen(from, () => {
+			const port = (srv.address() as net.AddressInfo).port;
+			srv.close(() => resolve_(port));
+		});
+		srv.on("error", () => {
+			// 端口被占则顺延
+			findFreePort(from + 1).then(resolve_, reject);
+		});
+	});
+}
+
+/** 解析 --key value / --flag 参数 */
+function parseArgs(args: string): { port?: number; cwd?: string; noBrowser: boolean } {
+	const out: { port?: number; cwd?: string; noBrowser: boolean } = { noBrowser: false };
+	const toks = args.split(/\s+/).filter(Boolean);
+	for (let i = 0; i < toks.length; i++) {
+		const t = toks[i];
+		if ((t === "--port" || t === "-p") && toks[i + 1]) {
+			const n = Number(toks[++i]);
+			if (Number.isInteger(n) && n > 0 && n < 65536) out.port = n;
+		} else if (t === "--cwd" && toks[i + 1]) {
+			out.cwd = resolve(toks[++i]);
+		} else if (t === "--no-browser") {
+			out.noBrowser = true;
+		}
+	}
+	return out;
+}
+
+/** 打开浏览器 */
+async function openBrowser(url: string): Promise<void> {
+	const { platform } = process;
+	const [cmd, ...rest] =
+		platform === "darwin" ? ["open", url] : platform === "win32" ? ["cmd", "/c", "start", "", url] : ["xdg-open", url];
+	// 无界面环境缺少 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 {
+	pi.registerCommand("webui", {
+		description: "启动本机 pi-web-ui Web 界面（/webui [--port N] [--cwd PATH] [--no-browser] | stop | status）",
+		handler: async (args: string, ctx: ExtensionCommandContext) => {
+			const sid = ctx.sessionManager.getSessionId();
+			const opts = parseArgs(args);
+			const action = (args.split(/\s+/)[0] || "start").toLowerCase();
+
+			// 停止
+			if (action === "stop" || action === "kill") {
+				const inst = running.get(sid);
+				if (!inst) {
+					ctx.ui.notify("没有正在运行的本机 pi-web-ui 服务器", "info");
+					return;
+				}
+				inst.proc.kill("SIGTERM");
+				running.delete(sid);
+				ctx.ui.notify(`已停止 pi-web-ui (${inst.url})`, "info");
+				return;
+			}
+
+			// 状态
+			if (action === "status") {
+				const inst = running.get(sid);
+				if (!inst) {
+					ctx.ui.notify("本机 pi-web-ui 未运行", "info");
+					return;
+				}
+				const alive = inst.proc.exitCode === null;
+				ctx.ui.notify(
+					alive
+						? `pi-web-ui 运行中 → ${inst.url}\n端口 ${inst.port} · cwd ${inst.cwd}`
+						: `已退出(exit=${inst.proc.exitCode})`,
+					alive ? "info" : "warning",
+				);
+				return;
+			}
+
+			// 默认 start
+			if (action !== "start" && action !== "run") {
+				ctx.ui.notify(`未知动作 ${action}（可用 start|stop|status）`, "warning");
+				return;
+			}
+
+			// 已运行则提示
+			const existing = running.get(sid);
+			if (existing && existing.proc.exitCode === null) {
+				ctx.ui.notify(`pi-web-ui 已在运行 → ${existing.url}`, "info");
+				return;
+			}
+
+			// 检查是否已构建
+			if (!existsSync(SERVER_ENTRY)) {
+				ctx.ui.notify(
+					"缺少 dist/ 产物（当前安装未包含已构建前端）。请运行 `npm run build` 后重试，或用 pi-web-ui 官方 npm 包。",
+					"warning",
+				);
+				return;
+			}
+
+			const port = opts.port ?? (await findFreePort());
+			const cwd = opts.cwd ?? ctx.cwd;
+			const url = `http://localhost:${port}`;
+
+			const env = {
+				...process.env,
+				PORT: String(port),
+				PI_WEB_CWD: cwd,
+				...(process.env.PI_WEB_DATA_DIR ? {} : { PI_WEB_DATA_DIR: join(cwd, ".pi-web") }),
+			};
+			const proc = spawn(NODE, [SERVER_ENTRY], { cwd, env, stdio: "ignore", detached: true });
+			proc.unref();
+			running.set(sid, { proc, port, cwd, url });
+
+			ctx.ui.notify(`pi-web-ui 启动中 → ${url}\n端口 ${port} · cwd ${cwd}\n(几秒后可用，/webui status 查看)`);
+
+			if (!opts.noBrowser) await openBrowser(url);
+
+			// 进程退出时清理
+			proc.on("exit", () => {
+				if (running.get(sid)?.proc === proc) running.delete(sid);
+			});
+		},
+	});
+
+	// 会话结束清理子进程，避免孤儿
+	pi.on("session_shutdown", async (_event, ctx) => {
+		const sid = ctx.sessionManager.getSessionId();
+		const inst = running.get(sid);
+		if (inst && inst.proc.exitCode === null) {
+			inst.proc.kill("SIGTERM");
+			running.delete(sid);
+		}
+	});
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-web-ui",
-  "version": "0.63.4",
+  "version": "0.64.0",
   "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",
   "author": {