Merge branch 'zzw' of https://bdgit.educoder.net/pgytbhcw9/xiaominote_code_analysis into zzw

README.md

@@ -1,2 +1,17 @@
 # xiaominote_code_analysis
+<!-- static void _split_whole_name(const char *whole_name, char *fname, char *ext)
+{
+	const char *p_ext;
  
+	p_ext = rindex(whole_name, '.');
+	if (NULL != p_ext)
+	{
+		strcpy(ext, p_ext);
+		snprintf(fname, p_ext - whole_name + 1, "%s", whole_name);
+	}
+	else
+	{
+		ext[0] = '\0';
+		strcpy(f1name, 1whole_name);
+	}
+} -->

chat.txt

@@ -0,0 +1 @@
+testify

src/Notes-master/Notes-master/src/net/micode/notes/data/Contact.java

@@ -25,6 +25,15 @@ import android.util.Log;
 
 import java.util.HashMap;
 
+/**     
+  * 
+  * @ProjectName:    minode
+  * @Package:        net.micode.notes.data
+  * @ClassName:      Contact
+  * @Description:    该类实现建立联系人数据库的功能
+  * @Author:         张铸玮
+  * @Date:           2023-12-16 17:57
+ */
 public class Contact {
     private static HashMap<String, String> sContactCache;
     private static final String TAG = "Contact";
@@ -35,18 +44,29 @@ public class Contact {
             + "(SELECT raw_contact_id "
             + " FROM phone_lookup"
             + " WHERE min_match = '+')";
-
+     /**
+      * @method      getContact
+      * @description 该方法用于识别电话号码对应的联系人
+      * @date:       2023-12-16 19:24
+      * @author:     张铸玮
+      * @return      string
+      */
     public static String getContact(Context context, String phoneNumber) {
         if(sContactCache == null) {
             sContactCache = new HashMap<String, String>();
         }
 
+        // 查找HashMap中是否有phoneNumber的信息
+        // 2023-12-16 19:43
         if(sContactCache.containsKey(phoneNumber)) {
             return sContactCache.get(phoneNumber);
         }
 
         String selection = CALLER_ID_SELECTION.replace("+",
                 PhoneNumberUtils.toCallerIDMinMatch(phoneNumber));
+
+        // 查找数据库中phoneNumber的信息
+        // 2023-12-16 19:43
         Cursor cursor = context.getContentResolver().query(
                 Data.CONTENT_URI,
                 new String [] { Phone.DISPLAY_NAME },
@@ -54,6 +74,8 @@ public class Contact {
                 new String[] { phoneNumber },
                 null);
 
+        // 检查是否查询到联系人，找到则将相关信息加入HashMap中，未找到则处理异常
+        // 2023-12-16 19:41
         if (cursor != null && cursor.moveToFirst()) {
             try {
                 String name = cursor.getString(0);

src/Notes-master/Notes-master/src/net/micode/notes/data/Notes.java

@@ -33,7 +33,7 @@ public class Notes {
     public static final int ID_ROOT_FOLDER = 0;
     public static final int ID_TEMPARAY_FOLDER = -1;
     public static final int ID_CALL_RECORD_FOLDER = -2;
-    public static final int ID_TRASH_FOLER = -3;
+    public static final int ID_TRASH_FOLER = -3; // TODO: 2023/12/25 有trash文件夹 
 
     public static final String INTENT_EXTRA_ALERT_DATE = "net.micode.notes.alert_date";
     public static final String INTENT_EXTRA_BACKGROUND_ID = "net.micode.notes.background_color_id";
@@ -161,10 +161,16 @@ public class Notes {
         public static final String GTASK_ID = "gtask_id";
 
         /**
-         * The version code
-         * <P> Type : INTEGER (long) </P>
+         * the version code
+         * <p> type : integer (long) </p>
          */
         public static final String VERSION = "version";
+
+        /**
+         * set top state
+         * <p> type : integer (long) </p>
+         */
+        public static final String TOP = "top";
     }
 
     public interface DataColumns {

src/Notes-master/Notes-master/src/net/micode/notes/data/NotesDatabaseHelper.java

@@ -30,7 +30,7 @@ import net.micode.notes.data.Notes.NoteColumns;
 public class NotesDatabaseHelper extends SQLiteOpenHelper {
     private static final String DB_NAME = "note.db";
 
-    private static final int DB_VERSION = 4;
+    private static final int DB_VERSION = 5;
 
     public interface TABLE {
         public static final String NOTE = "note";
@@ -60,7 +60,8 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
             NoteColumns.LOCAL_MODIFIED + " INTEGER NOT NULL DEFAULT 0," +
             NoteColumns.ORIGIN_PARENT_ID + " INTEGER NOT NULL DEFAULT 0," +
             NoteColumns.GTASK_ID + " TEXT NOT NULL DEFAULT ''," +
-            NoteColumns.VERSION + " INTEGER NOT NULL DEFAULT 0" +
+            NoteColumns.VERSION + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.TOP + " INTEGER NOT NULL DEFAULT 0" +
         ")";
 
     private static final String CREATE_DATA_TABLE_SQL =
@@ -322,6 +323,11 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
             oldVersion++;
         }
 
+        if (oldVersion == 4) {
+            upgradeToV5(db);
+            oldVersion++;
+        }
+
         if (reCreateTriggers) {
             reCreateNoteTableTriggers(db);
             reCreateDataTableTriggers(db);
@@ -359,4 +365,9 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.VERSION
                 + " INTEGER NOT NULL DEFAULT 0");
     }
+
+    private void upgradeToV5(SQLiteDatabase db) {
+        db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.TOP
+                + " INTEGER NOT NULL DEFAULT 0");
+    }
 }

src/Notes-master/Notes-master/src/net/micode/notes/data/NotesProvider.java

@@ -48,6 +48,7 @@ public class NotesProvider extends ContentProvider {
     private static final int URI_DATA_ITEM       = 4;
 
     private static final int URI_SEARCH          = 5;
+
     private static final int URI_SEARCH_SUGGEST  = 6;
 
     static {

src/Notes-master/Notes-master/src/net/micode/notes/gtask/exception/NetworkFailureException.java

@@ -15,7 +15,6 @@
  */
 
 package net.micode.notes.gtask.exception;
-
 public class NetworkFailureException extends Exception {
     private static final long serialVersionUID = 2107610287180234136L;
 
@@ -26,7 +25,6 @@ public class NetworkFailureException extends Exception {
     public NetworkFailureException(String paramString) {
         super(paramString);
     }
-
     public NetworkFailureException(String paramString, Throwable paramThrowable) {
         super(paramString, paramThrowable);
     }

src/Notes-master/Notes-master/src/net/micode/notes/gtask/remote/GTaskManager.java

@@ -47,7 +47,15 @@ import java.util.HashSet;
 import java.util.Iterator;
 import java.util.Map;
 
-
+/**
+  *
+  * @ProjectName:    minode
+  * @Package:        net.micode.notes.gtask.remote
+  * @ClassName:      GTaskManager
+  * @Description:    该类实现了便签管理者类，提供同步便签内容和文件夹，添加、更新本地和远端节点等功能
+  * @Author:         张铸玮
+  * @Date:           2023-12-18 0:17
+ */
 public class GTaskManager {
     private static final String TAG = GTaskManager.class.getSimpleName();
 
@@ -247,6 +255,13 @@ public class GTaskManager {
         }
     }
 
+     /**
+      * @method      syncContent
+      * @description 该方法实现本地便签文本同步操作
+      * @date:       2023-12-18 0:01
+      * @author:     张铸玮
+      * @return      void
+      */
     private void syncContent() throws NetworkFailureException {
         int syncType;
         Cursor c = null;
@@ -351,6 +366,13 @@ public class GTaskManager {
 
     }
 
+     /**
+      * @method      syncFolder
+      * @description 该方法实现本地文件夹同步操作
+      * @date:       2023-12-18 0:04
+      * @author:     张铸玮
+      * @return      void
+      */
     private void syncFolder() throws NetworkFailureException {
         Cursor c = null;
         String gid;
@@ -476,6 +498,13 @@ public class GTaskManager {
             GTaskClient.getInstance().commitUpdate();
     }
 
+     /**
+      * @method      doContentSync
+      * @description 该方法通过接收到不同类型的syncType来进行对应便签内容同步操作
+      * @date:       2023-12-18 0:08
+      * @author:     张铸玮
+      * @return      void
+      */
     private void doContentSync(int syncType, Node node, Cursor c) throws NetworkFailureException {
         if (mCancelled) {
             return;

src/Notes-master/Notes-master/src/net/micode/notes/gtask/remote/GTaskSyncService.java

@@ -22,7 +22,15 @@ import android.content.Context;
 import android.content.Intent;
 import android.os.Bundle;
 import android.os.IBinder;
-
+/**
+  *
+  * @ProjectName:    minode
+  * @Package:        net.micode.notes.gtask.remote
+  * @ClassName:      GTaskSyncService
+  * @Description:    该类实现了Gtask同步服务的功能，提供开启同步服务、发送同步通知等功能
+  * @Author:         张铸玮
+  * @Date:           2023-12-17 23:38
+ */
 public class GTaskSyncService extends Service {
     public final static String ACTION_STRING_NAME = "sync_action_type";
 
@@ -42,6 +50,13 @@ public class GTaskSyncService extends Service {
 
     private static String mSyncProgress = "";
 
+     /**
+      * @method      startSync
+      * @description 该方法用于开启Gtask备忘录同步工作
+      * @date:       2023-12-17 23:42
+      * @author:     张铸玮
+      * @return      void
+      */
     private void startSync() {
         if (mSyncTask == null) {
             mSyncTask = new GTaskASyncTask(this, new GTaskASyncTask.OnCompleteListener() {
@@ -52,10 +67,19 @@ public class GTaskSyncService extends Service {
                 }
             });
             sendBroadcast("");
+            // 使同步任务以单线程队列方式开启运行
+            // 2023-12-17 23:46
             mSyncTask.execute();
         }
     }
 
+     /**
+      * @method      cancelSync
+      * @description 该方法用于取消Gtask备忘录同步工作
+      * @date:       2023-12-17 23:49
+      * @author:     张铸玮
+      * @return      void
+      */
     private void cancelSync() {
         if (mSyncTask != null) {
             mSyncTask.cancelSync();
@@ -67,11 +91,20 @@ public class GTaskSyncService extends Service {
         mSyncTask = null;
     }
 
+     /**
+      * @method      onStartCommand
+      * @description 该方法用于接受其他组件传递的消息使之重启GtaskSyncService
+      * @date:       2023-12-17 23:53
+      * @author:     张铸玮
+      * @return      int
+      */
     @Override
     public int onStartCommand(Intent intent, int flags, int startId) {
         Bundle bundle = intent.getExtras();
         if (bundle != null && bundle.containsKey(ACTION_STRING_NAME)) {
             switch (bundle.getInt(ACTION_STRING_NAME, ACTION_INVALID)) {
+                // 开始同步或取消同步
+                // 2023-12-17 23:52
                 case ACTION_START_SYNC:
                     startSync();
                     break;

src/Notes-master/Notes-master/src/net/micode/notes/model/Note.java

@@ -70,6 +70,10 @@ public class Note {
         mNoteData = new NoteData();
     }
 
+    public void setTopState(String key, int value) {
+        mNoteDiffValues.put(key, value);
+    }
+
     public void setNoteValue(String key, String value) {
         mNoteDiffValues.put(key, value);
         mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);

src/Notes-master/Notes-master/src/net/micode/notes/model/WorkingNote.java

@@ -52,6 +52,8 @@ public class WorkingNote {
 
     private int mWidgetType;
 
+    private int mTop;
+
     private long mFolderId;
 
     private Context mContext;
@@ -78,7 +80,8 @@ public class WorkingNote {
             NoteColumns.BG_COLOR_ID,
             NoteColumns.WIDGET_ID,
             NoteColumns.WIDGET_TYPE,
-            NoteColumns.MODIFIED_DATE
+            NoteColumns.MODIFIED_DATE,
+            NoteColumns.TOP
     };
 
     private static final int DATA_ID_COLUMN = 0;
@@ -101,6 +104,8 @@ public class WorkingNote {
 
     private static final int NOTE_MODIFIED_DATE_COLUMN = 5;
 
+    private static final int NOTE_TOP_STATE_COLUMN = 6;
+
     // New note construct
     private WorkingNote(Context context, long folderId) {
         mContext = context;
@@ -111,6 +116,7 @@ public class WorkingNote {
         mNoteId = 0;
         mIsDeleted = false;
         mMode = 0;
+        mTop = 0;
         mWidgetType = Notes.TYPE_WIDGET_INVALIDE;
     }
 
@@ -137,6 +143,7 @@ public class WorkingNote {
                 mWidgetType = cursor.getInt(NOTE_WIDGET_TYPE_COLUMN);
                 mAlertDate = cursor.getLong(NOTE_ALERTED_DATE_COLUMN);
                 mModifiedDate = cursor.getLong(NOTE_MODIFIED_DATE_COLUMN);
+                mTop = cursor.getInt(NOTE_TOP_STATE_COLUMN);
             }
             cursor.close();
         } else {
@@ -176,6 +183,14 @@ public class WorkingNote {
 
     public static WorkingNote createEmptyNote(Context context, long folderId, int widgetId,
             int widgetType, int defaultBgColorId) {
+         /**
+          * @method:  createEmptyNote
+          * @description: 创建一个空的工作便签，根据传入参数，设置好工作便签的背景色、挂件号、挂件类型
+          * @date: 2023/12/20 23:55
+          * @author: zhoukexing
+          * @param: [context, folderId, widgetId, widgetType, defaultBgColorId]
+          * @return: net.micode.notes.model.WorkingNote 返回一个WorkingNote实例
+          */
         WorkingNote note = new WorkingNote(context, folderId);
         note.setBgColorId(defaultBgColorId);
         note.setWidgetId(widgetId);
@@ -187,16 +202,24 @@ public class WorkingNote {
         return new WorkingNote(context, id, 0);
     }
 
-    public synchronized boolean saveNote() {
-        if (isWorthSaving()) {
-            if (!existInDatabase()) {
+    public synchronized boolean saveNote() {// TODO: 2023/12/19 要仔细溯源看看
+         /**
+          * @method:  saveNote
+          * @description: 保存工作便签，当保存成功时，返回true，保存失败（）
+          * @date: 2023/12/19 23:44
+          * @author: zhoukexing
+          * @param: []
+          * @return: boolean
+          */
+        if (isWorthSaving()) { // 判断是否有新内容-->是否值得注释 @zhoukexing 2023/12/19 23:45
+            if (!existInDatabase()) { // 判断是否在数据库里存在==是新便签还是已有便签 @zhoukexing 2023/12/19 23:45
                 if ((mNoteId = Note.getNewNoteId(mContext, mFolderId)) == 0) {
                     Log.e(TAG, "Create new note fail with id:" + mNoteId);
                     return false;
                 }
             }
 
-            mNote.syncNote(mContext, mNoteId);
+            mNote.syncNote(mContext, mNoteId); // 和远程同步 @zhoukexing 2023/12/19 23:46
 
             /**
              * Update widget content if there exist any widget of this note
@@ -208,7 +231,7 @@ public class WorkingNote {
             }
             return true;
         } else {
-            return false;
+            return false; // 没有需要保存的，就返回false @zhoukexing 2023/12/19 23:46
         }
     }
 
@@ -225,20 +248,56 @@ public class WorkingNote {
         }
     }
 
+    /**
+     * @method:  setOnSettingStatusChangedListener
+     * @description: 将工作目录里的NoteEditActivity项设置为NoteSettingChangedListener
+     * @date: 2023/12/21 0:10
+     * @author: zhoukexing
+     * @param: [l] NoteEditActivity
+     * @return: void
+     */
     public void setOnSettingStatusChangedListener(NoteSettingChangedListener l) {
+        //Q: 这里的l是怎么获取的。l是NoteEditActivity @zkx 2023/12/21
         mNoteSettingStatusListener = l;
     }
 
+    public void reverseTopState() {
+        mTop ^= 1;
+        mNote.setTopState(NoteColumns.TOP, mTop);
+    }
+
+    public int getmTop(){
+        return mTop;
+    }
+
+    /**
+     * @Method      setAlertDate
+     * @Date        2023/12/13 11:43
+     * @param       date 提醒日期
+     * @param       set 动作（关闭或开启）
+     * @Author      lenovo
+     * @Return      void
+     * @Description 设置一个提醒时间
+     */
     public void setAlertDate(long date, boolean set) {
+        // 更新便签项中的提醒日期
         if (date != mAlertDate) {
             mAlertDate = date;
             mNote.setNoteValue(NoteColumns.ALERTED_DATE, String.valueOf(mAlertDate));
         }
+        // 设置提醒的监听事件
         if (mNoteSettingStatusListener != null) {
             mNoteSettingStatusListener.onClockAlertChanged(date, set);
         }
     }
-
+    /**
+     * @method:  markDeleted
+     * @description: 描述一下方法的作用
+     * @date: 2023/12/21 0:50
+     * @author: zhoukexing
+     * @param: [mark]
+     * @return: void
+     */
     public void markDeleted(boolean mark) {
         mIsDeleted = mark;
         if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID

src/Notes-master/Notes-master/src/net/micode/notes/tool/DataUtils.java

@@ -80,8 +80,15 @@ public class DataUtils {
         resolver.update(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id), values, null, null);
     }
 
-    public static boolean batchMoveToFolder(ContentResolver resolver, HashSet<Long> ids,
-            long folderId) {
+    /**
+     * @method:  batchMoveToFolder
+     * @description: 将ids里标注的文件移至folderId指定的文件夹
+     * @date: 2024/12/26 3:32
+     * @author: zhoukexing
+     * @param: [resolver, ids, folderId]
+     * @return: boolean
+     */
+    public static boolean batchMoveToFolder(ContentResolver resolver, HashSet<Long> ids, long folderId) {
         if (ids == null) {
             Log.d(TAG, "the ids is null");
             return true;
@@ -135,8 +142,22 @@ public class DataUtils {
         }
         return count;
     }
-
+    /**
+     * @Method      visibleInNoteDatabase
+     * @Date        2024/12/13 9:08
+     * @param resolver
+     * @param noteId
+     * @param type
+     * @Author      lenovo
+     * @Return      boolean
+     * @Description 访问数据库中是否有 noteId 对应的便签
+     */
     public static boolean visibleInNoteDatabase(ContentResolver resolver, long noteId, int type) {
+        /**
+          * withAppendedId 将 URI 和 ID 连接成一个新的URI
+          * query 返回 Uri 中符合 selection 的表格
+          * lenovo 2024/12/13 9:06
+        */
         Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId),
                 null,
                 NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER,
@@ -292,4 +313,13 @@ public class DataUtils {
         }
         return snippet;
     }
+
+    public static Cursor searchInNoteDatabase(ContentResolver resolver, String query) {
+        Cursor cursor = resolver.query(Notes.CONTENT_DATA_URI,
+                new String[]{NoteColumns.ID},
+                Notes.DataColumns.CONTENT + " LIKE'%" + query +"%'",
+                null,
+                null);
+        return cursor;
+    }
 }

src/Notes-master/Notes-master/src/net/micode/notes/tool/ResourceParser.java

@@ -37,6 +37,7 @@ public class ResourceParser {
     public static final int TEXT_LARGE       = 2;
     public static final int TEXT_SUPER       = 3;
 
+
     public static final int BG_DEFAULT_FONT_SIZE = TEXT_MEDIUM;
 
     public static class NoteBgResources {

src/Notes-master/Notes-master/src/net/micode/notes/ui/AlarmAlertActivity.java

@@ -39,21 +39,38 @@ import net.micode.notes.tool.DataUtils;
  
  import java.io.IOException;
  
-
+ /**
+  * 闹钟提醒活动类，用于在指定时间弹出提醒对话框并播放闹钟提示音
+  */
  public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener {
-    private long mNoteId;
-    private String mSnippet;
-    private static final int SNIPPET_PREW_MAX_LEN = 60;
-    MediaPlayer mPlayer;
+     private long mNoteId; // 便签的ID
+     private String mSnippet; // 便签的摘要信息
+     private static final int SNIPPET_PREW_MAX_LEN = 60; // 便签摘要信息的最大长度
+     MediaPlayer mPlayer; // 用于播放闹钟提示音的MediaPlayer对象
  
      @Override
+     /**
+      * @Method      onCreate
+      * @Date        2024/12/25 8:15
+      * @param savedInstanceState
+      * @Author      lenovo
+      * @Return      void
+      * @Description 创建闹钟提醒活动时的初始化操作
+      */
      protected void onCreate(Bundle savedInstanceState) {
+         /**
+           * Bundel 类似于 map，key-value存储
+           * super 代表父类, 调用 onCreate 用于恢复上次结束的状态
+           * lenovo 2024/12/25 8:39
+         */
          super.onCreate(savedInstanceState);
-        requestWindowFeature(Window.FEATURE_NO_TITLE);
+         requestWindowFeature(Window.FEATURE_NO_TITLE); // 请求无标题栏窗口
  
          final Window win = getWindow();
+         // 在屏幕锁定时显示
          win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED);
  
+         // 锁屏时到闹钟提示时间后，点亮屏幕
          if (!isScreenOn()) {
              win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON
                      | WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON
@@ -61,78 +78,98 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
                      | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR);
          }
  
-        Intent intent = getIntent();
+         Intent intent = getIntent(); // 获取启动该活动的Intent对象
  
          try {
+             // 从Intent中获取便签的ID
              mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));
+             // 根据便签ID获取便签的摘要信息
              mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId);
+             // 如果摘要信息长度超过最大长度，则截取并添加省略号
              mSnippet = mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet.substring(0,
                      SNIPPET_PREW_MAX_LEN) + getResources().getString(R.string.notelist_string_info)
                      : mSnippet;
          } catch (IllegalArgumentException e) {
-            e.printStackTrace();
-            return;
+             e.printStackTrace(); // 打印异常信息
+             return; // 如果获取便签ID或摘要信息失败，则直接返回
          }
  
-        mPlayer = new MediaPlayer();
+         mPlayer = new MediaPlayer(); // 创建MediaPlayer对象
+         // 查找数据库中有没有 mNoteId 的便签, 如果有则激发对话框 + 闹钟提示音
          if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
-            showActionDialog();
-            playAlarmSound();
+             showActionDialog(); // 显示提醒对话框
+             playAlarmSound(); // 播放闹钟提示音
          } else {
-            finish();
+             finish(); // 如果数据库中没有该便签，则结束该活动
          }
      }
  
+     /**
+      * 检测屏幕是否处于点亮状态
+      * @return 屏幕是否处于点亮状态
+      */
      private boolean isScreenOn() {
-        PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
-        return pm.isScreenOn();
+         PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE); // 获取电源管理服务
+         return pm.isScreenOn(); // 返回屏幕是否处于点亮状态
      }
  
+     /**
+      * 播放闹钟提示音
+      */
      private void playAlarmSound() {
-        Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);
+         Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM); // 获取默认闹钟提示音的URI
  
          int silentModeStreams = Settings.System.getInt(getContentResolver(),
-                Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0);
+                 Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0); // 获取静音模式影响的音频流类型
  
          if ((silentModeStreams & (1 << AudioManager.STREAM_ALARM)) != 0) {
-            mPlayer.setAudioStreamType(silentModeStreams);
+             mPlayer.setAudioStreamType(silentModeStreams); // 设置MediaPlayer的音频流类型为静音模式影响的音频流类型
          } else {
-            mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM);
+             mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM); // 设置MediaPlayer的音频流类型为闹钟音频流类型
          }
          try {
-            mPlayer.setDataSource(this, url);
-            mPlayer.prepare();
-            mPlayer.setLooping(true);
-            mPlayer.start();
+             mPlayer.setDataSource(this, url); // 设置MediaPlayer的数据源为默认闹钟提示音的URI
+             mPlayer.prepare(); // 准备MediaPlayer
+             mPlayer.setLooping(true); // 设置MediaPlayer为循环播放
+             mPlayer.start(); // 开始播放MediaPlayer
          } catch (IllegalArgumentException e) {
              // TODO Auto-generated catch block
-            e.printStackTrace();
+             e.printStackTrace(); // 打印异常信息
          } catch (SecurityException e) {
              // TODO Auto-generated catch block
-            e.printStackTrace();
+             e.printStackTrace(); // 打印异常信息
          } catch (IllegalStateException e) {
              // TODO Auto-generated catch block
-            e.printStackTrace();
+             e.printStackTrace(); // 打印异常信息
          } catch (IOException e) {
              // TODO Auto-generated catch block
-            e.printStackTrace();
+             e.printStackTrace(); // 打印异常信息
          }
      }
  
+     /**
+      * 显示提醒对话框
+      */
      private void showActionDialog() {
-        AlertDialog.Builder dialog = new AlertDialog.Builder(this);
-        dialog.setTitle(R.string.app_name);
-        dialog.setMessage(mSnippet);
-        dialog.setPositiveButton(R.string.notealert_ok, this);
+         AlertDialog.Builder dialog = new AlertDialog.Builder(this); // 创建AlertDialog构建器
+         dialog.setTitle(R.string.app_name); // 设置对话框标题为应用名称
+         dialog.setMessage(mSnippet); // 设置对话框消息为便签的摘要信息
+         dialog.setPositiveButton(R.string.notealert_ok, this); // 设置对话框的确定按钮，并指定点击事件监听器为当前对象
          if (isScreenOn()) {
-            dialog.setNegativeButton(R.string.notealert_enter, this);
+             dialog.setNegativeButton(R.string.notealert_enter, this); // 如果屏幕处于点亮状态，则设置对话框的取消按钮，并指定点击事件监听器为当前对象
          }
-        dialog.show().setOnDismissListener(this);
+         dialog.show().setOnDismissListener(this); // 显示对话框，并设置对话框消失事件监听器为当前对象
      }
  
+     /**
+      * 对话框按钮点击事件处理方法
+      * @param dialog 被点击的对话框
+      * @param which 被点击的按钮编号
+      */
      public void onClick(DialogInterface dialog, int which) {
          switch (which) {
              case DialogInterface.BUTTON_NEGATIVE:
+                 // 如果点击了取消按钮，则启动便签编辑活动，并传入便签的ID
                  Intent intent = new Intent(this, NoteEditActivity.class);
                  intent.setAction(Intent.ACTION_VIEW);
                  intent.putExtra(Intent.EXTRA_UID, mNoteId);
@@ -143,16 +180,23 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
          }
      }
  
+     /**
+      * 对话框消失事件处理方法
+      * @param dialog 消失的对话框
+      */
      public void onDismiss(DialogInterface dialog) {
-        stopAlarmSound();
-        finish();
+         stopAlarmSound(); // 停止播放闹钟提示音
+         finish(); // 结束该活动
      }
  
+     /**
+      * 停止播放闹钟提示音
+      */
      private void stopAlarmSound() {
          if (mPlayer != null) {
-            mPlayer.stop();
-            mPlayer.release();
-            mPlayer = null;
+             mPlayer.stop(); // 停止MediaPlayer
+             mPlayer.release(); // 释放MediaPlayer资源
+             mPlayer = null; // 将MediaPlayer对象置为null
          }
      }
  }

src/Notes-master/Notes-master/src/net/micode/notes/ui/NoteEditActivity.java

@@ -35,6 +35,8 @@ import android.text.SpannableString;
 import android.text.TextUtils;
 import android.text.format.DateUtils;
 import android.text.style.BackgroundColorSpan;
+import android.text.Editable;
+import android.text.TextWatcher;
 import android.util.Log;
 import android.view.LayoutInflater;
 import android.view.Menu;
@@ -51,6 +53,10 @@ import android.widget.ImageView;
 import android.widget.LinearLayout;
 import android.widget.TextView;
 import android.widget.Toast;
+import android.os.Environment;
+import android.graphics.Bitmap;
+import android.graphics.Typeface; // 自带四种字体
+
 
 import net.micode.notes.R;
 import net.micode.notes.data.Notes;
@@ -65,15 +71,27 @@ import net.micode.notes.ui.NoteEditText.OnTextViewChangeListener;
 import net.micode.notes.widget.NoteWidgetProvider_2x;
 import net.micode.notes.widget.NoteWidgetProvider_4x;
 
+import java.util.ArrayList;
 import java.util.HashMap;
 import java.util.HashSet;
+import java.util.LinkedList;
 import java.util.Map;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
+import java.util.Vector;
+import java.io.File;
+import java.io.FileOutputStream;
+
 
 
-public class NoteEditActivity extends Activity implements OnClickListener,
-        NoteSettingChangedListener, OnTextViewChangeListener {
+
+public class NoteEditActivity extends Activity //NOTE: extends--单继承，但可多重继承 @zhoukexing 2023/12/17 23:29
+        implements OnClickListener, NoteSettingChangedListener, OnTextViewChangeListener {
+    private Intent intent; //NOTE: implements--实现接口 @zhoukexing 2023/12/17 23:24
+    /** NOTE:
+     *
+     * @zhoukexing 2023/12/17 23:39
+     */
     private class HeadViewHolder {
         public TextView tvModified;
 
@@ -81,6 +99,12 @@ public class NoteEditActivity extends Activity implements OnClickListener,
 
         public TextView tvAlertDate;
 
+        // 顶部置顶文本
+        public TextView tvTopText;
+
+        // 顶部长度统计文本
+        public TextView tvTextNum;
+
         public ImageView ibSetBgColor;
     }
 
@@ -118,8 +142,13 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         sFontSelectorSelectionMap.put(ResourceParser.TEXT_SUPER, R.id.iv_super_select);
     }
 
+
+
+
     private static final String TAG = "NoteEditActivity";
 
+    private static int mMaxRevokeTimes = 10;
+
     private HeadViewHolder mNoteHeaderHolder;
 
     private View mHeadViewPanel;
@@ -136,8 +165,10 @@ public class NoteEditActivity extends Activity implements OnClickListener,
 
     private SharedPreferences mSharedPrefs;
     private int mFontSizeId;
+    private int mFontStyleId;
 
     private static final String PREFERENCE_FONT_SIZE = "pref_font_size";
+    private static final String PREFERENCE_FONT_STYLE = "pref_font_style";
 
     private static final int SHORTCUT_ICON_TITLE_MAX_LEN = 10;
 
@@ -149,15 +180,36 @@ public class NoteEditActivity extends Activity implements OnClickListener,
     private String mUserQuery;
     private Pattern mPattern;
 
+    // 存储改变的数据
+    private Vector<SpannableString> mHistory = new Vector<SpannableString>(mMaxRevokeTimes);
+    private boolean mIsRvoke;
+
+    /*--- 以上是此类中的数据区，以下是方法区 ---*/
+
+    /**
+    * @zkx 2023/12/18 复写了Activity类中的onCreate函数，当用户点击创建时，会进入这个函数
+    */
+    /**
+     * @method:  onCreate
+     * @description: 进入场景：在list页面，点击“写便签”时进入；在挂件页面，生成挂件时不进入，点进挂件时才进入；……
+     * allinall：在进入编辑页面前都会进入
+     * 创建一个编辑活动
+     * @date: 2023/12/18 23:22
+     * @author: zhoukexing
+     * @param: [savedInstanceState]
+     * @return: void
+     */
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         this.setContentView(R.layout.note_edit);
 
         if (savedInstanceState == null && !initActivityState(getIntent())) {
+            // 表示之前保存的状态，用于还原数据 @lzk 2024/1/3 23:33
             finish();
             return;
         }
+        // 初始化资源。我要的设置字体就在这儿
         initResources();
     }
 
@@ -180,18 +232,26 @@ public class NoteEditActivity extends Activity implements OnClickListener,
     }
 
     private boolean initActivityState(Intent intent) {
+         /**
+          * @method:  initActivityState
+          * @description: 根据intent（Key-Value）内容，初始化一个便签活动
+          * @date: 2023/12/18 23:31
+          * @author: zhoukexing
+          * @param: [intent]
+          * @return: boolean 为真则初始化成功，为假则失败。失败原因：不存在、（call）load失败、intent内容错误
+          */
         /**
          * If the user specified the {@link Intent#ACTION_VIEW} but not provided with id,
          * then jump to the NotesListActivity
          */
         mWorkingNote = null;
         if (TextUtils.equals(Intent.ACTION_VIEW, intent.getAction())) {
+            // 进入场景：点进一个已有便签 @zhoukexing 2023/12/21 0:14
             long noteId = intent.getLongExtra(Intent.EXTRA_UID, 0);
-            mUserQuery = "";
-
             /**
              * Starting from the searched result
              */
+            // 高亮搜索内容 @lzk 2024/1/3 10:10
             if (intent.hasExtra(SearchManager.EXTRA_DATA_KEY)) {
                 noteId = Long.parseLong(intent.getStringExtra(SearchManager.EXTRA_DATA_KEY));
                 mUserQuery = intent.getStringExtra(SearchManager.USER_QUERY);
@@ -203,7 +263,8 @@ public class NoteEditActivity extends Activity implements OnClickListener,
                 showToast(R.string.error_note_not_exist);
                 finish();
                 return false;
-            } else {
+            }
+            else {// 如果在数据库里存在，就根据noteId从数据库中加载到工作便签里来 @zhoukexing 2023/12/21 0:16
                 mWorkingNote = WorkingNote.load(this, noteId);
                 if (mWorkingNote == null) {
                     Log.e(TAG, "load note failed with note id" + noteId);
@@ -211,20 +272,22 @@ public class NoteEditActivity extends Activity implements OnClickListener,
                     return false;
                 }
             }
-            getWindow().setSoftInputMode(
+            getWindow().setSoftInputMode(// 猜：平滑地展示便签内容 @zhoukexing 2023/12/21 0:18
                     WindowManager.LayoutParams.SOFT_INPUT_STATE_HIDDEN
                             | WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE);
-        } else if(TextUtils.equals(Intent.ACTION_INSERT_OR_EDIT, intent.getAction())) {
-            // New note
+        }
+        else if(TextUtils.equals(Intent.ACTION_INSERT_OR_EDIT, intent.getAction())) {
+            // 进入场景：一个New note
             long folderId = intent.getLongExtra(Notes.INTENT_EXTRA_FOLDER_ID, 0);
             int widgetId = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_ID,
                     AppWidgetManager.INVALID_APPWIDGET_ID);
             int widgetType = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_TYPE,
-                    Notes.TYPE_WIDGET_INVALIDE);
+                    Notes.TYPE_WIDGET_INVALIDE); // widgetType=0: 新建的挂件，空的 @zhoukexing 2023/12/21 0:02
             int bgResId = intent.getIntExtra(Notes.INTENT_EXTRA_BACKGROUND_ID,
-                    ResourceParser.getDefaultBgId(this));
+                    ResourceParser.getDefaultBgId(this));// TODO: 2023/12/21 背景色的设置
 
-            // Parse call-record note
+            // Parse call-record note todo
+            // 解析文档，看是否有号码存在，以便展示的时候渲染 @zhoukexing 2023/12/20 23:49
             String phoneNumber = intent.getStringExtra(Intent.EXTRA_PHONE_NUMBER);
             long callDate = intent.getLongExtra(Notes.INTENT_EXTRA_CALL_DATE, 0);
             if (callDate != 0 && phoneNumber != null) {
@@ -234,6 +297,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
                 long noteId = 0;
                 if ((noteId = DataUtils.getNoteIdByPhoneNumberAndCallDate(getContentResolver(),
                         phoneNumber, callDate)) > 0) {
+                    // TODO: 2023/12/20
                     mWorkingNote = WorkingNote.load(this, noteId);
                     if (mWorkingNote == null) {
                         Log.e(TAG, "load call note failed with note id" + noteId);
@@ -245,7 +309,8 @@ public class NoteEditActivity extends Activity implements OnClickListener,
                             widgetType, bgResId);
                     mWorkingNote.convertToCallNote(phoneNumber, callDate);
                 }
-            } else {
+            }
+            else { // 没有要显示的电话
                 mWorkingNote = WorkingNote.createEmptyNote(this, folderId, widgetId, widgetType,
                         bgResId);
             }
@@ -253,12 +318,14 @@ public class NoteEditActivity extends Activity implements OnClickListener,
             getWindow().setSoftInputMode(
                     WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE
                             | WindowManager.LayoutParams.SOFT_INPUT_STATE_VISIBLE);
-        } else {
+        }
+        else {
             Log.e(TAG, "Intent not specified action, should not support");
             finish();
             return false;
         }
         mWorkingNote.setOnSettingStatusChangedListener(this);
+        // this是WorkingNote @zhoukexing 2023/12/21 0:08
         return true;
     }
 
@@ -268,9 +335,20 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         initNoteScreen();
     }
 
+    private void showTopHeader(){
+        if(mWorkingNote.getmTop() == 1){
+            mNoteHeaderHolder.tvTopText.setText("已置顶");
+            mNoteHeaderHolder.tvTopText.setVisibility(View.VISIBLE);
+        }
+        else{
+            mNoteHeaderHolder.tvTopText.setVisibility(View.GONE);
+        }
+    }
+
     private void initNoteScreen() {
         mNoteEditor.setTextAppearance(this, TextAppearanceResources
                 .getTexAppearanceResource(mFontSizeId));
+        initFontStyle(mNoteEditor, mFontStyleId);
         if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {
             switchToListMode(mWorkingNote.getContent());
         } else {
@@ -293,17 +371,57 @@ public class NoteEditActivity extends Activity implements OnClickListener,
          * is not ready
          */
         showAlertHeader();
+        showTopHeader();
+    }
+
+    private void initFontStyle(EditText edit, int i) {
+        if (i == 0) {
+            edit.setTypeface(Typeface.DEFAULT);
+        } else if (i == 1) {
+            edit.setTypeface(Typeface.DEFAULT_BOLD);
+        } else if (i == 2) {
+            edit.setTypeface(Typeface.defaultFromStyle(Typeface.ITALIC));
+        } else if (i == 3) {
+            edit.setTypeface(Typeface.SERIF);
+        } else if (i == 4) {
+            Typeface tf = Typeface.createFromAsset(getAssets(),"fonts/FZSTK.ttf");
+            edit.setTypeface(tf);
+        } else if (i == 5) {
+            Typeface tf = Typeface.createFromAsset(getAssets(),"fonts/STXINGKA.ttf");
+            edit.setTypeface(tf);
+        } else if (i == 6) {
+            Typeface tf = Typeface.createFromAsset(getAssets(),"fonts/VINERITC.ttf");
+            edit.setTypeface(tf);
+        }
     }
 
+
+    /**
+     * @Method      showAlertHeader
+     * @Date        2023/12/13 11:32
+     * @Author      lenovo
+     * @Return      void
+     * @Description 在便签页面的上方栏显示提醒信息
+     */
     private void showAlertHeader() {
         if (mWorkingNote.hasClockAlert()) {
             long time = System.currentTimeMillis();
             if (time > mWorkingNote.getAlertDate()) {
+                // 闹钟时间大于当前时间, 显示 "Expired"， 闹钟失效
                 mNoteHeaderHolder.tvAlertDate.setText(R.string.note_alert_expired);
             } else {
+                // 显示正常闹钟信息
                 mNoteHeaderHolder.tvAlertDate.setText(DateUtils.getRelativeTimeSpanString(
                         mWorkingNote.getAlertDate(), time, DateUtils.MINUTE_IN_MILLIS));
             }
+            /**
+             * setVisibility()
+             * 用于设置空间的可见性
+             * VISIBLE 可见
+             * INVISIBLE 不可见，但是占用一个位置
+             * GNONE 不可见且不占用位置
+             * lenovo 2023/12/13 11:28
+            */
             mNoteHeaderHolder.tvAlertDate.setVisibility(View.VISIBLE);
             mNoteHeaderHolder.ivAlertIcon.setVisibility(View.VISIBLE);
         } else {
@@ -315,7 +433,15 @@ public class NoteEditActivity extends Activity implements OnClickListener,
     @Override
     protected void onNewIntent(Intent intent) {
         super.onNewIntent(intent);
-        initActivityState(intent);
+        // 若为搜索事件则设置高亮
+        if (Intent.ACTION_SEARCH.equals(intent.getAction())) {
+            mUserQuery = intent.getStringExtra(SearchManager.QUERY);
+            mNoteEditor.setText(getHighlightQueryResult(mWorkingNote.getContent(), mUserQuery));
+            mNoteEditor.setSelection(mNoteEditor.getText().length());
+        }
+        else if(!initActivityState(intent)) {
+            Log.e(TAG, "Intent Type Error");
+        };
     }
 
     @Override
@@ -363,15 +489,61 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         return true;
     }
 
+    /**
+     * @Method      textFilter
+     * @Date        2024/1/18 9:45
+     * @param 		 oriText
+     * @Author      lenovo
+     * @Return      java.lang.String
+     * @Description 过滤掉空格换行等不可见字符
+     */
+    private String textFilter(String oriText){
+        String newText = oriText;
+        newText = newText.replaceAll("\\s", "");
+        return newText;
+    }
+
+    /**
+     * @method:  initResources
+     * @description: 初始化资源。被onCreate唯一调用
+     * @date: 2023/12/18 23:36
+     * @author: zhoukexing
+     * @param: []
+     * @return: void
+     */
     private void initResources() {
         mHeadViewPanel = findViewById(R.id.note_title);
         mNoteHeaderHolder = new HeadViewHolder();
         mNoteHeaderHolder.tvModified = (TextView) findViewById(R.id.tv_modified_date);
         mNoteHeaderHolder.ivAlertIcon = (ImageView) findViewById(R.id.iv_alert_icon);
         mNoteHeaderHolder.tvAlertDate = (TextView) findViewById(R.id.tv_alert_date);
+        mNoteHeaderHolder.tvTopText = (TextView) findViewById(R.id.tv_top_text);
+        mNoteHeaderHolder.tvTextNum = (TextView) findViewById(R.id.tv_text_num);
         mNoteHeaderHolder.ibSetBgColor = (ImageView) findViewById(R.id.btn_set_bg_color);
         mNoteHeaderHolder.ibSetBgColor.setOnClickListener(this);
         mNoteEditor = (EditText) findViewById(R.id.note_edit_view);
+        mNoteEditor.addTextChangedListener(new TextWatcher() {
+            int currentLength = 0;
+            @Override
+            public void beforeTextChanged(CharSequence s, int start, int count, int after)
+            {
+                mNoteHeaderHolder.tvTextNum.setVisibility(View.VISIBLE);
+                mNoteHeaderHolder.tvTextNum.setText("长度" + String.valueOf(currentLength));
+            }
+            @Override
+            public void onTextChanged(CharSequence s, int start, int before, int count) {
+                currentLength = textFilter(mNoteEditor.getText().toString()).length();
+            }
+            @Override
+            public void afterTextChanged(Editable s) {//储存文本更改的编辑
+                if(!mIsRvoke) {
+                    saveHistory();
+                }else {
+                    mIsRvoke = false;
+                }
+                mNoteHeaderHolder.tvTextNum.setText("长度" + String.valueOf(currentLength));
+            }
+        });
         mNoteEditorPanel = findViewById(R.id.sv_note_edit);
         mNoteBgColorSelector = findViewById(R.id.note_bg_color_selector);
         for (int id : sBgSelectorBtnsMap.keySet()) {
@@ -394,6 +566,10 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         if(mFontSizeId >= TextAppearanceResources.getResourcesSize()) {
             mFontSizeId = ResourceParser.BG_DEFAULT_FONT_SIZE;
         }
+        mFontStyleId = mSharedPrefs.getInt(PREFERENCE_FONT_STYLE, 0); // defult style id--0,即对应“默认”字体 @zkx
+        if(mFontStyleId >= 7) {
+            mFontStyleId = 0;
+        }
         mEditTextList = (LinearLayout) findViewById(R.id.note_edit_list);
     }
 
@@ -406,6 +582,13 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         clearSettingState();
     }
 
+    /**
+     * @method      updateWidget
+     * @description 该方法用于实现与桌面小工具同步的功能
+     * @date:       2023-12-18 21:37
+     * @author:     郑鲲鹏
+     * @return      void
+     */
     private void updateWidget() {
         Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE);
         if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_2X) {
@@ -430,7 +613,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);
@@ -442,13 +625,15 @@ public class NoteEditActivity extends Activity implements OnClickListener,
             mSharedPrefs.edit().putInt(PREFERENCE_FONT_SIZE, mFontSizeId).commit();
             findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.VISIBLE);
             if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {
-                getWorkingText();
+                getWorkingText(); // DONE：切换到清单模式后，字体保留
                 switchToListMode(mWorkingNote.getContent());
             } else {
                 mNoteEditor.setTextAppearance(this,
                         TextAppearanceResources.getTexAppearanceResource(mFontSizeId));
+                initFontStyle(mNoteEditor, mFontStyleId); // 因为上面的操作会覆盖掉style的显示，所以在这里重新设置一下 @zkx
             }
             mFontSizeSelector.setVisibility(View.GONE);
+
         }
     }
 
@@ -502,59 +687,122 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         } else {
             menu.findItem(R.id.menu_delete_remind).setVisible(false);
         }
+        if(mWorkingNote.getmTop() == 1){
+            menu.findItem(R.id.menu_top).setTitle(R.string.cancel_top);
+        }
+        else{
+            menu.findItem(R.id.menu_top).setTitle(R.string.menu_top);
+        }
         return true;
     }
 
     @Override
     public boolean onOptionsItemSelected(MenuItem item) {
-        switch (item.getItemId()) {
-            case R.id.menu_new_note:
+         /**
+          * @method:  onOptionsItemSelected
+          * @description: 覆写了Activity.java里的onOptionsItemSelected，路线是menu-->item，
+          * 这里就是处理识别到的item
+          * @date: 2023/12/19 23:35
+          * @author: zhoukexing
+          * @param: [item]
+          * @return: boolean
+          */
+        int itemId = item.getItemId();
+        if (itemId == R.id.menu_new_note) { // 从item到itemid，用itemid导向对应的不同的动作 @zhoukexing 2023/12/19 23:38
             createNewNote();
-                break;
-            case R.id.menu_delete:
+        } else if (itemId == R.id.menu_delete) {
+            // 构建一个警告⚠对话框，让用户确认是否真的要删除便签 @zhoukexing 2023/12/21 0:41
             AlertDialog.Builder builder = new AlertDialog.Builder(this);
             builder.setTitle(getString(R.string.alert_title_delete));
             builder.setIcon(android.R.drawable.ic_dialog_alert);
             builder.setMessage(getString(R.string.alert_message_delete_note));
             builder.setPositiveButton(android.R.string.ok,
-                        new DialogInterface.OnClickListener() {
+                    new DialogInterface.OnClickListener() {// TODO: 2023/12/21 传入了一个函数作为参数？
                         public void onClick(DialogInterface dialog, int which) {
-                                deleteCurrentNote();
+                            deleteCurrentNote(); //TODO: 修改这里达成“在便签内点删除进回收站”
                             finish();
                         }
                     });
             builder.setNegativeButton(android.R.string.cancel, null);
             builder.show();
-                break;
-            case R.id.menu_font_size:
+        } else if (itemId == R.id.menu_font_size) {
             mFontSizeSelector.setVisibility(View.VISIBLE);
             findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.VISIBLE);
-                break;
-            case R.id.menu_list_mode:
+        } else if (itemId == R.id.menu_list_mode) {
             mWorkingNote.setCheckListMode(mWorkingNote.getCheckListMode() == 0 ?
                     TextNote.MODE_CHECK_LIST : 0);
-                break;
-            case R.id.menu_share:
+        } else if (itemId == R.id.menu_share) {
             getWorkingText();
             sendTo(this, mWorkingNote.getContent());
-                break;
-            case R.id.menu_send_to_desktop:
+        } else if (itemId == R.id.menu_send_to_desktop) {
             sendToDesktop();
-                break;
-            case R.id.menu_alert:
+        } else if (itemId == R.id.menu_alert) {
             setReminder();
-                break;
-            case R.id.menu_delete_remind:
+        } else if (itemId == R.id.menu_delete_remind) {
             mWorkingNote.setAlertDate(0, false);
-                break;
-            default:
-                break;
+        } else if (itemId == R.id.menu_search) {
+            onSearchRequested();
+        } else if (itemId == R.id.menu_top) {
+            mWorkingNote.reverseTopState();
+            showTopHeader();
+		} else if (itemId == R.id.menu_revoke) {
+            doRevoke();
+		} else if (itemId == R.id.menu_screenshot) {
+            doScreenshot();
+        } else if (itemId == R.id.menu_font_select) {
+            setFontStyle();
         }
         return true;
     }
 
+    public boolean onSearchRequested() {
+        startSearch(null, false, null /* appData */, false);
+        return true;
+    }
+
+    private void setFontStyle() {
+        final String[] items = {"普通", "加粗", "斜体", "等宽", "方正舒体", "行楷", "VINERITC-en"};
+        AlertDialog.Builder dialog = new AlertDialog.Builder(this);
+        dialog.setTitle("设置字体");
+        dialog.setCancelable(true);
+        dialog.setSingleChoiceItems(items, 0, new DialogInterface.OnClickListener() {
+            @Override
+            public void onClick(DialogInterface dialog, int i) {
+                mFontStyleId = i;
+            }
+        });
+
+        dialog.setPositiveButton("确定", new DialogInterface.OnClickListener() {
+            @Override
+            public void onClick(DialogInterface dialog, int i) {
+                mSharedPrefs.edit().putInt(PREFERENCE_FONT_STYLE, mFontStyleId).commit();
+                if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {
+                    getWorkingText(); // DONE：切换到清单模式后，字体保留
+                    switchToListMode(mWorkingNote.getContent());
+                } else {
+                    initFontStyle(mNoteEditor, mFontStyleId);
+                }
+            }
+        });
+
+        dialog.setNegativeButton("取消", new DialogInterface.OnClickListener() {
+            @Override
+            public void onClick(DialogInterface dialog, int i) {
+            }
+        });
+        dialog.show();
+    }
+
+    /**
+     * @Method      setReminder
+     * @Date        2023/12/13 12:52
+     * @Author      lenovo
+     * @Return      void
+     * @Description 显示时间选择器，默认时间为当前时间
+     */
     private void setReminder() {
         DateTimePickerDialog d = new DateTimePickerDialog(this, System.currentTimeMillis());
+        // 设置时间选择器的监听事件，当选中 date 之后调用 setAlertDate 设置提醒时间
         d.setOnDateTimeSetListener(new OnDateTimeSetListener() {
             public void OnDateTimeSet(AlertDialog dialog, long date) {
                 mWorkingNote.setAlertDate(date	, true);
@@ -567,25 +815,53 @@ public class NoteEditActivity extends Activity implements OnClickListener,
      * Share note to apps that support {@link Intent#ACTION_SEND} action
      * and {@text/plain} type
      */
+     /**
+      * @method      sendTo
+      * @description 该方法用于共享便签
+      * @date:       2023-12-18 0:57
+      * @author:     郑鲲鹏
+      * @return      void
+      */
     private void sendTo(Context context, String info) {
+        // 新建intent消息
+        // 2023-12-18 1:00
         Intent intent = new Intent(Intent.ACTION_SEND);
+        // 将要分享的便签内容放入intent中
+        // 2023-12-18 1:01
         intent.putExtra(Intent.EXTRA_TEXT, info);
         intent.setType("text/plain");
         context.startActivity(intent);
     }
 
     private void createNewNote() {
+         /**
+          * @method:  createNewNote
+          * @description: 从编辑页面，点击“add note”会进入这个创建便签的方法。
+          * 此方法会保存并结束当前便签，用NoteEditActivity类实例化一个新的intent（活动意图），
+          * 设置行为和指定报错对象后，启动intent活动意图
+          * @date: 2023/12/19 23:03
+          * @author: zhoukexing
+          * @param: []
+          * @return: void
+          */
         // Firstly, save current editing notes
         saveNote();
 
         // For safety, start a new NoteEditActivity
         finish();
-        Intent intent = new Intent(this, NoteEditActivity.class);
-        intent.setAction(Intent.ACTION_INSERT_OR_EDIT);
+        Intent intent = new Intent(this, NoteEditActivity.class); //Q: 在类的内部，还没有实现完全时，启动这个类自己？@zkx 2023/12/17
+        intent.setAction(Intent.ACTION_INSERT_OR_EDIT); // 创建便签后，要插入或者编辑。Q: 为什么要插入 @zhoukexing 2023/12/19 22:57
         intent.putExtra(Notes.INTENT_EXTRA_FOLDER_ID, mWorkingNote.getFolderId());
         startActivity(intent);
     }
-
+    /**
+     * @method:  deleteCurrentNote
+     * @description: 删除当前便签。如果在数据库里，还要进一步判断是否在根目录下，是否为同步模式
+     * @date: 2023/12/21 0:48
+     * @author: zhoukexing
+     * @param: []
+     * @return: void
+     */
     private void deleteCurrentNote() {
         if (mWorkingNote.existInDatabase()) {
             HashSet<Long> ids = new HashSet<Long>();
@@ -595,7 +871,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
             } else {
                 Log.d(TAG, "Wrong note id, should not happen");
             }
-            if (!isSyncMode()) {
+                if (mWorkingNote.getFolderId() == Notes.ID_TRASH_FOLER) {
                     if (!DataUtils.batchDeleteNotes(getContentResolver(), ids)) {
                         Log.e(TAG, "Delete Note error");
                     }
@@ -612,6 +888,15 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         return NotesPreferenceActivity.getSyncAccountName(this).trim().length() > 0;
     }
 
+    /**
+     * @Method      onClockAlertChanged
+     * @Date        2023/12/13 9:52
+     * @param       date
+     * @param       set 0 取消 1 设置
+     * @Author      lenovo
+     * @Return      void
+     * @Description 设置提醒的监听事件
+     */
     public void onClockAlertChanged(long date, boolean set) {
         /**
          * User could set clock to an unsaved note, so before setting the
@@ -627,8 +912,10 @@ public class NoteEditActivity extends Activity implements OnClickListener,
             AlarmManager alarmManager = ((AlarmManager) getSystemService(ALARM_SERVICE));
             showAlertHeader();
             if(!set) {
+                // 取消监听事件
                 alarmManager.cancel(pendingIntent);
             } else {
+                // 设置监听事件，到时间启动提醒
                 alarmManager.set(AlarmManager.RTC_WAKEUP, date, pendingIntent);
             }
         } else {
@@ -691,7 +978,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         }
     }
 
-    private void switchToListMode(String text) {
+    private void switchToListMode(String text) { // TODO: 在清单模式下设置的字体大小、样式没法保留
         mEditTextList.removeAllViews();
         String[] items = text.split("\n");
         int index = 0;
@@ -729,6 +1016,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         View view = LayoutInflater.from(this).inflate(R.layout.note_edit_list_item, null);
         final NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text);
         edit.setTextAppearance(this, TextAppearanceResources.getTexAppearanceResource(mFontSizeId));
+        initFontStyle(edit, mFontStyleId);
         CheckBox cb = ((CheckBox) view.findViewById(R.id.cb_edit_item));
         cb.setOnCheckedChangeListener(new OnCheckedChangeListener() {
             public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
@@ -806,8 +1094,16 @@ public class NoteEditActivity extends Activity implements OnClickListener,
     }
 
     private boolean saveNote() {
+         /**
+          * @method:  saveNote
+          * @description: 获取工作文本，调用真正的保存便签的方法，设置便签在list界面的位置
+          * @date: 2023/12/19 23:50
+          * @author: zhoukexing
+          * @param: []
+          * @return: boolean
+          */
         getWorkingText();
-        boolean saved = mWorkingNote.saveNote();
+        boolean saved = mWorkingNote.saveNote();// TODO: 2023/12/19 工作便签下的saveNote 
         if (saved) {
             /**
              * There are two modes from List view to edit view, open one note,
@@ -816,11 +1112,19 @@ public class NoteEditActivity extends Activity implements OnClickListener,
              * new node requires to the top of the list. This code
              * {@link #RESULT_OK} is used to identify the create/edit state
              */
-            setResult(RESULT_OK);
+            setResult(RESULT_OK); // RESULT_OK指示将该便签保存到list界面的顶端（因为这是新建的便签） @zhoukexing 2023/12/19 23:41
+            //Q: 这个setResult只在这里调用了，怎么实现的 @zkx 2023/12/19
         }
         return saved;
     }
 
+     /**
+      * @method      sendToDesktop
+      * @description 该方法用于将便签发送至桌面，创建快捷方式
+      * @date:       2023-12-18 17:27
+      * @author:     郑鲲鹏
+      * @return      void
+      */
     private void sendToDesktop() {
         /**
          * Before send message to home, we should make sure that current
@@ -832,9 +1136,13 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         }
 
         if (mWorkingNote.getNoteId() > 0) {
+            // 新建intent消息，为创建桌面快捷方式的连接器
+            // 2023-12-18 17:29
             Intent sender = new Intent();
             Intent shortcutIntent = new Intent(this, NoteEditActivity.class);
             shortcutIntent.setAction(Intent.ACTION_VIEW);
+            // 将便签的相关信息添加进intent中
+            // 2023-12-18 17:36
             shortcutIntent.putExtra(Intent.EXTRA_UID, mWorkingNote.getNoteId());
             sender.putExtra(Intent.EXTRA_SHORTCUT_INTENT, shortcutIntent);
             sender.putExtra(Intent.EXTRA_SHORTCUT_NAME,
@@ -844,6 +1152,8 @@ public class NoteEditActivity extends Activity implements OnClickListener,
             sender.putExtra("duplicate", true);
             sender.setAction("com.android.launcher.action.INSTALL_SHORTCUT");
             showToast(R.string.info_note_enter_desktop);
+            // 将便签显示于桌面
+            // 2023-12-18 17:38
             sendBroadcast(sender);
         } else {
             /**
@@ -870,4 +1180,86 @@ public class NoteEditActivity extends Activity implements OnClickListener,
     private void showToast(int resId, int duration) {
         Toast.makeText(this, resId, duration).show();
     }
+
+     /**
+      * @method      saveHistory
+      * @description 将每次编辑的内容保存在栈中
+      * @date:       2024-01-08 8:56
+      * @author:     郑鲲鹏
+      * @return      void
+      */
+    private void saveHistory() {
+        SpannableString text = new SpannableString(mNoteEditor.getText());
+        if (mHistory.size() >= mMaxRevokeTimes) {
+            mHistory.removeElementAt(0);
+            mHistory.add(text);
+        }
+        else {
+            mHistory.add(text);
+        }
+    }
+
+    /**
+     * @method      doRevoke
+     * @description 该方法实现撤回的操作
+     * @date:       2024-01-08 15:56
+     * @author:     郑鲲鹏
+     * @return      void
+     */
+    private void doRevoke() {
+        AlertDialog.Builder dialog = new AlertDialog.Builder(this);
+        dialog.setTitle(R.string.tips_of_revoke);
+        dialog.setCancelable(true);
+        dialog.setPositiveButton("OK", new DialogInterface.OnClickListener() {
+            @Override
+            public void onClick(DialogInterface dialog, int which) {
             }
+        });
+        mIsRvoke = true;
+        if(mHistory.size() <= 1){
+            dialog.setMessage(R.string.cannot_revoke_anything);
+            dialog.show();
+        }
+        else {
+            mNoteEditor.setText((CharSequence)mHistory.elementAt(mHistory.size() - 2));
+            mHistory.removeElementAt(mHistory.size() - 1);
+        }
+    }
+
+     /**
+      * @method      doScreenshot
+      * @description 该方法实现截取除了导航栏之外的屏幕的功能
+      * @date:       2024-01-17 17:20
+      * @author:     郑鲲鹏
+      * @return
+      */
+    private void doScreenshot() {
+        // 调用 getWindow().getDecorView().getRootView() 获取屏幕的根视图
+        // 使用 getDrawingCache() 获取视图的缓存位图
+        // 2024-01-17 23:22
+        View view = getWindow().getDecorView();
+        view.setDrawingCacheEnabled(true);
+        view.buildDrawingCache();
+        Bitmap bitmap = Bitmap.createBitmap(view.getDrawingCache());
+        view.setDrawingCacheEnabled(false);
+        // 保存Bitmap对象至文件中
+        // 2024-01-17 23:21
+        if (bitmap != null) {
+            try {
+                String sdCardPath = Environment.getExternalStorageDirectory().getPath();
+                String filePath = sdCardPath + File.separator + "screenshot.png";
+                File file = new File(filePath);
+                FileOutputStream fos = new FileOutputStream(file);
+                bitmap.compress(Bitmap.CompressFormat.PNG, 100, fos);
+                fos.flush();
+                fos.close();
+                // showToast(R.string.success_screenshot_saved);
+                Toast.makeText(this, "Successfully saved the screenshot to" + filePath, Toast.LENGTH_LONG).show();
+            } catch (Exception e) {
+                Log.e(TAG, "Take a screenshot error");
+                showToast(R.string.error_screenshot_saved);
+            }
+        }
+    }
+
+} //NOTE: 这一整个文件就是这一个类 @zhoukexing 2023/12/17 23:41

src/Notes-master/Notes-master/src/net/micode/notes/ui/NoteEditText.java

@@ -37,15 +37,20 @@ import net.micode.notes.R;
  import java.util.HashMap;
  import java.util.Map;
  
+ /**
+  * 自定义的便签编辑文本框类，继承自EditText，用于在便签应用中实现特殊的文本编辑功能
+  */
  public class NoteEditText extends EditText {
-    private static final String TAG = "NoteEditText";
-    private int mIndex;
-    private int mSelectionStartBeforeDelete;
+     private static final String TAG = "NoteEditText"; // 日志标签
+     private int mIndex; // 当前文本框的索引
+     private int mSelectionStartBeforeDelete; // 删除前的文本选择起始位置
  
+     // 定义几种常见的URL协议前缀
      private static final String SCHEME_TEL = "tel:" ;
      private static final String SCHEME_HTTP = "http:" ;
      private static final String SCHEME_EMAIL = "mailto:" ;
  
+     // 定义一个映射表，用于将URL协议前缀映射到对应的字符串资源ID
      private static final Map<String, Integer> sSchemaActionResMap = new HashMap<String, Integer>();
      static {
          sSchemaActionResMap.put(SCHEME_TEL, R.string.note_link_tel);
@@ -54,56 +59,87 @@ public class NoteEditText extends EditText {
      }
  
      /**
-     * Call by the {@link NoteEditActivity} to delete or add edit text
+      * 便签编辑文本框的监听器接口，用于处理文本框的删除、回车和文本变化事件
       */
      public interface OnTextViewChangeListener {
          /**
-         * Delete current edit text when {@link KeyEvent#KEYCODE_DEL} happens
-         * and the text is null
+          * 当文本框为空且按下删除键时，删除当前文本框
+          * @param index 当前文本框的索引
+          * @param text 当前文本框的文本内容
           */
          void onEditTextDelete(int index, String text);
  
          /**
-         * Add edit text after current edit text when {@link KeyEvent#KEYCODE_ENTER}
-         * happen
+          * 当按下回车键时，在当前文本框后面添加一个新的文本框
+          * @param index 当前文本框的索引
+          * @param text 当前文本框的文本内容
           */
          void onEditTextEnter(int index, String text);
  
          /**
-         * Hide or show item option when text change
+          * 当文本内容发生变化时，隐藏或显示选项菜单项
+          * @param index 当前文本框的索引
+          * @param hasText 文本框是否包含文本
           */
          void onTextChange(int index, boolean hasText);
      }
  
-    private OnTextViewChangeListener mOnTextViewChangeListener;
+     private OnTextViewChangeListener mOnTextViewChangeListener; // 监听器实例
  
+     /**
+      * 构造函数，用于创建便签编辑文本框
+      * @param context 上下文对象
+      */
      public NoteEditText(Context context) {
          super(context, null);
-        mIndex = 0;
+         mIndex = 0; // 默认索引为0
      }
  
+     /**
+      * 设置当前文本框的索引
+      * @param index 文本框的索引
+      */
      public void setIndex(int index) {
          mIndex = index;
      }
  
+     /**
+      * 设置便签编辑文本框的监听器
+      * @param listener 监听器实例
+      */
      public void setOnTextViewChangeListener(OnTextViewChangeListener listener) {
          mOnTextViewChangeListener = listener;
      }
  
+     /**
+      * 构造函数，用于创建便签编辑文本框
+      * @param context 上下文对象
+      * @param attrs 属性集
+      */
      public NoteEditText(Context context, AttributeSet attrs) {
          super(context, attrs, android.R.attr.editTextStyle);
      }
  
+     /**
+      * 构造函数，用于创建便签编辑文本框
+      * @param context 上下文对象
+      * @param attrs 属性集
+      * @param defStyle 默认样式
+      */
      public NoteEditText(Context context, AttributeSet attrs, int defStyle) {
          super(context, attrs, defStyle);
-        // TODO Auto-generated constructor stub
      }
  
+     /**
+      * 处理触摸事件，用于在文本框中选择文本
+      * @param event 触摸事件对象
+      * @return 是否处理了该事件
+      */
      @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();
@@ -111,25 +147,33 @@ public class NoteEditText extends EditText {
                  x += getScrollX();
                  y += getScrollY();
  
-                Layout layout = getLayout();
-                int line = layout.getLineForVertical(y);
-                int off = layout.getOffsetForHorizontal(line, x);
-                Selection.setSelection(getText(), off);
+                 Layout layout = getLayout(); // 获取文本布局
+                 int line = layout.getLineForVertical(y); // 计算触摸点所在的行
+                 int off = layout.getOffsetForHorizontal(line, x); // 计算触摸点所在的偏移量
+                 Selection.setSelection(getText(), off); // 设置文本选择
                  break;
          }
  
          return super.onTouchEvent(event);
      }
  
+     /**
+      * 处理键盘按键按下事件
+      * @param keyCode 按键代码
+      * @param event 键盘事件对象
+      * @return 是否处理了该事件
+      */
      @Override
      public boolean onKeyDown(int keyCode, KeyEvent event) {
          switch (keyCode) {
              case KeyEvent.KEYCODE_ENTER:
+                 // 如果监听器不为空，则不处理回车键事件
                  if (mOnTextViewChangeListener != null) {
                      return false;
                  }
                  break;
              case KeyEvent.KEYCODE_DEL:
+                 // 记录删除前的文本选择起始位置
                  mSelectionStartBeforeDelete = getSelectionStart();
                  break;
              default:
@@ -138,27 +182,35 @@ public class NoteEditText extends EditText {
          return super.onKeyDown(keyCode, event);
      }
  
+     /**
+      * 处理键盘按键抬起事件
+      * @param keyCode 按键代码
+      * @param event 键盘事件对象
+      * @return 是否处理了该事件
+      */
      @Override
      public boolean onKeyUp(int keyCode, KeyEvent event) {
          switch(keyCode) {
-            case KeyEvent.KEYCODE_DEL:
+             case KeyEvent.KEYCODE_DEL: // delete键的代码为67
+                 // 如果监听器不为空且删除前的文本选择起始位置为0且当前文本框的索引不为0，则通知监听器删除当前文本框
                  if (mOnTextViewChangeListener != null) {
                      if (0 == mSelectionStartBeforeDelete && mIndex != 0) {
                          mOnTextViewChangeListener.onEditTextDelete(mIndex, getText().toString());
                          return true;
                      }
                  } else {
-                    Log.d(TAG, "OnTextViewChangeListener was not seted");
+                     Log.d(TAG, "OnTextViewChangeListener was not seted"); // 打印日志
                  }
                  break;
-            case KeyEvent.KEYCODE_ENTER:
+             case KeyEvent.KEYCODE_ENTER: // enter键的代码为66
+                 // 如果监听器不为空，则通知监听器在当前文本框后面添加一个新的文本框
                  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");
+                     Log.d(TAG, "OnTextViewChangeListener was not seted"); // 打印日志
                  }
                  break;
              default:
@@ -167,8 +219,15 @@ public class NoteEditText extends EditText {
          return super.onKeyUp(keyCode, event);
      }
  
+     /**
+      * 处理焦点变化事件
+      * @param focused 是否获得焦点
+      * @param direction 焦点移动方向
+      * @param previouslyFocusedRect 之前获得焦点的矩形区域
+      */
      @Override
      protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) {
+         // 如果监听器不为空，则通知监听器文本框的文本变化
          if (mOnTextViewChangeListener != null) {
              if (!focused && TextUtils.isEmpty(getText())) {
                  mOnTextViewChangeListener.onTextChange(mIndex, false);
@@ -179,6 +238,10 @@ public class NoteEditText extends EditText {
          super.onFocusChanged(focused, direction, previouslyFocusedRect);
      }
  
+     /**
+      * 创建上下文菜单
+      * @param menu 上下文菜单对象
+      */
      @Override
      protected void onCreateContextMenu(ContextMenu menu) {
          if (getText() instanceof Spanned) {
@@ -187,10 +250,11 @@ public class NoteEditText extends EditText {
  
              int min = Math.min(selStart, selEnd);
              int max = Math.max(selStart, selEnd);
-
+                     // 获取选中文本中的URL
         final URLSpan[] urls = ((Spanned) getText()).getSpans(min, max, URLSpan.class);
         if (urls.length == 1) {
             int defaultResId = 0;
+            // 根据URL的协议前缀获取对应的字符串资源ID
             for(String schema: sSchemaActionResMap.keySet()) {
                 if(urls[0].getURL().indexOf(schema) >= 0) {
                     defaultResId = sSchemaActionResMap.get(schema);
@@ -199,13 +263,14 @@ public class NoteEditText extends EditText {
             }
 
             if (defaultResId == 0) {
-                    defaultResId = R.string.note_link_other;
+                defaultResId = R.string.note_link_other; // 如果没有匹配的协议前缀，则使用默认的字符串资源ID
             }
 
+            // 添加一个菜单项，用于打开URL
             menu.add(0, 0, 0, defaultResId).setOnMenuItemClickListener(
                     new OnMenuItemClickListener() {
                         public boolean onMenuItemClick(MenuItem item) {
-                                // goto a new intent
+                            // 打开URL
                             urls[0].onClick(NoteEditText.this);
                             return true;
                         }
@@ -214,4 +279,3 @@ public class NoteEditText extends EditText {
     }
     super.onCreateContextMenu(menu);
 }
-}

src/Notes-master/Notes-master/src/net/micode/notes/ui/NoteItemData.java

@@ -40,6 +40,7 @@ public class NoteItemData {
         NoteColumns.TYPE,
         NoteColumns.WIDGET_ID,
         NoteColumns.WIDGET_TYPE,
+        NoteColumns.TOP,
     };
 
     private static final int ID_COLUMN                    = 0;
@@ -54,7 +55,11 @@ public class NoteItemData {
     private static final int TYPE_COLUMN                  = 9;
     private static final int WIDGET_ID_COLUMN             = 10;
     private static final int WIDGET_TYPE_COLUMN           = 11;
+    private static final int TOP_STATE_COLUMN           = 12;
 
+     /** 以下这些数据，对照着NotesDatabaseHelper.java看
+      * 都是数据行里设置好的属性
+      * @zhoukexing 2023/12/25 20:22 */
     private long mId;
     private long mAlertDate;
     private int mBgColorId;
@@ -67,6 +72,7 @@ public class NoteItemData {
     private int mType;
     private int mWidgetId;
     private int mWidgetType;
+    private int mTop;
     private String mName;
     private String mPhoneNumber;
 
@@ -76,8 +82,16 @@ public class NoteItemData {
     private boolean mIsOneNoteFollowingFolder;
     private boolean mIsMultiNotesFollowingFolder;
 
-    public NoteItemData(Context context, Cursor cursor) {
-        mId = cursor.getLong(ID_COLUMN);
+    /**
+     * @method:  NoteItemData
+     * @description: 描述一下方法的作用
+     * @date: 2023/12/25 19:58
+     * @author: zhoukexing
+     * @param: [context, cursor]
+     * @return:
+     */
+    public NoteItemData(Context context, Cursor cursor) { // 把cursor理解为这样一个指针，指向一个表格 @zhoukexing 2023/12/25 20:12
+        mId = cursor.getLong(ID_COLUMN); // 可以根据传入的列号获取到表格里对应列的值 @zhoukexing 2023/12/25 20:12
         mAlertDate = cursor.getLong(ALERTED_DATE_COLUMN);
         mBgColorId = cursor.getInt(BG_COLOR_ID_COLUMN);
         mCreatedDate = cursor.getLong(CREATED_DATE_COLUMN);
@@ -91,10 +105,12 @@ public class NoteItemData {
         mType = cursor.getInt(TYPE_COLUMN);
         mWidgetId = cursor.getInt(WIDGET_ID_COLUMN);
         mWidgetType = cursor.getInt(WIDGET_TYPE_COLUMN);
+        mTop = cursor.getInt(TOP_STATE_COLUMN);
 
         mPhoneNumber = "";
-        if (mParentId == Notes.ID_CALL_RECORD_FOLDER) {
+        if (mParentId == Notes.ID_CALL_RECORD_FOLDER) { //Q: 文件夹为什么有电话记录之说？怎么是通过一个便签的父文件夹来判断便签内有无电话号码？@zkx 2023/12/25
             mPhoneNumber = DataUtils.getCallNumberByNoteId(context.getContentResolver(), mId);
+            // 根据电话号码锁定联系人名称，若不在联系人里，直接使用电话号码 @zhoukexing 2023/12/25 20:17
             if (!TextUtils.isEmpty(mPhoneNumber)) {
                 mName = Contact.getContact(context, mPhoneNumber);
                 if (mName == null) {
@@ -158,6 +174,10 @@ public class NoteItemData {
         return mIsOnlyOneItem;
     }
 
+    public int getTop(){
+        return mTop;
+    }
+
     public long getId() {
         return mId;
     }

src/Notes-master/Notes-master/src/net/micode/notes/ui/NotesListActivity.java

@@ -16,9 +16,11 @@
 
 package net.micode.notes.ui;
 
+import android.annotation.SuppressLint;
 import android.app.Activity;
 import android.app.AlertDialog;
 import android.app.Dialog;
+import android.app.SearchManager;
 import android.appwidget.AppWidgetManager;
 import android.content.AsyncQueryHandler;
 import android.content.ContentResolver;
@@ -77,7 +79,19 @@ import java.io.IOException;
 import java.io.InputStream;
 import java.io.InputStreamReader;
 import java.util.HashSet;
+import java.util.Queue;
 
+/** 
+  * @Package:        net.micode.notes.ui
+  * @ClassName:      NotesListActivity
+  * @Description:    便签项界面活动，所有在该界面的操作都要经过这个类
+  * @Author:         zhoukexing
+  * @CreateDate:     2024/1/18 15:25
+  * @UpdateUser:     none
+  * @UpdateDate:     2024/1/18 15:25
+  * @UpdateRemark:   none
+  * @Version:        1.0
+ */
 public class NotesListActivity extends Activity implements OnClickListener, OnItemLongClickListener {
     private static final int FOLDER_NOTE_LIST_QUERY_TOKEN = 0;
 
@@ -89,11 +103,15 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
 
     private static final int MENU_FOLDER_CHANGE_NAME = 2;
 
+    private static final int DAY_MODE = 0;
+    private static final int NIGHT_MODE = 1;
+
     private static final String PREFERENCE_ADD_INTRODUCTION = "net.micode.notes.introduction";
+    private static final String SEARCH_RESULTS = "Search Results: ";
 
     private enum ListEditState {
-        NOTE_LIST, SUB_FOLDER, CALL_RECORD_FOLDER
-    };
+        NOTE_LIST, SUB_FOLDER, CALL_RECORD_FOLDER, TRASH_FOLDER
+    } //NOTE: 三种编辑状态@zhoukexing 2024/1/2 19:31 新增一个
 
     private ListEditState mState;
 
@@ -135,12 +153,23 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
     private final static int REQUEST_CODE_OPEN_NODE = 102;
     private final static int REQUEST_CODE_NEW_NODE  = 103;
 
+    private String mTitle;
+    private String mMessage;
+
+    private int mBackground = 2;
+
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.note_list);
+        if (mBackground == DAY_MODE) {
+            getWindow().setBackgroundDrawableResource(R.drawable.list_day_mode_background);
+        } else if (mBackground == NIGHT_MODE) {
+            getWindow().setBackgroundDrawableResource(R.drawable.list_night_mode_background);
+        } else {
+            getWindow().setBackgroundDrawableResource(R.drawable.list_background);
+        }
         initResources();
-
         /**
          * Insert an introduction when user firstly use this application
          */
@@ -204,9 +233,26 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
     }
 
     @Override
+     /**
+      * @Method      onStart
+      * @Date        2024/1/4 8:56
+      * @Author      lenovo
+      * @Return      void
+      * @Description 仅在启动时调用，用于加载页面数据，展现页面内容。
+      */
     protected void onStart() {
         super.onStart();
-        startAsyncNotesListQuery();
+        Intent intent = getIntent();
+        // 如果是搜索引起的实体创建，说明需要展示搜索页面
+        if (Intent.ACTION_SEARCH.equals(intent.getAction())) {
+            String query = intent.getStringExtra(SearchManager.QUERY);
+            mTitleBar.setText(SEARCH_RESULTS + query);
+            mTitleBar.setVisibility(View.VISIBLE);
+            mAddNewNote.setVisibility(View.GONE);
+            // 将搜索数据同步
+            startAsyncNotesSearchListQuery(query);
+        }
+        else startAsyncNotesListQuery();
     }
 
     private void initResources() {
@@ -218,7 +264,7 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
                 null, false);
         mNotesListView.setOnItemClickListener(new OnListItemClickListener());
         mNotesListView.setOnItemLongClickListener(this);
-        mNotesListAdapter = new NotesListAdapter(this);
+        mNotesListAdapter = new NotesListAdapter(this, null);
         mNotesListView.setAdapter(mNotesListAdapter);
         mAddNewNote = (Button) findViewById(R.id.btn_new_note);
         mAddNewNote.setOnClickListener(this);
@@ -319,13 +365,28 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
                 return true;
             }
 
-            switch (item.getItemId()) {
-                case R.id.delete:
+            int itemId = item.getItemId();
+            if (itemId == R.id.delete) {
+                switch (mState) {
+                    case SUB_FOLDER:
+                    case CALL_RECORD_FOLDER:
+                    case NOTE_LIST:
+                        mTitle = getString(R.string.alert_title_delete);
+                        mMessage = getString(R.string.alert_message_delete_notes,
+                                mNotesListAdapter.getSelectedCount());
+                        break;
+                    case TRASH_FOLDER:
+                        mTitle = getString(R.string.alert_title_delete_true);
+                        mMessage = getString(R.string.alert_message_delete_notes_true,
+                                mNotesListAdapter.getSelectedCount());
+                        break;
+                    default:
+                        break;
+                }
                 AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
-                    builder.setTitle(getString(R.string.alert_title_delete));
+                builder.setTitle(mTitle);
                 builder.setIcon(android.R.drawable.ic_dialog_alert);
-                    builder.setMessage(getString(R.string.alert_message_delete_notes,
-                                             mNotesListAdapter.getSelectedCount()));
+                builder.setMessage(mMessage);
                 builder.setPositiveButton(android.R.string.ok,
                         new DialogInterface.OnClickListener() {
                             public void onClick(DialogInterface dialog,
@@ -335,11 +396,9 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
                         });
                 builder.setNegativeButton(android.R.string.cancel, null);
                 builder.show();
-                    break;
-                case R.id.move:
+            } else if (itemId == R.id.move) {
                 startQueryDestinationFolders();
-                    break;
-                default:
+            } else {
                 return false;
             }
             return true;
@@ -359,7 +418,9 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
                     /**
                      * Minus TitleBar's height
                      */
-                    if (mState == ListEditState.SUB_FOLDER) {
+                    if (mState == ListEditState.SUB_FOLDER ||
+                            mState == ListEditState.TRASH_FOLDER) {
+                        // 回收站的ui显示 @zkx
                         eventY -= mTitleBar.getHeight();
                         start -= mTitleBar.getHeight();
                     }
@@ -407,14 +468,33 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         }
 
     };
-
+    /**
+     * @Method      startAsyncNotesListQuery
+     * @Date        2023/12/19 8:34
+     * @Author      lenovo
+     * @Return      void
+     * @Description 开始异步查询便签列表，将便签列表从数据库加载进来
+     */
     private void startAsyncNotesListQuery() {
         String selection = (mCurrentFolderId == Notes.ID_ROOT_FOLDER) ? ROOT_FOLDER_SELECTION
                 : NORMAL_SELECTION;
+        // 按照 Top 降序
         mBackgroundQueryHandler.startQuery(FOLDER_NOTE_LIST_QUERY_TOKEN, null,
                 Notes.CONTENT_NOTE_URI, NoteItemData.PROJECTION, selection, new String[] {
                     String.valueOf(mCurrentFolderId)
-                }, NoteColumns.TYPE + " DESC," + NoteColumns.MODIFIED_DATE + " DESC");
+                }, NoteColumns.TOP + " DESC," + NoteColumns.TYPE + " DESC," + NoteColumns.MODIFIED_DATE + " DESC");
+        // DESC 降序
+    }
+
+    private void startAsyncNotesSearchListQuery(String query) {
+        // 模糊匹配 query
+        String selection = NoteColumns.SNIPPET + " LIKE'%" + query +"%'";
+        mBackgroundQueryHandler.startQuery(FOLDER_NOTE_LIST_QUERY_TOKEN, null,
+                Notes.CONTENT_NOTE_URI,
+                NoteItemData.PROJECTION,
+                selection,
+                null,
+                NoteColumns.TOP + " DESC," + NoteColumns.TYPE + " DESC," + NoteColumns.MODIFIED_DATE + " DESC");
     }
 
     private final class BackgroundQueryHandler extends AsyncQueryHandler {
@@ -469,20 +549,29 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         this.startActivityForResult(intent, REQUEST_CODE_NEW_NODE);
     }
 
+    /**
+     * @method:  batchDelete
+     * @description: 删除若干个选中的便签。
+     * 根据NotesListAdapter里的mSelectedIndex数据成员里的标记，为真表示选中，予以删除。
+     * @date: 2024/1/3 23:02
+     * @author: zhoukexing
+     * @param: []
+     * @return: void
+     */
     private void batchDelete() {
         new AsyncTask<Void, Void, HashSet<AppWidgetAttribute>>() {
+            @SuppressLint("StaticFieldLeak")
             protected HashSet<AppWidgetAttribute> doInBackground(Void... unused) {
                 HashSet<AppWidgetAttribute> widgets = mNotesListAdapter.getSelectedWidget();
-                if (!isSyncMode()) {
-                    // if not synced, delete notes directly
+                if (mCurrentFolderId == Notes.ID_TRASH_FOLER){
+                    // if in trash, really delete notes
                     if (DataUtils.batchDeleteNotes(mContentResolver, mNotesListAdapter
                             .getSelectedItemIds())) {
                     } else {
                         Log.e(TAG, "Delete notes error, should not happens");
                     }
                 } else {
-                    // in sync mode, we'll move the deleted note into the trash
-                    // folder
+                    // move notes to trash
                     if (!DataUtils.batchMoveToFolder(mContentResolver, mNotesListAdapter
                             .getSelectedItemIds(), Notes.ID_TRASH_FOLER)) {
                         Log.e(TAG, "Move notes to trash folder error, should not happens");
@@ -495,8 +584,10 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
             protected void onPostExecute(HashSet<AppWidgetAttribute> widgets) {
                 if (widgets != null) {
                     for (AppWidgetAttribute widget : widgets) {
+                        // widget挂件的Id和Type都不是非法的《==》存在这个widget挂件 @zkx
                         if (widget.widgetId != AppWidgetManager.INVALID_APPWIDGET_ID
                                 && widget.widgetType != Notes.TYPE_WIDGET_INVALIDE) {
+                            //  ==》 删除这个挂件
                             updateWidget(widget.widgetId, widget.widgetType);
                         }
                     }
@@ -506,6 +597,14 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         }.execute();
     }
 
+    /**
+     * @Method      deleteFolder
+     * @Date        2023/12/19 8:37
+     * @param 		folderId
+     * @Author      lenovo
+     * @Return      void
+     * @Description 删除文件夹 (sync mode 会删除进回收站)
+     */
     private void deleteFolder(long folderId) {
         if (folderId == Notes.ID_ROOT_FOLDER) {
             Log.e(TAG, "Wrong folder id, should not happen " + folderId);
@@ -514,15 +613,17 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
 
         HashSet<Long> ids = new HashSet<Long>();
         ids.add(folderId);
+        // 所有与要删除文件夹相关的 widgets
         HashSet<AppWidgetAttribute> widgets = DataUtils.getFolderNoteWidget(mContentResolver,
                 folderId);
-        if (!isSyncMode()) {
-            // if not synced, delete folder directly
+        if (mCurrentFolderId == Notes.ID_TRASH_FOLER) {
+            // if in trash, delete folder directly
             DataUtils.batchDeleteNotes(mContentResolver, ids);
         } else {
-            // in sync mode, we'll move the deleted folder into the trash folder
+            // move the deleted folder into the trash folder
             DataUtils.batchMoveToFolder(mContentResolver, ids, Notes.ID_TRASH_FOLER);
         }
+        // 更新 widgets
         if (widgets != null) {
             for (AppWidgetAttribute widget : widgets) {
                 if (widget.widgetId != AppWidgetManager.INVALID_APPWIDGET_ID
@@ -540,33 +641,47 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         this.startActivityForResult(intent, REQUEST_CODE_OPEN_NODE);
     }
 
+    /**
+     * @Method      openFolder
+     * @Date        2023/12/19 7:55
+     * @param 		data
+     * @Author      lenovo
+     * @Return      void
+     * @Description 打开文件夹
+     */
     private void openFolder(NoteItemData data) {
         mCurrentFolderId = data.getId();
         startAsyncNotesListQuery();
         if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {
+            // TODO store all records 暂时没太搞明白这个代表什么
             mState = ListEditState.CALL_RECORD_FOLDER;
             mAddNewNote.setVisibility(View.GONE);
         } else {
+            // 正常打开文件夹
             mState = ListEditState.SUB_FOLDER;
         }
         if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {
             mTitleBar.setText(R.string.call_record_folder_name);
         } else {
+            // 将顶部栏设置为 data.getSnippet 文件夹名称
             mTitleBar.setText(data.getSnippet());
         }
         mTitleBar.setVisibility(View.VISIBLE);
     }
 
     public void onClick(View v) {
-        switch (v.getId()) {
-            case R.id.btn_new_note:
+        if (v.getId() == R.id.btn_new_note) {
             createNewNote();
-                break;
-            default:
-                break;
         }
     }
 
+    /**
+     * @Method      showSoftInput
+     * @Date        2023/12/17 23:46
+     * @Author      lenovo
+     * @Return      void
+     * @Description 显示软键盘
+     */
     private void showSoftInput() {
         InputMethodManager inputMethodManager = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
         if (inputMethodManager != null) {
@@ -579,14 +694,23 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         inputMethodManager.hideSoftInputFromWindow(view.getWindowToken(), 0);
     }
 
+    /**
+     * @Method      showCreateOrModifyFolderDialog
+     * @Date        2023/12/17 22:32
+     * @param 		create true为创建新文件夹， false为修改文件夹的名字
+     * @Author      lenovo
+     * @Return      void
+     * @Description 新建或修改文件夹名字
+     */
     private void showCreateOrModifyFolderDialog(final boolean create) {
+        // final 关键字, 初始化之后无法修改 (const)
         final AlertDialog.Builder builder = new AlertDialog.Builder(this);
         View view = LayoutInflater.from(this).inflate(R.layout.dialog_edit_text, null);
         final EditText etName = (EditText) view.findViewById(R.id.et_foler_name);
         showSoftInput();
         if (!create) {
             if (mFocusNoteDataItem != null) {
-                etName.setText(mFocusNoteDataItem.getSnippet());
+                etName.setText(mFocusNoteDataItem.getSnippet()); // 显示之前的名称
                 builder.setTitle(getString(R.string.menu_folder_change_name));
             } else {
                 Log.e(TAG, "The long click data item is null");
@@ -596,7 +720,11 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
             etName.setText("");
             builder.setTitle(this.getString(R.string.menu_create_folder));
         }
-
+        /**
+         * 正按钮 OK 无监听器
+         *  负按钮 Cancel 隐藏软键盘
+         * lenovo 2023/12/18 0:03
+        */
         builder.setPositiveButton(android.R.string.ok, null);
         builder.setNegativeButton(android.R.string.cancel, new DialogInterface.OnClickListener() {
             public void onClick(DialogInterface dialog, int which) {
@@ -610,12 +738,14 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
             public void onClick(View v) {
                 hideSoftInput(etName);
                 String name = etName.getText().toString();
+                // 如果该名称已经存在
                 if (DataUtils.checkVisibleFolderName(mContentResolver, name)) {
                     Toast.makeText(NotesListActivity.this, getString(R.string.folder_exist, name),
                             Toast.LENGTH_LONG).show();
-                    etName.setSelection(0, etName.length());
+                    etName.setSelection(0, etName.length()); //全选输入文件名（准备修改/删除)
                     return;
                 }
+                // 更新数据库中文件夹名称 插入/修改
                 if (!create) {
                     if (!TextUtils.isEmpty(name)) {
                         ContentValues values = new ContentValues();
@@ -633,6 +763,7 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
                     values.put(NoteColumns.TYPE, Notes.TYPE_FOLDER);
                     mContentResolver.insert(Notes.CONTENT_NOTE_URI, values);
                 }
+                //关闭对话框
                 dialog.dismiss();
             }
         });
@@ -646,7 +777,6 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         etName.addTextChangedListener(new TextWatcher() {
             public void beforeTextChanged(CharSequence s, int start, int count, int after) {
                 // TODO Auto-generated method stub
-
             }
 
             public void onTextChanged(CharSequence s, int start, int before, int count) {
@@ -659,21 +789,25 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
 
             public void afterTextChanged(Editable s) {
                 // TODO Auto-generated method stub
-
             }
         });
     }
 
     @Override
     public void onBackPressed() {
+        // 在list（清单界面）按回退键就会被捕捉到这里，执行这个函数 @zhoukexing 2024/1/2 19:33
         switch (mState) {
-            case SUB_FOLDER:
+            case SUB_FOLDER: // 当前状态是子文件夹，要回退到主文件夹 @zkx
+                // 特殊情况：子文件夹是“回收站”，要显式地说明展示底部栏（模仿下面的call_record_folder） @zkx
+                // 添加mAddNewNote.setVisibility(View.VISIBLE);此行后，
+                // sub_folder 和 call_record_folder 两种情况无差别，无需分开处理
                 mCurrentFolderId = Notes.ID_ROOT_FOLDER;
                 mState = ListEditState.NOTE_LIST;
-                startAsyncNotesListQuery();
                 mTitleBar.setVisibility(View.GONE);
+                startAsyncNotesListQuery();
                 break;
             case CALL_RECORD_FOLDER:
+            case TRASH_FOLDER:
                 mCurrentFolderId = Notes.ID_ROOT_FOLDER;
                 mState = ListEditState.NOTE_LIST;
                 mAddNewNote.setVisibility(View.VISIBLE);
@@ -688,8 +822,17 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         }
     }
 
+     /**
+      * @method      updateWidget
+      * @description 该方法用于实现与桌面小工具同步的功能
+      * @date:       2023-12-18 21:37
+      * @author:     郑鲲鹏
+      * @return      void
+      */
     private void updateWidget(int appWidgetId, int appWidgetType) {
         Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE);
+        // 根据不同大小类型的widget更新Widget
+        // 2023-12-18 21:41
         if (appWidgetType == Notes.TYPE_WIDGET_2X) {
             intent.setClass(this, NoteWidgetProvider_2x.class);
         } else if (appWidgetType == Notes.TYPE_WIDGET_4X) {
@@ -726,6 +869,14 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         super.onContextMenuClosed(menu);
     }
 
+    /**
+     * @Method      onContextItemSelected
+     * @Date        2023/12/17 23:51
+     * @param 		item
+     * @Author      lenovo
+     * @Return      boolean
+     * @Description 长按文件夹之后显示的文件夹菜单对应的后台程序
+     */
     @Override
     public boolean onContextItemSelected(MenuItem item) {
         if (mFocusNoteDataItem == null) {
@@ -739,7 +890,7 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
             case MENU_FOLDER_DELETE:
                 AlertDialog.Builder builder = new AlertDialog.Builder(this);
                 builder.setTitle(getString(R.string.alert_title_delete));
-                builder.setIcon(android.R.drawable.ic_dialog_alert);
+                builder.setIcon(android.R.drawable.divider_horizontal_dark);
                 builder.setMessage(getString(R.string.alert_message_delete_folder));
                 builder.setPositiveButton(android.R.string.ok,
                         new DialogInterface.OnClickListener() {
@@ -770,26 +921,39 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
                     GTaskSyncService.isSyncing() ? R.string.menu_sync_cancel : R.string.menu_sync);
         } else if (mState == ListEditState.SUB_FOLDER) {
             getMenuInflater().inflate(R.menu.sub_folder, menu);
+        } else if (mState == ListEditState.TRASH_FOLDER) {
+            getMenuInflater().inflate(R.menu.trash_folder, menu);
         } else if (mState == ListEditState.CALL_RECORD_FOLDER) {
             getMenuInflater().inflate(R.menu.call_record_folder, menu);
         } else {
             Log.e(TAG, "Wrong state:" + mState);
         }
+        // 实现交替显示白天和夜间模式
+        // 2024-01-18 9:09
+        if (mBackground == DAY_MODE) {
+            menu.findItem(R.id.menu_day_mode).setVisible(false);
+        } else if (mBackground == NIGHT_MODE) {
+            menu.findItem(R.id.menu_night_mode).setVisible(false);
+        }
         return true;
     }
 
+    /**
+     * @Method      onOptionsItemSelected
+     * @Date        2023/12/17 23:49
+     * @param 		item
+     * @Author      lenovo
+     * @Return      boolean
+     * @Description 主界面菜单对应的后台程序
+     */
     @Override
     public boolean onOptionsItemSelected(MenuItem item) {
-        switch (item.getItemId()) {
-            case R.id.menu_new_folder: {
+        int itemId = item.getItemId();
+        if (itemId == R.id.menu_new_folder) {
             showCreateOrModifyFolderDialog(true);
-                break;
-            }
-            case R.id.menu_export_text: {
+        } else if (itemId == R.id.menu_export_text) {
             exportNoteToText();
-                break;
-            }
-            case R.id.menu_sync: {
+        } else if (itemId == R.id.menu_sync) {
             if (isSyncMode()) {
                 if (TextUtils.equals(item.getTitle(), getString(R.string.menu_sync))) {
                     GTaskSyncService.startSync(this);
@@ -799,43 +963,128 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
             } else {
                 startPreferenceActivity();
             }
-                break;
-            }
-            case R.id.menu_setting: {
+        } else if (itemId == R.id.menu_setting) {
             startPreferenceActivity();
-                break;
-            }
-            case R.id.menu_new_note: {
+        } else if (itemId == R.id.menu_new_note) {
             createNewNote();
-                break;
-            }
-            case R.id.menu_search:
+        } else if (itemId == R.id.menu_search) {
             onSearchRequested();
-                break;
-            default:
-                break;
+        } else if (itemId == R.id.menu_trash) {
+            openTrashFolder();
+        } else if (itemId == R.id.menu_empty_trash) {
+            emptyTrashFolder();
+        } else if (itemId == R.id.menu_count_notes) {
+            countTotalNotes();
+        } else if (itemId == R.id.menu_day_mode) {
+            mBackground = DAY_MODE;
+            getWindow().setBackgroundDrawableResource(R.drawable.list_day_mode_background);
+        } else if (itemId == R.id.menu_night_mode) {
+            mBackground = NIGHT_MODE;
+            getWindow().setBackgroundDrawableResource(R.drawable.list_night_mode_background);
         }
         return true;
     }
 
+    private void countTotalNotes() {
+        AlertDialog.Builder btr =new AlertDialog.Builder(this);
+        btr.setTitle("目前便签数");
+        btr.setMessage("目前有 "+Integer.toString(mNotesListAdapter.getMNotesCount())+"个便签");
+        btr.show();
+    }
+
+    /**
+     * @method:  emptyTrashFolder
+     * @description: 通过“选中”回收站下所有便签，清空整个回收站
+     * @date: 2024/1/3 22:59
+     * @author: zhoukexing
+     * @param: []
+     * @return: void
+     */
+    private void emptyTrashFolder() {
+        // 利用已有函数，在数据结构上“选中”所有便签 @zkx
+        mNotesListAdapter.selectAll(true);
+        // 模仿选中R.id.delete，构建对话框
+        AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
+        builder.setTitle(getString(R.string.alert_title_delete_true));
+        builder.setIcon(android.R.drawable.ic_dialog_alert);
+        builder.setMessage(getString(R.string.alert_message_delete_notes_true,
+                mNotesListAdapter.getMNotesCount()));
+        builder.setPositiveButton(android.R.string.ok,
+                new DialogInterface.OnClickListener() {
+                    public void onClick(DialogInterface dialog,
+                                        int which) {
+                        // 这里体现了【层次化/模块化】的软件哲学。
+                        // 当时实现这个功能有两条路可以走，
+                        // 一条是：修改已有batchDelete里的select函数，改为选中所有，实现一个alldelete函数
+                        // 一条是：利用batchDelete的功能（删除选中的便签），在进入batchDelete前选中所有
+                        // 后者是更好的。前者需要修改方法，是侵入式的，而且会造成许多代码的重复，没有做到方法与方法之间的低耦合。
+                        batchDelete();
+                    }
+                });
+        builder.setNegativeButton(android.R.string.cancel, null);
+        builder.show();
+    }
+
+    /**
+     * @method:  openTrashFolder
+     * @description: 打开回收站 todo：添加30天后自动删除【时间】
+     * @date: 2024/1/2 19:04
+     * @author: zhoukexing
+     * @param: []
+     * @return: void
+     */
+    private void openTrashFolder() {
+        mCurrentFolderId = Notes.ID_TRASH_FOLER;
+        startAsyncNotesListQuery();
+        // 正常打开文件夹
+        mState = ListEditState.TRASH_FOLDER;
+        // 将顶部栏设置为 data.getSnippet 文件夹名称
+        mTitleBar.setText(NotesListActivity.this
+                .getString(R.string.menu_trash));
+        // 不显示底部的“写便签” todoclosed:从子文件夹回到主页面时，展示底部栏
+        mAddNewNote.setVisibility(View.GONE);
+        mTitleBar.setVisibility(View.VISIBLE);
+    }
     @Override
+    /**
+     * @Method      onSearchRequested
+     * @Date        2023/12/19 8:53
+     * @Author      lenovo
+     * @Return      boolean
+     * @Description 打开搜索小部件
+     */
     public boolean onSearchRequested() {
         startSearch(null, false, null /* appData */, false);
         return true;
     }
 
+    /**
+     * @Method      exportNoteToText
+     * @Date        2023/12/19 8:44
+     * @Author      lenovo
+     * @Return      void
+     * @Description 将便签导出成文本
+     */
     private void exportNoteToText() {
         final BackupUtils backup = BackupUtils.getInstance(NotesListActivity.this);
+        /**
+         * 启用异步 UI 线程
+         * Warning: deprecated in API level 30
+         * would cause Context leaks, missed callbacks, or crashes on configuration changes.
+         * lenovo 2023/12/19 9:04
+        */
         new AsyncTask<Void, Void, Integer>() {
 
             @Override
+            // 后台运行导出文本
             protected Integer doInBackground(Void... unused) {
                 return backup.exportToText();
             }
 
             @Override
+            // 线程运行结束后的结果处理程序
             protected void onPostExecute(Integer result) {
-                if (result == BackupUtils.STATE_SD_CARD_UNMOUONTED) {
+                if (result == BackupUtils.STATE_SD_CARD_UNMOUONTED) { // 没插 SD 卡
                     AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
                     builder.setTitle(NotesListActivity.this
                             .getString(R.string.failed_sdcard_export));
@@ -903,6 +1152,7 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
                         break;
                     case SUB_FOLDER:
                     case CALL_RECORD_FOLDER:
+                    case TRASH_FOLDER:
                         if (item.getType() == Notes.TYPE_NOTE) {
                             openNode(item);
                         } else {
@@ -917,6 +1167,13 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
 
     }
 
+    /**
+     * @Method      startQueryDestinationFolders
+     * @Date        2023/12/19 8:59
+     * @Author      lenovo
+     * @Return      void
+     * @Description 查询可以移动到哪些文件夹
+     */
     private void startQueryDestinationFolders() {
         String selection = NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>? AND " + NoteColumns.ID + "<>?";
         selection = (mState == ListEditState.NOTE_LIST) ? selection:

src/Notes-master/Notes-master/src/net/micode/notes/ui/NotesListAdapter.java

@@ -16,12 +16,14 @@
 
 package net.micode.notes.ui;
 
+import android.text.TextUtils;
 import android.content.Context;
 import android.database.Cursor;
 import android.util.Log;
 import android.view.View;
 import android.view.ViewGroup;
 import android.widget.CursorAdapter;
+import android.widget.LinearLayout;
 
 import net.micode.notes.data.Notes;
 
@@ -34,22 +36,41 @@ import java.util.Iterator;
 public class NotesListAdapter extends CursorAdapter {
     private static final String TAG = "NotesListAdapter";
     private Context mContext;
+     /** 键-值对，值为true时，表示被选中 @zhoukexing 2024/1/2 20:50 */
     private HashMap<Integer, Boolean> mSelectedIndex;
+//    private HashMap<Integer, String> mSnippetPosition;
     private int mNotesCount;
     private boolean mChoiceMode;
+//    private String mQuery; // 搜索串
 
     public static class AppWidgetAttribute {
         public int widgetId;
         public int widgetType;
-    };
+    }
 
-    public NotesListAdapter(Context context) {
-        super(context, null);
+    public NotesListAdapter(Context context, Cursor cursor) {
+        super(context, cursor);
         mSelectedIndex = new HashMap<Integer, Boolean>();
+//        mSnippetPosition = new HashMap<Integer, String>();
         mContext = context;
         mNotesCount = 0;
+//        mQuery="";
     }
 
+//    @Override
+//    public View getView(int position, View convertView, ViewGroup parent) {
+//        View view = super.getView(position, convertView, parent);
+//        // 仅显示便签项中包含搜索串的便签
+//        String snippet = mSnippetPosition.get(position);
+//        Log.e(TAG, snippet);
+//        if(!TextUtils.isEmpty(mQuery) && !mSnippetPosition.get(position).contains(mQuery)) {
+//            view.setVisibility(View.GONE);
+//            LinearLayout.LayoutParams param = new LinearLayout.LayoutParams(0,1);
+//            view.setLayoutParams(param);
+//        }
+//        return view;
+//    }
+
     @Override
     public View newView(Context context, Cursor cursor, ViewGroup parent) {
         return new NotesListItem(context);
@@ -78,6 +99,17 @@ public class NotesListAdapter extends CursorAdapter {
         mChoiceMode = mode;
     }
 
+    /**
+     * @method:  selectAll
+     * @description: 传入一个boolean值，
+     * 通过setCheckedItem来修改mSelectedIndex数据成员，
+     * 将值都置为传入的参数，
+     * 达到选中所有项 or 不选所有项的效果。
+     * @date: 2024/1/3 22:36
+     * @author: zhoukexing
+     * @param: [checked]
+     * @return: void
+     */
     public void selectAll(boolean checked) {
         Cursor cursor = getCursor();
         for (int i = 0; i < getCount(); i++) {
@@ -143,11 +175,27 @@ public class NotesListAdapter extends CursorAdapter {
         return count;
     }
 
+    public int getMNotesCount() {
+        return mNotesCount;
+    }
+
+    /**
+     * @method:  isAllSelected
+     * @description: 如果都选中了就返回true，否则返回false
+     * @date: 2024/1/2 20:47
+     * @author: zhoukexing
+     * @param: []
+     * @return: boolean
+     */
     public boolean isAllSelected() {
         int checkedCount = getSelectedCount();
         return (checkedCount != 0 && checkedCount == mNotesCount);
     }
 
+//    public void setmQuery(String Query) {
+//        mQuery = Query;
+//    }
+
     public boolean isSelectedItem(final int position) {
         if (null == mSelectedIndex.get(position)) {
             return false;
@@ -159,14 +207,46 @@ public class NotesListAdapter extends CursorAdapter {
     protected void onContentChanged() {
         super.onContentChanged();
         calcNotesCount();
+//        updateSnippetMap(); // 在数据发生改变时更新 Snippet 到 Position 的映射
     }
 
+    /**
+     * @Method      changeCursor
+     * @Date        2024/1/18 15:36
+     * @param 		 cursor
+     * @Author      lenovo
+     * @Return      void
+     * @Description 当cursor改变时调用，需要在这里进行一些数据更新工作
+     */
     @Override
     public void changeCursor(Cursor cursor) {
         super.changeCursor(cursor);
         calcNotesCount();
+//        updateSnippetMap(); // 在数据发生改变时更新 Snippet 到 Position 的映射
     }
 
+//    private void updateSnippetMap() {
+//        mSnippetPosition = new HashMap<Integer, String>();
+//        for (int i = 0; i < getCount(); i++) {
+//            Cursor c = (Cursor) getItem(i);
+//            if (c != null) {
+//                int position = c.getPosition();
+//                NoteItemData item = new NoteItemData(mContext, c);
+//                mSnippetPosition.put(position, item.getSnippet());
+//            } else {
+//                Log.e(TAG, "Invalid cursor");
+//                break;
+//            }
+//        }
+//    }
+
+    /**
+     * @Method      calcNotesCount
+     * @Date        2024/1/18 15:36
+     * @Author      lenovo
+     * @Return      void
+     * @Description 计算便签的数目
+     */
     private void calcNotesCount() {
         mNotesCount = 0;
         for (int i = 0; i < getCount(); i++) {

src/Notes-master/Notes-master/src/net/micode/notes/ui/NotesListItem.java

@@ -29,93 +29,138 @@ import net.micode.notes.data.Notes;
  import net.micode.notes.tool.DataUtils;
  import net.micode.notes.tool.ResourceParser.NoteItemBgResources;
  
-
+ /**
+  * @Package: net.micode.notes.ui
+  * @Class:    NotesListItem
+  * @Author:   lenovo
+  * @Date:     2024/1/18 15:43
+  * @Description: 主页面便签项的类，用于显示便签列表中的每个便签项
+  */
  public class NotesListItem extends LinearLayout {
-    private ImageView mAlert;
-    private TextView mTitle;
-    private TextView mTime;
-    private TextView mCallName;
-    private NoteItemData mItemData;
-    private CheckBox mCheckBox;
+     private ImageView mAlert; // 用于显示提醒图标的ImageView
+     private ImageView mTop; // 用于显示置顶图标的ImageView
+     private TextView mTitle; // 用于显示便签标题的TextView
+     private TextView mTime; // 用于显示便签修改时间的TextView
+     private TextView mCallName; // 用于显示通话记录名称的TextView
+     private NoteItemData mItemData; // 当前便签项的数据
+     private CheckBox mCheckBox; // 用于显示选择框的CheckBox
  
+     /**
+      * 构造函数，用于创建便签项视图
+      * @param context 上下文对象
+      */
      public NotesListItem(Context context) {
          super(context);
-        inflate(context, R.layout.note_item, this);
-        mAlert = (ImageView) findViewById(R.id.iv_alert_icon);
-        mTitle = (TextView) findViewById(R.id.tv_title);
-        mTime = (TextView) findViewById(R.id.tv_time);
-        mCallName = (TextView) findViewById(R.id.tv_name);
-        mCheckBox = (CheckBox) findViewById(android.R.id.checkbox);
+         inflate(context, R.layout.note_item, this); // 加载便签项布局
+         mAlert = (ImageView) findViewById(R.id.iv_alert_icon); // 获取提醒图标
+         mTop = (ImageView) findViewById(R.id.iv_top_icon); // 获取置顶图标
+         mTitle = (TextView) findViewById(R.id.tv_title); // 获取便签标题
+         mTime = (TextView) findViewById(R.id.tv_time); // 获取便签修改时间
+         mCallName = (TextView) findViewById(R.id.tv_name); // 获取通话记录名称
+         mCheckBox = (CheckBox) findViewById(android.R.id.checkbox); // 获取选择框
      }
  
+     /**
+      * 绑定便签项数据
+      * @param context 上下文对象
+      * @param data 便签项数据
+      * @param choiceMode 是否处于选择模式
+      * @param checked 是否被选中
+      */
      public void bind(Context context, NoteItemData data, boolean choiceMode, boolean checked) {
          if (choiceMode && data.getType() == Notes.TYPE_NOTE) {
-            mCheckBox.setVisibility(View.VISIBLE);
-            mCheckBox.setChecked(checked);
+             mCheckBox.setVisibility(View.VISIBLE); // 如果处于选择模式且是便签类型，则显示选择框
+             mCheckBox.setChecked(checked); // 设置选择框的选中状态
          } else {
-            mCheckBox.setVisibility(View.GONE);
+             mCheckBox.setVisibility(View.GONE); // 否则隐藏选择框
          }
  
-        mItemData = data;
+         mItemData = data; // 设置当前便签项的数据
          if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {
-            mCallName.setVisibility(View.GONE);
-            mAlert.setVisibility(View.VISIBLE);
-            mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
+             // 如果是通话记录文件夹
+             mCallName.setVisibility(View.GONE); // 隐藏通话记录名称
+             mAlert.setVisibility(View.VISIBLE); // 显示提醒图标
+             mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem); // 设置便签标题的样式
              mTitle.setText(context.getString(R.string.call_record_folder_name)
-                    + context.getString(R.string.format_folder_files_count, data.getNotesCount()));
-            mAlert.setImageResource(R.drawable.call_record);
+                     + context.getString(R.string.format_folder_files_count, data.getNotesCount())); // 设置便签标题为通话记录文件夹名称和文件数量
+             mAlert.setImageResource(R.drawable.call_record); // 设置提醒图标为通话记录图标
          } else if (data.getParentId() == Notes.ID_CALL_RECORD_FOLDER) {
-            mCallName.setVisibility(View.VISIBLE);
-            mCallName.setText(data.getCallName());
-            mTitle.setTextAppearance(context,R.style.TextAppearanceSecondaryItem);
-            mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));
+             // 如果是通话记录
+             mCallName.setVisibility(View.VISIBLE); // 显示通话记录名称
+             mCallName.setText(data.getCallName()); // 设置通话记录名称
+             mTitle.setTextAppearance(context,R.style.TextAppearanceSecondaryItem); // 设置便签标题的样式
+             mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet())); // 设置便签标题为格式化的摘要信息
              if (data.hasAlert()) {
-                mAlert.setImageResource(R.drawable.clock);
-                mAlert.setVisibility(View.VISIBLE);
+                 mAlert.setImageResource(R.drawable.clock); // 如果有提醒，则设置提醒图标为时钟图标
+                 mAlert.setVisibility(View.VISIBLE); // 显示提醒图标
              } else {
-                mAlert.setVisibility(View.GONE);
+                 mAlert.setVisibility(View.GONE); // 否则隐藏提醒图标
              }
          } else {
-            mCallName.setVisibility(View.GONE);
-            mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
+             mCallName.setVisibility(View.GONE); // 隐藏通话记录名称
+             mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem); // 设置便签标题的样式
  
              if (data.getType() == Notes.TYPE_FOLDER) {
+                 // 如果是文件夹
                  mTitle.setText(data.getSnippet()
                          + context.getString(R.string.format_folder_files_count,
-                                data.getNotesCount()));
-                mAlert.setVisibility(View.GONE);
+                                 data.getNotesCount())); // 设置便签标题为文件夹名称和文件数量
+                 mAlert.setVisibility(View.GONE); // 隐藏提醒图标
              } else {
-                mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));
+                 // 如果是便签
+                 mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet())); // 设置便签标题为格式化的摘要信息
                  if (data.hasAlert()) {
-                    mAlert.setImageResource(R.drawable.clock);
-                    mAlert.setVisibility(View.VISIBLE);
+                     mAlert.setImageResource(R.drawable.clock); // 如果有提醒，则设置提醒图标为时钟图标
+                     mAlert.setVisibility(View.VISIBLE); // 显示提醒图标
                  } else {
-                    mAlert.setVisibility(View.GONE);
+                     mAlert.setVisibility(View.GONE); // 否则隐藏提醒图标
                  }
              }
          }
-        mTime.setText(DateUtils.getRelativeTimeSpanString(data.getModifiedDate()));
+         mTime.setText(DateUtils.getRelativeTimeSpanString(data.getModifiedDate())); // 设置便签修改时间为相对时间字符串
+         // 设置置顶图标
+         if(data.getTop() == 1){
+             mTop.setImageResource(R.drawable.set_top); // 如果便签置顶，则设置置顶图标为置顶图标
+             mTop.setVisibility(View.VISIBLE); // 显示置顶图标
+         }
+         else{
+             mTop.setVisibility(View.GONE); // 否则隐藏置顶图标
+         }
  
-        setBackground(data);
+         setBackground(data); // 设置便签项的背景
      }
  
+     /**
+      * 设置便签项的背景
+      * @param data 便签项数据
+      */
      private void setBackground(NoteItemData data) {
-        int id = data.getBgColorId();
+         int id = data.getBgColorId(); // 获取便签项的背景颜色ID
          if (data.getType() == Notes.TYPE_NOTE) {
+             // 如果是便签
              if (data.isSingle() || data.isOneFollowingFolder()) {
-                setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(id));
+                 // 如果是单个便签或紧跟在文件夹后面的便签
+                 setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(id)); // 设置背景为单个便签背景
              } else if (data.isLast()) {
-                setBackgroundResource(NoteItemBgResources.getNoteBgLastRes(id));
+                 // 如果是最后一个便签
+                 setBackgroundResource(NoteItemBgResources.getNoteBgLastRes(id)); // 设置背景为最后一个便签背景
              } else if (data.isFirst() || data.isMultiFollowingFolder()) {
-                setBackgroundResource(NoteItemBgResources.getNoteBgFirstRes(id));
+                 // 如果是第一个便签或紧跟在多个文件夹后面的便签
+                 setBackgroundResource(NoteItemBgResources.getNoteBgFirstRes(id)); // 设置背景为第一个便签背景
              } else {
-                setBackgroundResource(NoteItemBgResources.getNoteBgNormalRes(id));
+                 // 如果是普通便签
+                 setBackgroundResource(NoteItemBgResources.getNoteBgNormalRes(id)); // 设置背景为普通便签背景
              }
          } else {
-            setBackgroundResource(NoteItemBgResources.getFolderBgRes());
+             // 如果是文件夹
+             setBackgroundResource(NoteItemBgResources.getFolderBgRes()); // 设置背景为文件夹背景
          }
      }
  
+     /**
+      * 获取便签项的数据
+      * @return 便签项的数据
+      */
      public NoteItemData getItemData() {
          return mItemData;
      }

src/Notes-master/Notes-master/src/net/micode/notes/widget/NoteWidgetProvider.java

@@ -32,6 +32,15 @@ import net.micode.notes.tool.ResourceParser;
 import net.micode.notes.ui.NoteEditActivity;
 import net.micode.notes.ui.NotesListActivity;
 
+/**
+ *
+ * @ProjectName:    minode
+ * @Package:        net.micode.notes.widget
+ * @ClassName:      NoteWidgetProvider
+ * @Description:    该类继承了AppWidgetProvider，实现挂件添加、删除、更新、启用等功能
+
+ * @Date:           2024-12-18 21:13
+ */
 public abstract class NoteWidgetProvider extends AppWidgetProvider {
     public static final String [] PROJECTION = new String [] {
             NoteColumns.ID,
@@ -45,6 +54,12 @@ public abstract class NoteWidgetProvider extends AppWidgetProvider {
 
     private static final String TAG = "NoteWidgetProvider";
 
+    /**
+     * @method      onDeleted
+     * @description 该方法用于删除Widget
+     * @date:       2024-12-18 21:18
+     * @return      void
+     */
     @Override
     public void onDeleted(Context context, int[] appWidgetIds) {
         ContentValues values = new ContentValues();
@@ -65,6 +80,12 @@ public abstract class NoteWidgetProvider extends AppWidgetProvider {
                 null);
     }
 
+    /**
+     * @method      update
+     * @description 该方法用于添加或更新Widget
+     * @date:       2024-12-18 21:11
+     * @return      void
+     */
     protected void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
         update(context, appWidgetManager, appWidgetIds, false);
     }