docs: add Chinese README docs with setup and API usage examples

- Add Simplified Chinese and Traditional Chinese README documentation
- Provide installation instructions and usage examples for graceful shutdown with Gin in both new README files
- Include API reference for all server lifecycle methods and configuration options in the new documentation

Signed-off-by: appleboy <[email protected]>

Author: appleboy

README.zh-cn.md

@@ -0,0 +1,133 @@
+# graceful
+
+[English](README.md) | [繁體中文](README.zh-tw.md) | 简体中文
+
+![Run Tests](https://github.com/gin-contrib/graceful/actions/workflows/go.yml/badge.svg?branch=master)
+![codecov](https://codecov.io/gh/gin-contrib/graceful/branch/master/graph/badge.svg)
+![Go Report Card](https://goreportcard.com/badge/github.com/gin-contrib/graceful)
+![GoDoc](https://godoc.org/github.com/gin-contrib/graceful?status.svg)
+
+**graceful** 是 Gin 的一个封装器，为 HTTP 服务器提供强大且灵活的优雅关闭能力。它允许你启动、停止及平滑关闭服务器，并支持多种监听机制，包括 TCP、Unix socket、文件描述符或自定义 listener。
+
+- [graceful](#graceful)
+  - [特性](#特性)
+  - [安装方法](#安装方法)
+  - [使用示例](#使用示例)
+  - [API 概览](#api-概览)
+    - [Graceful 类型](#graceful-类型)
+    - [服务器启动方法](#服务器启动方法)
+    - [关闭与清理方法](#关闭与清理方法)
+    - [选项](#选项)
+  - [许可证](#许可证)
+
+## 特性
+
+- 为 Gin HTTP 服务器无缝实现优雅关闭功能
+- 支持 TCP、TLS、Unix socket、文件描述符和自定义 net.Listener
+- 线程安全的启动/停止流程和基于 context 的取消
+- 保证所有活动连接都被妥善处理后再终止
+- 简洁 API 并支持自定义选项
+
+## 安装方法
+
+```bash
+go get github.com/gin-contrib/graceful
+```
+
+## 使用示例
+
+```go
+package main
+
+import (
+  "context"
+  "net/http"
+  "os/signal"
+  "syscall"
+
+  "github.com/gin-contrib/graceful"
+  "github.com/gin-gonic/gin"
+)
+
+func main() {
+  ctx, stop := signal.NotifyContext(context.Background(), syscall.SIGINT, syscall.SIGTERM)
+  defer stop()
+
+  router, err := graceful.Default()
+  if err != nil {
+    panic(err)
+  }
+  defer router.Close()
+
+  router.GET("/", func(c *gin.Context) {
+    c.String(http.StatusOK, "Welcome Gin Server")
+  })
+
+  if err := router.RunWithContext(ctx); err != nil && err != context.Canceled {
+    panic(err)
+  }
+}
+```
+
+## API 概览
+
+### Graceful 类型
+
+主要类型为：
+
+```go
+type Graceful struct {
+  *gin.Engine
+  // 内部同步/context 字段
+}
+```
+
+### 服务器启动方法
+
+- **Default(opts ...Option) \*Graceful, error**：  
+  创建一个带默认 Gin 中间件的 `Graceful` 实例。
+
+- **New(router *gin.Engine, opts ...Option) \*Graceful, error**：  
+  封装已有 `gin.Engine`。
+
+- **Run(addr ...string) error**：  
+  在一个或多个 TCP 地址启动 HTTP 服务器。
+
+- **RunTLS(addr, certFile, keyFile string) error**：  
+  在指定地址启动 HTTPS 服务器。
+
+- **RunUnix(file string) error**：  
+  在指定 Unix socket 启动服务器。
+
+- **RunFd(fd uintptr) error**：  
+  使用给定文件描述符启动服务器。
+
+- **RunListener(listener net.Listener) error**：  
+  在自定义的 `net.Listener` 启动服务器。
+
+- **RunWithContext(ctx context.Context) error**：  
+  在绑定 context 生命周期下启动服务器。推荐配合信号处理关闭使用。
+
+### 关闭与清理方法
+
+- **Shutdown(ctx context.Context) error**：  
+  优雅关闭服务器，并等待所有活动连接断开。
+
+- **Start() error**：  
+  在 goroutine 中启动服务器，需自行调用 `Stop()` 终止。
+
+- **Stop() error**：  
+  停止由 `Start()` 启动的 Graceful 实例。
+
+- **Close()**：  
+  清理内部状态并关闭正在运行的服务器。
+
+### 选项
+
+多种选项（详见代码 `Option` 接口及实现），可配置服务器，包括自定义地址、TLS、Unix socket、文件描述符和 listener。
+
+---
+
+## 许可证
+
+本项目基于 [MIT License](LICENSE) 授权。

README.zh-tw.md

@@ -0,0 +1,133 @@
+# graceful
+
+[English](README.md) | 繁體中文 | [简体中文](README.zh-cn.md)
+
+![Run Tests](https://github.com/gin-contrib/graceful/actions/workflows/go.yml/badge.svg?branch=master)
+![codecov](https://codecov.io/gh/gin-contrib/graceful/branch/master/graph/badge.svg)
+![Go Report Card](https://goreportcard.com/badge/github.com/gin-contrib/graceful)
+![GoDoc](https://godoc.org/github.com/gin-contrib/graceful?status.svg)
+
+**graceful** 是 Gin 的一個包裝器，為 HTTP 伺服器提供強大且靈活的優雅關閉能力。它允許你啟動、停止及平滑地關閉伺服器，並支援各種監聽方式，包括 TCP、Unix socket、檔案描述符或自訂 listener。
+
+- [graceful](#graceful)
+  - [特色](#特色)
+  - [安裝方式](#安裝方式)
+  - [使用範例](#使用範例)
+  - [API 概覽](#api-概覽)
+    - [Graceful 型別](#graceful-型別)
+    - [伺服器啟動方法](#伺服器啟動方法)
+    - [關閉與清理方法](#關閉與清理方法)
+    - [選項](#選項)
+  - [授權條款](#授權條款)
+
+## 特色
+
+- 為 Gin HTTP 伺服器提供無縫的優雅關閉功能
+- 支援 TCP、TLS、Unix socket、檔案描述符和自訂 net.Listener
+- 執行緒安全的啟動/停止程序與基於 context 的取消控制
+- 確保所有活動連線都被妥善處理後再終止
+- 提供簡潔 API 與可自訂選項
+
+## 安裝方式
+
+```bash
+go get github.com/gin-contrib/graceful
+```
+
+## 使用範例
+
+```go
+package main
+
+import (
+  "context"
+  "net/http"
+  "os/signal"
+  "syscall"
+
+  "github.com/gin-contrib/graceful"
+  "github.com/gin-gonic/gin"
+)
+
+func main() {
+  ctx, stop := signal.NotifyContext(context.Background(), syscall.SIGINT, syscall.SIGTERM)
+  defer stop()
+
+  router, err := graceful.Default()
+  if err != nil {
+    panic(err)
+  }
+  defer router.Close()
+
+  router.GET("/", func(c *gin.Context) {
+    c.String(http.StatusOK, "Welcome Gin Server")
+  })
+
+  if err := router.RunWithContext(ctx); err != nil && err != context.Canceled {
+    panic(err)
+  }
+}
+```
+
+## API 概覽
+
+### Graceful 型別
+
+主要型別為：
+
+```go
+type Graceful struct {
+  *gin.Engine
+  // 內部同步與 context 欄位
+}
+```
+
+### 伺服器啟動方法
+
+- **Default(opts ...Option) \*Graceful, error**：  
+  建立具預設 Gin middleware 的 `Graceful` 實例。
+
+- **New(router *gin.Engine, opts ...Option) \*Graceful, error**：  
+  包裝現有 `gin.Engine`。
+
+- **Run(addr ...string) error**：  
+  於一個或多個 TCP 位址啟動 HTTP 伺服器。
+
+- **RunTLS(addr, certFile, keyFile string) error**：  
+  於指定位址啟動 HTTPS 伺服器。
+
+- **RunUnix(file string) error**：  
+  於指定 Unix socket 啟動伺服器。
+
+- **RunFd(fd uintptr) error**：  
+  利用給定檔案描述符啟動伺服器。
+
+- **RunListener(listener net.Listener) error**：  
+  於自訂的 `net.Listener` 啟動伺服器。
+
+- **RunWithContext(ctx context.Context) error**：  
+  於 context 綁定的生命週期中啟動伺服器。建議信號處理時使用。
+
+### 關閉與清理方法
+
+- **Shutdown(ctx context.Context) error**：  
+  優雅地關閉伺服器，並等候所有活動連線終止。
+
+- **Start() error**：  
+  於 goroutine 啟動伺服器，你必須呼叫 `Stop()` 來終止。
+
+- **Stop() error**：  
+  停止先前以 `Start()` 啟動的 Graceful 實例。
+
+- **Close()**：  
+  清理內部狀態並關閉所有執行中伺服器。
+
+### 選項
+
+各種選項（參見程式碼 `Option` 介面 / 實作）允許設定伺服器，包括自訂位址、TLS、Unix socket、檔案描述符與 listener。
+
+---
+
+## 授權條款
+
+本專案依 [MIT License](LICENSE) 授權。