docs: update README for v1.2.4 release

Author: FunnySaltyFish

README.md

@@ -38,7 +38,13 @@ class MyViewModel: ViewModel() {
 
 **注：此库是对Compose中使用其他框架（比如 Preference、MMKV、DataStore 等）的封装，不是一个单独的数据保存框架**。您可以参考[此链接](https://juejin.cn/post/7144750071156834312)以了解它的设计思想。
 
-<img src="screenshot.png" alt="Example" style="zoom: 15%;" />
+在线预览：<https://funnysaltyfish.github.io/ComposeDataSaver/>
+
+点击下方任意截图即可打开在线预览：
+
+| 预览 1 | 预览 2 | 预览 3 |
+| --- | --- | --- |
+| <a href="https://funnysaltyfish.github.io/ComposeDataSaver/"><img src="screenshots/CN_1.jpg" alt="中文界面预览 1" width="240" /></a> | <a href="https://funnysaltyfish.github.io/ComposeDataSaver/"><img src="screenshots/CN_2.jpg" alt="中文界面预览 2" width="240" /></a> | <a href="https://funnysaltyfish.github.io/ComposeDataSaver/"><img src="screenshots/CN_3.jpg" alt="中文界面预览 3" width="240" /></a> |
 
 您可以点击 [这里下载demo体验](demo.apk)（Debug 包，相较于 release 包较卡顿）
 
@@ -60,7 +66,7 @@ dependencyResolutionManagement {
 
 ```bash
 dependencies {
-    implementation "io.github.funnysaltyfish:data-saver-core:1.2.3"
+    implementation "io.github.funnysaltyfish:data-saver-core:1.2.4"
 }
 ```
 
@@ -69,6 +75,8 @@ dependencies {
 ## 示例代码
 以下介绍的示例代码均可在 [这里](composeApp/src/commonMain/kotlin/com/funny/data_saver/ui/ExampleComposables.kt) 查看具体实现
 
+示例应用采用分组布局，并内置了日志侧边栏，方便直接查看读写日志与状态变化。
+
 ## 配置
 
 项目使用 `DataSaverInterface` 的实现类来保存数据，因此**您需要先提供一个此类对象。**
@@ -93,7 +101,7 @@ CompositionLocalProvider(LocalDataSaver provides dataSaverPreferences){
 
 ```bash
 // if you want to use mmkv
-implementation "io.github.funnysaltyfish:data-saver-mmkv:1.2.3"
+implementation "io.github.funnysaltyfish:data-saver-mmkv:1.2.4"
 implementation 'com.tencent:mmkv:1.2.14'
 ```
 
@@ -121,7 +129,7 @@ CompositionLocalProvider(LocalDataSaver provides dataSaverMMKV){
 
 ```bash
 // if you want to use DataStore
-implementation "io.github.funnysaltyfish:data-saver-data-store-preferences:1.2.3"
+implementation "io.github.funnysaltyfish:data-saver-data-store-preferences:1.2.4"
 def data_store_version = "1.0.0"
 implementation "androidx.datastore:datastore:$data_store_version"
 implementation "androidx.datastore:datastore-preferences:$data_store_version"
@@ -398,19 +406,36 @@ open class SavePolicy {
 }
 ```
 
-### 设置库参数
+### 日志设置
 
-目前，库提供了一些可以设置的参数，它们位于`DataSaverConfig`下
+目前，库提供了分级日志配置，它们位于 `DataSaverConfig` 下：
 
-```Kotlin
-/**
- * 1. DEBUG: 是否输出库的调试信息
- */
+```kotlin
 object DataSaverConfig {
-    var DEBUG = true
+    var logLevel: DataSaverLogLevel = DataSaverLogLevel.INFO
 }
 ```
 
+可用级别如下：
+
+```kotlin
+enum class DataSaverLogLevel {
+    NONE,
+    ERROR,
+    WARNING,
+    INFO,
+    DEBUG,
+    VERBOSE
+}
+```
+
+默认级别为 `INFO`。在默认配置下，读取、恢复、写入、移除以及外部数据变更等关键日志都可直接看到。
+
+> 注意：
+>
+> 1. `DataSaverLogger` 已移除，如果您之前直接使用它，请改为直接调用 `Log`
+> 2. `DataSaverConfig.DEBUG` 仍保留兼容入口，但后续推荐使用 `DataSaverConfig.logLevel`
+
 ### 异步保存
 
 v1.1.0 对 `DataSaverInterface` 新增了 `suspend fun saveDataAsync` ，用于异步保存。默认情况下，它等同于 `saveData`。对于支持协程的框架（如`DataStore`），使用此实现有助于充分利用协程优势（默认给出的`DataStorePreference`就是如此）。

README_en.md

@@ -37,7 +37,13 @@ class MyViewModel: ViewModel() {
 
 **Note: This library is a wrapper for using other frameworks (such as Preference, MMKV, DataStore, etc.) in Compose, not a standalone data storage framework**. You can refer to [this link](https://juejin.cn/post/7144750071156834312) to understand its design concepts.
 
-<img src="screenshot.png" alt="Example" style="zoom: 15%;" />
+Online preview: <https://funnysaltyfish.github.io/ComposeDataSaver/>
+
+Click any screenshot to view the online preview.
+
+| Preview 1 | Preview 2 | Preview 3 |
+| --- | --- | --- |
+| <a href="https://funnysaltyfish.github.io/ComposeDataSaver/"><img src="screenshots/EN_1.jpg" alt="English UI Preview 1" width="240" /></a> | <a href="https://funnysaltyfish.github.io/ComposeDataSaver/"><img src="screenshots/EN_2.jpg" alt="English UI Preview 2" width="240" /></a> | <a href="https://funnysaltyfish.github.io/ComposeDataSaver/"><img src="screenshots/EN_3.jpg" alt="English UI Preview 3" width="240" /></a> |
 
 You can click [here to download the demo for experience](demo.apk) (Debug package, may be slower compared to the release package)
 
@@ -59,14 +65,16 @@ Include in project `build.gradle`
 
 ```bash
 dependencies {
-    implementation "io.github.funnysaltyfish:data-saver-core:1.2.3"
+    implementation "io.github.funnysaltyfish:data-saver-core:1.2.4"
 }
 ```
 > Note: Starting from v1.2.0, the repository has been migrated to Compose Multiplatform and released to Maven Central. The Group Id has also been changed. When upgrading from versions before v1.2.0, please remember to make the necessary changes.
 
 ## Sample Code
 The sample codes described below can be viewed in detail [here](composeApp/src/commonMain/kotlin/com/funny/data_saver/ui/ExampleComposables.kt).
 
+The demo app uses a grouped layout and includes a log sidebar, so you can inspect read/write logs and state changes more easily.
+
 ## Configuration
 
 The project uses an implementation class of `DataSaverInterface` to save data, so **you need to provide an object of this class first.**
@@ -91,11 +99,7 @@ Additionally, we also provide simple implementations based on [MMKV](https://git
 
 ```bash
 // If you want to use MMKV
-The following:
-
-```bash
-// If you want to use MMKV
-implementation "io.github.funnysaltyfish:data-saver-mmkv:1.2.3"
+implementation "io.github.funnysaltyfish:data-saver-mmkv:1.2.4"
 implementation 'com.tencent:mmkv:1.2.14'
 ```
 
@@ -123,7 +127,7 @@ CompositionLocalProvider(LocalDataSaver provides dataSaverMMKV){
 
 ```bash
 // if you want to use DataStore
-implementation "io.github.funnysaltyfish:data-saver-data-store-preferences:1.2.3"
+implementation "io.github.funnysaltyfish:data-saver-data-store-preferences:1.2.4"
 def data_store_version = "1.0.0"
 implementation "androidx.datastore:datastore:$data_store_version"
 implementation "androidx.datastore:datastore-preferences:$data_store_version"
@@ -389,19 +393,36 @@ open class SavePolicy {
 }
 ```
 
-### Setting Library Parameters
+### Logging Configuration
 
-Currently, the library provides some parameters that can be set under `DataSaverConfig`.
+The library now provides leveled logging configuration under `DataSaverConfig`:
 
 ```kotlin
-/**
- * 1. DEBUG: Whether to output debug information of the library
- */
 object DataSaverConfig {
-    var DEBUG = true
+    var logLevel: DataSaverLogLevel = DataSaverLogLevel.INFO
 }
 ```
 
+Available levels:
+
+```kotlin
+enum class DataSaverLogLevel {
+    NONE,
+    ERROR,
+    WARNING,
+    INFO,
+    DEBUG,
+    VERBOSE
+}
+```
+
+The default level is `INFO`. With the default configuration, important logs such as read, restore, write, remove, and external data change events are visible out of the box.
+
+> Note:
+>
+> 1. `DataSaverLogger` has been removed. If you referenced it directly before, migrate to `Log`
+> 2. `DataSaverConfig.DEBUG` is still kept as a compatibility entry point, but `DataSaverConfig.logLevel` is now the recommended API
+
 ### Asynchronous Saving
 
 In version 1.1.0, `suspend fun saveDataAsync` was added to `DataSaverInterface` for asynchronous saving. By default, it is equivalent to `saveData`. For frameworks that support coroutines (such as `DataStore`), using this implementation helps to fully leverage the advantages of coroutines (the default `DataStorePreference` does this).