docs: update fallback field descriptions for clarity and consistency (#4556)

2heal1 · web-flow · commit a78f53c53196 · 2026-03-17T13:58:03.000+08:00
diff --git a/apps/website-new/docs/en/configure/stats-fields.mdx b/apps/website-new/docs/en/configure/stats-fields.mdx
@@ -35,9 +35,9 @@ Use this document to understand every field in `mf-stats.json`, which is helpful
 | `deps` | `string[]` | Yes | Dependencies |
 | `usedIn` | `string[]` | Yes | Used by containers/modules |
 | `usedExports` | `string[]` | Yes | Used exports |
-| `fallback` | `string` | Yes | Fallback path/id |
-| `fallbackName` | `string` | Yes | Fallback name |
-| `fallbackType` | `RemoteEntryType` | Yes | Fallback type |
+| `fallback` | `string` | Yes | Treeshaking Fallback path/id |
+| `fallbackName` | `string` | Yes | Treeshaking Fallback name |
+| `fallbackType` | `RemoteEntryType` | Yes | Treeshaking Fallback type |
 
 ## remotes
 
diff --git a/apps/website-new/docs/en/guide/_meta.json b/apps/website-new/docs/en/guide/_meta.json
@@ -48,10 +48,5 @@
     "type":"dir-section-header",
     "name":"troubleshooting",
     "label":"Troubleshooting"
-  },
-  {
-    "type": "dir-section-header",
-    "name": "ai",
-    "label": "AI"
   }
 ]
diff --git a/apps/website-new/docs/en/guide/ai/_meta.json b/apps/website-new/docs/en/guide/ai/_meta.json
diff --git a/apps/website-new/docs/en/guide/start/_meta.json b/apps/website-new/docs/en/guide/start/_meta.json
@@ -1 +1 @@
-["index", "setting-up-env", "quick-start", "features", "glossary", "npm-packages"]
+["index", "setting-up-env", "quick-start", "features", "glossary", "npm-packages","ai"]
diff --git a/apps/website-new/docs/en/guide/start/ai.mdx b/apps/website-new/docs/en/guide/start/ai.mdx
@@ -1,4 +1,4 @@
-# Module Federation for AI
+# AI
 
 ## Helping AI Understand MF 2.0
 
diff --git a/apps/website-new/docs/en/guide/start/npm-packages.mdx b/apps/website-new/docs/en/guide/start/npm-packages.mdx
@@ -1,4 +1,4 @@
-# npm Packages
+# NPM Packages
 
 This document showcases all npm package information maintained by the Module Federation team.
 
diff --git a/apps/website-new/docs/en/guide/start/skill.mdx b/apps/website-new/docs/en/guide/start/skill.mdx
diff --git a/apps/website-new/docs/zh/configure/stats-fields.mdx b/apps/website-new/docs/zh/configure/stats-fields.mdx
@@ -35,9 +35,9 @@ import CommonMfManifestStatsFields from '@components/common/configure/mf-manifes
 | `deps` | `string[]` | 是 | 依赖列表 |
 | `usedIn` | `string[]` | 是 | 被哪些模块/容器使用 |
 | `usedExports` | `string[]` | 是 | 实际使用到的导出 |
-| `fallback` | `string` | 是 | fallback 路径/标识 |
-| `fallbackName` | `string` | 是 | fallback 名称 |
-| `fallbackType` | `RemoteEntryType` | 是 | fallback 产物类型 |
+| `fallback` | `string` | 是 | treeshaking fallback 路径/标识 |
+| `fallbackName` | `string` | 是 | treeshaking fallback 名称 |
+| `fallbackType` | `RemoteEntryType` | 是 | treeshaking fallback 产物类型 |
 
 ## remotes
 
diff --git a/apps/website-new/docs/zh/guide/_meta.json b/apps/website-new/docs/zh/guide/_meta.json
@@ -48,10 +48,5 @@
     "type":"dir-section-header",
     "name":"troubleshooting",
     "label":"Troubleshooting"
-  },
-  {
-    "type": "dir-section-header",
-    "name": "ai",
-    "label": "AI"
   }
 ]
diff --git a/apps/website-new/docs/zh/guide/ai/_meta.json b/apps/website-new/docs/zh/guide/ai/_meta.json
diff --git a/apps/website-new/docs/zh/guide/start/_meta.json b/apps/website-new/docs/zh/guide/start/_meta.json
@@ -1 +1 @@
-["index", "setting-up-env", "quick-start", "features", "glossary", "npm-packages"]
+["index", "setting-up-env", "quick-start", "features", "glossary", "npm-packages","ai"]
diff --git a/apps/website-new/docs/zh/guide/start/ai.mdx b/apps/website-new/docs/zh/guide/start/ai.mdx
@@ -1,4 +1,4 @@
-# 面向 AI 的 Module Federation
+# AI
 
 ## 让 AI 了解 MF 2.0
 
diff --git a/apps/website-new/docs/zh/guide/start/npm-packages.mdx b/apps/website-new/docs/zh/guide/start/npm-packages.mdx
@@ -1,4 +1,4 @@
-# npm 包
+# NPM 包
 
 本文档展示了 Module Federation 团队维护的所有 npm 包信息。
 
diff --git a/apps/website-new/docs/zh/guide/start/skill.mdx b/apps/website-new/docs/zh/guide/start/skill.mdx
diff --git a/apps/website-new/src/components/common/configure/mf-manifest-stats-common-en.mdx b/apps/website-new/src/components/common/configure/mf-manifest-stats-common-en.mdx
@@ -12,7 +12,7 @@
 Shared fields:
 
 | Field               | Type             | Required | Description                           |
-| ------------------- | ---------------- | -------- | ------------------------------------- |
+| ------------------- | ---------------- | -------- | ------------------------------------- | --- |
 | `name`              | `string`         | Yes      | Current remote/host name              |
 | `globalName`        | `string`         | Yes      | Global name for the remoteEntry       |
 | `buildInfo`         | `StatsBuildInfo` | Yes      | Build information                     |
@@ -21,8 +21,8 @@ Shared fields:
 | `prefetchInterface` | `boolean`        | No       | Whether prefetch interface is enabled |
 | `prefetchEntry`     | `ResourceInfo`   | No       | Prefetch resource (if any)            |
 | `types`             | `MetaDataTypes`  | No       | Types bundle info (if any)            |
-| `type`              | `string`         | Yes      | Remote type                           |
-| `pluginVersion`     | `string`         | No       | Plugin version                        |
+| `type`              | `string`         | Yes      | APP                                   | NPM |
+| `pluginVersion`     | `string`         | No       | MF Plugin version                     |
 
 ### ResourceInfo
 
@@ -44,12 +44,12 @@ Shared fields:
 
 ### MetaDataTypes
 
-| Field  | Type     | Required | Description |
-| ------ | -------- | -------- | ----------- |
-| `path` | `string` | Yes      | Output path |
-| `name` | `string` | Yes      | File name   |
-| `api`  | `string` | Yes      | API entry   |
-| `zip`  | `string` | Yes      | Zip path    |
+| Field  | Type     | Required | Description                                               |
+| ------ | -------- | -------- | --------------------------------------------------------- |
+| `path` | `string` | Yes      | Output path                                               |
+| `name` | `string` | Yes      | File name (required for legacy types, will be deprecated) |
+| `api`  | `string` | Yes      | API entry                                                 |
+| `zip`  | `string` | Yes      | Zip path                                                  |
 
 ## assets (Both Files)
 
@@ -64,7 +64,7 @@ Shared fields:
 
 ### StatsAssetsInfo
 
-| Field   | Type       | Required | Description  |
-| ------- | ---------- | -------- | ------------ |
-| `sync`  | `string[]` | Yes      | Sync assets  |
-| `async` | `string[]` | Yes      | Async assets |
+| Field   | Type       | Required | Description    |
+| ------- | ---------- | -------- | -------------- |
+| `sync`  | `string[]` | Yes      | Initial assets |
+| `async` | `string[]` | Yes      | Async assets   |
diff --git a/apps/website-new/src/components/common/configure/mf-manifest-stats-common.mdx b/apps/website-new/src/components/common/configure/mf-manifest-stats-common.mdx
@@ -11,18 +11,16 @@
 
 共同字段如下：
 
-| 字段                | 类型             | 必有 | 说明                          |
-| ------------------- | ---------------- | ---- | ----------------------------- |
-| `name`              | `string`         | 是   | 当前 remote/host 名称         |
-| `globalName`        | `string`         | 是   | remoteEntry 对应的 globalName |
-| `buildInfo`         | `StatsBuildInfo` | 是   | 构建信息（版本/构建名等）     |
-| `remoteEntry`       | `ResourceInfo`   | 是   | remoteEntry 资源信息          |
-| `ssrRemoteEntry`    | `ResourceInfo`   | 否   | SSR remoteEntry（若有）       |
-| `prefetchInterface` | `boolean`        | 否   | 是否启用 prefetch 接口        |
-| `prefetchEntry`     | `ResourceInfo`   | 否   | prefetch 资源（若有）         |
-| `types`             | `MetaDataTypes`  | 否   | 类型产物信息（若有）          |
-| `type`              | `string`         | 是   | remote 类型标识               |
-| `pluginVersion`     | `string`         | 否   | 构建插件版本                  |
+| 字段             | 类型             | 必有 | 说明                          |
+| ---------------- | ---------------- | ---- | ----------------------------- | --- |
+| `name`           | `string`         | 是   | 当前 remote/host 名称         |
+| `globalName`     | `string`         | 是   | remoteEntry 对应的 globalName |
+| `buildInfo`      | `StatsBuildInfo` | 是   | 构建信息（版本/构建名等）     |
+| `remoteEntry`    | `ResourceInfo`   | 是   | remoteEntry 资源信息          |
+| `ssrRemoteEntry` | `ResourceInfo`   | 否   | SSR remoteEntry（若有）       |
+| `types`          | `MetaDataTypes`  | 否   | 类型产物信息（若有）          |
+| `type`           | `string`         | 是   | APP                           | NPM |
+| `pluginVersion`  | `string`         | 否   | MF 构建插件版本               |
 
 ### ResourceInfo
 
@@ -44,12 +42,12 @@
 
 ### MetaDataTypes
 
-| 字段   | 类型     | 必有 | 说明            |
-| ------ | -------- | ---- | --------------- |
-| `path` | `string` | 是   | 产物路径        |
-| `name` | `string` | 是   | 文件名          |
-| `api`  | `string` | 是   | API 类型入口    |
-| `zip`  | `string` | 是   | zip 包地址/路径 |
+| 字段   | 类型     | 必有 | 说明                             |
+| ------ | -------- | ---- | -------------------------------- |
+| `path` | `string` | 是   | 产物路径                         |
+| `name` | `string` | 是   | 文件名（旧版类型需要，即将废弃） |
+| `api`  | `string` | 是   | API 类型入口                     |
+| `zip`  | `string` | 是   | zip 包地址/路径                  |
 
 ## assets（两者都有）
 
@@ -66,5 +64,5 @@
 
 | 字段    | 类型       | 必有 | 说明         |
 | ------- | ---------- | ---- | ------------ |
-| `sync`  | `string[]` | 是   | 同步加载资源 |
+| `sync`  | `string[]` | 是   | 初始加载资源 |
 | `async` | `string[]` | 是   | 异步加载资源 |

Original file line number	Diff line number	Diff line change
`@@ -48,10 +48,5 @@`
`48`	`48`	`"type":"dir-section-header",`
`49`	`49`	`"name":"troubleshooting",`
`50`	`50`	`"label":"Troubleshooting"`
`51`		`- },`
`52`		`- {`
`53`		`- "type": "dir-section-header",`
`54`		`- "name": "ai",`
`55`		`- "label": "AI"`
`56`	`51`	`}`
`57`	`52`	`]`
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-["index", "setting-up-env", "quick-start", "features", "glossary", "npm-packages"]`
	`1`	`+["index", "setting-up-env", "quick-start", "features", "glossary", "npm-packages","ai"]`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# Module Federation for AI`
	`1`	`+# AI`
`2`	`2`
`3`	`3`	`## Helping AI Understand MF 2.0`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# npm Packages`
	`1`	`+# NPM Packages`
`2`	`2`
`3`	`3`	`This document showcases all npm package information maintained by the Module Federation team.`
`4`	`4`