@rexvane/piweb 0.3.5 → 0.3.7

package/.next/types/cache-life.d.ts

@@ -0,0 +1,146 @@
+// Type definitions for Next.js cacheLife configs
+
+declare module 'next/cache' {
+  export { unstable_cache } from 'next/dist/server/web/spec-extension/unstable-cache'
+  export {
+    updateTag,
+    revalidateTag,
+    revalidatePath,
+    refresh,
+  } from 'next/dist/server/web/spec-extension/revalidate'
+  export { unstable_noStore } from 'next/dist/server/web/spec-extension/unstable-no-store'
+  export { io } from 'next/dist/server/request/io'
+
+  
+    /**
+     * Cache this `"use cache"` for a timespan defined by the `"default"` profile.
+     * ```
+     *   stale:      300 seconds (5 minutes)
+     *   revalidate: 900 seconds (15 minutes)
+     *   expire:     never
+     * ```
+     * 
+     * This cache may be stale on clients for 5 minutes before checking with the server.
+     * If the server receives a new request after 15 minutes, start revalidating new values in the background.
+     * It lives for the maximum age of the server cache. If this entry has no traffic for a while, it may serve an old value the next request.
+     */
+    export function cacheLife(profile: "default"): void
+    
+    /**
+     * Cache this `"use cache"` for a timespan defined by the `"seconds"` profile.
+     * ```
+     *   stale:      30 seconds
+     *   revalidate: 1 seconds
+     *   expire:     60 seconds (1 minute)
+     * ```
+     * 
+     * This cache may be stale on clients for 30 seconds before checking with the server.
+     * If the server receives a new request after 1 seconds, start revalidating new values in the background.
+     * If this entry has no traffic for 1 minute it will expire. The next request will recompute it.
+     */
+    export function cacheLife(profile: "seconds"): void
+    
+    /**
+     * Cache this `"use cache"` for a timespan defined by the `"minutes"` profile.
+     * ```
+     *   stale:      300 seconds (5 minutes)
+     *   revalidate: 60 seconds (1 minute)
+     *   expire:     3600 seconds (1 hour)
+     * ```
+     * 
+     * This cache may be stale on clients for 5 minutes before checking with the server.
+     * If the server receives a new request after 1 minute, start revalidating new values in the background.
+     * If this entry has no traffic for 1 hour it will expire. The next request will recompute it.
+     */
+    export function cacheLife(profile: "minutes"): void
+    
+    /**
+     * Cache this `"use cache"` for a timespan defined by the `"hours"` profile.
+     * ```
+     *   stale:      300 seconds (5 minutes)
+     *   revalidate: 3600 seconds (1 hour)
+     *   expire:     86400 seconds (1 day)
+     * ```
+     * 
+     * This cache may be stale on clients for 5 minutes before checking with the server.
+     * If the server receives a new request after 1 hour, start revalidating new values in the background.
+     * If this entry has no traffic for 1 day it will expire. The next request will recompute it.
+     */
+    export function cacheLife(profile: "hours"): void
+    
+    /**
+     * Cache this `"use cache"` for a timespan defined by the `"days"` profile.
+     * ```
+     *   stale:      300 seconds (5 minutes)
+     *   revalidate: 86400 seconds (1 day)
+     *   expire:     604800 seconds (1 week)
+     * ```
+     * 
+     * This cache may be stale on clients for 5 minutes before checking with the server.
+     * If the server receives a new request after 1 day, start revalidating new values in the background.
+     * If this entry has no traffic for 1 week it will expire. The next request will recompute it.
+     */
+    export function cacheLife(profile: "days"): void
+    
+    /**
+     * Cache this `"use cache"` for a timespan defined by the `"weeks"` profile.
+     * ```
+     *   stale:      300 seconds (5 minutes)
+     *   revalidate: 604800 seconds (1 week)
+     *   expire:     2592000 seconds (1 month)
+     * ```
+     * 
+     * This cache may be stale on clients for 5 minutes before checking with the server.
+     * If the server receives a new request after 1 week, start revalidating new values in the background.
+     * If this entry has no traffic for 1 month it will expire. The next request will recompute it.
+     */
+    export function cacheLife(profile: "weeks"): void
+    
+    /**
+     * Cache this `"use cache"` for a timespan defined by the `"max"` profile.
+     * ```
+     *   stale:      300 seconds (5 minutes)
+     *   revalidate: 2592000 seconds (1 month)
+     *   expire:     31536000 seconds (365 days)
+     * ```
+     * 
+     * This cache may be stale on clients for 5 minutes before checking with the server.
+     * If the server receives a new request after 1 month, start revalidating new values in the background.
+     * If this entry has no traffic for 365 days it will expire. The next request will recompute it.
+     */
+    export function cacheLife(profile: "max"): void
+    
+    /**
+     * Cache this `"use cache"` using a custom timespan.
+     * ```
+     *   stale: ... // seconds
+     *   revalidate: ... // seconds
+     *   expire: ... // seconds
+     * ```
+     *
+     * This is similar to Cache-Control: max-age=`stale`,s-max-age=`revalidate`,stale-while-revalidate=`expire-revalidate`
+     *
+     * If a value is left out, the lowest of other cacheLife() calls or the default, is used instead.
+     */
+    export function cacheLife(profile: {
+      /**
+       * This cache may be stale on clients for ... seconds before checking with the server.
+       */
+      stale?: number,
+      /**
+       * If the server receives a new request after ... seconds, start revalidating new values in the background.
+       */
+      revalidate?: number,
+      /**
+       * If this entry has no traffic for ... seconds it will expire. The next request will recompute it.
+       */
+      expire?: number
+    }): void
+  
+
+  import { cacheTag } from 'next/dist/server/use-cache/cache-tag'
+  export { cacheTag }
+
+  export const unstable_cacheTag: typeof cacheTag
+  export const unstable_cacheLife: typeof cacheLife
+}

package/.next/types/package.json

@@ -0,0 +1 @@
+{"type": "module"}

package/.next/types/root-params.d.ts

@@ -0,0 +1,3 @@
+// Type definitions for Next.js root params (next/root-params)
+// No root params detected.
+export {}

package/.next/types/routes.d.ts

@@ -0,0 +1,94 @@
+// This file is generated automatically by Next.js
+// Do not edit this file manually
+
+type AppRoutes = "/" | "/login"
+type AppRouteHandlerRoutes = "/api/agent/[id]" | "/api/agent/[id]/events" | "/api/agent/[id]/tree" | "/api/agent/new" | "/api/config" | "/api/files" | "/api/git" | "/api/growth" | "/api/health" | "/api/models" | "/api/pi-settings" | "/api/plugins" | "/api/security" | "/api/sessions" | "/api/sessions/[id]" | "/api/sessions/[id]/export" | "/api/skills" | "/api/update" | "/api/version" | "/api/web-auth" | "/api/workspaces"
+type PageRoutes = never
+type LayoutRoutes = "/"
+type RedirectRoutes = never
+type RewriteRoutes = never
+type Routes = AppRoutes | PageRoutes | LayoutRoutes | RedirectRoutes | RewriteRoutes | AppRouteHandlerRoutes
+
+
+interface ParamMap {
+  "/": {}
+  "/api/agent/[id]": { "id": string; }
+  "/api/agent/[id]/events": { "id": string; }
+  "/api/agent/[id]/tree": { "id": string; }
+  "/api/agent/new": {}
+  "/api/config": {}
+  "/api/files": {}
+  "/api/git": {}
+  "/api/growth": {}
+  "/api/health": {}
+  "/api/models": {}
+  "/api/pi-settings": {}
+  "/api/plugins": {}
+  "/api/security": {}
+  "/api/sessions": {}
+  "/api/sessions/[id]": { "id": string; }
+  "/api/sessions/[id]/export": { "id": string; }
+  "/api/skills": {}
+  "/api/update": {}
+  "/api/version": {}
+  "/api/web-auth": {}
+  "/api/workspaces": {}
+  "/login": {}
+}
+
+
+export type ParamsOf<Route extends Routes> = ParamMap[Route]
+
+interface LayoutSlotMap {
+  "/": never
+}
+
+
+export type { AppRoutes, PageRoutes, LayoutRoutes, RedirectRoutes, RewriteRoutes, ParamMap, AppRouteHandlerRoutes }
+
+declare global {
+  /**
+   * Props for Next.js App Router page components
+   * @example
+   * ```tsx
+   * export default function Page(props: PageProps<'/blog/[slug]'>) {
+   *   const { slug } = await props.params
+   *   return <div>Blog post: {slug}</div>
+   * }
+   * ```
+   */
+  interface PageProps<AppRoute extends AppRoutes> {
+    params: Promise<ParamMap[AppRoute]>
+    searchParams: Promise<Record<string, string | string[] | undefined>>
+  }
+
+  /**
+   * Props for Next.js App Router layout components
+   * @example
+   * ```tsx
+   * export default function Layout(props: LayoutProps<'/dashboard'>) {
+   *   return <div>{props.children}</div>
+   * }
+   * ```
+   */
+  type LayoutProps<LayoutRoute extends LayoutRoutes> = {
+    params: Promise<ParamMap[LayoutRoute]>
+    children: React.ReactNode
+  } & {
+    [K in LayoutSlotMap[LayoutRoute]]: React.ReactNode
+  }
+
+  /**
+   * Context for Next.js App Router route handlers
+   * @example
+   * ```tsx
+   * export async function GET(request: NextRequest, context: RouteContext<'/api/users/[id]'>) {
+   *   const { id } = await context.params
+   *   return Response.json({ id })
+   * }
+   * ```
+   */
+  interface RouteContext<AppRouteHandlerRoute extends AppRouteHandlerRoutes> {
+    params: Promise<ParamMap[AppRouteHandlerRoute]>
+  }
+}

package/.next/types/validator.ts

@@ -0,0 +1,268 @@
+// This file is generated automatically by Next.js
+// Do not edit this file manually
+// This file validates that all pages and layouts export the correct types
+
+import type { AppRoutes, LayoutRoutes, ParamMap, AppRouteHandlerRoutes } from "./routes.js"
+import type { ResolvingMetadata, ResolvingViewport } from "next/types.js"
+import type { NextRequest } from 'next/server.js'
+
+type AppPageConfig<Route extends AppRoutes = AppRoutes> = {
+  default: React.ComponentType<{ params: Promise<ParamMap[Route]> } & any> | ((props: { params: Promise<ParamMap[Route]> } & any) => React.ReactNode | Promise<React.ReactNode> | never | void | Promise<void>)
+  generateStaticParams?: (props: { params: ParamMap[Route] }) => Promise<any[]> | any[]
+  generateMetadata?: (
+    props: { params: Promise<ParamMap[Route]> } & any,
+    parent: ResolvingMetadata
+  ) => Promise<any> | any
+  generateViewport?: (
+    props: { params: Promise<ParamMap[Route]> } & any,
+    parent: ResolvingViewport
+  ) => Promise<any> | any
+  metadata?: any
+  viewport?: any
+}
+
+type LayoutConfig<Route extends LayoutRoutes = LayoutRoutes> = {
+  default: React.ComponentType<LayoutProps<Route>> | ((props: LayoutProps<Route>) => React.ReactNode | Promise<React.ReactNode> | never | void | Promise<void>)
+  generateStaticParams?: (props: { params: ParamMap[Route] }) => Promise<any[]> | any[]
+  generateMetadata?: (
+    props: { params: Promise<ParamMap[Route]> } & any,
+    parent: ResolvingMetadata
+  ) => Promise<any> | any
+  generateViewport?: (
+    props: { params: Promise<ParamMap[Route]> } & any,
+    parent: ResolvingViewport
+  ) => Promise<any> | any
+  metadata?: any
+  viewport?: any
+}
+
+type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRoutes> = {
+  GET?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  POST?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  PUT?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  PATCH?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  DELETE?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  HEAD?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  OPTIONS?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+}
+
+
+// Validate ../../src/app/login/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/login">> = Specific
+  const handler = {} as typeof import("../../src/app/login/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/">> = Specific
+  const handler = {} as typeof import("../../src/app/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/agent/[id]/events/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/agent/[id]/events">> = Specific
+  const handler = {} as typeof import("../../src/app/api/agent/[id]/events/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/agent/[id]/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/agent/[id]">> = Specific
+  const handler = {} as typeof import("../../src/app/api/agent/[id]/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/agent/[id]/tree/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/agent/[id]/tree">> = Specific
+  const handler = {} as typeof import("../../src/app/api/agent/[id]/tree/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/agent/new/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/agent/new">> = Specific
+  const handler = {} as typeof import("../../src/app/api/agent/new/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/config/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/config">> = Specific
+  const handler = {} as typeof import("../../src/app/api/config/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/files/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/files">> = Specific
+  const handler = {} as typeof import("../../src/app/api/files/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/git/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/git">> = Specific
+  const handler = {} as typeof import("../../src/app/api/git/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/growth/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/growth">> = Specific
+  const handler = {} as typeof import("../../src/app/api/growth/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/health/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/health">> = Specific
+  const handler = {} as typeof import("../../src/app/api/health/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/models/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/models">> = Specific
+  const handler = {} as typeof import("../../src/app/api/models/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/pi-settings/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/pi-settings">> = Specific
+  const handler = {} as typeof import("../../src/app/api/pi-settings/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/plugins/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/plugins">> = Specific
+  const handler = {} as typeof import("../../src/app/api/plugins/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/security/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/security">> = Specific
+  const handler = {} as typeof import("../../src/app/api/security/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/sessions/[id]/export/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/sessions/[id]/export">> = Specific
+  const handler = {} as typeof import("../../src/app/api/sessions/[id]/export/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/sessions/[id]/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/sessions/[id]">> = Specific
+  const handler = {} as typeof import("../../src/app/api/sessions/[id]/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/sessions/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/sessions">> = Specific
+  const handler = {} as typeof import("../../src/app/api/sessions/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/skills/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/skills">> = Specific
+  const handler = {} as typeof import("../../src/app/api/skills/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/update/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/update">> = Specific
+  const handler = {} as typeof import("../../src/app/api/update/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/version/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/version">> = Specific
+  const handler = {} as typeof import("../../src/app/api/version/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/web-auth/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/web-auth">> = Specific
+  const handler = {} as typeof import("../../src/app/api/web-auth/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/workspaces/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/workspaces">> = Specific
+  const handler = {} as typeof import("../../src/app/api/workspaces/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+
+
+
+
+// Validate ../../src/app/layout.tsx
+{
+  type __IsExpected<Specific extends LayoutConfig<"/">> = Specific
+  const handler = {} as typeof import("../../src/app/layout.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rexvane/piweb",
-	"version": "0.3.5",
+	"version": "0.3.7",
 	"license": "MIT",
 	"type": "module",
 	"description": "Modern web UI for the pi coding agent, driven by the official pi SDK without modifying pi",
@@ -31,14 +31,20 @@
 		"assets/showcase.png",
 		"next.config.ts",
 		"tsconfig.json",
-		"postcss.config.mjs"
+		"postcss.config.mjs",
+		".next/BUILD_ID",
+		".next/package.json",
+		".next/app",
+		".next/server",
+		".next/static",
+		".next/types"
 	],
 	"scripts": {
 		"dev": "node scripts/dev.mjs",
 		"build": "node --max-old-space-size=8192 node_modules/next/dist/bin/next build --webpack",
 		"build:release": "node scripts/release.mjs",
 		"postinstall": "node scripts/postinstall.mjs",
-		"prepublishOnly": "npm run check",
+		"prepublishOnly": "npm run typecheck && npm run test",
 		"start": "node bin/piweb.js",
 		"web": "node bin/pi.js web",
 		"typecheck": "tsc --noEmit",

package/scripts/install-build.mjs

@@ -101,13 +101,32 @@ export function assertStagingOutsideNodeModules(root) {
 	return parent;
 }
 
-function tryLinkDependencies(root, staging) {
+function linkOrCopyDependencies(root, staging, log) {
+	const target = path.join(root, "node_modules");
+	const linkPath = path.join(staging, "node_modules");
+	// Windows: junction 不需要符号链接权限；跨卷时 junction 也会失败（试回退）。
+	// POSIX（macOS/Linux）: 目录符号链接即可，"junction" 类型会被 libuv 拒绝。
+	const type = process.platform === "win32" ? "junction" : "dir";
 	try {
-		fs.symlinkSync(path.join(root, "node_modules"), path.join(staging, "node_modules"), "junction");
-		return true;
-	} catch {
-		return false;
+		fs.symlinkSync(target, linkPath, type);
+		return;
+	} catch (error) {
+		// EEXIST：链接已存在（重入/上次构建残留）。指向正确位置就复用，否则删了重建。
+		if (error.code === "EEXIST") {
+			try {
+				const existing = fs.readlinkSync(linkPath);
+				if (path.resolve(path.dirname(linkPath), existing) === path.resolve(target)) return;
+				fs.rmSync(linkPath, { recursive: true, force: true });
+				fs.symlinkSync(target, linkPath, type);
+				return;
+			} catch {
+				/* fall through to the copy */
+			}
+		}
 	}
+	// 兜底：符号链接不可用（如无权限）时整份复制依赖。慢但保证构建可解析。
+	log("[piweb] Symlink unavailable; copying dependencies into the staging build (slower)...");
+	fs.cpSync(target, linkPath, { recursive: true, verbatimSymlinks: true });
 }
 
 function buildInStaging(root, nextBin, env, log, warn) {
@@ -117,13 +136,6 @@ function buildInStaging(root, nextBin, env, log, warn) {
 	} catch {
 		staging = fs.mkdtempSync(path.join(os.tmpdir(), "piweb-build-"));
 	}
-	// junction 不能跨卷：staging 与包不同盘时链接会失败，退回系统临时目录再试一次
-	if (!tryLinkDependencies(root, staging) && path.parse(staging).root !== path.parse(os.tmpdir()).root) {
-		try {
-			fs.rmSync(staging, { recursive: true, force: true, maxRetries: 3, retryDelay: 100 });
-		} catch { /* proceed to the tmpdir attempt */ }
-		staging = fs.mkdtempSync(path.join(os.tmpdir(), "piweb-build-"));
-	}
 	try {
 		for (const entry of ["src", "public", "assets", "scripts", "bin"]) {
 			const from = path.join(root, entry);
@@ -133,10 +145,7 @@ function buildInStaging(root, nextBin, env, log, warn) {
 			const from = path.join(root, file);
 			if (fs.existsSync(from)) fs.copyFileSync(from, path.join(staging, file));
 		}
-		if (!tryLinkDependencies(root, staging)) {
-			warn("[piweb] Could not link dependencies into the staging build (junction unavailable).");
-			return false;
-		}
+		linkOrCopyDependencies(root, staging, log);
 		log(`[piweb] Building in ${staging} ...`);
 		const result = spawnSync(process.execPath, [nextBin, "build", "--webpack"], { cwd: staging, stdio: "inherit", env });
 		const produced = path.join(staging, ".next", "BUILD_ID");
@@ -146,6 +155,8 @@ function buildInStaging(root, nextBin, env, log, warn) {
 		fs.cpSync(path.join(staging, ".next"), target, { recursive: true });
 		return fs.existsSync(path.join(target, "BUILD_ID"));
 	} finally {
+		// 复制兜底时 staging 里是整份 node_modules，必须删掉；rmSync 跟随链接删除
+		// 的是链接本身（Node 14+ 目录符号链接不穿透），真实依赖不受影响。
 		fs.rmSync(staging, { recursive: true, force: true, maxRetries: 3, retryDelay: 100 });
 	}
 }

package/scripts/launcher.mjs

@@ -1,4 +1,5 @@
 import net from "node:net";
+import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import { spawn } from "node:child_process";
@@ -179,7 +180,15 @@ export async function runLauncher({ args = process.argv.slice(2), env = process.
 	if (!options.isDev) {
 		const prepared = ensureInstallBuild(root, { log, warn: dependencies.warn ?? console.warn });
 		if (prepared === "failed" && isProductionOnlyInstall(root)) {
-			throw new Error("无法准备生产构建，且该安装没有开发依赖。请用 `npm rebuild -g piweb` 重试，或改用仓库中的 npm run dev。");
+			// 常见根因：包目录属主不是当前用户（sudo 安装残留），构建产物写不进去
+			let owner = "";
+			try {
+				const stat = await fs.stat(root);
+				if (typeof stat.uid === "number" && stat.uid !== process.getuid?.()) {
+					owner = `\n此安装目录属主不是当前用户（uid ${stat.uid}）——之前可能用 sudo 安装过。修复：sudo chown -R $(whoami) "${root}"，然后重试 piweb。`;
+				}
+			} catch { /* diagnostics only */ }
+			throw new Error(`无法准备生产构建，且该安装没有开发依赖。请用 \`npm rebuild -g piweb\` 重试，或改用仓库中的 npm run dev。${owner}`);
 		}
 	}
 	const plan = createLaunchPlan(root, options, env);