From 7f248802d56eb77ed11acaaee408518672a05645 Mon Sep 17 00:00:00 2001
From: Super12138 <70494801+Super12138@users.noreply.github.com>
Date: Thu, 5 Feb 2026 20:43:29 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=E4=BB=A3=E7=A0=81?=
 =?UTF-8?q?=E6=B3=A8=E9=87=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 app/build.gradle.kts                              |  2 +-
 .../ui/pages/settings/components/SettingsItem.kt  |  3 ++-
 .../kotlin/cn/super12138/todo/utils/TodoExt.kt    | 15 ++++++++++++++-
 .../cn/super12138/todo/utils/VibrationUtils.kt    | 11 +++++++++++
 4 files changed, 28 insertions(+), 3 deletions(-)

diff --git a/app/build.gradle.kts b/app/build.gradle.kts
index 18c4764..0c22098 100644
--- a/app/build.gradle.kts
+++ b/app/build.gradle.kts
@@ -38,7 +38,7 @@ android {
         applicationId = "cn.super12138.todo"
         minSdk = 24
         targetSdk = 36
-        versionCode = 951
+        versionCode = 952
         versionName = "2.3.3"
 
         testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
diff --git a/app/src/main/kotlin/cn/super12138/todo/ui/pages/settings/components/SettingsItem.kt b/app/src/main/kotlin/cn/super12138/todo/ui/pages/settings/components/SettingsItem.kt
index c40c851..bf4f4e6 100644
--- a/app/src/main/kotlin/cn/super12138/todo/ui/pages/settings/components/SettingsItem.kt
+++ b/app/src/main/kotlin/cn/super12138/todo/ui/pages/settings/components/SettingsItem.kt
@@ -238,7 +238,8 @@ fun SettingsItem(
             .padding(
                 horizontal = TodoDefaults.settingsItemHorizontalPadding,
                 vertical = TodoDefaults.settingsItemVerticalPadding
-            ), verticalAlignment = Alignment.CenterVertically
+            ),
+        verticalAlignment = Alignment.CenterVertically
     ) {
         leadingIcon?.let { it() }
 
diff --git a/app/src/main/kotlin/cn/super12138/todo/utils/TodoExt.kt b/app/src/main/kotlin/cn/super12138/todo/utils/TodoExt.kt
index d04dcda..8297445 100644
--- a/app/src/main/kotlin/cn/super12138/todo/utils/TodoExt.kt
+++ b/app/src/main/kotlin/cn/super12138/todo/utils/TodoExt.kt
@@ -24,6 +24,13 @@ fun Priority.containerColor(): Color =
         Priority.Urgent -> MaterialTheme.colorScheme.error
     }
 
+/**
+ * 获取部分圆角的形状
+ *
+ * @param topRounded 顶部是否圆角
+ * @param bottomRounded 底部是否圆角
+ * @param roundedShape 所需圆角形状
+ */
 @Composable
 fun CornerBasedShape.getPartialRoundedShape(
     topRounded: Boolean,
@@ -37,7 +44,13 @@ fun CornerBasedShape.getPartialRoundedShape(
         bottomStart = if (bottomRounded) roundedShape.bottomStart else this.bottomStart,
     )
 
-
+/**
+ * 绘制渐变边缘遮罩
+ *
+ * @param edgeWidth 渐变边缘宽度
+ * @param maskColor 遮罩颜色
+ * @param leftEdge 是否在左侧边缘添加遮罩（否即在右侧边缘添加）
+ */
 fun ContentDrawScope.drawFadedEdge(
     edgeWidth: Dp,
     maskColor: Color,
diff --git a/app/src/main/kotlin/cn/super12138/todo/utils/VibrationUtils.kt b/app/src/main/kotlin/cn/super12138/todo/utils/VibrationUtils.kt
index 2c5cb30..f99a9ba 100644
--- a/app/src/main/kotlin/cn/super12138/todo/utils/VibrationUtils.kt
+++ b/app/src/main/kotlin/cn/super12138/todo/utils/VibrationUtils.kt
@@ -7,10 +7,21 @@ import cn.super12138.todo.constants.Constants
 object VibrationUtils {
     private var isEnabled: Boolean = Constants.PREF_HAPTIC_FEEDBACK_DEFAULT
 
+    /**
+     * 启用或禁用触感反馈
+     */
     fun setEnabled(enabled: Boolean) {
         isEnabled = enabled
     }
 
+    /**
+     * **依据触感反馈的启用状态**为用户提供当前视图的触感反馈
+     *
+     * 注：触感反馈 **当且仅当 `isHapticFeedbackEnabled()` 为 `true` 时（须在系统设置中开启）** 才会被出发
+     *
+     * @param view 触发触感反馈的视图
+     * @param feedbackConstants 触感反馈类型，默认值为 `HapticFeedbackConstants.CONTEXT_CLICK`
+     */
     fun performHapticFeedback(
         view: View,
         feedbackConstants: Int = HapticFeedbackConstants.CONTEXT_CLICK