增加注释

.idea/deploymentTargetSelector.xml

@@ -4,6 +4,14 @@
     <selectionStates>
       <SelectionState runConfigName="app">
         <option name="selectionMode" value="DROPDOWN" />
+        <DropdownSelection timestamp="2025-06-14T18:50:42.270638800Z">
+          <Target type="DEFAULT_BOOT">
+            <handle>
+              <DeviceId pluginId="PhysicalDevice" identifier="serial=9DX8D6J76L95PRPR" />
+            </handle>
+          </Target>
+        </DropdownSelection>
+        <DialogSelection />
       </SelectionState>
     </selectionStates>
   </component>

.idea/misc.xml

@@ -1,4 +1,3 @@
-<?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
   <component name="ProjectRootManager" version="2" languageLevel="JDK_21" default="true" project-jdk-name="jbr-21" project-jdk-type="JavaSDK">
     <output url="file://$PROJECT_DIR$/build/classes" />

app/src/main/java/net/micode/notes/model/WorkingNote.java

@@ -31,7 +31,10 @@ import net.micode.notes.data.Notes.NoteColumns;
 import net.micode.notes.data.Notes.TextNote;
 import net.micode.notes.tool.ResourceParser.NoteBgResources;
 
-
+/**
+ * WorkingNote 类代表一个正在编辑的笔记对象
+ * 它负责管理笔记的内容、状态和与数据库的交互
+ */
 public class WorkingNote {
     // Note for the working note
     private Note mNote;
@@ -42,26 +45,18 @@ public class WorkingNote {
     // Note mode
     private int mMode;
 
-    private long mAlertDate;
-
-    private long mModifiedDate;
-
-    private int mBgColorId;
-
-    private int mWidgetId;
-
-    private int mWidgetType;
-
-    private long mFolderId;
-
-    private Context mContext;
+    private long mAlertDate;  // 提醒时间
+    private long mModifiedDate;  // 修改时间
+    private int mBgColorId;  // 背景颜色ID
+    private int mWidgetId;  // 小部件ID
+    private int mWidgetType;  // 小部件类型
+    private long mFolderId;  // 文件夹ID
+    private Context mContext;  // 上下文
+    private boolean mIsDeleted;  // 是否已删除
+    private NoteSettingChangedListener mNoteSettingStatusListener;  // 笔记设置变化监听器
 
     private static final String TAG = "WorkingNote";
 
-    private boolean mIsDeleted;
-
-    private NoteSettingChangedListener mNoteSettingStatusListener;
-
     public static final String[] DATA_PROJECTION = new String[] {
             DataColumns.ID,
             DataColumns.CONTENT,
@@ -174,6 +169,15 @@ public class WorkingNote {
         }
     }
 
+    /**
+     * 创建新的空笔记
+     * @param context 上下文
+     * @param folderId 文件夹ID
+     * @param widgetId 小部件ID
+     * @param widgetType 小部件类型
+     * @param defaultBgColorId 默认背景颜色ID
+     * @return 新创建的WorkingNote对象
+     */
     public static WorkingNote createEmptyNote(Context context, long folderId, int widgetId,
             int widgetType, int defaultBgColorId) {
         WorkingNote note = new WorkingNote(context, folderId);
@@ -183,10 +187,20 @@ public class WorkingNote {
         return note;
     }
 
+    /**
+     * 从数据库加载笔记
+     * @param context 上下文
+     * @param id 笔记ID
+     * @return 加载的WorkingNote对象
+     */
     public static WorkingNote load(Context context, long id) {
         return new WorkingNote(context, id, 0);
     }
 
+    /**
+     * 保存笔记到数据库
+     * @return 是否保存成功
+     */
     public synchronized boolean saveNote() {
         if (isWorthSaving()) {
             if (!existInDatabase()) {
@@ -199,7 +213,7 @@ public class WorkingNote {
             mNote.syncNote(mContext, mNoteId);
 
             /**
-             * Update widget content if there exist any widget of this note
+             * 如果笔记有关联的小部件，更新小部件内容
              */
             if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID
                     && mWidgetType != Notes.TYPE_WIDGET_INVALIDE
@@ -229,6 +243,11 @@ public class WorkingNote {
         mNoteSettingStatusListener = l;
     }
 
+    /**
+     * 设置提醒时间
+     * @param date 提醒时间戳
+     * @param set 是否设置提醒
+     */
     public void setAlertDate(long date, boolean set) {
         if (date != mAlertDate) {
             mAlertDate = date;
@@ -288,6 +307,11 @@ public class WorkingNote {
         }
     }
 
+    /**
+     * 将笔记转换为通话记录笔记
+     * @param phoneNumber 电话号码
+     * @param callDate 通话时间
+     */
     public void convertToCallNote(String phoneNumber, long callDate) {
         mNote.setCallData(CallNote.CALL_DATE, String.valueOf(callDate));
         mNote.setCallData(CallNote.PHONE_NUMBER, phoneNumber);

app/src/main/java/net/micode/notes/ui/NoteEditActivity.java

@@ -73,17 +73,20 @@ import java.util.Map;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
 
-
+/**
+ * NoteEditActivity 是笔记编辑界面的主要活动类
+ * 负责处理笔记的创建、编辑、保存等功能
+ */
 public class NoteEditActivity extends Activity implements OnClickListener,
         NoteSettingChangedListener, OnTextViewChangeListener {
+    /**
+     * 头部视图持有者类，用于管理笔记编辑界面的头部视图元素
+     */
     private class HeadViewHolder {
-        public TextView tvModified;
-
-        public ImageView ivAlertIcon;
-
-        public TextView tvAlertDate;
-
-        public ImageView ibSetBgColor;
+        public TextView tvModified;  // 显示修改时间
+        public ImageView ivAlertIcon;  // 提醒图标
+        public TextView tvAlertDate;  // 提醒时间
+        public ImageView ibSetBgColor;  // 设置背景颜色按钮
     }
 
     private static final Map<Integer, Integer> sBgSelectorBtnsMap = new HashMap<Integer, Integer>();
@@ -189,18 +192,19 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         }
     }
 
+    /**
+     * 初始化活动状态
+     * @param intent 启动活动的Intent
+     * @return 是否成功初始化
+     */
     private boolean initActivityState(Intent 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())) {
             long noteId = intent.getLongExtra(Intent.EXTRA_UID, 0);
             mUserQuery = "";
 
             /**
-             * Starting from the searched result
+             * 从搜索结果启动
              */
             if (intent.hasExtra(SearchManager.EXTRA_DATA_KEY)) {
                 noteId = Long.parseLong(intent.getStringExtra(SearchManager.EXTRA_DATA_KEY));
@@ -305,6 +309,10 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         showAlertHeader();
     }
 
+    /**
+     * 显示提醒头部信息
+     * 根据笔记的提醒时间显示相应的提醒信息
+     */
     private void showAlertHeader() {
         if (mWorkingNote.hasClockAlert()) {
             long time = System.currentTimeMillis();
@@ -611,6 +619,10 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         startActivity(intent);
     }
 
+    /**
+     * 删除当前笔记
+     * 如果笔记存在于数据库中，则将其移动到回收站或直接删除
+     */
     private void deleteCurrentNote() {
         if (mWorkingNote.existInDatabase()) {
             HashSet<Long> ids = new HashSet<Long>();
@@ -807,6 +819,10 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         }
     }
 
+    /**
+     * 获取当前编辑的文本内容
+     * @return 是否包含已勾选的项目
+     */
     private boolean getWorkingText() {
         boolean hasChecked = false;
         if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {
@@ -830,16 +846,21 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         return hasChecked;
     }
 
+    /**
+     * 保存笔记
+     * @return 是否保存成功
+     */
     private boolean saveNote() {
         getWorkingText();
         boolean saved = mWorkingNote.saveNote();
         if (saved) {
             /**
-             * There are two modes from List view to edit view, open one note,
-             * create/edit a node. Opening node requires to the original
-             * position in the list when back from edit view, while creating a
-             * new node requires to the top of the list. This code
-             * {@link #RESULT_OK} is used to identify the create/edit state
+             * 从列表视图到编辑视图有两种模式：
+             * 1. 打开一个笔记
+             * 2. 创建/编辑一个笔记
+             * 打开笔记需要返回到列表中的原始位置
+             * 创建新笔记需要返回到列表顶部
+             * 使用RESULT_OK来标识创建/编辑状态
              */
             setResult(RESULT_OK);
         }

app/src/main/java/net/micode/notes/ui/NotesListActivity.java

@@ -78,53 +78,45 @@ import java.io.InputStream;
 import java.io.InputStreamReader;
 import java.util.HashSet;
 
+/**
+ * NotesListActivity 是笔记列表界面的主要活动类
+ * 负责显示所有笔记的列表，并提供创建、编辑、删除笔记等功能
+ */
 public class NotesListActivity extends Activity implements OnClickListener, OnItemLongClickListener {
-    private static final int FOLDER_NOTE_LIST_QUERY_TOKEN = 0;
-
-    private static final int FOLDER_LIST_QUERY_TOKEN      = 1;
-
-    private static final int MENU_FOLDER_DELETE = 0;
-
-    private static final int MENU_FOLDER_VIEW = 1;
-
-    private static final int MENU_FOLDER_CHANGE_NAME = 2;
-
-    private static final String PREFERENCE_ADD_INTRODUCTION = "net.micode.notes.introduction";
-
+    private static final int FOLDER_NOTE_LIST_QUERY_TOKEN = 0;  // 文件夹笔记列表查询令牌
+    private static final int FOLDER_LIST_QUERY_TOKEN = 1;  // 文件夹列表查询令牌
+    private static final int MENU_FOLDER_DELETE = 0;  // 删除文件夹菜单项
+    private static final int MENU_FOLDER_VIEW = 1;  // 查看文件夹菜单项
+    private static final int MENU_FOLDER_CHANGE_NAME = 2;  // 修改文件夹名称菜单项
+    private static final String PREFERENCE_ADD_INTRODUCTION = "net.micode.notes.introduction";  // 是否添加介绍笔记的偏好设置键
+
+    /**
+     * 列表编辑状态枚举
+     */
     private enum ListEditState {
-        NOTE_LIST, SUB_FOLDER, CALL_RECORD_FOLDER
+        NOTE_LIST,  // 笔记列表
+        SUB_FOLDER,  // 子文件夹
+        CALL_RECORD_FOLDER  // 通话记录文件夹
     };
 
-    private ListEditState mState;
-
-    private BackgroundQueryHandler mBackgroundQueryHandler;
-
-    private NotesListAdapter mNotesListAdapter;
-
-    private ListView mNotesListView;
-
-    private Button mAddNewNote;
-
-    private boolean mDispatch;
-
-    private int mOriginY;
-
-    private int mDispatchY;
-
-    private TextView mTitleBar;
-
-    private long mCurrentFolderId;
-
-    private ContentResolver mContentResolver;
-
-    private ModeCallback mModeCallBack;
+    private ListEditState mState;  // 当前列表编辑状态
+    private BackgroundQueryHandler mBackgroundQueryHandler;  // 后台查询处理器
+    private NotesListAdapter mNotesListAdapter;  // 笔记列表适配器
+    private ListView mNotesListView;  // 笔记列表视图
+    private Button mAddNewNote;  // 添加新笔记按钮
+    private boolean mDispatch;  // 是否正在分发事件
+    private int mOriginY;  // 原始Y坐标
+    private int mDispatchY;  // 分发Y坐标
+    private TextView mTitleBar;  // 标题栏
+    private long mCurrentFolderId;  // 当前文件夹ID
+    private ContentResolver mContentResolver;  // 内容解析器
+    private ModeCallback mModeCallBack;  // 模式回调
+    private NoteItemData mFocusNoteDataItem;  // 当前焦点笔记数据项
 
     private static final String TAG = "NotesListActivity";
 
     public static final int NOTES_LISTVIEW_SCROLL_RATE = 30;
 
-    private NoteItemData mFocusNoteDataItem;
-
     private static final String NORMAL_SELECTION = NoteColumns.PARENT_ID + "=?";
 
     private static final String ROOT_FOLDER_SELECTION = "(" + NoteColumns.TYPE + "<>"
@@ -159,6 +151,10 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         }
     }
 
+    /**
+     * 从原始资源文件设置应用信息
+     * 用于首次启动时创建介绍笔记
+     */
     private void setAppInfoFromRawRes() {
         SharedPreferences sp = PreferenceManager.getDefaultSharedPreferences(this);
         if (!sp.getBoolean(PREFERENCE_ADD_INTRODUCTION, false)) {
@@ -211,6 +207,10 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         }
     }
 
+    /**
+     * 启动异步笔记列表查询
+     * 在活动启动时调用，用于加载笔记列表
+     */
     @Override
     protected void onStart() {
         super.onStart();