update docs

Author: wu-clan

docs/.vuepress/data/sponsors.ts

@@ -20,7 +20,7 @@ export const homeSponsor: Sponsor = { ...defaultSponsor };
 export const goldSponsors: Sponsor[] = [
     {
         link: 'https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQQImbvY5S8IbJ1iL6yHfExtHiAhUtLIoi7AQ&s',
-        href: 'https://user.by.ltd/aff.php?aff=12215',
+        href: 'https://u.bws.lol/aff.php?aff=12215',
         alt: 'Bywave',
         expiryTime: '2099-12-31T23:59:59',
     },

docs/.vuepress/sidebar.ts

@@ -39,7 +39,7 @@ export const mySidebar: ThemeSidebarMulti = {
                 { text: 'RBAC', link: 'RBAC' },
                 { text: 'CORS', link: 'CORS' },
                 { text: '时区', link: 'timezone' },
-                { text: '节流', link: 'limit' },
+                { text: '限流', link: 'limit' },
                 { text: '事务', link: 'transaction' },
                 { text: '缓存', link: 'cache' },
                 { text: '国际化', link: 'i18n' },

docs/backend/reference/limit.md

@@ -2,45 +2,76 @@
 title: 节流
 ---
 
-我们有一个关于路由器的历史讨论，如果你感兴趣，可以查看：[#70](https://github.com/fastapi-practices/fastapi_best_architecture/discussions/70)
+在现代 Web 开发中，API 限流（Rate
+Limiting）是保护后端服务、防止资源滥用、保证服务稳定性的重要机制，我们有一个关于路由器的历史讨论，如果你感兴趣，可以查看：[#70](https://github.com/fastapi-practices/fastapi_best_architecture/discussions/70)
 
-[**fastapi-limiter** GitHub 仓库地址](https://github.com/long2ice/fastapi-limiter){.read-more}
+## 处理流程
 
-## 使用
+以下是 RateLimiter 处理一次请求的完整流程：
 
-更多使用方法请查看官方仓库 [README](https://github.com/long2ice/fastapi-limiter/blob/master/README.md#quick-start)
+```mermaid
+graph TD
+    A[请求进入路由依赖] --> B[初始化 Bucket 和 Limiter]
+    B --> C[获取 Identifier]
+    C --> D[异步尝试获取]
+    D -->|获取成功| E[放行请求，继续业务处理]
+    D -->|获取失败| F[计算 Retry-After]
+    F --> G[执行 Callback<br>（默认抛出 429 异常）]
+```
+
+## 使用方法
+
+RateLimiter 设计为 FastAPI 的依赖项，直接在路由中使用 `Depends` 注入
+
+### 单规则限流
+
+```python
+# 每分钟最多 60 次
+@app.get(
+    "/api/example", 
+    dependencies=[Depends(RateLimiter(Rate(5, Duration.MINUTE)))]
+)
+async def example():
+    return {"message": "success"}
+```
+
+### 多规则复合限流
 
-```python{1,6,11-17,25,29}
-@app.get("/", dependencies=[Depends(RateLimiter(times=1, seconds=5))])
-async def index_get():
-    return {"msg": "Hello World"}
+```python
+# 每秒 10 次 + 每分钟 100 次
+@app.post(
+    "/api/heavy", 
+    dependencies=[
+        Depends(
+            RateLimiter(
+                Rate(10, Duration.SECOND),
+                Rate(100, Duration.MINUTE),
+            )
+        )
+    ]
+)
+async def heavy_endpoint():
+    return {"status": "ok"}
+```
 
+### 自定义 Identifier
 
-@app.post("/", dependencies=[Depends(RateLimiter(times=1, seconds=5))])
-async def index_post():
-    return {"msg": "Hello World"}
+```python
+async def user_identifier(request: Request) -> str:
+    return f"user:{request.user.id}"
 
 
 @app.get(
-    "/multiple",
+    "/api/user-data",
     dependencies=[
-        Depends(RateLimiter(times=1, seconds=5)),
-        Depends(RateLimiter(times=2, seconds=15)),
-    ],
+        Depends(
+            RateLimiter(
+                Rate(50, Duration.MINUTE),
+                identifier=user_identifier,
+            )
+        )
+    ]    
 )
-async def multiple():
-    return {"msg": "Hello World"}
-
-
-@app.websocket("/ws")
-async def websocket_endpoint(websocket: WebSocket):
-    await websocket.accept()
-    ratelimit = WebSocketRateLimiter(times=1, seconds=5)
-    while True:
-        try:
-            data = await websocket.receive_text()
-            await ratelimit(websocket, context_key=data)
-            await websocket.send_text("Hello, world")
-        except HTTPException:
-            await websocket.send_text("Hello again")
+async def user_data():
+    return {"data": "protected"}
 ```

docs/frontend/summary/quick-start.md

@@ -3,7 +3,7 @@ title: 快速开始
 ---
 
 ::: caution
-前端已默认集成【字典】功能，所以 fba 必须安装字典插件并执行插件中的 SQL 脚本
+前端已默认集成【字典】功能，所以 fba 必须安装字典插件（已内置）并执行插件中的 SQL 脚本
 :::
 
 ::: steps