diff --git a/changes.md b/changes.md
index 83c788dc..1bea6689 100644
--- a/changes.md
+++ b/changes.md
@@ -1,6 +1,40 @@
 # MyBatis-Flex ChangeLog
 
 
+
+## v1.5.5 20230801:
+- 新增：添加对 xml 分页查询的支持
+- 新增：逻辑删除添加列默认值为 null 值时的构建功能，感谢 @Suomm
+- 新增：QueryWrapper 添加 `clear()` 方法以复用，感谢 @yuanbaolong
+- 优化：添加更多的 QueryWrapper.select() 方法
+- 优化：添加全表更新或全部删除时的异常信息国际化
+- 优化：移除 Mappers.java 一些无用的代码
+- 优化：重构 ModifyAttrsRecordProxyFactory 以提升性能
+- 优化：重构 Page.java，默认使用 long 统一相关参数
+- 优化：对 ClassUtil/ConvertUtil 等一些工具类进行优化，感谢 @xinjump
+- 优化：代码生成器 ignoreColumns 变更为只对Entity生成有效果，感谢 @jerryzhengsz1
+- 优化：完善 Gitee 的 issue 模板配置，感谢 @Suomm
+- 优化：Relations 附加条件参数值修改为 Object 类型，感谢 @Suomm
+- 优化：重构 ActiveRecord 的关于关联查询的链式操作方法，感谢 @Suomm
+- 修复：修复游标查询时，配置 `@Column(typeHandler =xxx)` 不生生效的问题 #I7PNUL
+- 修复：修复达梦数据库数据大小写敏感的问题 #I7OYMN
+- 修复：UpdateChain.toSQL() 在某些情况下出错的问题
+- 修复：动态表名在 updateByQuery 中无效的问题
+- 修复：多数据源、且数据源加密的情况下，无法正确解析 jdbcUrl 的问题
+- 修复：数据解密器在某些场景下会多次触发解密的问题
+- 修复：逻辑删除配置为字符串时，多添加单引号的问题，感谢 @Suomm
+- 文档：添加自动映射的相关文档描述
+- 文档：打印 SQL 的相关文档添加 MyBatis 原生配置的方式
+- 文档：优化逻辑删除文档的一些代码展示示例有误的问题
+- 文档：添加 xml 分页查询的相关文档和示例
+- 文档：添加补充 Active Record 多种方式关联查询的文档，感谢 @Suomm
+- 文档：优化多数据源的代码配置展示，感谢 @lhzsdnu
+- 文档：修改链式操作的代码示例错误，感谢 @eltociear
+- 文档：修改 SQL 审计的相关错别字，感谢 @cijie
+- 文档：修改 MyBatisFlexCustomizer 文档的一些错别字，感谢 @q-alex
+
+
+
 ## v1.5.4 20230729:
 - 新增：UpdateChain.of(entity) 方法，方便直接传入 entity
 - 新增：TableInfo.buildQueryColumn() 方法，用于在泛型下构建 QueryColumn
diff --git a/docs/zh/changes.md b/docs/zh/changes.md
index 83c788dc..1bea6689 100644
--- a/docs/zh/changes.md
+++ b/docs/zh/changes.md
@@ -1,6 +1,40 @@
 # MyBatis-Flex ChangeLog
 
 
+
+## v1.5.5 20230801:
+- 新增：添加对 xml 分页查询的支持
+- 新增：逻辑删除添加列默认值为 null 值时的构建功能，感谢 @Suomm
+- 新增：QueryWrapper 添加 `clear()` 方法以复用，感谢 @yuanbaolong
+- 优化：添加更多的 QueryWrapper.select() 方法
+- 优化：添加全表更新或全部删除时的异常信息国际化
+- 优化：移除 Mappers.java 一些无用的代码
+- 优化：重构 ModifyAttrsRecordProxyFactory 以提升性能
+- 优化：重构 Page.java，默认使用 long 统一相关参数
+- 优化：对 ClassUtil/ConvertUtil 等一些工具类进行优化，感谢 @xinjump
+- 优化：代码生成器 ignoreColumns 变更为只对Entity生成有效果，感谢 @jerryzhengsz1
+- 优化：完善 Gitee 的 issue 模板配置，感谢 @Suomm
+- 优化：Relations 附加条件参数值修改为 Object 类型，感谢 @Suomm
+- 优化：重构 ActiveRecord 的关于关联查询的链式操作方法，感谢 @Suomm
+- 修复：修复游标查询时，配置 `@Column(typeHandler =xxx)` 不生生效的问题 #I7PNUL
+- 修复：修复达梦数据库数据大小写敏感的问题 #I7OYMN
+- 修复：UpdateChain.toSQL() 在某些情况下出错的问题
+- 修复：动态表名在 updateByQuery 中无效的问题
+- 修复：多数据源、且数据源加密的情况下，无法正确解析 jdbcUrl 的问题
+- 修复：数据解密器在某些场景下会多次触发解密的问题
+- 修复：逻辑删除配置为字符串时，多添加单引号的问题，感谢 @Suomm
+- 文档：添加自动映射的相关文档描述
+- 文档：打印 SQL 的相关文档添加 MyBatis 原生配置的方式
+- 文档：优化逻辑删除文档的一些代码展示示例有误的问题
+- 文档：添加 xml 分页查询的相关文档和示例
+- 文档：添加补充 Active Record 多种方式关联查询的文档，感谢 @Suomm
+- 文档：优化多数据源的代码配置展示，感谢 @lhzsdnu
+- 文档：修改链式操作的代码示例错误，感谢 @eltociear
+- 文档：修改 SQL 审计的相关错别字，感谢 @cijie
+- 文档：修改 MyBatisFlexCustomizer 文档的一些错别字，感谢 @q-alex
+
+
+
 ## v1.5.4 20230729:
 - 新增：UpdateChain.of(entity) 方法，方便直接传入 entity
 - 新增：TableInfo.buildQueryColumn() 方法，用于在泛型下构建 QueryColumn
diff --git a/docs/zh/intro/getting-started.md b/docs/zh/intro/getting-started.md
index 8e8a4659..4329b94a 100644
--- a/docs/zh/intro/getting-started.md
+++ b/docs/zh/intro/getting-started.md
@@ -39,7 +39,7 @@ VALUES (1, '张三', 18, '2020-01-11'),
     <dependency>
         <groupId>com.mybatis-flex</groupId>
         <artifactId>mybatis-flex-spring-boot-starter</artifactId>
-        <version>1.5.4</version>
+        <version>1.5.5</version>
     </dependency>
     <dependency>
         <groupId>com.mysql</groupId>
diff --git a/docs/zh/intro/maven.md b/docs/zh/intro/maven.md
index 333f8427..60bfa822 100644
--- a/docs/zh/intro/maven.md
+++ b/docs/zh/intro/maven.md
@@ -12,12 +12,12 @@
 <dependency>
     <groupId>com.mybatis-flex</groupId>
     <artifactId>mybatis-flex-core</artifactId>
-    <version>1.5.4</version>
+    <version>1.5.5</version>
 </dependency>
 <dependency>
     <groupId>com.mybatis-flex</groupId>
     <artifactId>mybatis-flex-processor</artifactId>
-    <version>1.5.4</version>
+    <version>1.5.5</version>
     <scope>provided</scope>
 </dependency>
 ```
@@ -28,12 +28,12 @@
 <dependency>
     <groupId>com.mybatis-flex</groupId>
     <artifactId>mybatis-flex-spring</artifactId>
-    <version>1.5.4</version>
+    <version>1.5.5</version>
 </dependency>
 <dependency>
     <groupId>com.mybatis-flex</groupId>
     <artifactId>mybatis-flex-processor</artifactId>
-    <version>1.5.4</version>
+    <version>1.5.5</version>
     <scope>provided</scope>
 </dependency>
 ``````
@@ -44,12 +44,12 @@
 <dependency>
     <groupId>com.mybatis-flex</groupId>
     <artifactId>mybatis-flex-spring-boot-starter</artifactId>
-    <version>1.5.4</version>
+    <version>1.5.5</version>
 </dependency>
 <dependency>
     <groupId>com.mybatis-flex</groupId>
     <artifactId>mybatis-flex-processor</artifactId>
-    <version>1.5.4</version>
+    <version>1.5.5</version>
     <scope>provided</scope>
 </dependency>
 ```
@@ -70,7 +70,7 @@
             <path>
                 <groupId>com.mybatis-flex</groupId>
                 <artifactId>mybatis-flex-processor</artifactId>
-                <version>1.5.4</version>
+                <version>1.5.5</version>
             </path>
         </annotationProcessorPaths>
     </configuration>
diff --git a/docs/zh/others/apt.md b/docs/zh/others/apt.md
index b7830fb7..f2759aed 100644
--- a/docs/zh/others/apt.md
+++ b/docs/zh/others/apt.md
@@ -220,7 +220,7 @@ pom.xml 添加 `annotationProcessorPaths` 配置，
 ```
 dependencies {
     ...
-    annotationProcessor 'com.mybatis-flex:mybatis-flex-processor:<version>1.5.4</version>'
+    annotationProcessor 'com.mybatis-flex:mybatis-flex-processor:<version>1.5.5</version>'
 }
 ```
 
diff --git a/docs/zh/others/codegen.md b/docs/zh/others/codegen.md
index f982537a..7123330c 100644
--- a/docs/zh/others/codegen.md
+++ b/docs/zh/others/codegen.md
@@ -10,7 +10,7 @@
 <dependency>
     <groupId>com.mybatis-flex</groupId>
     <artifactId>mybatis-flex-codegen</artifactId>
-    <version>1.5.4</version>
+    <version>1.5.5</version>
 </dependency>
 ```
 
diff --git a/pom.xml b/pom.xml
index 10c518b3..74121ed9 100644
--- a/pom.xml
+++ b/pom.xml
@@ -7,7 +7,7 @@
     <groupId>com.mybatis-flex</groupId>
     <artifactId>parent</artifactId>
     <packaging>pom</packaging>
-    <version>1.5.4</version>
+    <version>1.5.5</version>
 
     <name>mybatis-flex</name>
     <url>https://mybatis-flex.com</url>
@@ -54,7 +54,7 @@
         <maven.compiler.source>8</maven.compiler.source>
         <maven.compiler.target>8</maven.compiler.target>
 
-        <mybatis-flex.version>1.5.4</mybatis-flex.version>
+        <mybatis-flex.version>1.5.5</mybatis-flex.version>
 
         <mybatis.version>3.5.13</mybatis.version>
         <mybatis-spring.version>2.1.0</mybatis-spring.version>