electron-updater-for-render 2.0.0-beta.2 → 2.0.1

package/README.zh-CN.md

@@ -21,8 +21,9 @@
 - **Pipeline 流式下载**：Node.js `stream/promises pipeline` + `Transform` 管道，内存零泄漏，网络背压自动控制
 - **零配置版本探测**：默认自动读取 `process.cwd()/package.json` 中的版本号，无需任何额外配置
 - **独立打包命令**：普通 `npm run build` 不受任何影响，只有 `npm run build:update` 才会触发 ASAR 打包
-- **History 模式 SPA 支持**：内置自定义协议处理器（`app://`），支持 Vue/React History 路由模式，零配置零样板代码
-- **三端隔离 SDK**：原生提供 `main`、`preload`、`renderer` 独立切入点，防止前端构建打包时发生 Node.js 模块（如 `fs`）污染，内置完美的 TypeScript 类型推导。
+- **History 模式支持**：内置支持 Vue/React 的 History 路由模式。
+- **多页应用 (MPA) 支持**：支持通过 `getLoadUrl(entry)` 加载不同的入口文件。
+- **极简 SDK 接入**：提供 `/main`, `/preload`, `/renderer` 导出，内置 `getRouterBase` 路由基准路径探测工具。
 - **精准灰度分发**：支持基于 `deviceId` 的环境身份匹配，配合 `updater.config.ts` 中的 `rolloutRule` 可实现百分百定点静默空投。
 - **Semver 内测通道**：基于 `allowPrerelease` 提供生产环境与内测环境的天然逻辑隔离，保障正式服用户免受 Beta 版干扰。
 - **动态网关鉴权**：通过 `requestOptions` 可在 HTTP 请求中自定义 Headers（如 Oauth / Bearer Token）及 Query 参数。
@@ -189,9 +190,10 @@ app.whenReady().then(async () => {
     webPreferences: { preload: join(__dirname, '../preload/index.js') }
   })
 
-  // 优先加载已下载的热更新 ASAR，否则回退到开发服务器
-  const loadUrl = updater.getLoadUrl()
-  mainWindow.loadURL(loadUrl || 'http://localhost:5173')
+  // 加载最新下载好的 ASAR，若无更新则回退至本地 dist。
+  // 支持多页应用入口传入 (默认为 'index.html')
+  const loadUrl = updater.getLoadUrl('login/index.html')
+  mainWindow.loadURL(loadUrl || `file://${join(__dirname, '../renderer/login/index.html')}`)
 
   // 延迟触发自动检测（支持拦截强制更新，autoPrompt 为 true 时会弹窗提示）
   setTimeout(() => updater.checkForUpdatesAndNotify(), 3000)
@@ -223,7 +225,11 @@ contextBridge.exposeInMainWorld('updaterAPI', exposeUpdaterPreload(ipcRenderer))
 ```vue
 <script setup lang="ts">
 import { ref, onMounted, onUnmounted } from 'vue'
-import { getUpdater } from 'electron-updater-for-render/renderer'
+import { getUpdater, getRouterBase } from 'electron-updater-for-render/renderer'
+
+// 自动探测当前 Window 上下文对应的 History Base
+const routerBase = getRouterBase() 
+const updater = getUpdater()
 
 // 状态：'idle' | 'checking' | 'available' | 'downloading' | 'ready' | 'no-update'
 const status = ref<'idle' | 'checking' | 'available' | 'downloading' | 'ready' | 'no-update'>('idle')
@@ -366,31 +372,49 @@ onUnmounted(() => {
 
 本库完美支持 Electron 常用的文件加载模式（Hash）和现代单页应用路由模式（History）。
 
-### 1. Hash 模式（默认推荐）
-这是最稳健的选择，使用 Electron 标准的 `file://` 协议。
+### 1. Hash 模式 (推荐方案：零配置、零侵入)
+这是 Electron 环境下的**工业级标准实践**。它对物理路径不敏感，不需要配置任何 Base，前端项目完全不需要引入插件的任何 JS 逻辑。
 
-- **主进程**：无需任何额外配置（`routerMode` 默认为 `'hash'`）。
+- **主进程**：无需额外配置（`routerMode` 默认为 `'hash'`）。
 - **前端 (Vite)**：`vite.config.ts` 中的 `base` 设为 `'./'`（或不填）。
 - **前端 (Router)**：使用 `createWebHashHistory()`。
+- **优点**：真正的“零感知”，前端代码与热更新逻辑完全解耦。
 
-### 2. History 模式（企业级方案）
-支持美观的 URL 和标准浏览器重载行为。由于 `file://` 不支持标准路由解析，本库会自动启用自定义协议（默认 `app://`）进行转发。
+### 2. History 模式 (高级方案)
+支持美观的 URL 和标准浏览器刷新行为。由于 MPA 存在物理路径认知偏差，需要对齐基准路径（Base）。
 
 - **主进程**：
   ```typescript
   new RenderUpdater({
-    updateUrl: '...',
-    versionsDir: '...',
-    routerMode: 'history',   // 开启 History 路由支持
-    protocol: 'my-app'       // 可选：自定义协议名 (默认 'app')
+    // ...
+    routerMode: 'history',
+    protocol: 'my-app'  // 可选：自定义协议名 (默认 'app')
+  })
+  ```
+
+- **渲染层 (Router) - 选项 A：使用自动化助手 (推荐)**
+  引入插件提供的轻量级工具函数，自动探测当前窗口的物理基准：
+  ```typescript
+  import { getRouterBase } from 'electron-updater-for-render/renderer'
+  const router = createRouter({
+    history: createWebHistory(getRouterBase()), // 自动对齐 app:// 协议下的物理路径
+    routes: [...]
+  })
+  ```
+
+- **渲染层 (Router) - 选项 B：手动对齐 (零侵入)**
+  如果您不想在前端引入任何插件代码，可以手动指定与 `getLoadUrl()` 传入路径一致的字符串（需以 `.html/` 结尾）：
+  ```typescript
+  const router = createRouter({
+    history: createWebHistory('/index.html/'), 
+    routes: [...]
   })
   ```
-  > 💡 **全自动化**：协议注册和特权赋权逻辑已在库内部**全自动处理**，您无需编写任何 `registerSchemesAsPrivileged` 等繁琐代码。
 
-- **前端构建工具（Vite、Webpack 等）**：**关键配置** —— 必须将 **公共路径 (Public Path / Base)** 设置为 `/`，确保资源引用为绝对路径，防止在深层路由下刷新出现 404。
-  - **Vite**：`base: '/'`
-  - **Webpack**：`output.publicPath: '/'`
-- **前端路由 (Router)**：使用 `createWebHistory()`。
+### 3. 多页应用 (MPA) 支持
+- **多窗口多入口**：支持为不同窗口指定不同的 HTML 入口。
+- **History 模式刷新**：支持在 History 模式下进行页面刷新。
+- **基准路径探测**：配合 `getRouterBase()` 自动识别当前的路由基准路径。
 
 ---
 
@@ -434,14 +458,14 @@ onUnmounted(() => {
 
 ### `RenderUpdater` 实例方法
 
-| 方法 | 返回值 | 说明 |
+| 方法 | 返回值 | 描述 |
 |---|---|---|
-| `check()` | `Promise<CheckResult>` | 检查更新。返回 `{ updateAvailable, status, version, info }`，其中 `status` 为 `'idle' \| 'available' \| 'ready'` |
-| `download(info?, onProgress?)` | `Promise<void>` | 下载更新。将 `check()` 返回的 `info` 传入，可避免重复请求 latest.json |
-| `getLoadUrl()` | `string` | 返回最新 ASAR 的加载地址（`app://renderer/` 或 `file://...`），未安装任何更新时返回空字符串 |
-| `installAndRestart()` | `Promise<void>` | 应用待安装更新并重启应用 |
-| `checkForUpdatesAndNotify()` | `Promise<void>` | 一键式：检查 + 弹窗 + 下载 + 安装，使用内置原生弹窗 |
-| `setUpdatePending(version)` | `void` | 将某版本标记为已下载待重启，同时触发 `onStatusChanged` |
+| `check()` | `Promise<CheckResult>` | 检查更新。返回 `{ updateAvailable, status, version, info }`。状态为 `'idle' \| 'available' \| 'ready'` |
+| `download(info?, onProgress?)` | `Promise<void>` | 下载更新。建议传入 `check()` 返回的 `info` 对象以防止版本竞争 |
+| `getLoadUrl(entry?)` | `string` | 返回加载最新 ASAR 的 URL (`app://renderer/` 或 `file://...`)。`entry` 默认为 `index.html`。若无更新则返回空字符串 |
+| `installAndRestart()` | `Promise<void>` | 应用更新并重启应用 |
+| `checkForUpdatesAndNotify()` | `Promise<void>` | 一站式：检查 + 提示 + 下载 + 安装（使用内置原生对话框） |
+| `setUpdatePending(version)` | `void` | 将某版本标记为已就绪并等待重启。会触发 `onStatusChanged` |
 | `useVersion(version)` | `void` | 立即切换磁盘和内存双重版本指针 |
 | `activeVersion` | `string`（getter） | 当前内存中正在运行的版本（本次会话） |
 | `pendingVersion` | `string`（getter） | 磁盘上最新已下载版本 |

package/Readme.md

@@ -21,8 +21,9 @@ Unlike `electron-updater` which re-downloads the entire app installer, this libr
 - **Stream Pipeline Download**: Node.js `stream/promises pipeline` + `Transform` — zero memory leaks, full backpressure support
 - **Zero-config Version Detection**: Auto-reads version from `process.cwd()/package.json` — no extra config required
 - **Separate Build Commands**: Normal `npm run build` is untouched. Only `npm run build:update` triggers ASAR packaging
-- **History Mode SPA Support**: Built-in custom protocol handler (`app://`) for Vue/React History mode routing — zero boilerplate
-- **Three-Tier SDK (Type-Safe)**: Dedicated `/main`, `/preload`, and `/renderer` exports. Built-in `setupUpdaterIPC` and `exposeUpdaterPreload` absolutely drops Node.js API pollution in the frontend build.
+- **History Mode Support**: Built-in support for Vue/React History router mode.
+- **Multi-Page Application (MPA)**: Support for loading multiple entry points via `getLoadUrl(entry)`.
+- **Simplified SDK**: Unified exports for `/main`, `/preload`, and `/renderer`, including `getRouterBase`.
 - **Precision Canary Releases**: Use `identity.deviceId` and `rolloutRule` to drop updates silently to a whitelist of device IDs.
 - **Semver Beta Channels**: Built-in Beta/RC channel toggling via `allowPrerelease` guarantees Stable users are isolated from beta patches.
 - **Dynamic Request Gateways**: Send custom Authenticated Headers (e.g., Oauth/Bearer tokens) and Queries via `requestOptions` when checking for updates.
@@ -187,9 +188,10 @@ app.whenReady().then(async () => {
     webPreferences: { preload: join(__dirname, '../preload/index.js') }
   })
 
-  // Load the latest downloaded ASAR, fallback to dev server if no update downloaded yet
-  const loadUrl = updater.getLoadUrl()
-  mainWindow.loadURL(loadUrl || 'http://localhost:5173')
+  // Load the latest downloaded ASAR, fallback to local dist if no update is available
+  // Supports multi-page entries (default: 'index.html')
+  const loadUrl = updater.getLoadUrl('login/index.html')
+  mainWindow.loadURL(loadUrl || `file://${join(__dirname, '../renderer/login/index.html')}`)
 
   // Auto-check on startup (respects forceUpdate, shows dialogs if autoPrompt: true)
   setTimeout(() => updater.checkForUpdatesAndNotify(), 3000)
@@ -221,7 +223,11 @@ The following example demonstrates the complete update flow with:
 ```vue
 <script setup lang="ts">
 import { ref, onMounted, onUnmounted } from 'vue'
-import { getUpdater } from 'electron-updater-for-render/renderer'
+import { getUpdater, getRouterBase } from 'electron-updater-for-render/renderer'
+
+// Automatically detect the correct context-aware History base for MPA
+const routerBase = getRouterBase() 
+const updater = getUpdater()
 
 // Status: 'idle' | 'checking' | 'available' | 'downloading' | 'ready' | 'no-update'
 const status = ref<'idle' | 'checking' | 'available' | 'downloading' | 'ready' | 'no-update'>('idle')
@@ -365,31 +371,49 @@ onUnmounted(() => {
 
 The library supports both standard Electron file-loading (Hash) and modern SPA routing (History) via custom protocols.
 
-### 1. Hash Mode (Default)
-Recommended for simple apps. It uses standard `file://` protocol.
+### 1. Hash Mode (Recommended: Zero-Config, Zero-Intrusion)
+The **industry standard** for Electron applications. It is resilient to physical path changes, requires no base configuration, and needs zero plugin-related JS in your frontend.
 
-- **Main Process**: No extra config needed (defaults to `hash`).
+- **Main Process**: No extra config needed (defaults to `'hash'`).
 - **Renderer (Vite)**: Set `base: './'` (or omit) in `vite.config.ts`.
 - **Renderer (Router)**: Use `createWebHashHistory()`.
+- **Pros**: Pure decoupling; your frontend project remains completely unaware of the updater's existence.
 
-### 2. History Mode (Modern)
-Supports clean URLs and standard browser refresh behavior. Uses a custom protocol (default `app://`) to bypass `file://` limitations.
+### 2. History Mode (Advanced)
+Supports clean URLs and native browser refresh behavior. Due to physical path context in MPAs, the router needs to be aligned with the base path.
 
 - **Main Process**: 
   ```typescript
   new RenderUpdater({
-    updateUrl: '...',
-    versionsDir: '...',
-    routerMode: 'history',   // Enable history mode
-    protocol: 'my-app'       // Optional: custom protocol name (default: 'app')
+    // ...
+    routerMode: 'history',
+    protocol: 'my-app'  // Optional: custom protocol name (default: 'app')
+  })
+  ```
+
+- **Renderer (Router) - Option A: Use Automated Helper (Recommended)**
+  Use our lightweight helper to automatically sense the physical base of the current window:
+  ```typescript
+  import { getRouterBase } from 'electron-updater-for-render/renderer'
+  const router = createRouter({
+    history: createWebHistory(getRouterBase()), // Auto-aligns with the app:// protocol path
+    routes: [...]
+  })
+  ```
+
+- **Renderer (Router) - Option B: Manual Alignment (Zero-Intrusion)**
+  If you prefer not to import any plugin JS, you can manually provide a string that matches the path passed to `getLoadUrl()` (must end with `.html/`):
+  ```typescript
+  const router = createRouter({
+    history: createWebHistory('/index.html/'), 
+    routes: [...]
   })
   ```
-  > 💡 **No Boilerplate**: Protocol registration and privileged scheme setup are **automated** internally. You don't need to call `registerSchemesAsPrivileged` manually.
 
-- **Renderer (Build Tool — Vite, Webpack, etc.)**: **CRITICAL** — set your build tool's public base path to `/` for absolute asset URLs. This prevents 404 errors when refreshing on deep-nested routes.
-  - **Vite**: `base: '/'`
-  - **Webpack**: `output.publicPath: '/'`
-- **Renderer (Router)**: Use `createWebHistory()`.
+### 3. Multi-Page Application (MPA)
+- **Multi-window Support**: Load different entry points for different windows.
+- **History Refresh Support**: Supports browser refresh in History mode.
+- **Base Path Detection**: Use `getRouterBase()` to automatically identify the current routing base.
 
 ---
 
@@ -437,7 +461,7 @@ Supports clean URLs and standard browser refresh behavior. Uses a custom protoco
 |---|---|---|
 | `check()` | `Promise<CheckResult>` | Check for updates. Returns `{ updateAvailable, status, version, info }`. Status is `'idle' \| 'available' \| 'ready'` |
 | `download(info?, onProgress?)` | `Promise<void>` | Download the update. Pass the `info` object from `check()` to avoid redundant network requests |
-| `getLoadUrl()` | `string` | Returns the URL to load the latest ASAR (`app://renderer/` or `file://...`). Empty string if no update downloaded |
+| `getLoadUrl(entry?)` | `string` | Returns the URL to load the latest ASAR (`app://renderer/` or `file://...`). `entry` defaults to `index.html`. Returns empty string if no update downloaded |
 | `installAndRestart()` | `Promise<void>` | Apply the pending update and relaunch the app |
 | `checkForUpdatesAndNotify()` | `Promise<void>` | All-in-one: check + prompt + download + install with built-in native dialogs |
 | `setUpdatePending(version)` | `void` | Mark a version as downloaded and pending restart. Also fires `onStatusChanged` |

package/dist/main/index.cjs

@@ -103,13 +103,42 @@ var RouterHandler = class _RouterHandler {
             return new Response("ASAR Not Found", { status: 404 });
           }
           let targetFile = import_path.default.join(asarPath, relativePath);
-          const ext = import_path.default.extname(relativePath);
-          if (!relativePath || relativePath === "/") {
-            targetFile = import_path.default.join(asarPath, "index.html");
-          } else if (ext === "") {
-            targetFile = import_path.default.join(asarPath, "index.html");
-          } else if (!import_fs.default.existsSync(targetFile)) {
-            targetFile = import_path.default.join(asarPath, "index.html");
+          const isFileExist = import_fs.default.existsSync(targetFile) && import_fs.default.statSync(targetFile).isFile();
+          if (!isFileExist) {
+            let rawPath = relativePath.endsWith("/") ? relativePath.slice(0, -1) : relativePath;
+            let ext = import_path.default.extname(rawPath).toLowerCase();
+            if (ext && ext !== ".html") {
+              return new Response("Not Found", { status: 404 });
+            }
+            let fallbackSearchPath = rawPath;
+            let foundFallback = false;
+            while (true) {
+              let checkFile = "";
+              if (fallbackSearchPath !== "") {
+                checkFile = import_path.default.join(asarPath, fallbackSearchPath.endsWith(".html") ? fallbackSearchPath : fallbackSearchPath + ".html");
+                if (import_fs.default.existsSync(checkFile) && import_fs.default.statSync(checkFile).isFile()) {
+                  targetFile = checkFile;
+                  foundFallback = true;
+                  break;
+                }
+              }
+              checkFile = import_path.default.join(asarPath, fallbackSearchPath, "index.html");
+              if (import_fs.default.existsSync(checkFile) && import_fs.default.statSync(checkFile).isFile()) {
+                targetFile = checkFile;
+                foundFallback = true;
+                break;
+              }
+              if (fallbackSearchPath === "") break;
+              const lastSlashIndex = fallbackSearchPath.lastIndexOf("/");
+              if (lastSlashIndex === -1) {
+                fallbackSearchPath = "";
+              } else {
+                fallbackSearchPath = fallbackSearchPath.substring(0, lastSlashIndex);
+              }
+            }
+            if (!foundFallback) {
+              return new Response("Not Found", { status: 404 });
+            }
           }
           const response = await import_electron.net.fetch((0, import_url.pathToFileURL)(targetFile).toString());
           const headers = new Headers(response.headers);
@@ -322,15 +351,24 @@ var RenderUpdater = class {
   get isUpdatePending() {
     return import_semver.default.gt(this._diskVersion || "0.0.0", this._activeVersion || "0.0.0");
   }
-  getLoadUrl() {
+  /**
+   * 获取加载 URL。
+   * @param entry 入口文件路径，默认为 'index.html'。
+   * 对于多页应用 (MPA)，可以传入 'login/index.html' 等。
+   */
+  getLoadUrl(entry = "index.html") {
     try {
       if (this._activeVersion && this._activeVersion !== "0.0.0") {
         const asarPath = import_path2.default.join(this.versionsDir, this._activeVersion, "renderer.asar");
         if (import_original_fs.default.existsSync(asarPath)) {
           if (this.routerMode === "history") {
-            return `${this.protocolName}://renderer/`;
+            if (entry === "index.html" || entry === "/index.html") {
+              return `${this.protocolName}://renderer/`;
+            }
+            const normalizedEntry = entry.startsWith("/") ? entry.slice(1) : entry;
+            return `${this.protocolName}://renderer/${normalizedEntry}/`;
           }
-          return `file://${asarPath}/index.html`;
+          return `file://${asarPath}/${entry}`;
         }
       }
     } catch (e) {

package/dist/main/index.d.ts

@@ -30,7 +30,12 @@ export declare class RenderUpdater {
     get activeVersion(): string;
     get pendingVersion(): string;
     get isUpdatePending(): boolean;
-    getLoadUrl(): string;
+    /**
+     * 获取加载 URL。
+     * @param entry 入口文件路径，默认为 'index.html'。
+     * 对于多页应用 (MPA)，可以传入 'login/index.html' 等。
+     */
+    getLoadUrl(entry?: string): string;
     check(): Promise<{
         updateAvailable: boolean;
         version?: string;

package/dist/main/index.js

@@ -75,13 +75,42 @@ var RouterHandler = class _RouterHandler {
             return new Response("ASAR Not Found", { status: 404 });
           }
           let targetFile = path.join(asarPath, relativePath);
-          const ext = path.extname(relativePath);
-          if (!relativePath || relativePath === "/") {
-            targetFile = path.join(asarPath, "index.html");
-          } else if (ext === "") {
-            targetFile = path.join(asarPath, "index.html");
-          } else if (!fs.existsSync(targetFile)) {
-            targetFile = path.join(asarPath, "index.html");
+          const isFileExist = fs.existsSync(targetFile) && fs.statSync(targetFile).isFile();
+          if (!isFileExist) {
+            let rawPath = relativePath.endsWith("/") ? relativePath.slice(0, -1) : relativePath;
+            let ext = path.extname(rawPath).toLowerCase();
+            if (ext && ext !== ".html") {
+              return new Response("Not Found", { status: 404 });
+            }
+            let fallbackSearchPath = rawPath;
+            let foundFallback = false;
+            while (true) {
+              let checkFile = "";
+              if (fallbackSearchPath !== "") {
+                checkFile = path.join(asarPath, fallbackSearchPath.endsWith(".html") ? fallbackSearchPath : fallbackSearchPath + ".html");
+                if (fs.existsSync(checkFile) && fs.statSync(checkFile).isFile()) {
+                  targetFile = checkFile;
+                  foundFallback = true;
+                  break;
+                }
+              }
+              checkFile = path.join(asarPath, fallbackSearchPath, "index.html");
+              if (fs.existsSync(checkFile) && fs.statSync(checkFile).isFile()) {
+                targetFile = checkFile;
+                foundFallback = true;
+                break;
+              }
+              if (fallbackSearchPath === "") break;
+              const lastSlashIndex = fallbackSearchPath.lastIndexOf("/");
+              if (lastSlashIndex === -1) {
+                fallbackSearchPath = "";
+              } else {
+                fallbackSearchPath = fallbackSearchPath.substring(0, lastSlashIndex);
+              }
+            }
+            if (!foundFallback) {
+              return new Response("Not Found", { status: 404 });
+            }
           }
           const response = await net.fetch(pathToFileURL(targetFile).toString());
           const headers = new Headers(response.headers);
@@ -294,15 +323,24 @@ var RenderUpdater = class {
   get isUpdatePending() {
     return semver.gt(this._diskVersion || "0.0.0", this._activeVersion || "0.0.0");
   }
-  getLoadUrl() {
+  /**
+   * 获取加载 URL。
+   * @param entry 入口文件路径，默认为 'index.html'。
+   * 对于多页应用 (MPA)，可以传入 'login/index.html' 等。
+   */
+  getLoadUrl(entry = "index.html") {
     try {
       if (this._activeVersion && this._activeVersion !== "0.0.0") {
         const asarPath = path2.join(this.versionsDir, this._activeVersion, "renderer.asar");
         if (fs2.existsSync(asarPath)) {
           if (this.routerMode === "history") {
-            return `${this.protocolName}://renderer/`;
+            if (entry === "index.html" || entry === "/index.html") {
+              return `${this.protocolName}://renderer/`;
+            }
+            const normalizedEntry = entry.startsWith("/") ? entry.slice(1) : entry;
+            return `${this.protocolName}://renderer/${normalizedEntry}/`;
           }
-          return `file://${asarPath}/index.html`;
+          return `file://${asarPath}/${entry}`;
         }
       }
     } catch (e) {

package/dist/renderer/index.cjs

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/renderer/index.ts
 var renderer_exports = {};
 __export(renderer_exports, {
+  getRouterBase: () => getRouterBase,
   getUpdater: () => getUpdater
 });
 module.exports = __toCommonJS(renderer_exports);
@@ -33,7 +34,17 @@ function getUpdater(namespace = "updaterAPI") {
   }
   return api;
 }
+function getRouterBase() {
+  if (typeof window === "undefined") return "/";
+  const pathname = window.location.pathname;
+  const htmlIndex = pathname.toLowerCase().lastIndexOf(".html");
+  if (htmlIndex !== -1) {
+    return pathname.substring(0, htmlIndex + 6);
+  }
+  return "/";
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  getRouterBase,
   getUpdater
 });

package/dist/renderer/index.d.ts

@@ -21,3 +21,10 @@ export interface UpdaterClientAPI {
  * This should only be used in the renderer process (e.g. standard Vue/React contexts).
  */
 export declare function getUpdater(namespace?: string): UpdaterClientAPI;
+/**
+ * 自动探测当前页面的路由基准路径 (Base URL)
+ * 专门用于解决多页面 (MPA) 在 History 模式下刷新后 404 的问题。
+ * 例如：当 Electron 加载的是 app://renderer/login/index.html/ 时，
+ * 本函数将返回 "/login/index.html/"，您可以直接将其传给 createWebHistory()。
+ */
+export declare function getRouterBase(): string;

package/dist/renderer/index.js

@@ -9,6 +9,16 @@ function getUpdater(namespace = "updaterAPI") {
   }
   return api;
 }
+function getRouterBase() {
+  if (typeof window === "undefined") return "/";
+  const pathname = window.location.pathname;
+  const htmlIndex = pathname.toLowerCase().lastIndexOf(".html");
+  if (htmlIndex !== -1) {
+    return pathname.substring(0, htmlIndex + 6);
+  }
+  return "/";
+}
 export {
+  getRouterBase,
   getUpdater
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "electron-updater-for-render",
-  "version": "2.0.0-beta.2",
+  "version": "2.0.1",
   "description": "A lightweight incremental updater for Electron renderer processes",
   "type": "module",
   "bin": {