Fix incorrect usage in documentation

Author: wu-clan

docs/advanced/filter.md

@@ -321,17 +321,17 @@ class UserRole(Base):
 
 ```python
 # 创建复合主键记录
-user_role_data = {"user_id": 1, "role_id": 2, "assigned_at": datetime.now()}
+user_role_data = UserRoleCreate(user_id=1, role_id=2, assigned_at=datetime.now())
 user_role = await user_role_crud.create_model(session, user_role_data)
 
 # 查询复合主键记录
 user_role = await user_role_crud.select_model(session, pk=(1, 2))
 
 # 更新复合主键记录
-updated_user_role = await user_role_crud.update_model(
+updated_count = await user_role_crud.update_model(
     session,
     pk=(1, 2),
-    obj_in={"assigned_at": datetime.now()}
+    obj={"assigned_at": datetime.now()}
 )
 
 # 删除复合主键记录

docs/api/errors.md

@@ -66,9 +66,9 @@ except ModelColumnError as e:
 from sqlalchemy_crud_plus.errors import MultipleResultsFoundError
 
 try:
-    user = await user_crud.update_model_by_column(
+    count = await user_crud.update_model_by_column(
         session,
-        obj_in={"name": "新名称"},
+        obj={"name": "新名称"},
         name__like='%张%'  # 可能匹配多条记录
     )
 except MultipleResultsFoundError as e:

docs/getting-started/quick-start.md

@@ -59,13 +59,13 @@ post_crud = CRUDPlus(Post)
 
 ```python
 # 创建单个用户
-user_data = {"name": "张三", "email": "zhangsan@example.com"}
+user_data = UserCreate(name="张三", email="zhangsan@example.com")
 user = await user_crud.create_model(session, user_data)
 
 # 批量创建
 users_data = [
-    {"name": "李四", "email": "lisi@example.com"},
-    {"name": "王五", "email": "wangwu@example.com"}
+    UserCreate(name="李四", email="lisi@example.com"),
+    UserCreate(name="王五", email="wangwu@example.com")
 ]
 users = await user_crud.create_models(session, users_data)
 ```

docs/index.md

@@ -45,9 +45,9 @@ crud_user = CRUDPlus(User)
 
 # 基础 CRUD 操作
 user = await crud_user.create_model(session, user_data)
-user = await crud_user.select_model(session, user_id=1)
-await crud_user.update_model(session, user_id=1, update_data)
-await crud_user.delete_model(session, user_id=1)
+user = await crud_user.select_model(session, pk=1)
+await crud_user.update_model(session, pk=1, obj=update_data)
+await crud_user.delete_model(session, pk=1)
 ```
 
 ### 关系查询
@@ -56,7 +56,7 @@ await crud_user.delete_model(session, user_id=1)
 # 预加载关系
 user = await crud_user.select_model(
     session,
-    user_id=1,
+    pk=1,
     load_strategies=['posts', 'profile']
 )
 

docs/relationships/overview.md

@@ -19,7 +19,8 @@ from sqlalchemy.orm import selectinload, joinedload
 
 # 使用原生 SQLAlchemy 选项
 user = await user_crud.select_model(
-    session, user_id,
+    session,
+    pk=user_id,
     load_options=[
         selectinload(User.posts),
         joinedload(User.profile)
@@ -28,7 +29,8 @@ user = await user_crud.select_model(
 
 # 嵌套关系
 user = await user_crud.select_model(
-    session, user_id,
+    session,
+    pk=user_id,
     load_options=[
         selectinload(User.posts).selectinload(Post.comments),
         joinedload(User.profile)
@@ -43,13 +45,15 @@ user = await user_crud.select_model(
 ```python
 # 列表格式（使用默认策略）
 user = await user_crud.select_model(
-    session, user_id,
+    session,
+    pk=user_id,
     load_strategies=['posts', 'profile']
 )
 
 # 字典格式（指定具体策略）
 user = await user_crud.select_model(
-    session, user_id,
+    session,
+    pk=user_id,
     load_strategies={
         'posts': 'selectinload',
         'profile': 'joinedload',
@@ -59,7 +63,8 @@ user = await user_crud.select_model(
 
 # 嵌套关系
 user = await user_crud.select_model(
-    session, user_id,
+    session,
+    pk=user_id,
     load_strategies={
         'posts': 'selectinload',
         'posts.category': 'joinedload',
@@ -106,13 +111,15 @@ users = await user_crud.select_models(
 ```python
 # 用户的多篇文章
 user = await user_crud.select_model(
-    session, user_id,
+    session,
+    pk=user_id,
     load_strategies={'posts': 'selectinload'}
 )
 
 # 文章的多条评论
 post = await post_crud.select_model(
-    session, post_id,
+    session,
+    pk=user_id,
     load_strategies={'comments': 'selectinload'}
 )
 ```
@@ -130,13 +137,15 @@ post = await post_crud.select_model(
 ```python
 # 用户的个人资料
 user = await user_crud.select_model(
-    session, user_id,
+    session,
+    pk=user_id,
     load_strategies={'profile': 'joinedload'}
 )
 
 # 文章的分类
 post = await post_crud.select_model(
-    session, post_id,
+    session,
+    pk=user_id,
     load_strategies={'category': 'joinedload'}
 )
 ```
@@ -154,13 +163,15 @@ post = await post_crud.select_model(
 ```python
 # 用户的多个角色
 user = await user_crud.select_model(
-    session, user_id,
+    session,
+    pk=user_id,
     load_strategies={'roles': 'subqueryload'}
 )
 
 # 文章的多个标签
 post = await post_crud.select_model(
-    session, post_id,
+    session,
+    pk=user_id,
     load_strategies={'tags': 'subqueryload'}
 )
 ```
@@ -191,13 +202,15 @@ users = await user_crud.select_models(
 ```python
 # 禁止访问关系（抛出异常）
 user = await user_crud.select_model(
-    session, user_id,
+    session,
+    pk=user_id,
     load_strategies={'posts': 'raiseload'}
 )
 
 # 禁止加载关系（返回 None）
 user = await user_crud.select_model(
-    session, user_id,
+    session,
+    pk=user_id,
     load_strategies={'posts': 'noload'}
 )
 ```

docs/usage/crud.md

@@ -7,25 +7,19 @@ SQLAlchemy CRUD Plus 提供完整的 CRUD（创建、读取、更新、删除）
 ### 单条记录
 
 ```python
-# 基础创建
-user_data = {"name": "张三", "email": "zhangsan@example.com"}
-user = await user_crud.create_model(session, user_data)
-
-# 使用 Pydantic 模型
+# 使用 Pydantic 模型创建
 user_data = UserCreate(name="张三", email="zhangsan@example.com")
 user = await user_crud.create_model(session, user_data)
-
-
 ```
 
 ### 批量创建
 
 ```python
 # 批量创建多条记录
 users_data = [
-    {"name": "用户1", "email": "user1@example.com"},
-    {"name": "用户2", "email": "user2@example.com"},
-    {"name": "用户3", "email": "user3@example.com"}
+    UserCreate(name="用户1", email="user1@example.com"),
+    UserCreate(name="用户2", email="user2@example.com"),
+    UserCreate(name="用户3", email="user3@example.com")
 ]
 users = await user_crud.create_models(session, users_data)
 ```
@@ -123,18 +117,18 @@ exists = await user_crud.exists(session, email="test@example.com")
 ### 主键更新
 
 ```python
-# 根据主键更新
-updated_user = await user_crud.update_model(session, pk=1, obj_in={"name": "新名称"})
+# 使用字典更新
+updated_count = await user_crud.update_model(session, pk=1, obj={"name": "新名称"})
 
 # 使用 Pydantic 模型
 user_update = UserUpdate(name="新名称", email="new@example.com")
-updated_user = await user_crud.update_model(session, pk=1, obj_in=user_update)
+updated_count = await user_crud.update_model(session, pk=1, obj=user_update)
 
 # 使用 whereclause 位置参数（额外条件）
-updated_user = await user_crud.update_model(
+updated_count = await user_crud.update_model(
     session,
     pk=1,
-    obj_in={"name": "新名称"},
+    obj={"name": "新名称"},
     user_crud.model.is_active == True
 )
 ```
@@ -143,16 +137,16 @@ updated_user = await user_crud.update_model(
 
 ```python
 # 根据条件更新单条记录
-updated_user = await user_crud.update_model_by_column(
+updated_count = await user_crud.update_model_by_column(
     session,
-    obj_in={"is_active": False},
+    obj={"is_active": False},
     email="user@example.com"
 )
 
 # 使用 whereclause 位置参数（额外条件）
-updated_user = await user_crud.update_model_by_column(
+updated_count = await user_crud.update_model_by_column(
     session,
-    obj_in={"name": "新名称"},
+    obj={"name": "新名称"},
     user_crud.model.is_active == True,
     email="user@example.com"
 )