remote-reload-utils 0.0.16 → 1.0.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 1.0.0
+
+### Major Changes
+
+- 9306c65: changeset cli 集成 & 变更日志记录
+
 所有重要的项目变更都将记录在此文件中。
 
 格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
@@ -7,63 +13,62 @@
 
 ## [未发布]
 
+## [0.0.17] - 2026-03-19
+
+### Release
+
+- Published version 0.0.17 with patch bump
+
 ## [0.0.16] - 2026-03-18
 
 ### Release
 
 - Published version 0.0.16 with patch bump
 
-
 ## [0.0.15] - 2026-03-17
 
 ### Release
 
 - Published version 0.0.15 with patch bump
 
-
 ## [0.0.14] - 2026-03-17
 
 ### Release
 
 - Published version 0.0.14 with patch bump
 
-
 ## [0.0.13] - 2026-03-17
 
 ### Release
 
 - Published version 0.0.13 with patch bump
 
-
 ## [0.0.12] - 2026-03-16
 
 ### Release
 
 - Published version 0.0.12 with patch bump
 
-
 ## [0.0.11] - 2026-03-16
 
 ### Release
 
 - Published version 0.0.11 with patch bump
 
-
 ## [0.0.10] - 2026-03-15
 
 ### Release
 
 - Published version 0.0.10 with patch bump
 
-
 ## [0.0.9] - 2026-03-15
 
 ### Release
 
 - Published version 0.0.9 with patch bump
 
-
 ### Refactor
+
 - 重构项目为模块化目录结构
   - `src/loader/` - 核心加载模块
   - `src/version/` - 版本管理模块
@@ -77,6 +82,7 @@
 - 更新 package.json types 路径为 `./dist/index.d.ts`
 
 ### Changed
+
 - 修复 preloadRemote 引用从 loadRemote2 改为 loadRemote
 - 移除 App.tsx 中未使用的 React 导入
 - 添加 release 脚本到 package.json
@@ -84,6 +90,7 @@
 ## [0.0.8] - 2026-03-15
 
 ### Refactor
+
 - 抽离公共工具函数到 `loadRemoteUtils.ts`
   - 新增 `fetchLatestVersion()` - 从 npm registry 获取最新版本
   - 新增 `getVersionCache()` / `setVersionCache()` - 缓存管理
@@ -96,14 +103,17 @@
 - 简化 `loadRemote.ts`，使用公共工具函数
 
 ### Changed
+
 - 更新 `index.ts` 导出，新增工具函数导出
 
 ### Docs
+
 - 更新 `loadRemote.md`，添加工具函数 API 文档
 
 ## [0.0.7] - 2026-03-15
 
 ### Features
+
 - 新增微前端工具函数集
   - 远程模块加载
   - React 多版本支持
@@ -114,15 +124,18 @@
 ## [0.0.6] - 2026-03-14
 
 ### Docs
+
 - 更新 README 和 loadRemote.md 文档
 - 添加使用指南和 API 参考
 
 ### Chore
+
 - 更新 remote-reload-utils 版本至 0.0.8
 
 ## [0.0.5] - 2026-03-14
 
 ### Features
+
 - 添加多版本远程加载功能
 - 支持自定义 shared 配置
 - 改进错误处理机制
@@ -130,33 +143,39 @@
 ## [0.0.4] - 2026-03-14
 
 ### Chore
+
 - 更新错误处理逻辑
 - 优化加载流程
 
 ## [0.0.3] - 2026-03-14
 
 ### Docs
+
 - 添加项目描述和 git 仓库信息
 - 更新 README 中的示例代码
 - 将 loadRemote.md 从 src 移动到根目录
 
 ### Chore
+
 - 更新 remote-reload-utils 的版本号至 0.0.3
 
 ## [0.0.2] - 2026-03-14
 
 ### Features
+
 - 添加 React 多版本加载功能（v17/v18/v19）
 - 添加共享配置支持
   - 默认共享 react 和 react-dom
   - 支持自定义共享模块
 
 ### Docs
+
 - 更新示例代码展示如何使用 loadRemoteMultiVersion
 
 ## [0.0.1] - 2026-03-14
 
 ### Features
+
 - 实现多版本远程模块加载功能
   - 支持 CDN 故障转移（jsdelivr、unpkg）
   - 支持本地 fallback 兜底
@@ -170,30 +189,32 @@
 
 ## 版本说明
 
-| 版本 | 日期 | 主要变更 |
-|------|------|----------|
-| 0.0.16 | 2026-03-18 | patch 版本发布 |
-|------|------|----------|
-| 0.0.15 | 2026-03-17 | patch 版本发布 |
-|------|------|----------|
-| 0.0.14 | 2026-03-17 | patch 版本发布 |
-|------|------|----------|
-| 0.0.13 | 2026-03-17 | patch 版本发布 |
-|------|------|----------|
-| 0.0.12 | 2026-03-16 | patch 版本发布 |
-|------|------|----------|
-| 0.0.11 | 2026-03-16 | patch 版本发布 |
-|------|------|----------|
-| 0.0.10 | 2026-03-15 | patch 版本发布 |
-|------|------|----------|
-| 0.0.9 | 2026-03-15 | patch 版本发布 |
-|------|------|----------|
-| 0.0.9 | 2026-03-15 | 重构为模块化目录结构 |
-| 0.0.8 | 2026-03-15 | 重构代码结构，抽离公共工具函数 |
-| 0.0.7 | 2026-03-15 | 新增微前端工具函数集 |
-| 0.0.6 | 2026-03-14 | 文档更新 |
-| 0.0.5 | 2026-03-14 | 多版本远程加载 |
-| 0.0.4 | 2026-03-14 | 错误处理优化 |
-| 0.0.3 | 2026-03-14 | 文档和配置更新 |
-| 0.0.2 | 2026-03-14 | React 多版本支持 |
-| 0.0.1 | 2026-03-14 | 初始版本 |
+| 版本   | 日期       | 主要变更                       |
+| ------ | ---------- | ------------------------------ |
+| 0.0.17 | 2026-03-19 | patch 版本发布                 |
+| ------ | ------     | ----------                     |
+| 0.0.16 | 2026-03-18 | patch 版本发布                 |
+| ------ | ------     | ----------                     |
+| 0.0.15 | 2026-03-17 | patch 版本发布                 |
+| ------ | ------     | ----------                     |
+| 0.0.14 | 2026-03-17 | patch 版本发布                 |
+| ------ | ------     | ----------                     |
+| 0.0.13 | 2026-03-17 | patch 版本发布                 |
+| ------ | ------     | ----------                     |
+| 0.0.12 | 2026-03-16 | patch 版本发布                 |
+| ------ | ------     | ----------                     |
+| 0.0.11 | 2026-03-16 | patch 版本发布                 |
+| ------ | ------     | ----------                     |
+| 0.0.10 | 2026-03-15 | patch 版本发布                 |
+| ------ | ------     | ----------                     |
+| 0.0.9  | 2026-03-15 | patch 版本发布                 |
+| ------ | ------     | ----------                     |
+| 0.0.9  | 2026-03-15 | 重构为模块化目录结构           |
+| 0.0.8  | 2026-03-15 | 重构代码结构，抽离公共工具函数 |
+| 0.0.7  | 2026-03-15 | 新增微前端工具函数集           |
+| 0.0.6  | 2026-03-14 | 文档更新                       |
+| 0.0.5  | 2026-03-14 | 多版本远程加载                 |
+| 0.0.4  | 2026-03-14 | 错误处理优化                   |
+| 0.0.3  | 2026-03-14 | 文档和配置更新                 |
+| 0.0.2  | 2026-03-14 | React 多版本支持               |
+| 0.0.1  | 2026-03-14 | 初始版本                       |

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { loadReactVersion } from './version/react';
 export { checkVersionCompatibility, satisfiesVersion, findCompatibleVersion, getCompatibleReactVersions, fetchAvailableVersions, sortVersions, getLatestVersion, getStableVersions, extractMajorVersion, isPrerelease, compareVersions, parseVersion, } from './version';
-export { loadRemoteMultiVersion } from './loader';
-export { fetchLatestVersion, getVersionCache, setVersionCache, buildCdnUrls, tryLoadRemote, getFinalSharedConfig, resolveFinalVersion, buildFinalUrls, type LoadResult, } from './loader/utils';
+export { loadRemoteMultiVersion, createRemoteSourcePlugin, type RemoteSourcePlugin, type RemoteSourcePluginContext, type LoadRemoteExtraOptions, } from './loader';
+export { fetchLatestVersion, getVersionCache, setVersionCache, buildCdnUrls, tryLoadRemote, getFinalSharedConfig, resolveFinalVersion, buildFinalUrls, type LoadResult, type RuntimeRemote, } from './loader/utils';
 export { preloadRemote, preloadRemoteList, cancelPreload, clearPreloadCache, getPreloadStatus, } from './preload';
 export { unloadRemote, unloadAll, registerRemoteInstance, registerLoadedModule, getLoadedRemotes, isRemoteLoaded, } from './unload';
 export { checkRemoteHealth, checkModuleLoadable, getRemoteHealthReport, formatHealthStatus, } from './health';

package/dist/loader/index.d.ts

@@ -1,6 +1,8 @@
-import { ModuleFederationRuntimePlugin } from '@module-federation/enhanced/runtime';
+import type { ModuleFederationRuntimePlugin } from '@module-federation/enhanced/runtime';
 import type { LoadRemoteOptions } from '../types';
+import { createRemoteSourcePlugin, type LoadRemoteExtraOptions, type RemoteSourcePlugin, type RemoteSourcePluginContext } from './remote-source';
+export { createRemoteSourcePlugin, type RemoteSourcePlugin, type RemoteSourcePluginContext, type LoadRemoteExtraOptions, };
 /**
  * 多版本共存的 loadRemote
  */
-export declare function loadRemoteMultiVersion(options: LoadRemoteOptions, plugins: ModuleFederationRuntimePlugin[]): Promise<import("./utils").LoadResult>;
+export declare function loadRemoteMultiVersion(options: LoadRemoteOptions, plugins?: ModuleFederationRuntimePlugin[], extraOptions?: LoadRemoteExtraOptions): Promise<import("./utils").LoadResult>;

package/dist/loader/remote-source/index.d.ts

@@ -0,0 +1,28 @@
+import type { LoadRemoteOptions } from '../../types';
+import type { RuntimeRemote } from '../utils';
+type MaybePromise<T> = T | Promise<T>;
+export interface RemoteSourcePluginContext {
+    options: LoadRemoteOptions;
+    scopeName: string;
+    pkg: string;
+    finalVersion: string;
+    currentEntry: string;
+    allEntries: string[];
+}
+export interface RemoteSourcePlugin {
+    name: string;
+    registerRemotes?: (context: RemoteSourcePluginContext) => MaybePromise<RuntimeRemote[] | void>;
+}
+export interface LoadRemoteExtraOptions {
+    remoteSourcePlugins?: RemoteSourcePlugin[];
+    baseRemotes?: RuntimeRemote[];
+    registerOptions?: {
+        force?: boolean;
+    };
+}
+export declare function resolveRegisteredRemotes(context: RemoteSourcePluginContext, baseRemotes: RuntimeRemote[], remoteSourcePlugins: RemoteSourcePlugin[]): Promise<RuntimeRemote[]>;
+/**
+ * 创建静态 remote 来源插件
+ */
+export declare function createRemoteSourcePlugin(name: string, remotes: RuntimeRemote[]): RemoteSourcePlugin;
+export {};

package/dist/loader/utils.d.ts

@@ -20,10 +20,14 @@ export interface LoadResult {
     scopeName: string;
     mf: ReturnType<typeof createInstance>;
 }
+export type RuntimeRemote = Parameters<ReturnType<typeof createInstance>['registerRemotes']>[0][number];
 /**
- * 尝试加载单个远程模块 URL，包含重试逻辑
+ * 尝试加载单个远程模块 URL
+ * 注意：实际的重试机制在外层 loadRemoteMultiVersion 的 URL 遍历中实现
  */
-export declare function tryLoadRemote(scopeName: string, url: string, retries: number, delay: number, sharedConfig: Record<string, any>, plugins: ModuleFederationRuntimePlugin[]): Promise<LoadResult>;
+export declare function tryLoadRemote(scopeName: string, url: string, _retries: number, _delay: number, sharedConfig: Record<string, any>, plugins: ModuleFederationRuntimePlugin[], extraRemotes?: RuntimeRemote[], registerOptions?: {
+    force?: boolean;
+}): Promise<LoadResult>;
 /**
  * 获取最终的共享配置
  */

package/dist/main.cjs

@@ -60,6 +60,7 @@ __webpack_require__.d(__webpack_exports__, {
     satisfiesVersion: ()=>satisfiesVersion,
     formatHealthStatus: ()=>formatHealthStatus,
     unloadAll: ()=>unloadAll,
+    createRemoteSourcePlugin: ()=>createRemoteSourcePlugin,
     setVersionCache: ()=>setVersionCache,
     isPrerelease: ()=>isPrerelease,
     checkRemoteHealth: ()=>checkRemoteHealth,
@@ -323,8 +324,20 @@ function buildCdnUrls(pkg, version) {
 }
 const mfInstanceCache = new Map();
 const mfInstanceLoadingCache = new Map();
-async function tryLoadRemote(scopeName, url, retries, delay, sharedConfig, plugins) {
-    const cacheKey = `${scopeName}::${url}`;
+function buildRemotesIdentity(remotes) {
+    if (0 === remotes.length) return '';
+    return remotes.map((remote)=>JSON.stringify({
+            name: remote.name,
+            entry: 'entry' in remote ? remote.entry : '',
+            version: 'version' in remote ? remote.version : '',
+            alias: remote.alias || '',
+            type: remote.type || '',
+            entryGlobalName: remote.entryGlobalName || ''
+        })).sort().join('|');
+}
+async function tryLoadRemote(scopeName, url, _retries, _delay, sharedConfig, plugins, extraRemotes = [], registerOptions = {}) {
+    const remotesIdentity = buildRemotesIdentity(extraRemotes);
+    const cacheKey = `${scopeName}::${url}::${remotesIdentity}::${registerOptions.force ? 'force' : 'normal'}`;
     const cachedMfs = mfInstanceCache.get(cacheKey);
     if (cachedMfs) return {
         scopeName,
@@ -332,41 +345,32 @@ async function tryLoadRemote(scopeName, url, retries, delay, sharedConfig, plugi
     };
     const loadingMfs = mfInstanceLoadingCache.get(cacheKey);
     if (loadingMfs) return loadingMfs;
-    const createProcess = (async ()=>{
-        let lastError;
-        for(let i = 0; i < retries; i++)try {
-            const mf = (0, runtime_namespaceObject.createInstance)({
-                name: 'host',
-                remotes: [
-                    {
-                        name: scopeName,
-                        entry: url
-                    }
-                ],
-                shared: sharedConfig,
-                plugins: [
-                    ...plugins,
-                    fallbackPlugin()
-                ]
-            });
-            const result = {
-                scopeName,
-                mf
-            };
-            mfInstanceCache.set(cacheKey, mf);
-            return result;
-        } catch (e) {
-            lastError = e;
-            console.warn(`[MF] URL ${url} 加载失败，第 ${i + 1} 次重试...`);
-            if (i < retries - 1) await new Promise((res)=>setTimeout(res, delay));
-        }
-        throw new Error(`[MF] URL ${url} 经过 ${retries} 次重试仍加载失败。`, {
-            cause: lastError
+    const loadPromise = Promise.resolve().then(()=>{
+        const mf = (0, runtime_namespaceObject.createInstance)({
+            name: 'host',
+            remotes: [
+                {
+                    name: scopeName,
+                    entry: url
+                }
+            ],
+            shared: sharedConfig,
+            plugins: [
+                ...plugins,
+                fallbackPlugin()
+            ]
         });
-    })();
-    mfInstanceLoadingCache.set(cacheKey, createProcess);
+        if (extraRemotes.length > 0) mf.registerRemotes(extraRemotes, registerOptions);
+        const result = {
+            scopeName,
+            mf
+        };
+        mfInstanceCache.set(cacheKey, mf);
+        return result;
+    });
+    mfInstanceLoadingCache.set(cacheKey, loadPromise);
     try {
-        return await createProcess;
+        return await loadPromise;
     } finally{
         mfInstanceLoadingCache.delete(cacheKey);
     }
@@ -488,15 +492,55 @@ function buildFinalUrls(pkg, version, localFallback) {
     if (localFallback) urls.push(localFallback);
     return urls;
 }
-async function loadRemoteMultiVersion(options, plugins) {
+function dedupeRemotes(remotes) {
+    const map = new Map();
+    for (const remote of remotes){
+        if (!remote?.name) continue;
+        const key = [
+            remote.name,
+            'entry' in remote ? remote.entry || '' : '',
+            'version' in remote ? remote.version || '' : '',
+            remote.alias || ''
+        ].join('::');
+        if (!map.has(key)) map.set(key, remote);
+    }
+    return Array.from(map.values());
+}
+async function resolveRegisteredRemotes(context, baseRemotes, remoteSourcePlugins) {
+    const remoteList = [
+        ...baseRemotes
+    ];
+    for (const plugin of remoteSourcePlugins)if (plugin.registerRemotes) try {
+        const pluginRemotes = await plugin.registerRemotes(context);
+        if (pluginRemotes?.length) remoteList.push(...pluginRemotes);
+    } catch (error) {
+        throw new Error(`[MF] remote 来源插件 ${plugin.name} 执行失败: ${error.message}`);
+    }
+    return dedupeRemotes(remoteList).filter((remote)=>!(remote.name === context.scopeName && 'entry' in remote && remote.entry === context.currentEntry));
+}
+function createRemoteSourcePlugin(name, remotes) {
+    return {
+        name,
+        registerRemotes: ()=>remotes
+    };
+}
+async function loadRemoteMultiVersion(options, plugins = [], extraOptions = {}) {
     const { name, pkg, version = 'latest', retries = 3, delay = 1000, localFallback, cacheTTL = 86400000, revalidate = true, shared: customShared } = options;
+    const { remoteSourcePlugins = [], baseRemotes = [], registerOptions = {} } = extraOptions;
     const finalVersion = await resolveFinalVersion(pkg, version, cacheTTL, revalidate);
     const scopeName = `${name}`;
     const urls = buildFinalUrls(pkg, finalVersion, localFallback);
     const finalSharedConfig = getFinalSharedConfig(customShared);
-    console.log(finalSharedConfig, 'finalSharedConfig');
     for (const url of urls)try {
-        return await tryLoadRemote(scopeName, url, retries, delay, finalSharedConfig, plugins);
+        const registeredRemotes = await resolveRegisteredRemotes({
+            options,
+            scopeName,
+            pkg,
+            finalVersion,
+            currentEntry: url,
+            allEntries: urls
+        }, baseRemotes, remoteSourcePlugins);
+        return await tryLoadRemote(scopeName, url, retries, delay, finalSharedConfig, plugins, registeredRemotes, registerOptions);
     } catch (e) {
         console.warn(`[MF] 切换 CDN 路径：${url} 失败，尝试下一个...`, e);
     }
@@ -897,6 +941,7 @@ exports.checkVersionCompatibility = __webpack_exports__.checkVersionCompatibilit
 exports.clearPreloadCache = __webpack_exports__.clearPreloadCache;
 exports.compareVersions = __webpack_exports__.compareVersions;
 exports.createEventBus = __webpack_exports__.createEventBus;
+exports.createRemoteSourcePlugin = __webpack_exports__.createRemoteSourcePlugin;
 exports.eventBus = __webpack_exports__.eventBus;
 exports.extractMajorVersion = __webpack_exports__.extractMajorVersion;
 exports.fallbackPlugin = __webpack_exports__.fallbackPlugin;
@@ -938,6 +983,7 @@ for(var __webpack_i__ in __webpack_exports__)if (-1 === [
     "clearPreloadCache",
     "compareVersions",
     "createEventBus",
+    "createRemoteSourcePlugin",
     "eventBus",
     "extractMajorVersion",
     "fallbackPlugin",

package/dist/main.js

@@ -256,8 +256,20 @@ function buildCdnUrls(pkg, version) {
 }
 const mfInstanceCache = new Map();
 const mfInstanceLoadingCache = new Map();
-async function tryLoadRemote(scopeName, url, retries, delay, sharedConfig, plugins) {
-    const cacheKey = `${scopeName}::${url}`;
+function buildRemotesIdentity(remotes) {
+    if (0 === remotes.length) return '';
+    return remotes.map((remote)=>JSON.stringify({
+            name: remote.name,
+            entry: 'entry' in remote ? remote.entry : '',
+            version: 'version' in remote ? remote.version : '',
+            alias: remote.alias || '',
+            type: remote.type || '',
+            entryGlobalName: remote.entryGlobalName || ''
+        })).sort().join('|');
+}
+async function tryLoadRemote(scopeName, url, _retries, _delay, sharedConfig, plugins, extraRemotes = [], registerOptions = {}) {
+    const remotesIdentity = buildRemotesIdentity(extraRemotes);
+    const cacheKey = `${scopeName}::${url}::${remotesIdentity}::${registerOptions.force ? 'force' : 'normal'}`;
     const cachedMfs = mfInstanceCache.get(cacheKey);
     if (cachedMfs) return {
         scopeName,
@@ -265,41 +277,32 @@ async function tryLoadRemote(scopeName, url, retries, delay, sharedConfig, plugi
     };
     const loadingMfs = mfInstanceLoadingCache.get(cacheKey);
     if (loadingMfs) return loadingMfs;
-    const createProcess = (async ()=>{
-        let lastError;
-        for(let i = 0; i < retries; i++)try {
-            const mf = createInstance({
-                name: 'host',
-                remotes: [
-                    {
-                        name: scopeName,
-                        entry: url
-                    }
-                ],
-                shared: sharedConfig,
-                plugins: [
-                    ...plugins,
-                    fallbackPlugin()
-                ]
-            });
-            const result = {
-                scopeName,
-                mf
-            };
-            mfInstanceCache.set(cacheKey, mf);
-            return result;
-        } catch (e) {
-            lastError = e;
-            console.warn(`[MF] URL ${url} 加载失败，第 ${i + 1} 次重试...`);
-            if (i < retries - 1) await new Promise((res)=>setTimeout(res, delay));
-        }
-        throw new Error(`[MF] URL ${url} 经过 ${retries} 次重试仍加载失败。`, {
-            cause: lastError
+    const loadPromise = Promise.resolve().then(()=>{
+        const mf = createInstance({
+            name: 'host',
+            remotes: [
+                {
+                    name: scopeName,
+                    entry: url
+                }
+            ],
+            shared: sharedConfig,
+            plugins: [
+                ...plugins,
+                fallbackPlugin()
+            ]
         });
-    })();
-    mfInstanceLoadingCache.set(cacheKey, createProcess);
+        if (extraRemotes.length > 0) mf.registerRemotes(extraRemotes, registerOptions);
+        const result = {
+            scopeName,
+            mf
+        };
+        mfInstanceCache.set(cacheKey, mf);
+        return result;
+    });
+    mfInstanceLoadingCache.set(cacheKey, loadPromise);
     try {
-        return await createProcess;
+        return await loadPromise;
     } finally{
         mfInstanceLoadingCache.delete(cacheKey);
     }
@@ -421,15 +424,55 @@ function buildFinalUrls(pkg, version, localFallback) {
     if (localFallback) urls.push(localFallback);
     return urls;
 }
-async function loadRemoteMultiVersion(options, plugins) {
+function dedupeRemotes(remotes) {
+    const map = new Map();
+    for (const remote of remotes){
+        if (!remote?.name) continue;
+        const key = [
+            remote.name,
+            'entry' in remote ? remote.entry || '' : '',
+            'version' in remote ? remote.version || '' : '',
+            remote.alias || ''
+        ].join('::');
+        if (!map.has(key)) map.set(key, remote);
+    }
+    return Array.from(map.values());
+}
+async function resolveRegisteredRemotes(context, baseRemotes, remoteSourcePlugins) {
+    const remoteList = [
+        ...baseRemotes
+    ];
+    for (const plugin of remoteSourcePlugins)if (plugin.registerRemotes) try {
+        const pluginRemotes = await plugin.registerRemotes(context);
+        if (pluginRemotes?.length) remoteList.push(...pluginRemotes);
+    } catch (error) {
+        throw new Error(`[MF] remote 来源插件 ${plugin.name} 执行失败: ${error.message}`);
+    }
+    return dedupeRemotes(remoteList).filter((remote)=>!(remote.name === context.scopeName && 'entry' in remote && remote.entry === context.currentEntry));
+}
+function createRemoteSourcePlugin(name, remotes) {
+    return {
+        name,
+        registerRemotes: ()=>remotes
+    };
+}
+async function loadRemoteMultiVersion(options, plugins = [], extraOptions = {}) {
     const { name, pkg, version = 'latest', retries = 3, delay = 1000, localFallback, cacheTTL = 86400000, revalidate = true, shared: customShared } = options;
+    const { remoteSourcePlugins = [], baseRemotes = [], registerOptions = {} } = extraOptions;
     const finalVersion = await resolveFinalVersion(pkg, version, cacheTTL, revalidate);
     const scopeName = `${name}`;
     const urls = buildFinalUrls(pkg, finalVersion, localFallback);
     const finalSharedConfig = getFinalSharedConfig(customShared);
-    console.log(finalSharedConfig, 'finalSharedConfig');
     for (const url of urls)try {
-        return await tryLoadRemote(scopeName, url, retries, delay, finalSharedConfig, plugins);
+        const registeredRemotes = await resolveRegisteredRemotes({
+            options,
+            scopeName,
+            pkg,
+            finalVersion,
+            currentEntry: url,
+            allEntries: urls
+        }, baseRemotes, remoteSourcePlugins);
+        return await tryLoadRemote(scopeName, url, retries, delay, finalSharedConfig, plugins, registeredRemotes, registerOptions);
     } catch (e) {
         console.warn(`[MF] 切换 CDN 路径：${url} 失败，尝试下一个...`, e);
     }
@@ -821,4 +864,4 @@ const eventBus = EventBusClass.create();
 function createEventBus() {
     return EventBusClass.create();
 }
-export { buildCdnUrls, buildFinalUrls, cancelPreload, checkModuleLoadable, checkRemoteHealth, checkVersionCompatibility, clearPreloadCache, compareVersions, createEventBus, eventBus, extractMajorVersion, fallbackPlugin, fetchAvailableVersions, fetchLatestVersion, findCompatibleVersion, formatHealthStatus, getCompatibleReactVersions, getFinalSharedConfig, getLatestVersion, getLoadedRemotes, getPreloadStatus, getRemoteHealthReport, getStableVersions, getVersionCache, isPrerelease, isRemoteLoaded, loadReactVersion, loadRemoteMultiVersion, parseVersion, preloadRemote, preloadRemoteList, registerLoadedModule, registerRemoteInstance, resolveFinalVersion, satisfiesVersion, setVersionCache, sortVersions, tryLoadRemote, unloadAll, unloadRemote };
+export { buildCdnUrls, buildFinalUrls, cancelPreload, checkModuleLoadable, checkRemoteHealth, checkVersionCompatibility, clearPreloadCache, compareVersions, createEventBus, createRemoteSourcePlugin, eventBus, extractMajorVersion, fallbackPlugin, fetchAvailableVersions, fetchLatestVersion, findCompatibleVersion, formatHealthStatus, getCompatibleReactVersions, getFinalSharedConfig, getLatestVersion, getLoadedRemotes, getPreloadStatus, getRemoteHealthReport, getStableVersions, getVersionCache, isPrerelease, isRemoteLoaded, loadReactVersion, loadRemoteMultiVersion, parseVersion, preloadRemote, preloadRemoteList, registerLoadedModule, registerRemoteInstance, resolveFinalVersion, satisfiesVersion, setVersionCache, sortVersions, tryLoadRemote, unloadAll, unloadRemote };

package/dist/types/index.d.ts

@@ -9,7 +9,7 @@ export interface LoadRemoteOptions {
     localFallback?: string;
     cacheTTL?: number;
     revalidate?: boolean;
-    shared?: Record<string, ModuleFederationRuntimePlugin>;
+    shared?: Record<string, any>;
 }
 export interface VersionCache {
     [pkg: string]: {

package/loadRemote.md

@@ -168,7 +168,8 @@ async function loadMultipleComponents() {
 ```typescript
 function loadRemoteMultiVersion(
   options: LoadRemoteOptions,
-  plugins: ModuleFederationRuntimePlugin[]
+  plugins?: ModuleFederationRuntimePlugin[],
+  extraOptions?: LoadRemoteExtraOptions,
 ): Promise<LoadResult>
 ```
 
@@ -192,6 +193,14 @@ function loadRemoteMultiVersion(
 
 Module Federation 运行时插件数组，默认会添加 `fallbackPlugin()`。
 
+**extraOptions**: `LoadRemoteExtraOptions`
+
+| 属性 | 类型 | 必填 | 默认值 | 描述 |
+|------|------|------|--------|------|
+| `baseRemotes` | `RuntimeRemote[]` | ❌ | `[]` | 直接注册的附加 remote 列表 |
+| `remoteSourcePlugins` | `RemoteSourcePlugin[]` | ❌ | `[]` | 通过插件动态返回并注册 remote 列表 |
+| `registerOptions` | `{ force?: boolean }` | ❌ | `{}` | 透传给 `registerRemotes` 的配置 |
+
 #### 返回值
 
 ```typescript
@@ -869,6 +878,38 @@ const { mf } = await loadRemoteMultiVersion(options, [
 ]);
 ```
 
+#### 4. 通过 `registerRemotes` 动态注册多个来源
+
+```typescript
+import { loadRemoteMultiVersion, createRemoteSourcePlugin } from 'remote-reload-utils';
+
+const remoteSourcePlugin = createRemoteSourcePlugin('multi-remote-source', [
+  {
+    name: 'remote_ui_v2',
+    entry: 'https://cdn.example.com/remote-ui-v2/dist/remoteEntry.js',
+  },
+  {
+    name: 'remote_widget',
+    entry: 'https://cdn.example.com/remote-widget/dist/remoteEntry.js',
+  },
+]);
+
+const { scopeName, mf } = await loadRemoteMultiVersion(
+  {
+    name: 'react_mf_lib',
+    pkg: 'test-mf-unpkg',
+    version: 'latest',
+  },
+  [],
+  {
+    remoteSourcePlugins: [remoteSourcePlugin],
+  },
+);
+
+const Button = await mf.loadRemote(`${scopeName}/Button`);
+const Widget = await mf.loadRemote('remote_widget/Widget');
+```
+
 #### 2. 监控加载状态
 
 ```typescript
@@ -1238,7 +1279,31 @@ interface LoadRemoteOptions {
   localFallback?: string;  // 本地兜底
   cacheTTL?: number;  // 缓存时间
   revalidate?: boolean;  // 灰度更新
-  shared?: Record<string, ModuleFederationRuntimePlugin>;  // 自定义 shared 配置
+  shared?: Record<string, any>;  // 自定义 shared 配置
+}
+
+interface LoadRemoteExtraOptions {
+  remoteSourcePlugins?: RemoteSourcePlugin[];
+  baseRemotes?: RuntimeRemote[];
+  registerOptions?: {
+    force?: boolean;
+  };
+}
+
+interface RemoteSourcePluginContext {
+  options: LoadRemoteOptions;
+  scopeName: string;
+  pkg: string;
+  finalVersion: string;
+  currentEntry: string;
+  allEntries: string[];
+}
+
+interface RemoteSourcePlugin {
+  name: string;
+  registerRemotes?: (
+    context: RemoteSourcePluginContext
+  ) => RuntimeRemote[] | void | Promise<RuntimeRemote[] | void>;
 }
 
 interface VersionCache {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "remote-reload-utils",
-  "version": "0.0.16",
+  "version": "1.0.0",
   "type": "module",
   "description": "Utilities for remote reload in Module Federation & React Component",
   "exports": {
@@ -57,23 +57,6 @@
       "optional": true
     }
   },
-  "scripts": {
-    "build": "rslib build",
-    "dev": "rslib build --watch",
-    "prepublishOnly": "npm run build",
-    "format": "biome format --write",
-    "check": "biome check --write",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "lint": "biome format ./src --write",
-    "release:prepare": "node scripts/generateReleasePr.mjs",
-    "release:finalize": "node scripts/finalizeRelease.mjs",
-    "release:patch": "pnpm release:prepare -t patch",
-    "release:minor": "pnpm release:prepare -t minor",
-    "release:major": "pnpm release:prepare -t major",
-    "publish:dry": "npm publish --dry-run",
-    "publish:live": "npm publish"
-  },
   "devDependencies": {
     "@biomejs/biome": "2.0.6",
     "@rslib/core": "0.17.0",
@@ -90,7 +73,26 @@
     "typescript": "^5.9.2",
     "vitest": "^2.1.8"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
     "@module-federation/enhanced": "0.18.3"
+  },
+  "scripts": {
+    "build": "rslib build",
+    "dev": "rslib build --watch",
+    "format": "biome format --write",
+    "check": "biome check --write",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "biome format ./src --write",
+    "release:prepare": "node scripts/generateReleasePr.mjs",
+    "release:finalize": "node scripts/finalizeRelease.mjs",
+    "release:patch": "pnpm release:prepare -t patch",
+    "release:minor": "pnpm release:prepare -t minor",
+    "release:major": "pnpm release:prepare -t major",
+    "publish:dry": "npm publish --dry-run",
+    "publish:live": "npm publish"
   }
-}
+}