pi-web-ui 0.8.8 → 0.9.0

package/deploy/com.xingshuyin.pi-web-ui.plist

@@ -1,48 +1,48 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<!--
-  pi-web-ui launchd agent — macOS auto-start at login.
-
-  Install:
-    npm i -g pi-web-ui
-    cp deploy/com.xingshuyin.pi-web-ui.plist ~/Library/LaunchAgents/
-    # edit ProgramArguments / WorkingDirectory / PI_WEB_CWD for your setup
-    launchctl load ~/Library/LaunchAgents/com.xingshuyin.pi-web-ui.plist
-    # (or: launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.xingshuyin.pi-web-ui.plist)
-
-  Find the pi-web-ui binary path with: which pi-web-ui
--->
-<plist version="1.0">
-<dict>
-  <key>Label</key>
-  <string>com.xingshuyin.pi-web-ui</string>
-
-  <key>ProgramArguments</key>
-  <array>
-    <string>/usr/local/bin/pi-web-ui</string>
-  </array>
-
-  <key>RunAtLoad</key>
-  <true/>
-
-  <!-- Restart if it crashes -->
-  <key>KeepAlive</key>
-  <true/>
-
-  <key>WorkingDirectory</key>
-  <string>/Users/YOUR_USER</string>
-
-  <key>EnvironmentVariables</key>
-  <dict>
-    <key>PORT</key>
-    <string>8787</string>
-    <key>PI_WEB_CWD</key>
-    <string>/Users/YOUR_USER</string>
-  </dict>
-
-  <key>StandardOutPath</key>
-  <string>/tmp/pi-web-ui.log</string>
-  <key>StandardErrorPath</key>
-  <string>/tmp/pi-web-ui.err</string>
-</dict>
-</plist>
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<!--
+  pi-web-ui launchd agent — macOS auto-start at login.
+
+  Install:
+    npm i -g pi-web-ui
+    cp deploy/com.xingshuyin.pi-web-ui.plist ~/Library/LaunchAgents/
+    # edit ProgramArguments / WorkingDirectory / PI_WEB_CWD for your setup
+    launchctl load ~/Library/LaunchAgents/com.xingshuyin.pi-web-ui.plist
+    # (or: launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.xingshuyin.pi-web-ui.plist)
+
+  Find the pi-web-ui binary path with: which pi-web-ui
+-->
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.xingshuyin.pi-web-ui</string>
+
+  <key>ProgramArguments</key>
+  <array>
+    <string>/usr/local/bin/pi-web-ui</string>
+  </array>
+
+  <key>RunAtLoad</key>
+  <true/>
+
+  <!-- Restart if it crashes -->
+  <key>KeepAlive</key>
+  <true/>
+
+  <key>WorkingDirectory</key>
+  <string>/Users/YOUR_USER</string>
+
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PORT</key>
+    <string>8787</string>
+    <key>PI_WEB_CWD</key>
+    <string>/Users/YOUR_USER</string>
+  </dict>
+
+  <key>StandardOutPath</key>
+  <string>/tmp/pi-web-ui.log</string>
+  <key>StandardErrorPath</key>
+  <string>/tmp/pi-web-ui.err</string>
+</dict>
+</plist>

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

@@ -1,71 +1,71 @@
-<?xml version="1.0" encoding="UTF-16"?>
-<!--
-  pi-web-ui Task Scheduler task — Windows auto-start at logon.
-
-  The easy way (no admin needed, generates everything for you):
-    npm i -g pi-web-ui
-    pi-web-ui server install --port 8787 --cwd C:\path\to\project
-    pi-web-ui server status | restart | stop | uninstall
-
-  Manual install with this template (edit the paths below first):
-    schtasks /Create /TN "pi-web-ui" /XML pi-web-ui-task.xml /F
-    schtasks /Run /TN "pi-web-ui"
-
-  Notes:
-    - 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).
-    - LogonTrigger = starts when you log in, same as a launchd user agent.
-      For boot-start without login, use Docker instead (see README).
--->
-<Task version="1.2" xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">
-  <RegistrationInfo>
-    <Description>pi-web-ui — web chat for the pi coding agent (auto-start at logon)</Description>
-  </RegistrationInfo>
-  <Triggers>
-    <LogonTrigger>
-      <Enabled>true</Enabled>
-    </LogonTrigger>
-  </Triggers>
-  <Principals>
-    <Principal id="Author">
-      <LogonType>InteractiveToken</LogonType>
-      <RunLevel>LeastPrivilege</RunLevel>
-    </Principal>
-  </Principals>
-  <Settings>
-    <MultipleInstancesPolicy>IgnoreNew</MultipleInstancesPolicy>
-    <DisallowStartIfOnBatteries>false</DisallowStartIfOnBatteries>
-    <StopIfGoingOnBatteries>false</StopIfGoingOnBatteries>
-    <AllowHardTerminate>true</AllowHardTerminate>
-    <StartWhenAvailable>false</StartWhenAvailable>
-    <RunOnlyIfNetworkAvailable>false</RunOnlyIfNetworkAvailable>
-    <IdleSettings>
-      <StopOnIdleEnd>false</StopOnIdleEnd>
-      <RestartOnIdle>false</RestartOnIdle>
-    </IdleSettings>
-    <AllowStartOnDemand>true</AllowStartOnDemand>
-    <Enabled>true</Enabled>
-    <Hidden>false</Hidden>
-    <RunOnlyIfIdle>false</RunOnlyIfIdle>
-    <WakeToRun>false</WakeToRun>
-    <ExecutionTimeLimit>PT0S</ExecutionTimeLimit>
-    <Priority>7</Priority>
-    <RestartOnFailure>
-      <Interval>PT1M</Interval>
-      <Count>3</Count>
-    </RestartOnFailure>
-  </Settings>
-  <Actions Context="Author">
-    <Exec>
-      <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>
-</Task>
+<?xml version="1.0" encoding="UTF-16"?>
+<!--
+  pi-web-ui Task Scheduler task — Windows auto-start at logon.
+
+  The easy way (no admin needed, generates everything for you):
+    npm i -g pi-web-ui
+    pi-web-ui server install --port 8787 --cwd C:\path\to\project
+    pi-web-ui server status | restart | stop | uninstall
+
+  Manual install with this template (edit the paths below first):
+    schtasks /Create /TN "pi-web-ui" /XML pi-web-ui-task.xml /F
+    schtasks /Run /TN "pi-web-ui"
+
+  Notes:
+    - 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).
+    - LogonTrigger = starts when you log in, same as a launchd user agent.
+      For boot-start without login, use Docker instead (see README).
+-->
+<Task version="1.2" xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">
+  <RegistrationInfo>
+    <Description>pi-web-ui — web chat for the pi coding agent (auto-start at logon)</Description>
+  </RegistrationInfo>
+  <Triggers>
+    <LogonTrigger>
+      <Enabled>true</Enabled>
+    </LogonTrigger>
+  </Triggers>
+  <Principals>
+    <Principal id="Author">
+      <LogonType>InteractiveToken</LogonType>
+      <RunLevel>LeastPrivilege</RunLevel>
+    </Principal>
+  </Principals>
+  <Settings>
+    <MultipleInstancesPolicy>IgnoreNew</MultipleInstancesPolicy>
+    <DisallowStartIfOnBatteries>false</DisallowStartIfOnBatteries>
+    <StopIfGoingOnBatteries>false</StopIfGoingOnBatteries>
+    <AllowHardTerminate>true</AllowHardTerminate>
+    <StartWhenAvailable>false</StartWhenAvailable>
+    <RunOnlyIfNetworkAvailable>false</RunOnlyIfNetworkAvailable>
+    <IdleSettings>
+      <StopOnIdleEnd>false</StopOnIdleEnd>
+      <RestartOnIdle>false</RestartOnIdle>
+    </IdleSettings>
+    <AllowStartOnDemand>true</AllowStartOnDemand>
+    <Enabled>true</Enabled>
+    <Hidden>false</Hidden>
+    <RunOnlyIfIdle>false</RunOnlyIfIdle>
+    <WakeToRun>false</WakeToRun>
+    <ExecutionTimeLimit>PT0S</ExecutionTimeLimit>
+    <Priority>7</Priority>
+    <RestartOnFailure>
+      <Interval>PT1M</Interval>
+      <Count>3</Count>
+    </RestartOnFailure>
+  </Settings>
+  <Actions Context="Author">
+    <Exec>
+      <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>
+</Task>

package/deploy/pi-web-ui.service

@@ -1,31 +1,31 @@
-# pi-web-ui systemd unit — Linux auto-start on boot.
-#
-# Install (adjust User/WorkingDirectory/Environment to taste):
-#   sudo npm i -g pi-web-ui
-#   sudo cp deploy/pi-web-ui.service /etc/systemd/system/
-#   sudo systemctl daemon-reload
-#   sudo systemctl enable --now pi-web-ui
-#   sudo systemctl status pi-web-ui
-#
-# Logs: journalctl -u pi-web-ui -f
-
-[Unit]
-Description=pi-web-ui — web chat for the pi coding agent
-After=network.target
-
-[Service]
-Type=simple
-# Run as an unprivileged user (change to your user, e.g. yourname)
-User=YOUR_USER
-# The workspace the agent operates in (read/edit/bash/write)
-WorkingDirectory=/home/YOUR_USER
-Environment=PORT=8787
-# Point at your pi config dir if it's not the default ~/.pi/agent
-#Environment=PI_CODING_AGENT_DIR=/home/YOUR_USER/.pi/agent
-ExecStart=/usr/bin/pi-web-ui
-Restart=on-failure
-RestartSec=5
-# npm global bin may live elsewhere (nvm, etc.) — find with: which pi-web-ui
-
-[Install]
-WantedBy=multi-user.target
+# pi-web-ui systemd unit — Linux auto-start on boot.
+#
+# Install (adjust User/WorkingDirectory/Environment to taste):
+#   sudo npm i -g pi-web-ui
+#   sudo cp deploy/pi-web-ui.service /etc/systemd/system/
+#   sudo systemctl daemon-reload
+#   sudo systemctl enable --now pi-web-ui
+#   sudo systemctl status pi-web-ui
+#
+# Logs: journalctl -u pi-web-ui -f
+
+[Unit]
+Description=pi-web-ui — web chat for the pi coding agent
+After=network.target
+
+[Service]
+Type=simple
+# Run as an unprivileged user (change to your user, e.g. yourname)
+User=YOUR_USER
+# The workspace the agent operates in (read/edit/bash/write)
+WorkingDirectory=/home/YOUR_USER
+Environment=PORT=8787
+# Point at your pi config dir if it's not the default ~/.pi/agent
+#Environment=PI_CODING_AGENT_DIR=/home/YOUR_USER/.pi/agent
+ExecStart=/usr/bin/pi-web-ui
+Restart=on-failure
+RestartSec=5
+# npm global bin may live elsewhere (nvm, etc.) — find with: which pi-web-ui
+
+[Install]
+WantedBy=multi-user.target

package/dist/server/agent-service.js

@@ -424,6 +424,8 @@ export class WebUIContext {
 function sanitizeId(id) {
     return id.replace(/[^a-zA-Z0-9_-]/g, "_").slice(0, 80) || "anon";
 }
+const IS_WIN32 = process.platform === "win32";
+// mac/linux: hide build & dependency noise (original behavior).
 const IGNORED_ENTRIES = new Set([
     "node_modules",
     ".git",
@@ -441,6 +443,22 @@ const IGNORED_ENTRIES = new Set([
     ".DS_Store",
     "Thumbs.db",
 ]);
+// Windows: the file tree is the primary way to navigate a project, so only
+// hide what would flood or destabilize the panel (dependency trees, VCS
+// internals, session data) plus pure junk. Build output (dist/.next/…) and
+// local env dirs (venv/__pycache__/…) stay visible — "所有文件可查看".
+const IGNORED_ENTRIES_WIN = new Set([
+    "node_modules",
+    ".git",
+    ".pi-web",
+    ".DS_Store",
+    "Thumbs.db",
+    "desktop.ini",
+]);
+/** The ignore set for the current platform — keeps win/posix lists separate. */
+function ignoredEntries() {
+    return IS_WIN32 ? IGNORED_ENTRIES_WIN : IGNORED_ENTRIES;
+}
 function countLines(buf) {
     if (buf.length === 0)
         return 0;
@@ -474,10 +492,81 @@ function extractPartialText(partial) {
  */
 export function workspacePath(root, raw) {
     const abs = resolve(root, raw);
-    const rel = relative(root, abs);
-    if (rel.startsWith("..") || rel.includes(`${sep}..`))
+    const rawRel = relative(root, abs);
+    if (rawRel.startsWith("..") || rawRel.includes(`${sep}..`))
         return null;
-    return { abs, rel };
+    // Normalize to forward slashes: the wire protocol and the frontend always
+    // use "/", but relative() returns "\\" on Windows.
+    return { abs, rel: rawRel.split(sep).join("/") };
+}
+/**
+ * Read a directory for the file panel. The two platforms intentionally use
+ * different strategies — do NOT unify them:
+ *
+ * darwin/linux (posix): original behavior — hide build/dependency noise,
+ * small cap, hard error notice when the directory itself is unreadable.
+ *
+ * win32: stability and completeness first, preview second. ACL-protected
+ * system dirs (C:\$Recycle.Bin, Program Files internals, OneDrive placeholders)
+ * throw EPERM/EACCES on open — that must not kill the panel, so it degrades
+ * to an empty listing plus a warning. Directory symlinks/junctions are
+ * followed so mklink /D folders stay navigable; broken links still show as
+ * files instead of vanishing. The cap is 4x posix and truncation is reported
+ * via `truncated` instead of happening silently.
+ */
+async function readDirForUI(abs, rel) {
+    const fs = await import("node:fs/promises");
+    const ignored = ignoredEntries();
+    const MAX = IS_WIN32 ? 2000 : 500;
+    let dirents;
+    try {
+        dirents = await fs.readdir(abs, { withFileTypes: true });
+    }
+    catch (err) {
+        if (!IS_WIN32)
+            throw err;
+        // Windows ACL-protected/system dirs throw EPERM/EACCES on open —
+        // degrade to an empty listing; listFiles turns this into a warning.
+        return { entries: [], truncated: false, error: err.message };
+    }
+    const out = [];
+    for (const d of dirents) {
+        if (ignored.has(d.name))
+            continue;
+        let type;
+        if (IS_WIN32 && d.isSymbolicLink()) {
+            // mklink /D symlinks and junctions are reparse points — libuv
+            // classifies them as links, so isDirectory() is false. Follow the
+            // target so folder links stay navigable; broken links still show.
+            try {
+                const st = await fs.stat(join(abs, d.name));
+                type = st.isDirectory() ? "dir" : "file";
+            }
+            catch {
+                type = "file";
+            }
+        }
+        else {
+            type = d.isDirectory() ? "dir" : "file";
+        }
+        const entry = {
+            name: d.name,
+            path: rel === "" ? d.name : `${rel}/${d.name}`,
+            type,
+        };
+        if (type === "file")
+            entry.kind = previewKind(d.name);
+        out.push(entry);
+    }
+    out.sort((a, b) => a.type === b.type
+        ? a.name.localeCompare(b.name)
+        : a.type === "dir"
+            ? -1
+            : 1);
+    const truncated = out.length > MAX;
+    if (truncated)
+        out.length = MAX;
+    return { entries: out, truncated };
 }
 /**
  * Persists which workspace each browser client last used + which workspaces it
@@ -1529,8 +1618,8 @@ export class ClientSession {
         const MAX_LINES_READ_BYTES = 2 * 1024 * 1024;
         for (const att of attachments) {
             const abs = resolve(root, att.path);
-            const rel = relative(root, abs);
-            if (rel.startsWith("..") || rel.includes(`${sep}..`)) {
+            const rawRel = relative(root, abs);
+            if (rawRel.startsWith("..") || rawRel.includes(`${sep}..`)) {
                 this.emit({
                     type: "notice",
                     level: "warning",
@@ -1538,6 +1627,9 @@ export class ClientSession {
                 });
                 continue;
             }
+            // Normalize to forward slashes (relative() returns "\\" on Windows);
+            // <file path> and details.path must use the wire format.
+            const rel = rawRel.split(sep).join("/");
             let stat;
             try {
                 stat = await fs.stat(abs);
@@ -1550,7 +1642,7 @@ export class ClientSession {
                 });
                 continue;
             }
-            const name = att.path.split("/").pop() ?? att.path;
+            const name = att.path.split(/[\\/]/).pop() ?? att.path;
             // Folders can't be inlined — always a path reference the model browses
             // on demand with its own tools (ls/read).
             if (stat.isDirectory()) {
@@ -2038,12 +2130,11 @@ export class ClientSession {
     /** List a workspace directory (relative to the configured cwd). */
     async listFiles(relPath) {
         try {
-            const fs = await import("node:fs/promises");
             const { resolve, sep, relative } = await import("node:path");
             const root = resolve(this.cwd);
             const target = relPath ? resolve(root, relPath) : root;
-            const rel = relative(root, target);
-            if (rel.startsWith("..") || rel.includes(`${sep}..`)) {
+            const rawRel = relative(root, target);
+            if (rawRel.startsWith("..") || rawRel.includes(`${sep}..`)) {
                 this.emit({
                     type: "notice",
                     level: "warning",
@@ -2051,25 +2142,19 @@ export class ClientSession {
                 });
                 return;
             }
-            const dirents = await fs.readdir(target, { withFileTypes: true });
-            const entries = dirents
-                .filter((d) => !IGNORED_ENTRIES.has(d.name))
-                .map((d) => {
-                const entry = {
-                    name: d.name,
-                    path: rel === "" ? d.name : `${rel}/${d.name}`,
-                    type: (d.isDirectory() ? "dir" : "file"),
-                };
-                if (!d.isDirectory())
-                    entry.kind = previewKind(d.name);
-                return entry;
-            })
-                .sort((a, b) => a.type === b.type
-                ? a.name.localeCompare(b.name)
-                : a.type === "dir"
-                    ? -1
-                    : 1)
-                .slice(0, 500);
+            // Normalize to forward slashes: the wire protocol and the frontend
+            // always use "/", but relative() returns "\\" on Windows.
+            const rel = rawRel.split(sep).join("/");
+            const { entries, truncated, error } = await readDirForUI(target, rel);
+            if (error) {
+                // Windows-only: unreadable system dirs degrade to an empty list
+                // with a warning instead of a hard error — the panel stays usable.
+                this.emit({
+                    type: "notice",
+                    level: "warning",
+                    text: `目录不可读：${error}`,
+                });
+            }
             this.emit({
                 type: "files",
                 path: rel === "" ? "" : rel,
@@ -2079,6 +2164,7 @@ export class ClientSession {
                         ? rel.slice(0, rel.lastIndexOf("/"))
                         : "",
                 entries,
+                truncated,
             });
         }
         catch (err) {
@@ -2113,7 +2199,7 @@ export class ClientSession {
                 });
                 return;
             }
-            const name = relPath.split("/").pop() ?? relPath;
+            const name = relPath.split(/[\\/]/).pop() ?? relPath;
             const kind = previewKind(name);
             // Media previews stream over the /api/file HTTP endpoint, so only
             // metadata is sent here — the raw bytes never touch the socket.
@@ -2232,10 +2318,14 @@ export class ClientSession {
                 return;
             }
             const completions = dirents
-                .filter((d) => d.name.startsWith(prefix) && !IGNORED_ENTRIES.has(d.name))
+                .filter((d) => d.name.startsWith(prefix) && !ignoredEntries().has(d.name))
                 .map((d) => ({
                 name: d.name,
-                path: dirPart + d.name,
+                // Windows users type backslashes — normalize the completion to the
+                // wire format ("/") so the picked path round-trips cleanly.
+                path: IS_WIN32
+                    ? join(dirPart, d.name).split(sep).join("/")
+                    : dirPart + d.name,
                 type: (d.isDirectory() ? "dir" : "file"),
             }))
                 .sort((a, b) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-web-ui",
-  "version": "0.8.8",
+  "version": "0.9.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",
   "type": "module",
@@ -35,7 +35,7 @@
   "scripts": {
     "prepublishOnly": "npm run build",
     "dev": "concurrently -k -n server,web -c blue,green \"npm:dev:server\" \"npm:dev:web\"",
-    "dev:server": "tsx watch server/index.ts",
+    "dev:server": "node --watch --import tsx server/index.ts",
     "dev:web": "vite --config web/vite.config.ts",
     "build": "npm run build:web && npm run build:server",
     "build:web": "vite build --config web/vite.config.ts",