@modern-js/main-doc 3.9.2 → 3.10.0

package/docs/zh/guides/advanced-features/international/configuration.mdx

@@ -1,13 +1,14 @@
 ---
 title: 配置说明
 ---
+
 # 配置说明
 
 插件配置分为两个文件，各有职责：
 
-| 文件 | 用途 |
-| --- | --- |
-| `modern.config.ts` | 插件基础设置，在构建/启动时读取 |
+| 文件                    | 用途                             |
+| ----------------------- | -------------------------------- |
+| `modern.config.ts`      | 插件基础设置，在构建/启动时读取  |
 | `src/modern.runtime.ts` | i18next 初始化选项，在运行时读取 |
 
 :::warning 函数类型只能在运行时配置中设置
@@ -16,13 +17,13 @@ title: 配置说明
 
 ## 配置归属一览
 
-| 配置项 | 放在哪里 |
-| --- | --- |
-| `localeDetection`（语言检测、路径重定向等） | `modern.config.ts` |
-| `backend`（资源路径、sdk 声明等） | `modern.config.ts` |
-| `i18nInstance` | `modern.runtime.ts` |
+| 配置项                                           | 放在哪里            |
+| ------------------------------------------------ | ------------------- |
+| `localeDetection`（语言检测、路径重定向等）      | `modern.config.ts`  |
+| `backend`（资源路径、sdk 声明等）                | `modern.config.ts`  |
+| `i18nInstance`                                   | `modern.runtime.ts` |
 | `initOptions`（fallbackLng、ns 等 i18next 选项） | `modern.runtime.ts` |
-| `backend.sdk` 的实际加载函数 | `modern.runtime.ts` |
+| `backend.sdk` 的实际加载函数                     | `modern.runtime.ts` |
 
 ## CLI 配置
 
@@ -43,15 +44,15 @@ export default defineConfig({
 
 ### localeDetection 选项
 
-| 字段 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| `languages` | `string[]` | `[]` | 支持的语言列表 |
-| `fallbackLanguage` | `string` | `''` | 语言检测失败时的兜底语言 |
-| `localePathRedirect` | `boolean` | `false` | 接管 URL 语言前缀的识别、重定向和切换，详见[路由集成](./routing.md#启用语言路径前缀) |
-| `i18nextDetector` | `boolean` | `false` | 启用 i18next 检测器（Cookie / Header 等） |
-| `detection` | `LanguageDetectorOptions` | — | i18next 检测器详细配置，见[语言检测](./locale-detection.md) |
-| `ignoreRedirectRoutes` | `string[] \| Function` | — | 跳过重定向的路由，见[语言检测](./locale-detection.md#ignoreredirectroutes) |
-| `localeDetectionByEntry` | `Record<string, ...>` | — | 多入口按入口覆盖配置 |
+| 字段                     | 类型                      | 默认值  | 说明                                                                                 |
+| ------------------------ | ------------------------- | ------- | ------------------------------------------------------------------------------------ |
+| `languages`              | `string[]`                | `[]`    | 支持的语言列表                                                                       |
+| `fallbackLanguage`       | `string`                  | `''`    | 语言检测失败时的兜底语言                                                             |
+| `localePathRedirect`     | `boolean`                 | `false` | 接管 URL 语言前缀的识别、重定向和切换，详见[路由集成](./routing.md#启用语言路径前缀) |
+| `i18nextDetector`        | `boolean`                 | `false` | 启用 i18next 检测器（Cookie / Header 等）                                            |
+| `detection`              | `LanguageDetectorOptions` | —       | i18next 检测器详细配置，见[语言检测](./locale-detection.md)                          |
+| `ignoreRedirectRoutes`   | `string[] \| Function`    | —       | 跳过重定向的路由，见[语言检测](./locale-detection.md#ignoreredirectroutes)           |
+| `localeDetectionByEntry` | `Record<string, ...>`     | —       | 多入口按入口覆盖配置                                                                 |
 
 **示例：**
 
@@ -104,23 +105,24 @@ interface BackendOptions {
 
 **backend 自动启用规则：**
 
-| 情况 | 结果 |
-| --- | --- |
-| 配置了 `loadPath` 或 `addPath` | 自动启用，无需写 `enabled: true` |
-| 未配置 backend，但 `locales` 目录存在且有 JSON 文件 | 自动启用，使用默认 `loadPath` |
-| 显式设置 `enabled: false` | 禁用，不做自动检测 |
+| 情况                                                | 结果                             |
+| --------------------------------------------------- | -------------------------------- |
+| 配置了 `loadPath` 或 `addPath`                      | 自动启用，无需写 `enabled: true` |
+| 未配置 backend，但 `locales` 目录存在且有 JSON 文件 | 自动启用，使用默认 `loadPath`    |
+| 显式设置 `enabled: false`                           | 禁用，不做自动检测               |
 
 自动检测的目录位置（按优先级）：
+
 1. `{项目根目录}/config/public/locales`
 2. `server.publicDir` 配置的目录下的 `locales` 子目录
 
 **选择哪种后端？**
 
-| 场景 | 推荐方式 |
-| --- | --- |
-| 翻译文件放在项目本地 | 静态文件后端（配置 `loadPath`，CSR/SSR 自动切换） |
-| 翻译来自远程 API 或翻译平台 | 自定义后端（配置 `sdk: true`） |
-| 本地兜底 + 远程实时更新 | 链式后端（同时配置 `loadPath` 和 `sdk`） |
+| 场景                        | 推荐方式                                          |
+| --------------------------- | ------------------------------------------------- |
+| 翻译文件放在项目本地        | 静态文件后端（配置 `loadPath`，CSR/SSR 自动切换） |
+| 翻译来自远程 API 或翻译平台 | 自定义后端（配置 `sdk: true`）                    |
+| 本地兜底 + 远程实时更新     | 链式后端（同时配置 `loadPath` 和 `sdk`）          |
 
 详细用法见[资源加载](./resource-loading.md)。
 
@@ -134,7 +136,7 @@ const i18nInstance = i18next.createInstance();
 
 export default defineRuntimeConfig({
   i18n: {
-    i18nInstance,   // 可选，建议使用独立实例
+    i18nInstance, // 可选，建议使用独立实例
     initOptions: {
       fallbackLng: 'en',
       supportedLngs: ['zh', 'en'],
@@ -162,13 +164,13 @@ import Desc from '@site-docs/components/international/init-options-desc';
 
 <Desc />
 
-| 字段 | 说明 |
-| --- | --- |
-| `fallbackLng` | i18next 找不到翻译键时回退到哪个语言的资源，支持字符串、数组或映射（回退链） |
-| `supportedLngs` | i18next 支持的语言列表 |
-| `ns` | 命名空间列表，默认 `['translation']` |
-| `defaultNS` | 默认命名空间，默认 `'translation'` |
-| `lng` | 强制指定初始语言（通常不需要，由检测器决定） |
+| 字段            | 说明                                                                         |
+| --------------- | ---------------------------------------------------------------------------- |
+| `fallbackLng`   | i18next 找不到翻译键时回退到哪个语言的资源，支持字符串、数组或映射（回退链） |
+| `supportedLngs` | i18next 支持的语言列表                                                       |
+| `ns`            | 命名空间列表，默认 `['translation']`                                         |
+| `defaultNS`     | 默认命名空间，默认 `'translation'`                                           |
+| `lng`           | 强制指定初始语言（通常不需要，由检测器决定）                                 |
 
 `fallbackLng` 支持回退链写法，适合区域语言降级的场景：
 

package/docs/zh/guides/advanced-features/international/locale-detection.mdx

@@ -64,8 +64,8 @@ i18nPlugin({
 ```ts
 i18nPlugin({
   localeDetection: {
-    localePathRedirect: true,   // 路径前缀
-    i18nextDetector: true,      // Cookie / Header 等
+    localePathRedirect: true, // 路径前缀
+    i18nextDetector: true, // Cookie / Header 等
     languages: ['zh', 'en'],
     fallbackLanguage: 'en',
     detection: {
@@ -77,39 +77,48 @@ i18nPlugin({
 
 ## 检测选项（detection）
 
-| 选项 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| `order` | `string[]` | 见下方 | i18next 检测器内部的检测顺序 |
-| `lookupQuerystring` | `string` | `'lng'` | 查询参数键名，例如 `?lng=en` |
-| `lookupCookie` | `string` | `'i18next'` | Cookie 键名 |
-| `lookupLocalStorage` | `string` | `'i18nextLng'` | LocalStorage 键名（仅浏览器） |
-| `lookupSession` | `string` | — | SessionStorage 键名（仅浏览器） |
-| `lookupHeader` | `string` | `'accept-language'` | HTTP 请求头键名 |
-| `lookupFromPathIndex` | `number` | `0` | 从 URL 路径的第几段开始识别语言 |
-| `caches` | `false \| string[]` | — | 检测到的语言缓存到哪里，如 `['cookie']` |
-| `cookieMinutes` | `number` | `525600`（1年） | Cookie 过期时间（分钟） |
-| `cookieExpirationDate` | `Date` | — | Cookie 过期日期，优先级高于 `cookieMinutes` |
-| `cookieDomain` | `string` | — | Cookie 域名 |
+| 选项                   | 类型                | 默认值              | 说明                                        |
+| ---------------------- | ------------------- | ------------------- | ------------------------------------------- |
+| `order`                | `string[]`          | 见下方              | i18next 检测器内部的检测顺序                |
+| `lookupQuerystring`    | `string`            | `'lng'`             | 查询参数键名，例如 `?lng=en`                |
+| `lookupCookie`         | `string`            | `'i18next'`         | Cookie 键名                                 |
+| `lookupLocalStorage`   | `string`            | `'i18nextLng'`      | LocalStorage 键名（仅浏览器）               |
+| `lookupSession`        | `string`            | —                   | SessionStorage 键名（仅浏览器）             |
+| `lookupHeader`         | `string`            | `'accept-language'` | HTTP 请求头键名                             |
+| `lookupFromPathIndex`  | `number`            | `0`                 | 从 URL 路径的第几段开始识别语言             |
+| `caches`               | `false \| string[]` | —                   | 检测到的语言缓存到哪里，如 `['cookie']`     |
+| `cookieMinutes`        | `number`            | `525600`（1年）     | Cookie 过期时间（分钟）                     |
+| `cookieExpirationDate` | `Date`              | —                   | Cookie 过期日期，优先级高于 `cookieMinutes` |
+| `cookieDomain`         | `string`            | —                   | Cookie 域名                                 |
 
 **默认检测顺序（未配置 `order` 时）：**
 
 ```ts
-['querystring', 'cookie', 'localStorage', 'header', 'navigator', 'htmlTag', 'path', 'subdomain']
+[
+  'querystring',
+  'cookie',
+  'localStorage',
+  'header',
+  'navigator',
+  'htmlTag',
+  'path',
+  'subdomain',
+];
 ```
 
 **`order` 可用值：**
 
-| 值 | 检测来源 | 限制 |
-| --- | --- | --- |
-| `querystring` | URL 查询参数（`?lng=en`） | — |
-| `cookie` | Cookie | — |
-| `localStorage` | LocalStorage | 仅浏览器 |
-| `sessionStorage` | SessionStorage | 仅浏览器 |
-| `navigator` | 浏览器语言设置 | 仅浏览器 |
-| `htmlTag` | `<html lang="...">` | 仅浏览器 |
-| `header` | `Accept-Language` 请求头 | — |
-| `path` | URL 路径（需同时启用 `localePathRedirect`） | — |
-| `subdomain` | 子域名（`en.example.com`） | — |
+| 值               | 检测来源                                    | 限制     |
+| ---------------- | ------------------------------------------- | -------- |
+| `querystring`    | URL 查询参数（`?lng=en`）                   | —        |
+| `cookie`         | Cookie                                      | —        |
+| `localStorage`   | LocalStorage                                | 仅浏览器 |
+| `sessionStorage` | SessionStorage                              | 仅浏览器 |
+| `navigator`      | 浏览器语言设置                              | 仅浏览器 |
+| `htmlTag`        | `<html lang="...">`                         | 仅浏览器 |
+| `header`         | `Accept-Language` 请求头                    | —        |
+| `path`           | URL 路径（需同时启用 `localePathRedirect`） | —        |
+| `subdomain`      | 子域名（`en.example.com`）                  | —        |
 
 ## ignoreRedirectRoutes
 
@@ -118,7 +127,7 @@ i18nPlugin({
 **写法一：字符串数组**（支持精确匹配和前缀匹配）
 
 ```ts
-ignoreRedirectRoutes: ['/api', '/admin', '/static']
+ignoreRedirectRoutes: ['/api', '/admin', '/static'];
 // '/api' 会匹配 /api 和 /api/users
 ```
 

package/docs/zh/guides/advanced-features/international/resource-loading.mdx

@@ -1,21 +1,23 @@
 ---
 title: 资源加载
 ---
+
 # 资源加载
 
 翻译文件的加载方式取决于你的翻译资源放在哪里：
 
-| 场景 | 加载方式 |
-| --- | --- |
-| 翻译文件放在项目本地 | 静态文件后端（本篇默认方式） |
-| 翻译来自远程 API、翻译平台 | 自定义后端 |
-| 两者都要：本地兜底 + 远程实时更新 | 链式后端 |
+| 场景                              | 加载方式                     |
+| --------------------------------- | ---------------------------- |
+| 翻译文件放在项目本地              | 静态文件后端（本篇默认方式） |
+| 翻译来自远程 API、翻译平台        | 自定义后端                   |
+| 两者都要：本地兜底 + 远程实时更新 | 链式后端                     |
 
 ## 静态文件后端
 
 把翻译文件放在项目里，插件直接加载。这是最常见的方式。
 
 **CSR 和 SSR 的加载机制不同，但配置完全一样：**
+
 - CSR：浏览器通过 HTTP 请求拉取翻译文件（如 `GET /locales/zh/translation.json`）
 - SSR：服务端直接从磁盘读取文件，不走 HTTP
 
@@ -100,11 +102,11 @@ export default defineRuntimeConfig({
 
 ```ts
 interface I18nSdkLoadOptions {
-  lng?: string;      // 单个语言代码
-  ns?: string;       // 单个命名空间
-  lngs?: string[];   // 多个语言代码
-  nss?: string[];    // 多个命名空间
-  all?: boolean;     // 加载所有资源
+  lng?: string; // 单个语言代码
+  ns?: string; // 单个命名空间
+  lngs?: string[]; // 多个语言代码
+  nss?: string[]; // 多个命名空间
+  all?: boolean; // 加载所有资源
 }
 ```
 
@@ -122,7 +124,7 @@ interface I18nSdkLoadOptions {
 i18nPlugin({
   backend: {
     loadPath: '/locales/{{lng}}/{{ns}}.json', // 本地文件，快速显示
-    sdk: true,                                 // 远程加载，异步更新
+    sdk: true, // 远程加载，异步更新
   },
 });
 ```
@@ -135,7 +137,9 @@ export default defineRuntimeConfig({
       backend: {
         sdk: async options => {
           if (options.lng && options.ns) {
-            const res = await fetch(`https://api.example.com/i18n/${options.lng}/${options.ns}`);
+            const res = await fetch(
+              `https://api.example.com/i18n/${options.lng}/${options.ns}`,
+            );
             return { [options.lng]: { [options.ns]: await res.json() } };
           }
           return {};
@@ -148,8 +152,8 @@ export default defineRuntimeConfig({
 
 **`cacheHitMode` 选项**（控制两个后端之间的协作方式）：
 
-| 值 | 行为 |
-| --- | --- |
-| `'none'` | 本地文件加载成功后直接使用，不再请求自定义后端 |
-| `'refresh'` | 继续请求自定义后端并更新缓存，但不更新当前页面 |
+| 值                        | 行为                                                   |
+| ------------------------- | ------------------------------------------------------ |
+| `'none'`                  | 本地文件加载成功后直接使用，不再请求自定义后端         |
+| `'refresh'`               | 继续请求自定义后端并更新缓存，但不更新当前页面         |
 | `'refreshAndUpdateStore'` | 继续请求自定义后端，更新缓存并同步刷新页面文案（默认） |

package/docs/zh/guides/advanced-features/international/routing.mdx

@@ -26,9 +26,9 @@ i18nPlugin({
 
 **效果：**
 
-| 访问路径 | 结果 |
-| --- | --- |
-| `/about` | 重定向到 `/en/about` |
+| 访问路径    | 结果                  |
+| ----------- | --------------------- |
+| `/about`    | 重定向到 `/en/about`  |
 | `/en/about` | 正常访问，语言为 `en` |
 | `/zh/about` | 正常访问，语言为 `zh` |
 
@@ -108,7 +108,9 @@ function Navigation() {
     <nav>
       <I18nLink to="/">首页</I18nLink>
       <I18nLink to="/about">关于</I18nLink>
-      <I18nLink to="/contact" replace>联系</I18nLink>
+      <I18nLink to="/contact" replace>
+        联系
+      </I18nLink>
     </nav>
   );
 }

package/docs/zh/guides/advanced-features/international.mdx

@@ -10,15 +10,15 @@ import I18nPluginIntroduce from '@site-docs/components/international/introduce';
 
 ## 从哪里开始？
 
-| 想做的事 | 文档 |
-| --- | --- |
-| 首次接入，跑通示例 | [快速开始](./international/quick-start.md) |
-| 了解完整的配置选项 | [配置说明](./international/configuration.md) |
-| 根据 URL / Cookie / Header 自动判断语言 | [语言检测](./international/locale-detection.md) |
-| 实现 `/en/about` 这类带语言前缀的路径 | [路由集成](./international/routing.md) |
-| 从远程服务或平台加载翻译资源 | [资源加载 → 自定义后端](./international/resource-loading.md#sdk-后端) |
-| SSR 场景、多入口、自定义实例 | [高级用法](./international/advanced.md) |
-| 查询 Hook / 组件 / 类型定义 | [API 参考](./international/api.md) |
+| 想做的事                                | 文档                                                                  |
+| --------------------------------------- | --------------------------------------------------------------------- |
+| 首次接入，跑通示例                      | [快速开始](./international/quick-start.md)                            |
+| 了解完整的配置选项                      | [配置说明](./international/configuration.md)                          |
+| 根据 URL / Cookie / Header 自动判断语言 | [语言检测](./international/locale-detection.md)                       |
+| 实现 `/en/about` 这类带语言前缀的路径   | [路由集成](./international/routing.md)                                |
+| 从远程服务或平台加载翻译资源            | [资源加载 → 自定义后端](./international/resource-loading.md#sdk-后端) |
+| SSR 场景、多入口、自定义实例            | [高级用法](./international/advanced.md)                               |
+| 查询 Hook / 组件 / 类型定义             | [API 参考](./international/api.md)                                    |
 
 ## 核心能力
 

package/docs/zh/guides/advanced-features/server-monitor/logger.mdx

@@ -6,10 +6,10 @@
 
 基于服务端运行逻辑，Modern.js 在内部提供了以下日志事件：
 
-| 阶段          | 消息                                         | Level |
-| ------------- | -------------------------------------------- | ----- |
-| RENDER_HTML   | App Render To HTML                           | error |
-| RENDER_STREAM | An error occurs during streaming SSR         | error |
+| 阶段          | 消息                                          | Level |
+| ------------- | --------------------------------------------- | ----- |
+| RENDER_HTML   | App Render To HTML                            | error |
+| RENDER_STREAM | An error occurs during streaming SSR          | error |
 | RENDER_SHELL  | An error occurs during streaming render shell | error |
 
 ## 内置 Monitor
@@ -17,5 +17,3 @@
 import InternalLogger from '@site-docs/components/internal-logger.mdx';
 
 <InternalLogger />
-
-

package/docs/zh/guides/advanced-features/server-monitor/metrics.mdx

@@ -8,21 +8,20 @@
 
 基于服务端运行逻辑，Modern.js 在内部提供了以下指标事件：
 
-| Key                      | 描述             |
-| ------------------------ | ---------------  |
-| server-handle-request    | Modern.js Server 处理请求单次耗时                                                           |
-| ssr-render-shell         | [SSR]在使用 Streaming SSR 时， React 将渲染一个套壳(shell)优先传输。这里表明套壳渲染完成时间                              |
-| ssr-render-html          | [SSR] React 将组件树渲染成 html 所消耗的时间，通常不会超过 50ms                                                         |
-| server-middleware        | Modern.js 自定义 Server `Middleware` 执行总时                                                                           |
-| server-loader            | Server 端整体 Data Loader 耗时                                                                                     |
-| server-loader-#id        | Server 端各个 Data Loader 耗时                                                                                      |
-| server-loader-navigation | 前端导航时，服务端 Data Loader 的整体耗时                                                                              |
+| Key                      | 描述                                                                                         |
+| ------------------------ | -------------------------------------------------------------------------------------------- |
+| server-handle-request    | Modern.js Server 处理请求单次耗时                                                            |
+| ssr-render-shell         | [SSR]在使用 Streaming SSR 时， React 将渲染一个套壳(shell)优先传输。这里表明套壳渲染完成时间 |
+| ssr-render-html          | [SSR] React 将组件树渲染成 html 所消耗的时间，通常不会超过 50ms                              |
+| server-middleware        | Modern.js 自定义 Server `Middleware` 执行总时                                                |
+| server-loader            | Server 端整体 Data Loader 耗时                                                               |
+| server-loader-#id        | Server 端各个 Data Loader 耗时                                                               |
+| server-loader-navigation | 前端导航时，服务端 Data Loader 的整体耗时                                                    |
 
 Modern.js 服务端流程如图所示：
 
 ![server](https://lf3-static.bytednsdoc.com/obj/eden-cn/eeeh7uhbepxlpe/edenx-website/e374def0-c179-40aa-9cfe-e82e181663b1.jpeg)
 
-
 ## 内置 Monitor
 
 import InternalMetrics from '@site-docs/components/internal-metrics.mdx';

package/docs/zh/guides/advanced-features/source-build.mdx

@@ -142,7 +142,7 @@ Project reference 提供了以下能力：
 {
   "compilerOptions": {
     "composite": true
-  },
+  }
 }
 ```
 

package/docs/zh/guides/advanced-features/web-server.mdx

@@ -50,13 +50,13 @@ export default defineServerConfig({
 
 3. 你可以将 `server` 目录包含在 `tsconfig.json` 中
 
-```json5
+```jsonc
 {
   // ...
   "include": [
     // ...
-    "server"
-  ]
+    "server",
+  ],
 }
 ```
 

package/docs/zh/guides/basic-features/data/data-fetch.mdx

@@ -25,9 +25,7 @@ Modern.js 推荐使用[约定式路由](/guides/basic-features/routes/routes)做
 在 `routes/user/page.data.ts` 文件中，可以导出一个 `loader` 函数：
 
 ```ts title="routes/user/page.data.ts"
-export type ProfileData = {
-  /*  some types */
-};
+export type ProfileData = {/*  some types */};
 
 export const loader = async (): Promise<ProfileData> => {
   const res = await fetch('https://api/user/profile');

package/docs/zh/guides/basic-features/data/data-write.mdx

@@ -33,7 +33,7 @@ export const action: ActionFunction = async ({ request }) => {
   const newUser = await request.json();
   const name = newUser.name;
   return updateUserProfile(name);
-}
+};
 ```
 
 在路由组件中，你可以通过 `useFetcher` 获取对应 `submit` 函数，执行并触发 Data Action：
@@ -43,7 +43,7 @@ import {
   useFetcher,
   useLoaderData,
   useParams,
-  Outlet
+  Outlet,
 } from '@modern-js/runtime/router';
 
 export default () => {
@@ -51,23 +51,21 @@ export default () => {
   const { submit } = useFetcher();
   const editUser = () => {
     const newUser = {
-      name: 'Modern.js'
-    }
+      name: 'Modern.js',
+    };
     return submit(newUser, {
       method: 'post',
       encType: 'application/json',
-    })
-  }
+    });
+  };
   return (
     <div>
       <button onClick={editUser}>edit user</button>
-      <div className="user-profile">
-        {userInfo}
-      </div>
+      <div className="user-profile">{userInfo}</div>
       <Outlet context={userInfo}></Outlet>
     </div>
-  )
-}
+  );
+};
 ```
 
 当执行 `submit` 后，会触发定义的 `action` 函数。在 `action` 函数中，可以通过[入参](/guides/basic-features/data/data-write.html#入参)获取提交的数据，最终发送数据到服务端。
@@ -124,17 +122,18 @@ useSubmit:
 
 ```ts
 const submit = useSubmit();
-submit(null, { method: "post", action: "/logout" });
+submit(null, { method: 'post', action: '/logout' });
 ```
 
 useFetcher:
 
 ```ts
 const { submit } = useFetcher();
-submit(null, { method: "post", action: "/logout" });
+submit(null, { method: 'post', action: '/logout' });
 ```
 
 `submit` 函数有两个入参，第一个入参是传递到服务端的 `formData`。第二个入参是可选参数，其中
+
 - `method` 相当于表单提交时的 `method`，大部分写入数据的场景下，`method` 可以传入 `post`。
 - `action` 用来指定触发哪个路由组件的 Data Action，如果未传入 `action` 入参，默认会触发当前路由组件的 action，即 `user/page.tsx` 组件或子组件中执行 submit，会触发 `user/page.data.ts` 中定义的 action。
 
@@ -144,7 +143,6 @@ submit(null, { method: "post", action: "/logout" });
 
 :::
 
-
 ### 数据类型
 
 `submit` 函数的第一个入参，可以接受不同类型的值。
@@ -153,7 +151,7 @@ submit(null, { method: "post", action: "/logout" });
 
 ```ts
 let formData = new FormData();
-formData.append("cheese", "gouda");
+formData.append('cheese', 'gouda');
 submit(formData);
 // In the action, you can get the data by request.json
 ```
@@ -162,7 +160,7 @@ submit(formData);
 
 ```ts
 let searchParams = new URLSearchParams();
-searchParams.append("cheese", "gouda");
+searchParams.append('cheese', 'gouda');
 submit(searchParams);
 // In the action, you can get the data by request.json
 ```
@@ -170,10 +168,10 @@ submit(searchParams);
 或任意 `URLSearchParams` 构造函数可接受的值：
 
 ```ts
-submit("cheese=gouda&toasted=yes");
+submit('cheese=gouda&toasted=yes');
 submit([
-  ["cheese", "gouda"],
-  ["toasted", "yes"],
+  ['cheese', 'gouda'],
+  ['toasted', 'yes'],
 ]);
 // In the action, you can get the data by request.json
 ```
@@ -182,11 +180,11 @@ submit([
 
 ```ts
 submit(
-  { key: "value" },
+  { key: 'value' },
   {
-    method: "post",
-    encType: "application/x-www-form-urlencoded",
-  }
+    method: 'post',
+    encType: 'application/x-www-form-urlencoded',
+  },
 );
 
 // In the action, you can get the data by request.formData
@@ -195,14 +193,11 @@ submit(
 你也可以通过第二个参数，指定为编码方式：
 
 ```tsx
-submit(
-  { key: "value" },
-  { method: "post", encType: "application/json" }
-);
+submit({ key: 'value' }, { method: 'post', encType: 'application/json' });
 
 submit('{"key":"value"}', {
-  method: "post",
-  encType: "application/json",
+  method: 'post',
+  encType: 'application/json',
 });
 
 // In the action, you can get the data by request.json
@@ -211,7 +206,7 @@ submit('{"key":"value"}', {
 或提交纯文本：
 
 ```ts
-submit("value", { method: "post", encType: "text/plain" });
+submit('value', { method: 'post', encType: 'text/plain' });
 // In the action, you can get the data by request.text
 ```
 
@@ -228,7 +223,6 @@ Modern.js 中提供 Data Action 主要是为了使 UI 和服务器的状态能
 
 如果项目中组件共享的数据主要来自于服务端的状态，则无需在项目引入浏览器端状态管理库。可以使用 Data Loader 请求数据，通过 [`useRouteLoaderData`](/guides/basic-features/data/data-fetch.md) 在子组件中共享数据，使用 Data Action 修改和同步服务端的状态。
 
-
 ## CSR 和 SSR
 
 与 Data Loader 一样，SSR 项目中，Data Action 是在服务端执行的（框架会自动发请求触发 Data Action），而在 CSR 项目中，Data Action 是在浏览器端执行的。

package/docs/zh/guides/basic-features/debug/mock.mdx

@@ -101,8 +101,8 @@ type MockConfig = {
 };
 
 export const config = {
-  enable: false
-}
+  enable: false,
+};
 ```
 
 目前仅支持 `enable` 配置，开发者可以通过该配置控制是否执行 Mock。