From 3d4e6fcc306ac0ef981cda3f429326353257abae Mon Sep 17 00:00:00 2001
From: WangYucheng <wangyucheng37@163.com>
Date: Sun, 11 May 2025 19:39:42 +0800
Subject: [PATCH] =?UTF-8?q?20250511=E6=96=87=E4=BB=B6=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .idea/gradle.xml                              |   1 +
 .idea/misc.xml                                |   3 +-
 .idea/vcs.xml                                 |   1 +
 app/build.gradle                              |   1 -
 app/src/main/AndroidManifest.xml              |  46 +++-
 .../java/net/micode/notes/data/Notes.java     |  10 +-
 .../notes/gtask/remote/GTaskClient.java       |  30 +--
 .../net/micode/notes/ui/NoteEditActivity.java |  78 +++++-
 .../net/micode/notes/ui/NoteEditText.java     | 100 ++++++-
 .../net/micode/notes/ui/NoteItemData.java     | 247 +++++++++++++-----
 app/src/main/res/values/styles.xml            |   3 +-
 readme.md                                     |  42 ++-
 12 files changed, 446 insertions(+), 116 deletions(-)

diff --git a/.idea/gradle.xml b/.idea/gradle.xml
index aaf3e43..64b18ac 100644
--- a/.idea/gradle.xml
+++ b/.idea/gradle.xml
@@ -4,6 +4,7 @@
   <component name="GradleSettings">
     <option name="linkedExternalProjectsSettings">
       <GradleProjectSettings>
+        <option name="testRunner" value="GRADLE" />
         <option name="externalProjectPath" value="$PROJECT_DIR$" />
         <option name="gradleJvm" value="corretto-18" />
         <option name="modules">
diff --git a/.idea/misc.xml b/.idea/misc.xml
index 81fbe86..2a8f725 100644
--- a/.idea/misc.xml
+++ b/.idea/misc.xml
@@ -1,9 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
   <component name="ExternalStorageConfigurationManager" enabled="true" />
   <component name="FrameworkDetectionExcludesConfiguration">
     <file type="web" url="file://$PROJECT_DIR$" />
   </component>
-  <component name="ProjectRootManager" version="2" languageLevel="JDK_18" default="true" project-jdk-name="corretto-18" project-jdk-type="JavaSDK">
+  <component name="ProjectRootManager" version="2" languageLevel="JDK_18_PREVIEW" project-jdk-name="corretto-18" project-jdk-type="JavaSDK">
     <output url="file://$PROJECT_DIR$/build/classes" />
   </component>
   <component name="ProjectType">
diff --git a/.idea/vcs.xml b/.idea/vcs.xml
index 6c0b863..288b36b 100644
--- a/.idea/vcs.xml
+++ b/.idea/vcs.xml
@@ -2,5 +2,6 @@
 <project version="4">
   <component name="VcsDirectoryMappings">
     <mapping directory="$PROJECT_DIR$/.." vcs="Git" />
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
   </component>
 </project>
\ No newline at end of file
diff --git a/app/build.gradle b/app/build.gradle
index 906f08b..fa32ae9 100644
--- a/app/build.gradle
+++ b/app/build.gradle
@@ -36,7 +36,6 @@ dependencies {
     implementation 'androidx.appcompat:appcompat:1.4.1'
     implementation 'com.google.android.material:material:1.5.0'
     implementation 'androidx.constraintlayout:constraintlayout:2.1.3'
-    implementation 'com.google.firebase:firebase-crashlytics-buildtools:2.8.1'
     testImplementation 'junit:junit:4.13.2'
     androidTestImplementation 'androidx.test.ext:junit:1.1.3'
     androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'
diff --git a/app/src/main/AndroidManifest.xml b/app/src/main/AndroidManifest.xml
index e061ed5..5574e2a 100644
--- a/app/src/main/AndroidManifest.xml
+++ b/app/src/main/AndroidManifest.xml
@@ -1,8 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
     xmlns:tools="http://schemas.android.com/tools">
+    <!-- AndroidManifest.xml 是 Android 应用的核心配置文件，定义了应用的基本信息、组件声明以及权限需求。-->
 
+    <!-- 定义应用所需的权限 -->
     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
+        <!--从 Android 13 开始，WRITE_EXTERNAL_STORAGE 权限已被弃用
+        直接访问共享存储需要使用更安全的 API（如 MediaStore）以提升用户隐私保护。-->
     <uses-permission android:name="com.android.launcher.permission.INSTALL_SHORTCUT" />
     <uses-permission android:name="android.permission.INTERNET" />
     <uses-permission android:name="android.permission.READ_CONTACTS" />
@@ -16,17 +20,17 @@
         android:allowBackup="true"
         android:dataExtractionRules="@xml/data_extraction_rules"
         android:fullBackupContent="@xml/backup_rules"
-        android:icon="@mipmap/ic_launcher"
+        android:icon="@drawable/icon_app"
         android:label="@string/app_name"
         android:roundIcon="@mipmap/ic_launcher_round"
         android:supportsRtl="true"
         android:theme="@style/Theme.Notesmaster"
         tools:targetApi="31">
 
+        <!-- 定义主活动，作为应用的入口点 -->
         <activity
             android:name=".ui.NotesListActivity"
             android:configChanges="keyboardHidden|orientation|screenSize"
-            android:label="@string/app_name"
             android:launchMode="singleTop"
             android:theme="@style/NoteTheme"
             android:uiOptions="splitActionBarWhenNarrow"
@@ -39,6 +43,7 @@
             </intent-filter>
         </activity>
 
+        <!-- 定义笔记编辑活动 -->
         <activity
             android:name=".ui.NoteEditActivity"
             android:configChanges="keyboardHidden|orientation|screenSize"
@@ -70,12 +75,17 @@
                 android:resource="@xml/searchable" />
         </activity>
 
-
+        <!-- 定义内容提供者 -->
         <provider
-            android:name="net.micode.notes.data.NotesProvider"
-            android:authorities="micode_notes"
-            android:multiprocess="true" />
+        android:name="net.micode.notes.data.NotesProvider"
+        android:authorities="micode_notes"
+        android:multiprocess="true"
+        android:exported="false"
+        android:readPermission="com.example.notesmaster.permission.READ_NOTES"
+        android:writePermission="com.example.notesmaster.permission.WRITE_NOTES" />
+
 
+        <!-- 定义小部件提供者 -->
         <receiver
             android:name=".widget.NoteWidgetProvider_2x"
             android:label="@string/app_widget2x2"
@@ -106,6 +116,7 @@
                 android:resource="@xml/widget_4x_info" />
         </receiver>
 
+        <!-- 定义启动时初始化闹钟的接收器 -->
         <receiver android:name=".ui.AlarmInitReceiver"
             android:exported="true">
             <intent-filter>
@@ -113,18 +124,20 @@
             </intent-filter>
         </receiver>
 
+        <!-- 定义处理闹钟事件的接收器 -->
         <receiver
             android:name="net.micode.notes.ui.AlarmReceiver"
             android:process=":remote" >
         </receiver>
 
+        <!-- 定义闹钟提醒活动 -->
         <activity
             android:name=".ui.AlarmAlertActivity"
-            android:label="@string/app_name"
             android:launchMode="singleInstance"
             android:theme="@android:style/Theme.Holo.Wallpaper.NoTitleBar" >
         </activity>
 
+        <!-- 定义设置活动 -->
         <activity
             android:name="net.micode.notes.ui.NotesPreferenceActivity"
             android:label="@string/preferences_title"
@@ -132,11 +145,13 @@
             android:theme="@android:style/Theme.Holo.Light" >
         </activity>
 
+        <!-- 定义Google任务同步服务 -->
         <service
             android:name="net.micode.notes.gtask.remote.GTaskSyncService"
             android:exported="false" >
         </service>
 
+        <!-- 定义默认搜索活动 -->
         <meta-data
             android:name="android.app.default_searchable"
             android:value=".ui.NoteEditActivity" />
@@ -149,7 +164,22 @@
 
         <!--                <category android:name="android.intent.category.LAUNCHER" />-->
         <!--            </intent-filter>-->
-        <!--        </activity>-->
+        <!--        </activity>
+
+
+            这段代码被注释化的原因可能有以下几种情况：
+        冗余配置：
+            如果应用已经有另一个活动（如 NotesListActivity）作为主入口点，并且已经正确配置了 <intent-filter>，
+            那么再定义一个类似的 MainActivity 就是冗余的。为了避免冲突或重复配置，开发者选择将其注释掉。
+        开发阶段调整：
+            在开发过程中，开发者可能尝试过不同的入口点配置，最终选择了 NotesListActivity 作为主活动，
+            因此将 MainActivity 注释掉以保留历史代码供参考。
+        功能迁移：
+            如果应用的功能结构发生了变化，原本由 MainActivity 承担的功能现在由其他活动（如 NotesListActivity）接管，
+            那么 MainActivity 就不再需要作为主入口点。
+        测试或调试：
+            有时开发者会临时注释掉某些代码以进行测试或调试，之后忘记取消注释。-->
+
 
     </application>
 
diff --git a/app/src/main/java/net/micode/notes/data/Notes.java b/app/src/main/java/net/micode/notes/data/Notes.java
index 7948b8a..f240604 100644
--- a/app/src/main/java/net/micode/notes/data/Notes.java
+++ b/app/src/main/java/net/micode/notes/data/Notes.java
@@ -206,35 +206,35 @@ public class Notes {
 
 
         /**
-         * Generic data column, the meaning is  specific, used for
+         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
          * integer data type
          * <P> Type: INTEGER </P>
          */
         public static final String DATA1 = "data1";
 
         /**
-         * Generic data column, the meaning is  specific, used for
+         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
          * integer data type
          * <P> Type: INTEGER </P>
          */
         public static final String DATA2 = "data2";
 
         /**
-         * Generic data column, the meaning is  specific, used for
+         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
          * TEXT data type
          * <P> Type: TEXT </P>
          */
         public static final String DATA3 = "data3";
 
         /**
-         * Generic data column, the meaning is  specific, used for
+         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
          * TEXT data type
          * <P> Type: TEXT </P>
          */
         public static final String DATA4 = "data4";
 
         /**
-         * Generic data column, the meaning is  specific, used for
+         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
          * TEXT data type
          * <P> Type: TEXT </P>
          */
diff --git a/app/src/main/java/net/micode/notes/gtask/remote/GTaskClient.java b/app/src/main/java/net/micode/notes/gtask/remote/GTaskClient.java
index 08a1768..c67dfdf 100644
--- a/app/src/main/java/net/micode/notes/gtask/remote/GTaskClient.java
+++ b/app/src/main/java/net/micode/notes/gtask/remote/GTaskClient.java
@@ -24,20 +24,6 @@ import android.os.Bundle;
 import android.text.TextUtils;
 import android.util.Log;
 
-import com.google.firebase.crashlytics.buildtools.reloc.org.apache.http.HttpEntity;
-import com.google.firebase.crashlytics.buildtools.reloc.org.apache.http.HttpResponse;
-import com.google.firebase.crashlytics.buildtools.reloc.org.apache.http.client.ClientProtocolException;
-import com.google.firebase.crashlytics.buildtools.reloc.org.apache.http.client.entity.UrlEncodedFormEntity;
-import com.google.firebase.crashlytics.buildtools.reloc.org.apache.http.client.methods.HttpGet;
-import com.google.firebase.crashlytics.buildtools.reloc.org.apache.http.client.methods.HttpPost;
-import com.google.firebase.crashlytics.buildtools.reloc.org.apache.http.conn.ClientConnectionManager;
-import com.google.firebase.crashlytics.buildtools.reloc.org.apache.http.cookie.Cookie;
-import com.google.firebase.crashlytics.buildtools.reloc.org.apache.http.impl.client.BasicCookieStore;
-import com.google.firebase.crashlytics.buildtools.reloc.org.apache.http.impl.client.DefaultHttpClient;
-import com.google.firebase.crashlytics.buildtools.reloc.org.apache.http.message.BasicNameValuePair;
-import com.google.firebase.crashlytics.buildtools.reloc.org.apache.http.params.BasicHttpParams;
-import com.google.firebase.crashlytics.buildtools.reloc.org.apache.http.params.HttpProtocolParams;
-
 import net.micode.notes.gtask.data.Node;
 import net.micode.notes.gtask.data.Task;
 import net.micode.notes.gtask.data.TaskList;
@@ -46,8 +32,20 @@ import net.micode.notes.gtask.exception.NetworkFailureException;
 import net.micode.notes.tool.GTaskStringUtils;
 import net.micode.notes.ui.NotesPreferenceActivity;
 
+import org.apache.http.HttpEntity;
+import org.apache.http.HttpResponse;
+import org.apache.http.client.ClientProtocolException;
+import org.apache.http.client.entity.UrlEncodedFormEntity;
+import org.apache.http.client.methods.HttpGet;
+import org.apache.http.client.methods.HttpPost;
+import org.apache.http.cookie.Cookie;
+import org.apache.http.impl.client.BasicCookieStore;
+import org.apache.http.impl.client.DefaultHttpClient;
+import org.apache.http.message.BasicNameValuePair;
+import org.apache.http.params.BasicHttpParams;
 import org.apache.http.params.HttpConnectionParams;
 import org.apache.http.params.HttpParams;
+import org.apache.http.params.HttpProtocolParams;
 import org.json.JSONArray;
 import org.json.JSONException;
 import org.json.JSONObject;
@@ -230,10 +228,10 @@ public class GTaskClient {
     private boolean loginGtask(String authToken) {
         int timeoutConnection = 10000;
         int timeoutSocket = 15000;
-        HttpParams httpParameters = (HttpParams) new BasicHttpParams();
+        HttpParams httpParameters = new BasicHttpParams();
         HttpConnectionParams.setConnectionTimeout(httpParameters, timeoutConnection);
         HttpConnectionParams.setSoTimeout(httpParameters, timeoutSocket);
-        mHttpClient = new DefaultHttpClient((ClientConnectionManager) httpParameters);
+        mHttpClient = new DefaultHttpClient(httpParameters);
         BasicCookieStore localBasicCookieStore = new BasicCookieStore();
         mHttpClient.setCookieStore(localBasicCookieStore);
         HttpProtocolParams.setUseExpectContinue(mHttpClient.getParams(), false);
diff --git a/app/src/main/java/net/micode/notes/ui/NoteEditActivity.java b/app/src/main/java/net/micode/notes/ui/NoteEditActivity.java
index 96a9ff8..439955c 100644
--- a/app/src/main/java/net/micode/notes/ui/NoteEditActivity.java
+++ b/app/src/main/java/net/micode/notes/ui/NoteEditActivity.java
@@ -430,7 +430,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         if (id == R.id.btn_set_bg_color) {
             mNoteBgColorSelector.setVisibility(View.VISIBLE);
             findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility(
-                    -                    View.VISIBLE);
+                    View.VISIBLE);
         } else if (sBgSelectorBtnsMap.containsKey(id)) {
             findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility(
                     View.GONE);
@@ -564,21 +564,36 @@ public class NoteEditActivity extends Activity implements OnClickListener,
     }
 
     /**
-     * Share note to apps that support {@link Intent#ACTION_SEND} action
-     * and {@text/plain} type
+     * 将指定的文本信息分享到支持 {@link Intent#ACTION_SEND} 操作和 {@text/plain} 类型的应用程序。
+     *
+     * @param context 上下文对象，用于启动新的 Activity。
+     * @param info 要分享的文本信息，将被作为 {@link Intent#EXTRA_TEXT} 传递给目标应用程序。
      */
     private void sendTo(Context context, String info) {
+        // 创建一个新的 Intent，设置操作为 ACTION_SEND，用于分享文本信息
         Intent intent = new Intent(Intent.ACTION_SEND);
+
+        // 将要分享的文本信息作为 EXTRA_TEXT 添加到 Intent 中
         intent.putExtra(Intent.EXTRA_TEXT, info);
+
+        // 设置 Intent 的 MIME 类型为 text/plain，表示分享的是纯文本
         intent.setType("text/plain");
+
+        // 启动目标应用程序的 Activity，分享文本信息
         context.startActivity(intent);
     }
 
+
+    /**
+     * 创建一个新的笔记。
+     * 该函数首先保存当前正在编辑的笔记，然后启动一个新的NoteEditActivity以安全地创建新笔记。
+     * 通过调用finish()结束当前Activity，并传递必要的Intent参数来启动新的NoteEditActivity。
+     */
     private void createNewNote() {
-        // Firstly, save current editing notes
+        // 首先保存当前正在编辑的笔记，确保数据不会丢失
         saveNote();
 
-        // For safety, start a new NoteEditActivity
+        // 结束当前Activity，并启动一个新的NoteEditActivity以创建新笔记
         finish();
         Intent intent = new Intent(this, NoteEditActivity.class);
         intent.setAction(Intent.ACTION_INSERT_OR_EDIT);
@@ -586,25 +601,44 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         startActivity(intent);
     }
 
+    /**
+     * 删除当前正在处理的笔记。如果笔记存在于数据库中，则根据同步模式决定是直接删除还是移动到回收站。
+     * 如果笔记不存在于数据库中，则仅标记为已删除状态。
+     *
+     * 该函数首先检查笔记是否存在于数据库中。如果存在，则根据笔记ID决定是否将其添加到待删除的ID集合中。
+     * 如果当前不在同步模式，则直接批量删除这些笔记；如果在同步模式，则将笔记移动到回收站。
+     * 最后，无论笔记是否存在于数据库中，都会将其标记为已删除状态。
+     */
     private void deleteCurrentNote() {
+        // 检查当前笔记是否存在于数据库中
         if (mWorkingNote.existInDatabase()) {
+            // 创建一个HashSet来存储待删除的笔记ID
             HashSet<Long> ids = new HashSet<Long>();
             long id = mWorkingNote.getNoteId();
+
+            // 如果笔记ID不是根文件夹的ID，则将其添加到待删除的ID集合中
             if (id != Notes.ID_ROOT_FOLDER) {
                 ids.add(id);
             } else {
+                // 如果笔记ID是根文件夹的ID，则记录错误日志
                 Log.d(TAG, "Wrong note id, should not happen");
             }
+
+            // 根据是否处于同步模式决定是直接删除还是移动到回收站
             if (!isSyncMode()) {
+                // 如果不在同步模式，则尝试批量删除笔记
                 if (!DataUtils.batchDeleteNotes(getContentResolver(), ids)) {
                     Log.e(TAG, "Delete Note error");
                 }
             } else {
+                // 如果在同步模式，则尝试将笔记移动到回收站
                 if (!DataUtils.batchMoveToFolder(getContentResolver(), ids, Notes.ID_TRASH_FOLER)) {
                     Log.e(TAG, "Move notes to trash folder error, should not happens");
                 }
             }
         }
+
+        // 无论笔记是否存在于数据库中，都将其标记为已删除状态
         mWorkingNote.markDeleted(true);
     }
 
@@ -612,14 +646,27 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         return NotesPreferenceActivity.getSyncAccountName(this).trim().length() > 0;
     }
 
+    /**
+     * 处理闹钟提醒的更改事件。
+     * 根据传入的日期和设置状态，为当前笔记设置或取消闹钟提醒。
+     * 如果笔记尚未保存到数据库，则先保存笔记。
+     *
+     * @param date 闹钟提醒的日期和时间，以毫秒为单位的时间戳
+     * @param set 是否设置闹钟提醒，true 表示设置，false 表示取消
+     */
     public void onClockAlertChanged(long date, boolean set) {
         /**
-         * User could set clock to an unsaved note, so before setting the
-         * alert clock, we should save the note first
+         * 如果当前笔记尚未保存到数据库，则先保存笔记。
+         * 因为用户可能会为未保存的笔记设置闹钟提醒，所以需要确保笔记已保存。
          */
         if (!mWorkingNote.existInDatabase()) {
             saveNote();
         }
+
+        /**
+         * 如果笔记已保存（即笔记ID大于0），则根据设置状态设置或取消闹钟提醒。
+         * 使用 AlarmManager 来管理闹钟，并通过 PendingIntent 触发 AlarmReceiver。
+         */
         if (mWorkingNote.getNoteId() > 0) {
             Intent intent = new Intent(this, AlarmReceiver.class);
             intent.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, mWorkingNote.getNoteId()));
@@ -633,9 +680,8 @@ public class NoteEditActivity extends Activity implements OnClickListener,
             }
         } else {
             /**
-             * There is the condition that user has input nothing (the note is
-             * not worthy saving), we have no note id, remind the user that he
-             * should input something
+             * 如果笔记尚未保存且用户未输入任何内容（笔记不值得保存），
+             * 则提醒用户需要输入内容才能设置闹钟提醒。
              */
             Log.e(TAG, "Clock alert setting error");
             showToast(R.string.error_note_empty_for_clock);
@@ -646,18 +692,30 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         updateWidget();
     }
 
+    /**
+     * 处理编辑文本删除操作。
+     * 当删除某个编辑框时，调整后续编辑框的索引，并将删除的文本内容追加到前一个或后一个编辑框中。
+     *
+     * @param index 被删除的编辑框的索引
+     * @param text  被删除的文本内容
+     */
     public void onEditTextDelete(int index, String text) {
         int childCount = mEditTextList.getChildCount();
+        // 如果只有一个编辑框，直接返回，不允许删除
         if (childCount == 1) {
             return;
         }
 
+        // 调整后续编辑框的索引
         for (int i = index + 1; i < childCount; i++) {
             ((NoteEditText) mEditTextList.getChildAt(i).findViewById(R.id.et_edit_text))
                     .setIndex(i - 1);
         }
 
+        // 移除指定索引的编辑框
         mEditTextList.removeViewAt(index);
+
+        // 获取前一个或后一个编辑框，并将删除的文本内容追加到其中
         NoteEditText edit = null;
         if(index == 0) {
             edit = (NoteEditText) mEditTextList.getChildAt(0).findViewById(
diff --git a/app/src/main/java/net/micode/notes/ui/NoteEditText.java b/app/src/main/java/net/micode/notes/ui/NoteEditText.java
index 2afe2a8..b4c2fc5 100644
--- a/app/src/main/java/net/micode/notes/ui/NoteEditText.java
+++ b/app/src/main/java/net/micode/notes/ui/NoteEditText.java
@@ -82,136 +82,232 @@ public class NoteEditText extends EditText {
         mIndex = 0;
     }
 
+    /**
+     * 设置索引值
+     * 该方法用于从外部更新对象的索引状态
+     *
+     * @param index 新的索引值，用于替换当前对象的索引
+     */
     public void setIndex(int index) {
         mIndex = index;
     }
 
+    /**
+     * 设置文本视图变化监听器
+     * 用于在文本视图的内容发生变化时通知监听器
+     *
+     * @param listener 实现了OnTextViewChangeListener接口的监听器实例
+     */
     public void setOnTextViewChangeListener(OnTextViewChangeListener listener) {
         mOnTextViewChangeListener = listener;
     }
 
+    /**
+    * 构造函数，用于在 XML 布局中实例化 NoteEditText 组件。
+    *
+    * @param context 上下文对象，包含应用环境信息
+    * @param attrs   从 XML 布局文件中解析的属性集合
+    */
     public NoteEditText(Context context, AttributeSet attrs) {
         super(context, attrs, android.R.attr.editTextStyle);
     }
 
+    /**
+    * 构造函数，用于在 XML 布局中实例化 NoteEditText 组件，并允许指定默认样式。
+    *
+    * @param context 上下文对象，包含应用环境信息
+    * @param attrs   从 XML 布局文件中解析的属性集合
+    * @param defStyle 默认样式资源 ID，用于自定义组件外观
+    */
     public NoteEditText(Context context, AttributeSet attrs, int defStyle) {
         super(context, attrs, defStyle);
         // TODO Auto-generated constructor stub
     }
 
+    /**
+     * 处理触摸事件以实现特定的交互逻辑
+     * 当用户触摸屏幕时，此方法被调用，用于处理触摸事件
+     * 特别地，当触摸动作为按下时，它会计算触摸位置，并更新文本选择
+     *
+     * @param event 触摸事件，包含触摸动作、位置等信息
+     * @return 返回true表示事件已被处理，false表示未处理
+     */
     @Override
     public boolean onTouchEvent(MotionEvent event) {
+        // 根据触摸事件的类型进行不同的处理
         switch (event.getAction()) {
             case MotionEvent.ACTION_DOWN:
-
+                // 获取触摸点相对于视图的坐标
                 int x = (int) event.getX();
                 int y = (int) event.getY();
+                // 调整坐标以考虑视图的内边距
                 x -= getTotalPaddingLeft();
                 y -= getTotalPaddingTop();
+                // 调整坐标以考虑视图的滚动偏移
                 x += getScrollX();
                 y += getScrollY();
 
+                // 获取视图中的文本布局
                 Layout layout = getLayout();
+                // 根据垂直位置计算触摸点所在的文本行
                 int line = layout.getLineForVertical(y);
+                // 根据水平位置计算触摸点所在的文本偏移量
                 int off = layout.getOffsetForHorizontal(line, x);
+                // 更新文本选择
                 Selection.setSelection(getText(), off);
                 break;
         }
 
+        // 调用父类的onTouchEvent方法以处理其他触摸事件
         return super.onTouchEvent(event);
     }
 
+    /**
+     * 重写onKeyDown方法以处理特定的键盘事件
+     *
+     * @param keyCode 键盘事件的键码
+     * @param event 键盘事件的对象
+     * @return 如果事件被处理返回true，否则返回false
+     */
     @Override
     public boolean onKeyDown(int keyCode, KeyEvent event) {
+        // 根据不同的键码做相应的处理
         switch (keyCode) {
             case KeyEvent.KEYCODE_ENTER:
+                // 当检测到ENTER键时，如果mOnTextViewChangeListener不为空，则不处理事件，交由其他处理程序处理
                 if (mOnTextViewChangeListener != null) {
                     return false;
                 }
                 break;
             case KeyEvent.KEYCODE_DEL:
+                // 当检测到DEL键时，记录删除操作前的光标位置
                 mSelectionStartBeforeDelete = getSelectionStart();
                 break;
             default:
+                // 对于其他键码，不做特殊处理
                 break;
         }
+        // 对于未特殊处理的键码，调用父类的方法处理
         return super.onKeyDown(keyCode, event);
     }
 
+    /**
+     * 处理键盘按键释放事件
+     *
+     * @param keyCode 按键代码，标识哪个键被释放
+     * @param event 键盘事件对象，包含更多关于该事件的详细信息
+     * @return 如果事件被处理，返回true；否则返回false
+     */
     @Override
     public boolean onKeyUp(int keyCode, KeyEvent event) {
+        // 根据按键代码处理不同的按键事件
         switch(keyCode) {
             case KeyEvent.KEYCODE_DEL:
+                // 处理删除键释放事件
                 if (mOnTextViewChangeListener != null) {
+                    // 如果删除前光标位置为0且不是第一个文本框，则通知监听器进行删除操作
                     if (0 == mSelectionStartBeforeDelete && mIndex != 0) {
                         mOnTextViewChangeListener.onEditTextDelete(mIndex, getText().toString());
                         return true;
                     }
                 } else {
+                    // 如果监听器未设置，则记录日志
                     Log.d(TAG, "OnTextViewChangeListener was not seted");
                 }
                 break;
             case KeyEvent.KEYCODE_ENTER:
+                // 处理回车键释放事件
                 if (mOnTextViewChangeListener != null) {
+                    // 获取当前光标位置并分离出光标后的文本，然后设置文本框内容为光标前的文本
                     int selectionStart = getSelectionStart();
                     String text = getText().subSequence(selectionStart, length()).toString();
                     setText(getText().subSequence(0, selectionStart));
+                    // 通知监听器进行回车操作处理
                     mOnTextViewChangeListener.onEditTextEnter(mIndex + 1, text);
                 } else {
+                    // 如果监听器未设置，则记录日志
                     Log.d(TAG, "OnTextViewChangeListener was not seted");
                 }
                 break;
             default:
+                // 对于其他按键事件，不做任何处理
                 break;
         }
+        // 如果上述条件都不满足，则调用父类的onKeyUp方法处理事件
         return super.onKeyUp(keyCode, event);
     }
 
+    /**
+     * 当视图焦点改变时调用的方法
+     *
+     * @param focused 表示视图是否获得了焦点
+     * @param direction 表示焦点移动的方向
+     * @param previouslyFocusedRect 表示之前获得焦点的视图的矩形区域
+     */
     @Override
     protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) {
+        // 如果有注册的文本视图变更监听器
         if (mOnTextViewChangeListener != null) {
+            // 如果视图失去焦点且文本为空，则调用监听器的onTextChange方法，参数为false
             if (!focused && TextUtils.isEmpty(getText())) {
                 mOnTextViewChangeListener.onTextChange(mIndex, false);
             } else {
+                // 否则，调用监听器的onTextChange方法，参数为true
                 mOnTextViewChangeListener.onTextChange(mIndex, true);
             }
         }
+        // 调用父类的onFocusChanged方法，确保焦点改变的默认行为得以执行
         super.onFocusChanged(focused, direction, previouslyFocusedRect);
     }
 
+    /**
+     * 重写创建上下文菜单的方法
+     * 此方法用于在长按文本时创建上下文菜单，根据选中的文本部分是否包含URL来决定菜单项
+     * 如果选中的文本中仅包含一个URL，则在菜单中添加一个相应的选项，点击可跳转到该链接
+     */
     @Override
     protected void onCreateContextMenu(ContextMenu menu) {
+        // 检查当前文本是否为Spanned类型，以支持富文本
         if (getText() instanceof Spanned) {
+            // 获取选中文本的起始和结束位置
             int selStart = getSelectionStart();
             int selEnd = getSelectionEnd();
 
+            // 确定选中文本的最小和最大位置，以处理选中区域
             int min = Math.min(selStart, selEnd);
             int max = Math.max(selStart, selEnd);
 
+            // 获取选中文本范围内的所有URLSpan对象
             final URLSpan[] urls = ((Spanned) getText()).getSpans(min, max, URLSpan.class);
+            // 如果选中的文本中仅有一个URL，则进一步处理
             if (urls.length == 1) {
                 int defaultResId = 0;
+                // 遍历预定义的schema-action资源映射，查找匹配的URL schema
                 for(String schema: sSchemaActionResMap.keySet()) {
+                    // 如果URL包含当前schema，则获取对应的资源ID，并停止遍历
                     if(urls[0].getURL().indexOf(schema) >= 0) {
                         defaultResId = sSchemaActionResMap.get(schema);
                         break;
                     }
                 }
 
+                // 如果没有找到匹配的schema，则使用默认的“其他”资源
                 if (defaultResId == 0) {
                     defaultResId = R.string.note_link_other;
                 }
 
+                // 在上下文菜单中添加一个菜单项，并设置点击事件处理
                 menu.add(0, 0, 0, defaultResId).setOnMenuItemClickListener(
                         new OnMenuItemClickListener() {
                             public boolean onMenuItemClick(MenuItem item) {
-                                // goto a new intent
+                                // 点击菜单项时，触发URL的onClick事件，通常会启动一个新的Activity
                                 urls[0].onClick(NoteEditText.this);
                                 return true;
                             }
                         });
             }
         }
+        // 调用父类方法，确保菜单被正确创建
         super.onCreateContextMenu(menu);
     }
 }
diff --git a/app/src/main/java/net/micode/notes/ui/NoteItemData.java b/app/src/main/java/net/micode/notes/ui/NoteItemData.java
index 0f5a878..33c3ae6 100644
--- a/app/src/main/java/net/micode/notes/ui/NoteItemData.java
+++ b/app/src/main/java/net/micode/notes/ui/NoteItemData.java
@@ -76,39 +76,76 @@ public class NoteItemData {
     private boolean mIsOneNoteFollowingFolder;
     private boolean mIsMultiNotesFollowingFolder;
 
-    public NoteItemData(Context context, Cursor cursor) {
-        mId = cursor.getLong(ID_COLUMN);
-        mAlertDate = cursor.getLong(ALERTED_DATE_COLUMN);
-        mBgColorId = cursor.getInt(BG_COLOR_ID_COLUMN);
-        mCreatedDate = cursor.getLong(CREATED_DATE_COLUMN);
-        mHasAttachment = (cursor.getInt(HAS_ATTACHMENT_COLUMN) > 0) ? true : false;
-        mModifiedDate = cursor.getLong(MODIFIED_DATE_COLUMN);
-        mNotesCount = cursor.getInt(NOTES_COUNT_COLUMN);
-        mParentId = cursor.getLong(PARENT_ID_COLUMN);
-        mSnippet = cursor.getString(SNIPPET_COLUMN);
-        mSnippet = mSnippet.replace(NoteEditActivity.TAG_CHECKED, "").replace(
-                NoteEditActivity.TAG_UNCHECKED, "");
-        mType = cursor.getInt(TYPE_COLUMN);
-        mWidgetId = cursor.getInt(WIDGET_ID_COLUMN);
-        mWidgetType = cursor.getInt(WIDGET_TYPE_COLUMN);
-
-        mPhoneNumber = "";
-        if (mParentId == Notes.ID_CALL_RECORD_FOLDER) {
-            mPhoneNumber = DataUtils.getCallNumberByNoteId(context.getContentResolver(), mId);
-            if (!TextUtils.isEmpty(mPhoneNumber)) {
-                mName = Contact.getContact(context, mPhoneNumber);
-                if (mName == null) {
-                    mName = mPhoneNumber;
-                }
+    /**
+ * NoteItemData 的构造函数，用于从数据库 Cursor 中初始化 NoteItemData 对象。
+ *
+ * @param context 上下文对象，用于获取内容解析器和联系人信息。
+ * @param cursor  数据库查询结果的 Cursor，包含笔记的相关信息。
+ */
+public NoteItemData(Context context, Cursor cursor) {
+    // 从 Cursor 中提取笔记的 ID
+    mId = cursor.getLong(ID_COLUMN);
+
+    // 从 Cursor 中提取笔记的提醒日期
+    mAlertDate = cursor.getLong(ALERTED_DATE_COLUMN);
+
+    // 从 Cursor 中提取笔记的背景颜色 ID
+    mBgColorId = cursor.getInt(BG_COLOR_ID_COLUMN);
+
+    // 从 Cursor 中提取笔记的创建日期
+    mCreatedDate = cursor.getLong(CREATED_DATE_COLUMN);
+
+    // 从 Cursor 中提取笔记是否包含附件的信息，并转换为布尔值
+    mHasAttachment = (cursor.getInt(HAS_ATTACHMENT_COLUMN) > 0) ? true : false;
+
+    // 从 Cursor 中提取笔记的最后修改日期
+    mModifiedDate = cursor.getLong(MODIFIED_DATE_COLUMN);
+
+    // 从 Cursor 中提取笔记下的子笔记数量
+    mNotesCount = cursor.getInt(NOTES_COUNT_COLUMN);
+
+    // 从 Cursor 中提取笔记的父级 ID（即所属文件夹的 ID）
+    mParentId = cursor.getLong(PARENT_ID_COLUMN);
+
+    // 从 Cursor 中提取笔记的摘要信息，并移除标记符号（TAG_CHECKED 和 TAG_UNCHECKED）
+    mSnippet = cursor.getString(SNIPPET_COLUMN);
+    mSnippet = mSnippet.replace(NoteEditActivity.TAG_CHECKED, "").replace(NoteEditActivity.TAG_UNCHECKED, "");
+
+    // 从 Cursor 中提取笔记的类型（如普通笔记、文件夹等）
+    mType = cursor.getInt(TYPE_COLUMN);
+
+    // 从 Cursor 中提取笔记的小部件 ID
+    mWidgetId = cursor.getInt(WIDGET_ID_COLUMN);
+
+    // 从 Cursor 中提取笔记的小部件类型
+    mWidgetType = cursor.getInt(WIDGET_TYPE_COLUMN);
+
+    // 初始化电话号码为空字符串
+    mPhoneNumber = "";
+
+    // 如果笔记属于通话记录文件夹，则获取其对应的电话号码
+    if (mParentId == Notes.ID_CALL_RECORD_FOLDER) {
+        mPhoneNumber = DataUtils.getCallNumberByNoteId(context.getContentResolver(), mId);
+        if (!TextUtils.isEmpty(mPhoneNumber)) {
+            // 根据电话号码获取联系人姓名
+            mName = Contact.getContact(context, mPhoneNumber);
+            if (mName == null) {
+                // 如果未找到联系人姓名，则使用电话号码作为名称
+                mName = mPhoneNumber;
             }
         }
+    }
 
-        if (mName == null) {
-            mName = "";
-        }
-        checkPostion(cursor);
+    // 如果 mName 仍为 null，则将其设置为空字符串
+    if (mName == null) {
+        mName = "";
     }
 
+    // 检查笔记在 Cursor 中的位置信息（如是否为第一个、最后一个等）
+    checkPostion(cursor);
+}
+
+
     private void checkPostion(Cursor cursor) {
         mIsLastItem = cursor.isLast() ? true : false;
         mIsFirstItem = cursor.isFirst() ? true : false;
@@ -158,61 +195,131 @@ public class NoteItemData {
         return mIsOnlyOneItem;
     }
 
-    public long getId() {
-        return mId;
-    }
+ /**
+ * 获取笔记的唯一标识符。
+ *
+ * @return 笔记的 ID。
+ */
+public long getId() {
+    return mId;
+}
 
-    public long getAlertDate() {
-        return mAlertDate;
-    }
+/**
+ * 获取笔记的提醒日期。
+ *
+ * @return 提醒日期，如果未设置则返回 0。
+ */
+public long getAlertDate() {
+    return mAlertDate;
+}
 
-    public long getCreatedDate() {
-        return mCreatedDate;
-    }
+/**
+ * 获取笔记的创建日期。
+ *
+ * @return 创建日期的时间戳。
+ */
+public long getCreatedDate() {
+    return mCreatedDate;
+}
 
-    public boolean hasAttachment() {
-        return mHasAttachment;
-    }
+/**
+ * 检查笔记是否包含附件。
+ *
+ * @return 如果包含附件则返回 true，否则返回 false。
+ */
+public boolean hasAttachment() {
+    return mHasAttachment;
+}
 
-    public long getModifiedDate() {
-        return mModifiedDate;
-    }
+/**
+ * 获取笔记的最后修改日期。
+ *
+ * @return 最后修改日期的时间戳。
+ */
+public long getModifiedDate() {
+    return mModifiedDate;
+}
 
-    public int getBgColorId() {
-        return mBgColorId;
-    }
+/**
+ * 获取笔记的背景颜色 ID。
+ *
+ * @return 背景颜色 ID。
+ */
+public int getBgColorId() {
+    return mBgColorId;
+}
 
-    public long getParentId() {
-        return mParentId;
-    }
+/**
+ * 获取笔记的父级 ID，即所属文件夹的 ID。
+ *
+ * @return 父级 ID。
+ */
+public long getParentId() {
+    return mParentId;
+}
 
-    public int getNotesCount() {
-        return mNotesCount;
-    }
+/**
+ * 获取笔记下的子笔记数量。
+ *
+ * @return 子笔记数量。
+ */
+public int getNotesCount() {
+    return mNotesCount;
+}
 
-    public long getFolderId () {
-        return mParentId;
-    }
+/**
+ * 获取笔记的文件夹 ID，等同于 getParentId() 方法。
+ *
+ * @return 文件夹 ID。
+ */
+public long getFolderId() {
+    return mParentId;
+}
 
-    public int getType() {
-        return mType;
-    }
+/**
+ * 获取笔记的类型。
+ *
+ * @return 笔记类型，如普通笔记、文件夹等。
+ */
+public int getType() {
+    return mType;
+}
 
-    public int getWidgetType() {
-        return mWidgetType;
-    }
+/**
+ * 获取笔记的小部件类型。
+ *
+ * @return 小部件类型。
+ */
+public int getWidgetType() {
+    return mWidgetType;
+}
 
-    public int getWidgetId() {
-        return mWidgetId;
-    }
+/**
+ * 获取笔记的小部件 ID。
+ *
+ * @return 小部件 ID。
+ */
+public int getWidgetId() {
+    return mWidgetId;
+}
 
-    public String getSnippet() {
-        return mSnippet;
-    }
+/**
+ * 获取笔记的摘要信息。
+ *
+ * @return 笔记摘要。
+ */
+public String getSnippet() {
+    return mSnippet;
+}
 
-    public boolean hasAlert() {
-        return (mAlertDate > 0);
-    }
+/**
+ * 检查笔记是否设置了提醒。
+ *
+ * @return 如果设置了提醒则返回 true，否则返回 false。
+ */
+public boolean hasAlert() {
+    return (mAlertDate > 0);
+}
 
     public boolean isCallRecord() {
         return (mParentId == Notes.ID_CALL_RECORD_FOLDER && !TextUtils.isEmpty(mPhoneNumber));
diff --git a/app/src/main/res/values/styles.xml b/app/src/main/res/values/styles.xml
index d750e65..c1eddb2 100644
--- a/app/src/main/res/values/styles.xml
+++ b/app/src/main/res/values/styles.xml
@@ -63,7 +63,6 @@
     </style>
 
     <style name="NoteActionBarStyle" parent="@android:style/Widget.Holo.Light.ActionBar.Solid">
-        <item name="android:displayOptions" />
-        <item name="android:visibility">gone</item>
+        <item name="android:visibility">visible</item>
     </style>
 </resources>
\ No newline at end of file
diff --git a/readme.md b/readme.md
index 38c5587..b003322 100644
--- a/readme.md
+++ b/readme.md
@@ -1,2 +1,42 @@
-# Notes_master
+# 小米便签项目分析与维护
 
+## 📖 项目背景
+中国民航大学计算机科学与技术学院软件工程课程小组作业，针对小米便签（MiNotes）开源项目进行深度源码分析、架构研究和维护优化实践。项目成员：董雯喆、郭佳豪、万文广、王禹程、王飞（按首字母排列，排名不分先后）
+
+---
+
+## 🧩 核心架构分析
+### 分层架构模式
+1. **数据层（Model）**
+    - SQLite数据库管理笔记元数据
+    - ContentProvider实现数据共享
+    - FileSystemManager处理附件存储
+
+2. **业务逻辑层（Presenter）**
+    - NoteOperator核心业务处理器
+    - 异步任务管理（AsyncTask线程池）
+    - 数据变更通知机制（Observer模式）
+
+3. **表现层（View）**
+    - RecyclerView实现笔记列表
+    - RichEditor自定义富文本编辑器
+    - 多主题适配框架
+
+---
+
+## ⚙️启动方式
+
+1. 连接手机（打开USB调试）或启动虚拟机
+2. 在Android Studio或Intellij IDEA中打开项目
+3. 若成功识别到设备即可运行项目
+4. 同意在手机或虚拟机上安装APK，安装完成即可成功启动项目
+
+---
+
+## 🔧 维护与优化方案
+### 现存问题
+1. 富文本编辑器性能瓶颈
+2. 所用数据包过于老旧
+
+## 📄 许可证
+遵循原始项目Apache License 2.0协议，详见LICENSE文件
\ No newline at end of file