diff --git a/apps/docs/README.md b/apps/docs/README.md
index 35b5747..fe6eb5e 100644
--- a/apps/docs/README.md
+++ b/apps/docs/README.md
@@ -37,7 +37,7 @@ You can also run equivalent commands inside `apps/docs` with `pnpm run <script>`
 
 ## i18n workflow
 
-This docs app supports multiple locales (`en`, `ko`, `de`, `fr`).
+This docs app supports multiple locales (`en`, `ko`, `de`, `fr`, `ru`, `ja`, `es`, `zh-Hans`).
 
 ```bash
 # extract translation files
diff --git a/apps/docs/docs/advanced/custom-transformer.md b/apps/docs/docs/advanced/custom-transformer.md
index 9f65870..001f764 100644
--- a/apps/docs/docs/advanced/custom-transformer.md
+++ b/apps/docs/docs/advanced/custom-transformer.md
@@ -95,7 +95,7 @@ class ReportRequest {
 class ProductQuery {
     @Query('q')
     @Transform((value: string) => value.toLowerCase().trim())
-    @IsNotEmpty()
+    @MinLength(1)
     searchTerm!: string
 
     @Query()
@@ -155,4 +155,4 @@ class FilterRequest {
 
 // GET /filter?active=yes → { active: true }
 // GET /filter?active=0   → { active: false }
-```
\ No newline at end of file
+```
diff --git a/apps/docs/docs/advanced/nested-binding.md b/apps/docs/docs/advanced/nested-binding.md
index c9ed97f..1e2a750 100644
--- a/apps/docs/docs/advanced/nested-binding.md
+++ b/apps/docs/docs/advanced/nested-binding.md
@@ -6,7 +6,7 @@ Express-Cargo allows you to handle nested objects in requests, automatically bin
 
 ```typescript
 import express, { Request, Response } from 'express'
-import { Body, bindingCargo, getCargo } from 'express-cargo'
+import { Body, Type, bindingCargo, getCargo } from 'express-cargo'
 
 // 1. Define nested Object
 class Profile {
@@ -16,6 +16,7 @@ class Profile {
 
 class ExampleObject {
     @Body('profile')
+    @Type(() => Profile)
     profile!: Profile
 }
 
diff --git a/apps/docs/docs/examples/nested-request.md b/apps/docs/docs/examples/nested-request.md
index 7bc4b35..e123311 100644
--- a/apps/docs/docs/examples/nested-request.md
+++ b/apps/docs/docs/examples/nested-request.md
@@ -40,7 +40,7 @@ export class UserInfoRequest {
 
 ```typescript
 // order.request.ts
-import { Body, Min, Max } from 'express-cargo'
+import { Body, Min, Max, Type } from 'express-cargo'
 import { UserInfoRequest } from './user.request'
 
 export class OrderRequest {
@@ -53,6 +53,7 @@ export class OrderRequest {
     quantity!: number
 
     @Body('user')
+    @Type(() => UserInfoRequest)
     user!: UserInfoRequest
 }
 ```
diff --git a/apps/docs/docs/getting-started.md b/apps/docs/docs/getting-started.md
index 72303fa..744209c 100644
--- a/apps/docs/docs/getting-started.md
+++ b/apps/docs/docs/getting-started.md
@@ -80,9 +80,8 @@ pnpm add reflect-metadata
 #### 6-1. `src/app.ts`
 
 ```typescript
-import express from 'express'
-import { bindingCargo, getCargo, Body, Query, Header, Params, Min, Max, Equal, NotEqual, Prefix, Suffix } from 'express-cargo'
-import errorHandlerRouter from './errorHandler'
+import express, { Request, Response, NextFunction } from 'express'
+import { bindingCargo, getCargo, Body, Equal, CargoValidationError } from 'express-cargo'
 
 const app = express()
 
@@ -91,10 +90,6 @@ const port = process.env.PORT || 3000
 app.use(express.json())
 app.use(express.urlencoded({ extended: true }))
 
-app.use(errorHandlerRouter)
-
-app.listen(port, () => {console.log(`Example app listening on port ${port}`)})
-
 class ExampleRequest {
   @Body() // Extract fields from the request body
   @Equal('1') // If the value is not "1", a validation error occurs
@@ -105,6 +100,19 @@ app.post('/example', bindingCargo(ExampleRequest), (req, res) => { // bindingCar
   const cargo = getCargo<ExampleRequest>(req) // Return a validated type-safe object
   res.json(cargo)
 })
+
+app.use((err: Error, req: Request, res: Response, next: NextFunction) => {
+  if (err instanceof CargoValidationError) {
+    res.status(400).json({
+      errors: err.errors.map(error => error.message),
+    })
+    return
+  }
+
+  next(err)
+})
+
+app.listen(port, () => {console.log(`Example app listening on port ${port}`)})
 ```
 
 ### 7. Run
diff --git a/apps/docs/docusaurus.config.ts b/apps/docs/docusaurus.config.ts
index 172a938..cfeec01 100644
--- a/apps/docs/docusaurus.config.ts
+++ b/apps/docs/docusaurus.config.ts
@@ -37,7 +37,7 @@ const config: Config = {
     // may want to replace "en" with "zh-Hans".
     i18n: {
         defaultLocale: 'en',
-        locales: ['en', 'ko', 'de', 'fr', 'ru', 'ja', 'es'],
+        locales: ['en', 'ko', 'de', 'fr', 'ru', 'ja', 'es', 'zh-Hans'],
         localeConfigs: {
             en: {
                 label: 'English',
@@ -66,6 +66,10 @@ const config: Config = {
                 label: 'Español',
                 direction: 'ltr',
             },
+            'zh-Hans': {
+                label: '简体中文',
+                direction: 'ltr',
+            },
         },
     },
 
diff --git a/apps/docs/i18n/zh-Hans/code.json b/apps/docs/i18n/zh-Hans/code.json
new file mode 100644
index 0000000..5f524d1
--- /dev/null
+++ b/apps/docs/i18n/zh-Hans/code.json
@@ -0,0 +1,285 @@
+{
+  "theme.ErrorPageContent.title": {
+    "message": "此页面崩溃了。",
+    "description": "The title of the fallback page when the page crashed"
+  },
+  "theme.BackToTopButton.buttonAriaLabel": {
+    "message": "返回顶部",
+    "description": "The ARIA label for the back to top button"
+  },
+  "theme.tags.tagsPageLink": {
+    "message": "查看所有标签",
+    "description": "The label of the link targeting the tag list page"
+  },
+  "theme.colorToggle.ariaLabel.mode.system": {
+    "message": "系统模式",
+    "description": "The name for the system color mode"
+  },
+  "theme.colorToggle.ariaLabel.mode.light": {
+    "message": "浅色模式",
+    "description": "The name for the light color mode"
+  },
+  "theme.colorToggle.ariaLabel.mode.dark": {
+    "message": "深色模式",
+    "description": "The name for the dark color mode"
+  },
+  "theme.colorToggle.ariaLabel": {
+    "message": "切换深色与浅色模式（当前为 {mode}）",
+    "description": "The ARIA label for the color mode toggle"
+  },
+  "theme.docs.breadcrumbs.navAriaLabel": {
+    "message": "面包屑导航",
+    "description": "The ARIA label for the breadcrumbs"
+  },
+  "theme.docs.DocCard.categoryDescription.plurals": {
+    "message": "1 个项目|{count} 个项目",
+    "description": "The default description for a category card in the generated index about how many items this category includes"
+  },
+  "theme.docs.paginator.navAriaLabel": {
+    "message": "文档页面",
+    "description": "The ARIA label for the docs pagination"
+  },
+  "theme.docs.paginator.previous": {
+    "message": "上一页",
+    "description": "The label used to navigate to the previous doc"
+  },
+  "theme.docs.paginator.next": {
+    "message": "下一页",
+    "description": "The label used to navigate to the next doc"
+  },
+  "theme.docs.versions.unreleasedVersionLabel": {
+    "message": "这是 {siteTitle} {versionLabel} 版本的未发布文档。",
+    "description": "The label used to tell the user that he's browsing an unreleased doc version"
+  },
+  "theme.docs.versions.unmaintainedVersionLabel": {
+    "message": "这是 {siteTitle} {versionLabel} 的文档，该版本已不再维护。",
+    "description": "The label used to tell the user that he's browsing an unmaintained doc version"
+  },
+  "theme.docs.versions.latestVersionSuggestionLabel": {
+    "message": "如需最新文档，请参阅 {latestVersionLink}（{versionLabel}）。",
+    "description": "The label used to tell the user to check the latest version"
+  },
+  "theme.docs.versions.latestVersionLinkLabel": {
+    "message": "最新版本",
+    "description": "The label used for the latest version suggestion link label"
+  },
+  "theme.docs.tagDocListPageTitle.nDocsTagged": {
+    "message": "1 篇文档带有此标签|{count} 篇文档带有此标签",
+    "description": "Pluralized label for \"{count} docs tagged\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)"
+  },
+  "theme.docs.tagDocListPageTitle": {
+    "message": "{nDocsTagged}：“{tagName}”",
+    "description": "The title of the page for a docs tag"
+  },
+  "theme.common.editThisPage": {
+    "message": "编辑此页面",
+    "description": "The link label to edit the current page"
+  },
+  "theme.docs.versionBadge.label": {
+    "message": "版本：{versionLabel}"
+  },
+  "theme.common.headingLinkTitle": {
+    "message": "指向 {heading} 的直接链接",
+    "description": "Title for link to heading"
+  },
+  "theme.lastUpdated.atDate": {
+    "message": " 于 {date}",
+    "description": "The words used to describe on which date a page has been last updated"
+  },
+  "theme.lastUpdated.byUser": {
+    "message": " 由 {user}",
+    "description": "The words used to describe by who the page has been last updated"
+  },
+  "theme.lastUpdated.lastUpdatedAtBy": {
+    "message": "最后更新{atDate}{byUser}",
+    "description": "The sentence used to display when a page has been last updated, and by who"
+  },
+  "theme.navbar.mobileVersionsDropdown.label": {
+    "message": "版本",
+    "description": "The label for the navbar versions dropdown on mobile view"
+  },
+  "theme.NotFound.title": {
+    "message": "页面未找到",
+    "description": "The title of the 404 page"
+  },
+  "theme.tags.tagsListLabel": {
+    "message": "标签：",
+    "description": "The label alongside a tag list"
+  },
+  "theme.admonition.caution": {
+    "message": "注意",
+    "description": "The default label used for the Caution admonition (:::caution)"
+  },
+  "theme.admonition.danger": {
+    "message": "危险",
+    "description": "The default label used for the Danger admonition (:::danger)"
+  },
+  "theme.admonition.info": {
+    "message": "信息",
+    "description": "The default label used for the Info admonition (:::info)"
+  },
+  "theme.admonition.note": {
+    "message": "备注",
+    "description": "The default label used for the Note admonition (:::note)"
+  },
+  "theme.admonition.tip": {
+    "message": "提示",
+    "description": "The default label used for the Tip admonition (:::tip)"
+  },
+  "theme.admonition.warning": {
+    "message": "警告",
+    "description": "The default label used for the Warning admonition (:::warning)"
+  },
+  "theme.AnnouncementBar.closeButtonAriaLabel": {
+    "message": "关闭",
+    "description": "The ARIA label for close button of announcement bar"
+  },
+  "theme.DocSidebarItem.expandCategoryAriaLabel": {
+    "message": "展开侧边栏分类“{label}”",
+    "description": "The ARIA label to expand the sidebar category"
+  },
+  "theme.DocSidebarItem.collapseCategoryAriaLabel": {
+    "message": "折叠侧边栏分类“{label}”",
+    "description": "The ARIA label to collapse the sidebar category"
+  },
+  "theme.NavBar.navAriaLabel": {
+    "message": "主导航",
+    "description": "The ARIA label for the main navigation"
+  },
+  "theme.NotFound.p1": {
+    "message": "我们找不到你要查找的内容。",
+    "description": "The first paragraph of the 404 page"
+  },
+  "theme.NotFound.p2": {
+    "message": "请联系链接到原始 URL 的网站所有者，并告知他们该链接已失效。",
+    "description": "The 2nd paragraph of the 404 page"
+  },
+  "theme.TOCCollapsible.toggleButtonLabel": {
+    "message": "本页目录",
+    "description": "The label used by the button on the collapsible TOC component"
+  },
+  "theme.navbar.mobileLanguageDropdown.label": {
+    "message": "语言",
+    "description": "The label for the mobile language switcher dropdown"
+  },
+  "theme.CodeBlock.wordWrapToggle": {
+    "message": "切换自动换行",
+    "description": "The title attribute for toggle word wrapping button of code block lines"
+  },
+  "theme.CodeBlock.copy": {
+    "message": "复制",
+    "description": "The copy button label on code blocks"
+  },
+  "theme.CodeBlock.copied": {
+    "message": "已复制",
+    "description": "The copied button label on code blocks"
+  },
+  "theme.CodeBlock.copyButtonAriaLabel": {
+    "message": "复制代码到剪贴板",
+    "description": "The ARIA label for copy code blocks button"
+  },
+  "theme.docs.sidebar.navAriaLabel": {
+    "message": "文档侧边栏",
+    "description": "The ARIA label for the sidebar navigation"
+  },
+  "theme.docs.breadcrumbs.home": {
+    "message": "首页",
+    "description": "The ARIA label for the home page in the breadcrumbs"
+  },
+  "theme.docs.sidebar.collapseButtonTitle": {
+    "message": "折叠侧边栏",
+    "description": "The title attribute for collapse button of doc sidebar"
+  },
+  "theme.docs.sidebar.collapseButtonAriaLabel": {
+    "message": "折叠侧边栏",
+    "description": "The title attribute for collapse button of doc sidebar"
+  },
+  "theme.docs.sidebar.closeSidebarButtonAriaLabel": {
+    "message": "关闭导航栏",
+    "description": "The ARIA label for close button of mobile sidebar"
+  },
+  "theme.navbar.mobileSidebarSecondaryMenu.backButtonLabel": {
+    "message": "← 返回主菜单",
+    "description": "The label of the back button to return to main menu, inside the mobile navbar sidebar secondary menu (notably used to display the docs sidebar)"
+  },
+  "theme.docs.sidebar.toggleSidebarButtonAriaLabel": {
+    "message": "切换导航栏",
+    "description": "The ARIA label for hamburger menu button of mobile navigation"
+  },
+  "theme.navbar.mobileDropdown.collapseButton.expandAriaLabel": {
+    "message": "展开下拉菜单",
+    "description": "The ARIA label of the button to expand the mobile dropdown navbar item"
+  },
+  "theme.navbar.mobileDropdown.collapseButton.collapseAriaLabel": {
+    "message": "折叠下拉菜单",
+    "description": "The ARIA label of the button to collapse the mobile dropdown navbar item"
+  },
+  "theme.docs.sidebar.expandButtonTitle": {
+    "message": "展开侧边栏",
+    "description": "The ARIA label and title attribute for expand button of doc sidebar"
+  },
+  "theme.docs.sidebar.expandButtonAriaLabel": {
+    "message": "展开侧边栏",
+    "description": "The ARIA label and title attribute for expand button of doc sidebar"
+  },
+  "theme.contentVisibility.unlistedBanner.title": {
+    "message": "未列出的页面",
+    "description": "The unlisted content banner title"
+  },
+  "theme.contentVisibility.unlistedBanner.message": {
+    "message": "此页面未列出。搜索引擎不会索引它，只有拥有直接链接的用户才能访问。",
+    "description": "The unlisted content banner message"
+  },
+  "theme.contentVisibility.draftBanner.title": {
+    "message": "草稿页面",
+    "description": "The draft content banner title"
+  },
+  "theme.contentVisibility.draftBanner.message": {
+    "message": "此页面是草稿。它只会在开发环境中可见，并会从生产构建中排除。",
+    "description": "The draft content banner message"
+  },
+  "theme.ErrorPageContent.tryAgain": {
+    "message": "重试",
+    "description": "The label of the button to try again rendering when the React error boundary captures an error"
+  },
+  "theme.common.skipToMainContent": {
+    "message": "跳到主要内容",
+    "description": "The skip to content label used for accessibility, allowing to rapidly navigate to main content with keyboard tab/enter navigation"
+  },
+  "theme.tags.tagsPageTitle": {
+    "message": "标签",
+    "description": "The title of the tag list page"
+  },
+  "theme.tagline": {
+    "message": "面向 Express.js 的声明式、基于装饰器的请求数据处理。",
+    "description": "The tagline of the site"
+  },
+  "theme.homepage.getStarted": {
+    "message": "快速开始",
+    "description": "The label of the getting started button on the homepage"
+  },
+  "theme.homepage.feature.declarative.title": {
+    "message": "声明式数据绑定",
+    "description": "Title for the 'Declarative Data Binding' feature on the homepage."
+  },
+  "theme.homepage.feature.declarative.description": {
+    "message": "使用直观的装饰器，将请求数据（body、query、params）轻松绑定到类实例，让路由逻辑保持清晰聚焦。",
+    "description": "Description of the declarative data binding feature. Emphasizes ease of use and clean code."
+  },
+  "theme.homepage.feature.validation.title": {
+    "message": "可靠的数据验证",
+    "description": "Title for the 'Robust Data Validation' feature on the homepage."
+  },
+  "theme.homepage.feature.validation.description": {
+    "message": "借助丰富的内置装饰器轻松验证数据，并在处理前确保数据完整性。",
+    "description": "Description of the data validation feature. Highlights the use of built-in decorators and the benefit of data integrity."
+  },
+  "theme.homepage.feature.typeSafe.title": {
+    "message": "类型安全且可扩展",
+    "description": "Title for the 'Type-Safe & Extensible' feature on the homepage."
+  },
+  "theme.homepage.feature.typeSafe.description": {
+    "message": "基于 TypeScript 构建，提供完整的类型安全，并允许你通过自定义装饰器和转换器扩展库。",
+    "description": "Description of the library's type safety and extensibility. Mentions TypeScript and custom decorators/transformers."
+  }
+}
diff --git a/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current.json b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current.json
new file mode 100644
index 0000000..34ae7a5
--- /dev/null
+++ b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current.json
@@ -0,0 +1,22 @@
+{
+  "version.label": {
+    "message": "下一版",
+    "description": "The label for version current"
+  },
+  "sidebar.docs.category.Getting Started": {
+    "message": "快速开始",
+    "description": "The label for category Getting Started in sidebar docs"
+  },
+  "sidebar.docs.category.Core Concepts": {
+    "message": "核心概念",
+    "description": "The label for category Core Concepts in sidebar docs"
+  },
+  "sidebar.docs.category.Advanced Usage": {
+    "message": "高级用法",
+    "description": "The label for category Advanced Usage in sidebar docs"
+  },
+  "sidebar.docs.category.Examples": {
+    "message": "示例",
+    "description": "The label for category Examples in sidebar docs"
+  }
+}
diff --git a/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/advanced/custom-transformer.md b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/advanced/custom-transformer.md
new file mode 100644
index 0000000..74f5e3f
--- /dev/null
+++ b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/advanced/custom-transformer.md
@@ -0,0 +1,158 @@
+# 自定义转换器
+
+`@Transform` 装饰器允许你定义自定义转换逻辑，该逻辑会在 Express-Cargo 的内置类型转换**之后**运行。它的用途是**细化值**，例如对类型已经确定的值进行规范化、限制范围或清理，而不是改变字段类型。
+
+如需了解基本的 `@Transform` 用法，请参阅[转换装饰器](/decorators/transforms)页面。
+
+:::note `@Transform` 细化的是值，而不是类型
+由于内置类型转换（`String`、`Number`、`Boolean`、`Date`、`Array`）会在 transformer 之前运行，你的函数接收到的是已经转换类型后的值，并应返回相同类型。如果原始请求值与声明类型不匹配（例如逗号分隔字符串传入声明为 `string[]` 的字段），类型转换会在你的 transformer 运行前失败。
+
+当你需要生成与原始来源不同形状的值时，例如把分隔字符串解析为数组、接受多种表示 true 的布尔写法等，请改用 [`@Request`](/decorators/virtual) 装饰器。它会完全绕过内置类型转换，并将 `Request` 对象直接交给你。请参阅下方[何时改用 `@Request`](#when-to-use-request-instead)一节。
+:::
+
+## 执行顺序
+
+理解 `@Transform` 的运行时机非常重要：
+
+1. 从请求来源（`@Query`、`@Body` 等）提取原始值
+2. **内置类型转换**将该值转换为声明类型（`String`、`Number`、`Boolean`、`Date`）
+3. **`@Transform`** 在已经完成类型转换的值上运行
+4. **验证**应用到最终结果
+
+这意味着你的 transformer 函数接收的是类型转换后的值，而不是原始字符串。
+
+## 实用配方
+
+### Enum 规范化
+
+规范化用户输入，使其匹配期望的 enum 值：
+
+```typescript
+enum SortOrder {
+    ASC = 'asc',
+    DESC = 'desc',
+}
+
+class ListRequest {
+    @Query()
+    @Transform((value: string) => value.toLowerCase() as SortOrder)
+    order!: SortOrder
+}
+
+// GET /list?order=DESC → { order: 'desc' }
+```
+
+### 清理字符串输入
+
+移除不需要的字符或规范化空白：
+
+```typescript
+class CommentRequest {
+    @Body()
+    @Transform((value: string) => value.trim().replace(/\s+/g, ' '))
+    content!: string
+}
+
+// POST { content: "  hello   world  " } → { content: "hello world" }
+```
+
+### 限制数字范围
+
+确保数字保持在可接受范围内：
+
+```typescript
+class PaginationRequest {
+    @Query()
+    @Transform((value: number) => Math.min(Math.max(value, 1), 100))
+    limit!: number
+}
+
+// GET /items?limit=500 → { limit: 100 }
+// GET /items?limit=-5  → { limit: 1 }
+```
+
+### 日期处理
+
+对解析后的日期应用调整：
+
+```typescript
+class ReportRequest {
+    @Query()
+    @Transform((value: Date) => {
+        // 将时间设置为一天开始（00:00:00）
+        value.setHours(0, 0, 0, 0)
+        return value
+    })
+    startDate!: Date
+}
+```
+
+## 与其他装饰器链式组合
+
+`@Transform` 可以和其他 Express-Cargo 装饰器顺畅配合：
+
+```typescript
+class ProductQuery {
+    @Query('q')
+    @Transform((value: string) => value.toLowerCase().trim())
+    @MinLength(1)
+    searchTerm!: string
+
+    @Query()
+    @Default(10)
+    @Transform((value: number) => Math.min(value, 50))
+    limit!: number
+}
+```
+
+:::tip
+保持 transformer 函数简单，并专注于单一职责。如果你需要复杂的多步骤转换，可以考虑组合工具函数：
+
+```typescript
+const normalize = (v: string) => v.trim().toLowerCase()
+const clamp = (min: number, max: number) => (v: number) => Math.min(Math.max(v, min), max)
+
+class Request {
+    @Query()
+    @Transform(normalize)
+    keyword!: string
+
+    @Query()
+    @Transform(clamp(1, 100))
+    page!: number
+}
+```
+:::
+
+## 何时改用 `@Request` {#when-to-use-request-instead}
+
+当请求值需要被重塑为不同类型，而不仅仅是细化时，`@Transform` 就不是合适工具，因为内置类型转换会先运行，并且可能失败或把值强制转换成与你期望不同的形式。使用 [`@Request`](/decorators/virtual) 可以绕过类型转换，并直接处理 `Request` 对象。
+
+### 逗号分隔字符串转数组
+
+```typescript
+class SearchRequest {
+    @Request(req => String(req.query.tags ?? '').split(',').map(v => v.trim()))
+    tags!: string[]
+}
+
+// GET /search?tags=node,express,cargo
+// Result: { tags: ['node', 'express', 'cargo'] }
+```
+
+### 灵活解析布尔值
+
+接受 `"yes"`、`"1"` 或 `"on"` 等多种表示 true 的写法，而不是只接受 `"true"`：
+
+```typescript
+class FilterRequest {
+    @Request(req => {
+        const raw = String(req.query.active ?? '').toLowerCase()
+        return ['true', 'yes', '1', 'on'].includes(raw)
+    })
+    active!: boolean
+}
+
+// GET /filter?active=yes → { active: true }
+// GET /filter?active=0   → { active: false }
+```
diff --git a/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/advanced/default.md b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/advanced/default.md
new file mode 100644
index 0000000..0be5586
--- /dev/null
+++ b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/advanced/default.md
@@ -0,0 +1,19 @@
+# 默认字段装饰器
+
+Express-Cargo 提供用于为请求字段定义默认值的装饰器。当传入请求没有提供某个值（undefined 或 null）时，该装饰器会自动赋予默认值。
+
+## 内置默认值装饰器
+
+### `@Default(value: T)`
+
+当请求没有提供某个类属性时，@Default 装饰器会为该属性赋予默认值。
+
+- **`value`**：当请求中不存在该字段时要赋予的默认值。
+
+```typescript
+class Request {
+    @Body()
+    @Default(1)
+    price!: number;
+}
+```
diff --git a/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/advanced/inherited-binding.md b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/advanced/inherited-binding.md
new file mode 100644
index 0000000..1716f5f
--- /dev/null
+++ b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/advanced/inherited-binding.md
@@ -0,0 +1,28 @@
+## 继承绑定
+
+字段装饰器也会应用到父类中声明的字段。  
+这使你可以在**基类**中定义通用字段，然后在**子类**中扩展或覆盖它们。
+
+### 示例
+
+```typescript
+class BaseRequest {
+  @Body()
+  @Length(10)
+  id!: string
+}
+
+class CreateUserRequest extends BaseRequest {
+  @Body()
+  @OneOf(["admin", "user"])
+  role!: string
+}
+```
+
+### 结果
+
+`CreateUserRequest` 将包含以下字段：
+
+- id：继承自 `BaseRequest`
+
+- role：定义在 `CreateUserRequest` 中
diff --git a/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/advanced/list-decorator.md b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/advanced/list-decorator.md
new file mode 100644
index 0000000..4282a46
--- /dev/null
+++ b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/advanced/list-decorator.md
@@ -0,0 +1,96 @@
+# List 装饰器
+
+Express-Cargo 的 `@List` 装饰器允许你从请求中自动绑定并转换数组类型。当你期望某个字段是特定类型的数组时，例如字符串、数字，甚至自定义对象，这会非常有用。
+
+## 使用示例
+
+```typescript
+import express, { Router } from 'express'
+import { Body, List, bindingCargo, getCargo } from 'express-cargo'
+
+const router: Router = express.Router()
+
+// 1. 定义自定义类（可选）
+class CustomClass {
+    @Body()
+    name!: string
+
+    @Body()
+    age!: number
+}
+
+// 2. 定义包含数组字段的类
+class ListSample {
+    @Body()
+    @List(String)
+    stringArray!: string[]
+
+    @Body()
+    @List(Number)
+    numberArray!: number[]
+
+    @Body()
+    @List(Boolean)
+    booleanArray!: boolean[]
+
+    @Body()
+    @List(Date)
+    dateArray!: Date[]
+
+    @Body()
+    @List('string')
+    stringLiteralArray!: string[]
+
+    @Body()
+    @List(CustomClass)
+    customClassArray!: CustomClass[]
+}
+
+// 3. 设置 Express 路由
+router.post('/list', bindingCargo(ListSample), (req, res) => {
+    const cargo = getCargo<ListSample>(req)
+    res.json(cargo)
+})
+
+export default router
+```
+
+## 输出示例
+
+如果你向 `/list` 发送如下 JSON body 的 POST 请求：
+
+```json
+{
+    "stringArray": ["apple", "banana"],
+    "numberArray": [1, 2, 3],
+    "booleanArray": [true, false],
+    "dateArray": ["2024-01-01", "2024-01-02"],
+    "stringLiteralArray": ["one", "two"],
+    "customClassArray": [
+        { "name": "John", "age": 30 },
+        { "name": "Jane", "age": 25 }
+    ]
+}
+```
+
+`getCargo` 函数将返回填充完整的 `ListSample` 对象：
+
+```typescript
+// getCargo<ListSample>(req) 返回的对象：
+const cargo = {
+  stringArray: ["apple", "banana"],
+  numberArray: [1, 2, 3],
+  booleanArray: [true, false],
+  dateArray: [
+    // 这些是真正的 Date 对象
+    new Date("2024-01-01T00:00:00.000Z"),
+    new Date("2024-01-02T00:00:00.000Z")
+  ],
+  stringLiteralArray: ["one", "two"],
+  customClassArray: [
+    // 这些是 CustomClass 的实例
+    { name: "John", age: 30 },
+    { name: "Jane", age: 25 }
+  ]
+};
+```
diff --git a/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/advanced/nested-binding.md b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/advanced/nested-binding.md
new file mode 100644
index 0000000..14c02b2
--- /dev/null
+++ b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/advanced/nested-binding.md
@@ -0,0 +1,57 @@
+# 嵌套对象绑定
+
+Express-Cargo 允许你处理请求中的嵌套对象，并在支持递归类型转换和验证的同时，将其自动绑定到嵌套对象。
+
+## 使用示例
+
+```typescript
+import express, { Request, Response } from 'express'
+import { Body, Type, bindingCargo, getCargo } from 'express-cargo'
+
+// 1. 定义嵌套对象
+class Profile {
+    @Body('nickname')
+    nickname!: string
+}
+
+class ExampleObject {
+    @Body('profile')
+    @Type(() => Profile)
+    profile!: Profile
+}
+
+// 2. 设置 Express 应用和路由
+const app = express()
+app.use(express.json())
+
+app.post('/submit', bindingCargo(ExampleObject), (req: Request, res: Response) => {
+    const requestData = getCargo<ExampleObject>(req)
+
+    res.json({
+        message: 'Nested bound successfully!',
+        data: requestData,
+    })
+})
+
+/*
+要测试此端点，请向 /submit 发送 POST 请求。
+
+示例请求 URL：
+http://localhost:3000/submit
+*/
+```
+
+## 输出示例
+
+当发送包含嵌套 profile 对象的 POST 请求时，`bindingCargo` 中间件会自动实例化并验证嵌套的 `ExampleObject`。随后 `getCargo` 函数会返回包含嵌套数据且填充完整的对象：
+
+```json
+{
+    "message": "Nested bound successfully!",
+    "data": {
+        "profile": {
+            "nickname": "coder123"
+        }
+    }
+}
+```
diff --git a/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/advanced/type-and-polymorphism.md b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/advanced/type-and-polymorphism.md
new file mode 100644
index 0000000..76795e6
--- /dev/null
+++ b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/advanced/type-and-polymorphism.md
@@ -0,0 +1,98 @@
+---
+id: type-and-polymorphism
+title: 类型转换与多态
+---
+
+`@Type` 装饰器是一个强大的工具，用于将普通 JSON 对象转换为真实的类实例。
+
+它对于保持类型安全、使用类方法，以及处理嵌套对象和多态数组等复杂数据结构非常重要。
+
+## 基础嵌套映射
+
+当某个属性需要成为另一个类的实例时，使用 `@Type` 指定目标类。
+
+```typescript
+import { Body, Type } from 'express-cargo';
+
+class Profile {
+  @Body()
+  bio!: string;
+}
+
+class User {
+  @Body()
+  name!: string;
+
+  @Body()
+  @Type(() => Profile) // 自动转换为 Profile 实例
+  profile!: Profile;
+}
+```
+
+## 解决循环依赖
+
+如果两个类互相引用（例如 `User` 拥有多个 `Posts`，而 `Post` 属于一个 `Author`），直接引用会导致 `ReferenceError`，因为类可能尚未定义。
+
+要解决这个问题，请使用 **Thunk（箭头函数）** 延迟类解析。
+
+```typescript
+class Post {
+    @Body()
+    title!: string;
+
+    @Body()
+    @Type(() => User) // 延迟解析，避免 "User is not defined" 错误
+    author!: User;
+}
+
+class User {
+    @Body()
+    name!: string;
+
+    /**
+     * @Type 会通过元数据自动检测数组类型。
+     * 不需要显式的 @List(Post) 装饰器。
+     */
+    @Body()
+    @Type(() => Post)
+    posts!: Post[];
+}
+```
+
+## 动态类型解析
+
+`@Type` 最高级的能力是根据传入数据在运行时确定目标类。这在处理继承和多态时尤其有用。
+
+### 函数式解析器
+
+你可以传入一个函数，检查数据并返回合适的类。
+
+```typescript
+class Example {
+    @Type((data) => {
+        if (data.type === 'video') return Video;
+        if (data.type === 'image') return Image;
+        return DefaultMedia;
+    })
+    featuredMedia!: Video | Image | DefaultMedia;
+}
+```
+
+### 结构化判别器
+
+如果想使用更清晰、更声明式的方式，可以使用 `discriminator` 选项，将特定属性值映射到对应的类。
+
+```typescript
+class Example {
+    @Type(() => Media, {
+        discriminator: {
+            property: 'kind',
+            subTypes: [
+                { name: 'v', value: Video },
+                { name: 'i', value: Image },
+            ],
+        },
+    })
+    gallery!: (Video | Image)[];
+}
+```
diff --git a/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/decorators/overview.md b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/decorators/overview.md
new file mode 100644
index 0000000..a021d6b
--- /dev/null
+++ b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/decorators/overview.md
@@ -0,0 +1,7 @@
+### 什么是装饰器？
+
+express-cargo 中的装饰器用于标注类字段，告诉中间件：
+
+- 从哪里提取数据（例如 body、query）
+- 如何验证数据
+- 如何转换数据
diff --git a/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/decorators/source-decorators.md b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/decorators/source-decorators.md
new file mode 100644
index 0000000..053b430
--- /dev/null
+++ b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/decorators/source-decorators.md
@@ -0,0 +1,76 @@
+## 内置装饰器
+
+| 装饰器       | 来源          |
+|--------------|---------------|
+| `@Body()`    | `req.body`    |
+| `@Query()`   | `req.query`   |
+| `@Header()`  | `req.headers` |
+| `@Uri()`     | `req.params`  |
+| `@Params()`  | `req.params`  |
+| `@Session()` | `req.session` |
+
+## 装饰器详情
+
+### `@Body()`
+
+从 HTTP 请求 body 中提取数据，并绑定到对应字段。
+
+- 来源：`req.body`
+
+---
+
+### `@Query()`
+
+从 HTTP 请求的 query 参数中提取数据，并绑定到对应字段。
+
+- 来源：`req.query`
+
+---
+
+### `@Header()`
+
+从 HTTP 请求头中提取值，并绑定到对应字段。  
+它常用于直接从 DTO 访问请求元数据，例如认证令牌（`Authorization`）或自定义请求头。
+
+- 来源：`req.headers`
+
+---
+
+### `@Uri()` / `@Params()`
+
+从 HTTP 请求 URL 中提取路径变量，并绑定到对应字段。  
+这通常用于在 REST API 中把资源标识符（例如 `id`）作为 DTO 的一部分接收。
+
+两个装饰器的内部行为完全相同，`@Uri()` 是 `@Params()` 的别名。
+
+- 来源：`req.params`
+- 常用于 `/users/:id`、`/posts/:postId` 等路由
+
+---
+
+### `@Session()`
+
+从 session 中提取已存储的值，并绑定到 DTO 字段。  
+它适合将认证用户信息等服务端状态传入 DTO。
+
+- 来源：`req.session`
+- 仅在已配置 session 中间件时可用
+
+---
+
+## 使用示例
+
+下面是在 Express 应用中使用来源装饰器的示例。
+
+```typescript
+class Request {
+    @Body('email')
+    email!: string
+
+    @Query('limit')
+    limit!: number
+
+    @Header('Authorization')
+    authorization!: string
+}
+```
diff --git a/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/decorators/transforms.md b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/decorators/transforms.md
new file mode 100644
index 0000000..e9f0752
--- /dev/null
+++ b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/decorators/transforms.md
@@ -0,0 +1,73 @@
+# 转换装饰器
+
+Express-Cargo 提供了一个装饰器，可以在请求数据绑定到类之前自动转换传入数据。它适用于规范化用户输入（例如将字符串转换为小写）或将逗号分隔的字符串解析为数组等任务。
+
+与通过组合已有字段创建新字段的虚拟字段不同，该转换装饰器会直接修改单个字段的值。
+
+## `@Transform<T>(transformer: (value: T) => T)`
+
+这是用于数据转换的主要装饰器。它接收一个 transformer 函数，该函数接收来自请求的原始值，并返回字段的新转换值。
+
+- `transformer`：接收原始值并返回转换后值的函数。
+
+## 使用示例
+
+此示例展示如何使用 `@Transform` 装饰器将请求数据规范化并处理成期望格式。它非常适合处理多样化的用户输入，并确保 API 以一致方式处理这些输入，从而提升应用稳定性。
+
+```typescript
+import express, { Request, Response } from 'express'
+import { bindingCargo, getCargo, Query, Transform } from 'express-cargo'
+
+// 1. 定义包含数据处理和规范化规则的类
+class SearchRequest {
+    // 将 'sortBy' 查询参数转换为小写，以便排序逻辑保持一致
+    @Query()
+    @Transform((value: string) => value.toLowerCase())
+    sortBy!: string
+
+    // 将 'count' 查询参数值翻倍
+    @Query()
+    @Transform((value: number) => value * 2)
+    count!: number
+}
+
+const app = express()
+app.use(express.json())
+
+// 2. 将 bindingCargo 中间件应用到路由
+app.get('/search', bindingCargo(SearchRequest), (req: Request, res: Response) => {
+    // 3. 使用正确类型访问转换后的数据
+    const searchParams = getCargo<SearchRequest>(req)
+
+    res.json({
+        message: 'Search parameters transformed successfully!',
+        data: searchParams,
+        // 验证转换后数据的类型
+        sortByType: typeof searchParams.sortBy,
+        countType: typeof searchParams.count,
+    })
+})
+
+/*
+要测试此端点，请向 /search 发送 GET 请求。
+
+示例请求 URL：
+http://localhost:3000/search?sortBy=TITLE&count=10
+*/
+```
+
+## 输出示例
+
+访问示例请求 URL 时，`bindingCargo` 中间件会处理 query 参数。随后 `@Transform` 装饰器会把 `sortBy` 值规范化为小写字符串，并将 `count` 值翻倍。`getCargo` 函数返回包含这些转换后值的对象。
+
+```json
+{
+    "message": "Search parameters transformed successfully!",
+    "data": {
+        "sortBy": "title",
+        "count": 20
+    },
+    "sortByType": "string",
+    "countType": "number"
+}
+```
diff --git a/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/decorators/validators.md b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/decorators/validators.md
new file mode 100644
index 0000000..830b282
--- /dev/null
+++ b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/decorators/validators.md
@@ -0,0 +1,357 @@
+# 验证装饰器
+
+Express-Cargo 使用装饰器验证绑定到类的传入请求数据。
+
+验证不是由独立的 `validate` 函数执行的。它被集成到 `bindingCargo` 中间件中，并在请求生命周期内自动验证数据。
+
+## 内置验证器
+
+### `@Optional()`
+
+将字段标记为可选，允许该字段被省略或设置为 `undefined`，且不会触发验证错误。
+
+### `@Min(value: number)`
+
+验证数字大于或等于指定的最小值。
+
+- **`value`**：允许的最小值。
+
+### `@Max(value: number)`
+
+验证数字小于或等于指定的最大值。
+
+- **`value`**：允许的最大值。
+
+### `@Range(min: number, max: number)`
+
+验证数字位于指定范围内，包含最小值和最大值。
+
+- **`min`**：允许的最小值。
+- **`max`**：允许的最大值。
+
+### `@Contains(seed: string)`
+
+验证字符串包含指定子字符串。
+
+- **`seed`**：字符串中必须包含的子字符串。
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+### `@Prefix(value: string)`
+
+验证字符串以指定前缀开头。
+
+- **`value`**：必需的起始文本。
+
+### `@Suffix(value: string)`
+
+验证字符串以指定后缀结尾。
+
+- **`value`**：必需的结尾文本。
+
+### `@Equal(value: any)`
+
+验证值与指定值严格相等（`===`）。
+
+- **`value`**：要比较的值。
+
+### `@NotEqual(value: any)`
+
+验证值与指定值严格不相等（`!==`）。
+
+- **`value`**：要比较的值。
+
+### `@IsTrue()`
+
+验证被装饰的属性为 true。
+
+### `@IsFalse()`
+
+验证被装饰的属性为 false。
+
+### `@Length(value: number)`
+
+验证被装饰字符串的长度恰好等于指定值。
+
+- **`value`**：所需的精确字符长度。
+
+### `@MaxLength(value: number)`
+
+验证被装饰字符串的长度不超过指定最大值。
+
+- **`value`**：允许的最大字符长度。
+
+### `@MinLength(value: number)`
+
+验证被装饰字符串的长度至少为指定最小值。
+
+- **`value`**：允许的最小字符长度。
+
+### `@OneOf(values: any[])`
+
+验证输入值是指定值集合中的一个。
+
+- **`values`**：允许值数组。
+
+### `@ListContains(values: any[], comparator?: (expected, actual) => boolean, message?: string)`
+
+验证数组包含所有指定值。支持原始值、对象、Date 和混合类型。
+
+- **`values`**：数组中必须存在的值。
+- **`comparator`**（可选）：自定义比较函数 `(expected, actual) => boolean`。提供后，所有比较都会委托给该函数，包括原始值。
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+> **警告**：对象比较默认使用深度相等。当 `values` 包含许多对象或深层嵌套结构时，性能可能下降。可以考虑使用 `comparator` 来获得更高效或更灵活的比较。
+
+### `@ListNotContains(values: any[], comparator?: (expected, actual) => boolean, message?: string)`
+
+验证数组不包含任何指定值。支持原始值、对象、Date 和混合类型。
+
+- **`values`**：数组中不得存在的值。
+- **`comparator`**（可选）：自定义比较函数 `(expected, actual) => boolean`。提供后，所有比较都会委托给该函数，包括原始值。
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+> **警告**：对象比较默认使用深度相等。当 `values` 包含许多对象或深层嵌套结构时，性能可能下降。可以考虑使用 `comparator` 来获得更高效或更灵活的比较。
+
+### `@Enum(enumObj: object, message?: string)`
+
+验证输入值匹配指定 enum 对象中的某个值。
+它还会自动将输入值（例如字符串 key）转换为对应的 enum 值。
+
+- **`enumObj`**：用于验证的 enum 对象。
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+### `@Validate(validateFn: (value: unknown) => boolean, message?: string)`
+
+使用自定义验证函数验证值。
+该装饰器提供灵活性，可实现内置验证器之外的验证逻辑。
+
+- **`validateFn`**：接收字段值并在有效时返回 true、无效时返回 false 的函数。
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+### `@Regexp(pattern: RegExp, message?: string)`
+
+验证被装饰字段匹配指定正则表达式模式。
+该装饰器适合强制执行 email、电话号码等格式规则。
+
+- **`pattern`**：用于测试字段值的 RegExp 对象。值匹配该模式时即为有效。
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+### `@Email()`
+
+验证被装饰属性是有效的 email 地址。
+
+### `@Alpha(message?: string)`
+
+验证被装饰字段只包含字母字符（大写或小写英文字母，A-Z / a-z）。
+
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+### `@Uuid(version?: 'v1' | 'v3' | 'v4' | 'v5', message?: string)`
+
+验证被装饰字段是有效的 UUID 字符串，并可选地限制为特定版本（v1、v3、v4 或 v5）。
+
+- **`version`**（可选）：要验证的特定 UUID 版本。省略时会验证 v1、v3、v4 或 v5。
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+### `@Alphanumeric(message?: string)`
+
+验证被装饰字段只包含字母数字字符（英文字母和数字，A-Z、a-z、0-9）。
+
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+### `@IsUppercase(message?: string)`
+
+验证被装饰字段只包含大写字符。
+
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+### `@IsLowercase(message?: string)`
+
+验证被装饰字段只包含小写字符。
+
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+### `@IsJwt(message?: string)`
+
+验证被装饰字段符合 JWT 格式（`header.payload.signature`）。每一部分都必须由 Base64URL 字符组成（A-Z、a-z、0-9、`-`、`_`）。该装饰器只检查格式，不验证签名或 token 有效性。
+
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+### `@IsUrl(options?: IsUrlOptions, message?: string)`
+
+验证被装饰字段是有效 URL。默认允许 `http`、`https` 和 `ftp` 协议。
+
+- **`options`**（可选）：
+  - **`protocols`**：允许的协议数组。默认为 `['http', 'https', 'ftp']`。
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+### `@IsPhoneNumber(region?: CountryCode, message?: string)`
+
+验证被装饰字段是有效电话号码。使用 [libphonenumber-js](https://github.com/catamphetamine/libphonenumber-js) 实现跨国家的准确验证。
+
+提供 region 时，会接受本地格式（不带国家码）。未提供 region 时，号码必须包含国家码（例如 `+82`）。如果号码包含以 `+` 开头的国家码前缀，则会忽略 region 参数，并根据号码自身的国家码进行验证。
+
+- **`region`**（可选）：ISO 3166-1 alpha-2 地区代码（例如 `'KR'`、`'US'`）。省略时，号码必须为国际格式。
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+### `@IsTimeZone(message?: string)`
+
+验证被装饰字段是有效的 IANA 时区标识符（例如 `Asia/Seoul`、`America/New_York`、`UTC`）。使用内置 `Intl` API 进行验证，不需要外部依赖。
+
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+### `@IsHexColor(message?: string)`
+
+验证被装饰字段是有效的十六进制颜色代码。支持 `#RGB`、`#RGBA`、`#RRGGBB` 和 `#RRGGBBAA` 格式（大小写不敏感）。必须包含 `#` 前缀。
+
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+### `@IsHexadecimal(message?: string)`
+
+验证被装饰字段是十六进制数字。值只能包含 `0-9` 和 `a-f` 字符（大小写不敏感）。也允许 `0x` 前缀。
+
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+### `@IsHash(algorithm: HashAlgorithm, message?: string)`
+
+验证被装饰字段是给定算法的有效 hash 字符串。支持的算法：`md5`、`sha1`、`sha256`、`sha384`、`sha512`、`crc32`、`crc32b`。值必须是长度与算法要求完全一致的十六进制字符串。
+
+- **`algorithm`**：用于验证的 hash 算法。
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+### `@MinDate(min: Date | (() => Date), message?: string)`
+
+验证被装饰字段是一个 `Date`，且不早于给定的最小日期。接受固定 `Date` 或返回 `Date` 的函数，以支持动态比较。
+
+- **`min`**：允许的最小日期，或返回该日期的函数。
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+### `@MaxDate(max: Date | (() => Date), message?: string)`
+
+验证被装饰字段是一个 `Date`，且不晚于给定的最大日期。接受固定 `Date` 或返回 `Date` 的函数，以支持动态比较。
+
+- **`max`**：允许的最大日期，或返回该日期的函数。
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+### `@With(fieldName: string, message?: string)`
+
+验证如果被装饰字段有值，则指定目标字段（fieldName）也必须有值，从而在两个字段之间建立必需依赖关系。
+
+- **`fieldName`**：当被装饰字段有值时，也必须有值的目标字段名称。
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+### `@Without(fieldName: string, message?: string)`
+
+验证如果被装饰属性有值，则指定目标属性不得有值，从而在两个属性之间建立互斥关系。
+
+- **`fieldName`**：当被装饰字段有值时必须为空的目标属性名称。
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+### `@Each(...args: (Validator | Function)[])`
+
+验证数组中的每个独立元素。它可以接收其他验证装饰器或自定义验证函数。
+
+- `args`：验证装饰器（例如 @Min(5)）或自定义函数 `(value: any) => boolean`。
+
+### `@ListMaxSize(max: number, message?: string)`
+
+验证数组包含的元素数量不超过指定数量。
+
+- **`max`**：数组允许的最大元素数量。
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+### `@ListMinSize(min: number, message?: string)`
+
+验证数组包含的元素数量至少达到指定数量。
+
+- **`min`**：数组允许的最小元素数量。
+- **`message`**（可选）：验证失败时显示的错误消息。省略时使用默认消息。
+
+## 使用示例
+
+下面是一个在 Express 应用中使用验证装饰器的完整示例。
+
+```typescript
+import express, { Request, Response, NextFunction } from 'express'
+import { bindingCargo, getCargo, Body, Min, Max, Suffix, CargoValidationError } from 'express-cargo'
+
+// 1. 定义包含来源和验证规则的类
+class CreateAssetRequest {
+    @Body('name')
+    assetName!: string
+
+    @Body('type')
+    @Suffix('.png')
+    assetType!: string
+
+    @Body('quantity')
+    @Min(1)
+    @Max(100)
+    quantity!: number
+}
+
+const app = express()
+app.use(express.json())
+
+// 2. 将 bindingCargo 中间件应用到路由
+app.post('/assets', bindingCargo(CreateAssetRequest), (req: Request, res: Response) => {
+    // 3. 如果验证成功，使用 getCargo 访问数据
+    const assetData = getCargo<CreateAssetRequest>(req)
+    res.json({
+        message: 'Asset created successfully!',
+        data: assetData,
+    })
+})
+
+// 4. 添加错误处理中间件以捕获验证错误
+app.use((err: Error, req: Request, res: Response, next: NextFunction) => {
+    if (err instanceof CargoValidationError) {
+        res.status(400).json({
+            message: 'Validation Failed',
+            errors: err.errors.map(e => e.message),
+        })
+    } else {
+        next(err)
+    }
+})
+
+/*
+要测试此端点，请向 /assets 发送 POST 请求。
+
+有效请求 body 示例：
+{
+    "name": "My-Asset",
+    "type": "icon.png",
+    "quantity": 10
+}
+
+无效请求 body 示例：
+{
+    "name": "My-Asset",
+    "type": "icon.jpg", // 未通过 @Suffix('.png')
+    "quantity": 101     // 未通过 @Max(100)
+}
+*/
+```
+
+## 错误处理
+
+验证失败时，`bindingCargo` 中间件会抛出 `CargoValidationError`。你应该注册一个 Express 错误处理中间件来捕获该错误并格式化响应。
+
+`CargoValidationError` 对象有一个 `errors` 属性，其中保存 `CargoFieldError` 实例数组。每个 `CargoFieldError` 对象都包含 `message` 属性，其中是描述具体错误的格式化字符串（例如 `"quantity: quantity must be <= 100"`）。
+
+如代码示例所示，常见的处理方式是遍历 `err.errors` 数组，生成这些错误消息的简单列表。
+
+**错误响应示例：**
+
+当发送上方示例中的无效请求 body 时，错误处理器会生成如下 JSON 响应，其中包含格式化错误消息数组。
+
+```json
+{
+    "message": "Validation Failed",
+    "errors": [
+        "type: assetType must end with .png",
+        "quantity: quantity must be <= 100"
+    ]
+}
+```
diff --git a/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/decorators/virtual.md b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/decorators/virtual.md
new file mode 100644
index 0000000..1934a76
--- /dev/null
+++ b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/decorators/virtual.md
@@ -0,0 +1,76 @@
+# 虚拟字段装饰器
+
+**Express-Cargo** 提供用于定义**虚拟字段**和**请求派生字段**的装饰器。这些装饰器允许你动态计算值，或将 `Request` 中的数据直接映射到对象属性。
+
+## 内置虚拟装饰器
+
+### `@Virtual<T>(transformer: (obj: object) => T)`
+
+`@Virtual` 装饰器定义一个**计算属性**，该属性并不直接来自请求。它的值由对象的其他属性派生而来。
+
+- **`transformer`**：接收对象实例并返回计算值的函数。
+
+### `@Request<T>(transformer: (req: Request) => T)`
+
+`@Request` 装饰器将 Express `Request` 对象中的值映射到类属性。
+
+- **`transformer`**：接收 Request 对象并返回要绑定值的函数。
+
+## 使用示例
+
+```typescript
+import express from 'express'
+import { Body, Virtual, Request, bindingCargo, getCargo } from 'express-cargo'
+
+// 1. 定义包含虚拟字段和请求派生字段的对象
+class OrderExample {
+    @Body('price')
+    price!: number
+
+    @Body('quantity')
+    quantity!: number
+
+    // 请求中不存在的计算字段
+    @Virtual((obj: OrderExample) => obj.price * obj.quantity)
+    total!: number
+}
+
+class HeaderExample {
+    // 直接从请求对象派生的字段
+    @Request(req => req.headers['x-custom-header'] as string)
+    customHeader!: string
+}
+
+// 2. 设置 Express 应用和路由
+const app = express()
+app.use(express.json())
+
+app.post('/orders', bindingCargo(OrderExample), (req, res) => {
+    const orderData = getCargo<OrderExample>(req)
+    res.json({
+        message: 'Order data processed with virtual fields!',
+        data: orderData
+    })
+})
+
+app.post('/headers', bindingCargo(HeaderExample), (req, res) => {
+    const headerData = getCargo<HeaderExample>(req)
+    res.json({
+        message: 'Header data mapped using @request!',
+        data: headerData
+    })
+})
+
+/*
+要测试这些端点，请使用相关 body 或 headers 发送 POST 请求：
+
+/orders body 示例：
+{
+    "price": 50,
+    "quantity": 2
+}
+
+/headers headers 示例：
+x-custom-header: my-header-value
+*/
+```
diff --git a/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/examples/basic-usage.md b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/examples/basic-usage.md
new file mode 100644
index 0000000..a1abfab
--- /dev/null
+++ b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/examples/basic-usage.md
@@ -0,0 +1 @@
+> 使用 bindingCargo 的基础 POST 处理器
diff --git a/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/examples/nested-request.md b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/examples/nested-request.md
new file mode 100644
index 0000000..aa69a43
--- /dev/null
+++ b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/examples/nested-request.md
@@ -0,0 +1,120 @@
+# 处理嵌套请求
+
+此示例展示 **Express-Cargo** 如何填充嵌套 Requests，让你可以将复杂且结构化的请求数据映射到一个组织良好的对象中。
+
+## 1. 定义你的 Requests
+
+在此场景中，我们将定义两个类：`UserInfoRequest` 和 `OrderRequest`。`UserInfoRequest` 类从请求 body 中提取用户详情，并从 headers 中提取认证 token。
+
+**`UserInfoRequest`** - 将用户详情映射自请求 body，并从 headers 中提取授权 token。
+
+```typescript
+// user.request.ts
+import { Body, Header, Optional, Prefix, Transform } from 'express-cargo'
+
+export class UserInfoRequest {
+    @Body('name')
+    name!: string
+
+    @Body('email')
+    @Prefix('user-')
+    email!: string
+
+    @Body('age')
+    @Optional()
+    age?: number
+
+    // 从 Authorization header 中提取 token。
+    @Header('authorization')
+    @Transform((value: string) => {
+        if (value.startsWith('Bearer ')) {
+            return value.substring(7);
+        }
+        return ''
+    })
+    authorization!: string
+}
+```
+
+**`OrderRequest`** - 表示订单请求，其中包含一个嵌套的 `UserInfoRequest`。
+
+```typescript
+// order.request.ts
+import { Body, Min, Max, Type } from 'express-cargo'
+import { UserInfoRequest } from './user.request'
+
+export class OrderRequest {
+    @Body('productId')
+    productId!: string
+
+    @Body('quantity')
+    @Min(1)
+    @Max(10)
+    quantity!: number
+
+    @Body('user')
+    @Type(() => UserInfoRequest)
+    user!: UserInfoRequest
+}
+```
+
+在 `UserInfoRequest` 中，我们在 `authorization` 属性上使用 `@header` 装饰器，从 `Authorization` header 获取值。然后，`@transform` 装饰器只提取 token 值，并移除 `"Bearer "` 前缀。
+
+## 2. 在 Express 路由中使用
+
+只需把 `bindingCargo` 中间件应用到路由，并传入顶层 Request：`OrderRequest`。中间件会为你处理所有绑定逻辑。
+
+```typescript
+router.post('/orders', bindingCargo(OrderRequest), (req, res) => {
+    const order = getCargo<OrderRequest>(req)
+
+    if (order) {
+        console.log(`Processing order for product: ${order.productId}`)
+        console.log(`User name: ${order.user.name}`)
+        console.log(`Auth token: ${order.user.authorization}`)
+
+        // 现在可以使用 auth token 执行验证或其他逻辑。
+        res.json({ message: 'Order received', order })
+    }
+})
+```
+
+## 3. 示例请求
+
+该路由可以成功处理同时包含 body 和 `Authorization` header 的请求。
+
+- Request Body:
+    ```json
+    {
+        "productId": "SKU-456",
+        "quantity": 5,
+        "user": {
+            "name": "Jane Doe",
+            "email": "user-jane@example.com"
+        }
+    }
+    ```
+
+- Request Headers:
+
+    ```
+    Authorization: Bearer my-auth-token-12345
+    ```
+
+处理后，`getCargo(req)` 将返回一个包含所有数据的 `OrderRequest` 对象，并且 `authorization` 属性会正确填充为 header 中的值。这展示了 **Express-Cargo** 如何优雅地将多个数据来源统一成一个清晰对象。
+
+## 4. 示例结果
+
+最终绑定得到的 `OrderRequest` 对象：
+
+```json
+{
+    "productId": "SKU-456",
+    "quantity": 5,
+    "user": {
+        "name": "Jane Doe",
+        "email": "user-jane@example.com",
+        "authorization": "my-auth-token-12345"
+    }
+}
+```
diff --git a/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/examples/validation-errors.md b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/examples/validation-errors.md
new file mode 100644
index 0000000..a6203b8
--- /dev/null
+++ b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/examples/validation-errors.md
@@ -0,0 +1,114 @@
+# 错误处理
+
+验证失败时，`bindingCargo` 会抛出 `CargoValidationError`。你可以使用 `setCargoErrorHandler` 或 Express 内置错误处理中间件来处理该错误。
+
+---
+
+## 错误类型
+
+### `CargoValidationError`
+
+当一个或多个字段验证失败时抛出。
+
+| 属性 | 类型 | 描述 |
+|---|---|---|
+| `name` | `string` | 始终为 `'CargoValidationError'` |
+| `errors` | `CargoFieldError[]` | 字段级错误列表 |
+
+### `CargoFieldError`
+
+表示单个字段验证失败。
+
+| 属性 | 类型 | 描述 |
+|---|---|---|
+| `name` | `string` | 始终为 `'CargoFieldError'` |
+| `field` | `string \| symbol` | 验证失败的字段名称 |
+| `message` | `string` | 错误消息 |
+
+---
+
+## 方案 1：`setCargoErrorHandler`（推荐）
+
+在应用启动时注册一次全局处理器。所有路由中的验证错误都会被自动处理。
+
+```typescript
+import { setCargoErrorHandler, CargoValidationError } from 'express-cargo'
+
+setCargoErrorHandler((err, req, res, next) => {
+    res.status(400).json({
+        error: 'Validation failed',
+        details: err.errors.map(e => ({
+            field: e.field,
+            message: e.message,
+        })),
+    })
+})
+```
+
+**响应示例：**
+
+```json
+{
+    "error": "Validation failed",
+    "details": [
+        { "field": "email", "message": "email should be a valid email" },
+        { "field": "age", "message": "age must be >= 0" }
+    ]
+}
+```
+
+---
+
+## 方案 2：Express 错误中间件
+
+使用 Express 标准的 4 参数错误中间件来捕获 `CargoValidationError`。
+
+```typescript
+import { CargoValidationError } from 'express-cargo'
+import { Request, Response, NextFunction } from 'express'
+
+app.use((err: Error, req: Request, res: Response, next: NextFunction) => {
+    if (err instanceof CargoValidationError) {
+        return res.status(400).json({
+            error: 'Validation failed',
+            details: err.errors.map(e => ({
+                field: e.field,
+                message: e.message,
+            })),
+        })
+    }
+    next(err)
+})
+```
+
+> **注意：** 如果已注册 `setCargoErrorHandler`，它会优先执行。只有在 `setCargoErrorHandler` 内调用 `next(err)` 时，Express 错误中间件才会收到该错误。
+
+---
+
+## 处理多个错误
+
+单个请求可能同时未通过多个验证。所有错误都会被收集并一起返回。
+
+```typescript
+class CreateUserDto {
+    @Body()
+    @Email()
+    email!: string
+
+    @Body()
+    @Min(0)
+    age!: number
+}
+```
+
+如果两个字段都无效，`err.errors` 将包含两个条目：
+
+```json
+{
+    "error": "Validation failed",
+    "details": [
+        { "field": "email", "message": "email should be a valid email" },
+        { "field": "age", "message": "age must be >= 0" }
+    ]
+}
+```
diff --git a/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/faq.md b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/faq.md
new file mode 100644
index 0000000..77c3fff
--- /dev/null
+++ b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/faq.md
@@ -0,0 +1,107 @@
+---
+title: 常见问题
+sidebar_label: 常见问题
+---
+
+这里整理了使用该库时的常见问题。点击问题即可展开答案。
+
+### 1. 快速开始
+
+<details>
+<summary><b>Q: express-cargo 项目是什么？</b></summary>
+
+**A:** 它是一个中间件，旨在用基于类的方式自动化 Express.js 中重复且繁琐的请求数据处理（`req.body`、`req.query` 等）。通过 TypeScript 装饰器，你可以在一个地方以声明式方式处理数据绑定和验证。
+</details>
+
+<details>
+<summary><b>Q: 安装时有什么注意事项？</b></summary>
+
+**A:** 推荐使用 **Node.js 20 或更高版本**。它被设计为标准中间件，可以灵活集成到现有 Express 项目中。
+</details>
+
+<details>
+<summary><b>Q: TypeScript 配置是必需的吗？</b></summary>
+
+**A:** 是的。因为它使用装饰器，你必须在 `tsconfig.json` 中将以下两个选项设置为 `true`：
+- `experimentalDecorators: true`
+- `emitDecoratorMetadata: true`
+
+此外，还必须安装 `reflect-metadata` 包，以便在运行时读取类型信息。
+</details>
+
+### 2. 数据绑定与装饰器
+
+<details>
+<summary><b>Q: `@Body` 和 `@Query` 有什么区别？</b></summary>
+
+**A:** 区别在于数据提取来源：
+- **`@Body`**：从 HTTP Request body 中提取数据。主要用于 `POST` 和 `PUT` 请求。
+- **`@Query`**：从 URL 查询字符串中提取参数（例如 `?id=1&name=test`）。主要用于 `GET` 请求中的过滤或排序。
+- 你也可以使用 `@Params()`（或 `@Uri()`）、`@Header()`、`@Session()` 绑定其他类型的请求数据。
+</details>
+
+<details>
+<summary><b>Q: @Uri() 是什么？它和 @Params() 不同吗？</b></summary>
+
+**A:** `@Uri()` 是 `@Params()` 的**别名**。绑定 URL 路径参数（例如 `/:id`）时，你可以根据可读性偏好选择使用哪一个。
+</details>
+
+<details>
+<summary><b>Q: 如何获取已绑定的数据？</b></summary>
+
+**A:** 在路由中通过 `bindingCargo(ClassName)` 中间件后，你可以在处理器里调用 `getCargo<ClassName>(req)` 函数来获取实例。
+</details>
+
+### 3. 验证与转换
+
+<details>
+<summary><b>Q: 验证失败会如何处理？</b></summary>
+
+**A:** 验证会在内部使用 `@Min`、`@Max`、`@Length` 等装饰器执行。如果检测到无效数据，中间件会自动返回错误响应或抛出异常。
+</details>
+
+<details>
+<summary><b>Q: 如何处理或转换字段值？</b></summary>
+
+**A:** 使用 **`@Transform()`** 装饰器。例如，编写 `@Transform(v => v.trim())` 可以在绑定前将输入数据转换为期望格式。
+</details>
+
+<details>
+<summary><b>Q: 如果某个字段缺失，如何避免错误？</b></summary>
+
+**A:** 使用 **`@Optional()`** 装饰器。即使该字段值为 `null` 或 `undefined`，也可以成功绑定，并跳过该字段的验证。
+</details>
+
+### 4. 框架兼容性
+
+<details>
+<summary><b>Q: 可以和 Fastify 或 NestJS 一起使用吗？</b></summary>
+
+**A:** 该库专门设计为 **Express.js 专用中间件**。
+- **NestJS**：NestJS 自带 `ValidationPipe` 和装饰器，功能上可能重叠。虽然在使用 Express adapter 时技术上可行，但该库的主要目标是提升纯 Express 环境中的 DX。
+- **Fastify**：目前未提供官方支持。
+</details>
+
+### 5. 故障排查
+
+<details>
+<summary><b>Q: 为什么我的类实例数据返回 `undefined`？</b></summary>
+
+**A:** 请检查以下两点：
+- 是否在 `bindingCargo` **之前**声明了类似 `express.json()` 的 body 解析中间件？
+- 是否在应用入口文件的最顶部导入了 `reflect-metadata`？
+</details>
+
+<details>
+<summary><b>Q: 会发生自动类型转换吗？</b></summary>
+
+**A:** 会。它会根据类字段中定义的类型（`string`、`number`、`boolean` 等）尝试自动转换值。例如，来自 `@Query()` 的字符串 `"123"`，如果字段类型定义为 `number`，会自动转换为数字。
+</details>
+
+### 6. 其他
+
+<details>
+<summary><b>Q: 可以在商业项目中免费使用吗？</b></summary>
+
+**A:** 该库基于 **MIT License** 授权。你可以自由使用、修改和分发，包括用于商业用途，不受限制。
+</details>
diff --git a/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started.md b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started.md
new file mode 100644
index 0000000..e9dd0c5
--- /dev/null
+++ b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started.md
@@ -0,0 +1,154 @@
+## 🚀 express-cargo 快速开始
+
+本文档提供一个最小配置指南，帮助你在 **TypeScript + Express 环境中快速体验 express-cargo**。
+示例基于 **pnpm + Node.js 18 或更高版本**。
+
+---
+
+### 1. 要求
+
+- Node.js **18 或更高版本（推荐 LTS）**
+
+包管理器：npm | yarn | pnpm
+→ 本文档使用 pnpm。
+
+> 由于 express-cargo 使用 Decorator + Metadata，推荐使用 TypeScript。
+
+---
+
+### 2. 安装 Node.js
+
+请从下方官方网站安装适合你操作系统的 LTS 版本。
+
+- Node.js 官方下载
+    https://nodejs.org
+
+验证安装：
+
+```shell
+node -v
+pnpm -v
+```
+
+如果安装成功，将显示版本号。
+
+---
+
+### 3. 创建新项目（pnpm）
+
+#### pnpm
+
+```shell
+mkdir express-cargo-example
+cd express-cargo-example
+pnpm init
+```
+
+### 4. 设置 TypeScript 环境
+
+#### 4-1. 安装 TypeScript 和开发依赖
+
+```shell
+pnpm add -D typescript ts-node @types/node
+```
+
+#### 4-2. 创建 tsconfig.json
+
+```shell
+pnpm tsc --init
+```
+
+#### 4-3. 推荐的 tsconfig 设置
+
+```json
+{
+  "compilerOptions": {
+    ...,
+    "experimentalDecorators": true,     // express-cargo 必需
+    "emitDecoratorMetadata": true,      // 使用类型元数据
+    ...
+  },
+  ...
+}
+```
+
+>⚠️ 如果没有 experimentalDecorators 和 emitDecoratorMetadata，
+> express-cargo 的验证/转换功能将无法工作。
+
+---
+
+### 5. 安装 express 和 express-cargo
+
+```shell
+pnpm add express express-cargo
+pnpm add -D @types/express
+pnpm add reflect-metadata
+```
+
+---
+
+### 6. 基础服务器 + express-cargo 设置
+
+#### 6-1. `src/app.ts`
+
+```typescript
+import express, { Request, Response, NextFunction } from 'express'
+import { bindingCargo, getCargo, Body, Equal, CargoValidationError } from 'express-cargo'
+
+const app = express()
+
+const port = process.env.PORT || 3000
+
+app.use(express.json())
+app.use(express.urlencoded({ extended: true }))
+
+class ExampleRequest {
+  @Body() // 从请求 body 中提取字段
+  @Equal('1') // 如果值不是 "1"，会发生验证错误
+  id!: string
+}
+
+app.post('/example', bindingCargo(ExampleRequest), (req, res) => { // bindingCargo(Class)：Request → DTO 转换 + 验证
+  const cargo = getCargo<ExampleRequest>(req) // 返回经过验证的类型安全对象
+  res.json(cargo)
+})
+
+app.use((err: Error, req: Request, res: Response, next: NextFunction) => {
+  if (err instanceof CargoValidationError) {
+    res.status(400).json({
+      errors: err.errors.map(error => error.message),
+    })
+    return
+  }
+
+  next(err)
+})
+
+app.listen(port, () => {console.log(`Example app listening on port ${port}`)})
+```
+
+### 7. 运行
+
+```shell
+npm run dev
+```
+
+测试请求：
+
+```
+POST http://localhost:3000/example
+Content-Type: application/json
+
+{
+  "id": "1"
+}
+
+```
+
+响应：
+
+```
+{ "id": "1" }
+```
+
+- ❌ `"id": "2"` → 会发生验证错误
diff --git a/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/installation.md b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/installation.md
new file mode 100644
index 0000000..e659c0e
--- /dev/null
+++ b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/installation.md
@@ -0,0 +1,39 @@
+## 安装
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+<Tabs groupId="package-manager">
+    <TabItem value="npm" label="npm">
+        ```
+        npm install express-cargo reflect-metadata
+        ```
+    </TabItem>
+    <TabItem value="yarn" label="yarn">
+        ```
+        yarn add express-cargo reflect-metadata
+        ```
+    </TabItem>
+    <TabItem value="pnpm" label="pnpm">
+        ```
+        pnpm add express-cargo reflect-metadata
+        ```
+    </TabItem>
+</Tabs>
+
+## 要求
+
+- Node.js 20+
+- 已启用 TypeScript
+
+
+### tsconfig.json
+
+```json
+{
+    "compilerOptions": {
+        "experimentalDecorators": true,
+        "emitDecoratorMetadata": true
+    }
+}
+```
diff --git a/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/intro.md b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/intro.md
new file mode 100644
index 0000000..91982bf
--- /dev/null
+++ b/apps/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/intro.md
@@ -0,0 +1,51 @@
+# express-cargo 简介
+
+## 概览
+
+express-cargo 是一个轻量级中间件库，
+面向基于 Express.js 框架的 Web 应用开发。
+该库利用装饰器模式，提供基于类的请求数据绑定与验证功能。
+它可以将通过 HTTP 请求（Request）收到的多种数据格式自动映射到开发者定义的类，
+同时简化这些数据的验证流程。
+
+## 为什么选择 express-cargo？
+
+虽然 Express.js 提供了灵活的架构，
+但在处理请求数据时，重复劳动和维护成本很容易成为问题。
+express-cargo 正是为了解决这些开发痛点，
+从而提升开发效率与代码健壮性。
+
+### 1. 减少样板代码
+
+- **传统方式的挑战**：在 Express.js 环境中，需要在每个路由处理器里反复从 `req.body`、`req.query`、
+  `req.params`、`req.headers` 中提取数据，并重复实现类型检查和验证逻辑，这会导致代码重复和生产力下降。
+- **express-cargo 的方案**：express-cargo 使用装饰器，在 Request 类中以声明式方式定义数据提取和映射逻辑。
+  开发者只需声明数据来源，就能减少重复的数据处理代码，从而提升生产力。
+
+### 2. 增强类型安全与可读性
+
+- **传统方式的挑战**：在 JavaScript 环境中，请求数据的类型可靠性较低；即使在 TypeScript 环境中，手动类型断言也可能带来运行时错误。
+  此外，数据处理逻辑和业务逻辑交织在一起，也会降低代码可读性。
+- **express-cargo 的方案**：express-cargo 会基于 Request 类中声明的类型执行自动数据映射与类型转换，
+  让类型错误更早在编译阶段暴露，并增强运行时稳定性。定义清晰的 DTO 类可以直观呈现 API 期望的输入结构，提高代码可读性。
+
+### 3. 结构化验证与一致的错误处理
+
+- **传统方式的挑战**：当数据验证逻辑分散在多个控制器中时，维护会变得困难，并且难以应用一致的错误处理策略。
+- **express-cargo 的方案**：express-cargo 提供内置和自定义验证装饰器，让验证规则可以在 Request 类中声明式定义。
+  请求数据绑定过程中会自动执行验证；如果验证失败，可通过用户自定义的错误处理生成一致且可预测的响应。
+
+## ✨ 主要特性
+
+- 基于类的请求绑定
+- 内置和自定义验证装饰器
+- 支持嵌套对象
+- 自动类型转换
+- 支持虚拟字段和计算值
+- 可自定义错误处理
+
+> 一个轻量级 Express 中间件，使用装饰器实现基于类的请求绑定和验证。
+
+express-cargo 能减少重复任务带来的负担，提高代码质量和稳定性，
+让开发者在 Express.js 开发环境中专注于实现核心业务逻辑。
+使用 express-cargo，体验更健壮、更高效的 Express.js 应用开发。
diff --git a/apps/docs/i18n/zh-Hans/docusaurus-theme-classic/footer.json b/apps/docs/i18n/zh-Hans/docusaurus-theme-classic/footer.json
new file mode 100644
index 0000000..874cef1
--- /dev/null
+++ b/apps/docs/i18n/zh-Hans/docusaurus-theme-classic/footer.json
@@ -0,0 +1,30 @@
+{
+  "link.title.Docs": {
+    "message": "文档",
+    "description": "The title of the footer links column"
+  },
+  "link.title.More": {
+    "message": "更多",
+    "description": "Footer column title"
+  },
+  "link.item.label.Getting Started": {
+    "message": "快速开始",
+    "description": "Link to intro page"
+  },
+  "link.item.label.Core Concepts": {
+    "message": "核心概念",
+    "description": "Link to core concepts page"
+  },
+  "link.item.label.Examples": {
+    "message": "示例",
+    "description": "Link to usage examples"
+  },
+  "link.item.label.GitHub": {
+    "message": "在 GitHub 查看",
+    "description": "GitHub project link"
+  },
+  "copyright": {
+    "message": "Copyright © 2025 Beyond_Imagination Team. Built with Docusaurus.",
+    "description": "The footer copyright"
+  }
+}
diff --git a/apps/docs/i18n/zh-Hans/docusaurus-theme-classic/navbar.json b/apps/docs/i18n/zh-Hans/docusaurus-theme-classic/navbar.json
new file mode 100644
index 0000000..c108458
--- /dev/null
+++ b/apps/docs/i18n/zh-Hans/docusaurus-theme-classic/navbar.json
@@ -0,0 +1,18 @@
+{
+  "title": {
+    "message": "express-cargo",
+    "description": "The title in the navbar"
+  },
+  "logo.alt": {
+    "message": "express-cargo 标志",
+    "description": "The alt text of navbar logo"
+  },
+  "item.label.Docs": {
+    "message": "文档",
+    "description": "Navbar item with label Docs"
+  },
+  "item.label.GitHub": {
+    "message": "GitHub",
+    "description": "Navbar item with label GitHub"
+  }
+}