Merge pull request '背景更改功能完成' (#4) from yeah into master

src/main/java/net/micode/notes/gtask/data/MetaData.java

@@ -24,37 +24,64 @@ import net.micode.notes.tool.GTaskStringUtils;
 import org.json.JSONException;
 import org.json.JSONObject;
 
-
+/**
+ * 元数据管理类，用于处理与Google Task同步相关的元数据信息
+ * 继承自Task类，主要管理关联任务ID和元数据的存储与解析
+ */
 public class MetaData extends Task {
+    // 日志标签
     private final static String TAG = MetaData.class.getSimpleName();
 
+    // 关联的Google Task服务器ID
     private String mRelatedGid = null;
 
+    /**
+     * 设置元数据信息
+     * @param gid 关联的Google Task服务器ID
+     * @param metaInfo 需要存储的元数据JSON对象
+     * 将gid存入metaInfo后，序列化为字符串存储到notes字段
+     * 并设置固定名称标识为元数据笔记
+     */
     public void setMeta(String gid, JSONObject metaInfo) {
         try {
+            // 将关联的GTask ID注入元数据头部
             metaInfo.put(GTaskStringUtils.META_HEAD_GTASK_ID, gid);
         } catch (JSONException e) {
             Log.e(TAG, "failed to put related gid");
         }
+        // 序列化元数据到笔记内容字段
         setNotes(metaInfo.toString());
+        // 设置固定名称标识为元数据笔记
         setName(GTaskStringUtils.META_NOTE_NAME);
     }
 
+    /**
+     * 获取关联的GTask ID
+     */
     public String getRelatedGid() {
         return mRelatedGid;
     }
 
+    /**
+     * 判断是否需要保存（当notes字段有内容时需保存）
+     */
     @Override
     public boolean isWorthSaving() {
         return getNotes() != null;
     }
 
+    /**
+     * 通过远程JSON数据设置内容
+     * 解析notes字段中的元数据并提取关联的GTask ID
+     */
     @Override
     public void setContentByRemoteJSON(JSONObject js) {
         super.setContentByRemoteJSON(js);
         if (getNotes() != null) {
             try {
+                // 反序列化notes字段内容
                 JSONObject metaInfo = new JSONObject(getNotes().trim());
+                // 提取关联的GTask ID
                 mRelatedGid = metaInfo.getString(GTaskStringUtils.META_HEAD_GTASK_ID);
             } catch (JSONException e) {
                 Log.w(TAG, "failed to get related gid");
@@ -63,20 +90,32 @@ public class MetaData extends Task {
         }
     }
 
+    // 以下方法在元数据管理中不应被调用，直接抛出异常
+
+    /**
+     * 元数据不应通过本地JSON设置内容
+     * @throws IllegalAccessError 始终抛出，标识非法调用
+     */
     @Override
     public void setContentByLocalJSON(JSONObject js) {
-        // this function should not be called
         throw new IllegalAccessError("MetaData:setContentByLocalJSON should not be called");
     }
 
+    /**
+     * 元数据不需要生成本地JSON内容
+     * @throws IllegalAccessError 始终抛出，标识非法调用
+     */
     @Override
     public JSONObject getLocalJSONFromContent() {
         throw new IllegalAccessError("MetaData:getLocalJSONFromContent should not be called");
     }
 
+    /**
+     * 元数据不处理本地数据库同步操作
+     * @throws IllegalAccessError 始终抛出，标识非法调用
+     */
     @Override
     public int getSyncAction(Cursor c) {
         throw new IllegalAccessError("MetaData:getSyncAction should not be called");
     }
-
 }

src/main/java/net/micode/notes/gtask/data/Node.java

@@ -17,36 +17,48 @@
 package net.micode.notes.gtask.data;
 
 import android.database.Cursor;
-
 import org.json.JSONObject;
 
+/**
+ * 抽象节点基类，定义同步任务数据节点的通用属性和行为
+ * 作为所有同步实体（如笔记、任务、子任务等）的父类
+ * 包含同步动作类型定义和基础数据字段管理
+ */
 public abstract class Node {
+    // 同步动作类型常量
+    /** 无需同步操作 */
     public static final int SYNC_ACTION_NONE = 0;
-
+    /** 需要在远程服务器创建新条目 */
     public static final int SYNC_ACTION_ADD_REMOTE = 1;
-
+    /** 需要在本地数据库创建新条目 */
     public static final int SYNC_ACTION_ADD_LOCAL = 2;
-
+    /** 需要删除远程服务器条目 */
     public static final int SYNC_ACTION_DEL_REMOTE = 3;
-
+    /** 需要删除本地数据库条目 */
     public static final int SYNC_ACTION_DEL_LOCAL = 4;
-
+    /** 需要更新远程服务器条目 */
     public static final int SYNC_ACTION_UPDATE_REMOTE = 5;
-
+    /** 需要更新本地数据库条目 */
     public static final int SYNC_ACTION_UPDATE_LOCAL = 6;
-
+    /** 检测到数据冲突需要处理 */
     public static final int SYNC_ACTION_UPDATE_CONFLICT = 7;
-
+    /** 同步过程发生错误 */
     public static final int SYNC_ACTION_ERROR = 8;
 
+    // 节点基础属性
+    /** Google Task服务器分配的唯一标识符 */
     private String mGid;
-
+    /** 节点显示名称 */
     private String mName;
-
+    /** 最后修改时间戳（毫秒级） */
     private long mLastModified;
-
+    /** 删除标记（逻辑删除） */
     private boolean mDeleted;
 
+    /**
+     * 节点构造函数
+     * 初始化默认值：gid=null, 名称为空字符串，最后修改时间为0，未删除状态
+     */
     public Node() {
         mGid = null;
         mName = "";
@@ -54,48 +66,86 @@ public abstract class Node {
         mDeleted = false;
     }
 
+    // 抽象方法定义（需子类实现）
+
+    /**
+     * 生成创建动作的JSON数据包
+     * @param actionId 动作标识符（用于保证操作序列）
+     * @return 包含创建指令的JSON对象
+     */
     public abstract JSONObject getCreateAction(int actionId);
 
+    /**
+     * 生成更新动作的JSON数据包
+     * @param actionId 动作标识符
+     * @return 包含更新指令的JSON对象
+     */
     public abstract JSONObject getUpdateAction(int actionId);
 
+    /**
+     * 通过远程JSON数据设置节点内容
+     * @param js 来自服务器的JSON数据包
+     */
     public abstract void setContentByRemoteJSON(JSONObject js);
 
+    /**
+     * 通过本地JSON数据设置节点内容
+     * @param js 来自本地数据库的JSON数据
+     */
     public abstract void setContentByLocalJSON(JSONObject js);
 
+    /**
+     * 从节点内容生成本地JSON数据
+     * @return 可用于本地存储的JSON对象
+     */
     public abstract JSONObject getLocalJSONFromContent();
 
+    /**
+     * 根据数据库游标确定同步动作类型
+     * @param c 数据库查询结果游标
+     * @return 需要执行的同步动作类型（参考SYNC_ACTION常量）
+     */
     public abstract int getSyncAction(Cursor c);
 
+    // 属性访问方法
+
+    /** 设置Google Task服务器ID */
     public void setGid(String gid) {
         this.mGid = gid;
     }
 
+    /** 设置节点名称 */
     public void setName(String name) {
         this.mName = name;
     }
 
+    /** 设置最后修改时间戳 */
     public void setLastModified(long lastModified) {
         this.mLastModified = lastModified;
     }
 
+    /** 设置删除标记 */
     public void setDeleted(boolean deleted) {
         this.mDeleted = deleted;
     }
 
+    /** 获取Google Task服务器ID */
     public String getGid() {
         return this.mGid;
     }
 
+    /** 获取节点名称 */
     public String getName() {
         return this.mName;
     }
 
+    /** 获取最后修改时间戳 */
     public long getLastModified() {
         return this.mLastModified;
     }
 
+    /** 获取删除状态 */
     public boolean getDeleted() {
         return this.mDeleted;
     }
-
 }

src/main/java/net/micode/notes/gtask/data/SqlData.java

@@ -34,54 +34,65 @@ import net.micode.notes.gtask.exception.ActionFailureException;
 import org.json.JSONException;
 import org.json.JSONObject;
 
-
+/**
+ * 数据库数据操作封装类
+ * 负责处理与便笺数据表（Data表）的CRUD操作
+ * 封装数据字段的差异更新逻辑，支持事务性提交
+ */
 public class SqlData {
+    // 日志标签
     private static final String TAG = SqlData.class.getSimpleName();
 
+    // 无效ID标识（用于新建条目）
     private static final int INVALID_ID = -99999;
 
+    // 数据表查询字段投影（对应DATA表的列）
     public static final String[] PROJECTION_DATA = new String[] {
-            DataColumns.ID, DataColumns.MIME_TYPE, DataColumns.CONTENT, DataColumns.DATA1,
-            DataColumns.DATA3
+            DataColumns.ID,           // 0:数据ID
+            DataColumns.MIME_TYPE,    // 1:MIME类型
+            DataColumns.CONTENT,      // 2:内容主体（JSON格式）
+            DataColumns.DATA1,        // 3:扩展数据1（长整型）
+            DataColumns.DATA3        // 4:扩展数据3（字符串）
     };
 
+    // 投影字段索引常量
     public static final int DATA_ID_COLUMN = 0;
-
     public static final int DATA_MIME_TYPE_COLUMN = 1;
-
     public static final int DATA_CONTENT_COLUMN = 2;
-
     public static final int DATA_CONTENT_DATA_1_COLUMN = 3;
-
     public static final int DATA_CONTENT_DATA_3_COLUMN = 4;
 
-    private ContentResolver mContentResolver;
-
-    private boolean mIsCreate;
-
-    private long mDataId;
-
-    private String mDataMimeType;
-
-    private String mDataContent;
-
-    private long mDataContentData1;
-
-    private String mDataContentData3;
-
-    private ContentValues mDiffDataValues;
-
+    // 成员变量
+    private ContentResolver mContentResolver; // 内容解析器（用于数据库操作）
+    private boolean mIsCreate;                // 新建数据条目标识
+    private long mDataId;                     // 当前数据ID
+    private String mDataMimeType;             // MIME类型（默认NOTE类型）
+    private String mDataContent;              // 内容主体
+    private long mDataContentData1;           // 扩展数据1（长整型字段）
+    private String mDataContentData3;         // 扩展数据3（字符串字段）
+    private ContentValues mDiffDataValues;    // 差异字段集合（用于批量更新）
+
+    /**
+     * 新建数据构造函数
+     * @param context 上下文对象（用于获取ContentResolver）
+     */
     public SqlData(Context context) {
         mContentResolver = context.getContentResolver();
         mIsCreate = true;
+        // 初始化默认值
         mDataId = INVALID_ID;
-        mDataMimeType = DataConstants.NOTE;
+        mDataMimeType = DataConstants.NOTE; // 默认MIME类型为便笺
         mDataContent = "";
         mDataContentData1 = 0;
         mDataContentData3 = "";
         mDiffDataValues = new ContentValues();
     }
 
+    /**
+     * 从数据库游标构造（用于加载已有数据）
+     * @param context 上下文对象
+     * @param c 数据库查询结果游标
+     */
     public SqlData(Context context, Cursor c) {
         mContentResolver = context.getContentResolver();
         mIsCreate = false;
@@ -89,6 +100,10 @@ public class SqlData {
         mDiffDataValues = new ContentValues();
     }
 
+    /**
+     * 从游标加载数据到成员变量
+     * @param c 已定位到正确位置的数据库游标
+     */
     private void loadFromCursor(Cursor c) {
         mDataId = c.getLong(DATA_ID_COLUMN);
         mDataMimeType = c.getString(DATA_MIME_TYPE_COLUMN);
@@ -97,13 +112,21 @@ public class SqlData {
         mDataContentData3 = c.getString(DATA_CONTENT_DATA_3_COLUMN);
     }
 
+    /**
+     * 通过JSON对象设置数据内容
+     * @param js 包含数据字段的JSON对象
+     * @throws JSONException JSON解析异常
+     * 说明：自动记录变化的字段，用于后续差异更新
+     */
     public void setContent(JSONObject js) throws JSONException {
+        // 处理数据ID字段
         long dataId = js.has(DataColumns.ID) ? js.getLong(DataColumns.ID) : INVALID_ID;
         if (mIsCreate || mDataId != dataId) {
             mDiffDataValues.put(DataColumns.ID, dataId);
         }
         mDataId = dataId;
 
+        // 处理MIME类型字段
         String dataMimeType = js.has(DataColumns.MIME_TYPE) ? js.getString(DataColumns.MIME_TYPE)
                 : DataConstants.NOTE;
         if (mIsCreate || !mDataMimeType.equals(dataMimeType)) {
@@ -111,18 +134,21 @@ public class SqlData {
         }
         mDataMimeType = dataMimeType;
 
+        // 处理内容主体字段
         String dataContent = js.has(DataColumns.CONTENT) ? js.getString(DataColumns.CONTENT) : "";
         if (mIsCreate || !mDataContent.equals(dataContent)) {
             mDiffDataValues.put(DataColumns.CONTENT, dataContent);
         }
         mDataContent = dataContent;
 
+        // 处理扩展数据1（长整型）
         long dataContentData1 = js.has(DataColumns.DATA1) ? js.getLong(DataColumns.DATA1) : 0;
         if (mIsCreate || mDataContentData1 != dataContentData1) {
             mDiffDataValues.put(DataColumns.DATA1, dataContentData1);
         }
         mDataContentData1 = dataContentData1;
 
+        // 处理扩展数据3（字符串）
         String dataContentData3 = js.has(DataColumns.DATA3) ? js.getString(DataColumns.DATA3) : "";
         if (mIsCreate || !mDataContentData3.equals(dataContentData3)) {
             mDiffDataValues.put(DataColumns.DATA3, dataContentData3);
@@ -130,6 +156,12 @@ public class SqlData {
         mDataContentData3 = dataContentData3;
     }
 
+    /**
+     * 获取当前数据的JSON表示
+     * @return 包含所有数据字段的JSON对象
+     * @throws JSONException JSON构造异常
+     * 注意：新建对象（未提交）调用此方法将返回null
+     */
     public JSONObject getContent() throws JSONException {
         if (mIsCreate) {
             Log.e(TAG, "it seems that we haven't created this in database yet");
@@ -144,34 +176,59 @@ public class SqlData {
         return js;
     }
 
+    /**
+     * 提交数据变更到数据库
+     * @param noteId 关联的便笺ID
+     * @param validateVersion 是否进行版本验证
+     * @param version 当前数据版本（用于乐观锁）
+     * @throws ActionFailureException 数据库操作失败时抛出
+     *
+     * 执行逻辑：
+     * 1. 新建模式：插入新记录并获取分配的ID
+     * 2. 更新模式：根据差异字段进行更新
+     *    - 带版本验证的更新可防止同步冲突
+     */
     public void commit(long noteId, boolean validateVersion, long version) {
-
         if (mIsCreate) {
+            // 新建数据处理
             if (mDataId == INVALID_ID && mDiffDataValues.containsKey(DataColumns.ID)) {
-                mDiffDataValues.remove(DataColumns.ID);
+                mDiffDataValues.remove(DataColumns.ID); // 移除无效ID
             }
 
+            // 添加关联便笺ID
             mDiffDataValues.put(DataColumns.NOTE_ID, noteId);
+
+            // 执行插入操作
             Uri uri = mContentResolver.insert(Notes.CONTENT_DATA_URI, mDiffDataValues);
             try {
+                // 从返回URI中解析新分配的ID
                 mDataId = Long.valueOf(uri.getPathSegments().get(1));
             } catch (NumberFormatException e) {
                 Log.e(TAG, "Get note id error :" + e.toString());
                 throw new ActionFailureException("create note failed");
             }
         } else {
+            // 更新数据处理
             if (mDiffDataValues.size() > 0) {
                 int result = 0;
                 if (!validateVersion) {
-                    result = mContentResolver.update(ContentUris.withAppendedId(
-                            Notes.CONTENT_DATA_URI, mDataId), mDiffDataValues, null, null);
+                    // 普通更新
+                    result = mContentResolver.update(
+                            ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, mDataId),
+                            mDiffDataValues,
+                            null,
+                            null
+                    );
                 } else {
-                    result = mContentResolver.update(ContentUris.withAppendedId(
-                            Notes.CONTENT_DATA_URI, mDataId), mDiffDataValues,
+                    // 带版本验证的更新（防止同步冲突）
+                    result = mContentResolver.update(
+                            ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, mDataId),
+                            mDiffDataValues,
+                            // 使用子查询确保版本匹配
                             " ? in (SELECT " + NoteColumns.ID + " FROM " + TABLE.NOTE
-                                    + " WHERE " + NoteColumns.VERSION + "=?)", new String[] {
-                                    String.valueOf(noteId), String.valueOf(version)
-                            });
+                                    + " WHERE " + NoteColumns.VERSION + "=?)",
+                            new String[] { String.valueOf(noteId), String.valueOf(version) }
+                    );
                 }
                 if (result == 0) {
                     Log.w(TAG, "there is no update. maybe user updates note when syncing");
@@ -179,10 +236,15 @@ public class SqlData {
             }
         }
 
+        // 重置状态
         mDiffDataValues.clear();
         mIsCreate = false;
     }
 
+    /**
+     * 获取当前数据ID
+     * @return 有效数据ID，新建对象提交前返回INVALID_ID
+     */
     public long getId() {
         return mDataId;
     }

src/main/java/net/micode/notes/gtask/data/SqlNote.java

@@ -37,12 +37,15 @@ import org.json.JSONObject;
 
 import java.util.ArrayList;
 
-
+// SqlNote类用于处理便签数据的存储和操作，包括数据的加载、设置、获取和提交等操作。
 public class SqlNote {
+    // 日志标签，用于调试和日志记录
     private static final String TAG = SqlNote.class.getSimpleName();
 
+    // 无效ID的常量值
     private static final int INVALID_ID = -99999;
 
+    // 定义查询便签时需要的列
     public static final String[] PROJECTION_NOTE = new String[] {
             NoteColumns.ID, NoteColumns.ALERTED_DATE, NoteColumns.BG_COLOR_ID,
             NoteColumns.CREATED_DATE, NoteColumns.HAS_ATTACHMENT, NoteColumns.MODIFIED_DATE,
@@ -52,76 +55,80 @@ public class SqlNote {
             NoteColumns.VERSION
     };
 
+    // 定义PROJECTION_NOTE中各列的索引
     public static final int ID_COLUMN = 0;
-
     public static final int ALERTED_DATE_COLUMN = 1;
-
     public static final int BG_COLOR_ID_COLUMN = 2;
-
     public static final int CREATED_DATE_COLUMN = 3;
-
     public static final int HAS_ATTACHMENT_COLUMN = 4;
-
     public static final int MODIFIED_DATE_COLUMN = 5;
-
     public static final int NOTES_COUNT_COLUMN = 6;
-
     public static final int PARENT_ID_COLUMN = 7;
-
     public static final int SNIPPET_COLUMN = 8;
-
     public static final int TYPE_COLUMN = 9;
-
     public static final int WIDGET_ID_COLUMN = 10;
-
     public static final int WIDGET_TYPE_COLUMN = 11;
-
     public static final int SYNC_ID_COLUMN = 12;
-
     public static final int LOCAL_MODIFIED_COLUMN = 13;
-
     public static final int ORIGIN_PARENT_ID_COLUMN = 14;
-
     public static final int GTASK_ID_COLUMN = 15;
-
     public static final int VERSION_COLUMN = 16;
 
+    // 上下文环境，用于访问应用程序资源和数据库
     private Context mContext;
 
+    // 内容解析器，用于与内容提供器进行交互
     private ContentResolver mContentResolver;
 
+    // 标志位，表示该便签是否是新创建的
     private boolean mIsCreate;
 
+    // 便签的唯一标识符
     private long mId;
 
+    // 便签的提醒日期
     private long mAlertDate;
 
+    // 便签的背景颜色标识符
     private int mBgColorId;
 
+    // 便签的创建日期
     private long mCreatedDate;
 
+    // 标志位，表示便签是否包含附件
     private int mHasAttachment;
 
+    // 便签的最后修改日期
     private long mModifiedDate;
 
+    // 便签的父便签标识符
     private long mParentId;
 
+    // 便签的简短摘要或标题
     private String mSnippet;
 
+    // 便签的类型（如普通便签、文件夹、系统文件夹等）
     private int mType;
 
+    // 与便签关联的小部件标识符
     private int mWidgetId;
 
+    // 便签的小部件类型
     private int mWidgetType;
 
+    // 便签的原始父便签标识符
     private long mOriginParent;
 
+    // 便签的版本号，用于数据同步和冲突检测
     private long mVersion;
 
+    // 用于存储便签属性的更改，以便后续提交到数据库
     private ContentValues mDiffNoteValues;
 
+    // 存储与便签相关的数据内容列表
     private ArrayList<SqlData> mDataList;
 
+    // 构造方法，创建一个新的SqlNote对象，初始化成员变量，并设置默认值
     public SqlNote(Context context) {
         mContext = context;
         mContentResolver = context.getContentResolver();
@@ -143,6 +150,7 @@ public class SqlNote {
         mDataList = new ArrayList<SqlData>();
     }
 
+    // 构造方法，从数据库游标中加载便签数据，初始化SqlNote对象
     public SqlNote(Context context, Cursor c) {
         mContext = context;
         mContentResolver = context.getContentResolver();
@@ -154,6 +162,7 @@ public class SqlNote {
         mDiffNoteValues = new ContentValues();
     }
 
+    // 构造方法，根据便签ID从数据库中加载便签数据，初始化SqlNote对象
     public SqlNote(Context context, long id) {
         mContext = context;
         mContentResolver = context.getContentResolver();
@@ -163,9 +172,9 @@ public class SqlNote {
         if (mType == Notes.TYPE_NOTE)
             loadDataContent();
         mDiffNoteValues = new ContentValues();
-
     }
 
+    // 根据便签ID从数据库中查询便签数据，并加载到当前对象中
     private void loadFromCursor(long id) {
         Cursor c = null;
         try {
@@ -185,6 +194,7 @@ public class SqlNote {
         }
     }
 
+    // 从数据库游标中加载便签数据到当前对象中
     private void loadFromCursor(Cursor c) {
         mId = c.getLong(ID_COLUMN);
         mAlertDate = c.getLong(ALERTED_DATE_COLUMN);
@@ -200,6 +210,7 @@ public class SqlNote {
         mVersion = c.getLong(VERSION_COLUMN);
     }
 
+    // 加载与当前便签相关的数据内容
     private void loadDataContent() {
         Cursor c = null;
         mDataList.clear();
@@ -226,13 +237,14 @@ public class SqlNote {
         }
     }
 
+    // 从JSON对象中设置便签的内容和属性
     public boolean setContent(JSONObject js) {
         try {
             JSONObject note = js.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
             if (note.getInt(NoteColumns.TYPE) == Notes.TYPE_SYSTEM) {
                 Log.w(TAG, "cannot set system folder");
             } else if (note.getInt(NoteColumns.TYPE) == Notes.TYPE_FOLDER) {
-                // for folder we can only update the snnipet and type
+                // 对于文件夹，我们只能更新摘要和类型
                 String snippet = note.has(NoteColumns.SNIPPET) ? note
                         .getString(NoteColumns.SNIPPET) : "";
                 if (mIsCreate || !mSnippet.equals(snippet)) {
@@ -248,7 +260,8 @@ public class SqlNote {
                 mType = type;
             } else if (note.getInt(NoteColumns.TYPE) == Notes.TYPE_NOTE) {
                 JSONArray dataArray = js.getJSONArray(GTaskStringUtils.META_HEAD_DATA);
-                long id = note.has(NoteColumns.ID) ? note.getLong(NoteColumns.ID) : INVALID_ID;
+                long id = note.has(NoteColumns.ID) ? note
+                        .getLong(NoteColumns.ID) : INVALID_ID;
                 if (mIsCreate || mId != id) {
                     mDiffNoteValues.put(NoteColumns.ID, id);
                 }
@@ -359,6 +372,7 @@ public class SqlNote {
         return true;
     }
 
+    // 将便签的内容和属性转换为JSON对象
     public JSONObject getContent() {
         try {
             JSONObject js = new JSONObject();
@@ -407,39 +421,48 @@ public class SqlNote {
         return null;
     }
 
+    // 设置便签的父便签标识符
     public void setParentId(long id) {
         mParentId = id;
         mDiffNoteValues.put(NoteColumns.PARENT_ID, id);
     }
 
+    // 设置便签的Gtask ID
     public void setGtaskId(String gid) {
         mDiffNoteValues.put(NoteColumns.GTASK_ID, gid);
     }
 
+    // 设置便签的同步ID
     public void setSyncId(long syncId) {
         mDiffNoteValues.put(NoteColumns.SYNC_ID, syncId);
     }
 
+    // 重置便签的本地修改标志
     public void resetLocalModified() {
         mDiffNoteValues.put(NoteColumns.LOCAL_MODIFIED, 0);
     }
 
+    // 获取便签的唯一标识符
     public long getId() {
         return mId;
     }
 
+    // 获取便签的父便签标识符
     public long getParentId() {
         return mParentId;
     }
 
+    // 获取便签的简短摘要或标题
     public String getSnippet() {
         return mSnippet;
     }
 
+    // 判断便签是否为普通便签类型
     public boolean isNoteType() {
         return mType == Notes.TYPE_NOTE;
     }
 
+    // 将便签的更改提交到数据库，包括插入新便签或更新现有便签，并处理数据同步和冲突检测
     public void commit(boolean validateVersion) {
         if (mIsCreate) {
             if (mId == INVALID_ID && mDiffNoteValues.containsKey(NoteColumns.ID)) {
@@ -494,7 +517,7 @@ public class SqlNote {
             }
         }
 
-        // refresh local info
+        // 刷新本地信息
         loadFromCursor(mId);
         if (mType == Notes.TYPE_NOTE)
             loadDataContent();

src/main/java/net/micode/notes/gtask/data/Task.java

@@ -31,20 +31,27 @@ import org.json.JSONArray;
 import org.json.JSONException;
 import org.json.JSONObject;
 
-
+// Task类继承自Node类，用于处理任务相关的操作，包括创建、更新、同步等
 public class Task extends Node {
+    // 日志标签，用于调试和日志记录
     private static final String TAG = Task.class.getSimpleName();
 
+    // 标志位，表示任务是否已完成
     private boolean mCompleted;
 
+    // 任务的备注信息
     private String mNotes;
 
+    // 任务的元数据信息
     private JSONObject mMetaInfo;
 
+    // 任务的前一个兄弟任务
     private Task mPriorSibling;
 
+    // 任务所属的任务列表
     private TaskList mParent;
 
+    // 构造方法，初始化任务对象
     public Task() {
         super();
         mCompleted = false;
@@ -54,21 +61,22 @@ public class Task extends Node {
         mMetaInfo = null;
     }
 
+    // 生成创建任务的JSON对象，用于与服务器交互
     public JSONObject getCreateAction(int actionId) {
         JSONObject js = new JSONObject();
 
         try {
-            // action_type
+            // 设置操作类型为创建
             js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
                     GTaskStringUtils.GTASK_JSON_ACTION_TYPE_CREATE);
 
-            // action_id
+            // 设置操作ID
             js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId);
 
-            // index
+            // 设置任务在父任务列表中的索引
             js.put(GTaskStringUtils.GTASK_JSON_INDEX, mParent.getChildTaskIndex(this));
 
-            // entity_delta
+            // 设置任务的基本信息
             JSONObject entity = new JSONObject();
             entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName());
             entity.put(GTaskStringUtils.GTASK_JSON_CREATOR_ID, "null");
@@ -79,17 +87,17 @@ public class Task extends Node {
             }
             js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity);
 
-            // parent_id
+            // 设置父任务列表的ID
             js.put(GTaskStringUtils.GTASK_JSON_PARENT_ID, mParent.getGid());
 
-            // dest_parent_type
+            // 设置目标父类型
             js.put(GTaskStringUtils.GTASK_JSON_DEST_PARENT_TYPE,
                     GTaskStringUtils.GTASK_JSON_TYPE_GROUP);
 
-            // list_id
+            // 设置列表ID
             js.put(GTaskStringUtils.GTASK_JSON_LIST_ID, mParent.getGid());
 
-            // prior_sibling_id
+            // 设置前一个兄弟任务的ID（如果存在）
             if (mPriorSibling != null) {
                 js.put(GTaskStringUtils.GTASK_JSON_PRIOR_SIBLING_ID, mPriorSibling.getGid());
             }
@@ -103,21 +111,22 @@ public class Task extends Node {
         return js;
     }
 
+    // 生成更新任务的JSON对象，用于与服务器交互
     public JSONObject getUpdateAction(int actionId) {
         JSONObject js = new JSONObject();
 
         try {
-            // action_type
+            // 设置操作类型为更新
             js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
                     GTaskStringUtils.GTASK_JSON_ACTION_TYPE_UPDATE);
 
-            // action_id
+            // 设置操作ID
             js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId);
 
-            // id
+            // 设置任务ID
             js.put(GTaskStringUtils.GTASK_JSON_ID, getGid());
 
-            // entity_delta
+            // 设置任务的更新信息
             JSONObject entity = new JSONObject();
             entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName());
             if (getNotes() != null) {
@@ -135,35 +144,36 @@ public class Task extends Node {
         return js;
     }
 
+    // 从远程JSON对象中设置任务内容
     public void setContentByRemoteJSON(JSONObject js) {
         if (js != null) {
             try {
-                // id
+                // 设置任务ID
                 if (js.has(GTaskStringUtils.GTASK_JSON_ID)) {
                     setGid(js.getString(GTaskStringUtils.GTASK_JSON_ID));
                 }
 
-                // last_modified
+                // 设置最后修改时间
                 if (js.has(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED)) {
                     setLastModified(js.getLong(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED));
                 }
 
-                // name
+                // 设置任务名称
                 if (js.has(GTaskStringUtils.GTASK_JSON_NAME)) {
                     setName(js.getString(GTaskStringUtils.GTASK_JSON_NAME));
                 }
 
-                // notes
+                // 设置任务备注
                 if (js.has(GTaskStringUtils.GTASK_JSON_NOTES)) {
                     setNotes(js.getString(GTaskStringUtils.GTASK_JSON_NOTES));
                 }
 
-                // deleted
+                // 设置任务是否已删除
                 if (js.has(GTaskStringUtils.GTASK_JSON_DELETED)) {
                     setDeleted(js.getBoolean(GTaskStringUtils.GTASK_JSON_DELETED));
                 }
 
-                // completed
+                // 设置任务是否已完成
                 if (js.has(GTaskStringUtils.GTASK_JSON_COMPLETED)) {
                     setCompleted(js.getBoolean(GTaskStringUtils.GTASK_JSON_COMPLETED));
                 }
@@ -175,21 +185,25 @@ public class Task extends Node {
         }
     }
 
+    // 从本地JSON对象中设置任务内容
     public void setContentByLocalJSON(JSONObject js) {
         if (js == null || !js.has(GTaskStringUtils.META_HEAD_NOTE)
                 || !js.has(GTaskStringUtils.META_HEAD_DATA)) {
-            Log.w(TAG, "setContentByLocalJSON: nothing is avaiable");
+            Log.w(TAG, "setContentByLocalJSON: nothing is available");
         }
 
         try {
+            // 获取任务的元数据
             JSONObject note = js.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
             JSONArray dataArray = js.getJSONArray(GTaskStringUtils.META_HEAD_DATA);
 
+            // 检查任务类型是否为普通任务
             if (note.getInt(NoteColumns.TYPE) != Notes.TYPE_NOTE) {
                 Log.e(TAG, "invalid type");
                 return;
             }
 
+            // 设置任务内容
             for (int i = 0; i < dataArray.length(); i++) {
                 JSONObject data = dataArray.getJSONObject(i);
                 if (TextUtils.equals(data.getString(DataColumns.MIME_TYPE), DataConstants.NOTE)) {
@@ -204,16 +218,18 @@ public class Task extends Node {
         }
     }
 
+    // 从任务内容生成本地JSON对象
     public JSONObject getLocalJSONFromContent() {
         String name = getName();
         try {
             if (mMetaInfo == null) {
-                // new task created from web
+                // 新创建的任务
                 if (name == null) {
                     Log.w(TAG, "the note seems to be an empty one");
                     return null;
                 }
 
+                // 创建JSON对象
                 JSONObject js = new JSONObject();
                 JSONObject note = new JSONObject();
                 JSONArray dataArray = new JSONArray();
@@ -225,10 +241,11 @@ public class Task extends Node {
                 js.put(GTaskStringUtils.META_HEAD_NOTE, note);
                 return js;
             } else {
-                // synced task
+                // 已同步的任务
                 JSONObject note = mMetaInfo.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
                 JSONArray dataArray = mMetaInfo.getJSONArray(GTaskStringUtils.META_HEAD_DATA);
 
+                // 更新任务内容
                 for (int i = 0; i < dataArray.length(); i++) {
                     JSONObject data = dataArray.getJSONObject(i);
                     if (TextUtils.equals(data.getString(DataColumns.MIME_TYPE), DataConstants.NOTE)) {
@@ -247,6 +264,7 @@ public class Task extends Node {
         }
     }
 
+    // 设置任务的元数据信息
     public void setMetaInfo(MetaData metaData) {
         if (metaData != null && metaData.getNotes() != null) {
             try {
@@ -258,6 +276,7 @@ public class Task extends Node {
         }
     }
 
+    // 根据游标数据确定同步操作类型
     public int getSyncAction(Cursor c) {
         try {
             JSONObject noteInfo = null;
@@ -275,31 +294,32 @@ public class Task extends Node {
                 return SYNC_ACTION_UPDATE_LOCAL;
             }
 
-            // validate the note id now
+            // 验证任务ID是否匹配
             if (c.getLong(SqlNote.ID_COLUMN) != noteInfo.getLong(NoteColumns.ID)) {
                 Log.w(TAG, "note id doesn't match");
                 return SYNC_ACTION_UPDATE_LOCAL;
             }
 
             if (c.getInt(SqlNote.LOCAL_MODIFIED_COLUMN) == 0) {
-                // there is no local update
+                // 本地没有修改
                 if (c.getLong(SqlNote.SYNC_ID_COLUMN) == getLastModified()) {
-                    // no update both side
+                    // 两边都没有更新
                     return SYNC_ACTION_NONE;
                 } else {
-                    // apply remote to local
+                    // 应用远程到本地
                     return SYNC_ACTION_UPDATE_LOCAL;
                 }
             } else {
-                // validate gtask id
+                // 验证Gtask ID是否匹配
                 if (!c.getString(SqlNote.GTASK_ID_COLUMN).equals(getGid())) {
                     Log.e(TAG, "gtask id doesn't match");
                     return SYNC_ACTION_ERROR;
                 }
                 if (c.getLong(SqlNote.SYNC_ID_COLUMN) == getLastModified()) {
-                    // local modification only
+                    // 只有本地修改
                     return SYNC_ACTION_UPDATE_REMOTE;
                 } else {
+                    // 同步冲突
                     return SYNC_ACTION_UPDATE_CONFLICT;
                 }
             }
@@ -311,41 +331,49 @@ public class Task extends Node {
         return SYNC_ACTION_ERROR;
     }
 
+    // 判断任务是否值得保存
     public boolean isWorthSaving() {
         return mMetaInfo != null || (getName() != null && getName().trim().length() > 0)
                 || (getNotes() != null && getNotes().trim().length() > 0);
     }
 
+    // 设置任务是否已完成
     public void setCompleted(boolean completed) {
         this.mCompleted = completed;
     }
 
+    // 设置任务备注
     public void setNotes(String notes) {
         this.mNotes = notes;
     }
 
+    // 设置任务的前一个兄弟任务
     public void setPriorSibling(Task priorSibling) {
         this.mPriorSibling = priorSibling;
     }
 
+    // 设置任务所属的任务列表
     public void setParent(TaskList parent) {
         this.mParent = parent;
     }
 
+    // 获取任务是否已完成
     public boolean getCompleted() {
         return this.mCompleted;
     }
 
+    // 获取任务备注
     public String getNotes() {
         return this.mNotes;
     }
 
+    // 获取任务的前一个兄弟任务
     public Task getPriorSibling() {
         return this.mPriorSibling;
     }
 
+    // 获取任务所属的任务列表
     public TaskList getParent() {
         return this.mParent;
     }
-
 }

src/main/java/net/micode/notes/gtask/data/TaskList.java

@@ -29,35 +29,40 @@ import org.json.JSONObject;
 
 import java.util.ArrayList;
 
-
+// TaskList类继承自Node类，用于管理任务列表及其子任务
 public class TaskList extends Node {
+    // 日志标签，用于调试和日志记录
     private static final String TAG = TaskList.class.getSimpleName();
 
+    // 任务列表的索引
     private int mIndex;
 
+    // 子任务列表
     private ArrayList<Task> mChildren;
 
+    // 构造方法，初始化任务列表
     public TaskList() {
         super();
         mChildren = new ArrayList<Task>();
         mIndex = 1;
     }
 
+    // 生成创建任务列表的JSON对象，用于与服务器交互
     public JSONObject getCreateAction(int actionId) {
         JSONObject js = new JSONObject();
 
         try {
-            // action_type
+            // 设置操作类型为创建
             js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
                     GTaskStringUtils.GTASK_JSON_ACTION_TYPE_CREATE);
 
-            // action_id
+            // 设置操作ID
             js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId);
 
-            // index
+            // 设置任务列表的索引
             js.put(GTaskStringUtils.GTASK_JSON_INDEX, mIndex);
 
-            // entity_delta
+            // 设置任务列表的基本信息
             JSONObject entity = new JSONObject();
             entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName());
             entity.put(GTaskStringUtils.GTASK_JSON_CREATOR_ID, "null");
@@ -74,21 +79,22 @@ public class TaskList extends Node {
         return js;
     }
 
+    // 生成更新任务列表的JSON对象，用于与服务器交互
     public JSONObject getUpdateAction(int actionId) {
         JSONObject js = new JSONObject();
 
         try {
-            // action_type
+            // 设置操作类型为更新
             js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
                     GTaskStringUtils.GTASK_JSON_ACTION_TYPE_UPDATE);
 
-            // action_id
+            // 设置操作ID
             js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId);
 
-            // id
+            // 设置任务列表ID
             js.put(GTaskStringUtils.GTASK_JSON_ID, getGid());
 
-            // entity_delta
+            // 设置任务列表的更新信息
             JSONObject entity = new JSONObject();
             entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName());
             entity.put(GTaskStringUtils.GTASK_JSON_DELETED, getDeleted());
@@ -103,20 +109,21 @@ public class TaskList extends Node {
         return js;
     }
 
+    // 从远程JSON对象中设置任务列表内容
     public void setContentByRemoteJSON(JSONObject js) {
         if (js != null) {
             try {
-                // id
+                // 设置任务列表ID
                 if (js.has(GTaskStringUtils.GTASK_JSON_ID)) {
                     setGid(js.getString(GTaskStringUtils.GTASK_JSON_ID));
                 }
 
-                // last_modified
+                // 设置最后修改时间
                 if (js.has(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED)) {
                     setLastModified(js.getLong(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED));
                 }
 
-                // name
+                // 设置任务列表名称
                 if (js.has(GTaskStringUtils.GTASK_JSON_NAME)) {
                     setName(js.getString(GTaskStringUtils.GTASK_JSON_NAME));
                 }
@@ -129,14 +136,17 @@ public class TaskList extends Node {
         }
     }
 
+    // 从本地JSON对象中设置任务列表内容
     public void setContentByLocalJSON(JSONObject js) {
         if (js == null || !js.has(GTaskStringUtils.META_HEAD_NOTE)) {
-            Log.w(TAG, "setContentByLocalJSON: nothing is avaiable");
+            Log.w(TAG, "setContentByLocalJSON: nothing is available");
         }
 
         try {
+            // 获取任务列表的元数据
             JSONObject folder = js.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
 
+            // 根据任务列表类型设置名称
             if (folder.getInt(NoteColumns.TYPE) == Notes.TYPE_FOLDER) {
                 String name = folder.getString(NoteColumns.SNIPPET);
                 setName(GTaskStringUtils.MIUI_FOLDER_PREFFIX + name);
@@ -157,11 +167,13 @@ public class TaskList extends Node {
         }
     }
 
+    // 从任务列表内容生成本地JSON对象
     public JSONObject getLocalJSONFromContent() {
         try {
             JSONObject js = new JSONObject();
             JSONObject folder = new JSONObject();
 
+            // 获取任务列表名称
             String folderName = getName();
             if (getName().startsWith(GTaskStringUtils.MIUI_FOLDER_PREFFIX))
                 folderName = folderName.substring(GTaskStringUtils.MIUI_FOLDER_PREFFIX.length(),
@@ -183,28 +195,29 @@ public class TaskList extends Node {
         }
     }
 
+    // 根据游标数据确定同步操作类型
     public int getSyncAction(Cursor c) {
         try {
             if (c.getInt(SqlNote.LOCAL_MODIFIED_COLUMN) == 0) {
-                // there is no local update
+                // 本地没有修改
                 if (c.getLong(SqlNote.SYNC_ID_COLUMN) == getLastModified()) {
-                    // no update both side
+                    // 两边都没有更新
                     return SYNC_ACTION_NONE;
                 } else {
-                    // apply remote to local
+                    // 应用远程到本地
                     return SYNC_ACTION_UPDATE_LOCAL;
                 }
             } else {
-                // validate gtask id
+                // 验证Gtask ID是否匹配
                 if (!c.getString(SqlNote.GTASK_ID_COLUMN).equals(getGid())) {
                     Log.e(TAG, "gtask id doesn't match");
                     return SYNC_ACTION_ERROR;
                 }
                 if (c.getLong(SqlNote.SYNC_ID_COLUMN) == getLastModified()) {
-                    // local modification only
+                    // 只有本地修改
                     return SYNC_ACTION_UPDATE_REMOTE;
                 } else {
-                    // for folder conflicts, just apply local modification
+                    // 对于文件夹冲突，仅应用本地修改
                     return SYNC_ACTION_UPDATE_REMOTE;
                 }
             }
@@ -216,16 +229,18 @@ public class TaskList extends Node {
         return SYNC_ACTION_ERROR;
     }
 
+    // 获取子任务数量
     public int getChildTaskCount() {
         return mChildren.size();
     }
 
+    // 添加子任务到任务列表
     public boolean addChildTask(Task task) {
         boolean ret = false;
         if (task != null && !mChildren.contains(task)) {
             ret = mChildren.add(task);
             if (ret) {
-                // need to set prior sibling and parent
+                // 设置子任务的前一个兄弟任务和父任务列表
                 task.setPriorSibling(mChildren.isEmpty() ? null : mChildren
                         .get(mChildren.size() - 1));
                 task.setParent(this);
@@ -234,6 +249,7 @@ public class TaskList extends Node {
         return ret;
     }
 
+    // 在指定位置添加子任务
     public boolean addChildTask(Task task, int index) {
         if (index < 0 || index > mChildren.size()) {
             Log.e(TAG, "add child task: invalid index");
@@ -244,7 +260,7 @@ public class TaskList extends Node {
         if (task != null && pos == -1) {
             mChildren.add(index, task);
 
-            // update the task list
+            // 更新子任务列表
             Task preTask = null;
             Task afterTask = null;
             if (index != 0)
@@ -260,6 +276,7 @@ public class TaskList extends Node {
         return true;
     }
 
+    // 从任务列表中移除子任务
     public boolean removeChildTask(Task task) {
         boolean ret = false;
         int index = mChildren.indexOf(task);
@@ -267,11 +284,11 @@ public class TaskList extends Node {
             ret = mChildren.remove(task);
 
             if (ret) {
-                // reset prior sibling and parent
+                // 重置子任务的前一个兄弟任务和父任务列表
                 task.setPriorSibling(null);
                 task.setParent(null);
 
-                // update the task list
+                // 更新子任务列表
                 if (index != mChildren.size()) {
                     mChildren.get(index).setPriorSibling(
                             index == 0 ? null : mChildren.get(index - 1));
@@ -281,6 +298,7 @@ public class TaskList extends Node {
         return ret;
     }
 
+    // 移动子任务到指定位置
     public boolean moveChildTask(Task task, int index) {
 
         if (index < 0 || index >= mChildren.size()) {
@@ -299,6 +317,7 @@ public class TaskList extends Node {
         return (removeChildTask(task) && addChildTask(task, index));
     }
 
+    // 根据GID查找子任务
     public Task findChildTaskByGid(String gid) {
         for (int i = 0; i < mChildren.size(); i++) {
             Task t = mChildren.get(i);
@@ -309,10 +328,12 @@ public class TaskList extends Node {
         return null;
     }
 
+    // 获取子任务在列表中的索引
     public int getChildTaskIndex(Task task) {
         return mChildren.indexOf(task);
     }
 
+    // 根据索引获取子任务
     public Task getChildTaskByIndex(int index) {
         if (index < 0 || index >= mChildren.size()) {
             Log.e(TAG, "getTaskByIndex: invalid index");
@@ -321,6 +342,7 @@ public class TaskList extends Node {
         return mChildren.get(index);
     }
 
+    // 根据GID获取子任务
     public Task getChilTaskByGid(String gid) {
         for (Task task : mChildren) {
             if (task.getGid().equals(gid))
@@ -329,14 +351,17 @@ public class TaskList extends Node {
         return null;
     }
 
+    // 获取子任务列表
     public ArrayList<Task> getChildTaskList() {
         return this.mChildren;
     }
 
+    // 设置任务列表的索引
     public void setIndex(int index) {
         this.mIndex = index;
     }
 
+    // 获取任务列表的索引
     public int getIndex() {
         return this.mIndex;
     }

src/main/java/net/micode/notes/gtask/exception/ActionFailureException.java

@@ -16,17 +16,22 @@
 
 package net.micode.notes.gtask.exception;
 
+// ActionFailureException类用于表示任务操作失败的异常情况
 public class ActionFailureException extends RuntimeException {
+    // 序列化ID，用于标识类的版本
     private static final long serialVersionUID = 4425249765923293627L;
 
+    // 构造方法，无参数
     public ActionFailureException() {
         super();
     }
 
+    // 构造方法，带错误消息参数
     public ActionFailureException(String paramString) {
         super(paramString);
     }
 
+    // 构造方法，带错误消息和异常原因参数
     public ActionFailureException(String paramString, Throwable paramThrowable) {
         super(paramString, paramThrowable);
     }

src/main/java/net/micode/notes/gtask/exception/NetworkFailureException.java

@@ -16,17 +16,22 @@
 
 package net.micode.notes.gtask.exception;
 
+// NetworkFailureException类用于表示网络操作失败的异常情况
 public class NetworkFailureException extends Exception {
+    // 序列化ID，用于标识类的版本
     private static final long serialVersionUID = 2107610287180234136L;
 
+    // 构造方法，无参数
     public NetworkFailureException() {
         super();
     }
 
+    // 构造方法，带错误消息参数
     public NetworkFailureException(String paramString) {
         super(paramString);
     }
 
+    // 构造方法，带错误消息和异常原因参数
     public NetworkFailureException(String paramString, Throwable paramThrowable) {
         super(paramString, paramThrowable);
     }

src/main/java/net/micode/notes/gtask/remote/GTaskASyncTask.java

@@ -1,4 +1,3 @@
-
 /*
  * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
  *
@@ -28,23 +27,29 @@ import net.micode.notes.R;
 import net.micode.notes.ui.NotesListActivity;
 import net.micode.notes.ui.NotesPreferenceActivity;
 
-
 public class GTaskASyncTask extends AsyncTask<Void, String, Integer> {
 
+    // 通知ID，用于同步任务的通知
     private static int GTASK_SYNC_NOTIFICATION_ID = 5234235;
 
+    // 定义任务完成后的回调接口
     public interface OnCompleteListener {
         void onComplete();
     }
 
+    // 上下文环境，用于访问应用程序资源
     private Context mContext;
 
+    // 通知管理器，用于显示同步通知
     private NotificationManager mNotifiManager;
 
+    // GTask管理器，用于处理任务同步
     private GTaskManager mTaskManager;
 
+    // 任务完成后的回调监听器
     private OnCompleteListener mOnCompleteListener;
 
+    // 构造方法，初始化任务所需的资源
     public GTaskASyncTask(Context context, OnCompleteListener listener) {
         mContext = context;
         mOnCompleteListener = listener;
@@ -53,35 +58,19 @@ public class GTaskASyncTask extends AsyncTask<Void, String, Integer> {
         mTaskManager = GTaskManager.getInstance();
     }
 
+    // 取消同步操作
     public void cancelSync() {
         mTaskManager.cancelSync();
     }
 
+    // 发布进度信息
     public void publishProgess(String message) {
         publishProgress(new String[] {
                 message
         });
     }
 
-//    private void showNotification(int tickerId, String content) {
-//        Notification notification = new Notification(R.drawable.notification, mContext
-//                .getString(tickerId), System.currentTimeMillis());
-//        notification.defaults = Notification.DEFAULT_LIGHTS;
-//        notification.flags = Notification.FLAG_AUTO_CANCEL;
-//        PendingIntent pendingIntent;
-//        if (tickerId != R.string.ticker_success) {
-//            pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext,
-//                    NotesPreferenceActivity.class), 0);
-//
-//        } else {
-//            pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext,
-//                    NotesListActivity.class), 0);
-//        }
-//        notification.setLatestEventInfo(mContext, mContext.getString(R.string.app_name), content,
-//                pendingIntent);
-//        mNotifiManager.notify(GTASK_SYNC_NOTIFICATION_ID, notification);
-//    }
-
+    // 显示通知
     private void showNotification(int tickerId, String content) {
         PendingIntent pendingIntent;
         if (tickerId != R.string.ticker_success) {
@@ -102,6 +91,7 @@ public class GTaskASyncTask extends AsyncTask<Void, String, Integer> {
         mNotifiManager.notify(GTASK_SYNC_NOTIFICATION_ID, notification);
     }
 
+    // 后台执行任务
     @Override
     protected Integer doInBackground(Void... unused) {
         publishProgess(mContext.getString(R.string.sync_progress_login, NotesPreferenceActivity
@@ -109,6 +99,7 @@ public class GTaskASyncTask extends AsyncTask<Void, String, Integer> {
         return mTaskManager.sync(mContext, this);
     }
 
+    // 更新进度
     @Override
     protected void onProgressUpdate(String... progress) {
         showNotification(R.string.ticker_syncing, progress[0]);
@@ -117,6 +108,7 @@ public class GTaskASyncTask extends AsyncTask<Void, String, Integer> {
         }
     }
 
+    // 任务完成后执行的操作
     @Override
     protected void onPostExecute(Integer result) {
         if (result == GTaskManager.STATE_SUCCESS) {

src/main/java/net/micode/notes/gtask/remote/GTaskClient.java

@@ -44,7 +44,6 @@ import org.apache.http.impl.client.DefaultHttpClient;
 import org.apache.http.message.BasicNameValuePair;
 import org.apache.http.params.BasicHttpParams;
 import org.apache.http.params.HttpConnectionParams;
-import org.apache.http.params.HttpParams;
 import org.apache.http.params.HttpProtocolParams;
 import org.json.JSONArray;
 import org.json.JSONException;
@@ -60,36 +59,50 @@ import java.util.zip.GZIPInputStream;
 import java.util.zip.Inflater;
 import java.util.zip.InflaterInputStream;
 
-
 public class GTaskClient {
+    // 日志标签，用于调试和日志记录
     private static final String TAG = GTaskClient.class.getSimpleName();
 
+    // Google Tasks 的基础URL
     private static final String GTASK_URL = "https://mail.google.com/tasks/";
 
+    // Google Tasks 获取数据的URL
     private static final String GTASK_GET_URL = "https://mail.google.com/tasks/ig";
 
+    // Google Tasks 提交数据的URL
     private static final String GTASK_POST_URL = "https://mail.google.com/tasks/r/ig";
 
+    // 单例实例
     private static GTaskClient mInstance = null;
 
+    // HTTP客户端，用于网络请求
     private DefaultHttpClient mHttpClient;
 
+    // 获取数据的URL
     private String mGetUrl;
 
+    // 提交数据的URL
     private String mPostUrl;
 
+    // 客户端版本号
     private long mClientVersion;
 
+    // 登录状态
     private boolean mLoggedin;
 
+    // 最后登录时间
     private long mLastLoginTime;
 
+    // 操作ID
     private int mActionId;
 
+    // 当前账户
     private Account mAccount;
 
+    // 更新数组
     private JSONArray mUpdateArray;
 
+    // 私有构造方法，用于单例模式
     private GTaskClient() {
         mHttpClient = null;
         mGetUrl = GTASK_GET_URL;
@@ -102,6 +115,7 @@ public class GTaskClient {
         mUpdateArray = null;
     }
 
+    // 获取单例实例
     public static synchronized GTaskClient getInstance() {
         if (mInstance == null) {
             mInstance = new GTaskClient();
@@ -109,15 +123,15 @@ public class GTaskClient {
         return mInstance;
     }
 
+    // 登录Google账户
     public boolean login(Activity activity) {
-        // we suppose that the cookie would expire after 5 minutes
-        // then we need to re-login
+        // 检查是否需要重新登录
         final long interval = 1000 * 60 * 5;
         if (mLastLoginTime + interval < System.currentTimeMillis()) {
             mLoggedin = false;
         }
 
-        // need to re-login after account switch
+        // 检查账户是否切换
         if (mLoggedin
                 && !TextUtils.equals(getSyncAccount().name, NotesPreferenceActivity
                 .getSyncAccountName(activity))) {
@@ -136,7 +150,7 @@ public class GTaskClient {
             return false;
         }
 
-        // login with custom domain if necessary
+        // 登录自定义域名
         if (!(mAccount.name.toLowerCase().endsWith("gmail.com") || mAccount.name.toLowerCase()
                 .endsWith("googlemail.com"))) {
             StringBuilder url = new StringBuilder(GTASK_URL).append("a/");
@@ -151,7 +165,7 @@ public class GTaskClient {
             }
         }
 
-        // try to login with google official url
+        // 登录官方URL
         if (!mLoggedin) {
             mGetUrl = GTASK_GET_URL;
             mPostUrl = GTASK_POST_URL;
@@ -164,6 +178,7 @@ public class GTaskClient {
         return true;
     }
 
+    // 登录Google账户并获取认证令牌
     private String loginGoogleAccount(Activity activity, boolean invalidateToken) {
         String authToken;
         AccountManager accountManager = AccountManager.get(activity);
@@ -189,7 +204,6 @@ public class GTaskClient {
             return null;
         }
 
-        // get the token now
         AccountManagerFuture<Bundle> accountManagerFuture = accountManager.getAuthToken(account,
                 "goanna_mobile", null, activity, null, null);
         try {
@@ -207,10 +221,10 @@ public class GTaskClient {
         return authToken;
     }
 
+    // 尝试登录Google Tasks
     private boolean tryToLoginGtask(Activity activity, String authToken) {
         if (!loginGtask(authToken)) {
-            // maybe the auth token is out of date, now let's invalidate the
-            // token and try again
+            // 如果认证令牌过期，重新获取并再次尝试登录
             authToken = loginGoogleAccount(activity, true);
             if (authToken == null) {
                 Log.e(TAG, "login google account failed");
@@ -225,6 +239,7 @@ public class GTaskClient {
         return true;
     }
 
+    // 登录Google Tasks
     private boolean loginGtask(String authToken) {
         int timeoutConnection = 10000;
         int timeoutSocket = 15000;
@@ -236,14 +251,13 @@ public class GTaskClient {
         mHttpClient.setCookieStore(localBasicCookieStore);
         HttpProtocolParams.setUseExpectContinue(mHttpClient.getParams(), false);
 
-        // login gtask
         try {
             String loginUrl = mGetUrl + "?auth=" + authToken;
             HttpGet httpGet = new HttpGet(loginUrl);
             HttpResponse response = null;
             response = mHttpClient.execute(httpGet);
 
-            // get the cookie now
+            // 获取登录后的Cookie
             List<Cookie> cookies = mHttpClient.getCookieStore().getCookies();
             boolean hasAuthCookie = false;
             for (Cookie cookie : cookies) {
@@ -255,7 +269,7 @@ public class GTaskClient {
                 Log.w(TAG, "it seems that there is no auth cookie");
             }
 
-            // get the client version
+            // 获取客户端版本号
             String resString = getResponseContent(response.getEntity());
             String jsBegin = "_setup(";
             String jsEnd = ")}</script>";
@@ -272,7 +286,6 @@ public class GTaskClient {
             e.printStackTrace();
             return false;
         } catch (Exception e) {
-            // simply catch all exceptions
             Log.e(TAG, "httpget gtask_url failed");
             return false;
         }
@@ -280,10 +293,12 @@ public class GTaskClient {
         return true;
     }
 
+    // 获取操作ID
     private int getActionId() {
         return mActionId++;
     }
 
+    // 创建HTTP POST请求
     private HttpPost createHttpPost() {
         HttpPost httpPost = new HttpPost(mPostUrl);
         httpPost.setHeader("Content-Type", "application/x-www-form-urlencoded;charset=utf-8");
@@ -291,6 +306,7 @@ public class GTaskClient {
         return httpPost;
     }
 
+    // 获取HTTP响应内容
     private String getResponseContent(HttpEntity entity) throws IOException {
         String contentEncoding = null;
         if (entity.getContentEncoding() != null) {
@@ -323,6 +339,7 @@ public class GTaskClient {
         }
     }
 
+    // 发送POST请求
     private JSONObject postRequest(JSONObject js) throws NetworkFailureException {
         if (!mLoggedin) {
             Log.e(TAG, "please login first");
@@ -336,7 +353,6 @@ public class GTaskClient {
             UrlEncodedFormEntity entity = new UrlEncodedFormEntity(list, "UTF-8");
             httpPost.setEntity(entity);
 
-            // execute the post
             HttpResponse response = mHttpClient.execute(httpPost);
             String jsString = getResponseContent(response.getEntity());
             return new JSONObject(jsString);
@@ -360,20 +376,18 @@ public class GTaskClient {
         }
     }
 
+    // 创建任务
     public void createTask(Task task) throws NetworkFailureException {
         commitUpdate();
         try {
             JSONObject jsPost = new JSONObject();
             JSONArray actionList = new JSONArray();
 
-            // action_list
             actionList.put(task.getCreateAction(getActionId()));
             jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList);
 
-            // client_version
             jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion);
 
-            // post
             JSONObject jsResponse = postRequest(jsPost);
             JSONObject jsResult = (JSONObject) jsResponse.getJSONArray(
                     GTaskStringUtils.GTASK_JSON_RESULTS).get(0);
@@ -386,20 +400,18 @@ public class GTaskClient {
         }
     }
 
+    // 创建任务列表
     public void createTaskList(TaskList tasklist) throws NetworkFailureException {
         commitUpdate();
         try {
             JSONObject jsPost = new JSONObject();
             JSONArray actionList = new JSONArray();
 
-            // action_list
             actionList.put(tasklist.getCreateAction(getActionId()));
             jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList);
 
-            // client version
             jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion);
 
-            // post
             JSONObject jsResponse = postRequest(jsPost);
             JSONObject jsResult = (JSONObject) jsResponse.getJSONArray(
                     GTaskStringUtils.GTASK_JSON_RESULTS).get(0);
@@ -412,15 +424,14 @@ public class GTaskClient {
         }
     }
 
+    // 提交更新
     public void commitUpdate() throws NetworkFailureException {
         if (mUpdateArray != null) {
             try {
                 JSONObject jsPost = new JSONObject();
 
-                // action_list
                 jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, mUpdateArray);
 
-                // client_version
                 jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion);
 
                 postRequest(jsPost);
@@ -433,10 +444,9 @@ public class GTaskClient {
         }
     }
 
+    // 添加更新节点
     public void addUpdateNode(Node node) throws NetworkFailureException {
         if (node != null) {
-            // too many update items may result in an error
-            // set max to 10 items
             if (mUpdateArray != null && mUpdateArray.length() > 10) {
                 commitUpdate();
             }
@@ -447,6 +457,7 @@ public class GTaskClient {
         }
     }
 
+    // 移动任务
     public void moveTask(Task task, TaskList preParent, TaskList curParent)
             throws NetworkFailureException {
         commitUpdate();
@@ -455,26 +466,21 @@ public class GTaskClient {
             JSONArray actionList = new JSONArray();
             JSONObject action = new JSONObject();
 
-            // action_list
             action.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
                     GTaskStringUtils.GTASK_JSON_ACTION_TYPE_MOVE);
             action.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, getActionId());
             action.put(GTaskStringUtils.GTASK_JSON_ID, task.getGid());
             if (preParent == curParent && task.getPriorSibling() != null) {
-                // put prioring_sibing_id only if moving within the tasklist and
-                // it is not the first one
                 action.put(GTaskStringUtils.GTASK_JSON_PRIOR_SIBLING_ID, task.getPriorSibling());
             }
             action.put(GTaskStringUtils.GTASK_JSON_SOURCE_LIST, preParent.getGid());
             action.put(GTaskStringUtils.GTASK_JSON_DEST_PARENT, curParent.getGid());
             if (preParent != curParent) {
-                // put the dest_list only if moving between tasklists
                 action.put(GTaskStringUtils.GTASK_JSON_DEST_LIST, curParent.getGid());
             }
             actionList.put(action);
             jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList);
 
-            // client_version
             jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion);
 
             postRequest(jsPost);
@@ -486,18 +492,17 @@ public class GTaskClient {
         }
     }
 
+    // 删除节点
     public void deleteNode(Node node) throws NetworkFailureException {
         commitUpdate();
         try {
             JSONObject jsPost = new JSONObject();
             JSONArray actionList = new JSONArray();
 
-            // action_list
             node.setDeleted(true);
             actionList.put(node.getUpdateAction(getActionId()));
             jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList);
 
-            // client_version
             jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion);
 
             postRequest(jsPost);
@@ -509,6 +514,7 @@ public class GTaskClient {
         }
     }
 
+    // 获取任务列表
     public JSONArray getTaskLists() throws NetworkFailureException {
         if (!mLoggedin) {
             Log.e(TAG, "please login first");
@@ -520,7 +526,6 @@ public class GTaskClient {
             HttpResponse response = null;
             response = mHttpClient.execute(httpGet);
 
-            // get the task list
             String resString = getResponseContent(response.getEntity());
             String jsBegin = "_setup(";
             String jsEnd = ")}</script>";
@@ -547,6 +552,7 @@ public class GTaskClient {
         }
     }
 
+    // 获取任务列表中的任务
     public JSONArray getTaskList(String listGid) throws NetworkFailureException {
         commitUpdate();
         try {
@@ -554,7 +560,6 @@ public class GTaskClient {
             JSONArray actionList = new JSONArray();
             JSONObject action = new JSONObject();
 
-            // action_list
             action.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
                     GTaskStringUtils.GTASK_JSON_ACTION_TYPE_GETALL);
             action.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, getActionId());
@@ -563,7 +568,6 @@ public class GTaskClient {
             actionList.put(action);
             jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList);
 
-            // client_version
             jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion);
 
             JSONObject jsResponse = postRequest(jsPost);
@@ -575,10 +579,12 @@ public class GTaskClient {
         }
     }
 
+    // 获取同步账户
     public Account getSyncAccount() {
         return mAccount;
     }
 
+    // 重置更新数组
     public void resetUpdateArray() {
         mUpdateArray = null;
     }

src/main/java/net/micode/notes/gtask/remote/GTaskManager.java

@@ -47,46 +47,57 @@ import java.util.HashSet;
 import java.util.Iterator;
 import java.util.Map;
 
-
 public class GTaskManager {
+    // 日志标签，用于调试和日志记录
     private static final String TAG = GTaskManager.class.getSimpleName();
 
+    // 同步状态常量
     public static final int STATE_SUCCESS = 0;
-
     public static final int STATE_NETWORK_ERROR = 1;
-
     public static final int STATE_INTERNAL_ERROR = 2;
-
     public static final int STATE_SYNC_IN_PROGRESS = 3;
-
     public static final int STATE_SYNC_CANCELLED = 4;
 
+    // 单例实例
     private static GTaskManager mInstance = null;
 
+    // 当前活动的Activity
     private Activity mActivity;
 
+    // 上下文环境
     private Context mContext;
 
+    // 内容解析器
     private ContentResolver mContentResolver;
 
+    // 同步状态
     private boolean mSyncing;
 
+    // 是否取消同步
     private boolean mCancelled;
 
+    // GTask列表映射
     private HashMap<String, TaskList> mGTaskListHashMap;
 
+    // GTask映射
     private HashMap<String, Node> mGTaskHashMap;
 
+    // 元数据映射
     private HashMap<String, MetaData> mMetaHashMap;
 
+    // 元数据列表
     private TaskList mMetaList;
 
+    // 本地删除ID集合
     private HashSet<Long> mLocalDeleteIdMap;
 
+    // GID到NID的映射
     private HashMap<String, Long> mGidToNid;
 
+    // NID到GID的映射
     private HashMap<Long, String> mNidToGid;
 
+    // 私有构造方法，用于单例模式
     private GTaskManager() {
         mSyncing = false;
         mCancelled = false;
@@ -99,6 +110,7 @@ public class GTaskManager {
         mNidToGid = new HashMap<Long, String>();
     }
 
+    // 获取单例实例
     public static synchronized GTaskManager getInstance() {
         if (mInstance == null) {
             mInstance = new GTaskManager();
@@ -106,11 +118,12 @@ public class GTaskManager {
         return mInstance;
     }
 
+    // 设置活动的Activity
     public synchronized void setActivityContext(Activity activity) {
-        // used for getting authtoken
         mActivity = activity;
     }
 
+    // 执行同步操作
     public int sync(Context context, GTaskASyncTask asyncTask) {
         if (mSyncing) {
             Log.d(TAG, "Sync is in progress");
@@ -131,18 +144,18 @@ public class GTaskManager {
             GTaskClient client = GTaskClient.getInstance();
             client.resetUpdateArray();
 
-            // login google task
+            // 登录Google Tasks
             if (!mCancelled) {
                 if (!client.login(mActivity)) {
                     throw new NetworkFailureException("login google task failed");
                 }
             }
 
-            // get the task list from google
+            // 初始化GTask列表
             asyncTask.publishProgess(mContext.getString(R.string.sync_progress_init_list));
             initGTaskList();
 
-            // do content sync work
+            // 执行内容同步
             asyncTask.publishProgess(mContext.getString(R.string.sync_progress_syncing));
             syncContent();
         } catch (NetworkFailureException e) {
@@ -168,6 +181,7 @@ public class GTaskManager {
         return mCancelled ? STATE_SYNC_CANCELLED : STATE_SUCCESS;
     }
 
+    // 初始化GTask列表
     private void initGTaskList() throws NetworkFailureException {
         if (mCancelled)
             return;
@@ -175,7 +189,7 @@ public class GTaskManager {
         try {
             JSONArray jsTaskLists = client.getTaskLists();
 
-            // init meta list first
+            // 初始化元数据列表
             mMetaList = null;
             for (int i = 0; i < jsTaskLists.length(); i++) {
                 JSONObject object = jsTaskLists.getJSONObject(i);
@@ -187,7 +201,7 @@ public class GTaskManager {
                     mMetaList = new TaskList();
                     mMetaList.setContentByRemoteJSON(object);
 
-                    // load meta data
+                    // 加载元数据
                     JSONArray jsMetas = client.getTaskList(gid);
                     for (int j = 0; j < jsMetas.length(); j++) {
                         object = (JSONObject) jsMetas.getJSONObject(j);
@@ -203,7 +217,7 @@ public class GTaskManager {
                 }
             }
 
-            // create meta list if not existed
+            // 创建元数据列表（如果不存在）
             if (mMetaList == null) {
                 mMetaList = new TaskList();
                 mMetaList.setName(GTaskStringUtils.MIUI_FOLDER_PREFFIX
@@ -211,7 +225,7 @@ public class GTaskManager {
                 GTaskClient.getInstance().createTaskList(mMetaList);
             }
 
-            // init task list
+            // 初始化任务列表
             for (int i = 0; i < jsTaskLists.length(); i++) {
                 JSONObject object = jsTaskLists.getJSONObject(i);
                 String gid = object.getString(GTaskStringUtils.GTASK_JSON_ID);
@@ -219,13 +233,13 @@ public class GTaskManager {
 
                 if (name.startsWith(GTaskStringUtils.MIUI_FOLDER_PREFFIX)
                         && !name.equals(GTaskStringUtils.MIUI_FOLDER_PREFFIX
-                                + GTaskStringUtils.FOLDER_META)) {
+                        + GTaskStringUtils.FOLDERMETA)) {
                     TaskList tasklist = new TaskList();
                     tasklist.setContentByRemoteJSON(object);
                     mGTaskListHashMap.put(gid, tasklist);
                     mGTaskHashMap.put(gid, tasklist);
 
-                    // load tasks
+                    // 加载任务
                     JSONArray jsTasks = client.getTaskList(gid);
                     for (int j = 0; j < jsTasks.length(); j++) {
                         object = (JSONObject) jsTasks.getJSONObject(j);
@@ -247,6 +261,7 @@ public class GTaskManager {
         }
     }
 
+    // 执行内容同步
     private void syncContent() throws NetworkFailureException {
         int syncType;
         Cursor c = null;
@@ -259,7 +274,7 @@ public class GTaskManager {
             return;
         }
 
-        // for local deleted note
+        // 同步本地删除的便签
         try {
             c = mContentResolver.query(Notes.CONTENT_NOTE_URI, SqlNote.PROJECTION_NOTE,
                     "(type<>? AND parent_id=?)", new String[] {
@@ -286,10 +301,10 @@ public class GTaskManager {
             }
         }
 
-        // sync folder first
+        // 同步文件夹
         syncFolder();
 
-        // for note existing in database
+        // 同步便签
         try {
             c = mContentResolver.query(Notes.CONTENT_NOTE_URI, SqlNote.PROJECTION_NOTE,
                     "(type=? AND parent_id<>?)", new String[] {
@@ -306,10 +321,8 @@ public class GTaskManager {
                         syncType = node.getSyncAction(c);
                     } else {
                         if (c.getString(SqlNote.GTASK_ID_COLUMN).trim().length() == 0) {
-                            // local add
                             syncType = Node.SYNC_ACTION_ADD_REMOTE;
                         } else {
-                            // remote delete
                             syncType = Node.SYNC_ACTION_DEL_LOCAL;
                         }
                     }
@@ -326,7 +339,7 @@ public class GTaskManager {
             }
         }
 
-        // go through remaining items
+        // 同步剩余项目
         Iterator<Map.Entry<String, Node>> iter = mGTaskHashMap.entrySet().iterator();
         while (iter.hasNext()) {
             Map.Entry<String, Node> entry = iter.next();
@@ -334,23 +347,21 @@ public class GTaskManager {
             doContentSync(Node.SYNC_ACTION_ADD_LOCAL, node, null);
         }
 
-        // mCancelled can be set by another thread, so we neet to check one by
-        // one
-        // clear local delete table
+        // 清除本地删除表
         if (!mCancelled) {
             if (!DataUtils.batchDeleteNotes(mContentResolver, mLocalDeleteIdMap)) {
                 throw new ActionFailureException("failed to batch-delete local deleted notes");
             }
         }
 
-        // refresh local sync id
+        // 刷新本地同步ID
         if (!mCancelled) {
             GTaskClient.getInstance().commitUpdate();
             refreshLocalSyncId();
         }
-
     }
 
+    // 同步文件夹
     private void syncFolder() throws NetworkFailureException {
         Cursor c = null;
         String gid;
@@ -361,7 +372,7 @@ public class GTaskManager {
             return;
         }
 
-        // for root folder
+        // 同步根文件夹
         try {
             c = mContentResolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI,
                     Notes.ID_ROOT_FOLDER), SqlNote.PROJECTION_NOTE, null, null, null);
@@ -373,7 +384,6 @@ public class GTaskManager {
                     mGTaskHashMap.remove(gid);
                     mGidToNid.put(gid, (long) Notes.ID_ROOT_FOLDER);
                     mNidToGid.put((long) Notes.ID_ROOT_FOLDER, gid);
-                    // for system folder, only update remote name if necessary
                     if (!node.getName().equals(
                             GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_DEFAULT))
                         doContentSync(Node.SYNC_ACTION_UPDATE_REMOTE, node, c);
@@ -390,7 +400,7 @@ public class GTaskManager {
             }
         }
 
-        // for call-note folder
+        // 同步通话记录文件夹
         try {
             c = mContentResolver.query(Notes.CONTENT_NOTE_URI, SqlNote.PROJECTION_NOTE, "(_id=?)",
                     new String[] {
@@ -404,8 +414,6 @@ public class GTaskManager {
                         mGTaskHashMap.remove(gid);
                         mGidToNid.put(gid, (long) Notes.ID_CALL_RECORD_FOLDER);
                         mNidToGid.put((long) Notes.ID_CALL_RECORD_FOLDER, gid);
-                        // for system folder, only update remote name if
-                        // necessary
                         if (!node.getName().equals(
                                 GTaskStringUtils.MIUI_FOLDER_PREFFIX
                                         + GTaskStringUtils.FOLDER_CALL_NOTE))
@@ -424,7 +432,7 @@ public class GTaskManager {
             }
         }
 
-        // for local existing folders
+        // 同步本地现有文件夹
         try {
             c = mContentResolver.query(Notes.CONTENT_NOTE_URI, SqlNote.PROJECTION_NOTE,
                     "(type=? AND parent_id<>?)", new String[] {
@@ -441,10 +449,8 @@ public class GTaskManager {
                         syncType = node.getSyncAction(c);
                     } else {
                         if (c.getString(SqlNote.GTASK_ID_COLUMN).trim().length() == 0) {
-                            // local add
                             syncType = Node.SYNC_ACTION_ADD_REMOTE;
                         } else {
-                            // remote delete
                             syncType = Node.SYNC_ACTION_DEL_LOCAL;
                         }
                     }
@@ -460,7 +466,7 @@ public class GTaskManager {
             }
         }
 
-        // for remote add folders
+        // 同步远程添加的文件夹
         Iterator<Map.Entry<String, TaskList>> iter = mGTaskListHashMap.entrySet().iterator();
         while (iter.hasNext()) {
             Map.Entry<String, TaskList> entry = iter.next();
@@ -476,6 +482,7 @@ public class GTaskManager {
             GTaskClient.getInstance().commitUpdate();
     }
 
+    // 执行内容同步操作
     private void doContentSync(int syncType, Node node, Cursor c) throws NetworkFailureException {
         if (mCancelled) {
             return;
@@ -510,18 +517,17 @@ public class GTaskManager {
                 updateRemoteNode(node, c);
                 break;
             case Node.SYNC_ACTION_UPDATE_CONFLICT:
-                // merging both modifications maybe a good idea
-                // right now just use local update simply
                 updateRemoteNode(node, c);
                 break;
             case Node.SYNC_ACTION_NONE:
                 break;
             case Node.SYNC_ACTION_ERROR:
             default:
-                throw new ActionFailureException("unkown sync action type");
+                throw new ActionFailureException("unknown sync action type");
         }
     }
 
+    // 添加本地节点
     private void addLocalNode(Node node) throws NetworkFailureException {
         if (mCancelled) {
             return;
@@ -549,7 +555,6 @@ public class GTaskManager {
                     if (note.has(NoteColumns.ID)) {
                         long id = note.getLong(NoteColumns.ID);
                         if (DataUtils.existInNoteDatabase(mContentResolver, id)) {
-                            // the id is not available, have to create a new one
                             note.remove(NoteColumns.ID);
                         }
                     }
@@ -562,8 +567,6 @@ public class GTaskManager {
                         if (data.has(DataColumns.ID)) {
                             long dataId = data.getLong(DataColumns.ID);
                             if (DataUtils.existInDataDatabase(mContentResolver, dataId)) {
-                                // the data id is not available, have to create
-                                // a new one
                                 data.remove(DataColumns.ID);
                             }
                         }
@@ -584,26 +587,22 @@ public class GTaskManager {
             sqlNote.setParentId(parentId.longValue());
         }
 
-        // create the local node
         sqlNote.setGtaskId(node.getGid());
         sqlNote.commit(false);
 
-        // update gid-nid mapping
         mGidToNid.put(node.getGid(), sqlNote.getId());
         mNidToGid.put(sqlNote.getId(), node.getGid());
 
-        // update meta
         updateRemoteMeta(node.getGid(), sqlNote);
     }
 
+    // 更新本地节点
     private void updateLocalNode(Node node, Cursor c) throws NetworkFailureException {
         if (mCancelled) {
             return;
         }
 
-        SqlNote sqlNote;
-        // update the note locally
-        sqlNote = new SqlNote(mContext, c);
+        SqlNote sqlNote = new SqlNote(mContext, c);
         sqlNote.setContent(node.getLocalJSONFromContent());
 
         Long parentId = (node instanceof Task) ? mGidToNid.get(((Task) node).getParent().getGid())
@@ -615,10 +614,10 @@ public class GTaskManager {
         sqlNote.setParentId(parentId.longValue());
         sqlNote.commit(true);
 
-        // update meta info
         updateRemoteMeta(node.getGid(), sqlNote);
     }
 
+    // 添加远程节点
     private void addRemoteNode(Node node, Cursor c) throws NetworkFailureException {
         if (mCancelled) {
             return;
@@ -627,7 +626,6 @@ public class GTaskManager {
         SqlNote sqlNote = new SqlNote(mContext, c);
         Node n;
 
-        // update remotely
         if (sqlNote.isNoteType()) {
             Task task = new Task();
             task.setContentByLocalJSON(sqlNote.getContent());
@@ -642,12 +640,10 @@ public class GTaskManager {
             GTaskClient.getInstance().createTask(task);
             n = (Node) task;
 
-            // add meta
             updateRemoteMeta(task.getGid(), sqlNote);
         } else {
             TaskList tasklist = null;
 
-            // we need to skip folder if it has already existed
             String folderName = GTaskStringUtils.MIUI_FOLDER_PREFFIX;
             if (sqlNote.getId() == Notes.ID_ROOT_FOLDER)
                 folderName += GTaskStringUtils.FOLDER_DEFAULT;
@@ -671,7 +667,6 @@ public class GTaskManager {
                 }
             }
 
-            // no match we can add now
             if (tasklist == null) {
                 tasklist = new TaskList();
                 tasklist.setContentByLocalJSON(sqlNote.getContent());
@@ -681,17 +676,16 @@ public class GTaskManager {
             n = (Node) tasklist;
         }
 
-        // update local note
         sqlNote.setGtaskId(n.getGid());
         sqlNote.commit(false);
         sqlNote.resetLocalModified();
         sqlNote.commit(true);
 
-        // gid-id mapping
         mGidToNid.put(n.getGid(), sqlNote.getId());
         mNidToGid.put(sqlNote.getId(), n.getGid());
     }
 
+    // 更新远程节点
     private void updateRemoteNode(Node node, Cursor c) throws NetworkFailureException {
         if (mCancelled) {
             return;
@@ -699,14 +693,11 @@ public class GTaskManager {
 
         SqlNote sqlNote = new SqlNote(mContext, c);
 
-        // update remotely
         node.setContentByLocalJSON(sqlNote.getContent());
         GTaskClient.getInstance().addUpdateNode(node);
 
-        // update meta
         updateRemoteMeta(node.getGid(), sqlNote);
 
-        // move task if necessary
         if (sqlNote.isNoteType()) {
             Task task = (Task) node;
             TaskList preParentList = task.getParent();
@@ -725,11 +716,11 @@ public class GTaskManager {
             }
         }
 
-        // clear local modified flag
         sqlNote.resetLocalModified();
         sqlNote.commit(true);
     }
 
+    // 更新远程元数据
     private void updateRemoteMeta(String gid, SqlNote sqlNote) throws NetworkFailureException {
         if (sqlNote != null && sqlNote.isNoteType()) {
             MetaData metaData = mMetaHashMap.get(gid);
@@ -746,12 +737,12 @@ public class GTaskManager {
         }
     }
 
+    // 刷新本地同步ID
     private void refreshLocalSyncId() throws NetworkFailureException {
         if (mCancelled) {
             return;
         }
 
-        // get the latest gtask list
         mGTaskHashMap.clear();
         mGTaskListHashMap.clear();
         mMetaHashMap.clear();
@@ -790,10 +781,12 @@ public class GTaskManager {
         }
     }
 
+    // 获取同步账户名称
     public String getSyncAccount() {
         return GTaskClient.getInstance().getSyncAccount().name;
     }
 
+    // 取消同步
     public void cancelSync() {
         mCancelled = true;
     }

src/main/java/net/micode/notes/gtask/remote/GTaskSyncService.java

@@ -24,24 +24,28 @@ import android.os.Bundle;
 import android.os.IBinder;
 
 public class GTaskSyncService extends Service {
+    // 广播操作类型
     public final static String ACTION_STRING_NAME = "sync_action_type";
 
+    // 同步操作类型常量
     public final static int ACTION_START_SYNC = 0;
-
     public final static int ACTION_CANCEL_SYNC = 1;
-
     public final static int ACTION_INVALID = 2;
 
+    // 广播名称
     public final static String GTASK_SERVICE_BROADCAST_NAME = "net.micode.notes.gtask.remote.gtask_sync_service";
 
+    // 广播数据键
     public final static String GTASK_SERVICE_BROADCAST_IS_SYNCING = "isSyncing";
-
     public final static String GTASK_SERVICE_BROADCAST_PROGRESS_MSG = "progressMsg";
 
+    // 同步任务实例
     private static GTaskASyncTask mSyncTask = null;
 
+    // 同步进度信息
     private static String mSyncProgress = "";
 
+    // 开始同步
     private void startSync() {
         if (mSyncTask == null) {
             mSyncTask = new GTaskASyncTask(this, new GTaskASyncTask.OnCompleteListener() {
@@ -56,17 +60,20 @@ public class GTaskSyncService extends Service {
         }
     }
 
+    // 取消同步
     private void cancelSync() {
         if (mSyncTask != null) {
             mSyncTask.cancelSync();
         }
     }
 
+    // 服务创建时调用
     @Override
     public void onCreate() {
         mSyncTask = null;
     }
 
+    // 处理启动命令
     @Override
     public int onStartCommand(Intent intent, int flags, int startId) {
         Bundle bundle = intent.getExtras();
@@ -86,6 +93,7 @@ public class GTaskSyncService extends Service {
         return super.onStartCommand(intent, flags, startId);
     }
 
+    // 低内存时调用
     @Override
     public void onLowMemory() {
         if (mSyncTask != null) {
@@ -93,10 +101,12 @@ public class GTaskSyncService extends Service {
         }
     }
 
+    // 返回绑定的IBinder对象
     public IBinder onBind(Intent intent) {
         return null;
     }
 
+    // 发送广播
     public void sendBroadcast(String msg) {
         mSyncProgress = msg;
         Intent intent = new Intent(GTASK_SERVICE_BROADCAST_NAME);
@@ -105,6 +115,7 @@ public class GTaskSyncService extends Service {
         sendBroadcast(intent);
     }
 
+    // 静态方法，用于启动同步
     public static void startSync(Activity activity) {
         GTaskManager.getInstance().setActivityContext(activity);
         Intent intent = new Intent(activity, GTaskSyncService.class);
@@ -112,16 +123,19 @@ public class GTaskSyncService extends Service {
         activity.startService(intent);
     }
 
+    // 静态方法，用于取消同步
     public static void cancelSync(Context context) {
         Intent intent = new Intent(context, GTaskSyncService.class);
         intent.putExtra(GTaskSyncService.ACTION_STRING_NAME, GTaskSyncService.ACTION_CANCEL_SYNC);
         context.startService(intent);
     }
 
+    // 静态方法，用于检查是否正在同步
     public static boolean isSyncing() {
         return mSyncTask != null;
     }
 
+    // 静态方法，用于获取同步进度信息
     public static String getProgressString() {
         return mSyncProgress;
     }

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

@@ -5,7 +5,7 @@
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
- *        http://www.apache.org/licenses/LICENSE-2.0
+ *        <url id="d0s4geb67ti966oe1310" type="url" status="parsed" title="Apache License, Version 2.0" wc="10467">http://www.apache.org/licenses/LICENSE-2.0</url>
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -79,101 +79,98 @@ import java.io.InputStreamReader;
 import java.util.HashSet;
 
 public class NotesListActivity extends Activity implements OnClickListener, OnItemLongClickListener {
+    //定义背景
+    private int mode=-1;//add
+    // 定义查询标记
     private static final int FOLDER_NOTE_LIST_QUERY_TOKEN = 0;
-
     private static final int FOLDER_LIST_QUERY_TOKEN      = 1;
-
+    // 定义菜单项 ID
     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
     };
-
+    // 定义当前列表编辑状态
     private ListEditState mState;
-
+    // 定义异步查询处理器
     private BackgroundQueryHandler mBackgroundQueryHandler;
-
+    // 定义笔记列表适配器
     private NotesListAdapter mNotesListAdapter;
-
+    // 定义笔记列表视图
     private ListView mNotesListView;
-
+    // 定义新建笔记按钮
     private Button mAddNewNote;
-
+    // 定义是否正在分发触摸事件的标志
     private boolean mDispatch;
-
+    // 定义触摸事件的原始 Y 坐标和分发 Y 坐标
     private int mOriginY;
-
     private int mDispatchY;
-
+    // 定义标题栏视图
     private TextView mTitleBar;
-
+    // 定义当前文件夹 ID
     private long mCurrentFolderId;
-
+    // 定义内容解析器
     private ContentResolver mContentResolver;
-
+    // 定义多选模式回调
     private ModeCallback mModeCallBack;
-
+    // 定义日志标签
     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 + "<>"
-            + Notes.TYPE_SYSTEM + " AND " + NoteColumns.PARENT_ID + "=?)" + " OR ("
-            + NoteColumns.ID + "=" + Notes.ID_CALL_RECORD_FOLDER + " AND "
-            + NoteColumns.NOTES_COUNT + ">0)";
-
+    private static final String ROOT_FOLDER_SELECTION = "(" + NoteColumns.TYPE + "<>" + Notes.TYPE_SYSTEM + " AND " + NoteColumns.PARENT_ID + "=?)" + " OR (" + NoteColumns.ID + "=" + Notes.ID_CALL_RECORD_FOLDER + " AND " + NoteColumns.NOTES_COUNT + ">0)";
+    // 定义请求码
     private final static int REQUEST_CODE_OPEN_NODE = 102;
     private final static int REQUEST_CODE_NEW_NODE  = 103;
 
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
-        setContentView(R.layout.note_list);
-        initResources();
+        setContentView(R.layout.note_list); // 设置布局文件为 note_list
+        initResources(); // 初始化资源
 
+        getWindow().setBackgroundDrawableResource(R.drawable.graygoo);
+        getWindow().setBackgroundDrawableResource(R.drawable.hutao);
+        getWindow().setBackgroundDrawableResource(R.drawable.miku);
         /**
-         * Insert an introduction when user firstly use this application
+         * 当用户首次使用此应用时插入介绍
          */
-        setAppInfoFromRawRes();
+        setAppInfoFromRawRes(); // 从原始资源文件中读取介绍信息并创建笔记
     }
 
     @Override
     protected void onActivityResult(int requestCode, int resultCode, Intent data) {
-        if (resultCode == RESULT_OK
-                && (requestCode == REQUEST_CODE_OPEN_NODE || requestCode == REQUEST_CODE_NEW_NODE)) {
-            mNotesListAdapter.changeCursor(null);
+        if (resultCode == RESULT_OK && (requestCode == REQUEST_CODE_OPEN_NODE || requestCode == REQUEST_CODE_NEW_NODE)) {
+            mNotesListAdapter.changeCursor(null); // 更改游标以刷新列表
         } else {
-            super.onActivityResult(requestCode, resultCode, data);
+            super.onActivityResult(requestCode, resultCode, data); // 调用父类的方法
         }
     }
 
     private void setAppInfoFromRawRes() {
-        SharedPreferences sp = PreferenceManager.getDefaultSharedPreferences(this);
-        if (!sp.getBoolean(PREFERENCE_ADD_INTRODUCTION, false)) {
-            StringBuilder sb = new StringBuilder();
+        SharedPreferences sp = PreferenceManager.getDefaultSharedPreferences(this); // 获取默认偏好设置
+        if (!sp.getBoolean(PREFERENCE_ADD_INTRODUCTION, false)) { // 如果未添加介绍
+            StringBuilder sb = new StringBuilder(); // 创建字符串构建器
             InputStream in = null;
             try {
-                 in = getResources().openRawResource(R.raw.introduction);
+                in = getResources().openRawResource(R.raw.introduction); // 打开原始资源文件
                 if (in != null) {
                     InputStreamReader isr = new InputStreamReader(in);
                     BufferedReader br = new BufferedReader(isr);
                     char[] buf = new char[1024];
                     int len = 0;
                     while ((len = br.read(buf)) > 0) {
-                        sb.append(buf, 0, len);
+                        sb.append(buf, 0, len); // 将读取的内容追加到字符串构建器
                     }
                 } else {
-                    Log.e(TAG, "Read introduction file error");
+                    Log.e(TAG, "读取介绍文件错误");
                     return;
                 }
             } catch (IOException e) {
@@ -182,22 +179,19 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
             } finally {
                 if (in != null) {
                     try {
-                        in.close();
+                        in.close(); // 关闭输入流
                     } catch (IOException e) {
-                        // TODO Auto-generated catch block
                         e.printStackTrace();
                     }
                 }
             }
 
-            WorkingNote note = WorkingNote.createEmptyNote(this, Notes.ID_ROOT_FOLDER,
-                    AppWidgetManager.INVALID_APPWIDGET_ID, Notes.TYPE_WIDGET_INVALIDE,
-                    ResourceParser.RED);
-            note.setWorkingText(sb.toString());
-            if (note.saveNote()) {
-                sp.edit().putBoolean(PREFERENCE_ADD_INTRODUCTION, true).commit();
+            WorkingNote note = WorkingNote.createEmptyNote(this, Notes.ID_ROOT_FOLDER, AppWidgetManager.INVALID_APPWIDGET_ID, Notes.TYPE_WIDGET_INVALIDE, ResourceParser.RED); // 创建空笔记
+            note.setWorkingText(sb.toString()); // 设置笔记内容
+            if (note.saveNote()) { // 保存笔记
+                sp.edit().putBoolean(PREFERENCE_ADD_INTRODUCTION, true).commit(); // 更新偏好设置
             } else {
-                Log.e(TAG, "Save introduction note error");
+                Log.e(TAG, "保存介绍笔记错误");
                 return;
             }
         }
@@ -206,29 +200,28 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
     @Override
     protected void onStart() {
         super.onStart();
-        startAsyncNotesListQuery();
+        startAsyncNotesListQuery(); // 开始异步查询笔记列表
     }
 
     private void initResources() {
-        mContentResolver = this.getContentResolver();
-        mBackgroundQueryHandler = new BackgroundQueryHandler(this.getContentResolver());
-        mCurrentFolderId = Notes.ID_ROOT_FOLDER;
-        mNotesListView = (ListView) findViewById(R.id.notes_list);
-        mNotesListView.addFooterView(LayoutInflater.from(this).inflate(R.layout.note_list_footer, null),
-                null, false);
-        mNotesListView.setOnItemClickListener(new OnListItemClickListener());
-        mNotesListView.setOnItemLongClickListener(this);
-        mNotesListAdapter = new NotesListAdapter(this);
-        mNotesListView.setAdapter(mNotesListAdapter);
-        mAddNewNote = (Button) findViewById(R.id.btn_new_note);
-        mAddNewNote.setOnClickListener(this);
-        mAddNewNote.setOnTouchListener(new NewNoteOnTouchListener());
+        mContentResolver = this.getContentResolver(); // 获取内容解析器
+        mBackgroundQueryHandler = new BackgroundQueryHandler(this.getContentResolver()); // 创建异步查询处理器
+        mCurrentFolderId = Notes.ID_ROOT_FOLDER; // 设置当前文件夹 ID 为根文件夹
+        mNotesListView = (ListView) findViewById(R.id.notes_list); // 获取笔记列表视图
+        mNotesListView.addFooterView(LayoutInflater.from(this).inflate(R.layout.note_list_footer, null), null, false); // 添加页脚视图
+        mNotesListView.setOnItemClickListener(new OnListItemClickListener()); // 设置项点击监听器
+        mNotesListView.setOnItemLongClickListener(this); // 设置项长按监听器
+        mNotesListAdapter = new NotesListAdapter(this); // 创建笔记列表适配器
+        mNotesListView.setAdapter(mNotesListAdapter); // 设置适配器
+        mAddNewNote = (Button) findViewById(R.id.btn_new_note); // 获取新建笔记按钮
+        mAddNewNote.setOnClickListener(this); // 设置点击监听器
+        mAddNewNote.setOnTouchListener(new NewNoteOnTouchListener()); // 设置触摸监听器
         mDispatch = false;
         mDispatchY = 0;
         mOriginY = 0;
-        mTitleBar = (TextView) findViewById(R.id.tv_title_bar);
-        mState = ListEditState.NOTE_LIST;
-        mModeCallBack = new ModeCallback();
+        mTitleBar = (TextView) findViewById(R.id.tv_title_bar); // 获取标题栏视图
+        mState = ListEditState.NOTE_LIST; // 设置列表编辑状态为笔记列表
+        mModeCallBack = new ModeCallback(); // 创建多选模式回调
     }
 
     private class ModeCallback implements ListView.MultiChoiceModeListener, OnMenuItemClickListener {
@@ -237,85 +230,76 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         private MenuItem mMoveMenu;
 
         public boolean onCreateActionMode(ActionMode mode, Menu menu) {
-            getMenuInflater().inflate(R.menu.note_list_options, menu);
-            menu.findItem(R.id.delete).setOnMenuItemClickListener(this);
+            getMenuInflater().inflate(R.menu.note_list_options, menu); // 加载菜单资源
+            menu.findItem(R.id.delete).setOnMenuItemClickListener(this); // 设置菜单项点击监听器
             mMoveMenu = menu.findItem(R.id.move);
-            if (mFocusNoteDataItem.getParentId() == Notes.ID_CALL_RECORD_FOLDER
-                    || DataUtils.getUserFolderCount(mContentResolver) == 0) {
-                mMoveMenu.setVisible(false);
+            if (mFocusNoteDataItem.getParentId() == Notes.ID_CALL_RECORD_FOLDER || DataUtils.getUserFolderCount(mContentResolver) == 0) {
+                mMoveMenu.setVisible(false); // 如果是通话记录文件夹或没有用户文件夹，则隐藏移动菜单项
             } else {
                 mMoveMenu.setVisible(true);
-                mMoveMenu.setOnMenuItemClickListener(this);
+                mMoveMenu.setOnMenuItemClickListener(this); // 设置菜单项点击监听器
             }
             mActionMode = mode;
-            mNotesListAdapter.setChoiceMode(true);
-            mNotesListView.setLongClickable(false);
-            mAddNewNote.setVisibility(View.GONE);
-
-            View customView = LayoutInflater.from(NotesListActivity.this).inflate(
-                    R.layout.note_list_dropdown_menu, null);
-            mode.setCustomView(customView);
-            mDropDownMenu = new DropdownMenu(NotesListActivity.this,
-                    (Button) customView.findViewById(R.id.selection_menu),
-                    R.menu.note_list_dropdown);
+            mNotesListAdapter.setChoiceMode(true); // 设置适配器为选择模式
+            mNotesListView.setLongClickable(false); // 禁用长按事件
+            mAddNewNote.setVisibility(View.GONE); // 隐藏新建笔记按钮
+
+            View customView = LayoutInflater.from(NotesListActivity.this).inflate(R.layout.note_list_dropdown_menu, null); // 加载自定义视图
+            mode.setCustomView(customView); // 设置自定义视图
+            mDropDownMenu = new DropdownMenu(NotesListActivity.this, (Button) customView.findViewById(R.id.selection_menu), R.menu.note_list_dropdown); // 创建下拉菜单
             mDropDownMenu.setOnDropdownMenuItemClickListener(new PopupMenu.OnMenuItemClickListener() {
                 public boolean onMenuItemClick(MenuItem item) {
-                    mNotesListAdapter.selectAll(!mNotesListAdapter.isAllSelected());
-                    updateMenu();
+                    mNotesListAdapter.selectAll(!mNotesListAdapter.isAllSelected()); // 选择或取消选择所有项
+                    updateMenu(); // 更新菜单
                     return true;
                 }
-
             });
             return true;
         }
 
         private void updateMenu() {
-            int selectedCount = mNotesListAdapter.getSelectedCount();
-            // Update dropdown menu
+            int selectedCount = mNotesListAdapter.getSelectedCount(); // 获取已选择的项数
+            // 更新下拉菜单
             String format = getResources().getString(R.string.menu_select_title, selectedCount);
             mDropDownMenu.setTitle(format);
             MenuItem item = mDropDownMenu.findItem(R.id.action_select_all);
             if (item != null) {
                 if (mNotesListAdapter.isAllSelected()) {
                     item.setChecked(true);
-                    item.setTitle(R.string.menu_deselect_all);
+                    item.setTitle(R.string.menu_deselect_all); // 设置为取消选择全部
                 } else {
                     item.setChecked(false);
-                    item.setTitle(R.string.menu_select_all);
+                    item.setTitle(R.string.menu_select_all); // 设置为选择全部
                 }
             }
         }
 
         public boolean onPrepareActionMode(ActionMode mode, Menu menu) {
-            // TODO Auto-generated method stub
             return false;
         }
 
         public boolean onActionItemClicked(ActionMode mode, MenuItem item) {
-            // TODO Auto-generated method stub
             return false;
         }
 
         public void onDestroyActionMode(ActionMode mode) {
-            mNotesListAdapter.setChoiceMode(false);
-            mNotesListView.setLongClickable(true);
-            mAddNewNote.setVisibility(View.VISIBLE);
+            mNotesListAdapter.setChoiceMode(false); // 退出选择模式
+            mNotesListView.setLongClickable(true); // 恢复长按事件
+            mAddNewNote.setVisibility(View.VISIBLE); // 显示新建笔记按钮
         }
 
         public void finishActionMode() {
-            mActionMode.finish();
+            mActionMode.finish(); // 结束多选模式
         }
 
-        public void onItemCheckedStateChanged(ActionMode mode, int position, long id,
-                boolean checked) {
-            mNotesListAdapter.setCheckedItem(position, checked);
-            updateMenu();
+        public void onItemCheckedStateChanged(ActionMode mode, int position, long id, boolean checked) {
+            mNotesListAdapter.setCheckedItem(position, checked); // 设置选中状态
+            updateMenu(); // 更新菜单
         }
 
         public boolean onMenuItemClick(MenuItem item) {
             if (mNotesListAdapter.getSelectedCount() == 0) {
-                Toast.makeText(NotesListActivity.this, getString(R.string.menu_select_none),
-                        Toast.LENGTH_SHORT).show();
+                Toast.makeText(NotesListActivity.this, getString(R.string.menu_select_none), Toast.LENGTH_SHORT).show(); // 显示未选择任何项的提示
                 return true;
             }
 
@@ -324,20 +308,17 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
                     AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.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_notes,
-                                             mNotesListAdapter.getSelectedCount()));
-                    builder.setPositiveButton(android.R.string.ok,
-                                             new DialogInterface.OnClickListener() {
-                                                 public void onClick(DialogInterface dialog,
-                                                         int which) {
-                                                     batchDelete();
+                    builder.setMessage(getString(R.string.alert_message_delete_notes, mNotesListAdapter.getSelectedCount())); // 设置删除确认对话框
+                    builder.setPositiveButton(android.R.string.ok, new DialogInterface.OnClickListener() {
+                        public void onClick(DialogInterface dialog, int which) {
+                            batchDelete(); // 批量删除
                         }
                     });
                     builder.setNegativeButton(android.R.string.cancel, null);
                     builder.show();
                     break;
                 case R.id.move:
-                    startQueryDestinationFolders();
+                    startQueryDestinationFolders(); // 开始查询目标文件夹
                     break;
                 default:
                     return false;
@@ -347,36 +328,21 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
     }
 
     private class NewNoteOnTouchListener implements OnTouchListener {
-
         public boolean onTouch(View v, MotionEvent event) {
             switch (event.getAction()) {
-                case MotionEvent.ACTION_DOWN: {
+                case MotionEvent.ACTION_DOWN:
                     Display display = getWindowManager().getDefaultDisplay();
                     int screenHeight = display.getHeight();
                     int newNoteViewHeight = mAddNewNote.getHeight();
                     int start = screenHeight - newNoteViewHeight;
                     int eventY = start + (int) event.getY();
-                    /**
-                     * Minus TitleBar's height
-                     */
                     if (mState == ListEditState.SUB_FOLDER) {
                         eventY -= mTitleBar.getHeight();
                         start -= mTitleBar.getHeight();
                     }
-                    /**
-                     * HACKME:When click the transparent part of "New Note" button, dispatch
-                     * the event to the list view behind this button. The transparent part of
-                     * "New Note" button could be expressed by formula y=-0.12x+94（Unit:pixel）
-                     * and the line top of the button. The coordinate based on left of the "New
-                     * Note" button. The 94 represents maximum height of the transparent part.
-                     * Notice that, if the background of the button changes, the formula should
-                     * also change. This is very bad, just for the UI designer's strong requirement.
-                     */
                     if (event.getY() < (event.getX() * (-0.12) + 94)) {
-                        View view = mNotesListView.getChildAt(mNotesListView.getChildCount() - 1
-                                - mNotesListView.getFooterViewsCount());
-                        if (view != null && view.getBottom() > start
-                                && (view.getTop() < (start + 94))) {
+                        View view = mNotesListView.getChildAt(mNotesListView.getChildCount() - 1 - mNotesListView.getFooterViewsCount());
+                        if (view != null && view.getBottom() > start && (view.getTop() < (start + 94))) {
                             mOriginY = (int) event.getY();
                             mDispatchY = eventY;
                             event.setLocation(event.getX(), mDispatchY);
@@ -385,16 +351,14 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
                         }
                     }
                     break;
-                }
-                case MotionEvent.ACTION_MOVE: {
+                case MotionEvent.ACTION_MOVE:
                     if (mDispatch) {
                         mDispatchY += (int) event.getY() - mOriginY;
                         event.setLocation(event.getX(), mDispatchY);
                         return mNotesListView.dispatchTouchEvent(event);
                     }
                     break;
-                }
-                default: {
+                default:
                     if (mDispatch) {
                         event.setLocation(event.getX(), mDispatchY);
                         mDispatch = false;
@@ -402,19 +366,13 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
                     }
                     break;
             }
-            }
             return false;
         }
-
-    };
+    }
 
     private void startAsyncNotesListQuery() {
-        String selection = (mCurrentFolderId == Notes.ID_ROOT_FOLDER) ? ROOT_FOLDER_SELECTION
-                : NORMAL_SELECTION;
-        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");
+        String selection = (mCurrentFolderId == Notes.ID_ROOT_FOLDER) ? ROOT_FOLDER_SELECTION : NORMAL_SELECTION;
+        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");
     }
 
     private final class BackgroundQueryHandler extends AsyncQueryHandler {
@@ -426,13 +384,13 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         protected void onQueryComplete(int token, Object cookie, Cursor cursor) {
             switch (token) {
                 case FOLDER_NOTE_LIST_QUERY_TOKEN:
-                    mNotesListAdapter.changeCursor(cursor);
+                    mNotesListAdapter.changeCursor(cursor); // 更改游标以更新列表
                     break;
                 case FOLDER_LIST_QUERY_TOKEN:
                     if (cursor != null && cursor.getCount() > 0) {
-                        showFolderListMenu(cursor);
+                        showFolderListMenu(cursor); // 显示文件夹列表菜单
                     } else {
-                        Log.e(TAG, "Query folder failed");
+                        Log.e(TAG, "查询文件夹失败");
                     }
                     break;
                 default:
@@ -446,17 +404,10 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         builder.setTitle(R.string.menu_title_select_folder);
         final FoldersListAdapter adapter = new FoldersListAdapter(this, cursor);
         builder.setAdapter(adapter, new DialogInterface.OnClickListener() {
-
             public void onClick(DialogInterface dialog, int which) {
-                DataUtils.batchMoveToFolder(mContentResolver,
-                        mNotesListAdapter.getSelectedItemIds(), adapter.getItemId(which));
-                Toast.makeText(
-                        NotesListActivity.this,
-                        getString(R.string.format_move_notes_to_folder,
-                                mNotesListAdapter.getSelectedCount(),
-                                adapter.getFolderName(NotesListActivity.this, which)),
-                        Toast.LENGTH_SHORT).show();
-                mModeCallBack.finishActionMode();
+                DataUtils.batchMoveToFolder(mContentResolver, mNotesListAdapter.getSelectedItemIds(), adapter.getItemId(which)); // 批量移动到文件夹
+                Toast.makeText(NotesListActivity.this, getString(R.string.format_move_notes_to_folder, mNotesListAdapter.getSelectedCount(), adapter.getFolderName(NotesListActivity.this, which)), Toast.LENGTH_SHORT).show(); // 显示移动成功的提示
+                mModeCallBack.finishActionMode(); // 结束多选模式
             }
         });
         builder.show();
@@ -466,26 +417,21 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         Intent intent = new Intent(this, NoteEditActivity.class);
         intent.setAction(Intent.ACTION_INSERT_OR_EDIT);
         intent.putExtra(Notes.INTENT_EXTRA_FOLDER_ID, mCurrentFolderId);
-        this.startActivityForResult(intent, REQUEST_CODE_NEW_NODE);
+        this.startActivityForResult(intent, REQUEST_CODE_NEW_NODE); // 启动新建笔记活动
     }
 
     private void batchDelete() {
         new AsyncTask<Void, Void, HashSet<AppWidgetAttribute>>() {
             protected HashSet<AppWidgetAttribute> doInBackground(Void... unused) {
-                HashSet<AppWidgetAttribute> widgets = mNotesListAdapter.getSelectedWidget();
+                HashSet<AppWidgetAttribute> widgets = mNotesListAdapter.getSelectedWidget(); // 获取选中的小部件属性
                 if (!isSyncMode()) {
-                    // if not synced, delete notes directly
-                    if (DataUtils.batchDeleteNotes(mContentResolver, mNotesListAdapter
-                            .getSelectedItemIds())) {
+                    if (DataUtils.batchDeleteNotes(mContentResolver, mNotesListAdapter.getSelectedItemIds())) { // 批量删除笔记
                     } else {
-                        Log.e(TAG, "Delete notes error, should not happens");
+                        Log.e(TAG, "删除笔记错误，不应该发生");
                     }
                 } else {
-                    // in sync mode, we'll move the deleted note into the trash
-                    // folder
-                    if (!DataUtils.batchMoveToFolder(mContentResolver, mNotesListAdapter
-                            .getSelectedItemIds(), Notes.ID_TRASH_FOLER)) {
-                        Log.e(TAG, "Move notes to trash folder error, should not happens");
+                    if (!DataUtils.batchMoveToFolder(mContentResolver, mNotesListAdapter.getSelectedItemIds(), Notes.ID_TRASH_FOLER)) { // 批量移动到回收站文件夹
+                        Log.e(TAG, "移动笔记到回收站文件夹错误，不应该发生");
                     }
                 }
                 return widgets;
@@ -495,39 +441,34 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
             protected void onPostExecute(HashSet<AppWidgetAttribute> widgets) {
                 if (widgets != null) {
                     for (AppWidgetAttribute widget : widgets) {
-                        if (widget.widgetId != AppWidgetManager.INVALID_APPWIDGET_ID
-                                && widget.widgetType != Notes.TYPE_WIDGET_INVALIDE) {
-                            updateWidget(widget.widgetId, widget.widgetType);
+                        if (widget.widgetId != AppWidgetManager.INVALID_APPWIDGET_ID && widget.widgetType != Notes.TYPE_WIDGET_INVALIDE) {
+                            updateWidget(widget.widgetId, widget.widgetType); // 更新小部件
                         }
                     }
                 }
-                mModeCallBack.finishActionMode();
+                mModeCallBack.finishActionMode(); // 结束多选模式
             }
         }.execute();
     }
 
     private void deleteFolder(long folderId) {
         if (folderId == Notes.ID_ROOT_FOLDER) {
-            Log.e(TAG, "Wrong folder id, should not happen " + folderId);
+            Log.e(TAG, "错误的文件夹 ID，不应该发生 " + folderId);
             return;
         }
 
         HashSet<Long> ids = new HashSet<Long>();
         ids.add(folderId);
-        HashSet<AppWidgetAttribute> widgets = DataUtils.getFolderNoteWidget(mContentResolver,
-                folderId);
+        HashSet<AppWidgetAttribute> widgets = DataUtils.getFolderNoteWidget(mContentResolver, folderId);
         if (!isSyncMode()) {
-            // if not synced, delete folder directly
-            DataUtils.batchDeleteNotes(mContentResolver, ids);
+            DataUtils.batchDeleteNotes(mContentResolver, ids); // 批量删除笔记
         } else {
-            // in sync mode, we'll move the deleted folder into the trash folder
-            DataUtils.batchMoveToFolder(mContentResolver, ids, Notes.ID_TRASH_FOLER);
+            DataUtils.batchMoveToFolder(mContentResolver, ids, Notes.ID_TRASH_FOLER); // 批量移动到回收站文件夹
         }
         if (widgets != null) {
             for (AppWidgetAttribute widget : widgets) {
-                if (widget.widgetId != AppWidgetManager.INVALID_APPWIDGET_ID
-                        && widget.widgetType != Notes.TYPE_WIDGET_INVALIDE) {
-                    updateWidget(widget.widgetId, widget.widgetType);
+                if (widget.widgetId != AppWidgetManager.INVALID_APPWIDGET_ID && widget.widgetType != Notes.TYPE_WIDGET_INVALIDE) {
+                    updateWidget(widget.widgetId, widget.widgetType); // 更新小部件
                 }
             }
         }
@@ -537,30 +478,30 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         Intent intent = new Intent(this, NoteEditActivity.class);
         intent.setAction(Intent.ACTION_VIEW);
         intent.putExtra(Intent.EXTRA_UID, data.getId());
-        this.startActivityForResult(intent, REQUEST_CODE_OPEN_NODE);
+        this.startActivityForResult(intent, REQUEST_CODE_OPEN_NODE); // 启动查看笔记活动
     }
 
     private void openFolder(NoteItemData data) {
         mCurrentFolderId = data.getId();
-        startAsyncNotesListQuery();
+        startAsyncNotesListQuery(); // 开始异步查询笔记列表
         if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {
             mState = ListEditState.CALL_RECORD_FOLDER;
-            mAddNewNote.setVisibility(View.GONE);
+            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);
+            mTitleBar.setText(R.string.call_record_folder_name); // 设置标题栏文本为通话记录文件夹名称
         } else {
-            mTitleBar.setText(data.getSnippet());
+            mTitleBar.setText(data.getSnippet()); // 设置标题栏文本为文件夹名称
         }
-        mTitleBar.setVisibility(View.VISIBLE);
+        mTitleBar.setVisibility(View.VISIBLE); // 显示标题栏
     }
 
     public void onClick(View v) {
         switch (v.getId()) {
             case R.id.btn_new_note:
-                createNewNote();
+                createNewNote(); // 创建新笔记
                 break;
             default:
                 break;
@@ -570,13 +511,13 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
     private void showSoftInput() {
         InputMethodManager inputMethodManager = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
         if (inputMethodManager != null) {
-            inputMethodManager.toggleSoftInput(InputMethodManager.SHOW_FORCED, 0);
+            inputMethodManager.toggleSoftInput(InputMethodManager.SHOW_FORCED, 0); // 显示软键盘
         }
     }
 
     private void hideSoftInput(View view) {
         InputMethodManager inputMethodManager = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
-        inputMethodManager.hideSoftInputFromWindow(view.getWindowToken(), 0);
+        inputMethodManager.hideSoftInputFromWindow(view.getWindowToken(), 0); // 隐藏软键盘
     }
 
     private void showCreateOrModifyFolderDialog(final boolean create) {
@@ -586,15 +527,15 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         showSoftInput();
         if (!create) {
             if (mFocusNoteDataItem != null) {
-                etName.setText(mFocusNoteDataItem.getSnippet());
-                builder.setTitle(getString(R.string.menu_folder_change_name));
+                etName.setText(mFocusNoteDataItem.getSnippet()); // 设置文件夹名称
+                builder.setTitle(getString(R.string.menu_folder_change_name)); // 设置对话框标题为更改文件夹名称
             } else {
-                Log.e(TAG, "The long click data item is null");
+                Log.e(TAG, "长按的数据项为空");
                 return;
             }
         } else {
             etName.setText("");
-            builder.setTitle(this.getString(R.string.menu_create_folder));
+            builder.setTitle(this.getString(R.string.menu_create_folder)); // 设置对话框标题为创建文件夹
         }
 
         builder.setPositiveButton(android.R.string.ok, null);
@@ -611,8 +552,7 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
                 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();
+                    Toast.makeText(NotesListActivity.this, getString(R.string.folder_exist, name), Toast.LENGTH_LONG).show(); // 显示文件夹已存在的提示
                     etName.setSelection(0, etName.length());
                     return;
                 }
@@ -622,16 +562,13 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
                         values.put(NoteColumns.SNIPPET, name);
                         values.put(NoteColumns.TYPE, Notes.TYPE_FOLDER);
                         values.put(NoteColumns.LOCAL_MODIFIED, 1);
-                        mContentResolver.update(Notes.CONTENT_NOTE_URI, values, NoteColumns.ID
-                                + "=?", new String[] {
-                            String.valueOf(mFocusNoteDataItem.getId())
-                        });
+                        mContentResolver.update(Notes.CONTENT_NOTE_URI, values, NoteColumns.ID + "=?", new String[] { String.valueOf(mFocusNoteDataItem.getId()) }); // 更新文件夹名称
                     }
                 } else if (!TextUtils.isEmpty(name)) {
                     ContentValues values = new ContentValues();
                     values.put(NoteColumns.SNIPPET, name);
                     values.put(NoteColumns.TYPE, Notes.TYPE_FOLDER);
-                    mContentResolver.insert(Notes.CONTENT_NOTE_URI, values);
+                    mContentResolver.insert(Notes.CONTENT_NOTE_URI, values); // 插入新文件夹
                 }
                 dialog.dismiss();
             }
@@ -640,13 +577,8 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         if (TextUtils.isEmpty(etName.getText())) {
             positive.setEnabled(false);
         }
-        /**
-         * When the name edit text is null, disable the positive button
-         */
         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) {
@@ -658,8 +590,6 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
             }
 
             public void afterTextChanged(Editable s) {
-                // TODO Auto-generated method stub
-
             }
         });
     }
@@ -670,18 +600,18 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
             case SUB_FOLDER:
                 mCurrentFolderId = Notes.ID_ROOT_FOLDER;
                 mState = ListEditState.NOTE_LIST;
-                startAsyncNotesListQuery();
-                mTitleBar.setVisibility(View.GONE);
+                startAsyncNotesListQuery(); // 返回根文件夹
+                mTitleBar.setVisibility(View.GONE); // 隐藏标题栏
                 break;
             case CALL_RECORD_FOLDER:
                 mCurrentFolderId = Notes.ID_ROOT_FOLDER;
                 mState = ListEditState.NOTE_LIST;
-                mAddNewNote.setVisibility(View.VISIBLE);
-                mTitleBar.setVisibility(View.GONE);
-                startAsyncNotesListQuery();
+                mAddNewNote.setVisibility(View.VISIBLE); // 显示新建笔记按钮
+                mTitleBar.setVisibility(View.GONE); // 隐藏标题栏
+                startAsyncNotesListQuery(); // 返回根文件夹
                 break;
             case NOTE_LIST:
-                super.onBackPressed();
+                super.onBackPressed(); // 调用父类的返回键处理方法
                 break;
             default:
                 break;
@@ -695,13 +625,11 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         } else if (appWidgetType == Notes.TYPE_WIDGET_4X) {
             intent.setClass(this, NoteWidgetProvider_4x.class);
         } else {
-            Log.e(TAG, "Unspported widget type");
+            Log.e(TAG, "不支持的小部件类型");
             return;
         }
 
-        intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_IDS, new int[] {
-            appWidgetId
-        });
+        intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_IDS, new int[] { appWidgetId });
 
         sendBroadcast(intent);
         setResult(RESULT_OK, intent);
@@ -710,10 +638,10 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
     private final OnCreateContextMenuListener mFolderOnCreateContextMenuListener = new OnCreateContextMenuListener() {
         public void onCreateContextMenu(ContextMenu menu, View v, ContextMenuInfo menuInfo) {
             if (mFocusNoteDataItem != null) {
-                menu.setHeaderTitle(mFocusNoteDataItem.getSnippet());
-                menu.add(0, MENU_FOLDER_VIEW, 0, R.string.menu_folder_view);
-                menu.add(0, MENU_FOLDER_DELETE, 0, R.string.menu_folder_delete);
-                menu.add(0, MENU_FOLDER_CHANGE_NAME, 0, R.string.menu_folder_change_name);
+                menu.setHeaderTitle(mFocusNoteDataItem.getSnippet()); // 设置上下文菜单标题为文件夹名称
+                menu.add(0, MENU_FOLDER_VIEW, 0, R.string.menu_folder_view); // 添加查看文件夹菜单项
+                menu.add(0, MENU_FOLDER_DELETE, 0, R.string.menu_folder_delete); // 添加删除文件夹菜单项
+                menu.add(0, MENU_FOLDER_CHANGE_NAME, 0, R.string.menu_folder_change_name); // 添加更改文件夹名称菜单项
             }
         }
     };
@@ -721,7 +649,7 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
     @Override
     public void onContextMenuClosed(Menu menu) {
         if (mNotesListView != null) {
-            mNotesListView.setOnCreateContextMenuListener(null);
+            mNotesListView.setOnCreateContextMenuListener(null); // 移除上下文菜单创建监听器
         }
         super.onContextMenuClosed(menu);
     }
@@ -729,29 +657,28 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
     @Override
     public boolean onContextItemSelected(MenuItem item) {
         if (mFocusNoteDataItem == null) {
-            Log.e(TAG, "The long click data item is null");
+            Log.e(TAG, "长按的数据项为空");
             return false;
         }
         switch (item.getItemId()) {
             case MENU_FOLDER_VIEW:
-                openFolder(mFocusNoteDataItem);
+                openFolder(mFocusNoteDataItem); // 打开文件夹
                 break;
             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.setMessage(getString(R.string.alert_message_delete_folder));
-                builder.setPositiveButton(android.R.string.ok,
-                        new DialogInterface.OnClickListener() {
+                builder.setMessage(getString(R.string.alert_message_delete_folder)); // 设置删除文件夹确认对话框
+                builder.setPositiveButton(android.R.string.ok, new DialogInterface.OnClickListener() {
                     public void onClick(DialogInterface dialog, int which) {
-                                deleteFolder(mFocusNoteDataItem.getId());
+                        deleteFolder(mFocusNoteDataItem.getId()); // 删除文件夹
                     }
                 });
                 builder.setNegativeButton(android.R.string.cancel, null);
                 builder.show();
                 break;
             case MENU_FOLDER_CHANGE_NAME:
-                showCreateOrModifyFolderDialog(false);
+                showCreateOrModifyFolderDialog(false); // 显示创建或修改文件夹对话框
                 break;
             default:
                 break;
@@ -765,50 +692,64 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         menu.clear();
         if (mState == ListEditState.NOTE_LIST) {
             getMenuInflater().inflate(R.menu.note_list, menu);
-            // set sync or sync_cancel
-            menu.findItem(R.id.menu_sync).setTitle(
-                    GTaskSyncService.isSyncing() ? R.string.menu_sync_cancel : R.string.menu_sync);
+            menu.findItem(R.id.menu_sync).setTitle(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.CALL_RECORD_FOLDER) {
             getMenuInflater().inflate(R.menu.call_record_folder, menu);
         } else {
-            Log.e(TAG, "Wrong state:" + mState);
+            Log.e(TAG, "错误的状态：" + mState);
         }
+
+        if(mode==-1)menu.findItem(R.id.menu_graygoo).setVisible(false);
+        else if(mode==0)menu.findItem(R.id.menu_miku).setVisible(false);
+        else if(mode==1)menu.findItem(R.id.menu_hutao).setVisible(false);
         return true;
     }
 
     @Override
     public boolean onOptionsItemSelected(MenuItem item) {
+
         switch (item.getItemId()) {
-            case R.id.menu_new_folder: {
-                showCreateOrModifyFolderDialog(true);
+            case R.id.menu_graygoo:{
+                mode=-1;
+                getWindow().setBackgroundDrawableResource(R.drawable.graygoo);
+                break;
+            }
+            case R.id.menu_miku:{
+                mode=0;
+                getWindow().setBackgroundDrawableResource(R.drawable.miku);
                 break;
             }
-            case R.id.menu_export_text: {
-                exportNoteToText();
+            case R.id.menu_hutao:{
+                mode=1;
+                getWindow().setBackgroundDrawableResource(R.drawable.hutao);
                 break;
             }
-            case R.id.menu_sync: {
+
+            case R.id.menu_new_folder:
+                showCreateOrModifyFolderDialog(true); // 显示创建文件夹对话框
+                break;
+            case R.id.menu_export_text:
+                exportNoteToText(); // 导出笔记为文本文件
+                break;
+            case R.id.menu_sync:
                 if (isSyncMode()) {
                     if (TextUtils.equals(item.getTitle(), getString(R.string.menu_sync))) {
-                        GTaskSyncService.startSync(this);
+                        GTaskSyncService.startSync(this); // 开始同步
                     } else {
-                        GTaskSyncService.cancelSync(this);
+                        GTaskSyncService.cancelSync(this); // 取消同步
                     }
                 } else {
-                    startPreferenceActivity();
+                    startPreferenceActivity(); // 启动偏好设置活动
                 }
                 break;
-            }
-            case R.id.menu_setting: {
-                startPreferenceActivity();
+            case R.id.menu_setting:
+                startPreferenceActivity(); // 启动偏好设置活动
                 break;
-            }
-            case R.id.menu_new_note: {
-                createNewNote();
+            case R.id.menu_new_note:
+                createNewNote(); // 创建新笔记
                 break;
-            }
             case R.id.menu_search:
                 onSearchRequested();
                 break;
@@ -820,7 +761,7 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
 
     @Override
     public boolean onSearchRequested() {
-        startSearch(null, false, null /* appData */, false);
+        startSearch(null, false, null, false);
         return true;
     }
 
@@ -830,34 +771,27 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
 
             @Override
             protected Integer doInBackground(Void... unused) {
-                return backup.exportToText();
+                return backup.exportToText(); // 导出笔记为文本文件
             }
 
             @Override
             protected void onPostExecute(Integer result) {
                 if (result == BackupUtils.STATE_SD_CARD_UNMOUONTED) {
                     AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
-                    builder.setTitle(NotesListActivity.this
-                            .getString(R.string.failed_sdcard_export));
-                    builder.setMessage(NotesListActivity.this
-                            .getString(R.string.error_sdcard_unmounted));
+                    builder.setTitle(NotesListActivity.this.getString(R.string.failed_sdcard_export));
+                    builder.setMessage(NotesListActivity.this.getString(R.string.error_sdcard_unmounted));
                     builder.setPositiveButton(android.R.string.ok, null);
                     builder.show();
                 } else if (result == BackupUtils.STATE_SUCCESS) {
                     AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
-                    builder.setTitle(NotesListActivity.this
-                            .getString(R.string.success_sdcard_export));
-                    builder.setMessage(NotesListActivity.this.getString(
-                            R.string.format_exported_file_location, backup
-                                    .getExportedTextFileName(), backup.getExportedTextFileDir()));
+                    builder.setTitle(NotesListActivity.this.getString(R.string.success_sdcard_export));
+                    builder.setMessage(NotesListActivity.this.getString(R.string.format_exported_file_location, backup.getExportedTextFileName(), backup.getExportedTextFileDir()));
                     builder.setPositiveButton(android.R.string.ok, null);
                     builder.show();
                 } else if (result == BackupUtils.STATE_SYSTEM_ERROR) {
                     AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
-                    builder.setTitle(NotesListActivity.this
-                            .getString(R.string.failed_sdcard_export));
-                    builder.setMessage(NotesListActivity.this
-                            .getString(R.string.error_sdcard_export));
+                    builder.setTitle(NotesListActivity.this.getString(R.string.failed_sdcard_export));
+                    builder.setMessage(NotesListActivity.this.getString(R.string.error_sdcard_export));
                     builder.setPositiveButton(android.R.string.ok, null);
                     builder.show();
                 }
@@ -867,13 +801,13 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
     }
 
     private boolean isSyncMode() {
-        return NotesPreferenceActivity.getSyncAccountName(this).trim().length() > 0;
+        return NotesPreferenceActivity.getSyncAccountName(this).trim().length() > 0; // 判断是否为同步模式
     }
 
     private void startPreferenceActivity() {
         Activity from = getParent() != null ? getParent() : this;
         Intent intent = new Intent(from, NotesPreferenceActivity.class);
-        from.startActivityIfNeeded(intent, -1);
+        from.startActivityIfNeeded(intent, -1); // 启动偏好设置活动
     }
 
     private class OnListItemClickListener implements OnItemClickListener {
@@ -884,29 +818,27 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
                 if (mNotesListAdapter.isInChoiceMode()) {
                     if (item.getType() == Notes.TYPE_NOTE) {
                         position = position - mNotesListView.getHeaderViewsCount();
-                        mModeCallBack.onItemCheckedStateChanged(null, position, id,
-                                !mNotesListAdapter.isSelectedItem(position));
+                        mModeCallBack.onItemCheckedStateChanged(null, position, id, !mNotesListAdapter.isSelectedItem(position)); // 切换选中状态
                     }
                     return;
                 }
 
                 switch (mState) {
                     case NOTE_LIST:
-                        if (item.getType() == Notes.TYPE_FOLDER
-                                || item.getType() == Notes.TYPE_SYSTEM) {
-                            openFolder(item);
+                        if (item.getType() == Notes.TYPE_FOLDER || item.getType() == Notes.TYPE_SYSTEM) {
+                            openFolder(item); // 打开文件夹
                         } else if (item.getType() == Notes.TYPE_NOTE) {
-                            openNode(item);
+                            openNode(item); // 打开笔记
                         } else {
-                            Log.e(TAG, "Wrong note type in NOTE_LIST");
+                            Log.e(TAG, "笔记列表中的错误笔记类型");
                         }
                         break;
                     case SUB_FOLDER:
                     case CALL_RECORD_FOLDER:
                         if (item.getType() == Notes.TYPE_NOTE) {
-                            openNode(item);
+                            openNode(item); // 打开笔记
                         } else {
-                            Log.e(TAG, "Wrong note type in SUB_FOLDER");
+                            Log.e(TAG, "子文件夹中的错误笔记类型");
                         }
                         break;
                     default:
@@ -919,20 +851,8 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
 
     private void startQueryDestinationFolders() {
         String selection = NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>? AND " + NoteColumns.ID + "<>?";
-        selection = (mState == ListEditState.NOTE_LIST) ? selection:
-            "(" + selection + ") OR (" + NoteColumns.ID + "=" + Notes.ID_ROOT_FOLDER + ")";
-
-        mBackgroundQueryHandler.startQuery(FOLDER_LIST_QUERY_TOKEN,
-                null,
-                Notes.CONTENT_NOTE_URI,
-                FoldersListAdapter.PROJECTION,
-                selection,
-                new String[] {
-                        String.valueOf(Notes.TYPE_FOLDER),
-                        String.valueOf(Notes.ID_TRASH_FOLER),
-                        String.valueOf(mCurrentFolderId)
-                },
-                NoteColumns.MODIFIED_DATE + " DESC");
+        selection = (mState == ListEditState.NOTE_LIST) ? selection : "(" + selection + ") OR (" + NoteColumns.ID + "=" + Notes.ID_ROOT_FOLDER + ")";
+        mBackgroundQueryHandler.startQuery(FOLDER_LIST_QUERY_TOKEN, null, Notes.CONTENT_NOTE_URI, FoldersListAdapter.PROJECTION, selection, new String[] { String.valueOf(Notes.TYPE_FOLDER), String.valueOf(Notes.ID_TRASH_FOLER), String.valueOf(mCurrentFolderId) }, NoteColumns.MODIFIED_DATE + " DESC");
     }
 
     public boolean onItemLongClick(AdapterView<?> parent, View view, int position, long id) {
@@ -940,13 +860,13 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
             mFocusNoteDataItem = ((NotesListItem) view).getItemData();
             if (mFocusNoteDataItem.getType() == Notes.TYPE_NOTE && !mNotesListAdapter.isInChoiceMode()) {
                 if (mNotesListView.startActionMode(mModeCallBack) != null) {
-                    mModeCallBack.onItemCheckedStateChanged(null, position, id, true);
-                    mNotesListView.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS);
+                    mModeCallBack.onItemCheckedStateChanged(null, position, id, true); // 进入多选模式并选中当前项
+                    mNotesListView.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS); // 执行触觉反馈
                 } else {
-                    Log.e(TAG, "startActionMode fails");
+                    Log.e(TAG, "进入多选模式失败");
                 }
             } else if (mFocusNoteDataItem.getType() == Notes.TYPE_FOLDER) {
-                mNotesListView.setOnCreateContextMenuListener(mFolderOnCreateContextMenuListener);
+                mNotesListView.setOnCreateContextMenuListener(mFolderOnCreateContextMenuListener); // 设置上下文菜单创建监听器
             }
         }
         return false;

src/main/res/layout/note_list.xml

@@ -18,8 +18,8 @@
 <FrameLayout
     xmlns:android="http://schemas.android.com/apk/res/android"
     android:layout_width="fill_parent"
-    android:layout_height="fill_parent"
-    android:background="@drawable/list_background">
+    android:layout_height="fill_parent">
+<!--    android:background="@drawable/list_background">-->
 
     <LinearLayout
         android:layout_width="fill_parent"

src/main/res/menu/note_list.xml

@@ -36,4 +36,16 @@
     <item
         android:id="@+id/menu_search"
         android:title="@string/menu_search"/>
+
+    <item
+            android:id="@+id/menu_graygoo"
+            android:title="@string/menu_graygoo"/>
+
+    <item
+            android:id="@+id/menu_miku"
+            android:title="@string/menu_miku"/>
+
+    <item
+            android:id="@+id/menu_hutao"
+            android:title="@string/menu_hutao"/>
 </menu>

src/main/res/values/strings.xml

@@ -39,6 +39,10 @@
     <string name="file_path">/MIUI/notes/</string>
     <string name="file_name_txt_format">notes_%s.txt</string>
     <!-- notes list string -->
+    <string name="menu_graygoo">Background: graygoo</string>
+    <string name="menu_miku">Background: miku</string>
+    <string name="menu_hutao">Background: hutao</string>
+
     <string name="format_folder_files_count">(%d)</string>
     <string name="menu_create_folder">New Folder</string>
     <string name="menu_export_text">Export text</string>