diff --git a/README.md b/README.md
index 05a23aa..c81762f 100644
--- a/README.md
+++ b/README.md
@@ -17,7 +17,7 @@ BitLogger 的文档按使用路径组织：先完成一个可运行的日志输
 ```bash
 moon new log-demo
 cd log-demo
-moon add Nanaloveyuki/BitLogger@0.8.0
+moon add Nanaloveyuki/BitLogger@0.8.1
 ```
 
 ### 2. 写入第一条结构化日志
diff --git a/docs/README-en.md b/docs/README-en.md
index db7d09b..6e329cb 100644
--- a/docs/README-en.md
+++ b/docs/README-en.md
@@ -18,7 +18,7 @@ The documentation is organized around complete usage flows. Start with an execut
 ```bash
 moon new log-demo
 cd log-demo
-moon add Nanaloveyuki/BitLogger@0.8.0
+moon add Nanaloveyuki/BitLogger@0.8.1
 ```
 
 ### 2. Import And Log
diff --git a/docs/changes/1.2.1(0.8.1).md b/docs/changes/1.2.1(0.8.1).md
new file mode 100644
index 0000000..604d73b
--- /dev/null
+++ b/docs/changes/1.2.1(0.8.1).md
@@ -0,0 +1,18 @@
+## BitLogger Update Changes
+
+version 1.2.1(0.8.1)
+
+### Changes
+
+- Add deterministic QuickCheck properties for bounded history retention, queued overflow and drain behavior, patch composition, and logger config round-trips.
+
+### Verification
+
+- moon fmt --check
+- moon check --deny-warn
+- moon test --deny-warn across native, wasm, wasm-gc, and js targets
+- pnpm run docs:build
+
+### Notes
+
+- QuickCheck seeds and shrink budgets are fixed for reproducible failures.
\ No newline at end of file
diff --git a/docs/changes/index.md b/docs/changes/index.md
index 8ca6fa5..f027e38 100644
--- a/docs/changes/index.md
+++ b/docs/changes/index.md
@@ -2,6 +2,7 @@
 
 Versioned BitLogger change summaries.
 
+- [1.2.1](./1.2.1(0.8.1).md)
 - [1.2.0](./1.2.0(0.8.0).md)
 - [1.1.3](./1.1.3(0.7.3).md)
 - [1.1.2](./1.1.2(0.7.2).md)
diff --git a/docs/examples/console.md b/docs/examples/console.md
index 28c164d..3d42429 100644
--- a/docs/examples/console.md
+++ b/docs/examples/console.md
@@ -5,7 +5,7 @@ Use this flow for command-line tools and services that need a human-readable sta
 ## Install And Import
 
 ```bash
-moon add Nanaloveyuki/BitLogger@0.8.0
+moon add Nanaloveyuki/BitLogger@0.8.1
 ```
 
 ```moonbit
diff --git a/docs/zh/examples/console.md b/docs/zh/examples/console.md
index 027a43e..4edb2d6 100644
--- a/docs/zh/examples/console.md
+++ b/docs/zh/examples/console.md
@@ -7,7 +7,7 @@
 ```bash
 moon new log-demo
 cd log-demo
-moon add Nanaloveyuki/BitLogger@0.8.0
+moon add Nanaloveyuki/BitLogger@0.8.1
 ```
 
 在应用的 `moon.pkg` 中加入：
diff --git a/moon.mod b/moon.mod
index 01d73b3..cb86d2a 100644
--- a/moon.mod
+++ b/moon.mod
@@ -1,6 +1,6 @@
 name = "Nanaloveyuki/BitLogger"
 
-version = "0.8.0"
+version = "0.8.1"
 
 import {
   "moonbitlang/async@0.21.0",