@fulgurjs/federation 5.7.1 → 5.9.0

package/docs/webpack-mf-/345/257/271/347/205/247/344/270/216/347/274/272/345/217/243.md

@@ -1,37 +1,64 @@
-# webpack Module Federation 逐项对照与缺口清单（P1-3）
-
-> 基准：webpack 5 Module Federation（ModuleFederationPlugin）语义——逐项对照本插件的对应实现，并列出明确不支持的缺口。
-
-## 一、已实现（与 webpack MF 对齐）
-
-| 能力 | webpack MF | @fulgurjs/federation | 备注 |
-|------|-----------|--------------------|------|
-| exposes 远程模块 | ✅ | ✅ | 自动拆 chunk；dev 动态容器入口 |
-| remotes 消费 | ✅ | ✅ | 单地址 dev/prod 自动切换；`name@url` 键重命名；promise remote（运行时 registerRemote） |
-| shared 协商 | ✅ | ✅ | shareScope/版本排序/已加载优先 singleton；fallback 本地副本 |
-| singleton / requiredVersion / strictVersion / eager | ✅ | ✅ | eager 以静态导入形式进初始 chunk |
-| shareScope 多作用域 | ✅ | ✅ | |
-| 容器协议 init/shareScopeMap/get | ✅ | ✅ | 对齐 webpack 容器接口 |
-| 双向联邦/嵌套 | ✅ | ✅ | 跨源模块副本共享同一注册表（globalThis 单例） |
-| 错误码体系 | ❌（裸错误） | ✅ MFU-001~008 + 三段式修复建议 | 超出 webpack |
-| dev 双 server 协作（无打包 dev 容器） | ❌（webpack dev 也需构建） | ✅ | 超出 webpack |
-| UMD/CJS-only 依赖 shared 化 | ⚠️（需自己处理） | ✅ 预构建外部化 + build require 垫片 | 超出 webpack |
-| 稳定 remoteEntry 文件名 + manifest + preload | ⚠️ 部分 | ✅ | preloadRemote API |
-
-## 二、明确不支持（缺口清单）
-
-| 能力 | 状态 | 说明 |
-|------|------|------|
-| SSR | ❌ | 仅警告并禁用钩子；无 SSR 渲染计划 |
-| React/其他框架适配 | ❌ | 首发仅 Vue 3（shared 门面按 Vue 3 语义生成） |
-| 浏览器 DevTools 扩展 | ❌ | 提供 `window.__FULGURJS_SCOPE__ / __FULGURJS_INFO__` 调试面 |
-| share 的 `import: false`（仅提供不消费） | ✅ import:false 已支持 | 与 webpack `eager`/share 语义对齐 |
-| 运行时动态 remote 版本浮动（promise remote 的 shared 注入） | ⚠️ | promise remote 可注册，但其 shared 需自带 |
-| Node.js 环境（SSR/构建外运行时） | ❌ | 仅浏览器 |
-
-## 三、迁移指南速查（详见 docs/迁移指南.md）
-
-- webpack `remotes: 'app2@http://.../remoteEntry.js'` → `remotes: { app2: 'http://.../dist' }`（去 manifest/entry 后缀，dev/prod 自动拼）
-- `exposes` 相同；`shared` 相同字段；`eager` 相同
-- `loadRemote('app2/./Button')` → `loadRemote('app2/./Button')`（runtime API 同名）
-- iframe/qiankun 微前端 → exposes 页面 + 宿主路由表（见 testbed 迁移案例）；**子应用级跨框架嵌入已支持（5.3.0 `/bridge`，任务书对齐 Module Federation Bridge 的产品范围、API 为本插件自定契约）**——Vue 宿主嵌 React 子应用 / React 宿主嵌 Vue 子应用，`defineBridgeApp` + `createVueBridgeApp`/`createReactBridgeApp`，受控会话与首提交语义见 README §8.2；组件级混渲染仍不支持（webpack MF 同样不支持）
+# webpack Module Federation：当前能力与使用边界对照
+
+> 核对版本：`@fulgurjs/federation@5.7.1`（2026-10-03）。本页描述当前能力；早期任务书、设计方案及分版本验收报告保留历史记录，不作为当前支持范围。
+> 对照对象是 webpack 5 内置 `ModuleFederationPlugin`；Module Federation enhanced runtime、Bridge、DevTools 等独立生态工具不是 webpack 内置插件的同一功能面。本插件不承诺完整配置或产物互操作兼容。
+
+## 一、已经实现
+
+| 能力 | 本插件当前状态 | 使用说明 |
+|---|---|---|
+| exposes / remotes | 支持 | dev 容器直连；production 生成 ESM remoteEntry 与 manifest |
+| 动态远程 | 支持 | `registerRemote` / `registerRemotes`；promise remote 解析容器或地址 |
+| shared 版本协商 | 支持 | `requiredVersion`、singleton、strictVersion、eager、shareKey、多 shareScope；真实实例版本登记与并发保护 |
+| `shared.import: false` | 支持 | 纯消费，不提供本地 fallback；不能与 eager 同时使用 |
+| 双向联邦与嵌套容器 | 支持 | 各应用可同时提供和消费模块；这不等于自动代理任意层级的桥接路由 |
+| Vue 3 / React 18–19 | 支持浏览器客户端 | 各框架组件加载、页面适配器；纯 TS 模块可跨框架消费 |
+| Vue ↔ React 子应用桥接 | 支持 | `/bridge` 整站挂载/卸载、props/context、会话切换、错误占位 |
+| 子应用路由 ↔ 宿主 URL | 支持，显式启用 | `/bridge/router/vue`、`/bridge/router/react`；深链、刷新、push/replace、前进后退与导航取消；默认关闭 |
+| React 18/19 隔离共存 | 支持按作用域隔离 | 整组 React、renderer 和消费者使用相应 scope；跨树传普通 props/回调，不能混用 ReactElement/Context |
+| 运行时策略 | 支持 | `runtimePlugins`；HTML 入口/expose 执行前准备异步共享策略。无 HTML 的入口及启动后修改策略须先协商再导入新消费者 |
+| 加载恢复与诊断 | 支持 | 超时、重试、熔断、显式 fallback、错误码；静态依赖失败的恢复边界见 §三 |
+| 工程辅助 | 支持 | dts、manifest 预载、setup/onSession、CLI 检查与 Demo |
+
+入门步骤见 [中文 README](../README.md)、[英文 README](../README.en.md)；公开签名及默认值见 [中文 API 手册](API.md)、[English API reference](API.en.md)。版本隔离与恢复例子见 [examples/demos/react-versions](../examples/demos/react-versions/README.md)。
+
+## 二、当前不提供的能力
+
+| 能力 | 当前范围 | 与 webpack 的关系 |
+|---|---|---|
+| SSR / Node 服务端联邦、RSC、Next.js 全栈 | 不支持 | webpack 联邦概念支持 web/Node 等环境；不意味着自动获得完整 SSR/RSC 集成。本插件当前仅支持浏览器客户端 |
+| webpack `script` / `var` 容器互操作 | 不支持 | 本插件产出 ESM remote；不要因为都有 init/get 就直接混用两种产物。remoteType/library 已删除，传入报迁移错误 |
+| Vue/React 组件级直接混渲染 | 不提供转换层 | webpack 核心负责模块加载，不转换框架组件；本插件的子应用桥接允许两个框架各自管理组件树 |
+| JS 沙箱 / 自动 CSS 隔离 | 不提供 | 普通同页面联邦不会自动隔离全局变量、全局 CSS、Portal/Teleport 的容器外 DOM；需要额外隔离方案 |
+| 独立浏览器 DevTools 扩展 | 无 | 本插件提供 `window.__FULGURJS_SCOPE__ / __FULGURJS_INFO__`。其他联邦生态工具的扩展不能计为 webpack 内置能力 |
+| React 页面 KeepAlive | 不承诺 | 已下载模块可复用；组件状态保活需要应用或专门库实现 |
+| 其他框架与路由库的内置适配 | 无 | URL 同步内置 Vue Router / React Router data router；其他库可实现导航端口。多层桥接路由自动代理、跨窗口同步不在当前支持面 |
+
+## 三、使用限制与 webpack 的区别
+
+以下区分实例正确性、网络开销和失败恢复，不将“已测场景”扩大成所有工程保证。
+
+| 场景 | 本插件当前表现 | webpack 5 内置 MF 的对应表现 | 处理方法 |
+|---|---|---|---|
+| 共享库额外网络副本 | Vite 8 同步消费门面可能把未采用的本地副本也拉入模块图；已测双版本场景 ≤2 份。这不是所有应用图的数量上限；同 singleton scope 的实例身份仍统一 | 不是 webpack 的必然限制。异步 shared 可按协商结果加载；eager/fallback、未共享路径或不同 scope 也可能增加下载量，不能宣称 webpack 永远只下载一份 | 区分网络文件数与运行时实例数，按实际构建图评估；不要将本插件这项代价归为所有 MF 实现共有 |
+| dev 冷启动依赖优化重载 | Vite 新发现依赖时可能重新预构建并 full reload（DEV-010）；稳定态需等优化完成 | webpack dev 也有编译/HMR 等待，但没有同一套 Vite 依赖优化机制 | 排查冷/热态区别，按需配置预构建；这不是生产限制，也不是 webpack MF 的相同缺陷 |
+| expose 的静态 ESM 依赖下载失败 | 已缓存失败的依赖 URL 可能阻止同页恢复；只变换 expose 入口 URL 不会改写静态依赖 URL，提供用户主动刷新恢复 | 常见 script/JSONP chunk loader 失败后清掉该 chunk 的加载状态，后续请求可以重新加载；仍需调用方触发重试。404 旧产物、持续网络故障等不保证靠重试恢复；使用原生 ESM 路径时需单独评估 | 不笼统写“webpack 也只能刷新”。本插件控制的入口/动态加载边界可变换 URL；静态依赖失败仍保留刷新操作 |
+| React 与 renderer 不兼容或实例不一致 | React 18 的 renderer 不能因 singleton 协商就自动兼容 React 19。对齐版本，或分 scope 隔离整组依赖及消费者 | 同样受 React 的版本与实例要求约束；singleton 不会转换框架 ABI，strictVersion 可拒绝冲突 | 共享树使用兼容 React/renderer；不同大版本使用独立树和作用域，传普通数据/回调 |
+
+异步协商的启动时序同样需要关注：webpack 推荐异步 bootstrap 边界。本插件对 HTML 入口自动处理相关边界；自定义入口仍应先 `await loadShare`，再动态导入消费者。已经求值的静态绑定不能追溯替换。
+
+### 官方依据
+
+- [webpack 联邦概念与异步 bootstrap](https://webpack.js.org/concepts/module-federation/)：容器、shareScope、已加载实例、eager 下载代价及不同运行环境。
+- [webpack shared 配置](https://webpack.js.org/plugins/module-federation-plugin/)：singleton / requiredVersion / strictVersion / eager。
+- [webpack 5.102.1 JSONP chunk loader 源码](https://github.com/webpack/webpack/blob/v5.102.1/lib/web/JsonpChunkLoadingRuntimeModule.js)：失败时清除 installedChunks 状态。此结论针对该加载器，由源码推导，不代表所有加载器或任意故障都能自动恢复。
+- [HTML 标准：模块脚本加载](https://html.spec.whatwg.org/multipage/webappapis.html#fetch-a-single-module-script)：原生 ESM 的 module map 与失败记录。
+- [Vite 依赖预构建](https://vite.dev/guide/dep-pre-bundling)：新依赖触发重新优化及必要的页面重载。
+- [React 的版本与重复实例诊断](https://react.dev/warnings/invalid-hook-call-warning)：消费方与 renderer 必须使用一致的 React 模块实例。
+
+## 四、迁移入口
+
+- Vite 工程按 [README](../README.md) 配置 remotes/exposes/shared，不照搬已经删除的 webpack 配置字段。
+- 从 iframe/其他微前端方案迁移：先选择模块/页面加载或子应用桥接；需要地址恢复时显式开启 URL 同步。
+- React 18/19 同页运行：先运行 [版本隔离 Demo](../examples/demos/react-versions/README.md)，再按实际应用依赖图配置作用域。
+- 旧报告里的“React 未支持”“URL 同步待实现”“Vite 8 生产挂起未解”属于旧版本记录。当前补修证据见 [完整验收报告 §14](完整Demo展示与全面复测-验收报告-20261002.md#14-共享协商收尾与证据订正571)。

package/examples/README.md

@@ -1,69 +1,5 @@
-# fulgurjs-federation 示例总入口
+# 可复制模板
 
-选择你的框架，复制对应宿主与远程两个目录，`npm install` 后即可看到完整的模块联邦演示。四个工程互相独立：不依赖本仓库源码、monorepo workspace 或父目录 node_modules，插件依赖为 npm registry 精确正式包。
+本 npm 包附带五个完整模板，见 [模板指南](templates/README.md)。复制整个模板目录，在模板根执行 pnpm install --frozen-lockfile，再执行 pnpm dev。
 
-## Vue（宿主 5214 / 远程 5213）
-
-完整操作步骤见 **[vue/README.md](./vue/README.md)**。
-
-```bash
-cd examples/vue/remote && npm install && npm run dev   # 终端 1：vue-remote，http://localhost:5213
-cd examples/vue/host   && npm install && npm run dev   # 终端 2：vue-host，http://localhost:5214
-```
-
-## React（宿主 5204 / 远程 5203）
-
-完整操作步骤见 **[react/README.md](./react/README.md)**。
-
-```bash
-cd examples/react/remote && npm install && npm run dev   # 终端 1：react-remote，http://localhost:5203
-cd examples/react/host   && npm install && npm run dev   # 终端 2：react-host，http://localhost:5204
-```
-
-## 跨框架桥接（Vue 宿主 5314 × React 远程 5303；React 宿主 5304 × Vue 远程 5313）
-
-完整操作步骤见 **[bridge/README.md](./bridge/README.md)**。
-
-```bash
-# Vue 宿主 × React 子应用：终端 1 起子应用，终端 2 起宿主
-cd examples/bridge/react-remote && npm install && npm run dev   # 5303
-cd examples/bridge/vue-host     && npm install && npm run dev   # 5314
-
-# React 宿主 × Vue 子应用
-cd examples/bridge/vue-remote   && npm install && npm run dev   # 5313
-cd examples/bridge/react-host   && npm install && npm run dev   # 5304
-```
-
-## 每对示例演示什么
-
-- 远程可点击计数组件（本地状态在远程组件内，宿主页面直接操作）
-- 普通 TS 模块跨应用调用（宿主展示真实返回值）
-- 远程首页 + 带真实路由参数的详情页（深链刷新可恢复）
-- 宿主导航、路由级懒加载（首页不批量预取未访问的远程页面）
-- 插件默认加载/错误占位与恢复操作（**重试加载** 同页恢复；**刷新页面重试** 整页恢复）
-- 生产构建 + 最小 Nginx 部署（含 SPA fallback）
-
-## 目录
-
-```text
-examples/
-├── README.md / README.en.md   # 本入口（中/英）
-├── bridge/                    # 跨框架桥接（子应用级挂载/卸载，§8.2）
-│   ├── README.md              # 双向组合说明
-│   ├── vue-host/              # Vue 宿主 × React 子应用（5314）
-│   ├── react-remote/          # React 子应用（5303）
-│   ├── react-host/            # React 宿主 × Vue 子应用（5304）
-│   └── vue-remote/            # Vue 子应用（5313）
-├── vue/
-│   ├── README.md              # Vue 一对示例的组合说明
-│   ├── host/                  # Vue 宿主（vue-host，5214）
-│   └── remote/                # Vue 远程（vue-remote，5213）
-└── react/
-    ├── README.md              # React 一对示例的组合说明
-    ├── host/                  # React 宿主（react-host，5204）
-    └── remote/                # React 远程（react-remote，5203）
-```
-
-> `examples/` 面向使用者拷贝运行；仓库根的 `fixtures/` 是插件内部回归夹具（源码 link 到插件工作区），请勿当作使用模板。
-
-> 提示：复制后可在项目根目录运行 `npx fulgurjs explain`（纯本地、无网络）核对联邦配置摘要。
+功能演示、大型应用集成和展示门户见 [GitHub 统一示例入口](https://github.com/chenmingye/fulgurjs-federation/tree/master/examples)。

package/examples/templates/README.md

@@ -0,0 +1,88 @@
+# fulgurjs-federation 模板（examples/templates/）
+
+五个可独立复制、`pnpm install` 后直接运行的联邦接入模板。全部使用 **npm registry 正式包** `@fulgurjs/federation@5.8.0`（精确版本 + pnpm 锁文件），不依赖本仓库源码、workspace 或父目录。
+
+## 获取模板的两种方式
+
+```bash
+# 方式一（推荐）：CLI 创建——不需要 clone 本仓库
+npx @fulgurjs/federation create vue-vue --dir my-federation
+#   交互式：npx @fulgurjs/federation create
+#   模板清单：npx @fulgurjs/federation create --list
+
+# 方式二：从仓库复制（clone 或下载 ZIP 后）
+cp -r examples/templates/vue-vue /wherever/you/want && cd /wherever/you/want/vue-vue
+```
+
+`create` 复制完整模板并默认执行 `pnpm install --frozen-lockfile`；目标目录非空默认拒绝（`--force` 只增量复制，不删除已有文件）；安装失败非零退出并显示原因。它不做应用名称/端口改写——需要改端口时按下方清单手工同步。
+
+## 选择模板
+
+| 模板 | 组合 | 演示能力 | 复制范围 |
+|---|---|---|---|
+| [`vue-vue/`](vue-vue) | Vue 宿主 × Vue 远程 | 远程组件/TS 模块、路由懒加载、错误占位与重试、生产部署 | 整个 `vue-vue/` 目录 |
+| [`react-react/`](react-react) | React 宿主 × React 远程 | 同上（React 版：remoteComponent / useLoadRemote / ErrorBoundary） | 整个 `react-react/` 目录 |
+| [`vue-host-react-remote/`](vue-host-react-remote) | Vue 宿主 × React 子应用 | 跨框架完整子应用桥接（挂载/卸载/appProps 快照） | 整个 `vue-host-react-remote/` 目录 |
+| [`react-host-vue-remote/`](react-host-vue-remote) | React 宿主 × Vue 子应用 | 同上（反方向） | 整个 `react-host-vue-remote/` 目录 |
+| [`showcase/`](showcase) | Vue/React 双宿主 × Vue/React 双远程 | **完整演示**：双向跨框架桥接、URL 同步（深链刷新/前进后退）、多远程并存、同框架子应用对照 | 整个 `showcase/` 目录 |
+
+每个模板目录是一个完整 pnpm workspace（根 `package.json` + `pnpm-workspace.yaml` + `pnpm-lock.yaml`）。**必须复制整个模板目录**，不能只复制其中的子应用。
+
+## 最短运行路径
+
+环境要求：Node ≥ 20（实测 24.x）、pnpm ≥ 9。**推荐 pnpm ≥ 12**（锁文件由 pnpm 12 生成；9/10/11 亦可安装）。平台口径：macOS 与 Linux（CI）实测；启动器含 Windows 兜底路径但**未经验证**。
+
+> **pnpm 12 用户注意**：各模板 `pnpm-workspace.yaml` 已带 `allowBuilds: {esbuild: true, vue-demi: true}`（pnpm 12 的构建脚本批准形态；pnpm 9–11 忽略该键——esbuild ≥0.16 的二进制经 optionalDependencies 平台包分发，postinstall 仅做校验，不影响安装与运行）。若用 pnpm 10/11 且提示未批准构建脚本，可改回 `onlyBuiltDependencies: [esbuild, vue-demi]` 或按提示 `pnpm approve-builds`。**不要**让 pnpm 把 `allowBuilds: <pkg>: set this to true or false` 的占位提示留在 yaml 里——把值改成 `true` 即可通过（pnpm 12 会在遇到未决构建脚本时自动写入该提示行）。
+
+```bash
+# 以 vue-vue 为例；其余模板把目录名换掉即可
+pnpm install            # 安装（锁文件冻结：pnpm install --frozen-lockfile）
+pnpm dev                # 统一启动器：远程(5213) + 宿主(5214) 按顺序启动
+# 打开 http://localhost:5214 —— 远程按钮、TS 模块调用、路由懒加载、错误恢复演示
+```
+
+各模板端口（远程先于宿主启动）：
+
+| 模板 | 远程 | 宿主 |
+|---|---|---|
+| vue-vue | 5213 | 5214 |
+| react-react | 5203 | 5204 |
+| vue-host-react-remote | react-remote 5303 | vue-host 5314 |
+| react-host-vue-remote | vue-remote 5313 | react-host 5304 |
+| showcase | vue-remote 5335 / react-remote 5333 | vue-host 5334 / react-host 5336 |
+
+## 统一 dev 启动器（`pnpm dev`）的行为
+
+五个模板共用同一份启动脚本（模板内 `scripts/dev.mjs`，规范源在仓库 `examples/scripts/dev-runner.mjs`，`npm run test:examples` 校验一致）。行为：
+
+- **启动前端口预检**：任一端口被占用则拒绝启动（退出码 2），打印占用查看命令与处理方法；不会替你结束端口上的既有服务。
+- **按序启动、逐个探活**：远程先启动，就绪后再启动宿主；日志带 `[应用名]` 前缀。
+- **失败整组退出**：任一应用启动失败/超时/运行中退出，停止本次启动的全部进程（退出码 1）并打印该应用日志尾部；不留下半残组合。
+- **Ctrl+C / SIGTERM 清理**：只清理本次启动的子进程（进程组级），不依赖 PID 文件，不按端口批量杀进程。
+- 单独调试某个应用：`pnpm run dev:remote` / `pnpm run dev:host`（showcase 有四个 `dev:*` 入口），绕过启动器直接启动。
+- 「dev server 已监听」表示端口就绪；页面可用以浏览器实际加载为准。
+
+## 改端口的固定清单
+
+模板不做端口/名称自动改写；需要改时同步以下三处（以 vue-vue 的远程 5213 为例）：
+
+1. `remote/package.json` 的 `dev` 与 `preview` 脚本里的 `--port 5213`；
+2. `host/fulgurjs.config.ts` 中 `remotes['vue-remote'].dev` 的 `http://localhost:5213`；
+3. （可选）根 `scripts/dev.config.json` 里该应用的 `port`，保持启动器/文档/场景表一致。
+
+宿主自身端口在 `host/package.json` 的 dev/preview 脚本。跨应用容器名（如 `vue-remote`）改名时，还需同步宿主代码中的 spec 前缀（`vue-remote/...`）与页面表——不建议改名。
+
+## 生产构建与部署
+
+`pnpm build` 后产物为标准 Vite dist，远程会多生成 `fulgurjs-remoteEntry.js` 与 `fulgurjs-manifest.json`，用 no-cache 规则部署，SPA fallback 配置见 [Vue 模板部署说明](vue-vue/README.md#生产构建与最小-nginx-部署)。部署后可用 `npx fulgurjs doctor --base <站点> --apps <部署子目录>` 体检（`--apps` 是部署子目录，不是容器名）。
+
+## 模板覆盖的能力 → 去哪看
+
+- **组件/模块加载、错误占位、重试恢复**：Vue/Vue 与 React/React 模板首页即演示。
+- **跨框架完整子应用挂载/卸载、appProps 快照、会话切换**：两个桥接模板。
+- **URL 同步（子应用内部路由 ↔ 宿主地址、刷新直达、前进后退、多层嵌套）**：showcase，宿主页 URL 变化随子应用导航联动。
+- **shared 共享协商、React 18/19 隔离、页面接入（createHostPages）、错误注入与恢复、Jeecg 三层嵌套**：不在模板内重复造码，直接用[统一示例入口](../README.md) 中的对应场景（`examples/demos/shared`、`examples/demos/react-versions`、`examples/demos/pages-cli`、`examples/demos/errors`、`examples/integrations/jeecg`），同样可独立下载运行（见 [功能演示说明](https://github.com/chenmingye/fulgurjs-federation/tree/master/examples/demos)）。
+
+## 与展示门户的关系
+
+这五个模板也是门户的基础场景工程。门户通过 `examples/scenarios.json` 直接启动本目录里的宿主与远程，不维护另一份基础源码。功能演示在 [demos/](https://github.com/chenmingye/fulgurjs-federation/tree/master/examples/demos)，大型集成在 [integrations/](https://github.com/chenmingye/fulgurjs-federation/tree/master/examples/integrations)。

package/examples/templates/react-host-vue-remote/README.md

@@ -0,0 +1,18 @@
+# react-host-vue-remote：完整子应用桥接模板
+
+`react-host/` 是宿主，`vue-remote/` 是子应用。复制整个模板目录，在根目录运行：
+
+```bash
+pnpm install --frozen-lockfile
+pnpm dev
+# http://localhost:5304
+```
+
+宿主展示远程应用、上下文传递与会话切换；切换用户或登出会卸载旧代次。远程独立运行与被嵌入时使用不同路由接线。
+
+- 单独启动：`pnpm dev:remote`、`pnpm dev:host`。
+- 生产构建：`pnpm build`，按各子应用配置的 base 部署 dist；远程入口与宿主的 prod 地址必须一致。各子应用 README 提供配置与部署细节。
+- 本模板展示挂载、卸载与会话，不开启宿主/子应用 URL 同步；需要深链、刷新和前进后退，使用 [showcase](../showcase/)。
+- 无 JS 沙箱或自动 CSS 隔离，子应用全局样式和 body 副作用需要自行管理。
+
+环境要求见[模板指南](../README.md)。所有依赖来自 registry，不需要本仓库源码或其他模板。

package/examples/templates/react-host-vue-remote/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "fulgurjs-template-react-host-vue-remote",
+  "private": true,
+  "version": "0.0.0",
+  "scripts": {
+    "dev:remote": "pnpm --dir vue-remote dev",
+    "dev:host": "pnpm --dir react-host dev",
+    "dev": "node scripts/dev.mjs",
+    "build": "pnpm --dir vue-remote build && pnpm --dir react-host build"
+  }
+}