pi-web-ui 0.2.13 → 0.2.15

package/README.md

@@ -140,8 +140,10 @@ pi-web-ui server uninstall             # remove the service entirely
   `/etc/systemd/system/pi-web-ui.service` and runs `systemctl enable --now`,
   logs via `journalctl -u pi-web-ui -f`.
 - **Windows** → Task Scheduler (no admin): creates a user task that starts at
-  logon (same as a launchd agent). It runs a `.cmd` wrapper generated at
-  `%APPDATA%\pi-web-ui\pi-web-ui.cmd` (sets env, cd's to the workspace,
+  logon (same as a launchd agent). It runs a PowerShell launcher generated at
+  `%APPDATA%\pi-web-ui\pi-web-ui.ps1` via `powershell.exe -WindowStyle
+  Hidden` — no black console window stays open, so there's nothing to
+  accidentally close/kill. The launcher sets env, cd's to the workspace,
   launches node, appends logs to `%USERPROFILE%\pi-web-ui.log`). The task XML
   is saved next to it; restarts on failure.
 - Options: `--port` (default 8787 or `$PORT`), `--cwd` (default `$PI_WEB_CWD`
@@ -336,12 +338,14 @@ pi-web-ui server stop        :: stop the running instance (auto-start stays)
 pi-web-ui server uninstall   :: remove the task entirely
 ```
 
-What it does: writes `%APPDATA%\pi-web-ui\pi-web-ui.cmd` (a `.cmd` wrapper
+What it does: writes `%APPDATA%\pi-web-ui\pi-web-ui.ps1` (a PowerShell launcher
 that sets `PORT`/`PI_WEB_CWD`, cd's to the workspace, launches node and
 appends output to `%USERPROFILE%\pi-web-ui.log`) plus the Task Scheduler XML,
 then registers a **logon** task (`schtasks /Create /XML` — the task runs when
-you log in, same as a launchd agent; no admin needed). Preview both generated
-files without installing: `pi-web-ui server install --print`.
+you log in, same as a launchd agent; no admin needed). The task invokes
+`powershell.exe -WindowStyle Hidden`, so the server runs with **no black
+console window** — there is nothing to accidentally close or kill. Preview
+both generated files without installing: `pi-web-ui server install --print`.
 
 Manual alternative with `deploy/pi-web-ui-task.xml`: edit the paths, save the
 file as **UTF-16 LE** (schtasks requires it), then

package/bin/pi-web-ui.mjs

@@ -14,7 +14,8 @@
  *              （--name 自定义时 com.<name>.server），无需 sudo
  *   - Linux   → systemd 单元 <name>.service（/etc/systemd/system/，自动 sudo）
  *   - Windows → 计划任务（Task Scheduler / schtasks，登录后自启，无需管理员），
- *              包装脚本与任务 XML 生成在 %APPDATA%\pi-web-ui\
+ *              隐藏窗口启动（无黑窗）；PowerShell 启动脚本与任务 XML 生成在
+ *              %APPDATA%\pi-web-ui\
  *
  * 环境变量（前台与系统服务均适用）：PORT / PI_WEB_CWD / PI_WEB_DATA_DIR /
  * PI_CODING_AGENT_DIR。
@@ -62,7 +63,7 @@ server 选项:
   --print           只打印将生成的配置文件，不实际安装
 
 平台: macOS → launchd 用户代理 · Linux → systemd · Windows → 计划任务（schtasks）
-      （Windows 任务登录后自启、无需管理员；stop 停止，uninstall 移除）
+      （Windows 任务登录后自启、无需管理员、隐藏窗口运行；stop 停止，uninstall 移除）
 
 环境变量（前台与系统服务均适用）:
   PORT / PI_WEB_CWD / PI_WEB_DATA_DIR / PI_CODING_AGENT_DIR
@@ -214,6 +215,10 @@ function winCmdPath(name) {
 	return join(winServiceDir(), `${name}.cmd`);
 }
 
+function winPs1Path(name) {
+	return join(winServiceDir(), `${name}.ps1`);
+}
+
 function winTaskXmlPath(name) {
 	return join(winServiceDir(), `${name}.xml`);
 }
@@ -230,17 +235,30 @@ function winTaskExists(name) {
 	);
 }
 
-/** Build the .cmd wrapper the scheduled task runs (set env → cd → launch node → log). */
-function buildWinCmd(cwd, env, logPath) {
+/** Single-quote a string for embedding in a generated PowerShell script. */
+function psQuote(s) {
+	return "'" + s.replace(/'/g, "''") + "'";
+}
+
+/**
+ * Build the PowerShell launcher the scheduled task runs. Task Scheduler
+ * launches it with -WindowStyle Hidden, so the console window is created
+ * hidden (SW_HIDE) — no black cmd window stays open while the server runs,
+ * and there is nothing to accidentally close/kill. The script sets the env,
+ * cd's to the workspace, then runs node in the foreground with output
+ * appended to the log, so the task instance IS the powershell process and
+ * `schtasks /End` still stops the whole tree.
+ */
+function buildWinStartPs1(env, cwd, logPath) {
 	const sets = Object.entries(env)
-		.map(([k, v]) => `set "${k}=${v}"`)
+		.map(([k, v]) => `$env:${k} = ${psQuote(v)}`)
 		.join("\r\n");
 	return [
-		"@echo off",
-		"rem Generated by: pi-web-ui server install (rerun to change)",
+		"# Generated by: pi-web-ui server install (rerun to change)",
+		"# Starts the server with a hidden console window (no black cmd box).",
 		sets,
-		`cd /d "${cwd}"`,
-		`"${NODE}" "${SERVER_ENTRY}" >> "${logPath}" 2>&1`,
+		`Set-Location ${psQuote(cwd)}`,
+		`& ${psQuote(NODE)} ${psQuote(SERVER_ENTRY)} *>> ${psQuote(logPath)}`,
 		"",
 	].join("\r\n");
 }
@@ -248,13 +266,16 @@ function buildWinCmd(cwd, env, logPath) {
 /**
  * Build the Task Scheduler XML for a user task: LogonTrigger (starts at logon,
  * like a launchd agent — no admin needed), InteractiveToken, auto-restart on
- * failure. The task runs the .cmd wrapper via cmd.exe.
+ * failure. The task runs the PowerShell launcher via
+ * powershell.exe -WindowStyle Hidden, so no console window ever appears.
  */
-function buildWinTaskXml(cmdPath, cwd) {
-	const cmdExe = join(
+function buildWinTaskXml(ps1Path, cwd) {
+	const powershell = join(
 		process.env.SystemRoot ?? "C:\\Windows",
 		"System32",
-		"cmd.exe",
+		"WindowsPowerShell",
+		"v1.0",
+		"powershell.exe",
 	);
 	return `<?xml version="1.0" encoding="UTF-16"?>
 <Task version="1.2" xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">
@@ -297,8 +318,8 @@ function buildWinTaskXml(cmdPath, cwd) {
   </Settings>
   <Actions Context="Author">
     <Exec>
-      <Command>${esc(cmdExe)}</Command>
-      <Arguments>/c ""${esc(cmdPath)}""</Arguments>
+      <Command>${esc(powershell)}</Command>
+      <Arguments>-NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File "${esc(ps1Path)}"</Arguments>
       <WorkingDirectory>${esc(cwd)}</WorkingDirectory>
     </Exec>
   </Actions>
@@ -502,17 +523,20 @@ function uninstallSystemd(opts) {
 function installWindows(opts) {
 	const { name, port, cwd, dataDir } = serviceOptions(opts);
 	const env = serviceEnv(port, cwd, dataDir);
-	const cmdPath = winCmdPath(name);
+	const ps1Path = winPs1Path(name);
 	const xmlPath = winTaskXmlPath(name);
-	const cmd = buildWinCmd(cwd, env, winLogPath());
-	const xml = buildWinTaskXml(cmdPath, cwd);
+	const ps1 = buildWinStartPs1(env, cwd, winLogPath());
+	const xml = buildWinTaskXml(ps1Path, cwd);
 	if (opts.print) {
-		console.log(`# ${cmdPath}\n${cmd}`);
+		console.log(`# ${ps1Path}\n${ps1}`);
 		console.log(`# ${xmlPath}\n${xml}`);
 		return;
 	}
-	mkdirSync(dirname(cmdPath), { recursive: true });
-	writeFileSync(cmdPath, cmd);
+	mkdirSync(dirname(ps1Path), { recursive: true });
+	// UTF-8 with BOM: Windows PowerShell 5.1 misreads BOM-less UTF-8 as ANSI.
+	writeFileSync(ps1Path, "\uFEFF" + ps1, "utf8");
+	// Remove the old-style .cmd wrapper from previous installs.
+	if (existsSync(winCmdPath(name))) rmSync(winCmdPath(name));
 	// schtasks /Create /XML requires a UTF-16 file (with BOM).
 	writeFileSync(xmlPath, "\uFEFF" + xml, "utf16le");
 	if (winTaskExists(name)) {
@@ -523,7 +547,7 @@ function installWindows(opts) {
 	}
 	run("schtasks", ["/Create", "/TN", name, "/XML", xmlPath, "/F"]);
 	run("schtasks", ["/Run", "/TN", name], { ignoreError: true });
-	console.log(`✅ 已安装并启动计划任务 ${name}`);
+	console.log(`✅ 已安装并启动计划任务 ${name}（隐藏窗口运行，无黑窗）`);
 	console.log(`   端口 : ${port}`);
 	console.log(`   目录 : ${cwd}`);
 	console.log(`   访问 : http://localhost:${port}`);
@@ -539,7 +563,7 @@ function uninstallWindows(opts) {
 	if (winTaskExists(name)) {
 		run("schtasks", ["/Delete", "/TN", name, "/F"], { ignoreError: true });
 	}
-	for (const f of [winCmdPath(name), winTaskXmlPath(name)]) {
+	for (const f of [winCmdPath(name), winPs1Path(name), winTaskXmlPath(name)]) {
 		if (existsSync(f)) rmSync(f);
 	}
 	console.log(`🗑  已卸载 ${name}（计划任务已删除，不再自启）`);

package/deploy/pi-web-ui-task.xml

@@ -12,9 +12,11 @@
     schtasks /Run /TN "pi-web-ui"
 
   Notes:
-    - The task points at the .cmd wrapper the CLI generates at
-      %APPDATA%\pi-web-ui\pi-web-ui.cmd (it sets PORT/PI_WEB_CWD, cd's to the
-      workspace, launches node, and appends output to %USERPROFILE%\pi-web-ui.log).
+    - The task runs the PowerShell launcher the CLI generates at
+      %APPDATA%\pi-web-ui\pi-web-ui.ps1 with -WindowStyle Hidden, so the
+      server runs with no black console window (nothing to accidentally
+      close/kill). The ps1 sets PORT/PI_WEB_CWD, cd's to the workspace,
+      launches node, and appends output to %USERPROFILE%\pi-web-ui.log.
       Preview both generated files with: pi-web-ui server install --print
     - Save this file as UTF-16 LE (schtasks requires it; the CLI does this
       automatically when it writes the task XML).
@@ -61,8 +63,8 @@
   </Settings>
   <Actions Context="Author">
     <Exec>
-      <Command>C:\Windows\System32\cmd.exe</Command>
-      <Arguments>/c ""%APPDATA%\pi-web-ui\pi-web-ui.cmd""</Arguments>
+      <Command>C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe</Command>
+      <Arguments>-NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File "%APPDATA%\pi-web-ui\pi-web-ui.ps1"</Arguments>
       <WorkingDirectory>%USERPROFILE%</WorkingDirectory>
     </Exec>
   </Actions>

package/package.json

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