vite-plugin-preloader 1.1.3 → 2.0.0

package/dist/index.d.mts

@@ -1,17 +1,50 @@
 import { Plugin } from 'vite';
 
 interface PreloadRoute {
+    /** 路由路径，如 /dashboard。含 :param 的动态路由会被自动过滤 */
     path: string;
+    /** 可选。组件文件路径，不填则自动推断为 @/views/{path}/index.vue */
     component?: string;
+    /** 备注说明，仅用于日志显示 */
     reason?: string;
+    /** 优先级，数字越小越优先加载，默认 2 */
     priority?: number;
 }
+type StatusPosition = "bottom-right" | "bottom-left" | "top-right" | "top-left";
 interface PreloaderOptions {
-    routes: (string | PreloadRoute)[];
+    /**
+     * 要预加载的路由列表，支持字符串或对象格式
+     * 含 :param 的动态路由段会被自动过滤
+     * 默认 []
+     */
+    routes?: (string | PreloadRoute)[];
+    /**
+     * 页面加载完成后延迟多少毫秒再触发状态显示
+     * 默认 2000ms
+     */
     delay?: number;
+    /**
+     * 是否开启调试日志与 window.__preloaderDebug 调试工具
+     * 默认：开发环境 true，生产环境 false
+     */
     debug?: boolean;
+    /**
+     * 是否在页面角落显示预加载状态提示
+     * 默认 true
+     */
+    showStatus?: boolean;
+    /**
+     * 状态提示的显示位置
+     * 默认 'bottom-right'
+     */
+    statusPosition?: StatusPosition;
+    /**
+     * 要排除预加载的路由路径列表（精确匹配或前缀匹配）
+     * 例：['/404', '/login', '/admin']
+     */
+    exclude?: string[];
 }
 
-declare function preloaderPlugin(options: PreloaderOptions): Plugin;
+declare function preloaderPlugin(userOptions?: PreloaderOptions): Plugin;
 
-export { type PreloadRoute, type PreloaderOptions, preloaderPlugin as default };
+export { type PreloadRoute, type PreloaderOptions, type StatusPosition, preloaderPlugin as default };

package/dist/index.d.ts

@@ -1,17 +1,50 @@
 import { Plugin } from 'vite';
 
 interface PreloadRoute {
+    /** 路由路径，如 /dashboard。含 :param 的动态路由会被自动过滤 */
     path: string;
+    /** 可选。组件文件路径，不填则自动推断为 @/views/{path}/index.vue */
     component?: string;
+    /** 备注说明，仅用于日志显示 */
     reason?: string;
+    /** 优先级，数字越小越优先加载，默认 2 */
     priority?: number;
 }
+type StatusPosition = "bottom-right" | "bottom-left" | "top-right" | "top-left";
 interface PreloaderOptions {
-    routes: (string | PreloadRoute)[];
+    /**
+     * 要预加载的路由列表，支持字符串或对象格式
+     * 含 :param 的动态路由段会被自动过滤
+     * 默认 []
+     */
+    routes?: (string | PreloadRoute)[];
+    /**
+     * 页面加载完成后延迟多少毫秒再触发状态显示
+     * 默认 2000ms
+     */
     delay?: number;
+    /**
+     * 是否开启调试日志与 window.__preloaderDebug 调试工具
+     * 默认：开发环境 true，生产环境 false
+     */
     debug?: boolean;
+    /**
+     * 是否在页面角落显示预加载状态提示
+     * 默认 true
+     */
+    showStatus?: boolean;
+    /**
+     * 状态提示的显示位置
+     * 默认 'bottom-right'
+     */
+    statusPosition?: StatusPosition;
+    /**
+     * 要排除预加载的路由路径列表（精确匹配或前缀匹配）
+     * 例：['/404', '/login', '/admin']
+     */
+    exclude?: string[];
 }
 
-declare function preloaderPlugin(options: PreloaderOptions): Plugin;
+declare function preloaderPlugin(userOptions?: PreloaderOptions): Plugin;
 
-export { type PreloadRoute, type PreloaderOptions, preloaderPlugin as default };
+export { type PreloadRoute, type PreloaderOptions, type StatusPosition, preloaderPlugin as default };

package/dist/index.js

@@ -1,8 +1,10 @@
 // vite-plugin-preloader - 智能路由预加载插件
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -16,6 +18,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -26,261 +36,290 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/runtime.ts
-var runtimeTemplate = `// \u{1F680} Auto-generated by vite-plugin-preloader
-(function() {
-  'use strict';
-  
-  // \u{1F3AF} \u9884\u52A0\u8F7D\u914D\u7F6E\uFF08\u6784\u5EFA\u65F6\u6CE8\u5165\uFF09
-  const PRELOAD_ROUTES = __PRELOAD_ROUTES__
-  const PRELOAD_OPTIONS = __PRELOAD_OPTIONS__
-
-  class PreloaderManager {
-    constructor() {
-      this.preloadedRoutes = new Set()
-      this.isPreloading = false
-      this.stats = {
-        total: 0, completed: 0, failed: 0, startTime: 0, endTime: 0
-      }
-    }
-
-    async start() {
-      if (this.isPreloading) return
-
-      this.isPreloading = true
-      this.stats = {
-        total: PRELOAD_ROUTES.length,
-        completed: 0, failed: 0,
-        startTime: Date.now(), endTime: 0
-      }
-
-      if (PRELOAD_OPTIONS.debug) {
-        console.log(\`\u{1F680} [\u9884\u52A0\u8F7D] \u5F00\u59CB\u9884\u52A0\u8F7D \${PRELOAD_ROUTES.length} \u4E2A\u9875\u9762\`)
-      }
-
-      const sortedRoutes = [...PRELOAD_ROUTES].sort((a, b) => a.priority - b.priority)
-      
-      for (const route of sortedRoutes) {
-        await this.preloadSingle(route)
-        await this.sleep(100)
-      }
-
-      this.stats.endTime = Date.now()
-      this.isPreloading = false
-      
-      if (PRELOAD_OPTIONS.debug) {
-        console.log(\`\u{1F389} [\u9884\u52A0\u8F7D] \u5B8C\u6210! \u8017\u65F6 \${this.stats.endTime - this.stats.startTime}ms\`)
-      }
-    }
-
-    async preloadSingle(route) {
-      if (this.preloadedRoutes.has(route.path)) return
-
-      try {
-        const startTime = Date.now()
-        let componentPath = route.component
-        
-        // \u5728\u5F00\u53D1\u73AF\u5883\u4E2D\uFF0CVite \u4F1A\u5904\u7406\u6A21\u5757\u89E3\u6790
-        // \u6211\u4EEC\u9700\u8981\u4F7F\u7528\u6B63\u786E\u7684\u6A21\u5757 ID
-        if (componentPath.startsWith('@/')) {
-          // \u5BF9\u4E8E Vite\uFF0C@ \u522B\u540D\u5E94\u8BE5\u5728\u6784\u5EFA\u65F6\u5C31\u88AB\u89E3\u6790
-          // \u4F46\u5728\u8FD0\u884C\u65F6\u6211\u4EEC\u9700\u8981\u4F7F\u7528\u5B9E\u9645\u7684\u8DEF\u5F84
-          componentPath = componentPath.replace('@/', '/src/')
-        }
-        
-        // \u786E\u4FDD\u8DEF\u5F84\u4EE5 / \u5F00\u5934\uFF08\u76F8\u5BF9\u4E8E\u9879\u76EE\u6839\u76EE\u5F55\uFF09
-        if (!componentPath.startsWith('/') && !componentPath.startsWith('./')) {
-          componentPath = '/' + componentPath
-        }
-        
-        if (PRELOAD_OPTIONS.debug) {
-          console.log(\`\u{1F50D} [\u9884\u52A0\u8F7D] \u5C1D\u8BD5\u52A0\u8F7D: \${componentPath}\`)
-        }
-        
-        const module = await import(/* @vite-ignore */ componentPath)
-        const loadTime = Date.now() - startTime
-        
-        this.preloadedRoutes.add(route.path)
-        this.stats.completed++
-        
-        if (PRELOAD_OPTIONS.debug) {
-          console.log(\`\u2705 [\u9884\u52A0\u8F7D] \${route.path} (\${loadTime}ms) - \${route.reason}\`)
-        }
-      } catch (error) {
-        this.stats.failed++
-        if (PRELOAD_OPTIONS.debug) {
-          console.error(\`\u274C [\u9884\u52A0\u8F7D] \${route.path} \u5931\u8D25:\`, error)
-        }
-      }
-    }
-
-    sleep(ms) {
-      return new Promise(resolve => setTimeout(resolve, ms))
-    }
-
-    isPreloaded(path) {
-      return this.preloadedRoutes.has(path)
-    }
-
-    getStats() {
-      return {
-        ...this.stats,
-        preloadedPaths: Array.from(this.preloadedRoutes),
-        isPreloading: this.isPreloading
+var STATUS_STYLES = {
+  "bottom-right": "bottom:16px;right:16px",
+  "bottom-left": "bottom:16px;left:16px",
+  "top-right": "top:16px;right:16px",
+  "top-left": "top:16px;left:16px"
+};
+function buildRuntimeScript(config) {
+  const posStyle = STATUS_STYLES[config.statusPosition] ?? STATUS_STYLES["bottom-right"];
+  const configJson = JSON.stringify(config);
+  const statusUiCode = config.showStatus ? `
+  function showStatus(){
+    var links=document.querySelectorAll('link[data-preloader]');
+    if(!links.length)return;
+    var el=document.createElement('div');
+    el.id='__preloader_ui__';
+    el.style.cssText='position:fixed;${posStyle};z-index:2147483647;'
+      +'background:rgba(15,15,15,0.82);color:#fff;font-size:12px;line-height:1.5;'
+      +'padding:7px 14px;border-radius:20px;pointer-events:none;'
+      +'transition:opacity 0.4s ease;font-family:system-ui,-apple-system,sans-serif;'
+      +'backdrop-filter:blur(4px);box-shadow:0 2px 8px rgba(0,0,0,0.3);';
+    el.textContent='\u26A1 \u6B63\u5728\u4F18\u5316 '+links.length+' \u4E2A\u9875\u9762...';
+    document.body&&document.body.appendChild(el);
+    var done=0,total=links.length;
+    function tick(){
+      done++;
+      el.textContent=done>=total?'\u2705 \u9875\u9762\u4F18\u5316\u5B8C\u6210\uFF08'+total+'\u4E2A\uFF09':'\u26A1 \u4F18\u5316\u4E2D '+done+'/'+total+'...';
+      if(done>=total){
+        setTimeout(function(){
+          el.style.opacity='0';
+          setTimeout(function(){el&&el.parentNode&&el.parentNode.removeChild(el);},420);
+        },2200);
       }
     }
+    links.forEach(function(l){l.addEventListener('load',tick);l.addEventListener('error',tick);});
+    setTimeout(function(){el&&el.parentNode&&el.parentNode.removeChild(el);},9000);
   }
-
-  // \u{1F680} \u5168\u5C40\u5B9E\u4F8B
-  const preloader = new PreloaderManager()
-
-  // \u{1F6E0}\uFE0F \u5F00\u53D1\u73AF\u5883\u8C03\u8BD5\u5DE5\u5177
-  if (PRELOAD_OPTIONS.debug) {
-    window.preloaderDebug = {
-      stats: () => preloader.getStats(),
-      restart: () => preloader.start(),
-      check: (path) => preloader.isPreloaded(path),
-      help: () => console.log('\u{1F6E0}\uFE0F \u9884\u52A0\u8F7D\u8C03\u8BD5: stats() | restart() | check(path)')
-    }
-    console.log('\u{1F6E0}\uFE0F \u9884\u52A0\u8F7D\u8C03\u8BD5\u5DE5\u5177: window.preloaderDebug')
-  }
-
-  // \u{1F680} \u81EA\u52A8\u542F\u52A8 - \u7B49\u5F85 DOM \u52A0\u8F7D\u5B8C\u6210
-  function autoStart() {
-    if (document.readyState === 'loading') {
-      document.addEventListener('DOMContentLoaded', () => {
-        setTimeout(() => preloader.start(), PRELOAD_OPTIONS.delay)
-      })
-    } else {
-      setTimeout(() => preloader.start(), PRELOAD_OPTIONS.delay)
-    }
+  if(document.readyState==='loading'){
+    document.addEventListener('DOMContentLoaded',function(){setTimeout(showStatus,C.delay);});
+  }else{
+    setTimeout(showStatus,C.delay);
+  }` : "";
+  const debugCode = config.debug ? `
+  console.group('%c\u{1F680} vite-plugin-preloader v2','color:#4ade80;font-weight:700');
+  console.log('\u5DF2\u6CE8\u5165 '+C.routes.length+' \u4E2A <link rel=\\"prefetch\\"> \u6807\u7B7E\uFF08\u6D4F\u89C8\u5668\u539F\u751F\u8C03\u5EA6\uFF09');
+  C.routes.forEach(function(r){
+    var ok=r.chunkPath;
+    console.log((ok?'\u2705 ':'\u26A0\uFE0F  ')+r.path+(ok?' \u2192 '+r.chunkPath:' (chunk \u672A\u5339\u914D\uFF0C\u4EC5\u5F00\u53D1\u73AF\u5883\u6709\u6548)')+(r.reason?' | '+r.reason:''));
+  });
+  console.groupEnd();
+  window.__preloaderDebug={
+    routes:C.routes,
+    check:function(p){return C.routes.some(function(r){return r.path===p&&!!r.chunkPath;})},
+    help:function(){console.log('__preloaderDebug: .routes | .check(path)');}
+  };
+  console.log('%c\u{1F6E0} \u8C03\u8BD5: window.__preloaderDebug','color:#94a3b8;font-size:11px');` : "";
+  if (!statusUiCode && !debugCode) return "";
+  return `<script>/* vite-plugin-preloader v2 - status/debug */
+(function(){
+  var C=${configJson};
+  var conn=navigator.connection||navigator.mozConnection||navigator.webkitConnection;
+  if(conn&&(conn.saveData||['slow-2g','2g'].indexOf(conn.effectiveType)>=0)){
+    if(C.debug)console.warn('[\u9884\u52A0\u8F7D] \u68C0\u6D4B\u5230\u7701\u6D41/\u4F4E\u901F\u7F51\u7EDC\uFF0C\u8DF3\u8FC7\u72B6\u6001\u663E\u793A');
+    return;
   }
-
-  // \u7ACB\u5373\u6267\u884C\u81EA\u52A8\u542F\u52A8
-  autoStart()
-
-  // \u5BFC\u51FA\u5230\u5168\u5C40\uFF08\u53EF\u9009\u4F7F\u7528\uFF09
-  window.usePreloader = () => ({
-    start: () => preloader.start(),
-    isPreloaded: (path) => preloader.isPreloaded(path),
-    getStats: () => preloader.getStats()
-  })
-
-})();`;
+  ${debugCode}
+  ${statusUiCode}
+})();
+</script>`;
+}
 
 // src/generator.ts
+var import_vite = require("vite");
+var import_node_path = __toESM(require("path"));
 var CodeGenerator = class {
   constructor(options) {
     this.options = options;
+    /** @ 别名对应的相对路径（相对于 viteRoot），默认 'src' */
+    this.srcAlias = "src";
+    this.viteRoot = process.cwd();
   }
   /**
-   * 生成运行时代码
+   * 从 Vite resolvedConfig 中读取项目根目录和 @ 别名
+   * 必须在 configResolved hook 中调用
    */
-  generateRuntime() {
-    const routes = this.processRoutes();
-    const options = this.processOptions();
-    return runtimeTemplate.replace("__PRELOAD_ROUTES__", JSON.stringify(routes, null, 2)).replace("__PRELOAD_OPTIONS__", JSON.stringify(options, null, 2));
+  setViteConfig(config) {
+    this.viteRoot = config.root;
+    const alias = config.resolve?.alias;
+    const entries = Array.isArray(alias) ? alias : Object.entries(alias ?? {}).map(([find, replacement]) => ({ find, replacement }));
+    const atEntry = entries.find(
+      (a) => a.find === "@" || a.find instanceof RegExp && a.find.source === "^@/"
+    );
+    if (atEntry && typeof atEntry.replacement === "string") {
+      const rel = (0, import_vite.normalizePath)(import_node_path.default.relative(this.viteRoot, atEntry.replacement));
+      if (rel) this.srcAlias = rel;
+    }
   }
   /**
-   * 处理路由配置
+   * 将用户路由配置解析为内部 ResolvedRoute 列表
+   * 同时过滤：含 :param 的动态路由段、exclude 列表匹配项
    */
-  processRoutes() {
+  resolveRoutes() {
+    if (!Array.isArray(this.options.routes) || this.options.routes.length === 0) {
+      return [];
+    }
+    const { exclude } = this.options;
     return this.options.routes.map((route) => {
       if (typeof route === "string") {
-        const componentPath2 = this.inferComponentPath(route);
         return {
           path: route,
-          component: componentPath2,
+          component: this.inferComponentPath(route),
           reason: "\u81EA\u52A8\u63A8\u65AD\u7684\u9884\u52A0\u8F7D\u9875\u9762",
           priority: 2
         };
       }
-      const componentPath = route.component || this.inferComponentPath(route.path);
       return {
         path: route.path,
-        component: componentPath,
-        reason: route.reason || "\u7528\u6237\u914D\u7F6E\u7684\u9884\u52A0\u8F7D\u9875\u9762",
-        priority: route.priority || 2
+        component: route.component ?? this.inferComponentPath(route.path),
+        reason: route.reason ?? "\u7528\u6237\u914D\u7F6E\u7684\u9884\u52A0\u8F7D\u9875\u9762",
+        priority: route.priority ?? 2
       };
-    });
+    }).filter((route) => {
+      if (/:\w+/.test(route.path)) return false;
+      if (exclude.length > 0 && exclude.some(
+        (e) => route.path === e || route.path.startsWith(e.replace(/\/$/, "") + "/")
+      )) {
+        return false;
+      }
+      return true;
+    }).sort((a, b) => a.priority - b.priority);
   }
   /**
-   * 处理选项配置
+   * 根据 Rollup OutputBundle 中的 facadeModuleId 为各路由匹配实际 chunk 文件路径
+   * 仅在生产构建的 generateBundle hook 中调用
    */
-  processOptions() {
-    const isDev = process.env.NODE_ENV !== "production";
-    return {
-      delay: this.options.delay ?? 2e3,
-      // 默认2秒
-      showStatus: this.options.showStatus ?? true,
-      // 默认显示状态
-      statusPosition: this.options.statusPosition ?? "bottom-right",
-      // 默认右下角
-      debug: this.options.debug ?? isDev
-      // 开发环境默认开启调试，生产环境默认关闭
-    };
+  fillChunkPaths(routes, bundle) {
+    const chunkMap = /* @__PURE__ */ new Map();
+    for (const [fileName, chunkOrAsset] of Object.entries(bundle)) {
+      if (chunkOrAsset.type !== "chunk") continue;
+      const chunk = chunkOrAsset;
+      if (!chunk.facadeModuleId) continue;
+      chunkMap.set((0, import_vite.normalizePath)(chunk.facadeModuleId), "/" + fileName);
+    }
+    return routes.map((route) => {
+      const absPath = (0, import_vite.normalizePath)(this.resolveComponentAbsPath(route.component));
+      const chunkPath = chunkMap.get(absPath);
+      return chunkPath ? { ...route, chunkPath } : route;
+    });
   }
   /**
-   * 推断组件路径 - 使用 Vite 别名格式
+   * 生成 <link> 标签字符串（注入到 </body> 前）
+   * 生产：<link rel="prefetch"> 指向实际 chunk（浏览器空闲时拉取，完全不阻塞主线程）
+   * 开发：<link rel="modulepreload"> 指向源文件（Vite dev server 处理解析）
    */
-  inferComponentPath(routePath) {
-    const cleanPath = routePath.replace(/^\//, "");
-    if (cleanPath.startsWith("demo/")) {
-      return `@/views/${cleanPath}/index.vue`;
+  generateLinkTags(routes, isBuild) {
+    const tags = [];
+    for (const route of routes) {
+      if (isBuild) {
+        if (!route.chunkPath) continue;
+        tags.push(
+          `<link rel="prefetch" href="${route.chunkPath}" as="script" crossorigin data-preloader="${encodeURIComponent(route.path)}">`
+        );
+      } else {
+        const devPath = route.component.startsWith("@/") ? route.component.replace("@/", `/${this.srcAlias}/`) : route.component;
+        tags.push(
+          `<link rel="modulepreload" href="${devPath}" data-preloader="${encodeURIComponent(route.path)}">`
+        );
+      }
     }
-    const pathSegments = cleanPath.split("/");
-    return `@/views/${pathSegments.join("/")}/index.vue`;
+    return tags.join("\n");
   }
   /**
-   * 生成注入到 HTML 头部的脚本
+   * 生成可选的状态 UI 和调试工具脚本
+   * showStatus=false 且 debug=false 时返回空字符串（0 运行时开销）
    */
-  generateHtmlInject() {
-    return `<script type="module">
-${this.generateRuntime()}
-</script>`;
+  generateRuntimeScript(routes, isBuild) {
+    return buildRuntimeScript({
+      delay: this.options.delay,
+      debug: this.options.debug,
+      showStatus: this.options.showStatus,
+      statusPosition: this.options.statusPosition,
+      isBuild,
+      routes: routes.map((r) => ({
+        path: r.path,
+        chunkPath: r.chunkPath ?? null,
+        reason: r.reason
+      }))
+    });
+  }
+  // --------------------------------------------------------------------------
+  // 私有工具方法
+  // --------------------------------------------------------------------------
+  /** 根据路由路径推断 Vue 组件路径（@/views/{path}/index.vue） */
+  inferComponentPath(routePath) {
+    const cleanPath = routePath.replace(/^\//, "").replace(/\/$/, "");
+    return `@/views/${cleanPath}/index.vue`;
+  }
+  /** 将 @/ 别名路径或相对路径解析为绝对路径，用于与 facadeModuleId 比对 */
+  resolveComponentAbsPath(componentPath) {
+    if (componentPath.startsWith("@/")) {
+      return import_node_path.default.join(this.viteRoot, this.srcAlias, componentPath.slice(2));
+    }
+    if (import_node_path.default.isAbsolute(componentPath)) {
+      return componentPath;
+    }
+    return import_node_path.default.join(this.viteRoot, componentPath);
   }
 };
 
 // src/index.ts
-function preloaderPlugin(options) {
-  let generator;
-  const isDev = process.env.NODE_ENV !== "production";
-  const finalOptions = {
-    debug: isDev,
-    // 开发环境默认开启调试
-    delay: 2e3,
-    // 默认2秒
-    showStatus: true,
-    // 默认显示状态
-    statusPosition: "bottom-right",
-    // 默认右下角
-    ...options
-    // 用户配置覆盖默认配置
+function preloaderPlugin(userOptions = {}) {
+  const options = {
+    routes: Array.isArray(userOptions.routes) ? userOptions.routes : [],
+    delay: userOptions.delay ?? 2e3,
+    debug: userOptions.debug ?? process.env.NODE_ENV !== "production",
+    showStatus: userOptions.showStatus ?? true,
+    statusPosition: userOptions.statusPosition ?? "bottom-right",
+    exclude: userOptions.exclude ?? []
   };
+  const generator = new CodeGenerator(options);
+  let resolvedRoutes = [];
+  let isBuild = false;
   return {
     name: "vite-plugin-preloader",
-    // 🎯 设置插件执行顺序
+    // post 确保在其他插件（如 @vitejs/plugin-vue）处理完后执行
     enforce: "post",
-    configResolved() {
-      generator = new CodeGenerator(finalOptions);
-      if (finalOptions.debug) {
-        console.log(`\u{1F680} [\u9884\u52A0\u8F7D\u63D2\u4EF6] \u5DF2\u542F\u7528\uFF0C\u9884\u52A0\u8F7D ${finalOptions.routes.length} \u4E2A\u9875\u9762\uFF0C\u8BE6\u60C5\u8BF7\u67E5\u770B\u6D4F\u89C8\u5668\u63A7\u5236\u53F0`);
+    // SSR 构建时不注入客户端预加载脚本
+    apply(_, { isSsrBuild }) {
+      return !isSsrBuild;
+    },
+    // ✅ 正确读取 viteConfig：alias、root、command
+    configResolved(config) {
+      isBuild = config.command === "build";
+      generator.setViteConfig(config);
+      resolvedRoutes = generator.resolveRoutes();
+      if (options.debug) {
+        const total = Array.isArray(userOptions.routes) ? userOptions.routes.length : 0;
+        const filtered = total - resolvedRoutes.length;
+        console.log(
+          `\u{1F680} [\u9884\u52A0\u8F7D\u63D2\u4EF6 v2] \u5DF2\u542F\u7528\uFF0C${resolvedRoutes.length} \u4E2A\u8DEF\u7531\u5F85\u9884\u52A0\u8F7D` + (filtered > 0 ? `\uFF08\u5DF2\u8FC7\u6EE4 ${filtered} \u4E2A\u52A8\u6001/\u6392\u9664\u8DEF\u7531\uFF09` : "")
+        );
+        if (!isBuild) {
+          console.log(
+            '   \u5F00\u53D1\u6A21\u5F0F\uFF1A\u6CE8\u5165 <link rel="modulepreload">\uFF0C\u751F\u4EA7\u6784\u5EFA\u540E\u5207\u6362\u4E3A <link rel="prefetch">'
+          );
+        }
+      }
+    },
+    // ✅ 生产构建阶段：扫描 bundle，为路由匹配真实 chunk hash 路径
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    generateBundle(_opts, bundle) {
+      if (!isBuild) return;
+      resolvedRoutes = generator.fillChunkPaths(resolvedRoutes, bundle);
+      if (options.debug) {
+        const matched = resolvedRoutes.filter((r) => r.chunkPath).length;
+        const unmatched = resolvedRoutes.filter((r) => !r.chunkPath);
+        console.log(
+          `\u{1F4E6} [\u9884\u52A0\u8F7D\u63D2\u4EF6 v2] bundle \u626B\u63CF\u5B8C\u6210\uFF1A${matched}/${resolvedRoutes.length} \u4E2A\u8DEF\u7531\u6210\u529F\u5339\u914D chunk`
+        );
+        unmatched.forEach((r) => {
+          console.warn(
+            `   \u26A0\uFE0F  \u672A\u627E\u5230 chunk\uFF1A${r.path} \u2192 ${r.component}\uFF08\u7EC4\u4EF6\u8DEF\u5F84\u53EF\u80FD\u4E0D\u5339\u914D\uFF09`
+          );
+        });
       }
     },
-    // 🎨 HTML 转换 - 直接注入脚本到 HTML
+    // ✅ 注入 <link> 标签 + 可选运行时脚本到 </body> 前
     transformIndexHtml(html) {
-      const inject = generator.generateHtmlInject();
-      return html.replace("</head>", `${inject}
-</head>`);
+      const linkTags = generator.generateLinkTags(resolvedRoutes, isBuild);
+      const runtimeScript = generator.generateRuntimeScript(
+        resolvedRoutes,
+        isBuild
+      );
+      const inject = [linkTags, runtimeScript].filter(Boolean).join("\n");
+      if (!inject) return html;
+      if (html.includes("</body>")) {
+        return html.replace("</body>", `${inject}
+</body>`);
+      }
+      return html + "\n" + inject;
     },
-    // 🔥 HMR 支持
+    // HMR：vite.config 变更时触发完整刷新
     handleHotUpdate(ctx) {
       if (ctx.file.includes("vite.config")) {
-        if (finalOptions.debug) {
-          console.log("\u{1F504} [\u9884\u52A0\u8F7D\u63D2\u4EF6] \u914D\u7F6E\u5DF2\u66F4\u65B0");
-        }
-        ctx.server.ws.send({
-          type: "full-reload"
-        });
+        ctx.server.ws.send({ type: "full-reload" });
         return [];
       }
       return void 0;