diff --git a/docs/zh/audit.md b/docs/zh/audit.md
index 2a73210b..28646bc7 100644
--- a/docs/zh/audit.md
+++ b/docs/zh/audit.md
@@ -1,3 +1,3 @@
# 数据审计
-文档正在完善中,请稍后。
\ No newline at end of file
+正在完善中,请稍后。
\ No newline at end of file
diff --git a/docs/zh/fill.md b/docs/zh/fill.md
index c8032fb9..27ab58f2 100644
--- a/docs/zh/fill.md
+++ b/docs/zh/fill.md
@@ -5,8 +5,8 @@
Mybatis-Flex 提供了两种方式,帮助开发者进行数据填充。
-- 1、通过 `@Table` 注解的 `onInsert` 和 `onUpdate` 配置进行操作。这部分可以参考 [@Table 注解](./table) 章节。
-- 2、通过 `@Column` 注解的 `onInsertValue` 和 `onUpdateValue` 配置进行操作。这部分可以参考 [@Column 注解](./column) 章节。
+- 1、通过 `@Table` 注解的 `onInsert` 和 `onUpdate` 配置进行操作。这部分可以参考 [@Table 注解章节](./table) 。
+- 2、通过 `@Column` 注解的 `onInsertValue` 和 `onUpdateValue` 配置进行操作。这部分可以参考 [@Column 注解章节](./column)。
diff --git a/docs/zh/id.md b/docs/zh/id.md
index 8b54c10c..42bdbbd7 100644
--- a/docs/zh/id.md
+++ b/docs/zh/id.md
@@ -94,7 +94,7 @@ public class Account {
```
当我们保存数据的时候,Account 的 id 主键为自增,而 otherId 主键则通过 uuid 生成。
-## 主键生成器
+## 自定义主键生成器
第 1 步:编写一个类,实现 `IKeyGenerator` 接口,例如:
diff --git a/docs/zh/querywrapper.md b/docs/zh/querywrapper.md
index eb12c648..7fc4f515 100644
--- a/docs/zh/querywrapper.md
+++ b/docs/zh/querywrapper.md
@@ -305,7 +305,7 @@ WHERE tb_account.age >= ?
## limit... offset
::: tip 提示
-在 "limit... offset" 的示例中,Mybatis-Flex 能够自动识别当前数据库,并根据数据库的类型生成不同的 SQL,用户也可以很轻易的通过 DialectFactory 注册(新增或改写)自己的实现方言。
+在 "limit... offset" 的示例中,Mybatis-Flex 能够自动识别当前数据库👍,并根据数据库的类型生成不同的 SQL,用户也可以很轻易的通过 DialectFactory 注册(新增或改写)自己的实现方言。
:::
@@ -361,8 +361,8 @@ SELECT * FROM "tb_account" ORDER BY "id" DESC ROWS 20 TO 30
**疑问1:示例代码中的 QueryWrapper 所需要的 "ACCOUNT" 从哪里来的?**
-答:答:Mybatis-Flex 使用了 APT(Annotation Processing Tool)技术,在项目编译的时候,
-会自动根据 Entity 类定义的字段帮你生成 "ACCOUNT" 类以及 Entity 对应的 Mapper 类, 通过开发工具构建项目(如下图),
+答:Mybatis-Flex 使用了 APT(Annotation Processing Tool)在项目编译的时候,
+会自动根据 Entity 类定义的字段生成 "ACCOUNT" 类以及 Entity 对应的 Mapper 类, 通过开发工具构建项目(如下图),
或者执行 maven 编译命令: `mvn clean package` 都可以自动生成。这个原理和 lombok 一致。

diff --git a/docs/zh/what-is-mybatisflex.md b/docs/zh/what-is-mybatisflex.md
index d14000fc..78f12a4b 100644
--- a/docs/zh/what-is-mybatisflex.md
+++ b/docs/zh/what-is-mybatisflex.md
@@ -1,7 +1,7 @@
# Mybatis-Flex 是什么
Mybatis-Flex 是一个优雅的 Mybatis 增强框架,它非常轻量、同时拥有极高的性能与灵活性。我们可以轻松的使用 Mybaits-Flex 链接任何数据库,其内置的
-QueryWrapper 帮助我们极大的减少了 SQL 编写的工作的同时,减少出错的可能性。
+QueryWrapper 帮助我们极大的减少了 SQL 编写的工作的同时,减少出错的可能性。
总而言之,Mybatis-Flex 能够极大地提高了我们的开发效率和开发体验,让我们有更多的时间专注于自己的事情。
@@ -12,8 +12,8 @@ QueryWrapper 帮助我们极大的减少了 SQL 编写的工作的同时,减
这带来了几个好处:1、极高的性能;2、极易对代码进行跟踪和调试,因而把控性更高。
-**2、灵活**:支持 Entity 的增删改查、以及分页查询的同时,Mybatis-Flex 提供了 Db + Row 工具,可以无需实体类对数据库进行增删改查以及分页查询。
-与此同时,Mybatis-Flex 内置的 QueryWrapper 可以轻易的帮助我们实现 **多表查询**、**链接查询**、**子查询**等等常见的 SQL 场景。
+**2、灵活**:支持 Entity 的增删改查、以及分页查询的同时,Mybatis-Flex 提供了 Db + Row 工具,可以无需实体类对数据库进行增删改查以及分页查询。
+与此同时,Mybatis-Flex 内置的 QueryWrapper 可以轻易的帮助我们实现 **多表查询**、**链接查询**、**子查询** 等等常见的 SQL 场景。
**3、强大**:支持任意关系型数据库,还可以通过方言持续扩展,同时支持 **多(复合)主键**、**逻辑删除**、**乐观锁配置**、**数据脱敏**、**数据审计**、