docs: 添加代码注释

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"

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() }
 

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,

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