@fulgurjs/federation 0.4.2 → 0.5.1

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 0.5.1（2026-09-19）
+
+### 修复
+
+- **宿主页面「虚拟运行时导入 + 远程动态导入」混用漏改写（真实 npm 用户验证轮发现）**：post 阶段防双重生成守卫原先按「代码含 `virtual:fulgurjs-runtime` 字样」一刀切跳过，导致同一文件里合法导入 `loadRemote`（README §2 标准用法）后再写 `import('remote-a/X')`（README §1 标准用法）时远程导入漏改写，dev 下 vite:import-analysis 直接 500。现改为按插件生成物特征精确判定（代理化导入 `virtual:fulgurjs-runtime-proxy` / 改写助手 `__fulgurjs_loadRemote`·`__fulgurjs_loadShare` / 构建入口注入标识 `/* fulgurjs:init */`），用户混用照常工作；补 4 组单测（157/157）。
+
+### 变更（发布面）
+
+- **README 双端导航统一**：README 内 8 处文档相对链接（manual.html×4 / 迁移指南 / webpack MF 对照 / 沙箱边界审计 / DESIGN）改为 GitHub 绝对 URL——npm 页面与 GitHub 点击行为一致（npm 不解析包内相对链接，此前在 npm 上全部 404）。
+
+## 0.5.0（2026-09-19）
+
+### 变更（品牌全面对齐，breaking）
+
+- 全品牌从 `fulgur` 对齐为 **`fulgurjs`**（npm 上 fulgur 组织名被占用）：
+  - CLI 命令：`fulgur` → **`fulgurjs`**（`npx fulgurjs init` / `npx fulgurjs doctor`）
+  - 虚拟模块：`virtual:fulgur-runtime` → **`virtual:fulgurjs-runtime`**（代理模块同步更名）
+  - 全局单例：`__FULGUR_RUNTIME__` → **`__FULGURJS_RUNTIME__`**（`__FULGURJS_APP_CONFIG__` / `__FULGURJS_SCOPE__` / `__FULGURJS_INFO__` 同步）
+  - 产物文件名：`fulgur-remoteEntry.js` / `fulgur-manifest.json` → **`fulgurjs-remoteEntry.js`** / **`fulgurjs-manifest.json`**（NGINX 规则同步更名）
+  - 配置文件：`fulgur.config.ts` → **`fulgurjs.config.ts`**；错误前缀 `[fulgur:*]` → `[fulgurjs:*]`；运行时事件 `fulgur:error` → `fulgurjs:error`
+  - GitHub 仓库：**fulgurjs-federation**（旧地址自动重定向）
+- 升级方式：0.4.x 用户全局替换 `fulgur` → `fulgurjs`（导入/全局名/NGINX 文件名/CLI 命令）即可。
+
 ## 0.4.2（2026-09-19）
 
 ### 修复（npm 发布面）
@@ -13,7 +36,7 @@
 
 ### 变更（规则自动化）
 
-- **任何文件都可以直接 `import { ... } from 'virtual:fulgur-runtime'`**（原 DEV-008 规则自动化）：
+- **任何文件都可以直接 `import { ... } from 'virtual:fulgurjs-runtime'`**（原 DEV-008 规则自动化）：
   exposes 目标文件（远程页面）里的静态导入，dev 下由插件自动改写为惰性单例委托模块
   （求值期零副作用、调用期转发页面级运行时单例）。用户不再需要知道
   「宿主/远程页面取运行时的不同姿势」，0.4.0 的手工 globalThis 写法已无需使用。
@@ -22,22 +45,22 @@
 
 ### 修复
 
-- runtime 两个存量 TS 断言错误（as Error → as FulgurError）与 fallback 源码契约断言同步。
+- runtime 两个存量 TS 断言错误（as Error → as FulgurjsError）与 fallback 源码契约断言同步。
 
 ## 0.4.0（2026-09-18）
 
 开箱即用批次（A→E）全部落地；W7 发布链按用户指示顺延（未发布 npm）。
 
 ### 新增
-- **CLI（主包内置 bin `fulgur`）**
-  - `fulgur init`：起步模板（带注释的 `fulgur.config.ts`：宿主/远程/页面路由表/部署形态，
+- **CLI（主包内置 bin `fulgurjs`）**
+  - `fulgurjs init`：起步模板（带注释的 `fulgurjs.config.ts`：宿主/远程/页面路由表/部署形态，
     单文件可入库可复跑）+ 配置校验（CFG 三段式报错）+ 输出可直接粘贴的样板
     （各应用 federation() vite 块、NGINX no-cache 站点模板、通用接入核对清单）；
     **项目无关**——不内置任何具体项目的模板、锚点或文件改写
-  - `fulgur doctor`：部署面体检——remoteEntry/manifest/index.html 的 200/no-cache/JS 形态、
+  - `fulgurjs doctor`：部署面体检——remoteEntry/manifest/index.html 的 200/no-cache/JS 形态、
     CORS、chunk 抽样可达（含 index.html 引用与一跳下钻、200-HTML 回退伪装识别）、
     版本协商 skew 预演、`--dev` 模式端口/容器入口探测；`--json` 供 CI
-- **W4 跨应用全局配置协商**：runtime 新增 `provideFulgurAppConfig` / `getFulgurAppConfig`
+- **W4 跨应用全局配置协商**：runtime 新增 `provideFulgurjsAppConfig` / `getFulgurjsAppConfig`
   （页面级单例、浅合并、globalThis 镜像）——EP locale/size 类跨副本配置的机制化收编
 - **W5 诊断补码**：CFG-007（remotes 对象形式误用 name@ 前缀）、CFG-008（shared 非法组合）、
   DEV-010（dev 冷启动预构建窗口提示）；BLD-003 必填 props 扫描器（按实测降级为手册核对项）
@@ -51,6 +74,6 @@
 
 ### 变更
 - **插件去项目化（2026-09-19 定调）**：移除 init 中曾内置的具体项目集成模板/锚点/补丁
-  （历史实现见 git 历史）；`fulgur init` 重写为纯通用脚手架，配置 schema 同步精简。
+  （历史实现见 git 历史）；`fulgurjs init` 重写为纯通用脚手架，配置 schema 同步精简。
   插件为所有项目服务，不做任何单一项目的形状。
 - runtime gzip 5212 B（红线 ≤5250 内）；单测 148/148；错误码 30 个全量文档对齐

package/DESIGN.md

@@ -1,8 +1,8 @@
 # @fulgurjs/federation 设计方案 v0.2（全量对齐 Webpack MF 版）
 
-> **品牌**：fulgur，拉丁语「闪电 · 辉光」，取自作者名中「烨」字的意译。
+> **品牌**：fulgurjs，拉丁语「闪电 · 辉光」，取自作者名中「烨」字的意译。
 > 系列规划：`@fulgurjs/federation`（模块联邦）→ `@fulgurjs/micro`、`@fulgurjs/dts` …
-> 内外命名统一 `fulgur`（`virtual:fulgur-*` 虚拟模块、`window.__FULGUR_*` 调试出口、`FulgurError` / MFU 错误码）。
+> 内外命名统一 `fulgurjs`（`virtual:fulgurjs-*` 虚拟模块、`window.__FULGURJS_*` 调试出口、`FulgurjsError` / MFU 错误码）。
 
 > 状态：已实现并验证（2026-09-13）。测试结果：单测 76/76、fixtures dev e2e 10/10、容错/HMR-L3 2/2、fixtures prod e2e 8/8（隔离 NGINX 8999）、testbed dev 实测全通、testbed prod（本地 NGINX 测试站点）最小宿主消费真实远程产物实测通过；runtime gzip 4.4KB。已知问题见手册 §7。
 > 日期：2026-09-12
@@ -30,7 +30,7 @@
 
 ### 2A. 核心配置（webpack 官方文档全部选项）
 
-| # | webpack 选项 | fulgur | 实现方式与语义说明 |
+| # | webpack 选项 | fulgurjs | 实现方式与语义说明 |
 |---|---|---|---|
 | 1 | `name` | ✅ | 容器名；同时作为 uniqueName 决胜来源。重名冲突构建期检测并警告（对齐 webpack 对 `output.uniqueName` 的要求） |
 | 2 | `filename` | ✅ | remoteEntry 文件名，稳定命名，利于 CDN 长缓存 |
@@ -50,7 +50,7 @@
 
 ### 2B. 运行时行为语义（"效果一模一样"的实体，逐条 e2e 验收）
 
-| # | webpack 行为 | fulgur 验收语义 |
+| # | webpack 行为 | fulgurjs 验收语义 |
 |---|---|---|
 | 1 | 版本协商：消费方拿到 scope 中**满足其 requiredVersion 的最高版本** | e2e 断言双版本场景加载的是高版本 |
 | 2 | 多版本共存（非 singleton、不同 requiredVersion 可并存） | e2e 断言两版本模块图并存且各自正常 |
@@ -69,11 +69,11 @@
 | 15 | 静态 remote 自动加载；加载失败 → 等价 `ScriptExternalLoadError` 的统一错误码（MFU-0xx 体系） | e2e：kill remote 断言错误码 + UI 错误边界 |
 | 16 | `import('app1/Button')` 语法 + default/named unwrap 语义 | 所有用例的基础断言 |
 | 17 | exposed 模块的样式自动随模块注入（dev / prod 都生效） | e2e：远程组件样式生效断言 |
-| 18 | 异步边界：fulgur **自动注入**（等效 `automaticAsyncBoundary: true` 默认开启），用户不需要 webpack 的 bootstrap.js 手工模式；提供开关可关 | e2e：不写 bootstrap 直接跑通 |
+| 18 | 异步边界：fulgurjs **自动注入**（等效 `automaticAsyncBoundary: true` 默认开启），用户不需要 webpack 的 bootstrap.js 手工模式；提供开关可关 | e2e：不写 bootstrap 直接跑通 |
 
 ### 2C. MF 2.0 / @module-federation/enhanced 配置
 
-| # | 选项 | fulgur | 说明 |
+| # | 选项 | fulgurjs | 说明 |
 |---|---|---|---|
 | 1 | `manifest` | ✅ | `mf-manifest.json`（资源清单 + 版本 + 公共路径），部署回滚 = 切 manifest 指针 |
 | 2 | `runtimePlugins` | ✅ | runtime 钩子 API（init / get / loadShare 前后钩子） |
@@ -84,7 +84,7 @@
 
 ## 3. 比 webpack 更进一步的点
 
-1. **自动异步边界**——webpack 要求手工 `import('./bootstrap')`，fulgur 自动注入，配置零改动
+1. **自动异步边界**——webpack 要求手工 `import('./bootstrap')`，fulgurjs 自动注入，配置零改动
 2. **类型直连**——dev 下 remote 的补全与跳转是真源码级（webpack 需要额外 dts 工具链折腾）
 3. **runtime 内核 gzip < 5KB**（CI 硬指标，对比 @module-federation/runtime 的 40KB+）
 4. **一套配置 dev/prod 自动切换**——webpack 的 dev/prod 配置经常分裂两份
@@ -92,7 +92,7 @@
 
 ## 4. HMR 对齐承诺（dev 体验）
 
-webpack 里 remote 模块 HMR 天然可用（同一构建系统）。fulgur 通过 host↔remote 双 dev-server HMR 桥对齐，分三档自动化验收：
+webpack 里 remote 模块 HMR 天然可用（同一构建系统）。fulgurjs 通过 host↔remote 双 dev-server HMR 桥对齐，分三档自动化验收：
 
 - L1 组件热替换成功（页面不整页刷新）
 - L2 状态保留（组件热替换后 local state 不丢，对齐 vue HMR 行为）

package/README.md

@@ -1,6 +1,6 @@
 # @fulgurjs/federation
 
-> **fulgur** — 拉丁语「闪电 · 辉光」。
+> **fulgurjs** — 拉丁语「闪电 · 辉光」。
 > 一个把 Vite 模块联邦做到开箱即用的插件：**一套配置，dev / prod 双引擎，语义对齐 Webpack Module Federation**。
 
 ![tests](https://img.shields.io/badge/tests-148%20%2B%20e2e-green) ![runtime](https://img.shields.io/badge/runtime%20gzip-%3C%205KB-blue) ![vite](https://img.shields.io/badge/vite-5%20%7C%206%20%7C%207%20%7C%208-purple)
@@ -26,13 +26,13 @@
 - **exposes / remotes / shared 全语义**：`name@url` 语法、键重命名、promise-based remote、semver 全语法 requiredVersion、版本协商（最高版本胜出）、singleton / strictVersion、已加载版本永不替换、多版本共存、shareKey 重定向、多 shareScope
 - **UMD / CJS-only 依赖开箱即用**：element-plus、avue 等只有 UMD/CJS 产物的依赖直接进 `optimizeDeps.include` 即可——dev 期插件自动把预构建产物内的 shared 键改道协商门面；build 期自动把 CJS `require(<shared>)` 重定向到垫片，双运行时免疫
 - **自动异步边界**：top-level await 自动注入（es2022+），无需 webpack 式手工 `import('./bootstrap')`
-- **稳定产物**：remoteEntry 固定文件名利于 CDN 长缓存；`fulgur-manifest.json` 资源清单；expose 独立 chunk
+- **稳定产物**：remoteEntry 固定文件名利于 CDN 长缓存；`fulgurjs-manifest.json` 资源清单；expose 独立 chunk
 - **容错（对齐 webpack MF 2.0 errorLoadRemote）**：加载重试 / 熔断 / 超时内置；`loadRemote(spec, { retries, fallbackModule })` 单次调用级覆盖——失败时返回 fallback 模块，错误事件仍显式发出（**绝不静默兜底**，不传则照旧抛错）
 - **增强能力**：dts 类型直连（dev 补全直达 remote 源码）、`preloadRemote()` manifest 驱动精确预载、runtimePlugins 钩子
 - **HMR 全链路**：remote 改动 → host 页面热更，L1 组件热替换 / L2 状态保留 / L3 错误覆盖与恢复
 - **零报错纪律**：配置问题启动瞬间三段式报错；联邦失败显式抛错（错误码 + 可执行修复建议），**无任何静默兜底路径**
-- **CLI（主包内置 bin）**：`fulgur init`——`fulgur.config.ts` 单配置驱动的迁移生成器（模板 = 真实工程验证形态：vite 配置/路由表/桥/联邦启动器/NGINX conf 全量编码，锚点补丁幂等可续跑）；`fulgur doctor`——部署面体检（remoteEntry/manifest/HTML 缓存头与形态、CORS、chunk 抽样可达、版本 skew 预演、`--dev` 端口探测）
-- **跨应用全局配置协商（W4）**：`provideFulgurAppConfig({ locale, size, ... })` 一次写入运行时页面级单例，各远程副本经 `getFulgurAppConfig()` 消费注入（EP locale/size 类问题的机制化收编）
+- **CLI（主包内置 bin）**：`fulgurjs init`——`fulgurjs.config.ts` 单配置驱动的迁移生成器（模板 = 真实工程验证形态：vite 配置/路由表/桥/联邦启动器/NGINX conf 全量编码，锚点补丁幂等可续跑）；`fulgurjs doctor`——部署面体检（remoteEntry/manifest/HTML 缓存头与形态、CORS、chunk 抽样可达、版本 skew 预演、`--dev` 端口探测）
+- **跨应用全局配置协商（W4）**：`provideFulgurjsAppConfig({ locale, size, ... })` 一次写入运行时页面级单例，各远程副本经 `getFulgurjsAppConfig()` 消费注入（EP locale/size 类问题的机制化收编）
 - **全链路错误码体系（30 码）**：CFG/DEV/BLD/MFU 四段 + 手册 §8 码表防漂移校验
 
 ## 安装
@@ -97,7 +97,7 @@ export default defineConfig({
 import Button from 'remote-a/Button'
 
 // 动态导入 / 运行时 API
-import { loadRemote, registerRemote, preloadRemote } from 'virtual:fulgur-runtime'
+import { loadRemote, registerRemote, preloadRemote } from 'virtual:fulgurjs-runtime'
 
 const Chart = defineAsyncComponent(() => loadRemote('remote-a/Chart').then(m => m.default))
 
@@ -114,26 +114,26 @@ const Panel = await loadRemote('shop/Panel', {
 ```
 
 > **在任何文件都可以直接这样导入**——包括 exposes 目标文件（远程页面）。插件会自动把远程页面里的
-> 该导入改写为惰性单例委托（0.4.1 起，原 0.4.0 要求手工改用 `globalThis.__FULGUR_RUNTIME__` 的规则已废除），
+> 该导入改写为惰性单例委托（0.4.1 起，原 0.4.0 要求手工改用 `globalThis.__FULGURJS_RUNTIME__` 的规则已废除），
 > 求值期零副作用、调用期自动转发页面级运行时单例，无需关心宿主/远程的区别。
 
 > 以上只是最小面。**全部选项（remotes 四形态/shared 九个开关/dts/runtimePlugins…）、运行时 API、CLI、错误码见下方 [API 参考](#api-参考)。**
 
-**没有别的步骤了。** dev 下 remote 跑它自己的 `vite dev`（容器入口 `/@fulgur-entry.js` 由插件中间件直出）；build 下 expose 自动拆独立 chunk、shared 自动剥离——同一份配置两端通用。
+**没有别的步骤了。** dev 下 remote 跑它自己的 `vite dev`（容器入口 `/@fulgurjs-entry.js` 由插件中间件直出）；build 下 expose 自动拆独立 chunk、shared 自动剥离——同一份配置两端通用。
 
 ## CLI：init 起步模板 + doctor 部署体检
 
 ```bash
-# 1) 生成带注释的 fulgur.config.ts 起步模板（宿主/远程/页面路由表/部署形态，单文件可入库）
-npx fulgur init                                # 已存在则拒绝，--force 覆盖
-# 样例：examples/fulgur.config.example.ts（通用字段示例）
+# 1) 生成带注释的 fulgurjs.config.ts 起步模板（宿主/远程/页面路由表/部署形态，单文件可入库）
+npx fulgurjs init                                # 已存在则拒绝，--force 覆盖
+# 样例：examples/fulgurjs.config.example.ts（通用字段示例）
 
 # 2) 校验配置并输出可直接粘贴的样板：各应用 federation() 块、NGINX no-cache 站点模板、接入核对清单
-npx fulgur init --config fulgur.config.ts
+npx fulgurjs init --config fulgurjs.config.ts
 
 # 3) 部署体检（CI 可嵌）：缓存头/资源形态/CORS/chunk 可达/版本 skew
-npx fulgur doctor --base http://your-site --apps app-a,app-b
-npx fulgur doctor --base http://localhost:5173 --apps app-a --dev
+npx fulgurjs doctor --base http://your-site --apps app-a,app-b
+npx fulgurjs doctor --base http://localhost:5173 --apps app-a --dev
 ```
 
 **插件保持项目无关**：init 不改写任何项目文件，不内置任何具体项目的模板或补丁；权限路由、
@@ -141,7 +141,7 @@ npx fulgur doctor --base http://localhost:5173 --apps app-a --dev
 
 ## API 参考
 
-以下覆盖插件的全部公开 API，签名与默认值与源码一致；完整语义细节与实测截图见 [`docs/manual.html`](./docs/manual.html)。
+以下覆盖插件的全部公开 API，签名与默认值与源码一致；完整语义细节与实测截图见 [`docs/manual.html`](https://github.com/chenmingye/fulgurjs-federation/blob/master/docs/manual.html)。
 
 ### 1. `federation(options)` — Vite 插件（宿主/远程同一份 API）
 
@@ -154,7 +154,7 @@ import { federation } from '@fulgurjs/federation'
 | 选项 | 类型 | 默认 | 说明 |
 |---|---|---|---|
 | `name` | `string` **必填** | — | 容器名。同页面宿主/远程必须唯一（也是 uniqueName）；须匹配 `/^[a-zA-Z][\w.-]*$/` |
-| `filename` | `string` | `'fulgur-remoteEntry.js'` | prod 容器入口文件名（固定文件名，CDN 可长缓存） |
+| `filename` | `string` | `'fulgurjs-remoteEntry.js'` | prod 容器入口文件名（固定文件名，CDN 可长缓存） |
 | `exposes` | `Record<string, string \| { import: string; name?: string }>` | — | 对外暴露模块：键 `'./X'`，值源文件路径；`name` 为稳定 chunk 文件名 |
 | `remotes` | `Record<string, string \| RemoteConfig \| (() => Promise<any>)>` | — | 消费的远程，三种形态见下表 |
 | `shared` | `string[] \| Record<string, string \| SharedHint>` | — | 共享依赖；字符串简写 = requiredVersion（缺省从本应用 package.json 推断） |
@@ -163,7 +163,7 @@ import { federation } from '@fulgurjs/federation'
 | `library` | `{ type?: string }` | — | 仅接受 esm/module（webpack 宿主 interop 尚未支持，告警） |
 | `runtime` | `string \| false` | 内置运行时 | 自定义运行时模块路径；`false` 禁用内置运行时 |
 | `runtimeChunk` | `boolean \| 'single'` | — | 运行时是否拆独立 chunk |
-| `manifest` | `boolean` | `true` | prod 构建生成 `fulgur-manifest.json`（preloadRemote 依赖它） |
+| `manifest` | `boolean` | `true` | prod 构建生成 `fulgurjs-manifest.json`（preloadRemote 依赖它） |
 | `runtimePlugins` | `string[]` | `[]` | 运行时插件模块路径列表（写法见「运行时插件」） |
 | `dts` | `boolean \| { dir?: string }` | `true` | dev 下拉取远程 manifest 生成类型声明——宿主写 `import X from 'remote-a/X'` 补全直达远程源码 |
 | `devSharedSelf` | `boolean` | 纯远程 `true`；有 `remotes` 的宿主 `false` | dev 下自身源码（含依赖）是否参与 shared 协商改写。**双向联邦**（既 expose 又消费 remote）的宿主/远程需显式 `true`，否则 prod 双 vue 实例 |
@@ -175,7 +175,7 @@ import { federation } from '@fulgurjs/federation'
 
 ```ts
 remotes: {
-  // ① 字符串单地址：dev 自动拼 /@fulgur-entry.js，prod 自动拼 filename
+  // ① 字符串单地址：dev 自动拼 /@fulgurjs-entry.js，prod 自动拼 filename
   'remote-a': 'http://localhost:5101',
   // ② '自报名@url'：重命名语义（仅字符串形式支持；对象形式不支持 name@，配置期即报 CFG-007）
   'checkout': 'shop@http://localhost:5102',
@@ -217,16 +217,16 @@ shared: {
 
 版本裁决语义对齐 webpack：满足 requiredVersion 的最高版本胜出；已加载版本永不替换；singleton 收敛到唯一实例（skew 告警 MFU-010）；strictVersion 不满足抛 MFU-003。
 
-### 2. 运行时 API — `virtual:fulgur-runtime`
+### 2. 运行时 API — `virtual:fulgurjs-runtime`
 
 **任何文件都直接静态导入**——宿主页面、exposes 目标文件（远程页面）都一样，插件自动保证同一页面只有一个运行时实例（远程页面里的导入会被自动改写为惰性单例委托，0.4.1 起）：
 
 ```ts
 // 宿主页面、远程页面，写法完全一致
-import { loadRemote, provideFulgurAppConfig } from 'virtual:fulgur-runtime'
+import { loadRemote, provideFulgurjsAppConfig } from 'virtual:fulgurjs-runtime'
 ```
 
-> 仍可绕过代理直取全局单例（等价，调试用）：`(globalThis as any).__FULGUR_RUNTIME__`。
+> 仍可绕过代理直取全局单例（等价，调试用）：`(globalThis as any).__FULGURJS_RUNTIME__`。
 
 #### 函数总表
 
@@ -240,9 +240,9 @@ import { loadRemote, provideFulgurAppConfig } from 'virtual:fulgur-runtime'
 | `registerShare` | `(scope, name, version, get, opts?) => void` | 手工注册共享模块（一般由 init 模块自动完成） |
 | `initSharing` | `(scopeName?) => ShareScopeMap` | 初始化共享作用域（一般由 init 模块自动完成） |
 | `registerPlugins` | `(plugins: RuntimePlugin[]) => void` | 注册运行时插件（见下） |
-| `provideFulgurAppConfig` | `(config: Record<string, any>) => void` | **跨应用全局配置写入**（宿主桥一次写入；浅合并；镜像到 `globalThis.__FULGUR_APP_CONFIG__`） |
-| `getFulgurAppConfig` | `() => Record<string, any>` | 读取全局配置（远程 federatedBoot 消费注入 locale/size 等） |
-| `getRuntime` | `() => FulgurRuntime` | 取运行时单例本体（与 `__FULGUR_RUNTIME__` 同一实例） |
+| `provideFulgurjsAppConfig` | `(config: Record<string, any>) => void` | **跨应用全局配置写入**（宿主桥一次写入；浅合并；镜像到 `globalThis.__FULGURJS_APP_CONFIG__`） |
+| `getFulgurjsAppConfig` | `() => Record<string, any>` | 读取全局配置（远程 federatedBoot 消费注入 locale/size 等） |
+| `getRuntime` | `() => FulgurjsRuntime` | 取运行时单例本体（与 `__FULGURJS_RUNTIME__` 同一实例） |
 | `version` | `string` | 运行时/插件版本（跨源副本一致性诊断用） |
 | `unwrapDefault` | `(ns: any) => any` | ESM/CJS default interop 工具 |
 
@@ -257,10 +257,10 @@ const Panel = await loadRemote('shop/Panel', {
 })
 ```
 
-#### 运行时插件（`runtimePlugins: ['./src/fulgurPlugin.ts']`）
+#### 运行时插件（`runtimePlugins: ['./src/fulgurjsPlugin.ts']`）
 
 ```ts
-import type { RuntimePlugin } from 'virtual:fulgur-runtime'
+import type { RuntimePlugin } from 'virtual:fulgurjs-runtime'
 
 export default {
   name: 'my-plugin',
@@ -279,20 +279,20 @@ export default {
 
 | 出口 | 内容 |
 |---|---|
-| `window.__FULGUR_SCOPE__` | share scope 实时协商结果（键 → 版本 → `{ get, from, loaded }`） |
-| `window.__FULGUR_INFO__` | `{ remotes: { [名]: { entry, status, lastLoadMs, error } }, errors: [] }` |
-| `window.__FULGUR_APP_CONFIG__` | W4 全局配置镜像 |
-| `window` 事件 `fulgur:error` | `CustomEvent<{ remote, error }>`，所有远程加载/共享错误都会发出 |
+| `window.__FULGURJS_SCOPE__` | share scope 实时协商结果（键 → 版本 → `{ get, from, loaded }`） |
+| `window.__FULGURJS_INFO__` | `{ remotes: { [名]: { entry, status, lastLoadMs, error } }, errors: [] }` |
+| `window.__FULGURJS_APP_CONFIG__` | W4 全局配置镜像 |
+| `window` 事件 `fulgurjs:error` | `CustomEvent<{ remote, error }>`，所有远程加载/共享错误都会发出 |
 
-### 3. `defineFulgurPages` — 宿主页面路由表（`@fulgurjs/federation/pages`）
+### 3. `defineFulgurjsPages` — 宿主页面路由表（`@fulgurjs/federation/pages`）
 
 宿主把「URL 路径 → 远程 exposes 键」的映射表交给它校验，带参路由的静默冲突在启动期报错而不是运行时加载错组件：
 
 ```ts
-import { defineFulgurPages } from '@fulgurjs/federation/pages'
-import remoteSchema from 'virtual:fulgur-remote-schema' // dev 自动生成；build 恒为空（诚实降级）
+import { defineFulgurjsPages } from '@fulgurjs/federation/pages'
+import remoteSchema from 'virtual:fulgurjs-remote-schema' // dev 自动生成；build 恒为空（诚实降级）
 
-export const PAGES = defineFulgurPages(
+export const PAGES = defineFulgurjsPages(
   [
     { route: '/remote-a/home', name: 'RemoteAHome', title: '首页' },
     // 带参路由：缺省推导 spec = 去首段 + 剥 :参 段；与其它条目冲突时 ERROR，
@@ -318,14 +318,14 @@ export const PAGES = defineFulgurPages(
 | R4 | ERROR | 静态路由被更靠前的带参路由遮蔽（先到先得）／路由完全重复 |
 | R5 | WARN | name 重复（vue-router 命名跳转歧义） |
 
-`validateFulgurPages(pages, options)` 为独立导出：返回违例清单不抛错，便于自测。
+`validateFulgurjsPages(pages, options)` 为独立导出：返回违例清单不抛错，便于自测。
 
-### 4. `fulgur.config.ts` — CLI 单配置文件（`@fulgurjs/federation/config`）
+### 4. `fulgurjs.config.ts` — CLI 单配置文件（`@fulgurjs/federation/config`）
 
 ```ts
-import { defineFulgurConfig } from '@fulgurjs/federation/config'
+import { defineFulgurjsConfig } from '@fulgurjs/federation/config'
 
-export default defineFulgurConfig({
+export default defineFulgurjsConfig({
   root: process.cwd(),            // 工程根（monorepo 根或单应用仓库根）
   apps: [
     {
@@ -354,9 +354,9 @@ export default defineFulgurConfig({
 
 | 命令 | 说明 |
 |---|---|
-| `fulgur init` | 在当前目录生成带注释的 `fulgur.config.ts` 起步模板；`--template <path>` 指定输出路径；已存在拒绝覆盖，`--force` 强制 |
-| `fulgur init --config <path>` | 校验配置（CFG 三段式报错）+ 输出各应用 `federation()` 粘贴块、NGINX no-cache 站点模板、8 条通用核对清单 |
-| `fulgur doctor --base <URL> --apps <a,b,c>` | 部署体检：remoteEntry/manifest/index.html 的 200/no-cache/JS 形态、CORS、chunk 抽样可达、版本 skew 预演。`--dev` 检查 dev 容器入口；`--json` 输出 JSON（CI 断言）；`--chunk-sample N` 控制抽样数（默认 16）。**退出码：有 FAIL 即 1**，可直接做 CI 门禁 |
+| `fulgurjs init` | 在当前目录生成带注释的 `fulgurjs.config.ts` 起步模板；`--template <path>` 指定输出路径；已存在拒绝覆盖，`--force` 强制 |
+| `fulgurjs init --config <path>` | 校验配置（CFG 三段式报错）+ 输出各应用 `federation()` 粘贴块、NGINX no-cache 站点模板、8 条通用核对清单 |
+| `fulgurjs doctor --base <URL> --apps <a,b,c>` | 部署体检：remoteEntry/manifest/index.html 的 200/no-cache/JS 形态、CORS、chunk 抽样可达、版本 skew 预演。`--dev` 检查 dev 容器入口；`--json` 输出 JSON（CI 断言）；`--chunk-sample N` 控制抽样数（默认 16）。**退出码：有 FAIL 即 1**，可直接做 CI 门禁 |
 
 ### 6. 错误码总表（30 个）
 
@@ -376,7 +376,7 @@ export default defineFulgurConfig({
 | | `DEV-004` | 已知 UMD-only 依赖不在 optimizeDeps.include（预构建内联本地 vue 风险） |
 | | `DEV-005` | remotes dev URL 端口无监听 |
 | | `DEV-006` | 宿主/远程插件版本不一致 |
-| | `DEV-008` | 远程页面静态导入 virtual:fulgur-runtime（破坏渲染上下文） |
+| | `DEV-008` | 远程页面静态导入 virtual:fulgurjs-runtime（破坏渲染上下文） |
 | | `DEV-009` | 门面/虚拟模块 404（.vite 缓存漂移，需清缓存重启） |
 | | `DEV-010` | dev 冷启动预构建窗口提示（首轮 30~60s 瞬态，非故障） |
 | BLD 构建期 | `BLD-001` | expose 源文件解析失败 |
@@ -393,18 +393,18 @@ export default defineFulgurConfig({
 | | `MFU-009` | 加载到的模块没有任何导出 |
 | | `MFU-010` | singleton 共享版本漂移（使用作用域版本，告警） |
 
-每个码的完整排查文案见 [`docs/manual.html`](./docs/manual.html) §8；`fulgur doctor` 可提前把部署面的 MFU-001 类问题拦在上线前。
+每个码的完整排查文案见 [`docs/manual.html`](https://github.com/chenmingye/fulgurjs-federation/blob/master/docs/manual.html) §8；`fulgurjs doctor` 可提前把部署面的 MFU-001 类问题拦在上线前。
 
 ### 7. 产物与端点约定
 
 | 环境 | 路径 | 说明 |
 |---|---|---|
-| dev | `/<base>/@fulgur-entry.js` | 远程容器入口（插件中间件直出，自包含） |
-| dev | `/<base>/@fulgur-manifest.json` | dev manifest（宿主 dts / preloadRemote 消费） |
-| prod | `/<base>/fulgur-remoteEntry.js` | 固定文件名容器入口（内容每次构建变——**必须 no-cache**） |
-| prod | `/<base>/fulgur-manifest.json` | expose chunk/CSS 清单（preloadRemote 消费，**no-cache**） |
+| dev | `/<base>/@fulgurjs-entry.js` | 远程容器入口（插件中间件直出，自包含） |
+| dev | `/<base>/@fulgurjs-manifest.json` | dev manifest（宿主 dts / preloadRemote 消费） |
+| prod | `/<base>/fulgurjs-remoteEntry.js` | 固定文件名容器入口（内容每次构建变——**必须 no-cache**） |
+| prod | `/<base>/fulgurjs-manifest.json` | expose chunk/CSS 清单（preloadRemote 消费，**no-cache**） |
 
-NGINX 部署模板（no-cache 规则 + 深链回退）用 `fulgur init --config` 自动生成，样例见 [`docs/manual.html`](./docs/manual.html)。
+NGINX 部署模板（no-cache 规则 + 深链回退）用 `fulgurjs init --config` 自动生成，样例见 [`docs/manual.html`](https://github.com/chenmingye/fulgurjs-federation/blob/master/docs/manual.html)。
 
 ## ⚠️ 首次使用避坑指南（真实迁移项目踩坑实录）
 
@@ -467,7 +467,7 @@ const Panel = await loadRemote('shop/Panel', {
 所有配置问题在 `vite` 启动瞬间即报，固定三段式，可直接照抄修正：
 
 ```
-[fulgur] Invalid federation() config — remotes["remote-a"] has no address (need one of external / dev / prod)
+[fulgurjs] Invalid federation() config — remotes["remote-a"] has no address (need one of external / dev / prod)
   got:      {"dev":""}
   expected: at least one address; with only one URL it is used for both dev and prod
   example:  remotes: { 'remote-a': 'http://localhost:5101' }
@@ -478,22 +478,22 @@ const Panel = await loadRemote('shop/Panel', {
 
 统一错误码体系（CFG/DEV/BLD/MFU 四段共 30 个）——**完整总表见上方 [API 参考 §6](#6-错误码总表30-个)**；报错文案一律「现象 → 根因 → 修法」三段式。
 
-调试出口：`window.__FULGUR_SCOPE__`（share 协商实时结果）、`window.__FULGUR_INFO__`（remote 状态/耗时/错误）。
+调试出口：`window.__FULGURJS_SCOPE__`（share 协商实时结果）、`window.__FULGURJS_INFO__`（remote 状态/耗时/错误）。
 
 ## 边界（明确不支持）
 
 - 仅 Vue 3 生态（React 适配不在当前范围）；不兼容 originjs 的 `virtual:__federation__` 旧写法
 - 不支持 SSR（检测到即警告并禁用钩子）
-- 无浏览器 DevTools 扩展（提供 `window.__FULGUR_SCOPE__ / __FULGUR_INFO__` 调试面）
+- 无浏览器 DevTools 扩展（提供 `window.__FULGURJS_SCOPE__ / __FULGURJS_INFO__` 调试面）
 - 无 JS 沙箱 / CSS 隔离——联邦是同 realm 共存架构，靠 shared 单例协商防止双运行时（详见 `docs/沙箱边界审计.md` 的三维度实测）
 
 ## 文档
 
-- [`docs/manual.html`](./docs/manual.html) — 完整使用手册：webpack 逐项对齐总表、每个功能的配置代码 + dev/prod 实测截图、错误码排查、NGINX 部署样例
-- [`docs/迁移指南.md`](./docs/迁移指南.md) — qiankun 微前端 → 联邦的真实迁移案例（七步法 + 验收清单）
-- [`docs/webpack-mf-对照与缺口.md`](./docs/webpack-mf-对照与缺口.md) — webpack MF 逐项对照与明确不支持清单
-- [`docs/沙箱边界审计.md`](./docs/沙箱边界审计.md) — CSS / 全局变量 / 公共依赖三维度互扰实测
-- [`DESIGN.md`](./DESIGN.md) — 架构设计、对齐总表、测试与验收方案
+- [`docs/manual.html`](https://github.com/chenmingye/fulgurjs-federation/blob/master/docs/manual.html) — 完整使用手册：webpack 逐项对齐总表、每个功能的配置代码 + dev/prod 实测截图、错误码排查、NGINX 部署样例
+- [`docs/迁移指南.md`](https://github.com/chenmingye/fulgurjs-federation/blob/master/docs/迁移指南.md) — qiankun 微前端 → 联邦的真实迁移案例（七步法 + 验收清单）
+- [`docs/webpack-mf-对照与缺口.md`](https://github.com/chenmingye/fulgurjs-federation/blob/master/docs/webpack-mf-对照与缺口.md) — webpack MF 逐项对照与明确不支持清单
+- [`docs/沙箱边界审计.md`](https://github.com/chenmingye/fulgurjs-federation/blob/master/docs/沙箱边界审计.md) — CSS / 全局变量 / 公共依赖三维度互扰实测
+- [`DESIGN.md`](https://github.com/chenmingye/fulgurjs-federation/blob/master/DESIGN.md) — 架构设计、对齐总表、测试与验收方案
 
 ## 开发与测试