修改后的质量分析报告

# Conflicts:
#	doc/小米便签泛读、标注和维护报告文档.docx
#	doc/小米便签泛读报告.docx

src/data/Contact.java

@@ -0,0 +1,135 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.data;
+
+import android.content.Context;
+import android.database.Cursor;
+import android.provider.ContactsContract.CommonDataKinds.Phone;
+import android.provider.ContactsContract.Data;
+import android.telephony.PhoneNumberUtils;
+import android.util.Log;
+
+import java.util.HashMap;
+
+/**
+ * <p>联系人信息查询和缓存类。</p>
+ * <p>核心职责：</p>
+ * <ul>
+ * <li>通过电话号码查询联系人姓名</li>
+ * <li>缓存查询结果以提高性能</li>
+ * <li>使用Android联系人API进行查询</li>
+ * </ul>
+ * <p>设计意图：</p>
+ * <ul>
+ * <li>提供便捷的联系人信息查询接口</li>
+ * <li>减少重复查询数据库的次数</li>
+ * <li>优化通话便签中显示联系人姓名的性能</li>
+ * </ul>
+ * <p>关键关联：</p>
+ * <ul>
+ * <li>使用{@link Context}访问系统联系人Content Provider</li>
+ * <li>使用{@link HashMap}实现查询结果缓存</li>
+ * <li>被通话便签功能使用，显示来电者姓名</li>
+ * </ul>
+ */
+public class Contact {
+    /**
+     * <p>联系人缓存，存储电话号码和联系人姓名的映射。</p>
+     * <p>业务含义：避免重复查询相同电话号码的联系人信息，提高性能。</p>
+     * <p>实现：使用HashMap存储，电话号码为键，联系人为值。</p>
+     */
+    private static HashMap<String, String> sContactCache;
+    
+    /**
+     * <p>日志标签。</p>
+     * <p>业务含义：用于在日志中标识Contact类的相关操作。</p>
+     */
+    private static final String TAG = "Contact";
+
+    /**
+     * <p>联系人查询条件。</p>
+     * <p>业务含义：定义查询联系人信息的SQL条件，使用PHONE_NUMBERS_EQUAL函数匹配电话号码。</p>
+     * <p>注意：其中的'+'会在查询时被替换为实际的电话号码匹配模式。</p>
+     */
+    private static final String CALLER_ID_SELECTION = "PHONE_NUMBERS_EQUAL(" + Phone.NUMBER
+    + ",?) AND " + Data.MIMETYPE + "='" + Phone.CONTENT_ITEM_TYPE + "'"
+    + " AND " + Data.RAW_CONTACT_ID + " IN "
+            + "(SELECT raw_contact_id "
+            + " FROM phone_lookup"
+            + " WHERE min_match = '+')";
+
+    /**
+     * <p>根据电话号码获取联系人姓名。</p>
+     * <p>功能：通过电话号码查询手机通讯录中的联系人姓名，并缓存结果。</p>
+     * 
+     * @param context 上下文对象，用于访问ContentResolver
+     * @param phoneNumber 电话号码，用于查询联系人
+     * 
+     * @return 联系人姓名，如果未找到则返回null
+     * 
+     * <p>查询流程：</p>
+     * <ol>
+     * <li>检查缓存中是否已存在该电话号码的联系人信息</li>
+     * <li>如果缓存中存在，直接返回缓存的联系人姓名</li>
+     * <li>如果缓存中不存在，构建查询条件</li>
+     * <li>通过ContentResolver查询联系人Content Provider</li>
+     * <li>如果查询成功，获取联系人姓名并缓存</li>
+     * <li>关闭Cursor</li>
+     * <li>返回查询结果</li>
+     * </ol>
+     * 
+     * <p>错误处理：</p>
+     * <ul>
+     * <li>如果查询过程中发生IndexOutOfBoundsException，记录错误日志并返回null</li>
+     * <li>如果未找到匹配的联系人，记录调试日志并返回null</li>
+     * </ul>
+     */
+    public static String getContact(Context context, String phoneNumber) {
+        if(sContactCache == null) {
+            sContactCache = new HashMap<String, String>();
+        }
+
+        if(sContactCache.containsKey(phoneNumber)) {
+            return sContactCache.get(phoneNumber);
+        }
+
+        String selection = CALLER_ID_SELECTION.replace("+",
+                PhoneNumberUtils.toCallerIDMinMatch(phoneNumber));
+        Cursor cursor = context.getContentResolver().query(
+                Data.CONTENT_URI,
+                new String [] { Phone.DISPLAY_NAME },
+                selection,
+                new String[] { phoneNumber },
+                null);
+
+        if (cursor != null && cursor.moveToFirst()) {
+            try {
+                String name = cursor.getString(0);
+                sContactCache.put(phoneNumber, name);
+                return name;
+            } catch (IndexOutOfBoundsException e) {
+                Log.e(TAG, " Cursor get string error " + e.toString());
+                return null;
+            } finally {
+                cursor.close();
+            }
+        } else {
+            Log.d(TAG, "No contact matched with number:" + phoneNumber);
+            return null;
+        }
+    }
+}

src/data/Notes.java

@@ -0,0 +1,578 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.data;
+
+import android.net.Uri;
+
+/**
+ * 便签应用的核心数据定义类，包含所有常量、URI和数据列定义
+ * <p>
+ * 核心职责：
+ * <ul>
+ *   <li>定义便签和文件夹的类型常量</li>
+ *   <li>定义系统文件夹的ID常量</li>
+ *   <li>定义Intent传递的额外数据键</li>
+ *   <li>定义Widget类型常量</li>
+ *   <li>定义Content Provider的URI</li>
+ *   <li>定义数据列接口和内部数据类</li>
+ * </ul>
+ * <p>
+ * 设计意图：
+ * <ul>
+ *   <li>集中管理所有数据相关的常量，提高代码的可维护性</li>
+ *   <li>为Content Provider提供统一的数据定义</li>
+ *   <li>为应用各组件间的通信提供标准常量</li>
+ *   <li>支持多种便签类型（文本便签、通话便签）</li>
+ *   <li>支持便签的分类管理（文件夹、回收站）</li>
+ *   <li>支持Widget功能</li>
+ * </ul>
+ * <p>
+ * 与其他类的关键关联：
+ * <ul>
+ *   <li>被{@link NotesProvider}使用，作为Content Provider的数据源定义</li>
+ *   <li>被{@link NotesDatabaseHelper}使用，用于数据库表结构定义</li>
+ *   <li>被UI组件使用，用于Intent传递和数据查询</li>
+ *   <li>被Widget组件使用，用于Widget类型定义和数据传递</li>
+ * </ul>
+ *
+
+ */
+public class Notes {
+    /**
+     * Content Provider的Authority，用于标识便签应用的Content Provider
+     */
+    public static final String AUTHORITY = "micode_notes";
+
+    /**
+     * 日志标签，用于调试和日志记录
+     */
+    public static final String TAG = "Notes";
+
+    /**
+     * 便签类型常量：普通便签
+     */
+    public static final int TYPE_NOTE     = 0;
+
+    /**
+     * 便签类型常量：文件夹
+     */
+    public static final int TYPE_FOLDER   = 1;
+
+    /**
+     * 便签类型常量：系统类型（保留用于系统内部使用）
+     */
+    public static final int TYPE_SYSTEM   = 2;
+
+    /**
+     * 系统文件夹ID：根文件夹，所有普通便签的默认父文件夹
+     */
+    public static final int ID_ROOT_FOLDER = 0;
+
+    /**
+     * 系统文件夹ID：临时文件夹，用于存放无归属的便签
+     */
+    public static final int ID_TEMPARAY_FOLDER = -1;
+
+    /**
+     * 系统文件夹ID：通话记录文件夹，用于存放自动生成的通话便签
+     */
+    public static final int ID_CALL_RECORD_FOLDER = -2;
+
+    /**
+     * 系统文件夹ID：回收站文件夹，用于存放已删除的便签
+     */
+    public static final int ID_TRASH_FOLER = -3;
+
+    /**
+     * Intent额外数据键：提醒日期，用于传递便签的提醒时间
+     */
+    public static final String INTENT_EXTRA_ALERT_DATE = "net.micode.notes.alert_date";
+
+    /**
+     * Intent额外数据键：背景颜色ID，用于传递便签的背景颜色设置
+     */
+    public static final String INTENT_EXTRA_BACKGROUND_ID = "net.micode.notes.background_color_id";
+
+    /**
+     * Intent额外数据键：Widget ID，用于传递Widget的唯一标识
+     */
+    public static final String INTENT_EXTRA_WIDGET_ID = "net.micode.notes.widget_id";
+
+    /**
+     * Intent额外数据键：Widget类型，用于传递Widget的类型（2x或4x）
+     */
+    public static final String INTENT_EXTRA_WIDGET_TYPE = "net.micode.notes.widget_type";
+
+    /**
+     * Intent额外数据键：文件夹ID，用于传递便签所属的文件夹ID
+     */
+    public static final String INTENT_EXTRA_FOLDER_ID = "net.micode.notes.folder_id";
+
+    /**
+     * Intent额外数据键：通话日期，用于传递通话记录的日期
+     */
+    public static final String INTENT_EXTRA_CALL_DATE = "net.micode.notes.call_date";
+
+    /**
+     * Widget类型常量：无效Widget类型
+     */
+    public static final int TYPE_WIDGET_INVALIDE      = -1;
+
+    /**
+     * Widget类型常量：2x尺寸Widget（2x2网格）
+     */
+    public static final int TYPE_WIDGET_2X            = 0;
+
+    /**
+     * Widget类型常量：4x尺寸Widget（4x4网格）
+     */
+    public static final int TYPE_WIDGET_4X            = 1;
+
+    /**
+     * 数据类型常量类，定义不同类型便签的MIME类型
+     * <p>
+     * 核心职责：
+     * <ul>
+     *   <li>提供统一的数据类型访问入口</li>
+     *   <li>封装不同类型便签的MIME类型定义</li>
+     * </ul>
+     */
+    public static class DataConstants {
+        /**
+         * 文本便签的MIME类型
+         */
+        public static final String NOTE = TextNote.CONTENT_ITEM_TYPE;
+
+        /**
+         * 通话便签的MIME类型
+         */
+        public static final String CALL_NOTE = CallNote.CONTENT_ITEM_TYPE;
+    }
+
+    /**
+     * Content Provider URI：用于查询所有便签和文件夹
+     * <p>
+     * 该URI指向Content Provider的note表，返回所有便签和文件夹的列表
+     */
+    public static final Uri CONTENT_NOTE_URI = Uri.parse("content://" + AUTHORITY + "/note");
+
+    /**
+     * Content Provider URI：用于查询便签详细数据
+     * <p>
+     * 该URI指向Content Provider的data表，返回便签的具体内容数据
+     */
+    public static final Uri CONTENT_DATA_URI = Uri.parse("content://" + AUTHORITY + "/data");
+
+    /**
+     * 便签和文件夹的通用列定义接口
+     * <p>
+     * 核心职责：
+     * <ul>
+     *   <li>定义便签和文件夹表的通用字段</li>
+     *   <li>为Content Provider提供统一的列名定义</li>
+     *   <li>支持便签和文件夹的基本属性存储</li>
+     * </ul>
+     * <p>
+     * 设计意图：
+     * <ul>
+     *   <li>使用接口定义列名，便于在不同组件间共享</li>
+     *   <li>支持便签和文件夹的统一管理</li>
+     *   <li>包含基本的元数据字段（创建时间、修改时间、ID等）</li>
+     *   <li>支持便签的提醒功能</li>
+     *   <li>支持便签的Widget关联</li>
+     *   <li>支持便签的背景颜色设置</li>
+     *   <li>支持便签的同步功能</li>
+     * </ul>
+     * <p>
+     * 与其他类的关联：
+     * <ul>
+     *   <li>被{@link NotesProvider}使用，作为查询和操作的列名</li>
+     *   <li>被{@link NotesDatabaseHelper}使用，用于创建数据库表</li>
+     *   <li>被UI组件使用，用于构建查询条件和显示数据</li>
+     * </ul>
+     */
+    public interface NoteColumns {
+        /**
+         * 行的唯一标识符
+         * <p>类型: INTEGER (long)</p>
+         * <p>约束: 主键，自增长</p>
+         */
+        public static final String ID = "_id";
+
+        /**
+         * 便签或文件夹的父级ID
+         * <p>类型: INTEGER (long)</p>
+         * <p>约束: 指向同一表中的ID字段</p>
+         * <p>用途: 用于构建便签和文件夹的层级结构</p>
+         */
+        public static final String PARENT_ID = "parent_id";
+
+        /**
+         * 便签或文件夹的创建时间
+         * <p>类型: INTEGER (long)</p>
+         * <p>约束: Unix时间戳，毫秒级</p>
+         * <p>用途: 记录创建时间，用于排序和显示</p>
+         */
+        public static final String CREATED_DATE = "created_date";
+
+        /**
+         * 最近修改时间
+         * <p>类型: INTEGER (long)</p>
+         * <p>约束: Unix时间戳，毫秒级</p>
+         * <p>用途: 记录最后修改时间，用于排序、同步和显示</p>
+         */
+        public static final String MODIFIED_DATE = "modified_date";
+
+        /**
+         * 提醒日期
+         * <p>类型: INTEGER (long)</p>
+         * <p>约束: Unix时间戳，毫秒级；0表示无提醒</p>
+         * <p>用途: 用于便签的提醒功能，指定提醒时间</p>
+         */
+        public static final String ALERTED_DATE = "alert_date";
+
+        /**
+         * 文件夹名称或便签文本内容的摘要
+         * <p>类型: TEXT</p>
+         * <p>约束: 最大长度根据数据库配置而定</p>
+         * <p>用途: 快速显示便签或文件夹的基本信息</p>
+         */
+        public static final String SNIPPET = "snippet";
+
+        /**
+         * 便签关联的Widget ID
+         * <p>类型: INTEGER (long)</p>
+         * <p>约束: -1表示无关联Widget</p>
+         * <p>用途: 用于关联便签和对应的Widget组件</p>
+         */
+        public static final String WIDGET_ID = "widget_id";
+
+        /**
+         * 便签关联的Widget类型
+         * <p>类型: INTEGER (long)</p>
+         * <p>约束: 取值范围为{@link Notes#TYPE_WIDGET_INVALIDE}、{@link Notes#TYPE_WIDGET_2X}、{@link Notes#TYPE_WIDGET_4X}</p>
+         * <p>用途: 用于标识关联Widget的尺寸类型</p>
+         */
+        public static final String WIDGET_TYPE = "widget_type";
+
+        /**
+         * 便签背景颜色的ID
+         * <p>类型: INTEGER (long)</p>
+         * <p>约束: 指向预定义的颜色资源ID</p>
+         * <p>用途: 用于设置和显示便签的背景颜色</p>
+         */
+        public static final String BG_COLOR_ID = "bg_color_id";
+
+        /**
+         * 是否包含附件
+         * <p>类型: INTEGER</p>
+         * <p>约束: 0表示无附件，1表示有附件</p>
+         * <p>用途: 用于标识便签是否包含多媒体附件</p>
+         */
+        public static final String HAS_ATTACHMENT = "has_attachment";
+
+        /**
+         * 文件夹包含的便签数量
+         * <p>类型: INTEGER (long)</p>
+         * <p>约束: 非负数</p>
+         * <p>用途: 用于快速显示文件夹中的便签数量</p>
+         */
+        public static final String NOTES_COUNT = "notes_count";
+
+        /**
+         * 类型：文件夹或便签
+         * <p>类型: INTEGER</p>
+         * <p>约束: 取值范围为{@link Notes#TYPE_NOTE}、{@link Notes#TYPE_FOLDER}、{@link Notes#TYPE_SYSTEM}</p>
+         * <p>用途: 用于区分便签和文件夹</p>
+         */
+        public static final String TYPE = "type";
+
+        /**
+         * 最后同步ID
+         * <p>类型: INTEGER (long)</p>
+         * <p>约束: 用于同步机制，标识同步状态</p>
+         * <p>用途: 用于便签的云同步功能，跟踪同步进度</p>
+         */
+        public static final String SYNC_ID = "sync_id";
+
+        /**
+         * 本地修改标记
+         * <p>类型: INTEGER</p>
+         * <p>约束: 0表示未修改，1表示已修改</p>
+         * <p>用途: 用于同步机制，标识本地是否有未同步的修改</p>
+         */
+        public static final String LOCAL_MODIFIED = "local_modified";
+
+        /**
+         * 移动到临时文件夹前的原始父ID
+         * <p>类型: INTEGER</p>
+         * <p>约束: 指向原父文件夹的ID</p>
+         * <p>用途: 用于临时文件夹中的便签，便于恢复到原位置</p>
+         */
+        public static final String ORIGIN_PARENT_ID = "origin_parent_id";
+
+        /**
+         * Google Task ID
+         * <p>类型: TEXT</p>
+         * <p>约束: 与Google Task服务同步时使用</p>
+         * <p>用途: 用于便签与Google Task的同步功能</p>
+         */
+        public static final String GTASK_ID = "gtask_id";
+
+        /**
+         * 版本号
+         * <p>类型: INTEGER (long)</p>
+         * <p>约束: 用于乐观锁机制，防止并发修改冲突</p>
+         * <p>用途: 用于同步和并发控制，确保数据一致性</p>
+         */
+        public static final String VERSION = "version";
+    }
+
+    /**
+     * 便签详细数据的列定义接口
+     * <p>
+     * 核心职责：
+     * <ul>
+     *   <li>定义便签详细数据表的通用字段</li>
+     *   <li>为不同类型的便签数据提供统一的存储结构</li>
+     *   <li>支持便签内容的扩展存储</li>
+     * </ul>
+     * <p>
+     * 设计意图：
+     * <ul>
+     *   <li>使用接口定义列名，便于在不同组件间共享</li>
+     *   <li>支持多种类型的便签数据存储（文本便签、通话便签等）</li>
+     *   <li>采用通用字段设计，便于扩展新的便签类型</li>
+     *   <li>包含基本的元数据字段（创建时间、修改时间、ID等）</li>
+     *   <li>支持便签内容的灵活存储</li>
+     * </ul>
+     * <p>
+     * 与其他类的关联：
+     * <ul>
+     *   <li>被{@link NotesProvider}使用，作为查询和操作的列名</li>
+     *   <li>被{@link NotesDatabaseHelper}使用，用于创建数据库表</li>
+     *   <li>被{@link TextNote}和{@link CallNote}内部类继承，用于定义特定类型便签的字段映射</li>
+     * </ul>
+     */
+    public interface DataColumns {
+        /**
+         * 行的唯一标识符
+         * <p>类型: INTEGER (long)</p>
+         * <p>约束: 主键，自增长</p>
+         */
+        public static final String ID = "_id";
+
+        /**
+         * 该行数据表示的项目的MIME类型
+         * <p>类型: TEXT</p>
+         * <p>约束: 唯一标识数据类型，如"text_note"、"call_note"等</p>
+         * <p>用途: 用于区分不同类型的便签数据</p>
+         */
+        public static final String MIME_TYPE = "mime_type";
+
+        /**
+         * 该数据所属的便签ID
+         * <p>类型: INTEGER (long)</p>
+         * <p>约束: 外键，指向note表的ID字段</p>
+         * <p>用途: 建立便签基本信息与详细数据的关联关系</p>
+         */
+        public static final String NOTE_ID = "note_id";
+
+        /**
+         * 数据的创建时间
+         * <p>类型: INTEGER (long)</p>
+         * <p>约束: Unix时间戳，毫秒级</p>
+         * <p>用途: 记录创建时间，用于排序和显示</p>
+         */
+        public static final String CREATED_DATE = "created_date";
+
+        /**
+         * 数据的最近修改时间
+         * <p>类型: INTEGER (long)</p>
+         * <p>约束: Unix时间戳，毫秒级</p>
+         * <p>用途: 记录最后修改时间，用于排序、同步和显示</p>
+         */
+        public static final String MODIFIED_DATE = "modified_date";
+
+        /**
+         * 数据的内容
+         * <p>类型: TEXT</p>
+         * <p>约束: 可变长度，存储便签的实际内容</p>
+         * <p>用途: 存储便签的文本内容或其他主要数据</p>
+         */
+        public static final String CONTENT = "content";
+
+        /**
+         * 通用数据列1，含义由{@link #MIME_TYPE}决定，用于整数数据类型
+         * <p>类型: INTEGER</p>
+         * <p>约束: 含义取决于具体的MIME类型</p>
+         * <p>用途: 用于存储特定类型便签的额外整数数据</p>
+         * <p>例如: 文本便签用于存储模式（普通模式/ checklist模式）</p>
+         */
+        public static final String DATA1 = "data1";
+
+        /**
+         * 通用数据列2，含义由{@link #MIME_TYPE}决定，用于整数数据类型
+         * <p>类型: INTEGER</p>
+         * <p>约束: 含义取决于具体的MIME类型</p>
+         * <p>用途: 用于存储特定类型便签的额外整数数据</p>
+         */
+        public static final String DATA2 = "data2";
+
+        /**
+         * 通用数据列3，含义由{@link #MIME_TYPE}决定，用于文本数据类型
+         * <p>类型: TEXT</p>
+         * <p>约束: 含义取决于具体的MIME类型</p>
+         * <p>用途: 用于存储特定类型便签的额外文本数据</p>
+         * <p>例如: 通话便签用于存储电话号码</p>
+         */
+        public static final String DATA3 = "data3";
+
+        /**
+         * 通用数据列4，含义由{@link #MIME_TYPE}决定，用于文本数据类型
+         * <p>类型: TEXT</p>
+         * <p>约束: 含义取决于具体的MIME类型</p>
+         * <p>用途: 用于存储特定类型便签的额外文本数据</p>
+         */
+        public static final String DATA4 = "data4";
+
+        /**
+         * 通用数据列5，含义由{@link #MIME_TYPE}决定，用于文本数据类型
+         * <p>类型: TEXT</p>
+         * <p>约束: 含义取决于具体的MIME类型</p>
+         * <p>用途: 用于存储特定类型便签的额外文本数据</p>
+         */
+        public static final String DATA5 = "data5";
+    }
+
+    /**
+     * 文本便签的数据定义类，实现了{@link DataColumns}接口
+     * <p>
+     * 核心职责：
+     * <ul>
+     *   <li>定义文本便签的特定字段映射</li>
+     *   <li>定义文本便签的MIME类型</li>
+     *   <li>定义文本便签的Content Provider URI</li>
+     *   <li>支持普通文本模式和Checklist模式</li>
+     * </ul>
+     * <p>
+     * 设计意图：
+     * <ul>
+     *   <li>扩展{@link DataColumns}接口，为文本便签提供特定的字段映射</li>
+     *   <li>使用DATA1列存储文本便签的模式（普通模式/Checklist模式）</li>
+     *   <li>为Content Provider提供文本便签的访问入口</li>
+     *   <li>支持多种文本便签显示模式</li>
+     * </ul>
+     * <p>
+     * 与其他类的关联：
+     * <ul>
+     *   <li>实现{@link DataColumns}接口，继承通用数据列定义</li>
+     *   <li>被{@link NotesProvider}使用，作为文本便签的数据源定义</li>
+     *   <li>被UI组件使用，用于查询和显示文本便签</li>
+     * </ul>
+     */
+    public static final class TextNote implements DataColumns {
+        /**
+         * 文本便签的模式字段，映射到通用数据列DATA1
+         * <p>类型: INTEGER</p>
+         * <p>约束: 0表示普通文本模式，1表示Checklist模式</p>
+         * <p>用途: 用于标识文本便签的显示和编辑模式</p>
+         */
+        public static final String MODE = DATA1;
+
+        /**
+         * Checklist模式常量，表示文本便签处于Checklist编辑模式
+         */
+        public static final int MODE_CHECK_LIST = 1;
+
+        /**
+         * 文本便签集合的MIME类型，用于Content Provider返回多个文本便签时使用
+         */
+        public static final String CONTENT_TYPE = "vnd.android.cursor.dir/text_note";
+
+        /**
+         * 单个文本便签的MIME类型，用于Content Provider返回单个文本便签时使用
+         */
+        public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/text_note";
+
+        /**
+         * 文本便签的Content Provider URI，用于查询和操作文本便签数据
+         */
+        public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/text_note");
+    }
+
+    /**
+     * 通话便签的数据定义类，实现了{@link DataColumns}接口
+     * <p>
+     * 核心职责：
+     * <ul>
+     *   <li>定义通话便签的特定字段映射</li>
+     *   <li>定义通话便签的MIME类型</li>
+     *   <li>定义通话便签的Content Provider URI</li>
+     *   <li>支持通话记录的自动关联和存储</li>
+     * </ul>
+     * <p>
+     * 设计意图：
+     * <ul>
+     *   <li>扩展{@link DataColumns}接口，为通话便签提供特定的字段映射</li>
+     *   <li>使用DATA1列存储通话日期</li>
+     *   <li>使用DATA3列存储电话号码</li>
+     *   <li>为Content Provider提供通话便签的访问入口</li>
+     *   <li>支持通话记录的自动生成和关联</li>
+     * </ul>
+     * <p>
+     * 与其他类的关联：
+     * <ul>
+     *   <li>实现{@link DataColumns}接口，继承通用数据列定义</li>
+     *   <li>被{@link NotesProvider}使用，作为通话便签的数据源定义</li>
+     *   <li>被通话记录相关组件使用，用于自动生成通话便签</li>
+     *   <li>被UI组件使用，用于查询和显示通话便签</li>
+     * </ul>
+     */
+    public static final class CallNote implements DataColumns {
+        /**
+         * 通话日期字段，映射到通用数据列DATA1
+         * <p>类型: INTEGER (long)</p>
+         * <p>约束: Unix时间戳，毫秒级</p>
+         * <p>用途: 存储通话发生的日期和时间</p>
+         */
+        public static final String CALL_DATE = DATA1;
+
+        /**
+         * 电话号码字段，映射到通用数据列DATA3
+         * <p>类型: TEXT</p>
+         * <p>约束: 存储通话记录的电话号码</p>
+         * <p>用途: 存储通话记录的电话号码，便于用户查看和回拨</p>
+         */
+        public static final String PHONE_NUMBER = DATA3;
+
+        /**
+         * 通话便签集合的MIME类型，用于Content Provider返回多个通话便签时使用
+         */
+        public static final String CONTENT_TYPE = "vnd.android.cursor.dir/call_note";
+
+        /**
+         * 单个通话便签的MIME类型，用于Content Provider返回单个通话便签时使用
+         */
+        public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/call_note";
+
+        /**
+         * 通话便签的Content Provider URI，用于查询和操作通话便签数据
+         */
+        public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/call_note");
+    }
+}

src/data/NotesDatabaseHelper.java

@@ -0,0 +1,546 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.data;
+
+import android.content.ContentValues;
+import android.content.Context;
+import android.database.sqlite.SQLiteDatabase;
+import android.database.sqlite.SQLiteOpenHelper;
+import android.util.Log;
+
+import net.micode.notes.data.Notes.DataColumns;
+import net.micode.notes.data.Notes.DataConstants;
+import net.micode.notes.data.Notes.NoteColumns;
+
+/**
+ * 便签应用的数据库核心帮助类，负责数据库的创建、升级和维护
+ * <p>
+ * 核心职责：
+ * <ul>
+ *   <li>负责 "note.db" 数据库的创建 ({@link #onCreate})</li>
+ *   <li>负责数据库版本升级与数据迁移 ({@link #onUpgrade})</li>
+ *   <li>定义表名常量（如 {@link TABLE#NOTE}）供外部调用</li>
+ *   <li>维护 SQL Triggers 以保证数据一致性（如文件夹计数更新）</li>
+ *   <li>提供单例实例，确保数据库连接的高效管理</li>
+ *   <li>创建和维护系统文件夹（根文件夹、临时文件夹、通话记录文件夹、回收站）</li>
+ * </ul>
+ * <p>
+ * 设计意图：
+ * <ul>
+ *   <li>采用单例模式，避免频繁创建和销毁数据库连接</li>
+ *   <li>使用SQL Triggers自动维护数据一致性，减少应用层逻辑复杂度</li>
+ *   <li>提供清晰的版本升级机制，支持平滑的数据迁移</li>
+ *   <li>将数据库结构定义集中管理，便于维护和扩展</li>
+ *   <li>支持多种便签类型和关联数据存储</li>
+ * </ul>
+ * <p>
+ * 继承关系：
+ * <ul>
+ *   <li>直接继承自 {@link SQLiteOpenHelper}，利用Android系统提供的数据库管理机制</li>
+ * </ul>
+ * <p>
+ * 与其他类的关键关联：
+ * <ul>
+ *   <li>被 {@link NotesProvider} 使用，作为Content Provider的底层数据存储</li>
+ *   <li>使用 {@link Notes} 类中定义的常量和列名，确保数据一致性</li>
+ *   <li>为整个应用提供统一的数据库访问入口</li>
+ * </ul>
+ * <p>
+ * 数据一致性保障：
+ * <ul>
+ *   <li>使用SQL Triggers自动更新文件夹的便签计数</li>
+ *   <li>实现级联删除，确保数据完整性</li>
+ *   <li>自动更新便签的摘要内容</li>
+ *   <li>支持回收站功能，实现安全删除</li>
+ * </ul>
+ *
+
+ */
+public class NotesDatabaseHelper extends SQLiteOpenHelper {
+    /**
+     * 数据库名称常量
+     * <p>数据库文件名：note.db</p>
+     */
+    private static final String DB_NAME = "note.db";
+
+    /**
+     * 数据库当前版本号
+     * <p>
+     * <strong>警告：</strong>
+     * 任何表结构的修改（如 addColumn）或 Trigger 逻辑的变更，都必须手动 +1。
+     * 这将导致系统自动调用 {@link #onUpgrade} 方法，执行相应的数据迁移操作。
+     * </p>
+     * <p>
+     * 版本历史：
+     * <ul>
+     *   <li>版本1：初始版本</li>
+     *   <li>版本2：完全重建数据库</li>
+     *   <li>版本3：添加Google Task ID支持并添加回收站文件夹</li>
+     *   <li>版本4：添加版本号字段</li>
+     * </ul>
+     * </p>
+     */
+    private static final int DB_VERSION = 4;
+
+    /**
+     * 表名常量接口，定义数据库中所有表的名称
+     * <p>
+     * 设计意图：
+     * <ul>
+     *   <li>集中管理表名常量，避免硬编码</li>
+     *   <li>提供统一的表名访问入口，便于维护和扩展</li>
+     *   <li>被外部类如{@link NotesProvider}使用，确保表名一致性</li>
+     * </ul>
+     */
+    public interface TABLE {
+        /**
+         * 笔记表，存储便签和文件夹的基本信息
+         * <p>包含字段：ID、PARENT_ID、ALERTED_DATE、BG_COLOR_ID、CREATED_DATE等</p>
+         */
+        public static final String NOTE = "note";
+        
+        /**
+         * 数据表，存储便签的详细内容数据
+         * <p>包含字段：ID、MIME_TYPE、NOTE_ID、CONTENT、DATA1-DATA5等</p>
+         */
+        public static final String DATA = "data";
+    }
+
+    /**
+     * 日志标签，用于调试和日志记录
+     */
+    private static final String TAG = "NotesDatabaseHelper";
+    
+    /**
+     * 单例实例，确保整个应用只有一个数据库连接实例
+     * <p>
+     * 设计意图：
+     * <ul>
+     *   <li>避免频繁创建和销毁数据库连接，提高性能</li>
+     *   <li>确保数据库操作的线程安全</li>
+     *   <li>通过{@link #getInstance(Context)}方法获取实例</li>
+     * </ul>
+     */
+    private static NotesDatabaseHelper mInstance;
+
+    /**
+     * 创建笔记表的SQL语句
+     * 包含笔记的基本信息字段：ID、父文件夹ID、提醒日期、背景颜色、创建日期等
+     */
+    private static final String CREATE_NOTE_TABLE_SQL =
+            "CREATE TABLE " + TABLE.NOTE + "(" +
+                    NoteColumns.ID + " INTEGER PRIMARY KEY," + // 主键ID
+                    NoteColumns.PARENT_ID + " INTEGER NOT NULL DEFAULT 0," + // 父文件夹ID，默认为0
+                    NoteColumns.ALERTED_DATE + " INTEGER NOT NULL DEFAULT 0," + // 提醒日期时间戳
+                    NoteColumns.BG_COLOR_ID + " INTEGER NOT NULL DEFAULT 0," + // 背景颜色ID
+                    NoteColumns.CREATED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," + // 创建日期，默认为当前时间
+                    NoteColumns.HAS_ATTACHMENT + " INTEGER NOT NULL DEFAULT 0," + // 是否有附件
+                    NoteColumns.MODIFIED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," + // 修改日期，默认为当前时间
+                    NoteColumns.NOTES_COUNT + " INTEGER NOT NULL DEFAULT 0," + // 笔记数量（用于文件夹）
+                    NoteColumns.SNIPPET + " TEXT NOT NULL DEFAULT ''," + // 内容摘要
+                    NoteColumns.TYPE + " INTEGER NOT NULL DEFAULT 0," + // 类型（笔记/文件夹/系统文件夹等）
+                    NoteColumns.WIDGET_ID + " INTEGER NOT NULL DEFAULT 0," + // 关联的小部件ID
+                    NoteColumns.WIDGET_TYPE + " INTEGER NOT NULL DEFAULT -1," + // 小部件类型
+                    NoteColumns.SYNC_ID + " INTEGER NOT NULL DEFAULT 0," + // 同步ID
+                    NoteColumns.LOCAL_MODIFIED + " INTEGER NOT NULL DEFAULT 0," + // 本地修改标记
+                    NoteColumns.ORIGIN_PARENT_ID + " INTEGER NOT NULL DEFAULT 0," + // 原始父文件夹ID
+                    NoteColumns.GTASK_ID + " TEXT NOT NULL DEFAULT ''," + // Google Task ID
+                    NoteColumns.VERSION + " INTEGER NOT NULL DEFAULT 0" + // 版本号
+                    ")";
+
+    /**
+     * 创建数据表的SQL语句
+     * 存储笔记的具体内容数据，支持多种MIME类型（文本、图片等）
+     */
+    private static final String CREATE_DATA_TABLE_SQL =
+            "CREATE TABLE " + TABLE.DATA + "(" +
+                    DataColumns.ID + " INTEGER PRIMARY KEY," + // 主键ID
+                    DataColumns.MIME_TYPE + " TEXT NOT NULL," + // MIME类型，标识数据类型
+                    DataColumns.NOTE_ID + " INTEGER NOT NULL DEFAULT 0," + // 关联的笔记ID
+                    NoteColumns.CREATED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," + // 创建日期
+                    NoteColumns.MODIFIED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," + // 修改日期
+                    DataColumns.CONTENT + " TEXT NOT NULL DEFAULT ''," + // 内容
+                    DataColumns.DATA1 + " INTEGER," + // 扩展字段1（整数）
+                    DataColumns.DATA2 + " INTEGER," + // 扩展字段2（整数）
+                    DataColumns.DATA3 + " TEXT NOT NULL DEFAULT ''," + // 扩展字段3（文本）
+                    DataColumns.DATA4 + " TEXT NOT NULL DEFAULT ''," + // 扩展字段4（文本）
+                    DataColumns.DATA5 + " TEXT NOT NULL DEFAULT ''" + // 扩展字段5（文本）
+                    ")";
+
+    /**
+     * 在数据表的note_id字段上创建索引，提高查询性能
+     */
+    private static final String CREATE_DATA_NOTE_ID_INDEX_SQL =
+            "CREATE INDEX IF NOT EXISTS note_id_index ON " +
+                    TABLE.DATA + "(" + DataColumns.NOTE_ID + ");";
+
+    /**
+     * SQL 触发器：移动笔记时自动增加目标文件夹计数
+     * <p>
+     * <strong>逻辑解析：</strong><br>
+     * 1. 监听 {@link TABLE#NOTE} 表的 {@link NoteColumns#PARENT_ID} 字段。<br>
+     * 2. 捕捉更新后的新文件夹 ID (new.parent_id)。<br>
+     * 3. 将该目标文件夹的 'note_count' 字段 +1。
+     * </p>
+     */
+    private static final String NOTE_INCREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER =
+            "CREATE TRIGGER increase_folder_count_on_update "+
+                    " AFTER UPDATE OF " + NoteColumns.PARENT_ID + " ON " + TABLE.NOTE +
+                    " BEGIN " +
+                    "  UPDATE " + TABLE.NOTE +
+                    "   SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + " + 1" +
+                    "  WHERE " + NoteColumns.ID + "=new." + NoteColumns.PARENT_ID + ";" +
+                    " END";
+
+    /**
+     * SQL 触发器：当笔记从文件夹移出时，减少原文件夹的笔记计数
+     * 注意：只减少计数大于0的文件夹
+     */
+    private static final String NOTE_DECREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER =
+            "CREATE TRIGGER decrease_folder_count_on_update " +
+                    " AFTER UPDATE OF " + NoteColumns.PARENT_ID + " ON " + TABLE.NOTE +
+                    " BEGIN " +
+                    "  UPDATE " + TABLE.NOTE +
+                    "   SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + "-1" +
+                    "  WHERE " + NoteColumns.ID + "=old." + NoteColumns.PARENT_ID +
+                    "  AND " + NoteColumns.NOTES_COUNT + ">0" + ";" +
+                    " END";
+
+    /**
+     * SQL 触发器：插入新笔记时增加父文件夹的笔记计数
+     */
+    private static final String NOTE_INCREASE_FOLDER_COUNT_ON_INSERT_TRIGGER =
+            "CREATE TRIGGER increase_folder_count_on_insert " +
+                    " AFTER INSERT ON " + TABLE.NOTE +
+                    " BEGIN " +
+                    "  UPDATE " + TABLE.NOTE +
+                    "   SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + " + 1" +
+                    "  WHERE " + NoteColumns.ID + "=new." + NoteColumns.PARENT_ID + ";" +
+                    " END";
+
+    /**
+     * SQL 触发器：删除笔记时减少父文件夹的笔记计数
+     * 注意：只减少计数大于0的文件夹
+     */
+    private static final String NOTE_DECREASE_FOLDER_COUNT_ON_DELETE_TRIGGER =
+            "CREATE TRIGGER decrease_folder_count_on_delete " +
+                    " AFTER DELETE ON " + TABLE.NOTE +
+                    " BEGIN " +
+                    "  UPDATE " + TABLE.NOTE +
+                    "   SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + "-1" +
+                    "  WHERE " + NoteColumns.ID + "=old." + NoteColumns.PARENT_ID +
+                    "  AND " + NoteColumns.NOTES_COUNT + ">0;" +
+                    " END";
+
+    /**
+     * SQL 触发器：当插入类型为NOTE的数据时，更新对应笔记的摘要内容
+     * 仅当MIME_TYPE为DataConstants.NOTE时触发
+     */
+    private static final String DATA_UPDATE_NOTE_CONTENT_ON_INSERT_TRIGGER =
+            "CREATE TRIGGER update_note_content_on_insert " +
+                    " AFTER INSERT ON " + TABLE.DATA +
+                    " WHEN new." + DataColumns.MIME_TYPE + "='" + DataConstants.NOTE + "'" +
+                    " BEGIN" +
+                    "  UPDATE " + TABLE.NOTE +
+                    "   SET " + NoteColumns.SNIPPET + "=new." + DataColumns.CONTENT +
+                    "  WHERE " + NoteColumns.ID + "=new." + DataColumns.NOTE_ID + ";" +
+                    " END";
+
+    /**
+     * SQL 触发器：当更新类型为NOTE的数据时，更新对应笔记的摘要内容
+     */
+    private static final String DATA_UPDATE_NOTE_CONTENT_ON_UPDATE_TRIGGER =
+            "CREATE TRIGGER update_note_content_on_update " +
+                    " AFTER UPDATE ON " + TABLE.DATA +
+                    " WHEN old." + DataColumns.MIME_TYPE + "='" + DataConstants.NOTE + "'" +
+                    " BEGIN" +
+                    "  UPDATE " + TABLE.NOTE +
+                    "   SET " + NoteColumns.SNIPPET + "=new." + DataColumns.CONTENT +
+                    "  WHERE " + NoteColumns.ID + "=new." + DataColumns.NOTE_ID + ";" +
+                    " END";
+
+    /**
+     * SQL 触发器：当删除类型为NOTE的数据时，清空对应笔记的摘要内容
+     */
+    private static final String DATA_UPDATE_NOTE_CONTENT_ON_DELETE_TRIGGER =
+            "CREATE TRIGGER update_note_content_on_delete " +
+                    " AFTER delete ON " + TABLE.DATA +
+                    " WHEN old." + DataColumns.MIME_TYPE + "='" + DataConstants.NOTE + "'" +
+                    " BEGIN" +
+                    "  UPDATE " + TABLE.NOTE +
+                    "   SET " + NoteColumns.SNIPPET + "=''" +
+                    "  WHERE " + NoteColumns.ID + "=old." + DataColumns.NOTE_ID + ";" +
+                    " END";
+
+    /**
+     * SQL 触发器：删除笔记时，级联删除其关联的所有数据
+     */
+    private static final String NOTE_DELETE_DATA_ON_DELETE_TRIGGER =
+            "CREATE TRIGGER delete_data_on_delete " +
+                    " AFTER DELETE ON " + TABLE.NOTE +
+                    " BEGIN" +
+                    "  DELETE FROM " + TABLE.DATA +
+                    "   WHERE " + DataColumns.NOTE_ID + "=old." + NoteColumns.ID + ";" +
+                    " END";
+
+    /**
+     * SQL 触发器：删除文件夹时，级联删除其下的所有笔记
+     * 注意：这会触发delete_data_on_delete触发器，从而删除所有关联数据
+     */
+    private static final String FOLDER_DELETE_NOTES_ON_DELETE_TRIGGER =
+            "CREATE TRIGGER folder_delete_notes_on_delete " +
+                    " AFTER DELETE ON " + TABLE.NOTE +
+                    " BEGIN" +
+                    "  DELETE FROM " + TABLE.NOTE +
+                    "   WHERE " + NoteColumns.PARENT_ID + "=old." + NoteColumns.ID + ";" +
+                    " END";
+
+    /**
+     * SQL 触发器：当文件夹被移动到回收站时，将其下的所有笔记也移动到回收站
+     */
+    private static final String FOLDER_MOVE_NOTES_ON_TRASH_TRIGGER =
+            "CREATE TRIGGER folder_move_notes_on_trash " +
+                    " AFTER UPDATE ON " + TABLE.NOTE +
+                    " WHEN new." + NoteColumns.PARENT_ID + "=" + Notes.ID_TRASH_FOLER +
+                    " BEGIN" +
+                    "  UPDATE " + TABLE.NOTE +
+                    "   SET " + NoteColumns.PARENT_ID + "=" + Notes.ID_TRASH_FOLER +
+                    "  WHERE " + NoteColumns.PARENT_ID + "=old." + NoteColumns.ID + ";" +
+                    " END";
+
+    /**
+     * 构造方法
+     * @param context Android上下文
+     */
+    public NotesDatabaseHelper(Context context) {
+        super(context, DB_NAME, null, DB_VERSION);
+    }
+
+    /**
+     * 创建笔记表及其相关触发器
+     * @param db SQLite数据库对象
+     */
+    public void createNoteTable(SQLiteDatabase db) {
+        db.execSQL(CREATE_NOTE_TABLE_SQL);
+        reCreateNoteTableTriggers(db);
+        createSystemFolder(db);
+        Log.d(TAG, "note table has been created");
+    }
+
+    /**
+     * 重建笔记表的所有触发器
+     * 先删除旧触发器（如果存在），然后创建新触发器
+     * @param db SQLite数据库对象
+     */
+    private void reCreateNoteTableTriggers(SQLiteDatabase db) {
+        // 删除所有旧触发器
+        db.execSQL("DROP TRIGGER IF EXISTS increase_folder_count_on_update");
+        db.execSQL("DROP TRIGGER IF EXISTS decrease_folder_count_on_update");
+        db.execSQL("DROP TRIGGER IF EXISTS decrease_folder_count_on_delete");
+        db.execSQL("DROP TRIGGER IF EXISTS delete_data_on_delete");
+        db.execSQL("DROP TRIGGER IF EXISTS increase_folder_count_on_insert");
+        db.execSQL("DROP TRIGGER IF EXISTS folder_delete_notes_on_delete");
+        db.execSQL("DROP TRIGGER IF EXISTS folder_move_notes_on_trash");
+
+        // 创建新触发器
+        db.execSQL(NOTE_INCREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER);
+        db.execSQL(NOTE_DECREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER);
+        db.execSQL(NOTE_DECREASE_FOLDER_COUNT_ON_DELETE_TRIGGER);
+        db.execSQL(NOTE_DELETE_DATA_ON_DELETE_TRIGGER);
+        db.execSQL(NOTE_INCREASE_FOLDER_COUNT_ON_INSERT_TRIGGER);
+        db.execSQL(FOLDER_DELETE_NOTES_ON_DELETE_TRIGGER);
+        db.execSQL(FOLDER_MOVE_NOTES_ON_TRASH_TRIGGER);
+    }
+
+    /**
+     * 创建系统文件夹
+     * 包括：通话记录文件夹、根文件夹、临时文件夹、回收站
+     * @param db SQLite数据库对象
+     */
+    private void createSystemFolder(SQLiteDatabase db) {
+        ContentValues values = new ContentValues();
+
+        /**
+         * 通话记录文件夹
+         */
+        values.put(NoteColumns.ID, Notes.ID_CALL_RECORD_FOLDER);
+        values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
+        db.insert(TABLE.NOTE, null, values);
+
+        /**
+         * 根文件夹（默认文件夹）
+         */
+        values.clear();
+        values.put(NoteColumns.ID, Notes.ID_ROOT_FOLDER);
+        values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
+        db.insert(TABLE.NOTE, null, values);
+
+        /**
+         * 临时文件夹（用于笔记移动操作）
+         */
+        values.clear();
+        values.put(NoteColumns.ID, Notes.ID_TEMPARAY_FOLDER);
+        values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
+        db.insert(TABLE.NOTE, null, values);
+
+        /**
+         * 回收站文件夹
+         */
+        values.clear();
+        values.put(NoteColumns.ID, Notes.ID_TRASH_FOLER);
+        values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
+        db.insert(TABLE.NOTE, null, values);
+    }
+
+    /**
+     * 创建数据表及其相关触发器
+     * @param db SQLite数据库对象
+     */
+    public void createDataTable(SQLiteDatabase db) {
+        db.execSQL(CREATE_DATA_TABLE_SQL);
+        reCreateDataTableTriggers(db);
+        db.execSQL(CREATE_DATA_NOTE_ID_INDEX_SQL); // 创建索引提高查询性能
+        Log.d(TAG, "data table has been created");
+    }
+
+    /**
+     * 重建数据表的所有触发器
+     * 先删除旧触发器（如果存在），然后创建新触发器
+     * @param db SQLite数据库对象
+     */
+    private void reCreateDataTableTriggers(SQLiteDatabase db) {
+        db.execSQL("DROP TRIGGER IF EXISTS update_note_content_on_insert");
+        db.execSQL("DROP TRIGGER IF EXISTS update_note_content_on_update");
+        db.execSQL("DROP TRIGGER IF EXISTS update_note_content_on_delete");
+
+        db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_INSERT_TRIGGER);
+        db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_UPDATE_TRIGGER);
+        db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_DELETE_TRIGGER);
+    }
+
+    /**
+     * 获取单例实例（线程安全）
+     * @param context Android上下文
+     * @return NotesDatabaseHelper实例
+     */
+    static synchronized NotesDatabaseHelper getInstance(Context context) {
+        if (mInstance == null) {
+            mInstance = new NotesDatabaseHelper(context);
+        }
+        return mInstance;
+    }
+
+    /**
+     * 数据库首次创建时调用
+     * 创建所有表和触发器
+     * @param db SQLite数据库对象
+     */
+    @Override
+    public void onCreate(SQLiteDatabase db) {
+        createNoteTable(db);
+        createDataTable(db);
+    }
+
+    /**
+     * 数据库版本升级时调用
+     * 处理不同版本间的数据迁移和结构变更
+     * @param db SQLite数据库对象
+     * @param oldVersion 旧版本号
+     * @param newVersion 新版本号
+     */
+    @Override
+    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
+        boolean reCreateTriggers = false; // 是否需要重建触发器
+        boolean skipV2 = false; // 是否跳过V2升级
+
+        // 从版本1升级到版本2
+        if (oldVersion == 1) {
+            upgradeToV2(db);
+            skipV2 = true; // V1到V2的升级包含了V2到V3的内容
+            oldVersion++;
+        }
+
+        // 从版本2升级到版本3（如果未跳过）
+        if (oldVersion == 2 && !skipV2) {
+            upgradeToV3(db);
+            reCreateTriggers = true; // V3升级需要重建触发器
+            oldVersion++;
+        }
+
+        // 从版本3升级到版本4
+        if (oldVersion == 3) {
+            upgradeToV4(db);
+            oldVersion++;
+        }
+
+        // 如果需要，重建所有触发器
+        if (reCreateTriggers) {
+            reCreateNoteTableTriggers(db);
+            reCreateDataTableTriggers(db);
+        }
+
+        // 版本号检查，确保升级完成
+        if (oldVersion != newVersion) {
+            throw new IllegalStateException("Upgrade notes database to version " + newVersion
+                    + "fails");
+        }
+    }
+
+    /**
+     * 升级到版本2：完全重建数据库
+     * @param db SQLite数据库对象
+     */
+    private void upgradeToV2(SQLiteDatabase db) {
+        // 删除旧表
+        db.execSQL("DROP TABLE IF EXISTS " + TABLE.NOTE);
+        db.execSQL("DROP TABLE IF EXISTS " + TABLE.DATA);
+        // 创建新表
+        createNoteTable(db);
+        createDataTable(db);
+    }
+
+    /**
+     * 升级到版本3：添加Google Task ID支持并添加回收站文件夹
+     * @param db SQLite数据库对象
+     */
+    private void upgradeToV3(SQLiteDatabase db) {
+        // 删除不再使用的触发器
+        db.execSQL("DROP TRIGGER IF EXISTS update_note_modified_date_on_insert");
+        db.execSQL("DROP TRIGGER IF EXISTS update_note_modified_date_on_delete");
+        db.execSQL("DROP TRIGGER IF EXISTS update_note_modified_date_on_update");
+
+        // 添加Google Task ID字段
+        db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.GTASK_ID
+                + " TEXT NOT NULL DEFAULT ''");
+
+        // 添加回收站系统文件夹
+        ContentValues values = new ContentValues();
+        values.put(NoteColumns.ID, Notes.ID_TRASH_FOLER);
+        values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
+        db.insert(TABLE.NOTE, null, values);
+    }
+
+    /**
+     * 升级到版本4：添加版本号字段
+     * @param db SQLite数据库对象
+     */
+    private void upgradeToV4(SQLiteDatabase db) {
+        // 添加版本号字段
+        db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.VERSION
+                + " INTEGER NOT NULL DEFAULT 0");
+    }
+}

src/data/NotesProvider.java

@@ -0,0 +1,661 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.data;
+
+
+import android.app.SearchManager;
+import android.content.ContentProvider;
+import android.content.ContentUris;
+import android.content.ContentValues;
+import android.content.Intent;
+import android.content.UriMatcher;
+import android.database.Cursor;
+import android.database.sqlite.SQLiteDatabase;
+import android.net.Uri;
+import android.text.TextUtils;
+import android.util.Log;
+
+import net.micode.notes.R;
+import net.micode.notes.data.Notes.DataColumns;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.data.NotesDatabaseHelper.TABLE;
+
+
+/**
+ * 便签应用的Content Provider，负责处理便签数据的CRUD操作和搜索功能
+ * <p>
+ * 核心职责：
+ * <ul>
+ *   <li>提供便签数据的Content Provider访问接口</li>
+ *   <li>处理便签和便签详细数据的查询、插入、更新、删除操作</li>
+ *   <li>支持便签搜索和搜索建议功能</li>
+ *   <li>管理便签数据的版本控制</li>
+ *   <li>在数据变更时通知相关组件</li>
+ * </ul>
+ * <p>
+ * 设计意图：
+ * <ul>
+ *   <li>遵循Android Content Provider设计规范，提供统一的数据访问接口</li>
+ *   <li>使用UriMatcher处理不同类型的URI请求</li>
+ *   <li>实现数据的封装和隔离，保护数据安全</li>
+ *   <li>支持跨应用数据访问（如果需要）</li>
+ *   <li>集成Android搜索框架，支持全局搜索</li>
+ * </ul>
+ * <p>
+ * 继承关系：
+ * <ul>
+ *   <li>直接继承自{@link android.content.ContentProvider}，实现标准的Content Provider接口</li>
+ * </ul>
+ * <p>
+ * 与其他类的关键关联：
+ * <ul>
+ *   <li>依赖{@link NotesDatabaseHelper}获取数据库实例，进行底层数据操作</li>
+ *   <li>使用{@link Notes}类中定义的常量和URI，作为数据访问的标准</li>
+ *   <li>实现{@link SearchManager}接口，支持Android全局搜索功能</li>
+ *   <li>被应用的UI组件和Widget组件使用，作为数据访问的主要入口</li>
+ * </ul>
+ * <p>
+ * URI匹配规则：
+ * <ul>
+ *   <li>content://micode_notes/note - 所有便签和文件夹</li>
+ *   <li>content://micode_notes/note/# - 单个便签或文件夹</li>
+ *   <li>content://micode_notes/data - 所有便签详细数据</li>
+ *   <li>content://micode_notes/data/# - 单个便签详细数据</li>
+ *   <li>content://micode_notes/search - 搜索便签</li>
+ *   <li>content://micode_notes/search_suggest_query - 搜索建议</li>
+ * </ul>
+ *
+
+ */
+public class NotesProvider extends ContentProvider {
+    /**
+     * UriMatcher实例，用于匹配不同类型的URI请求
+     * <p>
+     * 用途：根据URI路径和格式，将请求分发到不同的处理逻辑
+     * <p>
+     * 初始化：在静态代码块中初始化，添加所有支持的URI模式
+     */
+    private static final UriMatcher mMatcher;
+
+    /**
+     * 数据库辅助类实例，用于获取SQLiteDatabase对象
+     * <p>
+     * 用途：提供底层数据库操作支持，包括创建、打开和升级数据库
+     * <p>
+     * 初始化：在onCreate方法中通过单例模式获取实例
+     */
+    private NotesDatabaseHelper mHelper;
+
+    /**
+     * 日志标签，用于调试和日志记录
+     */
+    private static final String TAG = "NotesProvider";
+
+    /**
+     * URI类型常量：表示所有便签和文件夹的集合
+     */
+    private static final int URI_NOTE            = 1;
+
+    /**
+     * URI类型常量：表示单个便签或文件夹
+     */
+    private static final int URI_NOTE_ITEM       = 2;
+
+    /**
+     * URI类型常量：表示所有便签详细数据的集合
+     */
+    private static final int URI_DATA            = 3;
+
+    /**
+     * URI类型常量：表示单个便签详细数据
+     */
+    private static final int URI_DATA_ITEM       = 4;
+
+    /**
+     * URI类型常量：表示便签搜索请求
+     */
+    private static final int URI_SEARCH          = 5;
+
+    /**
+     * URI类型常量：表示搜索建议请求
+     */
+    private static final int URI_SEARCH_SUGGEST  = 6;
+
+    /**
+     * 静态代码块，初始化UriMatcher实例，添加所有支持的URI模式
+     * <p>
+     * 注册的URI模式包括：
+     * <ul>
+     *   <li>note - 所有便签和文件夹</li>
+     *   <li>note/# - 单个便签或文件夹</li>
+     *   <li>data - 所有便签详细数据</li>
+     *   <li>data/# - 单个便签详细数据</li>
+     *   <li>search - 便签搜索</li>
+     *   <li>search_suggest_query - 搜索建议</li>
+     *   <li>search_suggest_query/* - 带查询参数的搜索建议</li>
+     * </ul>
+     */
+    static {
+        mMatcher = new UriMatcher(UriMatcher.NO_MATCH);
+        mMatcher.addURI(Notes.AUTHORITY, "note", URI_NOTE);
+        mMatcher.addURI(Notes.AUTHORITY, "note/#", URI_NOTE_ITEM);
+        mMatcher.addURI(Notes.AUTHORITY, "data", URI_DATA);
+        mMatcher.addURI(Notes.AUTHORITY, "data/#", URI_DATA_ITEM);
+        mMatcher.addURI(Notes.AUTHORITY, "search", URI_SEARCH);
+        mMatcher.addURI(Notes.AUTHORITY, SearchManager.SUGGEST_URI_PATH_QUERY, URI_SEARCH_SUGGEST);
+        mMatcher.addURI(Notes.AUTHORITY, SearchManager.SUGGEST_URI_PATH_QUERY + "/*", URI_SEARCH_SUGGEST);
+    }
+
+    /**
+     * 便签搜索的投影列定义，用于构建搜索结果
+     * <p>
+     * 包含以下字段：
+     * <ul>
+     *   <li>便签ID</li>
+     *   <li>搜索建议的额外数据（便签ID）</li>
+     *   <li>搜索建议的文本1（便签内容，去除换行符和空格）</li>
+     *   <li>搜索建议的文本2（便签内容，去除换行符和空格）</li>
+     *   <li>搜索结果图标</li>
+     *   <li>搜索结果的意图动作（查看）</li>
+     *   <li>搜索结果的意图数据类型</li>
+     * </ul>
+     * <p>
+     * 特殊处理：
+     * <ul>
+     *   <li>使用SQLite函数TRIM和REPLACE去除便签内容中的换行符（x'0A'）和空格</li>
+     *   <li>使用固定的搜索结果图标</li>
+     * </ul>
+     */
+    private static final String NOTES_SEARCH_PROJECTION = NoteColumns.ID + ","
+        + NoteColumns.ID + " AS " + SearchManager.SUGGEST_COLUMN_INTENT_EXTRA_DATA + ","
+        + "TRIM(REPLACE(" + NoteColumns.SNIPPET + ", x'0A','')) AS " + SearchManager.SUGGEST_COLUMN_TEXT_1 + ","
+        + "TRIM(REPLACE(" + NoteColumns.SNIPPET + ", x'0A','')) AS " + SearchManager.SUGGEST_COLUMN_TEXT_2 + ","
+        + R.drawable.search_result + " AS " + SearchManager.SUGGEST_COLUMN_ICON_1 + ","
+        + "'" + Intent.ACTION_VIEW + "' AS " + SearchManager.SUGGEST_COLUMN_INTENT_ACTION + ","
+        + "'" + Notes.TextNote.CONTENT_TYPE + "' AS " + SearchManager.SUGGEST_COLUMN_INTENT_DATA;
+
+    /**
+     * 便签搜索的SQL查询语句，用于执行实际的搜索操作
+     * <p>
+     * 查询条件：
+     * <ul>
+     *   <li>便签内容包含搜索关键字（LIKE ?）</li>
+     *   <li>便签不在回收站中（PARENT_ID <> TRASH_FOLDER）</li>
+     *   <li>便签类型为普通便签（TYPE = TYPE_NOTE）</li>
+     * </ul>
+     * <p>
+     * 用途：在URI_SEARCH和URI_SEARCH_SUGGEST类型的请求中执行搜索操作
+     */
+    private static String NOTES_SNIPPET_SEARCH_QUERY = "SELECT " + NOTES_SEARCH_PROJECTION
+        + " FROM " + TABLE.NOTE
+        + " WHERE " + NoteColumns.SNIPPET + " LIKE ?"
+        + " AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER
+        + " AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE;
+
+    /**
+     * 初始化Content Provider
+     * <p>
+     * 业务逻辑：
+     * <ul>
+     *   <li>获取NotesDatabaseHelper的单例实例</li>
+     *   <li>初始化数据库连接</li>
+     * </ul>
+     * <p>
+     * 与其他类的交互：
+     * <ul>
+     *   <li>调用{@link NotesDatabaseHelper#getInstance(android.content.Context)}获取数据库辅助类实例</li>
+     * </ul>
+     *
+     * @return true 初始化成功
+     * @see android.content.ContentProvider#onCreate()
+     */
+    @Override
+    public boolean onCreate() {
+        mHelper = NotesDatabaseHelper.getInstance(getContext());
+        return true;
+    }
+
+    /**
+     * 处理查询请求，根据URI类型返回相应的Cursor对象
+     * <p>
+     * 业务逻辑：
+     * <ul>
+     *   <li>根据URI类型分发到不同的查询逻辑</li>
+     *   <li>获取可读数据库实例</li>
+     *   <li>执行查询操作，返回Cursor对象</li>
+     *   <li>为Cursor设置通知URI，以便数据变更时接收通知</li>
+     * </ul>
+     * <p>
+     * URI类型处理：
+     * <ul>
+     *   <li>{@link #URI_NOTE} - 查询所有便签和文件夹</li>
+     *   <li>{@link #URI_NOTE_ITEM} - 查询单个便签或文件夹</li>
+     *   <li>{@link #URI_DATA} - 查询所有便签详细数据</li>
+     *   <li>{@link #URI_DATA_ITEM} - 查询单个便签详细数据</li>
+     *   <li>{@link #URI_SEARCH} - 执行便签搜索</li>
+     *   <li>{@link #URI_SEARCH_SUGGEST} - 提供搜索建议</li>
+     * </ul>
+     * <p>
+     * 与其他类的交互：
+     * <ul>
+     *   <li>使用{@link NotesDatabaseHelper#getReadableDatabase()}获取可读数据库</li>
+     *   <li>使用{@link SQLiteDatabase}执行查询操作</li>
+     *   <li>使用{@link SearchManager}处理搜索相关请求</li>
+     * </ul>
+     * <p>
+     * 特殊处理：
+     * <ul>
+     *   <li>搜索请求不允许指定sortOrder和projection参数</li>
+     *   <li>搜索结果会去除换行符和空格，以便显示更多信息</li>
+     *   <li>搜索范围不包括回收站中的便签</li>
+     * </ul>
+     *
+     * @param uri           请求的URI
+     * @param projection    返回的列名数组
+     * @param selection     查询条件
+     * @param selectionArgs 查询条件参数
+     * @param sortOrder     排序方式
+     * @return Cursor 查询结果的Cursor对象，或null如果查询失败
+     * @throws IllegalArgumentException 如果URI无效或参数不符合要求
+     * @see android.content.ContentProvider#query(android.net.Uri, java.lang.String[], java.lang.String, java.lang.String[], java.lang.String)
+     */
+    @Override
+    public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs,
+            String sortOrder) {
+        Cursor c = null;
+        SQLiteDatabase db = mHelper.getReadableDatabase();
+        String id = null;
+        switch (mMatcher.match(uri)) {
+            case URI_NOTE:
+                c = db.query(TABLE.NOTE, projection, selection, selectionArgs, null, null,
+                        sortOrder);
+                break;
+            case URI_NOTE_ITEM:
+                id = uri.getPathSegments().get(1);
+                c = db.query(TABLE.NOTE, projection, NoteColumns.ID + "=" + id
+                        + parseSelection(selection), selectionArgs, null, null, sortOrder);
+                break;
+            case URI_DATA:
+                c = db.query(TABLE.DATA, projection, selection, selectionArgs, null, null,
+                        sortOrder);
+                break;
+            case URI_DATA_ITEM:
+                id = uri.getPathSegments().get(1);
+                c = db.query(TABLE.DATA, projection, DataColumns.ID + "=" + id
+                        + parseSelection(selection), selectionArgs, null, null, sortOrder);
+                break;
+            case URI_SEARCH:
+            case URI_SEARCH_SUGGEST:
+                if (sortOrder != null || projection != null) {
+                    throw new IllegalArgumentException(
+                            "do not specify sortOrder, selection, selectionArgs, or projection" + "with this query");
+                }
+
+                String searchString = null;
+                if (mMatcher.match(uri) == URI_SEARCH_SUGGEST) {
+                    if (uri.getPathSegments().size() > 1) {
+                        searchString = uri.getPathSegments().get(1);
+                    }
+                } else {
+                    searchString = uri.getQueryParameter("pattern");
+                }
+
+                if (TextUtils.isEmpty(searchString)) {
+                    return null;
+                }
+
+                try {
+                    searchString = String.format("%%%s%%", searchString);
+                    c = db.rawQuery(NOTES_SNIPPET_SEARCH_QUERY,
+                            new String[] { searchString });
+                } catch (IllegalStateException ex) {
+                    Log.e(TAG, "got exception: " + ex.toString());
+                }
+                break;
+            default:
+                throw new IllegalArgumentException("Unknown URI " + uri);
+        }
+        if (c != null) {
+            c.setNotificationUri(getContext().getContentResolver(), uri);
+        }
+        return c;
+    }
+
+    /**
+     * 处理插入请求，根据URI类型插入数据并返回新的URI
+     * <p>
+     * 业务逻辑：
+     * <ul>
+     *   <li>根据URI类型分发到不同的插入逻辑</li>
+     *   <li>获取可写数据库实例</li>
+     *   <li>执行插入操作，返回插入的行ID</li>
+     *   <li>通知相关URI的数据变更</li>
+     *   <li>返回包含新ID的URI</li>
+     * </ul>
+     * <p>
+     * URI类型处理：
+     * <ul>
+     *   <li>{@link #URI_NOTE} - 插入便签或文件夹</li>
+     *   <li>{@link #URI_DATA} - 插入便签详细数据</li>
+     * </ul>
+     * <p>
+     * 与其他类的交互：
+     * <ul>
+     *   <li>使用{@link NotesDatabaseHelper#getWritableDatabase()}获取可写数据库</li>
+     *   <li>使用{@link SQLiteDatabase}执行插入操作</li>
+     *   <li>通过{@link android.content.ContentResolver#notifyChange(android.net.Uri, android.database.ContentObserver)}通知数据变更</li>
+     * </ul>
+     * <p>
+     * 特殊处理：
+     * <ul>
+     *   <li>插入数据时，记录插入的noteId和dataId</li>
+     *   <li>插入成功后，通知相关URI的数据变更</li>
+     * </ul>
+     *
+     * @param uri     请求的URI
+     * @param values  要插入的数据
+     * @return Uri 包含新插入行ID的URI
+     * @throws IllegalArgumentException 如果URI无效
+     * @see android.content.ContentProvider#insert(android.net.Uri, android.content.ContentValues)
+     */
+    @Override
+    public Uri insert(Uri uri, ContentValues values) {
+        SQLiteDatabase db = mHelper.getWritableDatabase();
+        long dataId = 0, noteId = 0, insertedId = 0;
+        switch (mMatcher.match(uri)) {
+            case URI_NOTE:
+                insertedId = noteId = db.insert(TABLE.NOTE, null, values);
+                break;
+            case URI_DATA:
+                if (values.containsKey(DataColumns.NOTE_ID)) {
+                    noteId = values.getAsLong(DataColumns.NOTE_ID);
+                } else {
+                    Log.d(TAG, "Wrong data format without note id:" + values.toString());
+                }
+                insertedId = dataId = db.insert(TABLE.DATA, null, values);
+                break;
+            default:
+                throw new IllegalArgumentException("Unknown URI " + uri);
+        }
+        // Notify the note uri
+        if (noteId > 0) {
+            getContext().getContentResolver().notifyChange(
+                    ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), null);
+        }
+
+        // Notify the data uri
+        if (dataId > 0) {
+            getContext().getContentResolver().notifyChange(
+                    ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, dataId), null);
+        }
+
+        return ContentUris.withAppendedId(uri, insertedId);
+    }
+
+    /**
+     * 处理删除请求，根据URI类型删除数据并返回删除的行数
+     * <p>
+     * 业务逻辑：
+     * <ul>
+     *   <li>根据URI类型分发到不同的删除逻辑</li>
+     *   <li>获取可写数据库实例</li>
+     *   <li>执行删除操作，返回删除的行数</li>
+     *   <li>通知相关URI的数据变更</li>
+     * </ul>
+     * <p>
+     * URI类型处理：
+     * <ul>
+     *   <li>{@link #URI_NOTE} - 删除便签或文件夹</li>
+     *   <li>{@link #URI_NOTE_ITEM} - 删除单个便签或文件夹</li>
+     *   <li>{@link #URI_DATA} - 删除便签详细数据</li>
+     *   <li>{@link #URI_DATA_ITEM} - 删除单个便签详细数据</li>
+     * </ul>
+     * <p>
+     * 与其他类的交互：
+     * <ul>
+     *   <li>使用{@link NotesDatabaseHelper#getWritableDatabase()}获取可写数据库</li>
+     *   <li>使用{@link SQLiteDatabase}执行删除操作</li>
+     *   <li>通过{@link android.content.ContentResolver#notifyChange(android.net.Uri, android.database.ContentObserver)}通知数据变更</li>
+     * </ul>
+     * <p>
+     * 特殊处理：
+     * <ul>
+     *   <li>删除便签时，跳过ID小于等于0的系统文件夹</li>
+     *   <li>删除数据时，同时通知CONTENT_NOTE_URI的数据变更</li>
+     * </ul>
+     *
+     * @param uri           请求的URI
+     * @param selection     删除条件
+     * @param selectionArgs 删除条件参数
+     * @return int 删除的行数
+     * @throws IllegalArgumentException 如果URI无效
+     * @see android.content.ContentProvider#delete(android.net.Uri, java.lang.String, java.lang.String[])
+     */
+    @Override
+    public int delete(Uri uri, String selection, String[] selectionArgs) {
+        int count = 0;
+        String id = null;
+        SQLiteDatabase db = mHelper.getWritableDatabase();
+        boolean deleteData = false;
+        switch (mMatcher.match(uri)) {
+            case URI_NOTE:
+                selection = "(" + selection + ") AND " + NoteColumns.ID + ">0 ";
+                count = db.delete(TABLE.NOTE, selection, selectionArgs);
+                break;
+            case URI_NOTE_ITEM:
+                id = uri.getPathSegments().get(1);
+                /**
+                 * ID that smaller than 0 is system folder which is not allowed to
+                 * trash
+                 */
+                long noteId = Long.valueOf(id);
+                if (noteId <= 0) {
+                    break;
+                }
+                count = db.delete(TABLE.NOTE,
+                        NoteColumns.ID + "=" + id + parseSelection(selection), selectionArgs);
+                break;
+            case URI_DATA:
+                count = db.delete(TABLE.DATA, selection, selectionArgs);
+                deleteData = true;
+                break;
+            case URI_DATA_ITEM:
+                id = uri.getPathSegments().get(1);
+                count = db.delete(TABLE.DATA,
+                        DataColumns.ID + "=" + id + parseSelection(selection), selectionArgs);
+                deleteData = true;
+                break;
+            default:
+                throw new IllegalArgumentException("Unknown URI " + uri);
+        }
+        if (count > 0) {
+            if (deleteData) {
+                getContext().getContentResolver().notifyChange(Notes.CONTENT_NOTE_URI, null);
+            }
+            getContext().getContentResolver().notifyChange(uri, null);
+        }
+        return count;
+    }
+
+    /**
+     * 处理更新请求，根据URI类型更新数据并返回更新的行数
+     * <p>
+     * 业务逻辑：
+     * <ul>
+     *   <li>根据URI类型分发到不同的更新逻辑</li>
+     *   <li>获取可写数据库实例</li>
+     *   <li>对于便签更新，先增加版本号</li>
+     *   <li>执行更新操作，返回更新的行数</li>
+     *   <li>通知相关URI的数据变更</li>
+     * </ul>
+     * <p>
+     * URI类型处理：
+     * <ul>
+     *   <li>{@link #URI_NOTE} - 更新便签或文件夹</li>
+     *   <li>{@link #URI_NOTE_ITEM} - 更新单个便签或文件夹</li>
+     *   <li>{@link #URI_DATA} - 更新便签详细数据</li>
+     *   <li>{@link #URI_DATA_ITEM} - 更新单个便签详细数据</li>
+     * </ul>
+     * <p>
+     * 与其他类的交互：
+     * <ul>
+     *   <li>使用{@link NotesDatabaseHelper#getWritableDatabase()}获取可写数据库</li>
+     *   <li>使用{@link SQLiteDatabase}执行更新操作</li>
+     *   <li>调用{@link #increaseNoteVersion(long, String, String[])}增加便签版本号</li>
+     *   <li>通过{@link android.content.ContentResolver#notifyChange(android.net.Uri, android.database.ContentObserver)}通知数据变更</li>
+     * </ul>
+     * <p>
+     * 特殊处理：
+     * <ul>
+     *   <li>更新便签时，自动增加版本号</li>
+     *   <li>更新数据时，同时通知CONTENT_NOTE_URI的数据变更</li>
+     * </ul>
+     *
+     * @param uri           请求的URI
+     * @param values        要更新的数据
+     * @param selection     更新条件
+     * @param selectionArgs 更新条件参数
+     * @return int 更新的行数
+     * @throws IllegalArgumentException 如果URI无效
+     * @see android.content.ContentProvider#update(android.net.Uri, android.content.ContentValues, java.lang.String, java.lang.String[])
+     */
+    @Override
+    public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
+        int count = 0;
+        String id = null;
+        SQLiteDatabase db = mHelper.getWritableDatabase();
+        boolean updateData = false;
+        switch (mMatcher.match(uri)) {
+            case URI_NOTE:
+                increaseNoteVersion(-1, selection, selectionArgs);
+                count = db.update(TABLE.NOTE, values, selection, selectionArgs);
+                break;
+            case URI_NOTE_ITEM:
+                id = uri.getPathSegments().get(1);
+                increaseNoteVersion(Long.valueOf(id), selection, selectionArgs);
+                count = db.update(TABLE.NOTE, values, NoteColumns.ID + "=" + id
+                        + parseSelection(selection), selectionArgs);
+                break;
+            case URI_DATA:
+                count = db.update(TABLE.DATA, values, selection, selectionArgs);
+                updateData = true;
+                break;
+            case URI_DATA_ITEM:
+                id = uri.getPathSegments().get(1);
+                count = db.update(TABLE.DATA, values, DataColumns.ID + "=" + id
+                        + parseSelection(selection), selectionArgs);
+                updateData = true;
+                break;
+            default:
+                throw new IllegalArgumentException("Unknown URI " + uri);
+        }
+
+        if (count > 0) {
+            if (updateData) {
+                getContext().getContentResolver().notifyChange(Notes.CONTENT_NOTE_URI, null);
+            }
+            getContext().getContentResolver().notifyChange(uri, null);
+        }
+        return count;
+    }
+
+    /**
+     * 辅助方法，处理查询条件，将额外条件添加到现有条件中
+     * <p>
+     * 业务逻辑：
+     * <ul>
+     *   <li>如果selection不为空，将其包装为" AND (selection)"格式</li>
+     *   <li>否则返回空字符串</li>
+     * </ul>
+     *
+     * @param selection 原始查询条件
+     * @return String 处理后的查询条件
+     */
+    private String parseSelection(String selection) {
+        return (!TextUtils.isEmpty(selection) ? " AND (" + selection + ')' : "");
+    }
+
+    /**
+     * 辅助方法，增加便签的版本号
+     * <p>
+     * 业务逻辑：
+     * <ul>
+     *   <li>构建UPDATE语句，将版本号加1</li>
+     *   <li>根据id和selection参数构建WHERE子句</li>
+     *   <li>执行SQL语句，更新版本号</li>
+     * </ul>
+     * <p>
+     * 与其他类的交互：
+     * <ul>
+     *   <li>使用{@link NotesDatabaseHelper#getWritableDatabase()}获取可写数据库</li>
+     *   <li>使用{@link SQLiteDatabase#execSQL(String)}执行SQL语句</li>
+     * </ul>
+     * <p>
+     * 特殊处理：
+     * <ul>
+     *   <li>直接使用字符串拼接构建SQL语句，存在SQL注入风险</li>
+     *   <li>使用replaceFirst替换占位符，仅适用于简单的条件</li>
+     *   <li>TODO: 考虑使用PreparedStatement或参数化查询，提高安全性</li>
+     * </ul>
+     *
+     * @param id            便签ID，-1表示更新多个便签
+     * @param selection     更新条件
+     * @param selectionArgs 更新条件参数
+     */
+    private void increaseNoteVersion(long id, String selection, String[] selectionArgs) {
+        StringBuilder sql = new StringBuilder(120);
+        sql.append("UPDATE ");
+        sql.append(TABLE.NOTE);
+        sql.append(" SET ");
+        sql.append(NoteColumns.VERSION);
+        sql.append("=" + NoteColumns.VERSION + "+1 ");
+
+        if (id > 0 || !TextUtils.isEmpty(selection)) {
+            sql.append(" WHERE ");
+        }
+        if (id > 0) {
+            sql.append(NoteColumns.ID + "=" + String.valueOf(id));
+        }
+        if (!TextUtils.isEmpty(selection)) {
+            String selectString = id > 0 ? parseSelection(selection) : selection;
+            for (String args : selectionArgs) {
+                selectString = selectString.replaceFirst("\\?", args);
+            }
+            sql.append(selectString);
+        }
+
+        mHelper.getWritableDatabase().execSQL(sql.toString());
+    }
+
+    /**
+     * 获取URI对应的MIME类型
+     * <p>
+     * 注意：该方法目前未实现，返回null
+     * <p>
+     * TODO: 实现该方法，返回正确的MIME类型
+     *
+     * @param uri 请求的URI
+     * @return String URI对应的MIME类型，目前返回null
+     * @see android.content.ContentProvider#getType(android.net.Uri)
+     */
+    @Override
+    public String getType(Uri uri) {
+        // TODO Auto-generated method stub
+        return null;
+    }
+
+}

src/gtask/data/MetaData.java

@@ -0,0 +1,180 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.gtask.data;
+
+import android.database.Cursor;
+import android.util.Log;
+
+import net.micode.notes.tool.GTaskStringUtils;
+
+import org.json.JSONException;
+import org.json.JSONObject;
+
+
+/**
+ * <p>任务元数据管理类，用于存储Google任务的元数据信息。</p>
+ * <p>核心职责：</p>
+ * <ul>
+ * <li>存储和管理任务的元数据信息</li>
+ * <li>处理元数据的JSON序列化和反序列化</li>
+ * <li>管理与其他任务的关联关系</li>
+ * </ul>
+ * <p>设计意图：</p>
+ * <ul>
+ * <li>继承自{@link Task}类，扩展其功能以支持元数据管理</li>
+ * <li>使用JSON格式存储元数据，便于序列化和传输</li>
+ * <li>提供元数据的设置和获取接口，简化元数据操作</li>
+ * </ul>
+ * <p>关键关联：</p>
+ * <ul>
+ * <li>继承自{@link Task}类，复用任务的基本功能</li>
+ * <li>使用{@link GTaskStringUtils}提供的常量定义元数据格式</li>
+ * <li>被{@link GTaskManager}和{@link GTaskSyncService}使用，管理任务同步元数据</li>
+ * </ul>
+ */
+public class MetaData extends Task {
+    /**
+     * <p>日志标签。</p>
+     * <p>业务含义：用于在日志中标识MetaData类的相关操作。</p>
+     */
+    private final static String TAG = MetaData.class.getSimpleName();
+
+    /**
+     * <p>关联的Google任务ID。</p>
+     * <p>业务含义：存储与当前元数据相关联的Google任务的唯一标识符。</p>
+     * <p>约束条件：仅通过{@link #setContentByRemoteJSON(JSONObject)}方法从远程JSON数据中获取。</p>
+     */
+    private String mRelatedGid = null;
+
+    /**
+     * <p>设置任务元数据信息。</p>
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>将Google任务ID添加到元数据JSON对象中</li>
+     * <li>将元数据JSON对象转换为字符串，存储到任务的notes字段中</li>
+     * <li>设置任务名称为元数据专用名称</li>
+     * </ul>
+     * <p>异常处理：</p>
+     * <ul>
+     * <li>处理JSONException异常，如果添加Google任务ID失败，记录错误日志</li>
+     * </ul>
+     * 
+     * @param gid 关联的Google任务ID
+     * @param metaInfo 元数据JSON对象
+     */
+    public void setMeta(String gid, JSONObject metaInfo) {
+        try {
+            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);
+    }
+
+    /**
+     * <p>获取关联的Google任务ID。</p>
+     * <p>业务含义：返回与当前元数据相关联的Google任务的唯一标识符。</p>
+     * 
+     * @return 关联的Google任务ID，如果不存在则返回null
+     */
+    public String getRelatedGid() {
+        return mRelatedGid;
+    }
+
+    /**
+     * <p>判断元数据是否值得保存。</p>
+     * <p>业务逻辑：如果元数据的notes字段不为null，则认为值得保存。</p>
+     * 
+     * @return 如果元数据值得保存则返回true，否则返回false
+     */
+    @Override
+    public boolean isWorthSaving() {
+        return getNotes() != null;
+    }
+
+    /**
+     * <p>根据远程JSON数据设置元数据内容。</p>
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>调用父类的setContentByRemoteJSON方法设置基本任务内容</li>
+     * <li>如果notes字段不为null，则解析JSON字符串获取元数据信息</li>
+     * <li>从元数据中提取关联的Google任务ID</li>
+     * </ul>
+     * <p>异常处理：</p>
+     * <ul>
+     * <li>处理JSONException异常，如果解析元数据失败，记录警告日志并将mRelatedGid设置为null</li>
+     * </ul>
+     * 
+     * @param js 远程JSON数据对象
+     */
+    @Override
+    public void setContentByRemoteJSON(JSONObject js) {
+        super.setContentByRemoteJSON(js);
+        if (getNotes() != null) {
+            try {
+                JSONObject metaInfo = new JSONObject(getNotes().trim());
+                mRelatedGid = metaInfo.getString(GTaskStringUtils.META_HEAD_GTASK_ID);
+            } catch (JSONException e) {
+                Log.w(TAG, "failed to get related gid");
+                mRelatedGid = null;
+            }
+        }
+    }
+
+    /**
+     * <p>根据本地JSON数据设置元数据内容。</p>
+     * <p>业务逻辑：此方法不应被调用，直接抛出IllegalAccessError异常。</p>
+     * <p>注意：MetaData类不支持从本地JSON数据设置内容。</p>
+     * 
+     * @param js 本地JSON数据对象
+     * @throws IllegalAccessError 总是抛出此异常，因为该方法不应被调用
+     */
+    @Override
+    public void setContentByLocalJSON(JSONObject js) {
+        // this function should not be called
+        throw new IllegalAccessError("MetaData:setContentByLocalJSON should not be called");
+    }
+
+    /**
+     * <p>从元数据内容获取本地JSON对象。</p>
+     * <p>业务逻辑：此方法不应被调用，直接抛出IllegalAccessError异常。</p>
+     * <p>注意：MetaData类不支持获取本地JSON数据。</p>
+     * 
+     * @return 本地JSON数据对象
+     * @throws IllegalAccessError 总是抛出此异常，因为该方法不应被调用
+     */
+    @Override
+    public JSONObject getLocalJSONFromContent() {
+        throw new IllegalAccessError("MetaData:getLocalJSONFromContent should not be called");
+    }
+
+    /**
+     * <p>获取元数据的同步操作类型。</p>
+     * <p>业务逻辑：此方法不应被调用，直接抛出IllegalAccessError异常。</p>
+     * <p>注意：MetaData类不支持获取同步操作类型。</p>
+     * 
+     * @param c 数据库游标对象
+     * @return 同步操作类型
+     * @throws IllegalAccessError 总是抛出此异常，因为该方法不应被调用
+     */
+    @Override
+    public int getSyncAction(Cursor c) {
+        throw new IllegalAccessError("MetaData:getSyncAction should not be called");
+    }
+
+}

src/gtask/data/Node.java

@@ -0,0 +1,247 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.gtask.data;
+
+import android.database.Cursor;
+
+import org.json.JSONObject;
+
+/**
+ * <p>Google任务数据模型的抽象基类。</p>
+ * <p>设计意图：统一定义Google任务相关数据（如任务、元数据）的核心属性和同步行为，为子类提供标准化接口。</p>
+ * <p>核心职责：</p>
+ * <ul>
+ * <li>封装通用属性：Google任务ID（GID）、名称、最后修改时间、删除状态</li>
+ * <li>定义同步操作抽象方法：创建/更新动作生成、本地/远程JSON数据转换、同步动作判断</li>
+ * <li>提供同步动作常量：规范同步操作类型（无动作、添加、更新、删除、冲突等）</li>
+ * </ul>
+ * <p>关键关联：</p>
+ * <ul>
+ * <li>子类需实现抽象方法以适配具体数据类型（如{@link Task}, {@link MetaData}）</li>
+ * <li>与{@link GTaskClient}配合完成Google任务服务的同步操作</li>
+ * <li>通过{@link Cursor}与本地数据库交互获取同步状态</li>
+ * </ul>
+ */
+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任务唯一标识ID，约束条件：仅通过远程同步设置
+     */
+    private String mGid;
+
+    /**
+     * 任务名称
+     */
+    private String mName;
+
+    /**
+     * 最后修改时间戳（毫秒）
+     */
+    private long mLastModified;
+
+    /**
+     * 删除状态标记
+     */
+    private boolean mDeleted;
+
+    /**
+     * 默认构造方法，初始化默认值
+     */
+    public Node() {
+        mGid = null;
+        mName = "";
+        mLastModified = 0;
+        mDeleted = false;
+    }
+
+    /**
+     * <p>生成创建动作的JSON对象。</p>
+     * <p>业务逻辑：构造用于向Google任务服务添加新任务的JSON数据。</p>
+     * 
+     * @param actionId 动作ID，用于标识同步任务序列
+     * @return 创建动作的JSON对象，包含必要的元数据和内容信息
+     */
+    public abstract JSONObject getCreateAction(int actionId);
+
+    /**
+     * <p>生成更新动作的JSON对象。</p>
+     * <p>业务逻辑：构造用于向Google任务服务更新现有任务的JSON数据。</p>
+     * 
+     * @param actionId 动作ID，用于标识同步任务序列
+     * @return 更新动作的JSON对象，包含待更新的字段和内容
+     */
+    public abstract JSONObject getUpdateAction(int actionId);
+
+    /**
+     * <p>从远程JSON数据解析并设置内容。</p>
+     * <p>业务逻辑：将Google任务服务返回的JSON数据转换为本地对象属性。</p>
+     * 
+     * @param js 远程获取的JSON对象，包含Google任务服务返回的任务数据
+     */
+    public abstract void setContentByRemoteJSON(JSONObject js);
+
+    /**
+     * <p>从本地JSON数据解析并设置内容。</p>
+     * <p>业务逻辑：将本地存储的JSON数据转换为对象属性。</p>
+     * 
+     * @param js 本地存储的JSON对象，包含应用内持久化的任务数据
+     */
+    public abstract void setContentByLocalJSON(JSONObject js);
+
+    /**
+     * <p>将当前内容转换为本地存储用的JSON对象。</p>
+     * <p>业务逻辑：将对象属性转换为可持久化到本地数据库的JSON格式。</p>
+     * 
+     * @return 包含内容数据的JSON对象，用于本地持久化
+     */
+    public abstract JSONObject getLocalJSONFromContent();
+
+    /**
+     * <p>从数据库游标判断当前同步动作类型。</p>
+     * <p>业务逻辑：比较本地数据库与远程同步状态，确定需要执行的同步操作类型。</p>
+     * <p>可能的返回值：
+     * <ul>
+     * <li>{@link #SYNC_ACTION_NONE}：无需同步</li>
+     * <li>{@link #SYNC_ACTION_ADD_REMOTE}：向远程添加</li>
+     * <li>{@link #SYNC_ACTION_UPDATE_LOCAL}：更新本地</li>
+     * <li>{@link #SYNC_ACTION_UPDATE_CONFLICT}：更新冲突</li>
+     * <li>等其他同步动作常量</li>
+     * </ul>
+     * </p>
+     * 
+     * @param c 查询本地数据库得到的游标，包含任务的同步状态信息
+     * @return 同步动作类型，取值为{@link #SYNC_ACTION_NONE}至{@link #SYNC_ACTION_ERROR}
+     */
+    public abstract int getSyncAction(Cursor c);
+
+    /**
+     * 设置Google任务唯一标识ID
+     * 
+     * @param gid Google任务ID
+     */
+    public void setGid(String gid) {
+        this.mGid = gid;
+    }
+
+    /**
+     * 设置任务名称
+     * 
+     * @param name 任务名称
+     */
+    public void setName(String name) {
+        this.mName = name;
+    }
+
+    /**
+     * 设置最后修改时间戳
+     * 
+     * @param lastModified 最后修改时间（毫秒）
+     */
+    public void setLastModified(long lastModified) {
+        this.mLastModified = lastModified;
+    }
+
+    /**
+     * 设置任务删除状态
+     * 
+     * @param deleted 删除状态
+     */
+    public void setDeleted(boolean deleted) {
+        this.mDeleted = deleted;
+    }
+
+    /**
+     * 获取Google任务唯一标识ID
+     * 
+     * @return Google任务ID
+     */
+    public String getGid() {
+        return this.mGid;
+    }
+
+    /**
+     * 获取任务名称
+     * 
+     * @return 任务名称
+     */
+    public String getName() {
+        return this.mName;
+    }
+
+    /**
+     * 获取最后修改时间戳
+     * 
+     * @return 最后修改时间（毫秒）
+     */
+    public long getLastModified() {
+        return this.mLastModified;
+    }
+
+    /**
+     * 判断任务是否已删除
+     * 
+     * @return 是否已删除
+     */
+    public boolean getDeleted() {
+        return this.mDeleted;
+    }
+
+}

src/gtask/data/SqlData.java

@@ -0,0 +1,305 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.gtask.data;
+
+import android.content.ContentResolver;
+import android.content.ContentUris;
+import android.content.ContentValues;
+import android.content.Context;
+import android.database.Cursor;
+import android.net.Uri;
+import android.util.Log;
+
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.DataColumns;
+import net.micode.notes.data.Notes.DataConstants;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.data.NotesDatabaseHelper.TABLE;
+import net.micode.notes.gtask.exception.ActionFailureException;
+
+import org.json.JSONException;
+import org.json.JSONObject;
+
+
+/**
+ * <p>SQL数据操作类，用于处理便签数据的增删改查操作。</p>
+ * <p>设计意图：作为Google任务同步与本地数据库之间的数据操作桥梁，封装对ContentProvider的访问。</p>
+ * <p>核心职责：</p>
+ * <ul>
+ * <li>从Cursor加载数据</li>
+ * <li>与JSON数据格式的相互转换</li>
+ * <li>将数据变更提交到ContentProvider</li>
+ * <li>跟踪数据变更差异</li>
+ * </ul>
+ */
+public class SqlData {
+    private static final String TAG = SqlData.class.getSimpleName();
+
+    /**
+     * 无效ID常量
+     */
+    private static final int INVALID_ID = -99999;
+
+    /**
+     * 数据查询投影列
+     */
+    public static final String[] PROJECTION_DATA = new String[] {
+            DataColumns.ID, DataColumns.MIME_TYPE, DataColumns.CONTENT, DataColumns.DATA1,
+            DataColumns.DATA3
+    };
+
+    /**
+     * 数据ID列索引
+     */
+    public static final int DATA_ID_COLUMN = 0;
+
+    /**
+     * 数据MIME类型列索引
+     */
+    public static final int DATA_MIME_TYPE_COLUMN = 1;
+
+    /**
+     * 数据内容列索引
+     */
+    public static final int DATA_CONTENT_COLUMN = 2;
+
+    /**
+     * 数据内容DATA1列索引
+     */
+    public static final int DATA_CONTENT_DATA_1_COLUMN = 3;
+
+    /**
+     * 数据内容DATA3列索引
+     */
+    public static final int DATA_CONTENT_DATA_3_COLUMN = 4;
+
+    /**
+     * 内容解析器，用于访问ContentProvider
+     */
+    private ContentResolver mContentResolver;
+
+    /**
+     * 是否为新创建的数据
+     */
+    private boolean mIsCreate;
+
+    /**
+     * 数据ID
+     */
+    private long mDataId;
+
+    /**
+     * 数据MIME类型
+     */
+    private String mDataMimeType;
+
+    /**
+     * 数据内容
+     */
+    private String mDataContent;
+
+    /**
+     * 数据内容DATA1字段
+     */
+    private long mDataContentData1;
+
+    /**
+     * 数据内容DATA3字段
+     */
+    private String mDataContentData3;
+
+    /**
+     * 数据变更差异集合
+     */
+    private ContentValues mDiffDataValues;
+
+    /**
+     * <p>构造方法，创建新的SqlData对象。</p>
+     * 
+     * @param context 上下文对象
+     */
+    public SqlData(Context context) {
+        mContentResolver = context.getContentResolver();
+        mIsCreate = true;
+        mDataId = INVALID_ID;
+        mDataMimeType = DataConstants.NOTE;
+        mDataContent = "";
+        mDataContentData1 = 0;
+        mDataContentData3 = "";
+        mDiffDataValues = new ContentValues();
+    }
+
+    /**
+     * <p>构造方法，从Cursor创建SqlData对象。</p>
+     * 
+     * @param context 上下文对象
+     * @param c 包含数据的Cursor对象
+     */
+    public SqlData(Context context, Cursor c) {
+        mContentResolver = context.getContentResolver();
+        mIsCreate = false;
+        loadFromCursor(c);
+        mDiffDataValues = new ContentValues();
+    }
+
+    /**
+     * <p>从Cursor加载数据到当前对象。</p>
+     * 
+     * @param c 包含数据的Cursor对象
+     */
+    private void loadFromCursor(Cursor c) {
+        mDataId = c.getLong(DATA_ID_COLUMN);
+        mDataMimeType = c.getString(DATA_MIME_TYPE_COLUMN);
+        mDataContent = c.getString(DATA_CONTENT_COLUMN);
+        mDataContentData1 = c.getLong(DATA_CONTENT_DATA_1_COLUMN);
+        mDataContentData3 = c.getString(DATA_CONTENT_DATA_3_COLUMN);
+    }
+
+    /**
+     * <p>从JSON对象设置数据内容。</p>
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>从JSON对象中提取各个字段的值</li>
+     * <li>比较当前值与新值，仅在不同时更新差异集合</li>
+     * <li>更新当前对象的字段值</li>
+     * </ul>
+     * 
+     * @param js 包含数据的JSON对象
+     * @throws JSONException 如果JSON解析失败
+     */
+    public void setContent(JSONObject js) throws JSONException {
+        long dataId = js.has(DataColumns.ID) ? js.getLong(DataColumns.ID) : INVALID_ID;
+        if (mIsCreate || mDataId != dataId) {
+            mDiffDataValues.put(DataColumns.ID, dataId);
+        }
+        mDataId = dataId;
+
+        String dataMimeType = js.has(DataColumns.MIME_TYPE) ? js.getString(DataColumns.MIME_TYPE)
+                : DataConstants.NOTE;
+        if (mIsCreate || !mDataMimeType.equals(dataMimeType)) {
+            mDiffDataValues.put(DataColumns.MIME_TYPE, dataMimeType);
+        }
+        mDataMimeType = dataMimeType;
+
+        String dataContent = js.has(DataColumns.CONTENT) ? js.getString(DataColumns.CONTENT) : "";
+        if (mIsCreate || !mDataContent.equals(dataContent)) {
+            mDiffDataValues.put(DataColumns.CONTENT, dataContent);
+        }
+        mDataContent = dataContent;
+
+        long dataContentData1 = js.has(DataColumns.DATA1) ? js.getLong(DataColumns.DATA1) : 0;
+        if (mIsCreate || mDataContentData1 != dataContentData1) {
+            mDiffDataValues.put(DataColumns.DATA1, dataContentData1);
+        }
+        mDataContentData1 = dataContentData1;
+
+        String dataContentData3 = js.has(DataColumns.DATA3) ? js.getString(DataColumns.DATA3) : "";
+        if (mIsCreate || !mDataContentData3.equals(dataContentData3)) {
+            mDiffDataValues.put(DataColumns.DATA3, dataContentData3);
+        }
+        mDataContentData3 = dataContentData3;
+    }
+
+    /**
+     * <p>获取当前数据的JSON表示。</p>
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>检查数据是否已创建</li>
+     * <li>创建JSON对象并设置各个字段值</li>
+     * <li>返回JSON对象</li>
+     * </ul>
+     * 
+     * @return 包含数据的JSON对象，若数据未创建则返回null
+     * @throws JSONException 如果JSON创建失败
+     */
+    public JSONObject getContent() throws JSONException {
+        if (mIsCreate) {
+            Log.e(TAG, "it seems that we haven't created this in database yet");
+            return null;
+        }
+        JSONObject js = new JSONObject();
+        js.put(DataColumns.ID, mDataId);
+        js.put(DataColumns.MIME_TYPE, mDataMimeType);
+        js.put(DataColumns.CONTENT, mDataContent);
+        js.put(DataColumns.DATA1, mDataContentData1);
+        js.put(DataColumns.DATA3, mDataContentData3);
+        return js;
+    }
+
+    /**
+     * <p>提交数据变更到ContentProvider。</p>
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>如果是新创建的数据，执行插入操作</li>
+     * <li>如果是已存在的数据，执行更新操作</li>
+     * <li>支持版本验证，避免并发更新冲突</li>
+     * <li>更新操作完成后清空差异集合</li>
+     * </ul>
+     * 
+     * @param noteId 所属便签ID
+     * @param validateVersion 是否验证版本
+     * @param version 版本号
+     * @throws ActionFailureException 如果操作失败
+     */
+    public void commit(long noteId, boolean validateVersion, long version) {
+
+        if (mIsCreate) {
+            if (mDataId == INVALID_ID && mDiffDataValues.containsKey(DataColumns.ID)) {
+                mDiffDataValues.remove(DataColumns.ID);
+            }
+
+            mDiffDataValues.put(DataColumns.NOTE_ID, noteId);
+            Uri uri = mContentResolver.insert(Notes.CONTENT_DATA_URI, mDiffDataValues);
+            try {
+                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);
+                } else {
+                    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)
+                            });
+                }
+                if (result == 0) {
+                    Log.w(TAG, "there is no update. maybe user updates note when syncing");
+                }
+            }
+        }
+
+        mDiffDataValues.clear();
+        mIsCreate = false;
+    }
+
+    /**
+     * <p>获取数据ID。</p>
+     * 
+     * @return 数据ID
+     */
+    public long getId() {
+        return mDataId;
+    }
+}

src/gtask/data/SqlNote.java

@@ -0,0 +1,759 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.gtask.data;
+
+import android.appwidget.AppWidgetManager;
+import android.content.ContentResolver;
+import android.content.ContentValues;
+import android.content.Context;
+import android.database.Cursor;
+import android.net.Uri;
+import android.util.Log;
+
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.DataColumns;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.gtask.exception.ActionFailureException;
+import net.micode.notes.tool.GTaskStringUtils;
+import net.micode.notes.tool.ResourceParser;
+
+import org.json.JSONArray;
+import org.json.JSONException;
+import org.json.JSONObject;
+
+import java.util.ArrayList;
+
+
+/**
+ * <p>本地便签数据操作类，用于Google任务同步时的便签元数据与内容数据管理。</p>
+ * <p>核心职责：</p>
+ * <ul>
+ * <li>管理便签的元数据（如标题、类型、修改时间等）</li>
+ * <li>处理便签的内容数据集合（通过{@link SqlData}）</li>
+ * <li>实现便签数据与JSON格式的相互转换</li>
+ * <li>提供便签数据的增删改查操作</li>
+ * <li>支持版本验证以避免并发更新冲突</li>
+ * </ul>
+ * <p>设计意图：</p>
+ * <ul>
+ * <li>作为Google任务同步与本地数据库之间的桥梁</li>
+ * <li>封装ContentProvider的复杂操作，提供简洁的API</li>
+ * <li>支持批量提交数据变更，提高性能</li>
+ * <li>维护数据一致性，确保元数据与内容数据同步更新</li>
+ * </ul>
+ * <p>关键关联：</p>
+ * <ul>
+ * <li>使用{@link Context}访问系统ContentResolver</li>
+ * <li>使用{@link ContentProvider}进行本地数据库操作</li>
+ * <li>与{@link SqlData}协作管理便签内容</li>
+ * <li>与{@link GTaskManager}集成实现Google任务同步</li>
+ * </ul>
+ */
+public class SqlNote {
+    /**
+     * <p>日志标签。</p>
+     * <p>业务含义：用于在日志中标识SqlNote类的相关操作，便于调试和问题追踪。</p>
+     */
+    private static final String TAG = SqlNote.class.getSimpleName();
+
+    /**
+     * <p>无效ID常量。</p>
+     * <p>业务含义：表示未初始化或无效的便签ID，用于边界条件判断。</p>
+     * <p>取值：-99999</p>
+     */
+    private static final int INVALID_ID = -99999;
+
+    /**
+     * <p>便签查询投影列。</p>
+     * <p>业务含义：定义从ContentProvider查询便签数据时返回的字段集合。</p>
+     * <p>包含：ID、提醒日期、背景颜色ID、创建日期、是否有附件、修改日期等关键字段。</p>
+     */
+    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,
+            NoteColumns.NOTES_COUNT, NoteColumns.PARENT_ID, NoteColumns.SNIPPET, NoteColumns.TYPE,
+            NoteColumns.WIDGET_ID, NoteColumns.WIDGET_TYPE, NoteColumns.SYNC_ID,
+            NoteColumns.LOCAL_MODIFIED, NoteColumns.ORIGIN_PARENT_ID, NoteColumns.GTASK_ID,
+            NoteColumns.VERSION
+    };
+
+    /**
+     * <p>ID列索引。</p>
+     * <p>业务含义：PROJECTION_NOTE数组中ID字段的索引位置。</p>
+     * <p>取值：0</p>
+     */
+    public static final int ID_COLUMN = 0;
+
+    /**
+     * <p>提醒日期列索引。</p>
+     * <p>业务含义：PROJECTION_NOTE数组中提醒日期字段的索引位置。</p>
+     * <p>取值：1</p>
+     */
+    public static final int ALERTED_DATE_COLUMN = 1;
+
+    /**
+     * <p>背景颜色ID列索引。</p>
+     * <p>业务含义：PROJECTION_NOTE数组中背景颜色ID字段的索引位置。</p>
+     * <p>取值：2</p>
+     */
+    public static final int BG_COLOR_ID_COLUMN = 2;
+
+    /**
+     * <p>创建日期列索引。</p>
+     * <p>业务含义：PROJECTION_NOTE数组中创建日期字段的索引位置。</p>
+     * <p>取值：3</p>
+     */
+    public static final int CREATED_DATE_COLUMN = 3;
+
+    /**
+     * <p>是否有附件列索引。</p>
+     * <p>业务含义：PROJECTION_NOTE数组中是否有附件字段的索引位置。</p>
+     * <p>取值：4</p>
+     */
+    public static final int HAS_ATTACHMENT_COLUMN = 4;
+
+    /**
+     * <p>修改日期列索引。</p>
+     * <p>业务含义：PROJECTION_NOTE数组中修改日期字段的索引位置。</p>
+     * <p>取值：5</p>
+     */
+    public static final int MODIFIED_DATE_COLUMN = 5;
+
+    /**
+     * <p>便签数量列索引。</p>
+     * <p>业务含义：PROJECTION_NOTE数组中便签数量字段的索引位置。</p>
+     * <p>取值：6</p>
+     */
+    public static final int NOTES_COUNT_COLUMN = 6;
+
+    /**
+     * <p>父ID列索引。</p>
+     * <p>业务含义：PROJECTION_NOTE数组中父ID字段的索引位置。</p>
+     * <p>取值：7</p>
+     */
+    public static final int PARENT_ID_COLUMN = 7;
+
+    /**
+     * <p>摘要列索引。</p>
+     * <p>业务含义：PROJECTION_NOTE数组中摘要字段的索引位置。</p>
+     * <p>取值：8</p>
+     */
+    public static final int SNIPPET_COLUMN = 8;
+
+    /**
+     * <p>类型列索引。</p>
+     * <p>业务含义：PROJECTION_NOTE数组中类型字段的索引位置。</p>
+     * <p>取值：9</p>
+     */
+    public static final int TYPE_COLUMN = 9;
+
+    /**
+     * <p>小组件ID列索引。</p>
+     * <p>业务含义：PROJECTION_NOTE数组中小组件ID字段的索引位置。</p>
+     * <p>取值：10</p>
+     */
+    public static final int WIDGET_ID_COLUMN = 10;
+
+    /**
+     * <p>小组件类型列索引。</p>
+     * <p>业务含义：PROJECTION_NOTE数组中小组件类型字段的索引位置。</p>
+     * <p>取值：11</p>
+     */
+    public static final int WIDGET_TYPE_COLUMN = 11;
+
+    /**
+     * <p>同步ID列索引。</p>
+     * <p>业务含义：PROJECTION_NOTE数组中同步ID字段的索引位置。</p>
+     * <p>取值：12</p>
+     */
+    public static final int SYNC_ID_COLUMN = 12;
+
+    /**
+     * <p>本地修改列索引。</p>
+     * <p>业务含义：PROJECTION_NOTE数组中本地修改字段的索引位置。</p>
+     * <p>取值：13</p>
+     */
+    public static final int LOCAL_MODIFIED_COLUMN = 13;
+
+    /**
+     * <p>原始父ID列索引。</p>
+     * <p>业务含义：PROJECTION_NOTE数组中原始父ID字段的索引位置。</p>
+     * <p>取值：14</p>
+     */
+    public static final int ORIGIN_PARENT_ID_COLUMN = 14;
+
+    /**
+     * <p>Google任务ID列索引。</p>
+     * <p>业务含义：PROJECTION_NOTE数组中Google任务ID字段的索引位置。</p>
+     * <p>取值：15</p>
+     */
+    public static final int GTASK_ID_COLUMN = 15;
+
+    /**
+     * <p>版本列索引。</p>
+     * <p>业务含义：PROJECTION_NOTE数组中版本字段的索引位置。</p>
+     * <p>取值：16</p>
+     */
+    public static final int VERSION_COLUMN = 16;
+
+    /**
+     * <p>上下文对象。</p>
+     * <p>业务含义：用于访问系统资源和ContentResolver。</p>
+     * <p>使用场景：在构造函数中初始化，用于后续的ContentProvider操作。</p>
+     */
+    private Context mContext;
+
+    /**
+     * <p>内容解析器。</p>
+     * <p>业务含义：用于与ContentProvider进行交互，执行数据库操作。</p>
+     * <p>使用场景：在构造函数中初始化，用于后续的CRUD操作。</p>
+     */
+    private ContentResolver mContentResolver;
+
+    /**
+     * <p>是否为新创建的便签。</p>
+     * <p>业务含义：标识当前便签对象是否已在数据库中创建。</p>
+     * <p>使用场景：在构造函数中初始化，用于确定执行插入或更新操作。</p>
+     */
+    private boolean mIsCreate;
+
+    /**
+     * <p>便签ID。</p>
+     * <p>业务含义：便签在本地数据库中的唯一标识符。</p>
+     * <p>默认值：INVALID_ID（-99999）</p>
+     */
+    private long mId;
+
+    /**
+     * <p>提醒日期。</p>
+     * <p>业务含义：便签的提醒时间戳。</p>
+     * <p>默认值：0（表示无提醒）</p>
+     */
+    private long mAlertDate;
+
+    /**
+     * <p>背景颜色ID。</p>
+     * <p>业务含义：便签的背景颜色资源ID。</p>
+     * <p>默认值：通过ResourceParser.getDefaultBgId(context)获取</p>
+     */
+    private int mBgColorId;
+
+    /**
+     * <p>创建日期。</p>
+     * <p>业务含义：便签创建的时间戳。</p>
+     * <p>默认值：当前系统时间</p>
+     */
+    private long mCreatedDate;
+
+    /**
+     * <p>是否有附件。</p>
+     * <p>业务含义：标识便签是否包含附件。</p>
+     * <p>取值：0（无附件）或1（有附件）</p>
+     * <p>默认值：0</p>
+     */
+    private int mHasAttachment;
+
+    /**
+     * <p>修改日期。</p>
+     * <p>业务含义：便签最后一次修改的时间戳。</p>
+     * <p>默认值：当前系统时间</p>
+     */
+    private long mModifiedDate;
+
+    /**
+     * <p>父便签ID。</p>
+     * <p>业务含义：便签所属的父文件夹ID。</p>
+     * <p>默认值：0（表示根目录）</p>
+     */
+    private long mParentId;
+
+    /**
+     * <p>便签摘要。</p>
+     * <p>业务含义：便签的标题或简短描述。</p>
+     * <p>默认值：空字符串</p>
+     */
+    private String mSnippet;
+
+    /**
+     * <p>便签类型。</p>
+     * <p>业务含义：便签的类型（如普通便签、文件夹等）。</p>
+     * <p>默认值：Notes.TYPE_NOTE</p>
+     */
+    private int mType;
+
+    /**
+     * <p>小组件ID。</p>
+     * <p>业务含义：关联的桌面小组件ID。</p>
+     * <p>默认值：AppWidgetManager.INVALID_APPWIDGET_ID</p>
+     */
+    private int mWidgetId;
+
+    /**
+     * <p>小组件类型。</p>
+     * <p>业务含义：关联的桌面小组件类型。</p>
+     * <p>默认值：Notes.TYPE_WIDGET_INVALIDE</p>
+     */
+    private int mWidgetType;
+
+    /**
+     * <p>原始父便签ID。</p>
+     * <p>业务含义：便签原始所属的父文件夹ID，用于同步操作。</p>
+     * <p>默认值：0</p>
+     */
+    private long mOriginParent;
+
+    /**
+     * <p>版本号。</p>
+     * <p>业务含义：便签的版本号，用于并发更新冲突检测。</p>
+     * <p>默认值：0</p>
+     */
+    private long mVersion;
+
+    /**
+     * <p>便签元数据变更集合。</p>
+     * <p>业务含义：存储便签元数据的变更内容，用于批量更新。</p>
+     * <p>使用场景：在setContent方法中记录变更，在commit方法中提交变更。</p>
+     */
+    private ContentValues mDiffNoteValues;
+
+    /**
+     * <p>便签内容数据集合。</p>
+     * <p>业务含义：存储便签的内容数据列表。</p>
+     * <p>使用场景：与SqlData类协作，管理便签的具体内容。</p>
+     */
+    private ArrayList<SqlData> mDataList;
+
+    /**
+     * <p>创建一个新的SqlNote实例。</p>
+     * <p>功能：初始化一个新的便签对象，设置默认值。</p>
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>设置mIsCreate为true，表示这是一个新创建的便签</li>
+     * <li>初始化所有字段为默认值</li>
+     * <li>创建空的变更集合和数据列表</li>
+     * </ul>
+     * 
+     * @param context 上下文对象，用于访问系统资源和ContentResolver
+     */
+    public SqlNote(Context context) {
+        mContext = context;
+        mContentResolver = context.getContentResolver();
+        mIsCreate = true;
+        mId = INVALID_ID;
+        mAlertDate = 0;
+        mBgColorId = ResourceParser.getDefaultBgId(context);
+        mCreatedDate = System.currentTimeMillis();
+        mHasAttachment = 0;
+        mModifiedDate = System.currentTimeMillis();
+        mParentId = 0;
+        mSnippet = "";
+        mType = Notes.TYPE_NOTE;
+        mWidgetId = AppWidgetManager.INVALID_APPWIDGET_ID;
+        mWidgetType = Notes.TYPE_WIDGET_INVALIDE;
+        mOriginParent = 0;
+        mVersion = 0;
+        mDiffNoteValues = new ContentValues();
+        mDataList = new ArrayList<SqlData>();
+    }
+
+    /**
+     * <p>从Cursor创建SqlNote实例。</p>
+     * <p>功能：从数据库查询结果创建便签对象。</p>
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>设置mIsCreate为false，表示这是一个已存在的便签</li>
+     * <li>从Cursor加载便签数据</li>
+     * <li>如果是普通便签，加载便签内容</li>
+     * <li>创建空的变更集合</li>
+     * </ul>
+     * 
+     * @param context 上下文对象，用于访问系统资源和ContentResolver
+     * @param c 查询结果Cursor，包含便签的元数据
+     */
+    public SqlNote(Context context, Cursor c) {
+        mContext = context;
+        mContentResolver = context.getContentResolver();
+        mIsCreate = false;
+        loadFromCursor(c);
+        mDataList = new ArrayList<SqlData>();
+        if (mType == Notes.TYPE_NOTE)
+            loadDataContent();
+        mDiffNoteValues = new ContentValues();
+    }
+
+    /**
+     * <p>通过ID创建SqlNote实例。</p>
+     * <p>功能：根据便签ID从数据库加载便签对象。</p>
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>设置mIsCreate为false，表示这是一个已存在的便签</li>
+     * <li>根据ID查询数据库并加载便签数据</li>
+     * <li>如果是普通便签，加载便签内容</li>
+     * <li>创建空的变更集合</li>
+     * </ul>
+     * 
+     * @param context 上下文对象，用于访问系统资源和ContentResolver
+     * @param id 便签ID，用于从数据库加载便签数据
+     */
+    public SqlNote(Context context, long id) {
+        mContext = context;
+        mContentResolver = context.getContentResolver();
+        mIsCreate = false;
+        loadFromCursor(id);
+        mDataList = new ArrayList<SqlData>();
+        if (mType == Notes.TYPE_NOTE)
+            loadDataContent();
+        mDiffNoteValues = new ContentValues();
+    }
+
+    private void loadFromCursor(long id) {
+        Cursor c = null;
+        try {
+            c = mContentResolver.query(Notes.CONTENT_NOTE_URI, PROJECTION_NOTE, "(_id=?)",
+                    new String[] {
+                        String.valueOf(id)
+                    }, null);
+            if (c != null) {
+                c.moveToNext();
+                loadFromCursor(c);
+            } else {
+                Log.w(TAG, "loadFromCursor: cursor = null");
+            }
+        } finally {
+            if (c != null)
+                c.close();
+        }
+    }
+
+    private void loadFromCursor(Cursor c) {
+        mId = c.getLong(ID_COLUMN);
+        mAlertDate = c.getLong(ALERTED_DATE_COLUMN);
+        mBgColorId = c.getInt(BG_COLOR_ID_COLUMN);
+        mCreatedDate = c.getLong(CREATED_DATE_COLUMN);
+        mHasAttachment = c.getInt(HAS_ATTACHMENT_COLUMN);
+        mModifiedDate = c.getLong(MODIFIED_DATE_COLUMN);
+        mParentId = c.getLong(PARENT_ID_COLUMN);
+        mSnippet = c.getString(SNIPPET_COLUMN);
+        mType = c.getInt(TYPE_COLUMN);
+        mWidgetId = c.getInt(WIDGET_ID_COLUMN);
+        mWidgetType = c.getInt(WIDGET_TYPE_COLUMN);
+        mVersion = c.getLong(VERSION_COLUMN);
+    }
+
+    private void loadDataContent() {
+        Cursor c = null;
+        mDataList.clear();
+        try {
+            c = mContentResolver.query(Notes.CONTENT_DATA_URI, SqlData.PROJECTION_DATA,
+                    "(note_id=?)", new String[] {
+                        String.valueOf(mId)
+                    }, null);
+            if (c != null) {
+                if (c.getCount() == 0) {
+                    Log.w(TAG, "it seems that the note has not data");
+                    return;
+                }
+                while (c.moveToNext()) {
+                    SqlData data = new SqlData(mContext, c);
+                    mDataList.add(data);
+                }
+            } else {
+                Log.w(TAG, "loadDataContent: cursor = null");
+            }
+        } finally {
+            if (c != null)
+                c.close();
+        }
+    }
+
+    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)) {
+                    mDiffNoteValues.put(NoteColumns.SNIPPET, snippet);
+                }
+                mSnippet = snippet;
+
+                int type = note.has(NoteColumns.TYPE) ? note.getInt(NoteColumns.TYPE)
+                        : Notes.TYPE_NOTE;
+                if (mIsCreate || mType != type) {
+                    mDiffNoteValues.put(NoteColumns.TYPE, type);
+                }
+                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;
+                if (mIsCreate || mId != id) {
+                    mDiffNoteValues.put(NoteColumns.ID, id);
+                }
+                mId = id;
+
+                long alertDate = note.has(NoteColumns.ALERTED_DATE) ? note
+                        .getLong(NoteColumns.ALERTED_DATE) : 0;
+                if (mIsCreate || mAlertDate != alertDate) {
+                    mDiffNoteValues.put(NoteColumns.ALERTED_DATE, alertDate);
+                }
+                mAlertDate = alertDate;
+
+                int bgColorId = note.has(NoteColumns.BG_COLOR_ID) ? note
+                        .getInt(NoteColumns.BG_COLOR_ID) : ResourceParser.getDefaultBgId(mContext);
+                if (mIsCreate || mBgColorId != bgColorId) {
+                    mDiffNoteValues.put(NoteColumns.BG_COLOR_ID, bgColorId);
+                }
+                mBgColorId = bgColorId;
+
+                long createDate = note.has(NoteColumns.CREATED_DATE) ? note
+                        .getLong(NoteColumns.CREATED_DATE) : System.currentTimeMillis();
+                if (mIsCreate || mCreatedDate != createDate) {
+                    mDiffNoteValues.put(NoteColumns.CREATED_DATE, createDate);
+                }
+                mCreatedDate = createDate;
+
+                int hasAttachment = note.has(NoteColumns.HAS_ATTACHMENT) ? note
+                        .getInt(NoteColumns.HAS_ATTACHMENT) : 0;
+                if (mIsCreate || mHasAttachment != hasAttachment) {
+                    mDiffNoteValues.put(NoteColumns.HAS_ATTACHMENT, hasAttachment);
+                }
+                mHasAttachment = hasAttachment;
+
+                long modifiedDate = note.has(NoteColumns.MODIFIED_DATE) ? note
+                        .getLong(NoteColumns.MODIFIED_DATE) : System.currentTimeMillis();
+                if (mIsCreate || mModifiedDate != modifiedDate) {
+                    mDiffNoteValues.put(NoteColumns.MODIFIED_DATE, modifiedDate);
+                }
+                mModifiedDate = modifiedDate;
+
+                long parentId = note.has(NoteColumns.PARENT_ID) ? note
+                        .getLong(NoteColumns.PARENT_ID) : 0;
+                if (mIsCreate || mParentId != parentId) {
+                    mDiffNoteValues.put(NoteColumns.PARENT_ID, parentId);
+                }
+                mParentId = parentId;
+
+                String snippet = note.has(NoteColumns.SNIPPET) ? note
+                        .getString(NoteColumns.SNIPPET) : "";
+                if (mIsCreate || !mSnippet.equals(snippet)) {
+                    mDiffNoteValues.put(NoteColumns.SNIPPET, snippet);
+                }
+                mSnippet = snippet;
+
+                int type = note.has(NoteColumns.TYPE) ? note.getInt(NoteColumns.TYPE)
+                        : Notes.TYPE_NOTE;
+                if (mIsCreate || mType != type) {
+                    mDiffNoteValues.put(NoteColumns.TYPE, type);
+                }
+                mType = type;
+
+                int widgetId = note.has(NoteColumns.WIDGET_ID) ? note.getInt(NoteColumns.WIDGET_ID)
+                        : AppWidgetManager.INVALID_APPWIDGET_ID;
+                if (mIsCreate || mWidgetId != widgetId) {
+                    mDiffNoteValues.put(NoteColumns.WIDGET_ID, widgetId);
+                }
+                mWidgetId = widgetId;
+
+                int widgetType = note.has(NoteColumns.WIDGET_TYPE) ? note
+                        .getInt(NoteColumns.WIDGET_TYPE) : Notes.TYPE_WIDGET_INVALIDE;
+                if (mIsCreate || mWidgetType != widgetType) {
+                    mDiffNoteValues.put(NoteColumns.WIDGET_TYPE, widgetType);
+                }
+                mWidgetType = widgetType;
+
+                long originParent = note.has(NoteColumns.ORIGIN_PARENT_ID) ? note
+                        .getLong(NoteColumns.ORIGIN_PARENT_ID) : 0;
+                if (mIsCreate || mOriginParent != originParent) {
+                    mDiffNoteValues.put(NoteColumns.ORIGIN_PARENT_ID, originParent);
+                }
+                mOriginParent = originParent;
+
+                for (int i = 0; i < dataArray.length(); i++) {
+                    JSONObject data = dataArray.getJSONObject(i);
+                    SqlData sqlData = null;
+                    if (data.has(DataColumns.ID)) {
+                        long dataId = data.getLong(DataColumns.ID);
+                        for (SqlData temp : mDataList) {
+                            if (dataId == temp.getId()) {
+                                sqlData = temp;
+                            }
+                        }
+                    }
+
+                    if (sqlData == null) {
+                        sqlData = new SqlData(mContext);
+                        mDataList.add(sqlData);
+                    }
+
+                    sqlData.setContent(data);
+                }
+            }
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            return false;
+        }
+        return true;
+    }
+
+    public JSONObject getContent() {
+        try {
+            JSONObject js = new JSONObject();
+
+            if (mIsCreate) {
+                Log.e(TAG, "it seems that we haven't created this in database yet");
+                return null;
+            }
+
+            JSONObject note = new JSONObject();
+            if (mType == Notes.TYPE_NOTE) {
+                note.put(NoteColumns.ID, mId);
+                note.put(NoteColumns.ALERTED_DATE, mAlertDate);
+                note.put(NoteColumns.BG_COLOR_ID, mBgColorId);
+                note.put(NoteColumns.CREATED_DATE, mCreatedDate);
+                note.put(NoteColumns.HAS_ATTACHMENT, mHasAttachment);
+                note.put(NoteColumns.MODIFIED_DATE, mModifiedDate);
+                note.put(NoteColumns.PARENT_ID, mParentId);
+                note.put(NoteColumns.SNIPPET, mSnippet);
+                note.put(NoteColumns.TYPE, mType);
+                note.put(NoteColumns.WIDGET_ID, mWidgetId);
+                note.put(NoteColumns.WIDGET_TYPE, mWidgetType);
+                note.put(NoteColumns.ORIGIN_PARENT_ID, mOriginParent);
+                js.put(GTaskStringUtils.META_HEAD_NOTE, note);
+
+                JSONArray dataArray = new JSONArray();
+                for (SqlData sqlData : mDataList) {
+                    JSONObject data = sqlData.getContent();
+                    if (data != null) {
+                        dataArray.put(data);
+                    }
+                }
+                js.put(GTaskStringUtils.META_HEAD_DATA, dataArray);
+            } else if (mType == Notes.TYPE_FOLDER || mType == Notes.TYPE_SYSTEM) {
+                note.put(NoteColumns.ID, mId);
+                note.put(NoteColumns.TYPE, mType);
+                note.put(NoteColumns.SNIPPET, mSnippet);
+                js.put(GTaskStringUtils.META_HEAD_NOTE, note);
+            }
+
+            return js;
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+        }
+        return null;
+    }
+
+    public void setParentId(long id) {
+        mParentId = id;
+        mDiffNoteValues.put(NoteColumns.PARENT_ID, id);
+    }
+
+    public void setGtaskId(String gid) {
+        mDiffNoteValues.put(NoteColumns.GTASK_ID, gid);
+    }
+
+    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)) {
+                mDiffNoteValues.remove(NoteColumns.ID);
+            }
+
+            Uri uri = mContentResolver.insert(Notes.CONTENT_NOTE_URI, mDiffNoteValues);
+            try {
+                mId = Long.valueOf(uri.getPathSegments().get(1));
+            } catch (NumberFormatException e) {
+                Log.e(TAG, "Get note id error :" + e.toString());
+                throw new ActionFailureException("create note failed");
+            }
+            if (mId == 0) {
+                throw new IllegalStateException("Create thread id failed");
+            }
+
+            if (mType == Notes.TYPE_NOTE) {
+                for (SqlData sqlData : mDataList) {
+                    sqlData.commit(mId, false, -1);
+                }
+            }
+        } else {
+            if (mId <= 0 && mId != Notes.ID_ROOT_FOLDER && mId != Notes.ID_CALL_RECORD_FOLDER) {
+                Log.e(TAG, "No such note");
+                throw new IllegalStateException("Try to update note with invalid id");
+            }
+            if (mDiffNoteValues.size() > 0) {
+                mVersion ++;
+                int result = 0;
+                if (!validateVersion) {
+                    result = mContentResolver.update(Notes.CONTENT_NOTE_URI, mDiffNoteValues, "("
+                            + NoteColumns.ID + "=?)", new String[] {
+                        String.valueOf(mId)
+                    });
+                } else {
+                    result = mContentResolver.update(Notes.CONTENT_NOTE_URI, mDiffNoteValues, "("
+                            + NoteColumns.ID + "=?) AND (" + NoteColumns.VERSION + "<=?)",
+                            new String[] {
+                                    String.valueOf(mId), String.valueOf(mVersion)
+                            });
+                }
+                if (result == 0) {
+                    Log.w(TAG, "there is no update. maybe user updates note when syncing");
+                }
+            }
+
+            if (mType == Notes.TYPE_NOTE) {
+                for (SqlData sqlData : mDataList) {
+                    sqlData.commit(mId, validateVersion, mVersion);
+                }
+            }
+        }
+
+        // refresh local info
+        loadFromCursor(mId);
+        if (mType == Notes.TYPE_NOTE)
+            loadDataContent();
+
+        mDiffNoteValues.clear();
+        mIsCreate = false;
+    }
+}

src/gtask/data/Task.java

@@ -0,0 +1,560 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.gtask.data;
+
+import android.database.Cursor;
+import android.text.TextUtils;
+import android.util.Log;
+
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.DataColumns;
+import net.micode.notes.data.Notes.DataConstants;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.gtask.exception.ActionFailureException;
+import net.micode.notes.tool.GTaskStringUtils;
+
+import org.json.JSONArray;
+import org.json.JSONException;
+import org.json.JSONObject;
+
+
+/**
+ * <p>Google任务类，继承自{@link Node}抽象类。</p>
+ * <p>设计意图：实现Google任务的具体数据模型和同步操作，处理任务的创建、更新、删除等功能。</p>
+ * <p>核心职责：</p>
+ * <ul>
+ * <li>封装Google任务的特有属性：完成状态、备注、元信息、兄弟任务关系、父子任务关系</li>
+ * <li>实现同步操作方法：生成创建/更新动作、解析本地/远程JSON数据、判断同步动作类型</li>
+ * <li>提供任务关系管理：设置父任务列表、前一个兄弟任务</li>
+ * <li>实现任务元信息管理：设置和解析任务的元数据</li>
+ * </ul>
+ * <p>关键关联：</p>
+ * <ul>
+ * <li>继承自{@link Node}抽象类，实现Google任务数据模型的标准化接口</li>
+ * <li>与{@link TaskList}类关联，任务必须属于某个任务列表</li>
+ * <li>与{@link MetaData}类关联，管理任务的元信息</li>
+ * <li>与{@link GTaskStringUtils}类配合使用，处理Google任务的JSON字段名</li>
+ * </ul>
+ */
+public class Task extends Node {
+    private static final String TAG = Task.class.getSimpleName();
+
+    /**
+     * 任务完成状态标记
+     */
+    private boolean mCompleted;
+
+    /**
+     * 任务备注信息
+     */
+    private String mNotes;
+
+    /**
+     * 任务元信息JSON对象，包含本地任务的详细信息
+     */
+    private JSONObject mMetaInfo;
+
+    /**
+     * 前一个兄弟任务，用于维护任务的顺序
+     */
+    private Task mPriorSibling;
+
+    /**
+     * 父任务列表，任务所属的任务列表
+     */
+    private TaskList mParent;
+
+    /**
+     * 默认构造方法，初始化任务属性
+     */
+    public Task() {
+        super();
+        mCompleted = false;
+        mNotes = null;
+        mPriorSibling = null;
+        mParent = null;
+        mMetaInfo = null;
+    }
+
+    /**
+     * <p>生成创建任务的JSON动作对象。</p>
+     * <p>业务逻辑：构造用于向Google任务服务添加新任务的JSON数据，包含任务的基本信息和关系。</p>
+     * <p>JSON结构说明：
+     * <ul>
+     * <li>action_type: 动作类型，固定为"create"</li>
+     * <li>action_id: 动作ID，用于标识同步任务序列</li>
+     * <li>index: 任务在父列表中的位置索引</li>
+     * <li>entity_delta: 任务实体信息，包含任务名称、创建者ID、实体类型、备注等</li>
+     * <li>parent_id: 父任务列表ID</li>
+     * <li>dest_parent_type: 目标父类型，固定为"group"</li>
+     * <li>list_id: 任务列表ID</li>
+     * <li>prior_sibling_id: 前一个兄弟任务ID（可选）</li>
+     * </ul>
+     * </p>
+     * 
+     * @param actionId 动作ID，用于标识同步任务序列
+     * @return 创建动作的JSON对象，包含任务创建所需的所有信息
+     * @throws ActionFailureException 如果生成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
+            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");
+            entity.put(GTaskStringUtils.GTASK_JSON_ENTITY_TYPE,
+                    GTaskStringUtils.GTASK_JSON_TYPE_TASK);
+            if (getNotes() != null) {
+                entity.put(GTaskStringUtils.GTASK_JSON_NOTES, getNotes());
+            }
+            js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity);
+
+            // parent_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
+            js.put(GTaskStringUtils.GTASK_JSON_LIST_ID, mParent.getGid());
+
+            // prior_sibling_id
+            if (mPriorSibling != null) {
+                js.put(GTaskStringUtils.GTASK_JSON_PRIOR_SIBLING_ID, mPriorSibling.getGid());
+            }
+
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            throw new ActionFailureException("fail to generate task-create jsonobject");
+        }
+
+        return js;
+    }
+
+    /**
+     * <p>生成更新任务的JSON动作对象。</p>
+     * <p>业务逻辑：构造用于向Google任务服务更新现有任务的JSON数据，包含任务的更新信息。</p>
+     * <p>JSON结构说明：
+     * <ul>
+     * <li>action_type: 动作类型，固定为"update"</li>
+     * <li>action_id: 动作ID，用于标识同步任务序列</li>
+     * <li>id: 任务ID，标识要更新的任务</li>
+     * <li>entity_delta: 任务实体更新信息，包含任务名称、备注、删除状态等</li>
+     * </ul>
+     * </p>
+     * 
+     * @param actionId 动作ID，用于标识同步任务序列
+     * @return 更新动作的JSON对象，包含任务更新所需的所有信息
+     * @throws ActionFailureException 如果生成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
+            js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId);
+
+            // id
+            js.put(GTaskStringUtils.GTASK_JSON_ID, getGid());
+
+            // entity_delta
+            JSONObject entity = new JSONObject();
+            entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName());
+            if (getNotes() != null) {
+                entity.put(GTaskStringUtils.GTASK_JSON_NOTES, getNotes());
+            }
+            entity.put(GTaskStringUtils.GTASK_JSON_DELETED, getDeleted());
+            js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity);
+
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            throw new ActionFailureException("fail to generate task-update jsonobject");
+        }
+
+        return js;
+    }
+
+    /**
+     * <p>从远程JSON数据解析并设置任务内容。</p>
+     * <p>业务逻辑：将Google任务服务返回的JSON数据转换为任务对象的属性值。</p>
+     * <p>解析的JSON字段：
+     * <ul>
+     * <li>id: 任务ID，设置为GID</li>
+     * <li>last_modified: 最后修改时间戳</li>
+     * <li>name: 任务名称</li>
+     * <li>notes: 任务备注</li>
+     * <li>deleted: 删除状态</li>
+     * <li>completed: 完成状态</li>
+     * </ul>
+     * </p>
+     * 
+     * @param js 远程获取的JSON对象，包含Google任务服务返回的任务数据
+     * @throws ActionFailureException 如果解析JSON对象失败，抛出此异常
+     */
+    public void setContentByRemoteJSON(JSONObject js) {
+        if (js != null) {
+            try {
+                // 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));
+                }
+            } catch (JSONException e) {
+                Log.e(TAG, e.toString());
+                e.printStackTrace();
+                throw new ActionFailureException("fail to get task content from jsonobject");
+            }
+        }
+    }
+
+    /**
+     * <p>从本地JSON数据解析并设置任务内容。</p>
+     * <p>业务逻辑：将本地存储的JSON数据转换为任务对象的属性值。</p>
+     * <p>解析的JSON结构：
+     * <ul>
+     * <li>meta_note: 包含笔记类型信息</li>
+     * <li>meta_data: 包含笔记内容数组，其中MIME类型为NOTE的数据项的内容被设置为任务名称</li>
+     * </ul>
+     * </p>
+     * 
+     * @param js 本地存储的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");
+        }
+
+        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)) {
+                    setName(data.getString(DataColumns.CONTENT));
+                    break;
+                }
+            }
+
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+        }
+    }
+
+    /**
+     * <p>从任务内容生成本地JSON对象。</p>
+     * <p>业务逻辑：根据任务名称和元信息生成本地存储所需的JSON数据结构。</p>
+     * <p>JSON结构说明：
+     * <ul>
+     * <li>meta_note: 包含笔记类型信息</li>
+     * <li>meta_data: 包含笔记内容数组，其中MIME类型为NOTE的数据项存储任务名称</li>
+     * </ul>
+     * </p>
+     * <p>处理流程：
+     * <ol>
+     * <li>如果没有元信息，生成新的JSON结构（适用于从Web创建的新任务）</li>
+     * <li>如果有元信息，更新现有结构中的任务名称（适用于已同步的任务）</li>
+     * </ol>
+     * </p>
+     * 
+     * @return 本地存储的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;
+                }
+
+                JSONObject js = new JSONObject();
+                JSONObject note = new JSONObject();
+                JSONArray dataArray = new JSONArray();
+                JSONObject data = new JSONObject();
+                data.put(DataColumns.CONTENT, name);
+                dataArray.put(data);
+                js.put(GTaskStringUtils.META_HEAD_DATA, dataArray);
+                note.put(NoteColumns.TYPE, Notes.TYPE_NOTE);
+                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)) {
+                        data.put(DataColumns.CONTENT, getName());
+                        break;
+                    }
+                }
+
+                note.put(NoteColumns.TYPE, Notes.TYPE_NOTE);
+                return mMetaInfo;
+            }
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            return null;
+        }
+    }
+
+    /**
+     * <p>设置任务的元信息。</p>
+     * <p>业务逻辑：从MetaData对象中解析JSON字符串，获取任务的元信息。</p>
+     * <p>处理流程：
+     * <ol>
+     * <li>检查MetaData对象及其notes字段是否为空</li>
+     * <li>将notes字段的JSON字符串解析为JSONObject</li>
+     * <li>如果解析失败，将元信息设置为null</li>
+     * </ol>
+     * </p>
+     * 
+     * @param metaData 包含元信息的MetaData对象
+     */
+    public void setMetaInfo(MetaData metaData) {
+        if (metaData != null && metaData.getNotes() != null) {
+            try {
+                mMetaInfo = new JSONObject(metaData.getNotes());
+            } catch (JSONException e) {
+                Log.w(TAG, e.toString());
+                mMetaInfo = null;
+            }
+        }
+    }
+
+    /**
+     * <p>获取同步动作类型。</p>
+     * <p>业务逻辑：通过比较本地任务和远程任务的状态，确定需要执行的同步动作。</p>
+     * <p>同步动作类型说明：
+     * <ul>
+     * <li>{@link Node#SYNC_ACTION_NONE}: 无同步动作，本地和远程数据一致</li>
+     * <li>{@link Node#SYNC_ACTION_UPDATE_LOCAL}: 更新本地数据，应用远程变更</li>
+     * <li>{@link Node#SYNC_ACTION_UPDATE_REMOTE}: 更新远程数据，应用本地变更</li>
+     * <li>{@link Node#SYNC_ACTION_UPDATE_CONFLICT}: 同步冲突，本地和远程都有变更</li>
+     * <li>{@link Node#SYNC_ACTION_ERROR}: 同步错误，数据验证失败</li>
+     * </ul>
+     * </p>
+     * <p>处理流程：
+     * <ol>
+     * <li>验证元信息和笔记ID的有效性</li>
+     * <li>比较本地和远程的最后修改时间</li>
+     * <li>检查本地修改标记和GTASK ID的一致性</li>
+     * <li>根据比较结果返回相应的同步动作类型</li>
+     * </ol>
+     * </p>
+     * 
+     * @param c 包含本地任务数据的游标对象
+     * @return 同步动作类型，对应Node类中定义的SYNC_ACTION_*常量
+     */
+    public int getSyncAction(Cursor c) {
+        try {
+            JSONObject noteInfo = null;
+            if (mMetaInfo != null && mMetaInfo.has(GTaskStringUtils.META_HEAD_NOTE)) {
+                noteInfo = mMetaInfo.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
+            }
+
+            if (noteInfo == null) {
+                Log.w(TAG, "it seems that note meta has been deleted");
+                return SYNC_ACTION_UPDATE_REMOTE;
+            }
+
+            if (!noteInfo.has(NoteColumns.ID)) {
+                Log.w(TAG, "remote note id seems to be deleted");
+                return SYNC_ACTION_UPDATE_LOCAL;
+            }
+
+            // validate the note id now
+            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
+                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;
+                }
+            }
+        } catch (Exception e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+        }
+
+        return SYNC_ACTION_ERROR;
+    }
+
+    /**
+     * <p>判断任务是否值得保存。</p>
+     * <p>业务逻辑：检查任务是否包含有价值的信息，用于决定是否需要保存到数据库或同步到远程。</p>
+     * <p>判断条件：满足以下任一条件则认为值得保存：
+     * <ul>
+     * <li>任务包含元信息（mMetaInfo不为null）</li>
+     * <li>任务名称不为空且长度大于0</li>
+     * <li>任务备注不为空且长度大于0</li>
+     * </ul>
+     * </p>
+     * 
+     * @return true表示任务值得保存，false表示任务为空或无价值信息
+     */
+    public boolean isWorthSaving() {
+        return mMetaInfo != null || (getName() != null && getName().trim().length() > 0)
+                || (getNotes() != null && getNotes().trim().length() > 0);
+    }
+
+    /**
+     * 设置任务的完成状态。
+     * 
+     * @param completed 任务的完成状态，true表示已完成，false表示未完成
+     */
+    public void setCompleted(boolean completed) {
+        this.mCompleted = completed;
+    }
+
+    /**
+     * 设置任务的备注信息。
+     * 
+     * @param notes 任务的备注信息字符串
+     */
+    public void setNotes(String notes) {
+        this.mNotes = notes;
+    }
+
+    /**
+     * 设置任务的前一个兄弟任务，用于维护任务的顺序。
+     * 
+     * @param priorSibling 前一个兄弟任务对象
+     */
+    public void setPriorSibling(Task priorSibling) {
+        this.mPriorSibling = priorSibling;
+    }
+
+    /**
+     * 设置任务的父任务列表。
+     * 
+     * @param parent 父任务列表对象
+     */
+    public void setParent(TaskList parent) {
+        this.mParent = parent;
+    }
+
+    /**
+     * 获取任务的完成状态。
+     * 
+     * @return 任务的完成状态，true表示已完成，false表示未完成
+     */
+    public boolean getCompleted() {
+        return this.mCompleted;
+    }
+
+    /**
+     * 获取任务的备注信息。
+     * 
+     * @return 任务的备注信息字符串
+     */
+    public String getNotes() {
+        return this.mNotes;
+    }
+
+    /**
+     * 获取任务的前一个兄弟任务。
+     * 
+     * @return 前一个兄弟任务对象，如果没有则返回null
+     */
+    public Task getPriorSibling() {
+        return this.mPriorSibling;
+    }
+
+    /**
+     * 获取任务的父任务列表。
+     * 
+     * @return 父任务列表对象，如果没有则返回null
+     */
+    public TaskList getParent() {
+        return this.mParent;
+    }
+
+}

src/gtask/data/TaskList.java

@@ -0,0 +1,495 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.gtask.data;
+
+import android.database.Cursor;
+import android.util.Log;
+
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.gtask.exception.ActionFailureException;
+import net.micode.notes.tool.GTaskStringUtils;
+
+import org.json.JSONException;
+import org.json.JSONObject;
+
+import java.util.ArrayList;
+
+
+/**
+ * Google任务列表的数据模型类，继承自Node类。
+ * <p>
+ * 负责管理任务列表的元数据信息和子任务集合，支持与Google Tasks服务的同步操作。
+ * 主要功能包括：
+ * <ul>
+ * <li>生成创建/更新任务列表的JSON动作对象</li>
+ * <li>从本地/远程JSON数据加载任务列表内容</li>
+ * <li>管理子任务集合（添加、删除、移动、查找）</li>
+ * <li>确定同步动作类型</li>
+ * </ul>
+ * </p>
+ */
+public class TaskList extends Node {
+    private static final String TAG = TaskList.class.getSimpleName();
+
+    /**
+     * 任务列表在Google任务中的索引位置，用于排序
+     */
+    private int mIndex;
+
+    /**
+     * 子任务集合，存储该任务列表下的所有任务对象
+     */
+    private ArrayList<Task> mChildren;
+
+    /**
+     * 构造函数，初始化任务列表对象
+     * <p>
+     * 创建空的子任务集合，并将索引初始化为1
+     * </p>
+     */
+    public TaskList() {
+        super();
+        mChildren = new ArrayList<Task>();
+        mIndex = 1;
+    }
+
+    /**
+     * 生成创建任务列表的JSON动作对象
+     * <p>
+     * 用于向Google Tasks服务发送创建任务列表的请求
+     * </p>
+     * @param actionId 动作ID，用于标识该创建操作
+     * @return 创建任务列表的JSON对象
+     * @throws ActionFailureException 如果生成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
+            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");
+            entity.put(GTaskStringUtils.GTASK_JSON_ENTITY_TYPE,
+                    GTaskStringUtils.GTASK_JSON_TYPE_GROUP);
+            js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity);
+
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            throw new ActionFailureException("fail to generate tasklist-create jsonobject");
+        }
+
+        return js;
+    }
+
+    /**
+     * 生成更新任务列表的JSON动作对象
+     * <p>
+     * 用于向Google Tasks服务发送更新任务列表的请求
+     * </p>
+     * @param actionId 动作ID，用于标识该更新操作
+     * @return 更新任务列表的JSON对象
+     * @throws ActionFailureException 如果生成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
+            js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId);
+
+            // 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());
+            js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity);
+
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            throw new ActionFailureException("fail to generate tasklist-update jsonobject");
+        }
+
+        return js;
+    }
+
+    /**
+     * 从远程JSON数据加载任务列表内容
+     * <p>
+     * 将Google Tasks服务返回的JSON数据解析到当前任务列表对象中
+     * </p>
+     * @param js 包含任务列表信息的JSON对象
+     * @throws ActionFailureException 如果解析JSON对象失败
+     */
+    public void setContentByRemoteJSON(JSONObject js) {
+        if (js != null) {
+            try {
+                // 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));
+                }
+
+            } catch (JSONException e) {
+                Log.e(TAG, e.toString());
+                e.printStackTrace();
+                throw new ActionFailureException("fail to get tasklist content from jsonobject");
+            }
+        }
+    }
+
+    /**
+     * 从本地JSON数据加载任务列表内容
+     * <p>
+     * 将本地数据库中的JSON数据解析到当前任务列表对象中
+     * </p>
+     * @param js 包含本地任务列表信息的JSON对象
+     */
+    public void setContentByLocalJSON(JSONObject js) {
+        if (js == null || !js.has(GTaskStringUtils.META_HEAD_NOTE)) {
+            Log.w(TAG, "setContentByLocalJSON: nothing is avaiable");
+        }
+
+        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);
+            } else if (folder.getInt(NoteColumns.TYPE) == Notes.TYPE_SYSTEM) {
+                if (folder.getLong(NoteColumns.ID) == Notes.ID_ROOT_FOLDER)
+                    setName(GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_DEFAULT);
+                else if (folder.getLong(NoteColumns.ID) == Notes.ID_CALL_RECORD_FOLDER)
+                    setName(GTaskStringUtils.MIUI_FOLDER_PREFFIX
+                            + GTaskStringUtils.FOLDER_CALL_NOTE);
+                else
+                    Log.e(TAG, "invalid system folder");
+            } else {
+                Log.e(TAG, "error type");
+            }
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+        }
+    }
+
+    /**
+     * 将任务列表内容转换为本地JSON格式
+     * <p>
+     * 生成用于存储到本地数据库的JSON对象
+     * </p>
+     * @return 包含任务列表本地信息的JSON对象，解析失败时返回null
+     */
+    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(),
+                        folderName.length());
+            folder.put(NoteColumns.SNIPPET, folderName);
+            if (folderName.equals(GTaskStringUtils.FOLDER_DEFAULT)
+                    || folderName.equals(GTaskStringUtils.FOLDER_CALL_NOTE))
+                folder.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
+            else
+                folder.put(NoteColumns.TYPE, Notes.TYPE_FOLDER);
+
+            js.put(GTaskStringUtils.META_HEAD_NOTE, folder);
+
+            return js;
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            return null;
+        }
+    }
+
+    /**
+     * 根据本地数据库游标确定同步动作类型
+     * <p>
+     * 比较本地和远程数据的状态，决定执行哪种同步操作
+     * </p>
+     * @param c 本地数据库游标，包含任务列表的本地状态信息
+     * @return 同步动作类型，可能的值：
+     *         <ul>
+     *         <li>{@link Node#SYNC_ACTION_NONE} - 无需同步</li>
+     *         <li>{@link Node#SYNC_ACTION_UPDATE_LOCAL} - 更新本地数据</li>
+     *         <li>{@link Node#SYNC_ACTION_UPDATE_REMOTE} - 更新远程数据</li>
+     *         <li>{@link Node#SYNC_ACTION_ERROR} - 同步错误</li>
+     *         </ul>
+     */
+    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
+                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;
+                }
+            }
+        } catch (Exception e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+        }
+
+        return SYNC_ACTION_ERROR;
+    }
+
+    /**
+     * 获取子任务数量
+     * @return 子任务集合的大小
+     */
+    public int getChildTaskCount() {
+        return mChildren.size();
+    }
+
+    /**
+     * 添加子任务到任务列表末尾
+     * <p>
+     * 设置任务的前一个兄弟任务和父任务列表
+     * </p>
+     * @param task 要添加的子任务对象
+     * @return true if the task was added successfully, false otherwise
+     */
+    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);
+            }
+        }
+        return ret;
+    }
+
+    /**
+     * 在指定索引位置添加子任务
+     * <p>
+     * 更新相关任务的前一个兄弟任务引用
+     * </p>
+     * @param task 要添加的子任务对象
+     * @param index 要添加的位置索引
+     * @return true if the task was added successfully, false otherwise
+     */
+    public boolean addChildTask(Task task, int index) {
+        if (index < 0 || index > mChildren.size()) {
+            Log.e(TAG, "add child task: invalid index");
+            return false;
+        }
+
+        int pos = mChildren.indexOf(task);
+        if (task != null && pos == -1) {
+            mChildren.add(index, task);
+
+            // update the task list
+            Task preTask = null;
+            Task afterTask = null;
+            if (index != 0)
+                preTask = mChildren.get(index - 1);
+            if (index != mChildren.size() - 1)
+                afterTask = mChildren.get(index + 1);
+
+            task.setPriorSibling(preTask);
+            if (afterTask != null)
+                afterTask.setPriorSibling(task);
+        }
+
+        return true;
+    }
+
+    /**
+     * 从任务列表中移除指定的子任务
+     * <p>
+     * 重置被移除任务的前一个兄弟任务和父任务列表引用
+     * </p>
+     * @param task 要移除的子任务对象
+     * @return true if the task was removed successfully, false otherwise
+     */
+    public boolean removeChildTask(Task task) {
+        boolean ret = false;
+        int index = mChildren.indexOf(task);
+        if (index != -1) {
+            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));
+                }
+            }
+        }
+        return ret;
+    }
+
+    /**
+     * 移动子任务到新的索引位置
+     * <p>
+     * 通过先移除后添加的方式实现移动操作
+     * </p>
+     * @param task 要移动的子任务对象
+     * @param index 新的位置索引
+     * @return true if the task was moved successfully, false otherwise
+     */
+    public boolean moveChildTask(Task task, int index) {
+
+        if (index < 0 || index >= mChildren.size()) {
+            Log.e(TAG, "move child task: invalid index");
+            return false;
+        }
+
+        int pos = mChildren.indexOf(task);
+        if (pos == -1) {
+            Log.e(TAG, "move child task: the task should in the list");
+            return false;
+        }
+
+        if (pos == index)
+            return true;
+        return (removeChildTask(task) && addChildTask(task, index));
+    }
+
+    /**
+     * 根据Google任务ID查找子任务
+     * @param gid Google任务ID
+     * @return 找到的任务对象，未找到时返回null
+     */
+    public Task findChildTaskByGid(String gid) {
+        for (int i = 0; i < mChildren.size(); i++) {
+            Task t = mChildren.get(i);
+            if (t.getGid().equals(gid)) {
+                return t;
+            }
+        }
+        return null;
+    }
+
+    /**
+     * 获取子任务在列表中的索引位置
+     * @param task 子任务对象
+     * @return 子任务的索引位置，未找到时返回-1
+     */
+    public int getChildTaskIndex(Task task) {
+        return mChildren.indexOf(task);
+    }
+
+    /**
+     * 根据索引位置获取子任务
+     * @param index 子任务的索引位置
+     * @return 对应的任务对象，索引无效时返回null
+     */
+    public Task getChildTaskByIndex(int index) {
+        if (index < 0 || index >= mChildren.size()) {
+            Log.e(TAG, "getTaskByIndex: invalid index");
+            return null;
+        }
+        return mChildren.get(index);
+    }
+
+    /**
+     * 根据Google任务ID查找子任务
+     * <p>
+     * 与{@link #findChildTaskByGid(String)}功能相同，是该方法的别名
+     * </p>
+     * @param gid Google任务ID
+     * @return 找到的任务对象，未找到时返回null
+     */
+    public Task getChilTaskByGid(String gid) {
+        for (Task task : mChildren) {
+            if (task.getGid().equals(gid))
+                return task;
+        }
+        return null;
+    }
+
+    /**
+     * 获取所有子任务的集合
+     * @return 子任务集合的引用
+     */
+    public ArrayList<Task> getChildTaskList() {
+        return this.mChildren;
+    }
+
+    /**
+     * 设置任务列表的索引位置
+     * @param index 新的索引位置
+     */
+    public void setIndex(int index) {
+        this.mIndex = index;
+    }
+
+    /**
+     * 获取任务列表的索引位置
+     * @return 当前索引位置
+     */
+    public int getIndex() {
+        return this.mIndex;
+    }
+}

src/gtask/exception/ActionFailureException.java

@@ -0,0 +1,53 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.gtask.exception;
+
+/**
+ * <p>Google任务操作失败异常类。</p>
+ * <p>设计意图：用于表示Google任务相关操作（如创建、更新、删除等）执行失败的情况。</p>
+ * <p>核心职责：封装Google任务操作失败的异常信息，提供多种构造方式以适应不同的错误场景。</p>
+ * <p>关键关联：继承自{@link RuntimeException}，属于非检查型异常，用于表示可恢复的操作失败。</p>
+ */
+public class ActionFailureException extends RuntimeException {
+    private static final long serialVersionUID = 4425249765923293627L;
+
+    /**
+     * 默认构造方法，创建一个空的操作失败异常。
+     */
+    public ActionFailureException() {
+        super();
+    }
+
+    /**
+     * 使用指定的错误信息创建操作失败异常。
+     * 
+     * @param paramString 错误信息字符串，描述操作失败的原因
+     */
+    public ActionFailureException(String paramString) {
+        super(paramString);
+    }
+
+    /**
+     * 使用指定的错误信息和根原因创建操作失败异常。
+     * 
+     * @param paramString 错误信息字符串，描述操作失败的原因
+     * @param paramThrowable 根原因异常，包含导致操作失败的详细错误信息
+     */
+    public ActionFailureException(String paramString, Throwable paramThrowable) {
+        super(paramString, paramThrowable);
+    }
+}

src/gtask/exception/NetworkFailureException.java

@@ -0,0 +1,53 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.gtask.exception;
+
+/**
+ * <p>网络连接失败异常类。</p>
+ * <p>设计意图：用于表示与Google任务服务通信时网络连接失败的情况。</p>
+ * <p>核心职责：封装网络连接失败的异常信息，提供多种构造方式以适应不同的错误场景。</p>
+ * <p>关键关联：继承自{@link Exception}，属于检查型异常，用于表示需要显式处理的网络问题。</p>
+ */
+public class NetworkFailureException extends Exception {
+    private static final long serialVersionUID = 2107610287180234136L;
+
+    /**
+     * 默认构造方法，创建一个空的网络失败异常。
+     */
+    public NetworkFailureException() {
+        super();
+    }
+
+    /**
+     * 使用指定的错误信息创建网络失败异常。
+     * 
+     * @param paramString 错误信息字符串，描述网络失败的原因
+     */
+    public NetworkFailureException(String paramString) {
+        super(paramString);
+    }
+
+    /**
+     * 使用指定的错误信息和根原因创建网络失败异常。
+     * 
+     * @param paramString 错误信息字符串，描述网络失败的原因
+     * @param paramThrowable 根原因异常，包含导致网络失败的详细错误信息
+     */
+    public NetworkFailureException(String paramString, Throwable paramThrowable) {
+        super(paramString, paramThrowable);
+    }
+}

src/gtask/remote/GTaskASyncTask.java

@@ -0,0 +1,234 @@
+
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.gtask.remote;
+
+import android.app.Notification;
+import android.app.NotificationManager;
+import android.app.PendingIntent;
+import android.content.Context;
+import android.content.Intent;
+import android.os.AsyncTask;
+
+import net.micode.notes.R;
+import net.micode.notes.ui.NotesListActivity;
+import net.micode.notes.ui.NotesPreferenceActivity;
+
+/**
+ * <p>Google任务异步同步任务类。</p>
+ * <p>设计意图：使用AsyncTask实现Google任务的异步同步操作，避免阻塞主线程，并提供用户友好的通知反馈。</p>
+ * <p>核心职责：</p>
+ * <ul>
+ * <li>在后台线程执行Google任务的同步操作</li>
+ * <li>显示同步进度和结果的通知</li>
+ * <li>处理同步完成后的回调</li>
+ * <li>支持取消同步操作</li>
+ * </ul>
+ * <p>关键关联：</p>
+ * <ul>
+ * <li>继承自{@link AsyncTask}，实现异步任务框架</li>
+ * <li>使用{@link GTaskManager}执行实际的同步逻辑</li>
+ * <li>与{@link GTaskSyncService}配合，支持服务环境下的广播通知</li>
+ * <li>通过{@link OnCompleteListener}提供同步完成回调</li>
+ * </ul>
+ */
+public class GTaskASyncTask extends AsyncTask<Void, String, Integer> {
+
+    /**
+     * Google任务同步通知的唯一ID
+     */
+    private static int GTASK_SYNC_NOTIFICATION_ID = 5234235;
+
+    /**
+     * <p>同步完成监听器接口。</p>
+     * <p>设计意图：提供Google任务同步完成后的回调机制。</p>
+     */
+    public interface OnCompleteListener {
+        /**
+         * 同步完成时调用的方法
+         */
+        void onComplete();
+    }
+
+    /**
+     * 上下文对象，用于访问系统服务和资源
+     */
+    private Context mContext;
+
+    /**
+     * 通知管理器，用于显示同步进度和结果通知
+     */
+    private NotificationManager mNotifiManager;
+
+    /**
+     * Google任务管理器，用于执行实际的同步逻辑
+     */
+    private GTaskManager mTaskManager;
+
+    /**
+     * 同步完成监听器，用于处理同步完成后的回调
+     */
+    private OnCompleteListener mOnCompleteListener;
+
+    /**
+     * 构造方法，初始化Google任务异步同步任务。
+     * 
+     * @param context 上下文对象，用于访问系统服务和资源
+     * @param listener 同步完成监听器，用于处理同步完成后的回调
+     */
+    public GTaskASyncTask(Context context, OnCompleteListener listener) {
+        mContext = context;
+        mOnCompleteListener = listener;
+        mNotifiManager = (NotificationManager) mContext
+                .getSystemService(Context.NOTIFICATION_SERVICE);
+        mTaskManager = GTaskManager.getInstance();
+    }
+
+    /**
+     * 取消正在进行的同步操作。
+     */
+    public void cancelSync() {
+        mTaskManager.cancelSync();
+    }
+
+    /**
+     * 发布同步进度信息。
+     * 
+     * @param message 进度信息消息
+     */
+    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);
+//    }
+    /**
+     * <p>显示同步通知。</p>
+     * <p>业务逻辑：根据同步状态创建并显示相应的通知，支持成功、失败、取消等不同状态。</p>
+     * <p>通知点击行为：
+     * <ul>
+     * <li>成功状态：点击打开笔记列表页面</li>
+     * <li>其他状态：点击打开笔记设置页面</li>
+     * </ul>
+     * </p>
+     * 
+     * @param tickerId 通知标题资源ID
+     * @param content 通知内容字符串
+     */
+private void showNotification(int tickerId, String content) {
+    PendingIntent pendingIntent;
+    if (tickerId != R.string.ticker_success) {
+        pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext,
+                NotesPreferenceActivity.class), PendingIntent.FLAG_IMMUTABLE);
+    } else {
+        pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext,
+                NotesListActivity.class), PendingIntent.FLAG_IMMUTABLE);
+    }
+    Notification.Builder builder = new Notification.Builder(mContext)
+            .setAutoCancel(true)
+            .setContentTitle(mContext.getString(R.string.app_name))
+            .setContentText(content)
+            .setContentIntent(pendingIntent)
+            .setWhen(System.currentTimeMillis())
+            .setOngoing(true);
+    Notification notification=builder.getNotification();
+    mNotifiManager.notify(GTASK_SYNC_NOTIFICATION_ID, notification);
+}
+    /**
+     * <p>在后台线程执行同步操作。</p>
+     * <p>业务逻辑：初始化同步进度通知，调用GTaskManager执行实际的同步逻辑。</p>
+     * 
+     * @param unused 未使用的参数
+     * @return 同步结果状态码，对应GTaskManager中的STATE_*常量
+     */
+    @Override
+    protected Integer doInBackground(Void... unused) {
+        publishProgess(mContext.getString(R.string.sync_progress_login, NotesPreferenceActivity
+                .getSyncAccountName(mContext)));
+        return mTaskManager.sync(mContext, this);
+    }
+
+    /**
+     * <p>更新同步进度。</p>
+     * <p>业务逻辑：显示当前同步进度通知，如果在服务环境下，还会发送广播通知。</p>
+     * 
+     * @param progress 进度信息数组，其中第一个元素为进度消息
+     */
+    @Override
+    protected void onProgressUpdate(String... progress) {
+        showNotification(R.string.ticker_syncing, progress[0]);
+        if (mContext instanceof GTaskSyncService) {
+            ((GTaskSyncService) mContext).sendBroadcast(progress[0]);
+        }
+    }
+
+    /**
+     * <p>处理同步结果。</p>
+     * <p>业务逻辑：根据同步结果显示相应的通知，更新最后同步时间，并调用完成监听器。</p>
+     * <p>同步结果处理：
+     * <ul>
+     * <li>STATE_SUCCESS：显示成功通知，更新最后同步时间</li>
+     * <li>STATE_NETWORK_ERROR：显示网络错误通知</li>
+     * <li>STATE_INTERNAL_ERROR：显示内部错误通知</li>
+     * <li>STATE_SYNC_CANCELLED：显示同步取消通知</li>
+     * </ul>
+     * </p>
+     * 
+     * @param result 同步结果状态码，对应GTaskManager中的STATE_*常量
+     */
+    @Override
+    protected void onPostExecute(Integer result) {
+        if (result == GTaskManager.STATE_SUCCESS) {
+            showNotification(R.string.ticker_success, mContext.getString(
+                    R.string.success_sync_account, mTaskManager.getSyncAccount()));
+            NotesPreferenceActivity.setLastSyncTime(mContext, System.currentTimeMillis());
+        } else if (result == GTaskManager.STATE_NETWORK_ERROR) {
+            showNotification(R.string.ticker_fail, mContext.getString(R.string.error_sync_network));
+        } else if (result == GTaskManager.STATE_INTERNAL_ERROR) {
+            showNotification(R.string.ticker_fail, mContext.getString(R.string.error_sync_internal));
+        } else if (result == GTaskManager.STATE_SYNC_CANCELLED) {
+            showNotification(R.string.ticker_cancel, mContext
+                    .getString(R.string.error_sync_cancelled));
+        }
+        if (mOnCompleteListener != null) {
+            new Thread(new Runnable() {
+
+                public void run() {
+                    mOnCompleteListener.onComplete();
+                }
+            }).start();
+        }
+    }
+}

src/gtask/remote/GTaskClient.java

@@ -0,0 +1,842 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.gtask.remote;
+
+import android.accounts.Account;
+import android.accounts.AccountManager;
+import android.accounts.AccountManagerFuture;
+import android.app.Activity;
+import android.os.Bundle;
+import android.text.TextUtils;
+import android.util.Log;
+
+import net.micode.notes.gtask.data.Node;
+import net.micode.notes.gtask.data.Task;
+import net.micode.notes.gtask.data.TaskList;
+import net.micode.notes.gtask.exception.ActionFailureException;
+import net.micode.notes.gtask.exception.NetworkFailureException;
+import net.micode.notes.tool.GTaskStringUtils;
+import net.micode.notes.ui.NotesPreferenceActivity;
+
+import org.apache.http.HttpEntity;
+import org.apache.http.HttpResponse;
+import org.apache.http.client.ClientProtocolException;
+import org.apache.http.client.entity.UrlEncodedFormEntity;
+import org.apache.http.client.methods.HttpGet;
+import org.apache.http.client.methods.HttpPost;
+import org.apache.http.cookie.Cookie;
+import org.apache.http.impl.client.BasicCookieStore;
+import org.apache.http.impl.client.DefaultHttpClient;
+import org.apache.http.message.BasicNameValuePair;
+import org.apache.http.params.BasicHttpParams;
+import org.apache.http.params.HttpConnectionParams;
+import org.apache.http.params.HttpParams;
+import org.apache.http.params.HttpProtocolParams;
+import org.json.JSONArray;
+import org.json.JSONException;
+import org.json.JSONObject;
+
+import java.io.BufferedReader;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.InputStreamReader;
+import java.util.LinkedList;
+import java.util.List;
+import java.util.zip.GZIPInputStream;
+import java.util.zip.Inflater;
+import java.util.zip.InflaterInputStream;
+
+
+/**
+ * <p>Google任务API客户端类。</p>
+ * <p>设计意图：提供与Google任务API交互的核心功能，实现任务的创建、更新、删除等操作。</p>
+ * <p>核心职责：</p>
+ * <ul>
+ * <li>处理Google账号的登录认证</li>
+ * <li>执行Google任务的CRUD操作</li>
+ * <li>管理API请求的Cookie和会话状态</li>
+ * <li>处理网络请求和响应，包括压缩数据的解压</li>
+ * <li>将本地任务模型转换为Google任务API的JSON格式</li>
+ * </ul>
+ * <p>关键关联：</p>
+ * <ul>
+ * <li>与{@link GTaskManager}配合，提供任务同步的底层支持</li>
+ * <li>使用{@link Task}和{@link TaskList}类封装Google任务数据</li>
+ * <li>通过{@link NetworkFailureException}和{@link ActionFailureException}处理异常</li>
+ * <li>依赖{@link GTaskStringUtils}提供API交互所需的常量</li>
+ * </ul>
+ * <p>设计特点：</p>
+ * <ul>
+ * <li>采用单例模式，确保全局只有一个Google任务API客户端实例</li>
+ * <li>实现会话管理，避免频繁登录认证</li>
+ * <li>支持批量更新操作，提高API调用效率</li>
+ * <li>处理不同类型的网络压缩格式（gzip、deflate）</li>
+ * </ul>
+ */
+public class GTaskClient {
+    /**
+     * 日志标签，用于调试和错误跟踪
+     */
+    private static final String TAG = GTaskClient.class.getSimpleName();
+
+    /**
+     * Google任务的基本URL
+     */
+    private static final String GTASK_URL = "https://mail.google.com/tasks/";
+
+    /**
+     * Google任务的GET请求URL
+     */
+    private static final String GTASK_GET_URL = "https://mail.google.com/tasks/ig";
+
+    /**
+     * Google任务的POST请求URL
+     */
+    private static final String GTASK_POST_URL = "https://mail.google.com/tasks/r/ig";
+
+    /**
+     * GTaskClient的单例实例
+     */
+    private static GTaskClient mInstance = null;
+
+    /**
+     * HTTP客户端，用于执行与Google任务API的网络请求
+     */
+    private DefaultHttpClient mHttpClient;
+
+    /**
+     * 当前使用的GET请求URL
+     */
+    private String mGetUrl;
+
+    /**
+     * 当前使用的POST请求URL
+     */
+    private String mPostUrl;
+
+    /**
+     * Google任务客户端版本号
+     */
+    private long mClientVersion;
+
+    /**
+     * 登录状态标志
+     */
+    private boolean mLoggedin;
+
+    /**
+     * 最后一次登录时间
+     */
+    private long mLastLoginTime;
+
+    /**
+     * 请求操作ID，用于跟踪API请求
+     */
+    private int mActionId;
+
+    /**
+     * 当前登录的Google账号
+     */
+    private Account mAccount;
+
+    /**
+     * 批量更新的JSON数组，用于累积多次更新操作
+     */
+    private JSONArray mUpdateArray;
+
+    /**
+     * <p>私有构造方法。</p>
+     * <p>设计意图：实现单例模式，防止外部直接实例化。</p>
+     * <p>初始化所有成员变量，设置默认值。</p>
+     */
+    private GTaskClient() {
+        mHttpClient = null;
+        mGetUrl = GTASK_GET_URL;
+        mPostUrl = GTASK_POST_URL;
+        mClientVersion = -1;
+        mLoggedin = false;
+        mLastLoginTime = 0;
+        mActionId = 1;
+        mAccount = null;
+        mUpdateArray = null;
+    }
+
+    /**
+     * <p>获取GTaskClient的单例实例。</p>
+     * <p>业务逻辑：使用双重检查锁定实现线程安全的单例模式。</p>
+     * 
+     * @return GTaskClient的单例实例
+     */
+    public static synchronized GTaskClient getInstance() {
+        if (mInstance == null) {
+            mInstance = new GTaskClient();
+        }
+        return mInstance;
+    }
+
+    /**
+     * <p>登录Google账号并验证Google任务API。</p>
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>检查登录状态，如果Cookie过期或账号切换则重新登录</li>
+     * <li>获取Google账号的认证令牌</li>
+     * <li>如果是自定义域名邮箱，使用自定义URL尝试登录</li>
+     * <li>如果自定义域名登录失败，使用官方URL尝试登录</li>
+     * </ul>
+     * 
+     * @param activity 当前活动的Activity，用于获取账号信息和显示认证界面
+     * @return true表示登录成功，false表示登录失败
+     */
+    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))) {
+            mLoggedin = false;
+        }
+
+        if (mLoggedin) {
+            Log.d(TAG, "already logged in");
+            return true;
+        }
+
+        mLastLoginTime = System.currentTimeMillis();
+        String authToken = loginGoogleAccount(activity, false);
+        if (authToken == null) {
+            Log.e(TAG, "login google account failed");
+            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/");
+            int index = mAccount.name.indexOf('@') + 1;
+            String suffix = mAccount.name.substring(index);
+            url.append(suffix + "/");
+            mGetUrl = url.toString() + "ig";
+            mPostUrl = url.toString() + "r/ig";
+
+            if (tryToLoginGtask(activity, authToken)) {
+                mLoggedin = true;
+            }
+        }
+
+        // try to login with google official url
+        if (!mLoggedin) {
+            mGetUrl = GTASK_GET_URL;
+            mPostUrl = GTASK_POST_URL;
+            if (!tryToLoginGtask(activity, authToken)) {
+                return false;
+            }
+        }
+
+        mLoggedin = true;
+        return true;
+    }
+
+    /**
+     * <p>登录Google账号并获取认证令牌。</p>
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>获取设备上所有的Google账号</li>
+     * <li>根据设置中选择的账号名查找对应的Account对象</li>
+     * <li>使用AccountManager获取该账号的认证令牌</li>
+     * <li>如果需要，可以使现有令牌失效并重新获取</li>
+     * </ul>
+     * 
+     * @param activity 当前活动的Activity，用于获取AccountManager
+     * @param invalidateToken 是否使现有令牌失效
+     * @return 认证令牌字符串，如果获取失败则返回null
+     */
+    private String loginGoogleAccount(Activity activity, boolean invalidateToken) {
+        String authToken;
+        AccountManager accountManager = AccountManager.get(activity);
+        Account[] accounts = accountManager.getAccountsByType("com.google");
+
+        if (accounts.length == 0) {
+            Log.e(TAG, "there is no available google account");
+            return null;
+        }
+
+        String accountName = NotesPreferenceActivity.getSyncAccountName(activity);
+        Account account = null;
+        for (Account a : accounts) {
+            if (a.name.equals(accountName)) {
+                account = a;
+                break;
+            }
+        }
+        if (account != null) {
+            mAccount = account;
+        } else {
+            Log.e(TAG, "unable to get an account with the same name in the settings");
+            return null;
+        }
+
+        // get the token now
+        AccountManagerFuture<Bundle> accountManagerFuture = accountManager.getAuthToken(account,
+                "goanna_mobile", null, activity, null, null);
+        try {
+            Bundle authTokenBundle = accountManagerFuture.getResult();
+            authToken = authTokenBundle.getString(AccountManager.KEY_AUTHTOKEN);
+            if (invalidateToken) {
+                accountManager.invalidateAuthToken("com.google", authToken);
+                loginGoogleAccount(activity, false);
+            }
+        } catch (Exception e) {
+            Log.e(TAG, "get auth token failed");
+            authToken = null;
+        }
+
+        return authToken;
+    }
+
+    /**
+     * <p>尝试登录Google任务API。</p>
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>首先使用提供的认证令牌尝试登录</li>
+     * <li>如果登录失败，可能是令牌过期，此时使令牌失效并重新获取</li>
+     * <li>使用新的认证令牌再次尝试登录</li>
+     * </ul>
+     * 
+     * @param activity 当前活动的Activity，用于重新获取认证令牌
+     * @param authToken Google账号的认证令牌
+     * @return true表示登录成功，false表示登录失败
+     */
+    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");
+                return false;
+            }
+
+            if (!loginGtask(authToken)) {
+                Log.e(TAG, "login gtask failed");
+                return false;
+            }
+        }
+        return true;
+    }
+
+    /**
+     * <p>登录Google任务API的核心方法。</p>
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>配置HTTP客户端的连接和套接字超时时间</li>
+     * <li>创建Cookie存储以保存认证信息</li>
+     * <li>发送HTTP GET请求进行登录认证</li>
+     * <li>检查响应中是否包含认证Cookie</li>
+     * <li>从响应中解析出客户端版本号</li>
+     * </ul>
+     * 
+     * @param authToken Google账号的认证令牌
+     * @return true表示登录成功，false表示登录失败
+     */
+    private boolean loginGtask(String authToken) {
+        int timeoutConnection = 10000;
+        int timeoutSocket = 15000;
+        HttpParams httpParameters = new BasicHttpParams();
+        HttpConnectionParams.setConnectionTimeout(httpParameters, timeoutConnection);
+        HttpConnectionParams.setSoTimeout(httpParameters, timeoutSocket);
+        mHttpClient = new DefaultHttpClient(httpParameters);
+        BasicCookieStore localBasicCookieStore = new BasicCookieStore();
+        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
+            List<Cookie> cookies = mHttpClient.getCookieStore().getCookies();
+            boolean hasAuthCookie = false;
+            for (Cookie cookie : cookies) {
+                if (cookie.getName().contains("GTL")) {
+                    hasAuthCookie = true;
+                }
+            }
+            if (!hasAuthCookie) {
+                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>";
+            int begin = resString.indexOf(jsBegin);
+            int end = resString.lastIndexOf(jsEnd);
+            String jsString = null;
+            if (begin != -1 && end != -1 && begin < end) {
+                jsString = resString.substring(begin + jsBegin.length(), end);
+            }
+            JSONObject js = new JSONObject(jsString);
+            mClientVersion = js.getLong("v");
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            return false;
+        } catch (Exception e) {
+            // simply catch all exceptions
+            Log.e(TAG, "httpget gtask_url failed");
+            return false;
+        }
+
+        return true;
+    }
+
+    /**
+     * <p>获取操作ID。</p>
+     * <p>业务逻辑：返回当前操作ID并自增，用于跟踪API请求。</p>
+     * 
+     * @return 当前操作ID
+     */
+    private int getActionId() {
+        return mActionId++;
+    }
+
+    /**
+     * <p>创建HTTP POST请求。</p>
+     * <p>业务逻辑：配置POST请求的URL和请求头。</p>
+     * 
+     * @return 配置好的HttpPost对象
+     */
+    private HttpPost createHttpPost() {
+        HttpPost httpPost = new HttpPost(mPostUrl);
+        httpPost.setHeader("Content-Type", "application/x-www-form-urlencoded;charset=utf-8");
+        httpPost.setHeader("AT", "1");
+        return httpPost;
+    }
+
+    /**
+     * <p>获取HTTP响应内容。</p>
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>检查响应内容的编码方式</li>
+     * <li>如果是gzip或deflate压缩格式，进行解压处理</li>
+     * <li>将响应内容转换为字符串</li>
+     * </ul>
+     * 
+     * @param entity HTTP响应实体
+     * @return 响应内容字符串
+     * @throws IOException 如果读取或解压响应内容时发生错误
+     */
+    private String getResponseContent(HttpEntity entity) throws IOException {
+        String contentEncoding = null;
+        if (entity.getContentEncoding() != null) {
+            contentEncoding = entity.getContentEncoding().getValue();
+            Log.d(TAG, "encoding: " + contentEncoding);
+        }
+
+        InputStream input = entity.getContent();
+        if (contentEncoding != null && contentEncoding.equalsIgnoreCase("gzip")) {
+            input = new GZIPInputStream(entity.getContent());
+        } else if (contentEncoding != null && contentEncoding.equalsIgnoreCase("deflate")) {
+            Inflater inflater = new Inflater(true);
+            input = new InflaterInputStream(entity.getContent(), inflater);
+        }
+
+        try {
+            InputStreamReader isr = new InputStreamReader(input);
+            BufferedReader br = new BufferedReader(isr);
+            StringBuilder sb = new StringBuilder();
+
+            while (true) {
+                String buff = br.readLine();
+                if (buff == null) {
+                    return sb.toString();
+                }
+                sb = sb.append(buff);
+            }
+        } finally {
+            input.close();
+        }
+    }
+
+    /**
+     * <p>发送POST请求到Google任务API。</p>
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>检查登录状态，未登录则抛出异常</li>
+     * <li>创建并配置HTTP POST请求</li>
+     * <li>将JSON数据转换为请求实体</li>
+     * <li>发送请求并获取响应</li>
+     * <li>将响应内容转换为JSON对象</li>
+     * </ul>
+     * 
+     * @param js 要发送的JSON对象
+     * @return 响应的JSON对象
+     * @throws NetworkFailureException 如果网络请求失败
+     */
+    private JSONObject postRequest(JSONObject js) throws NetworkFailureException {
+        if (!mLoggedin) {
+            Log.e(TAG, "please login first");
+            throw new ActionFailureException("not logged in");
+        }
+
+        HttpPost httpPost = createHttpPost();
+        try {
+            LinkedList<BasicNameValuePair> list = new LinkedList<BasicNameValuePair>();
+            list.add(new BasicNameValuePair("r", js.toString()));
+            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);
+
+        } catch (ClientProtocolException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            throw new NetworkFailureException("postRequest failed");
+        } catch (IOException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            throw new NetworkFailureException("postRequest failed");
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            throw new ActionFailureException("unable to convert response content to jsonobject");
+        } catch (Exception e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            throw new ActionFailureException("error occurs when posting request");
+        }
+    }
+
+    /**
+     * <p>创建新的Google任务。</p>
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>提交当前累积的更新操作</li>
+     * <li>创建任务的JSON表示</li>
+     * <li>发送创建任务的POST请求</li>
+     * <li>从响应中获取新创建任务的GID并设置到任务对象中</li>
+     * </ul>
+     * 
+     * @param task 要创建的任务对象
+     * @throws NetworkFailureException 如果网络请求失败
+     */
+    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);
+            task.setGid(jsResult.getString(GTaskStringUtils.GTASK_JSON_NEW_ID));
+
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            throw new ActionFailureException("create task: handing jsonobject failed");
+        }
+    }
+
+    /**
+     * <p>创建新的Google任务列表。</p>
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>提交当前累积的更新操作</li>
+     * <li>创建任务列表的JSON表示</li>
+     * <li>发送创建任务列表的POST请求</li>
+     * <li>从响应中获取新创建任务列表的GID并设置到任务列表对象中</li>
+     * </ul>
+     * 
+     * @param tasklist 要创建的任务列表对象
+     * @throws NetworkFailureException 如果网络请求失败
+     */
+    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);
+            tasklist.setGid(jsResult.getString(GTaskStringUtils.GTASK_JSON_NEW_ID));
+
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            throw new ActionFailureException("create tasklist: handing jsonobject failed");
+        }
+    }
+
+    /**
+     * <p>提交累积的更新操作。</p>
+     * <p>业务逻辑：将累积在mUpdateArray中的所有更新操作发送到Google任务API。</p>
+     * 
+     * @throws NetworkFailureException 如果网络请求失败
+     */
+    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);
+                mUpdateArray = null;
+            } catch (JSONException e) {
+                Log.e(TAG, e.toString());
+                e.printStackTrace();
+                throw new ActionFailureException("commit update: handing jsonobject failed");
+            }
+        }
+    }
+
+    /**
+     * <p>添加节点更新操作到累积列表。</p>
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>如果累积的更新操作超过10个，先提交这些更新</li>
+     * <li>将节点的更新操作添加到累积列表中</li>
+     * </ul>
+     * 
+     * @param node 要更新的节点对象
+     * @throws NetworkFailureException 如果网络请求失败（当提交累积更新时）
+     */
+    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();
+            }
+
+            if (mUpdateArray == null)
+                mUpdateArray = new JSONArray();
+            mUpdateArray.put(node.getUpdateAction(getActionId()));
+        }
+    }
+
+    /**
+     * <p>移动任务到新的父任务列表或在同一列表中重新排序。</p>
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>提交当前累积的更新操作</li>
+     * <li>创建移动任务的JSON表示</li>
+     * <li>如果在同一列表内移动且不是第一个任务，设置前一个兄弟任务的ID</li>
+     * <li>发送移动任务的POST请求</li>
+     * </ul>
+     * 
+     * @param task 要移动的任务
+     * @param preParent 任务的当前父任务列表
+     * @param curParent 任务的新父任务列表
+     * @throws NetworkFailureException 如果网络请求失败
+     */
+    public void moveTask(Task task, TaskList preParent, TaskList curParent)
+            throws NetworkFailureException {
+        commitUpdate();
+        try {
+            JSONObject jsPost = new JSONObject();
+            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);
+
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            throw new ActionFailureException("move task: handing jsonobject failed");
+        }
+    }
+
+    /**
+     * <p>删除节点。</p>
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>提交当前累积的更新操作</li>
+     * <li>将节点标记为已删除</li>
+     * <li>创建删除节点的JSON表示</li>
+     * <li>发送删除节点的POST请求</li>
+     * <li>清空累积的更新列表</li>
+     * </ul>
+     * 
+     * @param node 要删除的节点
+     * @throws NetworkFailureException 如果网络请求失败
+     */
+    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);
+            mUpdateArray = null;
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            throw new ActionFailureException("delete node: handing jsonobject failed");
+        }
+    }
+
+    /**
+     * <p>获取所有的Google任务列表。</p>
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>检查登录状态</li>
+     * <li>发送获取任务列表的GET请求</li>
+     * <li>解析响应内容，提取任务列表数据</li>
+     * </ul>
+     * 
+     * @return 任务列表的JSON数组
+     * @throws NetworkFailureException 如果网络请求失败
+     */
+    public JSONArray getTaskLists() throws NetworkFailureException {
+        if (!mLoggedin) {
+            Log.e(TAG, "please login first");
+            throw new ActionFailureException("not logged in");
+        }
+
+        try {
+            HttpGet httpGet = new HttpGet(mGetUrl);
+            HttpResponse response = null;
+            response = mHttpClient.execute(httpGet);
+
+            // get the task list
+            String resString = getResponseContent(response.getEntity());
+            String jsBegin = "_setup(";
+            String jsEnd = ")}</script>";
+            int begin = resString.indexOf(jsBegin);
+            int end = resString.lastIndexOf(jsEnd);
+            String jsString = null;
+            if (begin != -1 && end != -1 && begin < end) {
+                jsString = resString.substring(begin + jsBegin.length(), end);
+            }
+            JSONObject js = new JSONObject(jsString);
+            return js.getJSONObject("t").getJSONArray(GTaskStringUtils.GTASK_JSON_LISTS);
+        } catch (ClientProtocolException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            throw new NetworkFailureException("gettasklists: httpget failed");
+        } catch (IOException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            throw new NetworkFailureException("gettasklists: httpget failed");
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            throw new ActionFailureException("get task lists: handing jasonobject failed");
+        }
+    }
+
+    public JSONArray getTaskList(String listGid) throws NetworkFailureException {
+        commitUpdate();
+        try {
+            JSONObject jsPost = new JSONObject();
+            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());
+            action.put(GTaskStringUtils.GTASK_JSON_LIST_ID, listGid);
+            action.put(GTaskStringUtils.GTASK_JSON_GET_DELETED, false);
+            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);
+            return jsResponse.getJSONArray(GTaskStringUtils.GTASK_JSON_TASKS);
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            throw new ActionFailureException("get task list: handing jsonobject failed");
+        }
+    }
+
+    public Account getSyncAccount() {
+        return mAccount;
+    }
+
+    public void resetUpdateArray() {
+        mUpdateArray = null;
+    }
+}

src/gtask/remote/GTaskSyncService.java

@@ -0,0 +1,290 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.gtask.remote;
+
+import android.app.Activity;
+import android.app.Service;
+import android.content.Context;
+import android.content.Intent;
+import android.os.Bundle;
+import android.os.IBinder;
+
+/**
+ * <p>Google任务同步服务类。</p>
+ * <p>设计意图：作为Android服务组件，管理Google任务的同步操作，提供同步的启动和取消功能。</p>
+ * <p>核心职责：</p>
+ * <ul>
+ * <li>接收同步操作的启动和取消指令</li>
+ * <li>管理异步同步任务的生命周期</li>
+ * <li>通过广播通知同步状态和进度</li>
+ * <li>处理低内存情况</li>
+ * </ul>
+ * <p>与其他类的关键关联：</p>
+ * <ul>
+ * <li>使用{@link GTaskASyncTask}执行实际的同步操作</li>
+ * <li>依赖{@link GTaskManager}进行同步逻辑处理</li>
+ * <li>通过广播与UI组件通信</li>
+ * </ul>
+ */
+public class GTaskSyncService extends Service {
+    /**
+     * 操作类型的Intent extra键名
+     */
+    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";
+
+    /**
+     * 广播中表示是否正在同步的extra键名
+     */
+    public final static String GTASK_SERVICE_BROADCAST_IS_SYNCING = "isSyncing";
+
+    /**
+     * 广播中表示同步进度消息的extra键名
+     */
+    public final static String GTASK_SERVICE_BROADCAST_PROGRESS_MSG = "progressMsg";
+
+    /**
+     * 当前正在执行的同步任务实例
+     */
+    private static GTaskASyncTask mSyncTask = null;
+
+    /**
+     * 当前同步进度消息
+     */
+    private static String mSyncProgress = "";
+
+    /**
+     * 启动Google任务同步操作。
+     * 
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>检查是否已有同步任务在执行</li>
+     * <li>如果没有，则创建新的异步同步任务</li>
+     * <li>设置任务完成监听器</li>
+     * <li>发送同步开始的广播</li>
+     * <li>执行异步同步任务</li>
+     * </ul>
+     */
+    private void startSync() {
+        if (mSyncTask == null) {
+            mSyncTask = new GTaskASyncTask(this, new GTaskASyncTask.OnCompleteListener() {
+                public void onComplete() {
+                    mSyncTask = null;
+                    sendBroadcast("");
+                    stopSelf();
+                }
+            });
+            sendBroadcast("");
+            mSyncTask.execute();
+        }
+    }
+
+    /**
+     * 取消正在执行的Google任务同步操作。
+     * 
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>检查是否有同步任务在执行</li>
+     * <li>如果有，则调用任务的取消方法</li>
+     * </ul>
+     */
+    private void cancelSync() {
+        if (mSyncTask != null) {
+            mSyncTask.cancelSync();
+        }
+    }
+
+    /**
+     * 创建服务时的回调方法。
+     * 
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>初始化同步任务引用为null</li>
+     * </ul>
+     */
+    @Override
+    public void onCreate() {
+        mSyncTask = null;
+    }
+
+    /**
+     * 服务启动时的回调方法，处理启动服务的Intent。
+     * 
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>解析Intent中的操作类型</li>
+     * <li>根据操作类型执行相应的同步操作（启动或取消）</li>
+     * <li>返回START_STICKY表示服务被系统终止后会尝试重新启动</li>
+     * </ul>
+     * 
+     * @param intent 启动服务的Intent
+     * @param flags 启动标志
+     * @param startId 启动ID
+     * @return 服务的启动模式
+     */
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        Bundle bundle = intent.getExtras();
+        if (bundle != null && bundle.containsKey(ACTION_STRING_NAME)) {
+            switch (bundle.getInt(ACTION_STRING_NAME, ACTION_INVALID)) {
+                case ACTION_START_SYNC:
+                    startSync();
+                    break;
+                case ACTION_CANCEL_SYNC:
+                    cancelSync();
+                    break;
+                default:
+                    break;
+            }
+            return START_STICKY;
+        }
+        return super.onStartCommand(intent, flags, startId);
+    }
+
+    /**
+     * 系统内存不足时的回调方法。
+     * 
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>在内存不足的情况下，取消正在执行的同步任务以释放资源</li>
+     * </ul>
+     */
+    @Override
+    public void onLowMemory() {
+        if (mSyncTask != null) {
+            mSyncTask.cancelSync();
+        }
+    }
+
+    /**
+     * 绑定服务时的回调方法。
+     * 
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>返回null，表示不支持绑定操作</li>
+     * </ul>
+     * 
+     * @param intent 绑定服务的Intent
+     * @return 绑定接口，此处返回null
+     */
+    public IBinder onBind(Intent intent) {
+        return null;
+    }
+
+    /**
+     * 发送同步状态的广播。
+     * 
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>更新同步进度消息</li>
+     * <li>创建广播Intent并设置同步状态和进度信息</li>
+     * <li>发送广播通知UI组件同步状态的变化</li>
+     * </ul>
+     * 
+     * @param msg 同步进度消息
+     */
+    public void sendBroadcast(String msg) {
+        mSyncProgress = msg;
+        Intent intent = new Intent(GTASK_SERVICE_BROADCAST_NAME);
+        intent.putExtra(GTASK_SERVICE_BROADCAST_IS_SYNCING, mSyncTask != null);
+        intent.putExtra(GTASK_SERVICE_BROADCAST_PROGRESS_MSG, msg);
+        sendBroadcast(intent);
+    }
+
+    /**
+     * 静态方法：启动Google任务同步服务。
+     * 
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>设置GTaskManager的Activity上下文</li>
+     * <li>创建启动服务的Intent并设置操作类型</li>
+     * <li>启动同步服务</li>
+     * </ul>
+     * 
+     * @param activity 调用该方法的Activity实例
+     */
+    public static void startSync(Activity activity) {
+        GTaskManager.getInstance().setActivityContext(activity);
+        Intent intent = new Intent(activity, GTaskSyncService.class);
+        intent.putExtra(GTaskSyncService.ACTION_STRING_NAME, GTaskSyncService.ACTION_START_SYNC);
+        activity.startService(intent);
+    }
+
+    /**
+     * 静态方法：取消Google任务同步服务。
+     * 
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>创建启动服务的Intent并设置取消操作类型</li>
+     * <li>启动同步服务以执行取消操作</li>
+     * </ul>
+     * 
+     * @param context 调用该方法的上下文
+     */
+    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);
+    }
+
+    /**
+     * 静态方法：检查是否正在进行同步操作。
+     * 
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>通过检查同步任务引用是否为null来判断同步状态</li>
+     * </ul>
+     * 
+     * @return true表示正在同步，false表示没有同步操作进行
+     */
+    public static boolean isSyncing() {
+        return mSyncTask != null;
+    }
+
+    /**
+     * 静态方法：获取当前同步进度消息。
+     * 
+     * <p>业务逻辑：</p>
+     * <ul>
+     * <li>返回当前的同步进度消息</li>
+     * </ul>
+     * 
+     * @return 当前同步进度消息
+     */
+    public static String getProgressString() {
+        return mSyncProgress;
+    }
+}

src/model/Note.java

@@ -0,0 +1,542 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.model;
+import android.content.ContentProviderOperation;
+import android.content.ContentProviderResult;
+import android.content.ContentUris;
+import android.content.ContentValues;
+import android.content.Context;
+import android.content.OperationApplicationException;
+import android.net.Uri;
+import android.os.RemoteException;
+import android.util.Log;
+
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.CallNote;
+import net.micode.notes.data.Notes.DataColumns;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.data.Notes.TextNote;
+
+import java.util.ArrayList;
+
+
+/**
+ * <p>核心笔记数据模型类，负责管理笔记的基本信息和数据变更。</p>
+ * <p>设计意图：将笔记的元数据变更和具体内容数据分离管理，提高数据操作的灵活性和效率。</p>
+ * <ul>
+ * <li>通过{@link #mNoteDiffValues}跟踪笔记元数据的变更</li>
+ * <li>通过内部类{@link NoteData}管理笔记的具体内容数据（文本、通话记录等）</li>
+ * <li>提供与ContentResolver的交互接口，实现数据持久化和同步</li>
+ * </ul>
+ * <p>关键关联：</p>
+ * <ul>
+ * <li>与{@link net.micode.notes.data.NotesProvider}交互，实现数据的CRUD操作</li>
+ * <li>使用{@link android.content.ContentValues}存储数据变更</li>
+ * <li>通过{@link android.content.ContentProviderOperation}执行批量数据更新</li>
+ * </ul>
+ */
+public class Note {
+    /**
+     * <p>存储笔记元数据的变更记录。</p>
+     * <p>业务含义：记录笔记的基本信息变更，如标题、创建时间、修改时间等。</p>
+     * <p>约束条件：仅包含需要更新到数据库的字段变更，不包含笔记的具体内容数据。</p>
+     */
+    private ContentValues mNoteDiffValues;
+    
+    /**
+     * <p>管理笔记的具体内容数据。</p>
+     * <p>业务含义：处理笔记的文本内容、通话记录等具体数据的存储和变更。</p>
+     */
+    private NoteData mNoteData;
+    
+    /**
+     * <p>日志标签。</p>
+     * <p>业务含义：用于在日志中标识Note类的相关操作。</p>
+     */
+    private static final String TAG = "Note";
+    /**
+     * <p>生成新的笔记ID，用于向数据库添加新笔记。</p>
+     * <p>业务逻辑：在数据库中创建一条新的笔记记录，返回其生成的ID。</p>
+     * <p>线程安全：方法使用synchronized关键字确保在多线程环境下的安全性。</p>
+     * 
+     * @param context 上下文对象，用于获取ContentResolver
+     * @param folderId 文件夹ID，新笔记将被添加到该文件夹下
+     * @return 生成的新笔记ID
+     * @throws IllegalStateException 当生成的笔记ID为-1时抛出
+     * 
+     * <p>跨类调用：</p>
+     * <ul>
+     * <li>通过{@link Context#getContentResolver()}获取ContentResolver</li>
+     * <li>调用{@link android.content.ContentResolver#insert(Uri, ContentValues)}向{@link Notes#CONTENT_NOTE_URI}插入新笔记</li>
+     * </ul>
+     * 
+     * <p>错误处理：</p>
+     * <ul>
+     * <li>捕获NumberFormatException异常，记录日志并返回0</li>
+     * <li>当生成的笔记ID为-1时，抛出IllegalStateException异常</li>
+     * </ul>
+     */
+    public static synchronized long getNewNoteId(Context context, long folderId) {
+        // Create a new note in the database
+        ContentValues values = new ContentValues();
+        long createdTime = System.currentTimeMillis();
+        values.put(NoteColumns.CREATED_DATE, createdTime);
+        values.put(NoteColumns.MODIFIED_DATE, createdTime);
+        values.put(NoteColumns.TYPE, Notes.TYPE_NOTE);
+        values.put(NoteColumns.LOCAL_MODIFIED, 1);
+        values.put(NoteColumns.PARENT_ID, folderId);
+        Uri uri = context.getContentResolver().insert(Notes.CONTENT_NOTE_URI, values);
+
+        long noteId = 0;
+        try {
+            noteId = Long.valueOf(uri.getPathSegments().get(1));
+        } catch (NumberFormatException e) {
+            Log.e(TAG, "Get note id error :" + e.toString());
+            noteId = 0;
+        }
+        if (noteId == -1) {
+            throw new IllegalStateException("Wrong note id:" + noteId);
+        }
+        return noteId;
+    }
+
+    /**
+     * <p>Note类的默认构造函数。</p>
+     * <p>功能：初始化笔记的元数据变更记录和内容数据管理对象。</p>
+     * <ul>
+     * <li>初始化{@link #mNoteDiffValues}为新的ContentValues对象，用于跟踪元数据变更</li>
+     * <li>初始化{@link #mNoteData}为新的NoteData对象，用于管理具体内容数据</li>
+     * </ul>
+     */
+    public Note() {
+        mNoteDiffValues = new ContentValues();
+        mNoteData = new NoteData();
+    }
+
+    /**
+     * <p>设置笔记的元数据字段值。</p>
+     * <p>业务逻辑：更新笔记的元数据变更记录，并标记为本地已修改。</p>
+     * 
+     * @param key 元数据字段名
+     * @param value 元数据字段值
+     * 
+     * <p>自动更新的字段：</p>
+     * <ul>
+     * <li>{@link NoteColumns#LOCAL_MODIFIED}：标记为1（已修改）</li>
+     * <li>{@link NoteColumns#MODIFIED_DATE}：更新为当前时间戳</li>
+     * </ul>
+     */
+    public void setNoteValue(String key, String value) {
+        mNoteDiffValues.put(key, value);
+        mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
+        mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
+    }
+
+    /**
+     * <p>设置笔记的文本数据字段值。</p>
+     * <p>业务逻辑：通过{@link NoteData}对象更新笔记的文本内容数据。</p>
+     * 
+     * @param key 文本数据字段名
+     * @param value 文本数据字段值
+     */
+    public void setTextData(String key, String value) {
+        mNoteData.setTextData(key, value);
+    }
+
+    /**
+     * <p>设置笔记文本数据的ID。</p>
+     * <p>业务逻辑：通过{@link NoteData}对象设置文本数据的ID。</p>
+     * 
+     * @param id 文本数据ID
+     */
+    public void setTextDataId(long id) {
+        mNoteData.setTextDataId(id);
+    }
+
+    /**
+     * <p>获取笔记文本数据的ID。</p>
+     * <p>业务逻辑：通过{@link NoteData}对象获取文本数据的ID。</p>
+     * 
+     * @return 文本数据ID
+     */
+    public long getTextDataId() {
+        return mNoteData.mTextDataId;
+    }
+
+    /**
+     * <p>设置笔记通话数据的ID。</p>
+     * <p>业务逻辑：通过{@link NoteData}对象设置通话数据的ID。</p>
+     * 
+     * @param id 通话数据ID
+     */
+    public void setCallDataId(long id) {
+        mNoteData.setCallDataId(id);
+    }
+
+    /**
+     * <p>设置笔记的通话数据字段值。</p>
+     * <p>业务逻辑：通过{@link NoteData}对象更新笔记的通话记录数据。</p>
+     * 
+     * @param key 通话数据字段名
+     * @param value 通话数据字段值
+     */
+    public void setCallData(String key, String value) {
+        mNoteData.setCallData(key, value);
+    }
+
+    /**
+     * <p>检查笔记是否在本地已修改。</p>
+     * <p>业务逻辑：判断笔记的元数据或内容数据是否发生了变更。</p>
+     * 
+     * @return true表示笔记已修改，false表示未修改
+     * 
+     * <p>判断条件：</p>
+     * <ul>
+     * <li>元数据变更：{@link #mNoteDiffValues}的大小大于0</li>
+     * <li>内容数据变更：通过{@link NoteData#isLocalModified()}判断</li>
+     * </ul>
+     */
+    public boolean isLocalModified() {
+        return mNoteDiffValues.size() > 0 || mNoteData.isLocalModified();
+    }
+
+    /**
+     * <p>将笔记的变更同步到ContentResolver。</p>
+     * <p>业务逻辑：将笔记的元数据变更和内容数据变更持久化到数据库。</p>
+     * 
+     * @param context 上下文对象，用于获取ContentResolver
+     * @param noteId 笔记ID，指定要同步的笔记
+     * @return true表示同步成功，false表示同步失败
+     * @throws IllegalArgumentException 当noteId无效（<=0）时抛出
+     * 
+     * <p>同步流程：</p>
+     * <ol>
+     * <li>检查noteId是否有效</li>
+     * <li>检查笔记是否已修改，未修改则直接返回true</li>
+     * <li>更新笔记的元数据变更到ContentResolver</li>
+     * <li>如果内容数据已修改，将其同步到ContentResolver</li>
+     * <li>返回同步结果</li>
+     * </ol>
+     * 
+     * <p>数据流转换：</p>
+     * <ul>
+     * <li>元数据变更：从{@link #mNoteDiffValues}转换为ContentResolver.update()的参数</li>
+     * <li>内容数据变更：通过{@link NoteData#pushIntoContentResolver(Context, long)}方法处理</li>
+     * </ul>
+     * 
+     * <p>错误处理：</p>
+     * <ul>
+     * <li>元数据更新失败：记录日志，但继续执行内容数据同步（为了数据安全性）</li>
+     * <li>内容数据同步失败：返回false表示同步失败</li>
+     * </ul>
+     * 
+     * <p>跨类调用：</p>
+     * <ul>
+     * <li>通过{@link Context#getContentResolver()}获取ContentResolver</li>
+     * <li>调用{@link android.content.ContentResolver#update(Uri, ContentValues, String, String[])}更新元数据</li>
+     * <li>调用{@link NoteData#pushIntoContentResolver(Context, long)}同步内容数据</li>
+     * </ul>
+     */
+    public boolean syncNote(Context context, long noteId) {
+        if (noteId <= 0) {
+            throw new IllegalArgumentException("Wrong note id:" + noteId);
+        }
+
+        if (!isLocalModified()) {
+            return true;
+        }
+
+        /**
+         * In theory, once data changed, the note should be updated on {@link NoteColumns#LOCAL_MODIFIED} and
+         * {@link NoteColumns#MODIFIED_DATE}. For data safety, though update note fails, we also update the
+         * note data info
+         */
+        if (context.getContentResolver().update(
+                ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), mNoteDiffValues, null,
+                null) == 0) {
+            Log.e(TAG, "Update note error, should not happen");
+            // Do not return, fall through
+        }
+        mNoteDiffValues.clear();
+
+        if (mNoteData.isLocalModified()
+                && (mNoteData.pushIntoContentResolver(context, noteId) == null)) {
+            return false;
+        }
+
+        return true;
+    }
+
+    /**
+     * <p>笔记内容数据管理类，处理笔记的具体内容存储和变更。</p>
+     * <p>设计意图：将笔记的内容数据与元数据分离管理，提高数据操作的灵活性和效率。</p>
+     * <p>作为{@link Note}类的内部类，专门负责处理：</p>
+     * <ul>
+     * <li>笔记的文本内容数据</li>
+     * <li>笔记的通话记录数据</li>
+     * <li>内容数据的变更跟踪</li>
+     * <li>内容数据与ContentResolver的同步</li>
+     * </ul>
+     * <p>关键关联：</p>
+     * <ul>
+     * <li>与{@link Note}类紧密协作，共享笔记元数据变更的跟踪</li>
+     * <li>使用{@link ContentValues}存储内容数据的变更</li>
+     * <li>通过{@link ContentProviderOperation}执行批量数据更新</li>
+     * </ul>
+     */
+    private class NoteData {
+        /**
+         * <p>文本数据的ID。</p>
+         * <p>业务含义：唯一标识笔记的文本内容数据记录。</p>
+         * <p>约束条件：0表示文本数据尚未保存到数据库。</p>
+         */
+        private long mTextDataId;
+
+        /**
+         * <p>存储文本数据的变更记录。</p>
+         * <p>业务含义：记录笔记文本内容的变更，如正文、标题等。</p>
+         */
+        private ContentValues mTextDataValues;
+
+        /**
+         * <p>通话数据的ID。</p>
+         * <p>业务含义：唯一标识笔记的通话记录数据记录。</p>
+         * <p>约束条件：0表示通话数据尚未保存到数据库。</p>
+         */
+        private long mCallDataId;
+
+        /**
+         * <p>存储通话数据的变更记录。</p>
+         * <p>业务含义：记录笔记通话记录的变更，如通话号码、通话时间等。</p>
+         */
+        private ContentValues mCallDataValues;
+
+        /**
+         * <p>日志标签。</p>
+         * <p>业务含义：用于在日志中标识NoteData类的相关操作。</p>
+         */
+        private static final String TAG = "NoteData";
+
+        /**
+         * <p>NoteData类的默认构造函数。</p>
+         * <p>功能：初始化笔记内容数据的变更记录和ID。</p>
+         * <ul>
+         * <li>初始化{@link #mTextDataValues}为新的ContentValues对象</li>
+         * <li>初始化{@link #mCallDataValues}为新的ContentValues对象</li>
+         * <li>将{@link #mTextDataId}和{@link #mCallDataId}初始化为0</li>
+         * </ul>
+         */
+        public NoteData() {
+            mTextDataValues = new ContentValues();
+            mCallDataValues = new ContentValues();
+            mTextDataId = 0;
+            mCallDataId = 0;
+        }
+
+        /**
+         * <p>检查内容数据是否在本地已修改。</p>
+         * <p>业务逻辑：判断文本数据或通话数据是否发生了变更。</p>
+         * 
+         * @return true表示内容数据已修改，false表示未修改
+         * 
+         * <p>判断条件：</p>
+         * <ul>
+         * <li>文本数据变更：{@link #mTextDataValues}的大小大于0</li>
+         * <li>通话数据变更：{@link #mCallDataValues}的大小大于0</li>
+         * </ul>
+         */
+        boolean isLocalModified() {
+            return mTextDataValues.size() > 0 || mCallDataValues.size() > 0;
+        }
+
+        /**
+         * <p>设置文本数据的ID。</p>
+         * <p>业务逻辑：更新文本数据的唯一标识符。</p>
+         * 
+         * @param id 文本数据ID
+         * @throws IllegalArgumentException 当id无效（<=0）时抛出
+         */
+        void setTextDataId(long id) {
+            if(id <= 0) {
+                throw new IllegalArgumentException("Text data id should larger than 0");
+            }
+            mTextDataId = id;
+        }
+
+        /**
+         * <p>设置通话数据的ID。</p>
+         * <p>业务逻辑：更新通话数据的唯一标识符。</p>
+         * 
+         * @param id 通话数据ID
+         * @throws IllegalArgumentException 当id无效（<=0）时抛出
+         */
+        void setCallDataId(long id) {
+            if (id <= 0) {
+                throw new IllegalArgumentException("Call data id should larger than 0");
+            }
+            mCallDataId = id;
+        }
+
+        /**
+         * <p>设置通话数据的字段值。</p>
+         * <p>业务逻辑：更新通话数据的变更记录，并标记笔记为本地已修改。</p>
+         * 
+         * @param key 通话数据字段名
+         * @param value 通话数据字段值
+         * 
+         * <p>自动更新的字段：</p>
+         * <ul>
+         * <li>通过外部类{@link Note}的{@link Note#mNoteDiffValues}更新{@link NoteColumns#LOCAL_MODIFIED}为1</li>
+         * <li>通过外部类{@link Note}的{@link Note#mNoteDiffValues}更新{@link NoteColumns#MODIFIED_DATE}为当前时间戳</li>
+         * </ul>
+         */
+        void setCallData(String key, String value) {
+            mCallDataValues.put(key, value);
+            mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
+            mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
+        }
+
+        /**
+         * <p>设置文本数据的字段值。</p>
+         * <p>业务逻辑：更新文本数据的变更记录，并标记笔记为本地已修改。</p>
+         * 
+         * @param key 文本数据字段名
+         * @param value 文本数据字段值
+         * 
+         * <p>自动更新的字段：</p>
+         * <ul>
+         * <li>通过外部类{@link Note}的{@link Note#mNoteDiffValues}更新{@link NoteColumns#LOCAL_MODIFIED}为1</li>
+         * <li>通过外部类{@link Note}的{@link Note#mNoteDiffValues}更新{@link NoteColumns#MODIFIED_DATE}为当前时间戳</li>
+         * </ul>
+         */
+        void setTextData(String key, String value) {
+            mTextDataValues.put(key, value);
+            mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
+            mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
+        }
+
+        /**
+         * <p>将内容数据的变更同步到ContentResolver。</p>
+         * <p>业务逻辑：处理文本数据和通话数据的插入或更新操作。</p>
+         * 
+         * @param context 上下文对象，用于获取ContentResolver
+         * @param noteId 笔记ID，指定内容数据所属的笔记
+         * @return 成功时返回笔记的Uri，失败时返回null
+         * @throws IllegalArgumentException 当noteId无效（<=0）时抛出
+         * 
+         * <p>同步流程：</p>
+         * <ol>
+         * <li>检查noteId是否有效</li>
+         * <li>处理文本数据：</li>
+         * <ul>
+         * <li>如果{@link #mTextDataId}为0，执行插入操作</li>
+         * <li>否则，执行更新操作</li>
+         * </ul>
+         * <li>处理通话数据：</li>
+         * <ul>
+         * <li>如果{@link #mCallDataId}为0，执行插入操作</li>
+         * <li>否则，执行更新操作</li>
+         * </ul>
+         * <li>通过ContentProviderOperation批量执行所有操作</li>
+         * </ol>
+         * 
+         * <p>跨类调用：</p>
+         * <ul>
+         * <li>通过{@link Context#getContentResolver()}获取ContentResolver</li>
+         * <li>调用{@link android.content.ContentResolver#insert(Uri, ContentValues)}插入新数据</li>
+         * <li>调用{@link android.content.ContentResolver#applyBatch(String, ArrayList)}执行批量操作</li>
+         * </ul>
+         * 
+         * <p>错误处理：</p>
+         * <ul>
+         * <li>插入文本数据失败：记录日志并返回null</li>
+         * <li>批量操作失败：捕获RemoteException和OperationApplicationException，记录日志并返回null</li>
+         * </ul>
+         */
+        Uri pushIntoContentResolver(Context context, long noteId) {
+            /**
+             * Check for safety
+             */
+            if (noteId <= 0) {
+                throw new IllegalArgumentException("Wrong note id:" + noteId);
+            }
+
+            ArrayList<ContentProviderOperation> operationList = new ArrayList<ContentProviderOperation>();
+            ContentProviderOperation.Builder builder = null;
+
+            if(mTextDataValues.size() > 0) {
+                mTextDataValues.put(DataColumns.NOTE_ID, noteId);
+                if (mTextDataId == 0) {
+                    mTextDataValues.put(DataColumns.MIME_TYPE, TextNote.CONTENT_ITEM_TYPE);
+                    Uri uri = context.getContentResolver().insert(Notes.CONTENT_DATA_URI,
+                            mTextDataValues);
+                    try {
+                        setTextDataId(Long.valueOf(uri.getPathSegments().get(1)));
+                    } catch (NumberFormatException e) {
+                        Log.e(TAG, "Insert new text data fail with noteId" + noteId);
+                        mTextDataValues.clear();
+                        return null;
+                    }
+                } else {
+                    builder = ContentProviderOperation.newUpdate(ContentUris.withAppendedId(
+                            Notes.CONTENT_DATA_URI, mTextDataId));
+                    builder.withValues(mTextDataValues);
+                    operationList.add(builder.build());
+                }
+                mTextDataValues.clear();
+            }
+
+            if(mCallDataValues.size() > 0) {
+                mCallDataValues.put(DataColumns.NOTE_ID, noteId);
+                if (mCallDataId == 0) {
+                    mCallDataValues.put(DataColumns.MIME_TYPE, CallNote.CONTENT_ITEM_TYPE);
+                    Uri uri = context.getContentResolver().insert(Notes.CONTENT_DATA_URI,
+                            mCallDataValues);
+                    try {
+                        setCallDataId(Long.valueOf(uri.getPathSegments().get(1)));
+                    } catch (NumberFormatException e) {
+                        Log.e(TAG, "Insert new call data fail with noteId" + noteId);
+                        mCallDataValues.clear();
+                        return null;
+                    }
+                } else {
+                    builder = ContentProviderOperation.newUpdate(ContentUris.withAppendedId(
+                            Notes.CONTENT_DATA_URI, mCallDataId));
+                    builder.withValues(mCallDataValues);
+                    operationList.add(builder.build());
+                }
+                mCallDataValues.clear();
+            }
+
+            if (operationList.size() > 0) {
+                try {
+                    ContentProviderResult[] results = context.getContentResolver().applyBatch(
+                            Notes.AUTHORITY, operationList);
+                    return (results == null || results.length == 0 || results[0] == null) ? null
+                            : ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId);
+                } catch (RemoteException e) {
+                    Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage()));
+                    return null;
+                } catch (OperationApplicationException e) {
+                    Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage()));
+                    return null;
+                }
+            }
+            return null;
+        }
+    }
+}

src/model/WorkingNote.java

@@ -0,0 +1,763 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.model;
+
+import android.appwidget.AppWidgetManager;
+import android.content.ContentUris;
+import android.content.Context;
+import android.database.Cursor;
+import android.text.TextUtils;
+import android.util.Log;
+
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.CallNote;
+import net.micode.notes.data.Notes.DataColumns;
+import net.micode.notes.data.Notes.DataConstants;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.data.Notes.TextNote;
+import net.micode.notes.tool.ResourceParser.NoteBgResources;
+
+
+/**
+ * <p>工作笔记管理类，负责处理笔记的编辑、保存、加载等操作。</p>
+ * <p>设计意图：作为Note类的包装类，提供更便捷的笔记操作接口，处理用户交互和数据同步。</p>
+ * <ul>
+ * <li>管理笔记的元数据和内容数据</li>
+ * <li>提供笔记的加载、保存、删除等功能</li>
+ * <li>处理笔记的设置变更（如背景颜色、提醒时间、清单模式）</li>
+ * <li>支持小组件交互和通知</li>
+ * </ul>
+ * <p>关键关联：</p>
+ * <ul>
+ * <li>与{@link Note}类紧密协作，管理笔记的核心数据</li>
+ * <li>通过{@link Context}与系统服务交互</li>
+ * <li>使用{@link NotesProvider}进行数据持久化</li>
+ * <li>通过{@link NoteSettingChangedListener}接口回调设置变更事件</li>
+ * </ul>
+ */
+public class WorkingNote {
+    /**
+     * <p>笔记的核心数据管理对象。</p>
+     * <p>业务含义：封装笔记的元数据和内容数据的变更管理。</p>
+     */
+    private Note mNote;
+    
+    /**
+     * <p>笔记的唯一标识符。</p>
+     * <p>业务含义：在数据库中唯一标识一条笔记记录。</p>
+     * <p>约束条件：0表示笔记尚未保存到数据库。</p>
+     */
+    private long mNoteId;
+    
+    /**
+     * <p>笔记的内容文本。</p>
+     * <p>业务含义：笔记的主要内容数据。</p>
+     */
+    private String mContent;
+    
+    /**
+     * <p>笔记的模式。</p>
+     * <p>业务含义：表示笔记的显示模式，如普通文本模式或清单模式。</p>
+     */
+    private int mMode;
+
+    /**
+     * <p>笔记的提醒时间。</p>
+     * <p>业务含义：笔记的闹钟提醒时间戳。</p>
+     * <p>约束条件：0表示无提醒。</p>
+     */
+    private long mAlertDate;
+
+    /**
+     * <p>笔记的最后修改时间。</p>
+     * <p>业务含义：记录笔记最后一次修改的时间戳。</p>
+     */
+    private long mModifiedDate;
+
+    /**
+     * <p>笔记的背景颜色ID。</p>
+     * <p>业务含义：标识笔记使用的背景颜色资源。</p>
+     */
+    private int mBgColorId;
+
+    /**
+     * <p>笔记关联的小组件ID。</p>
+     * <p>业务含义：与笔记关联的桌面小组件的唯一标识符。</p>
+     * <p>约束条件：{@link AppWidgetManager#INVALID_APPWIDGET_ID}表示无关联小组件。</p>
+     */
+    private int mWidgetId;
+
+    /**
+     * <p>笔记关联的小组件类型。</p>
+     * <p>业务含义：标识与笔记关联的桌面小组件的类型。</p>
+     * <p>约束条件：{@link Notes#TYPE_WIDGET_INVALIDE}表示无关联小组件。</p>
+     */
+    private int mWidgetType;
+
+    /**
+     * <p>笔记所在的文件夹ID。</p>
+     * <p>业务含义：标识笔记所属的文件夹。</p>
+     */
+    private long mFolderId;
+
+    /**
+     * <p>上下文对象。</p>
+     * <p>业务含义：用于访问系统服务和资源。</p>
+     */
+    private Context mContext;
+
+    /**
+     * <p>日志标签。</p>
+     * <p>业务含义：用于在日志中标识WorkingNote类的相关操作。</p>
+     */
+    private static final String TAG = "WorkingNote";
+
+    /**
+     * <p>笔记是否已删除的标记。</p>
+     * <p>业务含义：标识笔记是否已被标记为删除。</p>
+     */
+    private boolean mIsDeleted;
+
+    /**
+     * <p>笔记设置变更监听器。</p>
+     * <p>业务含义：用于监听笔记设置的变更事件。</p>
+     */
+    private NoteSettingChangedListener mNoteSettingStatusListener;
+
+    /**
+     * <p>笔记内容数据的查询投影。</p>
+     * <p>业务含义：定义从Notes.CONTENT_DATA_URI查询时需要获取的列。</p>
+     */
+    public static final String[] DATA_PROJECTION = new String[] {
+            DataColumns.ID,
+            DataColumns.CONTENT,
+            DataColumns.MIME_TYPE,
+            DataColumns.DATA1,
+            DataColumns.DATA2,
+            DataColumns.DATA3,
+            DataColumns.DATA4,
+    };
+
+    /**
+     * <p>笔记元数据的查询投影。</p>
+     * <p>业务含义：定义从Notes.CONTENT_NOTE_URI查询时需要获取的列。</p>
+     */
+    public static final String[] NOTE_PROJECTION = new String[] {
+            NoteColumns.PARENT_ID,
+            NoteColumns.ALERTED_DATE,
+            NoteColumns.BG_COLOR_ID,
+            NoteColumns.WIDGET_ID,
+            NoteColumns.WIDGET_TYPE,
+            NoteColumns.MODIFIED_DATE
+    };
+
+    /**
+     * <p>DATA_PROJECTION中ID列的索引。</p>
+     */
+    private static final int DATA_ID_COLUMN = 0;
+
+    /**
+     * <p>DATA_PROJECTION中CONTENT列的索引。</p>
+     */
+    private static final int DATA_CONTENT_COLUMN = 1;
+
+    /**
+     * <p>DATA_PROJECTION中MIME_TYPE列的索引。</p>
+     */
+    private static final int DATA_MIME_TYPE_COLUMN = 2;
+
+    /**
+     * <p>DATA_PROJECTION中DATA1列的索引，用于存储模式信息。</p>
+     */
+    private static final int DATA_MODE_COLUMN = 3;
+
+    /**
+     * <p>NOTE_PROJECTION中PARENT_ID列的索引。</p>
+     */
+    private static final int NOTE_PARENT_ID_COLUMN = 0;
+
+    /**
+     * <p>NOTE_PROJECTION中ALERTED_DATE列的索引。</p>
+     */
+    private static final int NOTE_ALERTED_DATE_COLUMN = 1;
+
+    /**
+     * <p>NOTE_PROJECTION中BG_COLOR_ID列的索引。</p>
+     */
+    private static final int NOTE_BG_COLOR_ID_COLUMN = 2;
+
+    /**
+     * <p>NOTE_PROJECTION中WIDGET_ID列的索引。</p>
+     */
+    private static final int NOTE_WIDGET_ID_COLUMN = 3;
+
+    /**
+     * <p>NOTE_PROJECTION中WIDGET_TYPE列的索引。</p>
+     */
+    private static final int NOTE_WIDGET_TYPE_COLUMN = 4;
+
+    /**
+     * <p>NOTE_PROJECTION中MODIFIED_DATE列的索引。</p>
+     */
+    private static final int NOTE_MODIFIED_DATE_COLUMN = 5;
+
+    /**
+     * <p>创建新笔记的构造函数。</p>
+     * <p>功能：初始化一个新的工作笔记对象，设置默认值。</p>
+     * 
+     * @param context 上下文对象，用于访问系统服务
+     * @param folderId 文件夹ID，新笔记将被添加到该文件夹
+     * 
+     * <p>默认初始化：</p>
+     * <ul>
+     * <li>提醒时间：0（无提醒）</li>
+     * <li>修改时间：当前时间戳</li>
+     * <li>笔记ID：0（未保存）</li>
+     * <li>删除标记：false</li>
+     * <li>模式：0（普通文本模式）</li>
+     * <li>小组件类型：无效</li>
+     * </ul>
+     */
+    private WorkingNote(Context context, long folderId) {
+        mContext = context;
+        mAlertDate = 0;
+        mModifiedDate = System.currentTimeMillis();
+        mFolderId = folderId;
+        mNote = new Note();
+        mNoteId = 0;
+        mIsDeleted = false;
+        mMode = 0;
+        mWidgetType = Notes.TYPE_WIDGET_INVALIDE;
+    }
+
+    /**
+     * <p>加载现有笔记的构造函数。</p>
+     * <p>功能：初始化一个工作笔记对象，并从数据库加载现有笔记数据。</p>
+     * 
+     * @param context 上下文对象，用于访问系统服务
+     * @param noteId 笔记ID，要加载的现有笔记
+     * @param folderId 文件夹ID，笔记所属的文件夹
+     * 
+     * <p>加载流程：</p>
+     * <ul>
+     * <li>初始化基本字段</li>
+     * <li>调用{@link #loadNote()}加载笔记元数据</li>
+     * <li>调用{@link #loadNoteData()}加载笔记内容数据</li>
+     * </ul>
+     */
+    private WorkingNote(Context context, long noteId, long folderId) {
+        mContext = context;
+        mNoteId = noteId;
+        mFolderId = folderId;
+        mIsDeleted = false;
+        mNote = new Note();
+        loadNote();
+    }
+
+    /**
+     * <p>加载笔记的元数据。</p>
+     * <p>功能：从数据库查询并加载笔记的元数据信息。</p>
+     * 
+     * <p>加载流程：</p>
+     * <ol>
+     * <li>通过ContentResolver查询{@link Notes#CONTENT_NOTE_URI}获取笔记元数据</li>
+     * <li>如果查询成功，提取并保存元数据字段</li>
+     * <li>关闭Cursor</li>
+     * <li>如果查询失败，记录日志并抛出异常</li>
+     * <li>调用{@link #loadNoteData()}加载笔记内容数据</li>
+     * </ol>
+     * 
+     * <p>加载的元数据字段：</p>
+     * <ul>
+     * <li>文件夹ID</li>
+     * <li>背景颜色ID</li>
+     * <li>小组件ID</li>
+     * <li>小组件类型</li>
+     * <li>提醒时间</li>
+     * <li>修改时间</li>
+     * </ul>
+     * 
+     * <p>错误处理：</p>
+     * <ul>
+     * <li>如果查询失败，记录错误日志</li>
+     * <li>抛出IllegalArgumentException异常</li>
+     * </ul>
+     */
+    private void loadNote() {
+        Cursor cursor = mContext.getContentResolver().query(
+                ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, mNoteId), NOTE_PROJECTION, null,
+                null, null);
+
+        if (cursor != null) {
+            if (cursor.moveToFirst()) {
+                mFolderId = cursor.getLong(NOTE_PARENT_ID_COLUMN);
+                mBgColorId = cursor.getInt(NOTE_BG_COLOR_ID_COLUMN);
+                mWidgetId = cursor.getInt(NOTE_WIDGET_ID_COLUMN);
+                mWidgetType = cursor.getInt(NOTE_WIDGET_TYPE_COLUMN);
+                mAlertDate = cursor.getLong(NOTE_ALERTED_DATE_COLUMN);
+                mModifiedDate = cursor.getLong(NOTE_MODIFIED_DATE_COLUMN);
+            }
+            cursor.close();
+        } else {
+            Log.e(TAG, "No note with id:" + mNoteId);
+            throw new IllegalArgumentException("Unable to find note with id " + mNoteId);
+        }
+        loadNoteData();
+    }
+
+    /**
+     * <p>加载笔记的内容数据。</p>
+     * <p>功能：从数据库查询并加载笔记的内容数据信息。</p>
+     * 
+     * <p>加载流程：</p>
+     * <ol>
+     * <li>通过ContentResolver查询{@link Notes#CONTENT_DATA_URI}获取笔记内容数据</li>
+     * <li>如果查询成功，遍历所有结果</li>
+     * <li>根据数据类型处理不同类型的内容数据：</li>
+     * <ul>
+     * <li>普通笔记：保存内容、模式、文本数据ID</li>
+     * <li>通话笔记：保存通话数据ID</li>
+     * <li>其他类型：记录日志</li>
+     * </ul>
+     * <li>关闭Cursor</li>
+     * <li>如果查询失败，记录日志并抛出异常</li>
+     * </ol>
+     * 
+     * <p>错误处理：</p>
+     * <ul>
+     * <li>如果查询失败，记录错误日志</li>
+     * <li>抛出IllegalArgumentException异常</li>
+     * </ul>
+     */
+    private void loadNoteData() {
+        Cursor cursor = mContext.getContentResolver().query(Notes.CONTENT_DATA_URI, DATA_PROJECTION,
+                DataColumns.NOTE_ID + "=?", new String[] {
+                    String.valueOf(mNoteId)
+                }, null);
+
+        if (cursor != null) {
+            if (cursor.moveToFirst()) {
+                do {
+                    String type = cursor.getString(DATA_MIME_TYPE_COLUMN);
+                    if (DataConstants.NOTE.equals(type)) {
+                        mContent = cursor.getString(DATA_CONTENT_COLUMN);
+                        mMode = cursor.getInt(DATA_MODE_COLUMN);
+                        mNote.setTextDataId(cursor.getLong(DATA_ID_COLUMN));
+                    } else if (DataConstants.CALL_NOTE.equals(type)) {
+                        mNote.setCallDataId(cursor.getLong(DATA_ID_COLUMN));
+                    } else {
+                        Log.d(TAG, "Wrong note type with type:" + type);
+                    }
+                } while (cursor.moveToNext());
+            }
+            cursor.close();
+        } else {
+            Log.e(TAG, "No data with id:" + mNoteId);
+            throw new IllegalArgumentException("Unable to find note's data with id " + mNoteId);
+        }
+    }
+
+    /**
+     * <p>创建一个空的工作笔记。</p>
+     * <p>功能：创建一个新的工作笔记对象，并设置默认属性。</p>
+     * 
+     * @param context 上下文对象，用于访问系统服务
+     * @param folderId 文件夹ID，新笔记将被添加到该文件夹
+     * @param widgetId 小组件ID，如果笔记关联到小组件
+     * @param widgetType 小组件类型，如果笔记关联到小组件
+     * @param defaultBgColorId 默认背景颜色ID
+     * 
+     * @return 创建的工作笔记对象
+     * 
+     * <p>初始化步骤：</p>
+     * <ol>
+     * <li>创建新的WorkingNote实例</li>
+     * <li>设置默认背景颜色</li>
+     * <li>设置小组件ID（如果有）</li>
+     * <li>设置小组件类型（如果有）</li>
+     * <li>返回创建的笔记对象</li>
+     * </ol>
+     */
+    public static WorkingNote createEmptyNote(Context context, long folderId, int widgetId,
+            int widgetType, int defaultBgColorId) {
+        WorkingNote note = new WorkingNote(context, folderId);
+        note.setBgColorId(defaultBgColorId);
+        note.setWidgetId(widgetId);
+        note.setWidgetType(widgetType);
+        return note;
+    }
+
+    /**
+     * <p>从数据库加载现有笔记。</p>
+     * <p>功能：根据笔记ID从数据库加载笔记数据，并创建工作笔记对象。</p>
+     * 
+     * @param context 上下文对象，用于访问系统服务
+     * @param id 笔记ID，要加载的现有笔记
+     * 
+     * @return 加载的工作笔记对象
+     * 
+     * <p>加载流程：</p>
+     * <ul>
+     * <li>调用构造函数创建WorkingNote实例</li>
+     * <li>在构造函数中调用{@link #loadNote()}加载元数据</li>
+     * <li>在loadNote()中调用{@link #loadNoteData()}加载内容数据</li>
+     * </ul>
+     */
+    public static WorkingNote load(Context context, long id) {
+        return new WorkingNote(context, id, 0);
+    }
+
+    /**
+     * <p>保存笔记到数据库。</p>
+     * <p>功能：将工作笔记的内容和设置保存到数据库中。</p>
+     * 
+     * @return 保存是否成功
+     * 
+     * <p>保存流程：</p>
+     * <ol>
+     * <li>检查笔记是否值得保存（{@link #isWorthSaving()}）</li>
+     * <li>如果笔记不存在于数据库：</li>
+     * <ul>
+     * <li>调用{@link Note#getNewNoteId(Context, long)}获取新笔记ID</li>
+     * <li>如果获取失败，记录日志并返回false</li>
+     * </ul>
+     * <li>调用{@link Note#syncNote(Context, long)}同步笔记数据到数据库</li>
+     * <li>如果笔记关联到小组件，通知小组件更新</li>
+     * <li>返回保存结果</li>
+     * </ol>
+     * 
+     * <p>线程安全：</p>
+     * <ul>
+     * <li>使用synchronized关键字保证多线程环境下的安全</li>
+     * </ul>
+     */
+    public synchronized boolean saveNote() {
+        if (isWorthSaving()) {
+            if (!existInDatabase()) {
+                if ((mNoteId = Note.getNewNoteId(mContext, mFolderId)) == 0) {
+                    Log.e(TAG, "Create new note fail with id:" + mNoteId);
+                    return false;
+                }
+            }
+
+            mNote.syncNote(mContext, mNoteId);
+
+            /**
+             * Update widget content if there exist any widget of this note
+             */
+            if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID
+                    && mWidgetType != Notes.TYPE_WIDGET_INVALIDE
+                    && mNoteSettingStatusListener != null) {
+                mNoteSettingStatusListener.onWidgetChanged();
+            }
+            return true;
+        } else {
+            return false;
+        }
+    }
+
+    /**
+     * <p>检查笔记是否存在于数据库中。</p>
+     * <p>功能：根据笔记ID判断笔记是否已保存到数据库。</p>
+     * 
+     * @return 如果笔记存在于数据库返回true，否则返回false
+     * 
+     * <p>判断逻辑：</p>
+     * <ul>
+     * <li>笔记ID大于0表示已保存到数据库</li>
+     * <li>笔记ID等于0表示未保存到数据库</li>
+     * </ul>
+     */
+    public boolean existInDatabase() {
+        return mNoteId > 0;
+    }
+
+    /**
+     * <p>检查笔记是否值得保存。</p>
+     * <p>功能：判断笔记是否需要保存到数据库。</p>
+     * 
+     * @return 如果笔记值得保存返回true，否则返回false
+     * 
+     * <p>判断条件：</p>
+     * <ul>
+     * <li>如果笔记已标记为删除 → 不值得保存</li>
+     * <li>如果笔记不存在于数据库且内容为空 → 不值得保存</li>
+     * <li>如果笔记存在于数据库但没有本地修改 → 不值得保存</li>
+     * <li>其他情况 → 值得保存</li>
+     * </ul>
+     * 
+     * <p>优化作用：</p>
+     * <ul>
+     * <li>避免保存空笔记或未修改的笔记</li>
+     * <li>减少不必要的数据库操作</li>
+     * </ul>
+     */
+    private boolean isWorthSaving() {
+        if (mIsDeleted || (!existInDatabase() && TextUtils.isEmpty(mContent))
+                || (existInDatabase() && !mNote.isLocalModified())) {
+            return false;
+        } else {
+            return true;
+        }
+    }
+
+    /**
+     * <p>设置笔记设置变更监听器。</p>
+     * <p>功能：注册一个监听器，用于接收笔记设置变更的通知。</p>
+     * 
+     * @param l 笔记设置变更监听器
+     */
+    public void setOnSettingStatusChangedListener(NoteSettingChangedListener l) {
+        mNoteSettingStatusListener = l;
+    }
+
+    /**
+     * <p>设置笔记的提醒时间。</p>
+     * <p>功能：更新笔记的提醒时间，并通知监听器。</p>
+     * 
+     * @param date 提醒时间戳
+     * @param set 是否设置提醒（true表示设置，false表示取消）
+     * 
+     * <p>处理流程：</p>
+     * <ol>
+     * <li>如果提醒时间发生变化：</li>
+     * <ul>
+     * <li>更新内部提醒时间字段</li>
+     * <li>调用{@link Note#setNoteValue(String, String)}更新笔记元数据</li>
+     * </ul>
+     * <li>通知监听器提醒时间已变更</li>
+     * </ol>
+     */
+    public void setAlertDate(long date, boolean set) {
+        if (date != mAlertDate) {
+            mAlertDate = date;
+            mNote.setNoteValue(NoteColumns.ALERTED_DATE, String.valueOf(mAlertDate));
+        }
+        if (mNoteSettingStatusListener != null) {
+            mNoteSettingStatusListener.onClockAlertChanged(date, set);
+        }
+    }
+
+    /**
+     * <p>标记笔记是否已删除。</p>
+     * <p>功能：设置笔记的删除标记，并通知关联的小组件。</p>
+     * 
+     * @param mark 删除标记（true表示已删除，false表示未删除）
+     * 
+     * <p>处理流程：</p>
+     * <ol>
+     * <li>更新内部删除标记字段</li>
+     * <li>如果笔记关联到小组件，通知小组件更新</li>
+     * </ol>
+     */
+    public void markDeleted(boolean mark) {
+        mIsDeleted = mark;
+        if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID
+                && mWidgetType != Notes.TYPE_WIDGET_INVALIDE && mNoteSettingStatusListener != null) {
+                mNoteSettingStatusListener.onWidgetChanged();
+        }
+    }
+
+    public void setBgColorId(int id) {
+        if (id != mBgColorId) {
+            mBgColorId = id;
+            if (mNoteSettingStatusListener != null) {
+                mNoteSettingStatusListener.onBackgroundColorChanged();
+            }
+            mNote.setNoteValue(NoteColumns.BG_COLOR_ID, String.valueOf(id));
+        }
+    }
+
+    public void setCheckListMode(int mode) {
+        if (mMode != mode) {
+            if (mNoteSettingStatusListener != null) {
+                mNoteSettingStatusListener.onCheckListModeChanged(mMode, mode);
+            }
+            mMode = mode;
+            mNote.setTextData(TextNote.MODE, String.valueOf(mMode));
+        }
+    }
+
+    public void setWidgetType(int type) {
+        if (type != mWidgetType) {
+            mWidgetType = type;
+            mNote.setNoteValue(NoteColumns.WIDGET_TYPE, String.valueOf(mWidgetType));
+        }
+    }
+
+    public void setWidgetId(int id) {
+        if (id != mWidgetId) {
+            mWidgetId = id;
+            mNote.setNoteValue(NoteColumns.WIDGET_ID, String.valueOf(mWidgetId));
+        }
+    }
+
+    public void setWorkingText(String text) {
+        if (!TextUtils.equals(mContent, text)) {
+            mContent = text;
+            mNote.setTextData(DataColumns.CONTENT, mContent);
+        }
+    }
+
+    /**
+     * <p>将笔记转换为通话笔记。</p>
+     * <p>功能：设置笔记为通话笔记类型，并添加通话相关信息。</p>
+     * 
+     * @param phoneNumber 电话号码
+     * @param callDate 通话时间戳
+     * 
+     * <p>转换流程：</p>
+     * <ol>
+     * <li>设置通话日期</li>
+     * <li>设置电话号码</li>
+     * <li>将笔记移动到通话记录文件夹</li>
+     * </ol>
+     */
+    public void convertToCallNote(String phoneNumber, long callDate) {
+        mNote.setCallData(CallNote.CALL_DATE, String.valueOf(callDate));
+        mNote.setCallData(CallNote.PHONE_NUMBER, phoneNumber);
+        mNote.setNoteValue(NoteColumns.PARENT_ID, String.valueOf(Notes.ID_CALL_RECORD_FOLDER));
+    }
+
+    /**
+     * <p>检查笔记是否有提醒。</p>
+     * <p>功能：判断笔记是否设置了提醒时间。</p>
+     * 
+     * @return 如果有提醒返回true，否则返回false
+     * 
+     * <p>判断逻辑：</p>
+     * <ul>
+     * <li>提醒时间大于0表示有提醒</li>
+     * <li>提醒时间等于0表示无提醒</li>
+     * </ul>
+     */
+    public boolean hasClockAlert() {
+        return (mAlertDate > 0 ? true : false);
+    }
+
+    /**
+     * <p>获取笔记内容。</p>
+     * @return 笔记的内容文本
+     */
+    public String getContent() {
+        return mContent;
+    }
+
+    /**
+     * <p>获取笔记的提醒时间。</p>
+     * @return 笔记的提醒时间戳
+     */
+    public long getAlertDate() {
+        return mAlertDate;
+    }
+
+    /**
+     * <p>获取笔记的最后修改时间。</p>
+     * @return 笔记的最后修改时间戳
+     */
+    public long getModifiedDate() {
+        return mModifiedDate;
+    }
+
+    /**
+     * <p>获取笔记背景颜色的资源ID。</p>
+     * @return 背景颜色的资源ID
+     */
+    public int getBgColorResId() {
+        return NoteBgResources.getNoteBgResource(mBgColorId);
+    }
+
+    /**
+     * <p>获取笔记背景颜色的ID。</p>
+     * @return 背景颜色的ID
+     */
+    public int getBgColorId() {
+        return mBgColorId;
+    }
+
+    /**
+     * <p>获取笔记标题背景的资源ID。</p>
+     * @return 标题背景的资源ID
+     */
+    public int getTitleBgResId() {
+        return NoteBgResources.getNoteTitleBgResource(mBgColorId);
+    }
+
+    /**
+     * <p>获取笔记的清单模式。</p>
+     * @return 清单模式（0表示普通模式，1表示清单模式）
+     */
+    public int getCheckListMode() {
+        return mMode;
+    }
+
+    /**
+     * <p>获取笔记的ID。</p>
+     * @return 笔记的唯一标识符
+     */
+    public long getNoteId() {
+        return mNoteId;
+    }
+
+    /**
+     * <p>获取笔记所属的文件夹ID。</p>
+     * @return 文件夹ID
+     */
+    public long getFolderId() {
+        return mFolderId;
+    }
+
+    /**
+     * <p>获取笔记关联的小组件ID。</p>
+     * @return 小组件ID（无效时返回{@link AppWidgetManager#INVALID_APPWIDGET_ID}）
+     */
+    public int getWidgetId() {
+        return mWidgetId;
+    }
+
+    /**
+     * <p>获取笔记关联的小组件类型。</p>
+     * @return 小组件类型（无效时返回{@link Notes#TYPE_WIDGET_INVALIDE}）
+     */
+    public int getWidgetType() {
+        return mWidgetType;
+    }
+
+    public interface NoteSettingChangedListener {
+        /**
+         * Called when the background color of current note has just changed
+         */
+        void onBackgroundColorChanged();
+
+        /**
+         * Called when user set clock
+         */
+        void onClockAlertChanged(long date, boolean set);
+
+        /**
+         * Call when user create note from widget
+         */
+        void onWidgetChanged();
+
+        /**
+         * Call when switch between check list mode and normal mode
+         * @param oldMode is previous mode before change
+         * @param newMode is new mode
+         */
+        void onCheckListModeChanged(int oldMode, int newMode);
+    }
+}

src/tool/BackupUtils.java

@@ -0,0 +1,436 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.tool;
+
+import android.content.Context;
+import android.database.Cursor;
+import android.os.Environment;
+import android.text.TextUtils;
+import android.text.format.DateFormat;
+import android.util.Log;
+
+import net.micode.notes.R;
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.DataColumns;
+import net.micode.notes.data.Notes.DataConstants;
+import net.micode.notes.data.Notes.NoteColumns;
+
+import java.io.File;
+import java.io.FileNotFoundException;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.PrintStream;
+
+
+/**
+ * 小米便签的备份工具类，用于将便签数据导出为文本文件存储在SD卡，支持文件夹、普通便签、通话记录便签的备份
+ * 采用单例模式，确保全局唯一实例（只有当BackupUtils不存在时才创建）
+ */
+public class BackupUtils {
+    private static final String TAG = "BackupUtils"; // 日志标签
+    // 单例实例
+    private static BackupUtils sInstance;
+
+    /**
+     * 获取单例实例
+     * @param context 应用上下文，用于访问资源和数据库，Context让备份工具能够访问便签数据、读取格式模板、写入SD卡，是连接应用逻辑和Android系统的特殊类
+     * @return 全局唯一的BackupUtils实例（只有当BackupUtils不存在时才创建）
+     */
+    public static synchronized BackupUtils getInstance(Context context) {
+        if (sInstance == null) {
+            sInstance = new BackupUtils(context);
+        }
+        return sInstance;
+    }
+
+    /**
+     * 备份/恢复状态常量，用于标识操作结果
+     */
+    // SD卡未挂载（无法读写）
+    public static final int STATE_SD_CARD_UNMOUONTED           = 0;
+    // 备份文件不存在（恢复时使用）
+    public static final int STATE_BACKUP_FILE_NOT_EXIST        = 1;
+    // 数据格式损坏（可能被其他程序修改）
+    public static final int STATE_DATA_DESTROIED               = 2;
+    // 运行时异常导致操作失败
+    public static final int STATE_SYSTEM_ERROR                 = 3;
+    // 备份/恢复成功
+    public static final int STATE_SUCCESS                      = 4;
+
+    // 文本导出的具体实现类
+    private TextExport mTextExport;
+
+    /**
+     * 私有构造方法，初始化文本导出工具
+     * @param context 应用上下文
+     */
+    private BackupUtils(Context context) {
+        mTextExport = new TextExport(context);
+    }
+
+    /**
+     * 检查外部存储（SD卡）是否可用（已挂载且可读写）
+     * @return 可用返回true，否则false
+     */
+    private static boolean externalStorageAvailable() {
+        return Environment.MEDIA_MOUNTED.equals(Environment.getExternalStorageState());// 返回存储状态
+    }
+
+    /**
+     * 对外提供的文本导出入口方法
+     * @return 备份状态（如STATE_SUCCESS、STATE_SD_CARD_UNMOUONTED等）
+     */
+    public int exportToText() {
+        return mTextExport.exportToText();
+    }
+
+    /**
+     * 获取导出的文本文件名
+     * @return 文件名（如notes_20240520.txt）
+     */
+    public String getExportedTextFileName() {
+        return mTextExport.mFileName;
+    }
+
+    /**
+     * 获取导出的文本文件所在目录
+     * @return 目录路径（如/sdcard/NotesBackup/）
+     */
+    public String getExportedTextFileDir() {
+        return mTextExport.mFileDirectory;
+    }
+
+    /**
+     * 静态内部类，封装文本导出的具体逻辑：查询数据库、格式化数据、写入文件
+     */
+    private static class TextExport {
+        // 查询便签时需要的字段投影（只查询需要的列，优化性能）
+        private static final String[] NOTE_PROJECTION = {
+                NoteColumns.ID,           // 便签/文件夹ID
+                NoteColumns.MODIFIED_DATE,// 最后修改时间
+                NoteColumns.SNIPPET,      // 文件夹名或便签摘要
+                NoteColumns.TYPE          // 类型（文件夹/便签）
+        };
+
+        // 字段索引常量，用于从Cursor中快速获取对应值
+        private static final int NOTE_COLUMN_ID = 0;
+        private static final int NOTE_COLUMN_MODIFIED_DATE = 1;
+        private static final int NOTE_COLUMN_SNIPPET = 2;
+
+        // 查询便签详情数据时的字段投影
+        private static final String[] DATA_PROJECTION = {
+                DataColumns.CONTENT,      // 内容（文本/位置）
+                DataColumns.MIME_TYPE,    // 类型（普通便签/通话便签）
+                DataColumns.DATA1,        // 通话便签的通话时间，getFormat函数定义的
+                DataColumns.DATA2,
+                DataColumns.DATA3,        // 通话便签的电话号码，getFormat函数定义的
+                DataColumns.DATA4,
+        };
+
+        /*
+        * private String getFormat(int id) {
+            return TEXT_FORMAT[id];
+        }*/
+        // 数据字段索引常量
+        private static final int DATA_COLUMN_CONTENT = 0;
+        private static final int DATA_COLUMN_MIME_TYPE = 1;
+        private static final int DATA_COLUMN_CALL_DATE = 2; // 通话时间在DATA1中，getFormat函数定义的
+        private static final int DATA_COLUMN_PHONE_NUMBER = 4; // 电话号码在DATA3中，getFormat函数定义的
+
+        // 文本格式化模板（从资源文件读取，如文件夹名、时间、内容的格式）
+        private final String [] TEXT_FORMAT;
+        // 格式化模板的索引常量
+        private static final int FORMAT_FOLDER_NAME          = 0; // 文件夹名格式
+        private static final int FORMAT_NOTE_DATE            = 1; // 便签时间格式
+        private static final int FORMAT_NOTE_CONTENT         = 2; // 便签内容格式
+
+        private Context mContext;       // 上下文
+        private String mFileName;       // 导出的文件名
+        private String mFileDirectory;  // 导出的文件目录
+
+        /**
+         * 初始化文本导出工具
+         * @param context 上下文，用于获取资源和查询数据库
+         */
+        public TextExport(Context context) {
+            // 从资源文件读取格式化模板（如strings.xml中的format_for_exported_note数组）
+            TEXT_FORMAT = context.getResources().getStringArray(R.array.format_for_exported_note);
+            mContext = context;
+            mFileName = "";
+            mFileDirectory = "";
+        }
+
+        /**
+         * 获取指定索引的格式化模板
+         * @param id 模板索引（如FORMAT_FOLDER_NAME）
+         * @return 模板字符串
+         */
+        private String getFormat(int id) {
+            return TEXT_FORMAT[id];
+        }
+
+        /**
+         * 导出指定文件夹下的所有便签到输出流
+         * @param folderId 文件夹ID
+         * @param ps 输出流（指向备份文件）
+         */
+        private void exportFolderToText(String folderId, PrintStream ps) {
+            // 查询该文件夹下的所有便签（通过parent_id关联）
+            Cursor notesCursor = mContext.getContentResolver().query(
+                    Notes.CONTENT_NOTE_URI,       // 便签数据库的URI
+                    NOTE_PROJECTION,              // 要查询的字段
+                    NoteColumns.PARENT_ID + "=?", // 查询条件：parent_id=folderId
+                    new String[] {folderId},      // 条件参数
+                    null);                        // 排序方式（默认）
+
+            if (notesCursor != null) {
+                if (notesCursor.moveToFirst()) { // 遍历所有便签
+                    do {
+                        // 打印便签的最后修改时间（格式化显示）
+                        ps.println(String.format(
+                                getFormat(FORMAT_NOTE_DATE),
+                                DateFormat.format(
+                                        mContext.getString(R.string.format_datetime_mdhm), // 时间格式（月日时分）
+                                        notesCursor.getLong(NOTE_COLUMN_MODIFIED_DATE)
+                                )
+                        ));
+                        // 导出该便签的详细内容
+                        String noteId = notesCursor.getString(NOTE_COLUMN_ID);
+                        exportNoteToText(noteId, ps);
+                    } while (notesCursor.moveToNext());
+                }
+                notesCursor.close(); // 关闭游标，释放资源
+            }
+        }
+
+        /**
+         * 导出单个便签的详细内容到输出流
+         * 区分普通便签和通话便签，分别格式化内容
+         * @param noteId 便签ID
+         * @param ps 输出流（指向备份文件）
+         */
+        private void exportNoteToText(String noteId, PrintStream ps) {
+            // 查询该便签的详细数据（如文本内容、通话记录信息）
+            Cursor dataCursor = mContext.getContentResolver().query(
+                    Notes.CONTENT_DATA_URI,       // 便签数据的URI
+                    DATA_PROJECTION,              // 要查询的字段
+                    DataColumns.NOTE_ID + "=?",   // 查询条件：note_id=noteId
+                    new String[] {noteId},        // 条件参数
+                    null);                        // 排序方式
+
+            if (dataCursor != null) {
+                if (dataCursor.moveToFirst()) { // 遍历便签的所有数据
+                    do {
+                        String mimeType = dataCursor.getString(DATA_COLUMN_MIME_TYPE);
+                        if (DataConstants.CALL_NOTE.equals(mimeType)) { // 通话记录便签
+                            // 提取电话号码、通话时间、位置信息
+                            String phoneNumber = dataCursor.getString(DATA_COLUMN_PHONE_NUMBER);
+                            long callDate = dataCursor.getLong(DATA_COLUMN_CALL_DATE);
+                            String location = dataCursor.getString(DATA_COLUMN_CONTENT);
+
+                            // 打印电话号码（非空时）
+                            if (!TextUtils.isEmpty(phoneNumber)) {
+                                ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT), phoneNumber));
+                            }
+                            // 打印通话时间（格式化）
+                            ps.println(String.format(
+                                    getFormat(FORMAT_NOTE_CONTENT),
+                                    DateFormat.format(
+                                            mContext.getString(R.string.format_datetime_mdhm),
+                                            callDate
+                                    )
+                            ));
+                            // 打印位置信息（非空时）
+                            if (!TextUtils.isEmpty(location)) {
+                                ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT), location));
+                            }
+                        } else if (DataConstants.NOTE.equals(mimeType)) { // 普通文本便签
+                            String content = dataCursor.getString(DATA_COLUMN_CONTENT);
+                            if (!TextUtils.isEmpty(content)) { // 打印文本内容
+                                ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT), content));
+                            }
+                        }
+                    } while (dataCursor.moveToNext());
+                }
+                dataCursor.close(); // 关闭游标，释放资源
+            }
+            // 便签之间添加分隔符（换行）
+            try {
+                ps.write(new byte[] {Character.LINE_SEPARATOR, Character.LINE_SEPARATOR});
+            } catch (IOException e) {
+                Log.e(TAG, "写入分隔符失败：" + e.toString());
+            }
+        }
+
+        /**
+         * 执行文本导出的主逻辑：检查SD卡→创建文件→查询数据→写入文件
+         * @return 备份状态（如STATE_SUCCESS）
+         */
+        public int exportToText() {
+            // 检查SD卡是否可用
+            if (!externalStorageAvailable()) {
+                Log.d(TAG, "SD卡未挂载，无法导出");
+                return STATE_SD_CARD_UNMOUONTED;
+            }
+
+            // 获取指向备份文件的输出流
+            PrintStream ps = getExportToTextPrintStream();
+            if (ps == null) {
+                Log.e(TAG, "创建输出流失败");
+                return STATE_SYSTEM_ERROR;
+            }
+
+            // 1. 导出所有文件夹及其包含的便签（排除回收站，包含通话记录文件夹）
+            Cursor folderCursor = mContext.getContentResolver().query(
+                    Notes.CONTENT_NOTE_URI,
+                    NOTE_PROJECTION,
+                    // 查询条件：文件夹类型且不在回收站，或通话记录文件夹
+                    "(" + NoteColumns.TYPE + "=" + Notes.TYPE_FOLDER + " AND "
+                            + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER + ") OR "
+                            + NoteColumns.ID + "=" + Notes.ID_CALL_RECORD_FOLDER,
+                    null,
+                    null);
+
+            if (folderCursor != null) {
+                if (folderCursor.moveToFirst()) { // 遍历所有文件夹
+                    do {
+                        // 获取文件夹名（通话记录文件夹使用固定名称）
+                        String folderName = "";
+                        if (folderCursor.getLong(NOTE_COLUMN_ID) == Notes.ID_CALL_RECORD_FOLDER) {
+                            folderName = mContext.getString(R.string.call_record_folder_name); // 从资源获取“通话记录”
+                        } else {
+                            folderName = folderCursor.getString(NOTE_COLUMN_SNIPPET); // 普通文件夹名
+                        }
+                        // 打印文件夹名（非空时）
+                        if (!TextUtils.isEmpty(folderName)) {
+                            ps.println(String.format(getFormat(FORMAT_FOLDER_NAME), folderName));
+                        }
+                        // 导出该文件夹下的所有便签
+                        String folderId = folderCursor.getString(NOTE_COLUMN_ID);
+                        exportFolderToText(folderId, ps);
+                    } while (folderCursor.moveToNext());
+                }
+                folderCursor.close(); // 关闭游标
+            }
+
+            // 2. 导出根目录下的便签（无文件夹归属的便签，parent_id=0）
+            Cursor noteCursor = mContext.getContentResolver().query(
+                    Notes.CONTENT_NOTE_URI,
+                    NOTE_PROJECTION,
+                    NoteColumns.TYPE + "=" + Notes.TYPE_NOTE + " AND " + NoteColumns.PARENT_ID + "=0",
+                    null,
+                    null);
+
+            if (noteCursor != null) {
+                if (noteCursor.moveToFirst()) { // 遍历根目录便签
+                    do {
+                        // 打印修改时间
+                        ps.println(String.format(
+                                getFormat(FORMAT_NOTE_DATE),
+                                DateFormat.format(
+                                        mContext.getString(R.string.format_datetime_mdhm),
+                                        noteCursor.getLong(NOTE_COLUMN_MODIFIED_DATE)
+                                )
+                        ));
+                        // 导出便签内容
+                        String noteId = noteCursor.getString(NOTE_COLUMN_ID);
+                        exportNoteToText(noteId, ps);
+                    } while (noteCursor.moveToNext());
+                }
+                noteCursor.close(); // 关闭游标
+            }
+
+            ps.close(); // 关闭输出流
+            return STATE_SUCCESS; // 导出成功
+        }
+
+        /**
+         * 创建SD卡上的备份文件，并返回指向该文件的PrintStream
+         * @return 输出流（PrintStream），失败返回null
+         */
+        private PrintStream getExportToTextPrintStream() {
+            // 在SD卡上生成备份文件（路径和名称从资源获取，包含当前日期）
+            File file = generateFileMountedOnSDcard(
+                    mContext,
+                    R.string.file_path,         // 目录路径（如/sdcard/NotesBackup/）
+                    R.string.file_name_txt_format // 文件名格式（如notes_%s.txt，%s为日期）
+            );
+            if (file == null) {
+                Log.e(TAG, "创建备份文件失败");
+                return null;
+            }
+            // 记录文件名和目录
+            mFileName = file.getName();
+            mFileDirectory = mContext.getString(R.string.file_path);
+
+            // 创建输出流
+            PrintStream ps = null;
+            try {
+                FileOutputStream fos = new FileOutputStream(file);
+                ps = new PrintStream(fos);
+            } catch (FileNotFoundException e) {
+                e.printStackTrace();
+                return null;
+            } catch (NullPointerException e) {
+                e.printStackTrace();
+                return null;
+            }
+            return ps;
+        }
+    }
+
+    /**
+     * 在SD卡上创建备份文件（含目录）
+     * @param context 上下文
+     * @param filePathResId 目录路径的资源ID（如R.string.file_path）
+     * @param fileNameFormatResId 文件名格式的资源ID（如R.string.file_name_txt_format）
+     * @return 创建的文件，失败返回null
+     */
+    private static File generateFileMountedOnSDcard(Context context, int filePathResId, int fileNameFormatResId) {
+        StringBuilder sb = new StringBuilder();
+        // 拼接路径：SD卡根目录 + 应用备份目录（如/sdcard/NotesBackup/）
+        sb.append(Environment.getExternalStorageDirectory());
+        sb.append(context.getString(filePathResId));
+        File filedir = new File(sb.toString());
+
+        // 拼接文件名：目录 + 格式化名称（含当前日期，如notes_20240520.txt）
+        sb.append(context.getString(
+                fileNameFormatResId,
+                DateFormat.format(
+                        context.getString(R.string.format_date_ymd), // 日期格式（年月日）
+                        System.currentTimeMillis()
+                )
+        ));
+        File file = new File(sb.toString());
+
+        // 创建目录和文件
+        try {
+            if (!filedir.exists()) {
+                filedir.mkdir(); // 目录不存在则创建
+            }
+            if (!file.exists()) {
+                file.createNewFile(); // 文件不存在则创建
+            }
+            return file;
+        } catch (SecurityException e) {
+            e.printStackTrace(); // 权限不足
+        } catch (IOException e) {
+            e.printStackTrace(); // 创建文件失败
+        }
+        return null;
+    }
+}

src/tool/DataUtils.java

@@ -0,0 +1,381 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.tool;
+
+import android.content.ContentProviderOperation;
+import android.content.ContentProviderResult;
+import android.content.ContentResolver;
+import android.content.ContentUris;
+import android.content.ContentValues;
+import android.content.OperationApplicationException;
+import android.database.Cursor;
+import android.os.RemoteException;
+import android.util.Log;
+
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.CallNote;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.ui.NotesListAdapter.AppWidgetAttribute;
+
+import java.util.ArrayList;
+import java.util.HashSet;
+
+
+
+
+/**
+ * 便签数据操作工具类，封装数据库查询、更新、删除等常用操作，
+ * 提供与ContentProvider交互的统一接口，支撑UI层的数据需求
+ */
+public class DataUtils {
+    public static final String TAG = "DataUtils";
+
+    /**
+     * 批量删除便签或文件夹（跳过系统根目录）
+     * @param resolver 内容解析器，用于操作数据库
+     * @param ids 待删除的便签/文件夹ID集合
+     * @return 操作成功返回true，失败返回false
+     */
+    public static boolean batchDeleteNotes(ContentResolver resolver, HashSet<Long> ids) {
+        if (ids == null) {
+            Log.d(TAG, "待删除的ID集合为null");
+            return true;
+        }
+        if (ids.size() == 0) {
+            Log.d(TAG, "待删除的ID集合为空");
+            return true;
+        }
+
+        // 创建批量删除操作列表
+        ArrayList<ContentProviderOperation> operationList = new ArrayList<ContentProviderOperation>();
+        for (long id : ids) {
+            // 禁止删除系统根目录
+            if(id == Notes.ID_ROOT_FOLDER) {
+                Log.e(TAG, "不能删除系统根目录文件夹");
+                continue;
+            }
+            // 构建删除操作（根据ID删除便签）
+            ContentProviderOperation.Builder builder = ContentProviderOperation
+                    .newDelete(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id));
+            operationList.add(builder.build());
+        }
+
+        try {
+            // 执行批量删除
+            ContentProviderResult[] results = resolver.applyBatch(Notes.AUTHORITY, operationList);
+            if (results == null || results.length == 0 || results[0] == null) {
+                Log.d(TAG, "删除失败，ID集合:" + ids.toString());
+                return false;
+            }
+            return true;
+        } catch (RemoteException e) {
+            Log.e(TAG, String.format("远程异常: %s: %s", e.toString(), e.getMessage()));
+        } catch (OperationApplicationException e) {
+            Log.e(TAG, String.format("操作应用异常: %s: %s", e.toString(), e.getMessage()));
+        }
+        return false;
+    }
+
+    /**
+     * 将单个便签移动到目标文件夹
+     * @param resolver 内容解析器
+     * @param id 便签ID
+     * @param srcFolderId 原文件夹ID
+     * @param desFolderId 目标文件夹ID
+     */
+    public static void moveNoteToFoler(ContentResolver resolver, long id, long srcFolderId, long desFolderId) {
+        ContentValues values = new ContentValues();
+        values.put(NoteColumns.PARENT_ID, desFolderId); // 更新父目录ID为目标文件夹
+        values.put(NoteColumns.ORIGIN_PARENT_ID, srcFolderId); // 记录原始文件夹ID
+        values.put(NoteColumns.LOCAL_MODIFIED, 1); // 标记本地已修改
+        // 执行更新操作
+        resolver.update(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id), values, null, null);
+    }
+
+    /**
+     * 批量移动便签到目标文件夹
+     * @param resolver 内容解析器
+     * @param ids 待移动的便签ID集合
+     * @param folderId 目标文件夹ID
+     * @return 操作成功返回true，失败返回false
+     */
+    public static boolean batchMoveToFolder(ContentResolver resolver, HashSet<Long> ids,
+                                            long folderId) {
+        if (ids == null) {
+            Log.d(TAG, "待移动的ID集合为null");
+            return true;
+        }
+
+        // 创建批量更新操作列表
+        ArrayList<ContentProviderOperation> operationList = new ArrayList<ContentProviderOperation>();
+        for (long id : ids) {
+            // 构建更新操作（修改父目录ID）
+            ContentProviderOperation.Builder builder = ContentProviderOperation
+                    .newUpdate(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id));
+            builder.withValue(NoteColumns.PARENT_ID, folderId);
+            builder.withValue(NoteColumns.LOCAL_MODIFIED, 1); // 标记本地修改
+            operationList.add(builder.build());
+        }
+
+        try {
+            // 执行批量更新
+            ContentProviderResult[] results = resolver.applyBatch(Notes.AUTHORITY, operationList);
+            if (results == null || results.length == 0 || results[0] == null) {
+                Log.d(TAG, "移动失败，ID集合:" + ids.toString());
+                return false;
+            }
+            return true;
+        } catch (RemoteException e) {
+            Log.e(TAG, String.format("远程异常: %s: %s", e.toString(), e.getMessage()));
+        } catch (OperationApplicationException e) {
+            Log.e(TAG, String.format("操作应用异常: %s: %s", e.toString(), e.getMessage()));
+        }
+        return false;
+    }
+
+    /**
+     * 获取用户创建的文件夹数量（排除系统文件夹如垃圾站）
+     * @param resolver 内容解析器
+     * @return 文件夹数量
+     */
+    public static int getUserFolderCount(ContentResolver resolver) {
+        // 查询非系统的文件夹且不在垃圾站中的文件夹数量
+        Cursor cursor =resolver.query(Notes.CONTENT_NOTE_URI,
+                new String[] { "COUNT(*)" }, // 统计数量
+                NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>?",
+                new String[] { String.valueOf(Notes.TYPE_FOLDER), String.valueOf(Notes.ID_TRASH_FOLER)},
+                null);
+
+        int count = 0;
+        if(cursor != null) {
+            if(cursor.moveToFirst()) {
+                try {
+                    count = cursor.getInt(0);
+                } catch (IndexOutOfBoundsException e) {
+                    Log.e(TAG, "获取文件夹数量失败:" + e.toString());
+                } finally {
+                    cursor.close();
+                }
+            }
+        }
+        return count;
+    }
+
+    /**
+     * 检查便签是否存在且可见（不在垃圾站中）
+     * @param resolver 内容解析器
+     * @param noteId 便签ID
+     * @param type 便签类型（如Notes.TYPE_NOTE）
+     * @return 存在且可见返回true，否则返回false
+     */
+    public static boolean visibleInNoteDatabase(ContentResolver resolver, long noteId, int type) {
+        Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId),
+                null,
+                NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER,
+                new String [] {String.valueOf(type)},
+                null);
+
+        boolean exist = false;
+        if (cursor != null) {
+            exist = cursor.getCount() > 0; // 游标有数据则存在
+            cursor.close();
+        }
+        return exist;
+    }
+
+    /**
+     * 检查便签是否存在（包括垃圾站中的便签）
+     * @param resolver 内容解析器
+     * @param noteId 便签ID
+     * @return 存在返回true，否则返回false
+     */
+    public static boolean existInNoteDatabase(ContentResolver resolver, long noteId) {
+        Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId),
+                null, null, null, null);
+
+        boolean exist = false;
+        if (cursor != null) {
+            exist = cursor.getCount() > 0;
+            cursor.close();
+        }
+        return exist;
+    }
+
+    /**
+     * 检查便签内容数据是否存在
+     * @param resolver 内容解析器
+     * @param dataId 内容数据ID
+     * @return 存在返回true，否则返回false
+     */
+    public static boolean existInDataDatabase(ContentResolver resolver, long dataId) {
+        Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, dataId),
+                null, null, null, null);
+
+        boolean exist = false;
+        if (cursor != null) {
+            exist = cursor.getCount() > 0;
+            cursor.close();
+        }
+        return exist;
+    }
+
+    /**
+     * 检查可见文件夹名称是否已存在（排除垃圾站）
+     * @param resolver 内容解析器
+     * @param name 文件夹名称
+     * @return 已存在返回true，否则返回false
+     */
+    public static boolean checkVisibleFolderName(ContentResolver resolver, String name) {
+        Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI, null,
+                NoteColumns.TYPE + "=" + Notes.TYPE_FOLDER +
+                        " AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER +
+                        " AND " + NoteColumns.SNIPPET + "=?", // SNIPPET字段存储文件夹名称
+                new String[] { name }, null);
+        boolean exist = false;
+        if(cursor != null) {
+            exist = cursor.getCount() > 0;
+            cursor.close();
+        }
+        return exist;
+    }
+
+    /**
+     * 获取文件夹下所有便签关联的桌面小部件属性
+     * @param resolver 内容解析器
+     * @param folderId 文件夹ID
+     * @return 小部件属性集合（包含widgetId和widgetType）
+     */
+    public static HashSet<AppWidgetAttribute> getFolderNoteWidget(ContentResolver resolver, long folderId) {
+        Cursor c = resolver.query(Notes.CONTENT_NOTE_URI,
+                new String[] { NoteColumns.WIDGET_ID, NoteColumns.WIDGET_TYPE }, // 查询小部件ID和类型
+                NoteColumns.PARENT_ID + "=?", // 筛选指定文件夹下的便签
+                new String[] { String.valueOf(folderId) },
+                null);
+
+        HashSet<AppWidgetAttribute> set = null;
+        if (c != null) {
+            if (c.moveToFirst()) {
+                set = new HashSet<AppWidgetAttribute>();
+                do {
+                    try {
+                        AppWidgetAttribute widget = new AppWidgetAttribute();
+                        widget.widgetId = c.getInt(0);
+                        widget.widgetType = c.getInt(1);
+                        set.add(widget);
+                    } catch (IndexOutOfBoundsException e) {
+                        Log.e(TAG, e.toString());
+                    }
+                } while (c.moveToNext());
+            }
+            c.close();
+        }
+        return set;
+    }
+
+    /**
+     * 通过便签ID获取关联的电话号码（用于通话便签）
+     * @param resolver 内容解析器
+     * @param noteId 通话便签ID
+     * @return 电话号码，获取失败返回空字符串
+     */
+    public static String getCallNumberByNoteId(ContentResolver resolver, long noteId) {
+        Cursor cursor = resolver.query(Notes.CONTENT_DATA_URI,
+                new String [] { CallNote.PHONE_NUMBER }, // 查询电话号码字段
+                CallNote.NOTE_ID + "=? AND " + CallNote.MIME_TYPE + "=?", // 筛选通话便签数据
+                new String [] { String.valueOf(noteId), CallNote.CONTENT_ITEM_TYPE },
+                null);
+
+        if (cursor != null && cursor.moveToFirst()) {
+            try {
+                return cursor.getString(0);
+            } catch (IndexOutOfBoundsException e) {
+                Log.e(TAG, "获取电话号码失败 " + e.toString());
+            } finally {
+                cursor.close();
+            }
+        }
+        return "";
+    }
+
+    /**
+     * 通过电话号码和通话时间查找对应的通话便签ID（避免重复创建）
+     * @param resolver 内容解析器
+     * @param phoneNumber 电话号码
+     * @param callDate 通话时间戳
+     * @return 便签ID，未找到返回0
+     */
+    public static long getNoteIdByPhoneNumberAndCallDate(ContentResolver resolver, String phoneNumber, long callDate) {
+        Cursor cursor = resolver.query(Notes.CONTENT_DATA_URI,
+                new String [] { CallNote.NOTE_ID }, // 查询关联的便签ID
+                CallNote.CALL_DATE + "=? AND " + CallNote.MIME_TYPE + "=? AND PHONE_NUMBERS_EQUAL("
+                        + CallNote.PHONE_NUMBER + ",?)", // 按通话时间和电话号码筛选（支持号码格式匹配）
+                new String [] { String.valueOf(callDate), CallNote.CONTENT_ITEM_TYPE, phoneNumber },
+                null);
+
+        if (cursor != null) {
+            if (cursor.moveToFirst()) {
+                try {
+                    return cursor.getLong(0);
+                } catch (IndexOutOfBoundsException e) {
+                    Log.e(TAG, "获取通话便签ID失败 " + e.toString());
+                }
+            }
+            cursor.close();
+        }
+        return 0;
+    }
+
+    /**
+     * 通过便签ID获取摘要文本（用于列表页展示）
+     * @param resolver 内容解析器
+     * @param noteId 便签ID
+     * @return 摘要文本，便签不存在则抛出异常
+     */
+    public static String getSnippetById(ContentResolver resolver, long noteId) {
+        Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI,
+                new String [] { NoteColumns.SNIPPET }, // 查询摘要字段
+                NoteColumns.ID + "=?",
+                new String [] { String.valueOf(noteId)},
+                null);
+
+        if (cursor != null) {
+            String snippet = "";
+            if (cursor.moveToFirst()) {
+                snippet = cursor.getString(0);
+            }
+            cursor.close();
+            return snippet;
+        }
+        throw new IllegalArgumentException("未找到ID为 " + noteId + " 的便签");
+    }
+
+    /**
+     * 格式化摘要文本（去除首尾空格，取首行内容）
+     * @param snippet 原始摘要文本
+     * @return 格式化后的摘要
+     */
+    public static String getFormattedSnippet(String snippet) {
+        if (snippet != null) {
+            snippet = snippet.trim(); // 去除首尾空格
+            int index = snippet.indexOf('\n'); // 查找第一个换行符
+            if (index != -1) {
+                snippet = snippet.substring(0, index); // 截取首行内容
+            }
+        }
+        return snippet;
+    }
+}

src/tool/GTaskStringUtils.java

@@ -0,0 +1,169 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package net.micode.notes.tool;
+
+/**
+ * GTask字符串常量工具类，定义小米便签与GTask（Google Tasks）同步过程中使用的所有标识符
+ * 包括JSON键名、文件夹标识、元数据键等，用于统一同步过程中的数据交互格式
+ */
+public class GTaskStringUtils {
+
+    // ========================== GTask JSON动作相关键名 ==========================
+    /** JSON中动作ID的键名，用于标识同步操作的唯一ID（如创建/更新任务的动作ID） */
+    public final static String GTASK_JSON_ACTION_ID = "action_id";
+
+    /** JSON中动作列表的键名，用于包装多个同步动作（如批量创建/更新任务） */
+    public final static String GTASK_JSON_ACTION_LIST = "action_list";
+
+    /** JSON中动作类型的键名，用于标识当前动作是创建/更新/移动等类型 */
+    public final static String GTASK_JSON_ACTION_TYPE = "action_type";
+
+    /** 动作类型：创建操作，用于标识在GTask中创建新任务或文件夹 */
+    public final static String GTASK_JSON_ACTION_TYPE_CREATE = "create";
+
+    /** 动作类型：获取全部数据，用于请求GTask中的所有任务和文件夹数据 */
+    public final static String GTASK_JSON_ACTION_TYPE_GETALL = "get_all";
+
+    /** 动作类型：移动操作，用于标识将任务/文件夹移动到新位置 */
+    public final static String GTASK_JSON_ACTION_TYPE_MOVE = "move";
+
+    /** 动作类型：更新操作，用于标识修改GTask中已有的任务或文件夹 */
+    public final static String GTASK_JSON_ACTION_TYPE_UPDATE = "update";
+
+
+    // ========================== GTask JSON实体属性相关键名 ==========================
+    /** JSON中创建者ID的键名，标识任务/文件夹的创建者（小米便签中暂用"null"） */
+    public final static String GTASK_JSON_CREATOR_ID = "creator_id";
+
+    /** JSON中子实体的键名，用于存储子任务信息 */
+    public final static String GTASK_JSON_CHILD_ENTITY = "child_entity";
+
+    /** JSON中客户端版本的键名，标识当前同步客户端的版本 */
+    public final static String GTASK_JSON_CLIENT_VERSION = "client_version";
+
+    /** JSON中任务完成状态的键名，标识任务是否已完成（true/false） */
+    public final static String GTASK_JSON_COMPLETED = "completed";
+
+    /** JSON中当前列表ID的键名，标识当前操作的任务列表ID */
+    public final static String GTASK_JSON_CURRENT_LIST_ID = "current_list_id";
+
+    /** JSON中默认列表ID的键名，标识GTask中的默认任务列表ID */
+    public final static String GTASK_JSON_DEFAULT_LIST_ID = "default_list_id";
+
+    /** JSON中删除状态的键名，标识任务/文件夹是否已删除（true/false） */
+    public final static String GTASK_JSON_DELETED = "deleted";
+
+    /** JSON中目标列表的键名，用于移动操作时指定目标列表 */
+    public final static String GTASK_JSON_DEST_LIST = "dest_list";
+
+    /** JSON中目标父节点的键名，用于移动操作时指定目标父节点 */
+    public final static String GTASK_JSON_DEST_PARENT = "dest_parent";
+
+    /** JSON中目标父节点类型的键名，标识目标父节点是任务（TASK）还是文件夹（GROUP） */
+    public final static String GTASK_JSON_DEST_PARENT_TYPE = "dest_parent_type";
+
+    /** JSON中实体增量的键名，用于存储任务/文件夹的修改内容（如名称、状态等） */
+    public final static String GTASK_JSON_ENTITY_DELTA = "entity_delta";
+
+    /** JSON中实体类型的键名，标识当前实体是任务（TASK）还是文件夹（GROUP） */
+    public final static String GTASK_JSON_ENTITY_TYPE = "entity_type";
+
+    /** JSON中获取已删除实体的键名，用于请求GTask中已删除的任务/文件夹 */
+    public final static String GTASK_JSON_GET_DELETED = "get_deleted";
+
+    /** JSON中实体ID的键名，标识任务/文件夹在GTask中的唯一ID */
+    public final static String GTASK_JSON_ID = "id";
+
+    /** JSON中排序索引的键名，标识任务/文件夹在列表中的位置（用于排序） */
+    public final static String GTASK_JSON_INDEX = "index";
+
+    /** JSON中最后修改时间的键名，标识任务/文件夹的最近修改时间（用于同步冲突判断） */
+    public final static String GTASK_JSON_LAST_MODIFIED = "last_modified";
+
+    /** JSON中最新同步点的键名，标识上次同步的时间点（用于增量同步） */
+    public final static String GTASK_JSON_LATEST_SYNC_POINT = "latest_sync_point";
+
+    /** JSON中列表ID的键名，标识当前任务所属的列表ID */
+    public final static String GTASK_JSON_LIST_ID = "list_id";
+
+    /** JSON中列表集合的键名，用于存储多个任务列表数据 */
+    public final static String GTASK_JSON_LISTS = "lists";
+
+    /** JSON中名称的键名，标识任务/文件夹的名称 */
+    public final static String GTASK_JSON_NAME = "name";
+
+    /** JSON中新ID的键名，用于标识创建操作后GTask返回的新实体ID */
+    public final static String GTASK_JSON_NEW_ID = "new_id";
+
+    /** JSON中备注的键名，标识任务的备注内容 */
+    public final static String GTASK_JSON_NOTES = "notes";
+
+    /** JSON中父节点ID的键名，标识当前实体的父节点ID（用于层级结构） */
+    public final static String GTASK_JSON_PARENT_ID = "parent_id";
+
+    /** JSON中前序兄弟节点ID的键名，标识当前实体的前一个兄弟节点（用于排序） */
+    public final static String GTASK_JSON_PRIOR_SIBLING_ID = "prior_sibling_id";
+
+    /** JSON中结果集合的键名，用于存储GTask返回的同步结果 */
+    public final static String GTASK_JSON_RESULTS = "results";
+
+    /** JSON中源列表的键名，用于移动操作时指定源列表 */
+    public final static String GTASK_JSON_SOURCE_LIST = "source_list";
+
+    /** JSON中任务集合的键名，用于存储多个任务数据 */
+    public final static String GTASK_JSON_TASKS = "tasks";
+
+    /** JSON中类型的键名，与ENTITY_TYPE配合使用 */
+    public final static String GTASK_JSON_TYPE = "type";
+
+    /** 实体类型：文件夹（分组），标识当前实体是GTask中的文件夹 */
+    public final static String GTASK_JSON_TYPE_GROUP = "GROUP";
+
+    /** 实体类型：任务，标识当前实体是GTask中的任务 */
+    public final static String GTASK_JSON_TYPE_TASK = "TASK";
+
+    /** JSON中用户信息的键名，标识当前同步的用户 */
+    public final static String GTASK_JSON_USER = "user";
+
+
+    // ========================== 小米便签专属文件夹标识 ==========================
+    /** 小米便签文件夹前缀，用于在GTask中区分小米便签创建的文件夹（避免与其他应用冲突） */
+    public final static String MIUI_FOLDER_PREFFIX = "[MIUI_Notes]";
+
+    /** 小米便签默认文件夹名称，拼接前缀后为"[MIUI_Notes]Default" */
+    public final static String FOLDER_DEFAULT = "Default";
+
+    /** 小米便签通话记录文件夹名称，拼接前缀后为"[MIUI_Notes]Call_Note" */
+    public final static String FOLDER_CALL_NOTE = "Call_Note";
+
+    /** 小米便签元数据文件夹名称，用于存储便签的额外信息（如本地ID、附件信息等） */
+    public final static String FOLDER_META = "METADATA";
+
+
+    // ========================== 元数据相关键名 ==========================
+    /** 元数据中GTask ID的键名，用于存储实体在GTask中的ID */
+    public final static String META_HEAD_GTASK_ID = "meta_gid";
+
+    /** 元数据中便签信息的键名，用于存储便签的核心信息（如ID、类型等） */
+    public final static String META_HEAD_NOTE = "meta_note";
+
+    /** 元数据中数据列表的键名，用于存储便签的内容数据（如文本、附件路径等） */
+    public final static String META_HEAD_DATA = "meta_data";
+
+    /** 元数据便签的名称，标识该便签为元数据（禁止用户修改或删除） */
+    public final static String META_NOTE_NAME = "[META INFO] DON'T UPDATE AND DELETE";
+
+}

src/tool/ResourceParser.java

@@ -0,0 +1,272 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.tool;
+
+import android.content.Context;
+import android.preference.PreferenceManager;
+
+import net.micode.notes.R;
+import net.micode.notes.ui.NotesPreferenceActivity;
+
+/**
+ * 资源解析器：统一管理便签应用中的各类资源（背景、文字样式等）
+ * 提供资源获取接口，实现样式资源与业务逻辑的解耦
+ */
+public class ResourceParser {
+
+    // 背景颜色常量定义（用于标识不同颜色主题）
+    public static final int YELLOW           = 0;   // 黄色背景
+    public static final int BLUE             = 1;   // 蓝色背景
+    public static final int WHITE            = 2;   // 白色背景
+    public static final int GREEN            = 3;   // 绿色背景
+    public static final int RED              = 4;   // 红色背景
+
+    public static final int BG_DEFAULT_COLOR = YELLOW;  // 默认背景颜色（黄色）
+
+    // 字体大小常量定义
+    public static final int TEXT_SMALL       = 0;   // 小字体
+    public static final int TEXT_MEDIUM      = 1;   // 中字体（默认）
+    public static final int TEXT_LARGE       = 2;   // 大字体
+    public static final int TEXT_SUPER       = 3;   // 超大字体
+
+    public static final int BG_DEFAULT_FONT_SIZE = TEXT_MEDIUM;  // 默认字体大小
+
+    /**
+     * 便签编辑页背景资源管理
+     * 提供编辑页主体背景和标题栏背景的资源获取
+     */
+    public static class NoteBgResources {
+        // 编辑页主体背景资源数组（与颜色常量顺序对应）
+        private final static int [] BG_EDIT_RESOURCES = new int [] {
+                R.drawable.edit_yellow,    // 黄色背景
+                R.drawable.edit_blue,      // 蓝色背景
+                R.drawable.edit_white,     // 白色背景
+                R.drawable.edit_green,     // 绿色背景
+                R.drawable.edit_red        // 红色背景
+        };
+
+        // 编辑页标题栏背景资源数组（与颜色常量顺序对应）
+        private final static int [] BG_EDIT_TITLE_RESOURCES = new int [] {
+                R.drawable.edit_title_yellow,  // 黄色标题栏
+                R.drawable.edit_title_blue,    // 蓝色标题栏
+                R.drawable.edit_title_white,   // 白色标题栏
+                R.drawable.edit_title_green,   // 绿色标题栏
+                R.drawable.edit_title_red      // 红色标题栏
+        };
+
+        /**
+         * 获取便签编辑页主体背景资源
+         * @param id 颜色标识（如YELLOW、BLUE等）
+         * @return 背景图片资源ID
+         */
+        public static int getNoteBgResource(int id) {
+            return BG_EDIT_RESOURCES[id];
+        }
+
+        /**
+         * 获取便签编辑页标题栏背景资源
+         * @param id 颜色标识（如YELLOW、BLUE等）
+         * @return 标题栏背景图片资源ID
+         */
+        public static int getNoteTitleBgResource(int id) {
+            return BG_EDIT_TITLE_RESOURCES[id];
+        }
+    }
+
+    /**
+     * 获取默认背景颜色ID
+     * 根据用户设置判断：若开启随机背景，则返回随机颜色；否则返回默认黄色
+     * @param context 上下文
+     * @return 背景颜色标识
+     */
+    public static int getDefaultBgId(Context context) {
+        if (PreferenceManager.getDefaultSharedPreferences(context).getBoolean(
+                NotesPreferenceActivity.PREFERENCE_SET_BG_COLOR_KEY, false)) {
+            // 随机选择背景颜色（0到背景资源数量-1之间）
+            return (int) (Math.random() * NoteBgResources.BG_EDIT_RESOURCES.length);
+        } else {
+            // 返回默认背景色
+            return BG_DEFAULT_COLOR;
+        }
+    }
+
+    /**
+     * 便签列表项背景资源管理
+     * 针对列表中不同位置的项（首项、中间项、末项、唯一项）提供对应的背景资源
+     */
+    public static class NoteItemBgResources {
+        // 列表首项背景资源数组
+        private final static int [] BG_FIRST_RESOURCES = new int [] {
+                R.drawable.list_yellow_up,    // 黄色首项
+                R.drawable.list_blue_up,      // 蓝色首项
+                R.drawable.list_white_up,     // 白色首项
+                R.drawable.list_green_up,     // 绿色首项
+                R.drawable.list_red_up        // 红色首项
+        };
+
+        // 列表中间项背景资源数组
+        private final static int [] BG_NORMAL_RESOURCES = new int [] {
+                R.drawable.list_yellow_middle,  // 黄色中间项
+                R.drawable.list_blue_middle,    // 蓝色中间项
+                R.drawable.list_white_middle,   // 白色中间项
+                R.drawable.list_green_middle,   // 绿色中间项
+                R.drawable.list_red_middle      // 红色中间项
+        };
+
+        // 列表末项背景资源数组
+        private final static int [] BG_LAST_RESOURCES = new int [] {
+                R.drawable.list_yellow_down,   // 黄色末项
+                R.drawable.list_blue_down,     // 蓝色末项
+                R.drawable.list_white_down,    // 白色末项
+                R.drawable.list_green_down,    // 绿色末项
+                R.drawable.list_red_down,      // 红色末项
+        };
+
+        // 列表唯一项（仅一项时）背景资源数组
+        private final static int [] BG_SINGLE_RESOURCES = new int [] {
+                R.drawable.list_yellow_single,  // 黄色唯一项
+                R.drawable.list_blue_single,    // 蓝色唯一项
+                R.drawable.list_white_single,   // 白色唯一项
+                R.drawable.list_green_single,   // 绿色唯一项
+                R.drawable.list_red_single      // 红色唯一项
+        };
+
+        /**
+         * 获取列表首项背景资源
+         * @param id 颜色标识
+         * @return 首项背景资源ID
+         */
+        public static int getNoteBgFirstRes(int id) {
+            return BG_FIRST_RESOURCES[id];
+        }
+
+        /**
+         * 获取列表末项背景资源
+         * @param id 颜色标识
+         * @return 末项背景资源ID
+         */
+        public static int getNoteBgLastRes(int id) {
+            return BG_LAST_RESOURCES[id];
+        }
+
+        /**
+         * 获取列表唯一项背景资源
+         * @param id 颜色标识
+         * @return 唯一项背景资源ID
+         */
+        public static int getNoteBgSingleRes(int id) {
+            return BG_SINGLE_RESOURCES[id];
+        }
+
+        /**
+         * 获取列表中间项背景资源
+         * @param id 颜色标识
+         * @return 中间项背景资源ID
+         */
+        public static int getNoteBgNormalRes(int id) {
+            return BG_NORMAL_RESOURCES[id];
+        }
+
+        /**
+         * 获取文件夹项背景资源
+         * @return 文件夹背景资源ID
+         */
+        public static int getFolderBgRes() {
+            return R.drawable.list_folder;
+        }
+    }
+
+    /**
+     * 桌面小部件（Widget）背景资源管理
+     * 提供不同尺寸Widget的背景资源
+     */
+    public static class WidgetBgResources {
+        // 2x尺寸Widget背景资源数组
+        private final static int [] BG_2X_RESOURCES = new int [] {
+                R.drawable.widget_2x_yellow,   // 2x黄色Widget
+                R.drawable.widget_2x_blue,     // 2x蓝色Widget
+                R.drawable.widget_2x_white,    // 2x白色Widget
+                R.drawable.widget_2x_green,    // 2x绿色Widget
+                R.drawable.widget_2x_red,      // 2x红色Widget
+        };
+
+        /**
+         * 获取2x尺寸Widget背景资源
+         * @param id 颜色标识
+         * @return 2x Widget背景资源ID
+         */
+        public static int getWidget2xBgResource(int id) {
+            return BG_2X_RESOURCES[id];
+        }
+
+        // 4x尺寸Widget背景资源数组
+        private final static int [] BG_4X_RESOURCES = new int [] {
+                R.drawable.widget_4x_yellow,   // 4x黄色Widget
+                R.drawable.widget_4x_blue,     // 4x蓝色Widget
+                R.drawable.widget_4x_white,    // 4x白色Widget
+                R.drawable.widget_4x_green,    // 4x绿色Widget
+                R.drawable.widget_4x_red       // 4x红色Widget
+        };
+
+        /**
+         * 获取4x尺寸Widget背景资源
+         * @param id 颜色标识
+         * @return 4x Widget背景资源ID
+         */
+        public static int getWidget4xBgResource(int id) {
+            return BG_4X_RESOURCES[id];
+        }
+    }
+
+    /**
+     * 文字样式资源管理
+     * 提供不同字体大小的样式资源
+     */
+    public static class TextAppearanceResources {
+        // 文字样式资源数组（与字体大小常量顺序对应）
+        private final static int [] TEXTAPPEARANCE_RESOURCES = new int [] {
+                R.style.TextAppearanceNormal,   // 小字体样式
+                R.style.TextAppearanceMedium,   // 中字体样式
+                R.style.TextAppearanceLarge,    // 大字体样式
+                R.style.TextAppearanceSuper     // 超大字体样式
+        };
+
+        /**
+         * 获取文字样式资源
+         * @param id 字体大小标识（如TEXT_SMALL、TEXT_MEDIUM等）
+         * @return 文字样式资源ID（若id无效则返回默认样式）
+         */
+        public static int getTexAppearanceResource(int id) {
+            /**
+             * 兼容处理：防止存储的资源ID超出范围
+             * 若id无效，返回默认字体大小样式
+             */
+            if (id >= TEXTAPPEARANCE_RESOURCES.length) {
+                return BG_DEFAULT_FONT_SIZE;
+            }
+            return TEXTAPPEARANCE_RESOURCES[id];
+        }
+
+        /**
+         * 获取文字样式资源数量
+         * @return 样式资源数组长度
+         */
+        public static int getResourcesSize() {
+            return TEXTAPPEARANCE_RESOURCES.length;
+        }
+    }
+}

src/ui/AlarmAlertActivity.java

@@ -0,0 +1,203 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.ui;
+
+import android.app.Activity;
+import android.app.AlertDialog;
+import android.content.Context;
+import android.content.DialogInterface;
+import android.content.DialogInterface.OnClickListener;
+import android.content.DialogInterface.OnDismissListener;
+import android.content.Intent;
+import android.media.AudioManager;
+import android.media.MediaPlayer;
+import android.media.RingtoneManager;
+import android.net.Uri;
+import android.os.Bundle;
+import android.os.PowerManager;
+import android.provider.Settings;
+import android.view.Window;
+import android.view.WindowManager;
+
+import net.micode.notes.R;
+import net.micode.notes.data.Notes;
+import net.micode.notes.tool.DataUtils;
+
+import java.io.IOException;
+
+
+/**
+ * 便签提醒活动页，负责在便签提醒时间到达时显示提醒对话框并播放闹钟声音
+ * 实现对话框按钮点击监听和对话框消失监听，处理用户操作
+ */
+public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener {
+    // 提醒的便签ID
+    private long mNoteId;
+    // 便签内容摘要（用于提醒对话框展示）
+    private String mSnippet;
+    // 摘要最大显示长度（超出部分用省略号处理）
+    private static final int SNIPPET_PREW_MAX_LEN = 60;
+    // 媒体播放器，用于播放闹钟声音
+    MediaPlayer mPlayer;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        // 去除标题栏
+        requestWindowFeature(Window.FEATURE_NO_TITLE);
+
+        final Window win = getWindow();
+        // 允许在锁屏时显示窗口
+        win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED);
+
+        // 如果屏幕处于关闭状态，添加额外窗口标志：保持屏幕常亮、点亮屏幕、允许锁屏时显示、布局适配
+        if (!isScreenOn()) {
+            win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON
+                    | WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON
+                    | WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON
+                    | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR);
+        }
+
+        // 获取启动当前Activity的Intent（由AlarmReceiver传递）
+        Intent intent = getIntent();
+
+        try {
+            // 从Intent的Data中解析便签ID（Data格式为content://.../notes/{id}，取路径的第2段）
+            mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));
+            // 通过便签ID获取内容摘要（用于提醒展示）
+            mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId);
+            // 处理摘要长度：超过最大长度时截断并添加省略提示
+            mSnippet = mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet.substring(0,
+                    SNIPPET_PREW_MAX_LEN) + getResources().getString(R.string.notelist_string_info)
+                    : mSnippet;
+        } catch (IllegalArgumentException e) {
+            e.printStackTrace();
+            return;
+        }
+
+        // 初始化媒体播放器
+        mPlayer = new MediaPlayer();
+        // 检查便签是否存在且可见（未被删除）
+        if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
+            // 显示提醒对话框
+            showActionDialog();
+            // 播放闹钟声音
+            playAlarmSound();
+        } else {
+            // 便签不存在则直接结束活动
+            finish();
+        }
+    }
+
+    /**
+     * 判断屏幕是否处于亮屏状态
+     * @return 屏幕亮着返回true，否则返回false
+     */
+    private boolean isScreenOn() {
+        PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
+        return pm.isScreenOn();
+    }
+
+    /**
+     * 播放系统默认闹钟铃声，设置为循环播放
+     */
+    private void playAlarmSound() {
+        // 获取系统默认闹钟铃声的Uri
+        Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);
+
+        // 获取系统静音模式影响的音频流（判断闹钟是否被静音）
+        int silentModeStreams = Settings.System.getInt(getContentResolver(),
+                Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0);
+
+        // 设置媒体播放器的音频流类型：若闹钟流被静音模式影响，则使用该流；否则默认使用闹钟流
+        if ((silentModeStreams & (1 << AudioManager.STREAM_ALARM)) != 0) {
+            mPlayer.setAudioStreamType(silentModeStreams);
+        } else {
+            mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM);
+        }
+
+        try {
+            // 设置铃声数据源并准备播放
+            mPlayer.setDataSource(this, url);
+            mPlayer.prepare();
+            // 设置为循环播放（直到用户操作停止）
+            mPlayer.setLooping(true);
+            mPlayer.start();
+        } catch (IllegalArgumentException | SecurityException | IllegalStateException | IOException e) {
+            e.printStackTrace();
+        }
+    }
+
+    /**
+     * 显示提醒对话框，展示便签摘要，提供操作按钮
+     */
+    private void showActionDialog() {
+        AlertDialog.Builder dialog = new AlertDialog.Builder(this);
+        // 设置对话框标题为应用名称（小米便签）
+        dialog.setTitle(R.string.app_name);
+        // 显示便签摘要内容
+        dialog.setMessage(mSnippet);
+        // 确定按钮：关闭提醒（默认行为）
+        dialog.setPositiveButton(R.string.notealert_ok, this);
+        // 若屏幕亮着，添加“进入”按钮（跳转到便签编辑页）
+        if (isScreenOn()) {
+            dialog.setNegativeButton(R.string.notealert_enter, this);
+        }
+        // 显示对话框，并设置消失监听（用于停止铃声）
+        dialog.show().setOnDismissListener(this);
+    }
+
+    /**
+     * 处理对话框按钮点击事件
+     * @param dialog 对话框实例
+     * @param which 点击的按钮标识（BUTTON_POSITIVE/BUTTON_NEGATIVE）
+     */
+    public void onClick(DialogInterface dialog, int which) {
+        switch (which) {
+            // 点击“进入”按钮：跳转到便签编辑页查看完整内容
+            case DialogInterface.BUTTON_NEGATIVE:
+                Intent intent = new Intent(this, NoteEditActivity.class);
+                intent.setAction(Intent.ACTION_VIEW); // 动作：查看便签
+                intent.putExtra(Intent.EXTRA_UID, mNoteId); // 传递便签ID
+                startActivity(intent);
+                break;
+            // 点击“确定”按钮：默认不做额外操作，对话框消失后会停止铃声并结束活动
+            default:
+                break;
+        }
+    }
+
+    /**
+     * 对话框消失时触发：停止铃声并结束活动
+     * @param dialog 对话框实例
+     */
+    public void onDismiss(DialogInterface dialog) {
+        stopAlarmSound();
+        finish();
+    }
+
+    /**
+     * 停止闹钟铃声并释放媒体播放器资源
+     */
+    private void stopAlarmSound() {
+        if (mPlayer != null) {
+            mPlayer.stop(); // 停止播放
+            mPlayer.release(); // 释放资源
+            mPlayer = null;
+        }
+    }
+}

src/ui/AlarmInitReceiver.java

@@ -0,0 +1,100 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.ui;
+
+import android.app.AlarmManager;
+import android.app.PendingIntent;
+import android.content.BroadcastReceiver;
+import android.content.ContentUris;
+import android.content.Context;
+import android.content.Intent;
+import android.database.Cursor;
+
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.NoteColumns;
+
+/**
+ * 便签提醒初始化接收器
+ * 用于在系统启动或特定事件触发时，重新注册所有未过期的便签提醒闹钟
+ * 确保用户设置的便签提醒不会因系统重启等原因丢失
+ */
+public class AlarmInitReceiver extends BroadcastReceiver {
+
+    /**
+     * 数据库查询字段投影：只查询便签ID和提醒时间
+     * 优化查询效率，避免获取不必要的字段
+     */
+    private static final String [] PROJECTION = new String [] {
+            NoteColumns.ID,             // 便签ID
+            NoteColumns.ALERTED_DATE    // 提醒时间戳
+    };
+
+    // 字段索引常量，用于快速访问Cursor中的数据
+    private static final int COLUMN_ID                = 0;       // 便签ID在投影中的索引
+    private static final int COLUMN_ALERTED_DATE      = 1;       // 提醒时间在投影中的索引
+
+    /**
+     * 接收广播时触发的回调方法
+     * 负责查询所有未过期的便签提醒，并重新注册到AlarmManager
+     * @param context 上下文对象
+     * @param intent 接收到的广播意图
+     */
+    @Override
+    public void onReceive(Context context, Intent intent) {
+        // 获取当前系统时间，用于筛选未过期的提醒
+        long currentDate = System.currentTimeMillis();
+
+        // 查询数据库中所有未过期的便签提醒
+        // 条件：提醒时间 > 当前时间 且 便签类型为普通便签（TYPE_NOTE）
+        Cursor c = context.getContentResolver().query(
+                Notes.CONTENT_NOTE_URI,       // 查询的内容URI（指向便签表）
+                PROJECTION,                   // 需要查询的字段
+                NoteColumns.ALERTED_DATE + ">? AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE,
+                new String[] { String.valueOf(currentDate) },  // 筛选条件参数（当前时间）
+                null                          // 排序方式（无需排序）
+        );
+
+        if (c != null) {
+            // 遍历查询结果，为每个未过期的提醒注册闹钟
+            if (c.moveToFirst()) {
+                do {
+                    // 获取便签的提醒时间
+                    long alertDate = c.getLong(COLUMN_ALERTED_DATE);
+                    // 创建触发提醒时的意图（指向AlarmReceiver）
+                    Intent sender = new Intent(context, AlarmReceiver.class);
+                    // 为意图附加便签ID，便于后续定位具体便签
+                    sender.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI,
+                            c.getLong(COLUMN_ID)));
+
+                    // 创建延迟执行的PendingIntent（用于触发提醒）
+                    PendingIntent pendingIntent = PendingIntent.getBroadcast(
+                            context, 0, sender, 0);
+
+                    // 获取AlarmManager服务，用于设置系统闹钟
+                    AlarmManager alermManager = (AlarmManager) context
+                            .getSystemService(Context.ALARM_SERVICE);
+
+                    // 注册闹钟：在指定时间（alertDate）唤醒设备并发送广播
+                    // RTC_WAKEUP模式确保在设备休眠时也能触发
+                    alermManager.set(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent);
+                } while (c.moveToNext());  // 继续处理下一个便签
+            }
+            // 关闭Cursor，释放资源
+            c.close();
+        }
+    }
+}

src/ui/AlarmReceiver.java

@@ -0,0 +1,46 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.ui;
+
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+
+/**
+ * 便签提醒广播接收器，负责接收系统闹钟触发的广播，并启动提醒展示界面
+ * 是小米便签提醒流程中连接闹钟触发与提醒展示的中间组件
+ */
+public class AlarmReceiver extends BroadcastReceiver {
+    /**
+     * 接收广播时触发的回调方法
+     * @param context 上下文环境，用于启动Activity
+     * @param intent 接收到的意图，包含触发提醒的便签信息（如便签ID）
+     */
+    @Override
+    public void onReceive(Context context, Intent intent) {
+        // 将意图的目标组件设置为AlarmAlertActivity（便签提醒展示界面）
+        // 确保广播中携带的便签信息（如Data中的便签ID）被传递给目标界面
+        intent.setClass(context, AlarmAlertActivity.class);
+
+        // 添加FLAG_ACTIVITY_NEW_TASK标志：在BroadcastReceiver中启动Activity必须设置此标志
+        // 因为BroadcastReceiver本身没有任务栈，需要为启动的Activity创建新任务栈
+        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+
+        // 启动AlarmAlertActivity，展示便签提醒对话框并播放铃声
+        context.startActivity(intent);
+    }
+}

src/ui/DateTimePicker.java

@@ -0,0 +1,576 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.ui;
+
+import java.text.DateFormatSymbols;
+import java.util.Calendar;
+
+import net.micode.notes.R;
+
+
+import android.content.Context;
+import android.text.format.DateFormat;
+import android.view.View;
+import android.widget.FrameLayout;
+import android.widget.NumberPicker;
+
+/**
+ * 日期时间选择器组件
+ * 用于小米便签中设置提醒时间，支持日期、小时、分钟的选择，以及12/24小时制切换
+ */
+public class DateTimePicker extends FrameLayout {
+
+    // 默认启用状态
+    private static final boolean DEFAULT_ENABLE_STATE = true;
+
+    // 时间计算常量定义
+    private static final int HOURS_IN_HALF_DAY = 12;         // 半天的小时数
+    private static final int HOURS_IN_ALL_DAY = 24;          // 一天的小时数
+    private static final int DAYS_IN_ALL_WEEK = 7;           // 一周的天数
+    private static final int DATE_SPINNER_MIN_VAL = 0;       // 日期选择器最小值
+    private static final int DATE_SPINNER_MAX_VAL = DAYS_IN_ALL_WEEK - 1; // 日期选择器最大值
+    private static final int HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW = 0;       // 24小时制小时最小值
+    private static final int HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW = 23;      // 24小时制小时最大值
+    private static final int HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW = 1;       // 12小时制小时最小值
+    private static final int HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW = 12;      // 12小时制小时最大值
+    private static final int MINUT_SPINNER_MIN_VAL = 0;       // 分钟选择器最小值
+    private static final int MINUT_SPINNER_MAX_VAL = 59;      // 分钟选择器最大值
+    private static final int AMPM_SPINNER_MIN_VAL = 0;        // 上下午选择器最小值
+    private static final int AMPM_SPINNER_MAX_VAL = 1;        // 上下午选择器最大值
+
+    // 选择器组件
+    private final NumberPicker mDateSpinner;     // 日期选择器（显示近一周日期）
+    private final NumberPicker mHourSpinner;     // 小时选择器
+    private final NumberPicker mMinuteSpinner;   // 分钟选择器
+    private final NumberPicker mAmPmSpinner;     // 上下午选择器（12小时制用）
+    private Calendar mDate;                      // 日期时间计算工具
+
+    // 日期显示值数组（存储近一周的日期文本）
+    private String[] mDateDisplayValues = new String[DAYS_IN_ALL_WEEK];
+
+    // 时间状态变量
+    private boolean mIsAm;           // 是否为上午（12小时制）
+    private boolean mIs24HourView;   // 是否为24小时制显示
+    private boolean mIsEnabled = DEFAULT_ENABLE_STATE; // 组件是否启用
+    private boolean mInitialising;   // 是否处于初始化状态
+
+    // 日期时间变更监听器
+    private OnDateTimeChangedListener mOnDateTimeChangedListener;
+
+    /**
+     * 日期选择器值变化监听器
+     * 当用户选择不同日期时，更新日期并触发时间变更事件
+     */
+    private NumberPicker.OnValueChangeListener mOnDateChangedListener = new NumberPicker.OnValueChangeListener() {
+        @Override
+        public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
+            // 计算日期偏移量并更新
+            mDate.add(Calendar.DAY_OF_YEAR, newVal - oldVal);
+            updateDateControl();
+            onDateTimeChanged();
+        }
+    };
+
+    /**
+     * 小时选择器值变化监听器
+     * 处理小时变更逻辑，包括跨天情况（如23点到0点）和12/24小时制转换
+     */
+    private NumberPicker.OnValueChangeListener mOnHourChangedListener = new NumberPicker.OnValueChangeListener() {
+        @Override
+        public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
+            boolean isDateChanged = false;
+            Calendar cal = Calendar.getInstance();
+
+            if (!mIs24HourView) {
+                // 12小时制处理：跨天情况（如11PM到12AM需加一天，12AM到11PM需减一天）
+                if (!mIsAm && oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY) {
+                    cal.setTimeInMillis(mDate.getTimeInMillis());
+                    cal.add(Calendar.DAY_OF_YEAR, 1);
+                    isDateChanged = true;
+                } else if (mIsAm && oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) {
+                    cal.setTimeInMillis(mDate.getTimeInMillis());
+                    cal.add(Calendar.DAY_OF_YEAR, -1);
+                    isDateChanged = true;
+                }
+                // 12点和11点切换时，切换上下午状态
+                if (oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY ||
+                        oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) {
+                    mIsAm = !mIsAm;
+                    updateAmPmControl();
+                }
+            } else {
+                // 24小时制处理：跨天情况（如23点到0点加一天，0点到23点减一天）
+                if (oldVal == HOURS_IN_ALL_DAY - 1 && newVal == 0) {
+                    cal.setTimeInMillis(mDate.getTimeInMillis());
+                    cal.add(Calendar.DAY_OF_YEAR, 1);
+                    isDateChanged = true;
+                } else if (oldVal == 0 && newVal == HOURS_IN_ALL_DAY - 1) {
+                    cal.setTimeInMillis(mDate.getTimeInMillis());
+                    cal.add(Calendar.DAY_OF_YEAR, -1);
+                    isDateChanged = true;
+                }
+            }
+
+            // 更新小时并触发事件
+            int newHour = mHourSpinner.getValue() % HOURS_IN_HALF_DAY + (mIsAm ? 0 : HOURS_IN_HALF_DAY);
+            mDate.set(Calendar.HOUR_OF_DAY, newHour);
+            onDateTimeChanged();
+
+            // 若日期变更，同步更新年月日
+            if (isDateChanged) {
+                setCurrentYear(cal.get(Calendar.YEAR));
+                setCurrentMonth(cal.get(Calendar.MONTH));
+                setCurrentDay(cal.get(Calendar.DAY_OF_MONTH));
+            }
+        }
+    };
+
+    /**
+     * 分钟选择器值变化监听器
+     * 处理分钟变更逻辑，包括跨小时情况（如59分到0分需加1小时）
+     */
+    private NumberPicker.OnValueChangeListener mOnMinuteChangedListener = new NumberPicker.OnValueChangeListener() {
+        @Override
+        public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
+            int minValue = mMinuteSpinner.getMinValue();
+            int maxValue = mMinuteSpinner.getMaxValue();
+            int offset = 0;
+
+            // 判断是否跨小时（59->0加1小时，0->59减1小时）
+            if (oldVal == maxValue && newVal == minValue) {
+                offset += 1;
+            } else if (oldVal == minValue && newVal == maxValue) {
+                offset -= 1;
+            }
+
+            if (offset != 0) {
+                // 调整小时并更新相关控件
+                mDate.add(Calendar.HOUR_OF_DAY, offset);
+                mHourSpinner.setValue(getCurrentHour());
+                updateDateControl();
+
+                // 更新上下午状态（12小时制）
+                int newHour = getCurrentHourOfDay();
+                if (newHour >= HOURS_IN_HALF_DAY) {
+                    mIsAm = false;
+                } else {
+                    mIsAm = true;
+                }
+                updateAmPmControl();
+            }
+
+            // 更新分钟并触发事件
+            mDate.set(Calendar.MINUTE, newVal);
+            onDateTimeChanged();
+        }
+    };
+
+    /**
+     * 上下午选择器值变化监听器
+     * 切换上午/下午状态，并调整小时（加减12小时）
+     */
+    private NumberPicker.OnValueChangeListener mOnAmPmChangedListener = new NumberPicker.OnValueChangeListener() {
+        @Override
+        public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
+            mIsAm = !mIsAm;
+            // 切换上下午时调整小时（上午转下午加12小时，反之减12小时）
+            if (mIsAm) {
+                mDate.add(Calendar.HOUR_OF_DAY, -HOURS_IN_HALF_DAY);
+            } else {
+                mDate.add(Calendar.HOUR_OF_DAY, HOURS_IN_HALF_DAY);
+            }
+            updateAmPmControl();
+            onDateTimeChanged();
+        }
+    };
+
+    /**
+     * 日期时间变更监听器接口
+     * 当用户修改日期或时间时回调
+     */
+    public interface OnDateTimeChangedListener {
+        void onDateTimeChanged(DateTimePicker view, int year, int month,
+                               int dayOfMonth, int hourOfDay, int minute);
+    }
+
+    /**
+     * 构造方法：使用当前时间初始化，默认使用系统时间格式（12/24小时制）
+     * @param context 上下文
+     */
+    public DateTimePicker(Context context) {
+        this(context, System.currentTimeMillis());
+    }
+
+    /**
+     * 构造方法：使用指定时间初始化，默认使用系统时间格式（12/24小时制）
+     * @param context 上下文
+     * @param date 初始化时间戳（毫秒）
+     */
+    public DateTimePicker(Context context, long date) {
+        this(context, date, DateFormat.is24HourFormat(context));
+    }
+
+    /**
+     * 构造方法：使用指定时间和时间格式初始化
+     * @param context 上下文
+     * @param date 初始化时间戳（毫秒）
+     * @param is24HourView 是否使用24小时制
+     */
+    public DateTimePicker(Context context, long date, boolean is24HourView) {
+        super(context);
+        mDate = Calendar.getInstance();
+        mInitialising = true;
+        mIsAm = getCurrentHourOfDay() >= HOURS_IN_HALF_DAY; // 初始化上下午状态
+
+        // 加载布局
+        inflate(context, R.layout.datetime_picker, this);
+
+        // 初始化日期选择器
+        mDateSpinner = (NumberPicker) findViewById(R.id.date);
+        mDateSpinner.setMinValue(DATE_SPINNER_MIN_VAL);
+        mDateSpinner.setMaxValue(DATE_SPINNER_MAX_VAL);
+        mDateSpinner.setOnValueChangedListener(mOnDateChangedListener);
+
+        // 初始化小时选择器
+        mHourSpinner = (NumberPicker) findViewById(R.id.hour);
+        mHourSpinner.setOnValueChangedListener(mOnHourChangedListener);
+
+        // 初始化分钟选择器
+        mMinuteSpinner =  (NumberPicker) findViewById(R.id.minute);
+        mMinuteSpinner.setMinValue(MINUT_SPINNER_MIN_VAL);
+        mMinuteSpinner.setMaxValue(MINUT_SPINNER_MAX_VAL);
+        mMinuteSpinner.setOnLongPressUpdateInterval(100); // 长按更新间隔（毫秒）
+        mMinuteSpinner.setOnValueChangedListener(mOnMinuteChangedListener);
+
+        // 初始化上下午选择器（使用系统本地化的AM/PM文本）
+        String[] stringsForAmPm = new DateFormatSymbols().getAmPmStrings();
+        mAmPmSpinner = (NumberPicker) findViewById(R.id.amPm);
+        mAmPmSpinner.setMinValue(AMPM_SPINNER_MIN_VAL);
+        mAmPmSpinner.setMaxValue(AMPM_SPINNER_MAX_VAL);
+        mAmPmSpinner.setDisplayedValues(stringsForAmPm);
+        mAmPmSpinner.setOnValueChangedListener(mOnAmPmChangedListener);
+
+        // 更新控件到初始状态
+        updateDateControl();
+        updateHourControl();
+        updateAmPmControl();
+
+        // 设置时间格式（12/24小时制）
+        set24HourView(is24HourView);
+
+        // 设置初始时间
+        setCurrentDate(date);
+
+        // 设置启用状态
+        setEnabled(isEnabled());
+
+        // 初始化完成
+        mInitialising = false;
+    }
+
+    /**
+     * 设置组件启用状态
+     * @param enabled 是否启用
+     */
+    @Override
+    public void setEnabled(boolean enabled) {
+        if (mIsEnabled == enabled) {
+            return;
+        }
+        super.setEnabled(enabled);
+        mDateSpinner.setEnabled(enabled);
+        mMinuteSpinner.setEnabled(enabled);
+        mHourSpinner.setEnabled(enabled);
+        mAmPmSpinner.setEnabled(enabled);
+        mIsEnabled = enabled;
+    }
+
+    /**
+     * 获取组件启用状态
+     * @return 是否启用
+     */
+    @Override
+    public boolean isEnabled() {
+        return mIsEnabled;
+    }
+
+    /**
+     * 获取当前选中的日期时间（毫秒时间戳）
+     * @return 时间戳
+     */
+    public long getCurrentDateInTimeMillis() {
+        return mDate.getTimeInMillis();
+    }
+
+    /**
+     * 设置当前日期时间（通过时间戳）
+     * @param date 时间戳（毫秒）
+     */
+    public void setCurrentDate(long date) {
+        Calendar cal = Calendar.getInstance();
+        cal.setTimeInMillis(date);
+        setCurrentDate(cal.get(Calendar.YEAR), cal.get(Calendar.MONTH), cal.get(Calendar.DAY_OF_MONTH),
+                cal.get(Calendar.HOUR_OF_DAY), cal.get(Calendar.MINUTE));
+    }
+
+    /**
+     * 设置当前日期时间（通过年月日时分）
+     * @param year 年
+     * @param month 月（0-11）
+     * @param dayOfMonth 日
+     * @param hourOfDay 时（24小时制，0-23）
+     * @param minute 分
+     */
+    public void setCurrentDate(int year, int month,
+                               int dayOfMonth, int hourOfDay, int minute) {
+        setCurrentYear(year);
+        setCurrentMonth(month);
+        setCurrentDay(dayOfMonth);
+        setCurrentHour(hourOfDay);
+        setCurrentMinute(minute);
+    }
+
+    /**
+     * 获取当前年份
+     * @return 年份
+     */
+    public int getCurrentYear() {
+        return mDate.get(Calendar.YEAR);
+    }
+
+    /**
+     * 设置当前年份
+     * @param year 年份
+     */
+    public void setCurrentYear(int year) {
+        if (!mInitialising && year == getCurrentYear()) {
+            return;
+        }
+        mDate.set(Calendar.YEAR, year);
+        updateDateControl();
+        onDateTimeChanged();
+    }
+
+    /**
+     * 获取当前月份（0-11）
+     * @return 月份
+     */
+    public int getCurrentMonth() {
+        return mDate.get(Calendar.MONTH);
+    }
+
+    /**
+     * 设置当前月份
+     * @param month 月份（0-11）
+     */
+    public void setCurrentMonth(int month) {
+        if (!mInitialising && month == getCurrentMonth()) {
+            return;
+        }
+        mDate.set(Calendar.MONTH, month);
+        updateDateControl();
+        onDateTimeChanged();
+    }
+
+    /**
+     * 获取当前日
+     * @return 日
+     */
+    public int getCurrentDay() {
+        return mDate.get(Calendar.DAY_OF_MONTH);
+    }
+
+    /**
+     * 设置当前日
+     * @param dayOfMonth 日
+     */
+    public void setCurrentDay(int dayOfMonth) {
+        if (!mInitialising && dayOfMonth == getCurrentDay()) {
+            return;
+        }
+        mDate.set(Calendar.DAY_OF_MONTH, dayOfMonth);
+        updateDateControl();
+        onDateTimeChanged();
+    }
+
+    /**
+     * 获取当前小时（24小时制，0-23）
+     * @return 小时
+     */
+    public int getCurrentHourOfDay() {
+        return mDate.get(Calendar.HOUR_OF_DAY);
+    }
+
+    /**
+     * 根据当前时间格式（12/24小时制）获取小时显示值
+     * @return 小时显示值
+     */
+    private int getCurrentHour() {
+        if (mIs24HourView){
+            return getCurrentHourOfDay();
+        } else {
+            int hour = getCurrentHourOfDay();
+            // 12小时制转换：13->1，0->12
+            if (hour > HOURS_IN_HALF_DAY) {
+                return hour - HOURS_IN_HALF_DAY;
+            } else {
+                return hour == 0 ? HOURS_IN_HALF_DAY : hour;
+            }
+        }
+    }
+
+    /**
+     * 设置当前小时（24小时制）
+     * @param hourOfDay 小时（0-23）
+     */
+    public void setCurrentHour(int hourOfDay) {
+        if (!mInitialising && hourOfDay == getCurrentHourOfDay()) {
+            return;
+        }
+        mDate.set(Calendar.HOUR_OF_DAY, hourOfDay);
+
+        if (!mIs24HourView) {
+            // 12小时制处理：更新上下午状态和小时显示值
+            if (hourOfDay >= HOURS_IN_HALF_DAY) {
+                mIsAm = false;
+                if (hourOfDay > HOURS_IN_HALF_DAY) {
+                    hourOfDay -= HOURS_IN_HALF_DAY;
+                }
+            } else {
+                mIsAm = true;
+                if (hourOfDay == 0) {
+                    hourOfDay = HOURS_IN_HALF_DAY;
+                }
+            }
+            updateAmPmControl();
+        }
+
+        mHourSpinner.setValue(hourOfDay);
+        onDateTimeChanged();
+    }
+
+    /**
+     * 获取当前分钟
+     * @return 分钟
+     */
+    public int getCurrentMinute() {
+        return mDate.get(Calendar.MINUTE);
+    }
+
+    /**
+     * 设置当前分钟
+     * @param minute 分钟（0-59）
+     */
+    public void setCurrentMinute(int minute) {
+        if (!mInitialising && minute == getCurrentMinute()) {
+            return;
+        }
+        mMinuteSpinner.setValue(minute);
+        mDate.set(Calendar.MINUTE, minute);
+        onDateTimeChanged();
+    }
+
+    /**
+     * 判断是否为24小时制显示
+     * @return 是否为24小时制
+     */
+    public boolean is24HourView () {
+        return mIs24HourView;
+    }
+
+    /**
+     * 设置时间显示格式（24小时制/12小时制）
+     * @param is24HourView true为24小时制，false为12小时制
+     */
+    public void set24HourView(boolean is24HourView) {
+        if (mIs24HourView == is24HourView) {
+            return;
+        }
+        mIs24HourView = is24HourView;
+        // 24小时制隐藏上下午选择器，12小时制显示
+        mAmPmSpinner.setVisibility(is24HourView ? View.GONE : View.VISIBLE);
+        int hour = getCurrentHourOfDay();
+        updateHourControl();
+        setCurrentHour(hour);
+        updateAmPmControl();
+    }
+
+    /**
+     * 更新日期选择器显示内容（近一周的日期，格式：月.日 星期）
+     */
+    private void updateDateControl() {
+        Calendar cal = Calendar.getInstance();
+        cal.setTimeInMillis(mDate.getTimeInMillis());
+        // 计算起始日期（当前日期减去3天，用于显示近一周）
+        cal.add(Calendar.DAY_OF_YEAR, -DAYS_IN_ALL_WEEK / 2 - 1);
+        mDateSpinner.setDisplayedValues(null);
+
+        // 生成近一周的日期文本
+        for (int i = 0; i < DAYS_IN_ALL_WEEK; ++i) {
+            cal.add(Calendar.DAY_OF_YEAR, 1);
+            mDateDisplayValues[i] = (String) DateFormat.format("MM.dd EEEE", cal);
+        }
+
+        mDateSpinner.setDisplayedValues(mDateDisplayValues);
+        mDateSpinner.setValue(DAYS_IN_ALL_WEEK / 2); // 默认选中当前日期
+        mDateSpinner.invalidate();
+    }
+
+    /**
+     * 更新上下午选择器状态（根据12小时制和当前上下午状态）
+     */
+    private void updateAmPmControl() {
+        if (mIs24HourView) {
+            mAmPmSpinner.setVisibility(View.GONE);
+        } else {
+            int index = mIsAm ? Calendar.AM : Calendar.PM;
+            mAmPmSpinner.setValue(index);
+            mAmPmSpinner.setVisibility(View.VISIBLE);
+        }
+    }
+
+    /**
+     * 更新小时选择器的范围（根据12/24小时制）
+     */
+    private void updateHourControl() {
+        if (mIs24HourView) {
+            mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW);
+            mHourSpinner.setMaxValue(HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW);
+        } else {
+            mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW);
+            mHourSpinner.setMaxValue(HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW);
+        }
+    }
+
+    /**
+     * 设置日期时间变更监听器
+     * @param callback 监听器实例
+     */
+    public void setOnDateTimeChangedListener(OnDateTimeChangedListener callback) {
+        mOnDateTimeChangedListener = callback;
+    }
+
+    /**
+     * 触发日期时间变更事件（通知监听器）
+     */
+    private void onDateTimeChanged() {
+        if (mOnDateTimeChangedListener != null) {
+            mOnDateTimeChangedListener.onDateTimeChanged(this, getCurrentYear(),
+                    getCurrentMonth(), getCurrentDay(), getCurrentHourOfDay(), getCurrentMinute());
+        }
+    }
+}

src/ui/DateTimePickerDialog.java

@@ -0,0 +1,137 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.ui;
+
+import java.util.Calendar;
+
+import net.micode.notes.R;
+import net.micode.notes.ui.DateTimePicker;
+import net.micode.notes.ui.DateTimePicker.OnDateTimeChangedListener;
+
+import android.app.AlertDialog;
+import android.content.Context;
+import android.content.DialogInterface;
+import android.content.DialogInterface.OnClickListener;
+import android.text.format.DateFormat;
+import android.text.format.DateUtils;
+
+/**
+ * 日期时间选择对话框，用于小米便签中设置提醒时间的交互界面
+ * 继承自AlertDialog，内部集成DateTimePicker作为选择视图，提供日期和时间的可视化选择
+ */
+public class DateTimePickerDialog extends AlertDialog implements OnClickListener {
+
+    // 用于维护当前选中的日期时间
+    private Calendar mDate = Calendar.getInstance();
+    // 是否采用24小时制显示时间
+    private boolean mIs24HourView;
+    // 日期时间选择完成后的回调监听器（由调用者实现，如NoteEditActivity）
+    private OnDateTimeSetListener mOnDateTimeSetListener;
+    // 自定义的日期时间选择器视图，负责用户选择交互
+    private DateTimePicker mDateTimePicker;
+
+    /**
+     * 日期时间选择完成的回调接口
+     * 当用户点击"确定"后，通过此接口将选中的时间（毫秒级时间戳）传递给调用者
+     */
+    public interface OnDateTimeSetListener {
+        void OnDateTimeSet(AlertDialog dialog, long date);
+    }
+
+    /**
+     * 构造方法：初始化日期时间选择对话框
+     * @param context 上下文环境（如NoteEditActivity）
+     * @param date 初始日期时间（毫秒级时间戳，通常为当前时间或便签已有的提醒时间）
+     */
+    public DateTimePickerDialog(Context context, long date) {
+        super(context);
+        // 初始化自定义的日期时间选择器
+        mDateTimePicker = new DateTimePicker(context);
+        // 将选择器设置为对话框的内容视图
+        setView(mDateTimePicker);
+
+        // 为日期时间选择器设置变化监听器：当用户选择的日期或时间变化时触发
+        mDateTimePicker.setOnDateTimeChangedListener(new OnDateTimeChangedListener() {
+            public void onDateTimeChanged(DateTimePicker view, int year, int month,
+                                          int dayOfMonth, int hourOfDay, int minute) {
+                // 更新内部维护的日期时间
+                mDate.set(Calendar.YEAR, year);
+                mDate.set(Calendar.MONTH, month);
+                mDate.set(Calendar.DAY_OF_MONTH, dayOfMonth);
+                mDate.set(Calendar.HOUR_OF_DAY, hourOfDay);
+                mDate.set(Calendar.MINUTE, minute);
+                // 根据新选择的时间更新对话框标题
+                updateTitle(mDate.getTimeInMillis());
+            }
+        });
+
+        // 设置初始日期时间（忽略秒数，确保提醒时间精确到分钟）
+        mDate.setTimeInMillis(date);
+        mDate.set(Calendar.SECOND, 0);
+        mDateTimePicker.setCurrentDate(mDate.getTimeInMillis());
+
+        // 设置对话框按钮："确定"按钮触发onClick方法，"取消"按钮不执行操作
+        setButton(context.getString(R.string.datetime_dialog_ok), this);
+        setButton2(context.getString(R.string.datetime_dialog_cancel), (OnClickListener)null);
+
+        // 根据系统设置初始化24小时制显示模式
+        set24HourView(DateFormat.is24HourFormat(this.getContext()));
+        // 初始化对话框标题为初始日期时间
+        updateTitle(mDate.getTimeInMillis());
+    }
+
+    /**
+     * 设置时间显示模式（24小时制/12小时制）
+     * @param is24HourView true为24小时制，false为12小时制
+     */
+    public void set24HourView(boolean is24HourView) {
+        mIs24HourView = is24HourView;
+    }
+
+    /**
+     * 设置日期时间选择完成后的回调监听器
+     * @param callBack 实现了OnDateTimeSetListener的对象（通常为调用对话框的Activity）
+     */
+    public void setOnDateTimeSetListener(OnDateTimeSetListener callBack) {
+        mOnDateTimeSetListener = callBack;
+    }
+
+    /**
+     * 更新对话框标题，显示当前选中的日期时间
+     * @param date 选中的日期时间（毫秒级时间戳）
+     */
+    private void updateTitle(long date) {
+        // 定义日期时间的显示格式：包含年、月、日、时间
+        int flag = DateUtils.FORMAT_SHOW_YEAR | DateUtils.FORMAT_SHOW_DATE | DateUtils.FORMAT_SHOW_TIME;
+        // 根据24小时制模式调整显示格式
+        flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_12HOUR;
+        // 格式化时间并设置为对话框标题
+        setTitle(DateUtils.formatDateTime(this.getContext(), date, flag));
+    }
+
+    /**
+     * 处理"确定"按钮的点击事件
+     * 当用户点击确定后，通过回调接口将选中的时间传递给调用者
+     */
+    public void onClick(DialogInterface arg0, int arg1) {
+        if (mOnDateTimeSetListener != null) {
+            // 回调传递选中的时间（毫秒级时间戳）
+            mOnDateTimeSetListener.OnDateTimeSet(this, mDate.getTimeInMillis());
+        }
+    }
+
+}

src/ui/DropdownMenu.java

@@ -0,0 +1,92 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.ui;
+
+import android.content.Context;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+import android.view.View.OnClickListener;
+import android.widget.Button;
+import android.widget.PopupMenu;
+import android.widget.PopupMenu.OnMenuItemClickListener;
+
+import net.micode.notes.R;
+
+/**
+ * 下拉菜单工具类，用于在小米便签中实现按钮触发的弹出式菜单
+ * 典型场景：笔记列表的批量操作菜单、编辑页的功能选项菜单等
+ */
+public class DropdownMenu {
+    // 触发下拉菜单的按钮
+    private Button mButton;
+    // 系统提供的弹出式菜单组件，负责显示下拉选项
+    private PopupMenu mPopupMenu;
+    // 菜单容器，存储从资源文件加载的菜单项
+    private Menu mMenu;
+
+    /**
+     * 构造方法：初始化下拉菜单
+     * @param context 上下文对象，用于访问资源和创建视图
+     * @param button 触发下拉菜单的按钮
+     * @param menuId 菜单资源ID（定义在res/menu目录下）
+     */
+    public DropdownMenu(Context context, Button button, int menuId) {
+        mButton = button;
+        // 设置按钮背景为下拉图标（箭头图标）
+        mButton.setBackgroundResource(R.drawable.dropdown_icon);
+        // 初始化PopupMenu，绑定到触发按钮
+        mPopupMenu = new PopupMenu(context, mButton);
+        // 获取菜单容器
+        mMenu = mPopupMenu.getMenu();
+        // 从资源文件加载菜单项到菜单容器
+        mPopupMenu.getMenuInflater().inflate(menuId, mMenu);
+        // 设置按钮点击事件：点击时显示下拉菜单
+        mButton.setOnClickListener(new OnClickListener() {
+            public void onClick(View v) {
+                mPopupMenu.show();
+            }
+        });
+    }
+
+    /**
+     * 设置下拉菜单项的点击事件监听器
+     * @param listener 监听器对象，处理菜单项点击逻辑
+     */
+    public void setOnDropdownMenuItemClickListener(OnMenuItemClickListener listener) {
+        if (mPopupMenu != null) {
+            mPopupMenu.setOnMenuItemClickListener(listener);
+        }
+    }
+
+    /**
+     * 根据ID查找菜单中的具体选项
+     * @param id 菜单项的资源ID
+     * @return 对应的MenuItem对象，可用于修改状态（如勾选、隐藏）
+     */
+    public MenuItem findItem(int id) {
+        return mMenu.findItem(id);
+    }
+
+    /**
+     * 设置触发按钮的显示文本
+     * @param title 要显示的文本（如"已选择3项"）
+     */
+    public void setTitle(CharSequence title) {
+        mButton.setText(title);
+    }
+}

src/ui/FoldersListAdapter.java

@@ -0,0 +1,130 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.ui;
+
+import android.content.Context;
+import android.database.Cursor;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.CursorAdapter;
+import android.widget.LinearLayout;
+import android.widget.TextView;
+
+import net.micode.notes.R;
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.NoteColumns;
+
+/**
+ * 文件夹列表适配器，用于小米便签中展示文件夹列表（如移动便签时选择目标文件夹）
+ * 继承自CursorAdapter，负责将数据库中的文件夹数据与列表视图绑定
+ */
+public class FoldersListAdapter extends CursorAdapter {
+    /**
+     * 数据库查询投影：指定需要查询的文件夹字段
+     * 包含文件夹ID（用于区分不同文件夹）和文件夹名称（存储在SNIPPET字段）
+     */
+    public static final String [] PROJECTION = {
+            NoteColumns.ID,       // 文件夹ID
+            NoteColumns.SNIPPET   // 文件夹名称（小米便签中文件夹名称存储在此字段）
+    };
+
+    /**
+     * 投影字段对应的索引，用于从Cursor中快速获取数据
+     */
+    public static final int ID_COLUMN   = 0;   // PROJECTION中ID字段的索引
+    public static final int NAME_COLUMN = 1;   // PROJECTION中SNIPPET（名称）字段的索引
+
+    /**
+     * 构造方法：初始化文件夹列表适配器
+     * @param context 上下文环境（如调用文件夹列表的Activity或对话框）
+     * @param c 包含文件夹数据的数据库游标（查询结果）
+     */
+    public FoldersListAdapter(Context context, Cursor c) {
+        super(context, c);
+        // TODO Auto-generated constructor stub
+    }
+
+    /**
+     * 创建新的列表项视图
+     * @param context 上下文环境
+     * @param cursor 包含当前项数据的游标（此处未直接使用，仅用于创建视图）
+     * @param parent 父视图容器（通常为ListView）
+     * @return 自定义的文件夹列表项视图（FolderListItem实例）
+     */
+    @Override
+    public View newView(Context context, Cursor cursor, ViewGroup parent) {
+        return new FolderListItem(context);
+    }
+
+    /**
+     * 将游标中的文件夹数据绑定到列表项视图
+     * @param view 列表项视图（FolderListItem实例）
+     * @param context 上下文环境
+     * @param cursor 包含当前文件夹数据的游标
+     */
+    @Override
+    public void bindView(View view, Context context, Cursor cursor) {
+        if (view instanceof FolderListItem) {
+            // 处理根文件夹的特殊名称：根文件夹ID为Notes.ID_ROOT_FOLDER，显示为“移动到父文件夹”
+            String folderName = (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context
+                    .getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN);
+            // 将文件夹名称绑定到列表项视图
+            ((FolderListItem) view).bind(folderName);
+        }
+    }
+
+    /**
+     * 根据位置获取文件夹名称
+     * @param context 上下文环境
+     * @param position 列表项位置
+     * @return 对应位置的文件夹名称（根文件夹特殊处理）
+     */
+    public String getFolderName(Context context, int position) {
+        Cursor cursor = (Cursor) getItem(position);
+        // 根文件夹特殊处理，其他文件夹直接取SNIPPET字段值
+        return (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context
+                .getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN);
+    }
+
+    /**
+     * 自定义文件夹列表项视图，继承LinearLayout，用于展示单个文件夹的名称
+     */
+    private class FolderListItem extends LinearLayout {
+        private TextView mName;  // 用于显示文件夹名称的文本控件
+
+        /**
+         * 构造方法：初始化列表项布局和控件
+         * @param context 上下文环境
+         */
+        public FolderListItem(Context context) {
+            super(context);
+            // 加载文件夹列表项的布局文件（folder_list_item.xml）
+            inflate(context, R.layout.folder_list_item, this);
+            // 获取布局中的文本控件，用于显示文件夹名称
+            mName = (TextView) findViewById(R.id.tv_folder_name);
+        }
+
+        /**
+         * 为列表项设置文件夹名称
+         * @param name 文件夹名称（可能是根文件夹的特殊名称或普通文件夹名称）
+         */
+        public void bind(String name) {
+            mName.setText(name);
+        }
+    }
+
+}

src/ui/NoteEditText.java

@@ -0,0 +1,288 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.ui;
+
+import android.content.Context;
+import android.graphics.Rect;
+import android.text.Layout;
+import android.text.Selection;
+import android.text.Spanned;
+import android.text.TextUtils;
+import android.text.style.URLSpan;
+import android.util.AttributeSet;
+import android.util.Log;
+import android.view.ContextMenu;
+import android.view.KeyEvent;
+import android.view.MenuItem;
+import android.view.MenuItem.OnMenuItemClickListener;
+import android.view.MotionEvent;
+import android.widget.EditText;
+
+import net.micode.notes.R;
+
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * 小米便签的自定义文本输入控件，继承自EditText，扩展了便签编辑的核心交互功能
+ * 支持多输入框管理、链接识别与交互、精确光标定位等
+ */
+public class NoteEditText extends EditText {
+    private static final String TAG = "NoteEditText";
+    // 当前输入框在多输入框列表中的索引（用于区分不同输入框）
+    private int mIndex;
+    // 记录删除键按下前的光标起始位置（用于判断是否删除当前输入框）
+    private int mSelectionStartBeforeDelete;
+
+    // 支持的链接协议常量
+    private static final String SCHEME_TEL = "tel:" ;      // 电话协议（如"tel:10086"）
+    private static final String SCHEME_HTTP = "http:" ;    // 网页协议（如"http://www.micode.net"）
+    private static final String SCHEME_EMAIL = "mailto:" ; // 邮件协议（如"mailto:test@micode.net"）
+
+    // 链接协议与对应菜单资源的映射（用于上下文菜单显示对应操作文字）
+    private static final Map<String, Integer> sSchemaActionResMap = new HashMap<String, Integer>();
+    static {
+        sSchemaActionResMap.put(SCHEME_TEL, R.string.note_link_tel);    // 电话链接对应"拨打"菜单
+        sSchemaActionResMap.put(SCHEME_HTTP, R.string.note_link_web);   // 网页链接对应"打开网页"菜单
+        sSchemaActionResMap.put(SCHEME_EMAIL, R.string.note_link_email); // 邮件链接对应"发送邮件"菜单
+    }
+
+    /**
+     * 文本视图变化监听器，由{@link NoteEditActivity}实现，用于处理输入框的增删和文本状态变化
+     */
+    public interface OnTextViewChangeListener {
+        /**
+         * 当按下删除键且文本为空时，删除当前输入框
+         * @param index 当前输入框的索引
+         * @param text 当前输入框的文本内容
+         */
+        void onEditTextDelete(int index, String text);
+
+        /**
+         * 当按下回车键时，在当前输入框后新增一个输入框
+         * @param index 新增输入框的索引（当前索引+1）
+         * @param text 回车键后需要移动到新输入框的文本
+         */
+        void onEditTextEnter(int index, String text);
+
+        /**
+         * 当文本内容变化时，通知是否显示输入框相关操作选项
+         * @param index 当前输入框的索引
+         * @param hasText 文本是否非空（用于控制操作选项的显示/隐藏）
+         */
+        void onTextChange(int index, boolean hasText);
+    }
+
+    // 文本变化监听器实例（由NoteEditActivity设置）
+    private OnTextViewChangeListener mOnTextViewChangeListener;
+
+    /**
+     * 构造方法：初始化文本输入控件（仅上下文参数）
+     * @param context 上下文环境（如NoteEditActivity）
+     */
+    public NoteEditText(Context context) {
+        super(context, null);
+        mIndex = 0; // 默认索引为0
+    }
+
+    /**
+     * 设置当前输入框在多输入框列表中的索引
+     * @param index 输入框索引
+     */
+    public void setIndex(int index) {
+        mIndex = index;
+    }
+
+    /**
+     * 设置文本变化监听器，关联到NoteEditActivity
+     * @param listener 实现了OnTextViewChangeListener的监听器
+     */
+    public void setOnTextViewChangeListener(OnTextViewChangeListener listener) {
+        mOnTextViewChangeListener = listener;
+    }
+
+    /**
+     * 构造方法：初始化文本输入控件（上下文+属性集）
+     * @param context 上下文环境
+     * @param attrs 布局中定义的属性集合
+     */
+    public NoteEditText(Context context, AttributeSet attrs) {
+        super(context, attrs, android.R.attr.editTextStyle);
+    }
+
+    /**
+     * 构造方法：初始化文本输入控件（上下文+属性集+样式）
+     * @param context 上下文环境
+     * @param attrs 属性集合
+     * @param defStyle 默认样式
+     */
+    public NoteEditText(Context context, AttributeSet attrs, int defStyle) {
+        super(context, attrs, defStyle);
+        // TODO Auto-generated constructor stub
+    }
+
+    /**
+     * 处理触摸事件，精确设置光标位置（根据触摸坐标计算光标应在的文本位置）
+     * @param event 触摸事件（包含触摸坐标等信息）
+     * @return 事件是否被处理
+     */
+    @Override
+    public boolean onTouchEvent(MotionEvent event) {
+        switch (event.getAction()) {
+            case MotionEvent.ACTION_DOWN:
+                // 计算触摸点在文本中的实际坐标（扣除内边距并加上滚动偏移）
+                int x = (int) event.getX();
+                int y = (int) event.getY();
+                x -= getTotalPaddingLeft();
+                y -= getTotalPaddingTop();
+                x += getScrollX();
+                y += getScrollY();
+
+                // 根据坐标获取对应的文本行和偏移量，设置光标位置
+                Layout layout = getLayout();
+                int line = layout.getLineForVertical(y); // 触摸点所在的文本行
+                int off = layout.getOffsetForHorizontal(line, x); // 行内的水平偏移（光标位置）
+                Selection.setSelection(getText(), off); // 设置光标
+                break;
+        }
+        return super.onTouchEvent(event);
+    }
+
+    /**
+     * 处理键盘按下事件，记录删除键按下前的光标位置
+     * @param keyCode 按键代码（如KEYCODE_DEL、KEYCODE_ENTER）
+     * @param event 键盘事件
+     * @return 事件是否被处理
+     */
+    @Override
+    public boolean onKeyDown(int keyCode, KeyEvent event) {
+        switch (keyCode) {
+            case KeyEvent.KEYCODE_ENTER:
+                // 回车键事件由onKeyUp处理，此处返回false让事件继续传递
+                if (mOnTextViewChangeListener != null) {
+                    return false;
+                }
+                break;
+            case KeyEvent.KEYCODE_DEL:
+                // 记录删除键按下前的光标起始位置，用于判断是否需要删除输入框
+                mSelectionStartBeforeDelete = getSelectionStart();
+                break;
+            default:
+                break;
+        }
+        return super.onKeyDown(keyCode, event);
+    }
+
+    /**
+     * 处理键盘抬起事件，触发输入框增删逻辑
+     * @param keyCode 按键代码
+     * @param event 键盘事件
+     * @return 事件是否被处理
+     */
+    @Override
+    public boolean onKeyUp(int keyCode, KeyEvent event) {
+        switch(keyCode) {
+            case KeyEvent.KEYCODE_DEL:
+                if (mOnTextViewChangeListener != null) {
+                    // 若光标在起始位置且不是第一个输入框，通知删除当前输入框
+                    if (0 == mSelectionStartBeforeDelete && mIndex != 0) {
+                        mOnTextViewChangeListener.onEditTextDelete(mIndex, getText().toString());
+                        return true;
+                    }
+                } else {
+                    Log.d(TAG, "OnTextViewChangeListener was not seted");
+                }
+                break;
+            case KeyEvent.KEYCODE_ENTER:
+                if (mOnTextViewChangeListener != null) {
+                    // 处理回车键：将光标后的文本移至新输入框
+                    int selectionStart = getSelectionStart();
+                    String text = getText().subSequence(selectionStart, length()).toString(); // 光标后文本
+                    setText(getText().subSequence(0, selectionStart)); // 保留光标前文本
+                    mOnTextViewChangeListener.onEditTextEnter(mIndex + 1, text); // 通知新增输入框
+                } else {
+                    Log.d(TAG, "OnTextViewChangeListener was not seted");
+                }
+                break;
+            default:
+                break;
+        }
+        return super.onKeyUp(keyCode, event);
+    }
+
+    /**
+     * 处理焦点变化事件，通知监听器文本是否为空（用于控制操作选项显示）
+     * @param focused 是否获得焦点
+     * @param direction 焦点移动方向
+     * @param previouslyFocusedRect 上一个焦点区域
+     */
+    @Override
+    protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) {
+        if (mOnTextViewChangeListener != null) {
+            // 失去焦点且文本为空时，通知无文本；否则通知有文本
+            if (!focused && TextUtils.isEmpty(getText())) {
+                mOnTextViewChangeListener.onTextChange(mIndex, false);
+            } else {
+                mOnTextViewChangeListener.onTextChange(mIndex, true);
+            }
+        }
+        super.onFocusChanged(focused, direction, previouslyFocusedRect);
+    }
+
+    /**
+     * 创建上下文菜单，识别选中的链接并显示对应操作选项（如拨打、打开网页）
+     * @param menu 上下文菜单实例
+     */
+    @Override
+    protected void onCreateContextMenu(ContextMenu menu) {
+        // 仅处理富文本中的链接
+        if (getText() instanceof Spanned) {
+            int selStart = getSelectionStart();
+            int selEnd = getSelectionEnd();
+            int min = Math.min(selStart, selEnd);
+            int max = Math.max(selStart, selEnd);
+
+            // 获取选中区域内的链接
+            final URLSpan[] urls = ((Spanned) getText()).getSpans(min, max, URLSpan.class);
+            if (urls.length == 1) { // 仅处理单个链接的情况
+                int defaultResId = 0;
+                // 识别链接协议，匹配对应的菜单资源
+                for(String schema: sSchemaActionResMap.keySet()) {
+                    if(urls[0].getURL().indexOf(schema) >= 0) {
+                        defaultResId = sSchemaActionResMap.get(schema);
+                        break;
+                    }
+                }
+
+                // 未匹配到已知协议时，使用默认菜单文本
+                if (defaultResId == 0) {
+                    defaultResId = R.string.note_link_other;
+                }
+
+                // 向菜单添加链接操作项，点击后触发链接的默认行为（如拨号、打开浏览器）
+                menu.add(0, 0, 0, defaultResId).setOnMenuItemClickListener(
+                        new OnMenuItemClickListener() {
+                            public boolean onMenuItemClick(MenuItem item) {
+                                urls[0].onClick(NoteEditText.this); // 触发URLSpan的点击事件
+                                return true;
+                            }
+                        });
+            }
+        }
+        super.onCreateContextMenu(menu);
+    }
+}

src/ui/NoteItemData.java

@@ -0,0 +1,319 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.ui;
+
+import android.content.Context;
+import android.database.Cursor;
+import android.text.TextUtils;
+
+import net.micode.notes.data.Contact;
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.tool.DataUtils;
+
+
+/**
+ * 小米便签列表项的数据模型类，封装单个便签的核心信息及列表位置属性，用于支撑列表UI展示
+ */
+public class NoteItemData {
+    // 数据库查询的列名数组，对应便签表的核心字段
+    static final String [] PROJECTION = new String [] {
+            NoteColumns.ID,                  // 便签ID
+            NoteColumns.ALERTED_DATE,        // 提醒时间
+            NoteColumns.BG_COLOR_ID,         // 背景色ID
+            NoteColumns.CREATED_DATE,        // 创建时间
+            NoteColumns.HAS_ATTACHMENT,      // 是否有附件
+            NoteColumns.MODIFIED_DATE,       // 修改时间
+            NoteColumns.NOTES_COUNT,         // 文件夹包含的便签数量（仅文件夹类型有效）
+            NoteColumns.PARENT_ID,           // 父文件夹ID
+            NoteColumns.SNIPPET,             // 内容摘要（文件夹名或便签内容片段）
+            NoteColumns.TYPE,                // 类型（便签/文件夹/系统文件夹）
+            NoteColumns.WIDGET_ID,           // 桌面插件ID
+            NoteColumns.WIDGET_TYPE,         // 桌面插件类型
+    };
+
+    // 上述PROJECTION数组中各列的索引常量，用于从Cursor中提取数据
+    private static final int ID_COLUMN                    = 0;         // 便签ID索引
+    private static final int ALERTED_DATE_COLUMN          = 1;         // 提醒时间索引
+    private static final int BG_COLOR_ID_COLUMN           = 2;         // 背景色ID索引
+    private static final int CREATED_DATE_COLUMN          = 3;         // 创建时间索引
+    private static final int HAS_ATTACHMENT_COLUMN        = 4;         // 是否有附件索引
+    private static final int MODIFIED_DATE_COLUMN         = 5;         // 修改时间索引
+    private static final int NOTES_COUNT_COLUMN           = 6;         // 文件夹便签数量索引
+    private static final int PARENT_ID_COLUMN             = 7;         // 父文件夹ID索引
+    private static final int SNIPPET_COLUMN               = 8;         // 内容摘要索引
+    private static final int TYPE_COLUMN                  = 9;         // 类型索引
+    private static final int WIDGET_ID_COLUMN             = 10;        // 桌面插件ID索引
+    private static final int WIDGET_TYPE_COLUMN           = 11;        // 桌面插件类型索引
+
+    // 便签核心数据字段
+    private long mId;                  // 便签唯一ID
+    private long mAlertDate;           // 提醒时间（毫秒时间戳）
+    private int mBgColorId;            // 背景色ID（对应资源文件）
+    private long mCreatedDate;         // 创建时间（毫秒时间戳）
+    private boolean mHasAttachment;    // 是否有附件（如图片等）
+    private long mModifiedDate;        // 最后修改时间（毫秒时间戳）
+    private int mNotesCount;           // 文件夹包含的便签数量（仅文件夹类型使用）
+    private long mParentId;            // 所属文件夹ID
+    private String mSnippet;           // 内容摘要（文件夹名或便签内容的简短展示）
+    private int mType;                 // 类型（Notes.TYPE_NOTE：便签；TYPE_FOLDER：文件夹等）
+    private int mWidgetId;             // 关联的桌面插件ID（无则为无效值）
+    private int mWidgetType;           // 桌面插件类型（无则为无效值）
+    private String mName;              // 通话记录便签的联系人姓名（非通话记录则为空）
+    private String mPhoneNumber;       // 通话记录便签的电话号码（非通话记录则为空）
+
+    // 列表位置属性（用于UI背景样式适配）
+    private boolean mIsLastItem;               // 是否为列表最后一项
+    private boolean mIsFirstItem;              // 是否为列表第一项
+    private boolean mIsOnlyOneItem;            // 是否为列表中唯一一项
+    private boolean mIsOneNoteFollowingFolder; // 是否为文件夹后的唯一便签项
+    private boolean mIsMultiNotesFollowingFolder; // 是否为文件夹后的多个便签项之一
+
+    /**
+     * 构造方法：从数据库查询游标中提取数据初始化便签信息
+     * @param context 上下文环境（用于获取联系人信息等）
+     * @param cursor 数据库查询结果游标（包含便签表数据）
+     */
+    public NoteItemData(Context context, Cursor cursor) {
+        // 从游标中提取核心数据字段
+        mId = cursor.getLong(ID_COLUMN);
+        mAlertDate = cursor.getLong(ALERTED_DATE_COLUMN);
+        mBgColorId = cursor.getInt(BG_COLOR_ID_COLUMN);
+        mCreatedDate = cursor.getLong(CREATED_DATE_COLUMN);
+        mHasAttachment = (cursor.getInt(HAS_ATTACHMENT_COLUMN) > 0) ? true : false;
+        mModifiedDate = cursor.getLong(MODIFIED_DATE_COLUMN);
+        mNotesCount = cursor.getInt(NOTES_COUNT_COLUMN);
+        mParentId = cursor.getLong(PARENT_ID_COLUMN);
+        mSnippet = cursor.getString(SNIPPET_COLUMN);
+        // 移除检查列表标记（用于纯文本展示）
+        mSnippet = mSnippet.replace(NoteEditActivity.TAG_CHECKED, "").replace(
+                NoteEditActivity.TAG_UNCHECKED, "");
+        mType = cursor.getInt(TYPE_COLUMN);
+        mWidgetId = cursor.getInt(WIDGET_ID_COLUMN);
+        mWidgetType = cursor.getInt(WIDGET_TYPE_COLUMN);
+
+        // 处理通话记录便签：提取电话号码并关联联系人姓名
+        mPhoneNumber = "";
+        if (mParentId == Notes.ID_CALL_RECORD_FOLDER) { // 若属于通话记录文件夹
+            mPhoneNumber = DataUtils.getCallNumberByNoteId(context.getContentResolver(), mId);
+            if (!TextUtils.isEmpty(mPhoneNumber)) {
+                mName = Contact.getContact(context, mPhoneNumber); // 获取联系人姓名
+                if (mName == null) {
+                    mName = mPhoneNumber; // 无联系人时显示电话号码
+                }
+            }
+        }
+
+        if (mName == null) {
+            mName = "";
+        }
+        // 计算当前项在列表中的位置属性
+        checkPostion(cursor);
+    }
+
+    /**
+     * 判断当前项在游标中的位置，初始化位置属性（用于UI背景样式适配）
+     * @param cursor 数据库查询结果游标
+     */
+    private void checkPostion(Cursor cursor) {
+        mIsLastItem = cursor.isLast() ? true : false; // 是否为最后一项
+        mIsFirstItem = cursor.isFirst() ? true : false; // 是否为第一项
+        mIsOnlyOneItem = (cursor.getCount() == 1); // 是否为唯一一项
+
+        // 初始化文件夹后便签的位置属性
+        mIsMultiNotesFollowingFolder = false;
+        mIsOneNoteFollowingFolder = false;
+
+        // 若当前是便签项且不是第一项，检查前一项是否为文件夹
+        if (mType == Notes.TYPE_NOTE && !mIsFirstItem) {
+            int position = cursor.getPosition();
+            if (cursor.moveToPrevious()) { // 移动到前一项
+                // 前一项是文件夹或系统文件夹
+                if (cursor.getInt(TYPE_COLUMN) == Notes.TYPE_FOLDER
+                        || cursor.getInt(TYPE_COLUMN) == Notes.TYPE_SYSTEM) {
+                    // 若游标总数大于当前位置+1，说明文件夹后有多个便签
+                    if (cursor.getCount() > (position + 1)) {
+                        mIsMultiNotesFollowingFolder = true;
+                    } else {
+                        // 否则文件夹后只有当前一个便签
+                        mIsOneNoteFollowingFolder = true;
+                    }
+                }
+                // 移回原位置，避免游标错乱
+                if (!cursor.moveToNext()) {
+                    throw new IllegalStateException("cursor move to previous but can't move back");
+                }
+            }
+        }
+    }
+
+    /**
+     * 是否为文件夹后的唯一便签项
+     */
+    public boolean isOneFollowingFolder() {
+        return mIsOneNoteFollowingFolder;
+    }
+
+    /**
+     * 是否为文件夹后的多个便签项之一
+     */
+    public boolean isMultiFollowingFolder() {
+        return mIsMultiNotesFollowingFolder;
+    }
+
+    /**
+     * 是否为列表最后一项
+     */
+    public boolean isLast() {
+        return mIsLastItem;
+    }
+
+    /**
+     * 获取通话记录便签的联系人姓名（非通话记录返回空）
+     */
+    public String getCallName() {
+        return mName;
+    }
+
+    /**
+     * 是否为列表第一项
+     */
+    public boolean isFirst() {
+        return mIsFirstItem;
+    }
+
+    /**
+     * 是否为列表中唯一一项
+     */
+    public boolean isSingle() {
+        return mIsOnlyOneItem;
+    }
+
+    /**
+     * 获取便签ID
+     */
+    public long getId() {
+        return mId;
+    }
+
+    /**
+     * 获取提醒时间（毫秒时间戳）
+     */
+    public long getAlertDate() {
+        return mAlertDate;
+    }
+
+    /**
+     * 获取创建时间（毫秒时间戳）
+     */
+    public long getCreatedDate() {
+        return mCreatedDate;
+    }
+
+    /**
+     * 是否有附件
+     */
+    public boolean hasAttachment() {
+        return mHasAttachment;
+    }
+
+    /**
+     * 获取最后修改时间（毫秒时间戳）
+     */
+    public long getModifiedDate() {
+        return mModifiedDate;
+    }
+
+    /**
+     * 获取背景色ID
+     */
+    public int getBgColorId() {
+        return mBgColorId;
+    }
+
+    /**
+     * 获取所属文件夹ID
+     */
+    public long getParentId() {
+        return mParentId;
+    }
+
+    /**
+     * 获取文件夹包含的便签数量（仅文件夹类型有效）
+     */
+    public int getNotesCount() {
+        return mNotesCount;
+    }
+
+    /**
+     * 获取所属文件夹ID（与getParentId一致，兼容不同调用场景）
+     */
+    public long getFolderId () {
+        return mParentId;
+    }
+
+    /**
+     * 获取类型（便签/文件夹/系统文件夹）
+     */
+    public int getType() {
+        return mType;
+    }
+
+    /**
+     * 获取桌面插件类型
+     */
+    public int getWidgetType() {
+        return mWidgetType;
+    }
+
+    /**
+     * 获取桌面插件ID
+     */
+    public int getWidgetId() {
+        return mWidgetId;
+    }
+
+    /**
+     * 获取内容摘要（文件夹名或便签内容片段）
+     */
+    public String getSnippet() {
+        return mSnippet;
+    }
+
+    /**
+     * 是否设置了提醒（提醒时间>0）
+     */
+    public boolean hasAlert() {
+        return (mAlertDate > 0);
+    }
+
+    /**
+     * 是否为通话记录便签（属于通话记录文件夹且有电话号码）
+     */
+    public boolean isCallRecord() {
+        return (mParentId == Notes.ID_CALL_RECORD_FOLDER && !TextUtils.isEmpty(mPhoneNumber));
+    }
+
+    /**
+     * 从游标中获取便签类型
+     * @param cursor 数据库查询结果游标
+     * @return 便签类型（Notes.TYPE_NOTE等）
+     */
+    public static int getNoteType(Cursor cursor) {
+        return cursor.getInt(TYPE_COLUMN);
+    }
+}

src/ui/NotesListAdapter.java

@@ -0,0 +1,259 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.ui;
+
+import android.content.Context;
+import android.database.Cursor;
+import android.util.Log;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.CursorAdapter;
+
+import net.micode.notes.data.Notes;
+
+import java.util.Collection;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.Iterator;
+
+
+/**
+ * 便签列表适配器，用于将便签数据与列表视图绑定，支持多选操作
+ * 继承自CursorAdapter，通过Cursor获取数据库中的便签数据
+ */
+public class NotesListAdapter extends CursorAdapter {
+    private static final String TAG = "NotesListAdapter";
+    private Context mContext; // 上下文对象
+    private HashMap<Integer, Boolean> mSelectedIndex; // 存储选中项的位置和状态
+    private int mNotesCount; // 便签总数（不包含文件夹）
+    private boolean mChoiceMode; // 是否处于选择模式
+
+    /**
+     * 桌面插件属性封装类
+     * 用于存储选中项中包含的桌面插件信息
+     */
+    public static class AppWidgetAttribute {
+        public int widgetId; // 插件ID
+        public int widgetType; // 插件类型
+    };
+
+    /**
+     * 构造方法
+     * @param context 上下文对象
+     */
+    public NotesListAdapter(Context context) {
+        super(context, null);
+        mSelectedIndex = new HashMap<Integer, Boolean>();
+        mContext = context;
+        mNotesCount = 0;
+    }
+
+    /**
+     * 创建新的列表项视图
+     * @param context 上下文
+     * @param cursor 数据游标
+     * @param parent 父容器
+     * @return 新创建的NotesListItem视图
+     */
+    @Override
+    public View newView(Context context, Cursor cursor, ViewGroup parent) {
+        return new NotesListItem(context);
+    }
+
+    /**
+     * 绑定数据到列表项视图
+     * @param view 列表项视图
+     * @param context 上下文
+     * @param cursor 数据游标
+     */
+    @Override
+    public void bindView(View view, Context context, Cursor cursor) {
+        if (view instanceof NotesListItem) {
+            // 从游标中解析便签数据
+            NoteItemData itemData = new NoteItemData(context, cursor);
+            // 绑定数据到视图，设置选择模式和选中状态
+            ((NotesListItem) view).bind(context, itemData, mChoiceMode,
+                    isSelectedItem(cursor.getPosition()));
+        }
+    }
+
+    /**
+     * 设置指定位置的选中状态
+     * @param position 列表项位置
+     * @param checked 是否选中
+     */
+    public void setCheckedItem(final int position, final boolean checked) {
+        mSelectedIndex.put(position, checked);
+        notifyDataSetChanged(); // 通知列表刷新
+    }
+
+    /**
+     * 判断是否处于选择模式
+     * @return 是否为选择模式
+     */
+    public boolean isInChoiceMode() {
+        return mChoiceMode;
+    }
+
+    /**
+     * 设置选择模式
+     * @param mode 选择模式开关
+     */
+    public void setChoiceMode(boolean mode) {
+        mSelectedIndex.clear(); // 清除选中状态
+        mChoiceMode = mode;
+    }
+
+    /**
+     * 全选或取消全选所有便签（仅对普通便签有效）
+     * @param checked 是否选中
+     */
+    public void selectAll(boolean checked) {
+        Cursor cursor = getCursor();
+        for (int i = 0; i < getCount(); i++) {
+            if (cursor.moveToPosition(i)) {
+                // 仅处理类型为普通便签的项
+                if (NoteItemData.getNoteType(cursor) == Notes.TYPE_NOTE) {
+                    setCheckedItem(i, checked);
+                }
+            }
+        }
+    }
+
+    /**
+     * 获取所有选中项的ID集合
+     * @return 选中项ID的HashSet
+     */
+    public HashSet<Long> getSelectedItemIds() {
+        HashSet<Long> itemSet = new HashSet<Long>();
+        for (Integer position : mSelectedIndex.keySet()) {
+            if (mSelectedIndex.get(position) == true) {
+                Long id = getItemId(position);
+                // 过滤根文件夹ID（不应被选中）
+                if (id == Notes.ID_ROOT_FOLDER) {
+                    Log.d(TAG, "Wrong item id, should not happen");
+                } else {
+                    itemSet.add(id);
+                }
+            }
+        }
+        return itemSet;
+    }
+
+    /**
+     * 获取所有选中项中的桌面插件属性
+     * @return 插件属性的HashSet
+     */
+    public HashSet<AppWidgetAttribute> getSelectedWidget() {
+        HashSet<AppWidgetAttribute> itemSet = new HashSet<AppWidgetAttribute>();
+        for (Integer position : mSelectedIndex.keySet()) {
+            if (mSelectedIndex.get(position) == true) {
+                Cursor c = (Cursor) getItem(position);
+                if (c != null) {
+                    AppWidgetAttribute widget = new AppWidgetAttribute();
+                    NoteItemData item = new NoteItemData(mContext, c);
+                    widget.widgetId = item.getWidgetId();
+                    widget.widgetType = item.getWidgetType();
+                    itemSet.add(widget);
+                    // 注意：此处不关闭游标，游标由适配器管理
+                } else {
+                    Log.e(TAG, "Invalid cursor");
+                    return null;
+                }
+            }
+        }
+        return itemSet;
+    }
+
+    /**
+     * 获取选中项的数量
+     * @return 选中项数量
+     */
+    public int getSelectedCount() {
+        Collection<Boolean> values = mSelectedIndex.values();
+        if (null == values) {
+            return 0;
+        }
+        Iterator<Boolean> iter = values.iterator();
+        int count = 0;
+        while (iter.hasNext()) {
+            if (true == iter.next()) {
+                count++;
+            }
+        }
+        return count;
+    }
+
+    /**
+     * 判断是否所有便签都被选中
+     * @return 是否全选
+     */
+    public boolean isAllSelected() {
+        int checkedCount = getSelectedCount();
+        return (checkedCount != 0 && checkedCount == mNotesCount);
+    }
+
+    /**
+     * 判断指定位置的项是否被选中
+     * @param position 列表项位置
+     * @return 是否选中
+     */
+    public boolean isSelectedItem(final int position) {
+        if (null == mSelectedIndex.get(position)) {
+            return false;
+        }
+        return mSelectedIndex.get(position);
+    }
+
+    /**
+     * 当数据发生变化时回调，重新计算便签数量
+     */
+    @Override
+    protected void onContentChanged() {
+        super.onContentChanged();
+        calcNotesCount();
+    }
+
+    /**
+     * 更换游标时回调，重新计算便签数量
+     * @param cursor 新游标
+     */
+    @Override
+    public void changeCursor(Cursor cursor) {
+        super.changeCursor(cursor);
+        calcNotesCount();
+    }
+
+    /**
+     * 计算普通便签的总数（排除文件夹）
+     */
+    private void calcNotesCount() {
+        mNotesCount = 0;
+        for (int i = 0; i < getCount(); i++) {
+            Cursor c = (Cursor) getItem(i);
+            if (c != null) {
+                // 仅统计类型为普通便签的项
+                if (NoteItemData.getNoteType(c) == Notes.TYPE_NOTE) {
+                    mNotesCount++;
+                }
+            } else {
+                Log.e(TAG, "Invalid cursor");
+                return;
+            }
+        }
+    }
+}

src/ui/NotesListItem.java

@@ -0,0 +1,169 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.ui;
+
+import android.content.Context;
+import android.text.format.DateUtils;
+import android.view.View;
+import android.widget.CheckBox;
+import android.widget.ImageView;
+import android.widget.LinearLayout;
+import android.widget.TextView;
+
+import net.micode.notes.R;
+import net.micode.notes.data.Notes;
+import net.micode.notes.tool.DataUtils;
+import net.micode.notes.tool.ResourceParser.NoteItemBgResources;
+
+
+/**
+ * 小米便签列表中的单个项视图
+ * 负责展示便签、文件夹或通话记录的内容及状态，支持多选模式
+ */
+public class NotesListItem extends LinearLayout {
+    private ImageView mAlert;       // 提醒图标（显示闹钟或通话记录图标）
+    private TextView mTitle;        // 标题/内容文本（显示便签内容、文件夹名称等）
+    private TextView mTime;         // 时间文本（显示最后修改时间）
+    private TextView mCallName;     // 通话记录联系人名称（仅通话记录便签显示）
+    private NoteItemData mItemData; // 当前项对应的数据模型
+    private CheckBox mCheckBox;     // 多选模式下的复选框
+
+    /**
+     * 构造方法：初始化布局和控件
+     * @param context 上下文对象
+     */
+    public NotesListItem(Context context) {
+        super(context);
+        // 加载列表项布局文件
+        inflate(context, R.layout.note_item, this);
+        // 绑定UI控件
+        mAlert = (ImageView) findViewById(R.id.iv_alert_icon);
+        mTitle = (TextView) findViewById(R.id.tv_title);
+        mTime = (TextView) findViewById(R.id.tv_time);
+        mCallName = (TextView) findViewById(R.id.tv_name);
+        mCheckBox = (CheckBox) findViewById(android.R.id.checkbox);
+    }
+
+    /**
+     * 绑定数据到当前列表项，根据数据类型和模式展示不同样式
+     * @param context 上下文对象
+     * @param data 便签数据模型
+     * @param choiceMode 是否处于多选模式
+     * @param checked 多选模式下是否被选中
+     */
+    public void bind(Context context, NoteItemData data, boolean choiceMode, boolean checked) {
+        // 处理多选模式：仅普通便签显示复选框并同步选中状态
+        if (choiceMode && data.getType() == Notes.TYPE_NOTE) {
+            mCheckBox.setVisibility(View.VISIBLE);
+            mCheckBox.setChecked(checked);
+        } else {
+            mCheckBox.setVisibility(View.GONE);
+        }
+
+        mItemData = data;
+
+        // 处理通话记录文件夹（特殊系统文件夹）
+        if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {
+            mCallName.setVisibility(View.GONE);
+            mAlert.setVisibility(View.VISIBLE);
+            mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
+            // 显示文件夹名称和包含的便签数量
+            mTitle.setText(context.getString(R.string.call_record_folder_name)
+                    + context.getString(R.string.format_folder_files_count, data.getNotesCount()));
+            mAlert.setImageResource(R.drawable.call_record); // 显示通话记录图标
+
+            // 处理通话记录文件夹下的便签
+        } else if (data.getParentId() == Notes.ID_CALL_RECORD_FOLDER) {
+            mCallName.setVisibility(View.VISIBLE);
+            mCallName.setText(data.getCallName()); // 显示联系人名称
+            mTitle.setTextAppearance(context, R.style.TextAppearanceSecondaryItem);
+            mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet())); // 显示便签内容片段
+            // 显示提醒图标（如有）
+            if (data.hasAlert()) {
+                mAlert.setImageResource(R.drawable.clock);
+                mAlert.setVisibility(View.VISIBLE);
+            } else {
+                mAlert.setVisibility(View.GONE);
+            }
+
+            // 处理普通文件夹和普通便签
+        } else {
+            mCallName.setVisibility(View.GONE);
+            mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
+
+            // 普通文件夹：显示名称和包含的便签数量
+            if (data.getType() == Notes.TYPE_FOLDER) {
+                mTitle.setText(data.getSnippet()
+                        + context.getString(R.string.format_folder_files_count,
+                        data.getNotesCount()));
+                mAlert.setVisibility(View.GONE);
+
+                // 普通便签：显示内容片段和提醒状态
+            } else {
+                mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));
+                if (data.hasAlert()) {
+                    mAlert.setImageResource(R.drawable.clock);
+                    mAlert.setVisibility(View.VISIBLE);
+                } else {
+                    mAlert.setVisibility(View.GONE);
+                }
+            }
+        }
+
+        // 显示最后修改时间（相对时间格式，如"1小时前"）
+        mTime.setText(DateUtils.getRelativeTimeSpanString(data.getModifiedDate()));
+
+        // 设置项背景样式
+        setBackground(data);
+    }
+
+    /**
+     * 根据便签类型和位置设置背景样式
+     * @param data 便签数据模型
+     */
+    private void setBackground(NoteItemData data) {
+        int bgColorId = data.getBgColorId(); // 获取背景色ID
+
+        // 普通便签：根据位置（首项/末项/单项等）设置不同背景
+        if (data.getType() == Notes.TYPE_NOTE) {
+            if (data.isSingle() || data.isOneFollowingFolder()) {
+                // 单项或文件夹后的唯一便签
+                setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(bgColorId));
+            } else if (data.isLast()) {
+                // 列表中的最后一项
+                setBackgroundResource(NoteItemBgResources.getNoteBgLastRes(bgColorId));
+            } else if (data.isFirst() || data.isMultiFollowingFolder()) {
+                // 首项或文件夹后的多个便签中的第一项
+                setBackgroundResource(NoteItemBgResources.getNoteBgFirstRes(bgColorId));
+            } else {
+                // 中间项
+                setBackgroundResource(NoteItemBgResources.getNoteBgNormalRes(bgColorId));
+            }
+        } else {
+            // 文件夹：使用固定的文件夹背景
+            setBackgroundResource(NoteItemBgResources.getFolderBgRes());
+        }
+    }
+
+    /**
+     * 获取当前项的数据模型
+     * @return 便签数据模型
+     */
+    public NoteItemData getItemData() {
+        return mItemData;
+    }
+}

src/ui/NotesPreferenceActivity.java

@@ -0,0 +1,463 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.ui;
+
+import android.accounts.Account;
+import android.accounts.AccountManager;
+import android.app.ActionBar;
+import android.app.AlertDialog;
+import android.content.BroadcastReceiver;
+import android.content.ContentValues;
+import android.content.Context;
+import android.content.DialogInterface;
+import android.content.Intent;
+import android.content.IntentFilter;
+import android.content.SharedPreferences;
+import android.os.Bundle;
+import android.preference.Preference;
+import android.preference.Preference.OnPreferenceClickListener;
+import android.preference.PreferenceActivity;
+import android.preference.PreferenceCategory;
+import android.text.TextUtils;
+import android.text.format.DateFormat;
+import android.view.LayoutInflater;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+import android.widget.Button;
+import android.widget.TextView;
+import android.widget.Toast;
+
+import net.micode.notes.R;
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.gtask.remote.GTaskSyncService;
+
+
+/**
+ * 小米便签的设置页面
+ * 负责账号管理、同步控制及偏好设置，支持便签数据同步功能
+ */
+public class NotesPreferenceActivity extends PreferenceActivity {
+    // 偏好设置存储名称
+    public static final String PREFERENCE_NAME = "notes_preferences";
+    // 同步账号名称的偏好键
+    public static final String PREFERENCE_SYNC_ACCOUNT_NAME = "pref_key_account_name";
+    // 最后同步时间的偏好键
+    public static final String PREFERENCE_LAST_SYNC_TIME = "pref_last_sync_time";
+    // 背景颜色设置的偏好键
+    public static final String PREFERENCE_SET_BG_COLOR_KEY = "pref_key_bg_random_appear";
+
+    // 同步账号设置分类的键
+    private static final String PREFERENCE_SYNC_ACCOUNT_KEY = "pref_sync_account_key";
+    // 账号权限过滤键
+    private static final String AUTHORITIES_FILTER_KEY = "authorities";
+
+    // 账号设置分类
+    private PreferenceCategory mAccountCategory;
+    // 同步服务广播接收器
+    private GTaskReceiver mReceiver;
+    // 原始账号列表（用于检测新添加的账号）
+    private Account[] mOriAccounts;
+    // 是否添加了新账号的标记
+    private boolean mHasAddedAccount;
+
+    @Override
+    protected void onCreate(Bundle icicle) {
+        super.onCreate(icicle);
+
+        // 设置ActionBar支持返回导航
+        getActionBar().setDisplayHomeAsUpEnabled(true);
+
+        // 加载偏好设置布局
+        addPreferencesFromResource(R.xml.preferences);
+        // 获取账号设置分类
+        mAccountCategory = (PreferenceCategory) findPreference(PREFERENCE_SYNC_ACCOUNT_KEY);
+        // 初始化广播接收器并注册，监听同步服务广播
+        mReceiver = new GTaskReceiver();
+        IntentFilter filter = new IntentFilter();
+        filter.addAction(GTaskSyncService.GTASK_SERVICE_BROADCAST_NAME);
+        registerReceiver(mReceiver, filter);
+
+        // 初始化账号列表和头部视图
+        mOriAccounts = null;
+        View header = LayoutInflater.from(this).inflate(R.layout.settings_header, null);
+        getListView().addHeaderView(header, null, true);
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+
+        // 如果检测到新添加的账号，自动设置为同步账号
+        if (mHasAddedAccount) {
+            Account[] accounts = getGoogleAccounts();
+            if (mOriAccounts != null && accounts.length > mOriAccounts.length) {
+                for (Account accountNew : accounts) {
+                    boolean found = false;
+                    for (Account accountOld : mOriAccounts) {
+                        if (TextUtils.equals(accountOld.name, accountNew.name)) {
+                            found = true;
+                            break;
+                        }
+                    }
+                    if (!found) {
+                        setSyncAccount(accountNew.name);
+                        break;
+                    }
+                }
+            }
+        }
+
+        // 刷新UI显示
+        refreshUI();
+    }
+
+    @Override
+    protected void onDestroy() {
+        // 注销广播接收器
+        if (mReceiver != null) {
+            unregisterReceiver(mReceiver);
+        }
+        super.onDestroy();
+    }
+
+    /**
+     * 加载账号设置项到偏好页面
+     */
+    private void loadAccountPreference() {
+        mAccountCategory.removeAll();
+
+        Preference accountPref = new Preference(this);
+        final String defaultAccount = getSyncAccountName(this);
+        accountPref.setTitle(getString(R.string.preferences_account_title));
+        accountPref.setSummary(getString(R.string.preferences_account_summary));
+        // 设置账号项点击事件
+        accountPref.setOnPreferenceClickListener(new OnPreferenceClickListener() {
+            public boolean onPreferenceClick(Preference preference) {
+                if (!GTaskSyncService.isSyncing()) {
+                    if (TextUtils.isEmpty(defaultAccount)) {
+                        // 首次设置账号，显示账号选择对话框
+                        showSelectAccountAlertDialog();
+                    } else {
+                        // 已设置账号，显示账号变更确认对话框
+                        showChangeAccountConfirmAlertDialog();
+                    }
+                } else {
+                    // 同步中不允许变更账号
+                    Toast.makeText(NotesPreferenceActivity.this,
+                                    R.string.preferences_toast_cannot_change_account, Toast.LENGTH_SHORT)
+                            .show();
+                }
+                return true;
+            }
+        });
+
+        mAccountCategory.addPreference(accountPref);
+    }
+
+    /**
+     * 加载同步按钮和同步状态显示
+     */
+    private void loadSyncButton() {
+        Button syncButton = (Button) findViewById(R.id.preference_sync_button);
+        TextView lastSyncTimeView = (TextView) findViewById(R.id.prefenerece_sync_status_textview);
+
+        // 设置同步按钮状态
+        if (GTaskSyncService.isSyncing()) {
+            syncButton.setText(getString(R.string.preferences_button_sync_cancel));
+            syncButton.setOnClickListener(new View.OnClickListener() {
+                public void onClick(View v) {
+                    // 取消同步
+                    GTaskSyncService.cancelSync(NotesPreferenceActivity.this);
+                }
+            });
+        } else {
+            syncButton.setText(getString(R.string.preferences_button_sync_immediately));
+            syncButton.setOnClickListener(new View.OnClickListener() {
+                public void onClick(View v) {
+                    // 立即同步
+                    GTaskSyncService.startSync(NotesPreferenceActivity.this);
+                }
+            });
+        }
+        // 未设置账号时禁用同步按钮
+        syncButton.setEnabled(!TextUtils.isEmpty(getSyncAccountName(this)));
+
+        // 设置最后同步时间显示
+        if (GTaskSyncService.isSyncing()) {
+            lastSyncTimeView.setText(GTaskSyncService.getProgressString());
+            lastSyncTimeView.setVisibility(View.VISIBLE);
+        } else {
+            long lastSyncTime = getLastSyncTime(this);
+            if (lastSyncTime != 0) {
+                lastSyncTimeView.setText(getString(R.string.preferences_last_sync_time,
+                        DateFormat.format(getString(R.string.preferences_last_sync_time_format),
+                                lastSyncTime)));
+                lastSyncTimeView.setVisibility(View.VISIBLE);
+            } else {
+                lastSyncTimeView.setVisibility(View.GONE);
+            }
+        }
+    }
+
+    /**
+     * 刷新整个UI界面
+     */
+    private void refreshUI() {
+        loadAccountPreference();
+        loadSyncButton();
+    }
+
+    /**
+     * 显示账号选择对话框
+     */
+    private void showSelectAccountAlertDialog() {
+        AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);
+
+        // 自定义对话框标题
+        View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);
+        TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);
+        titleTextView.setText(getString(R.string.preferences_dialog_select_account_title));
+        TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);
+        subtitleTextView.setText(getString(R.string.preferences_dialog_select_account_tips));
+        dialogBuilder.setCustomTitle(titleView);
+        dialogBuilder.setPositiveButton(null, null);
+
+        // 获取谷歌账号列表
+        Account[] accounts = getGoogleAccounts();
+        String defAccount = getSyncAccountName(this);
+
+        mOriAccounts = accounts;
+        mHasAddedAccount = false;
+
+        if (accounts.length > 0) {
+            CharSequence[] items = new CharSequence[accounts.length];
+            final CharSequence[] itemMapping = items;
+            int checkedItem = -1;
+            int index = 0;
+            // 构建账号选择列表
+            for (Account account : accounts) {
+                if (TextUtils.equals(account.name, defAccount)) {
+                    checkedItem = index;
+                }
+                items[index++] = account.name;
+            }
+            // 设置单选列表点击事件
+            dialogBuilder.setSingleChoiceItems(items, checkedItem,
+                    new DialogInterface.OnClickListener() {
+                        public void onClick(DialogInterface dialog, int which) {
+                            setSyncAccount(itemMapping[which].toString());
+                            dialog.dismiss();
+                            refreshUI();
+                        }
+                    });
+        }
+
+        // 添加"添加账号"选项
+        View addAccountView = LayoutInflater.from(this).inflate(R.layout.add_account_text, null);
+        dialogBuilder.setView(addAccountView);
+
+        final AlertDialog dialog = dialogBuilder.show();
+        addAccountView.setOnClickListener(new View.OnClickListener() {
+            public void onClick(View v) {
+                mHasAddedAccount = true;
+                // 跳转到添加账号设置页面
+                Intent intent = new Intent("android.settings.ADD_ACCOUNT_SETTINGS");
+                intent.putExtra(AUTHORITIES_FILTER_KEY, new String[] {
+                        "gmail-ls"
+                });
+                startActivityForResult(intent, -1);
+                dialog.dismiss();
+            }
+        });
+    }
+
+    /**
+     * 显示账号变更确认对话框
+     */
+    private void showChangeAccountConfirmAlertDialog() {
+        AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);
+
+        // 自定义对话框标题
+        View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);
+        TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);
+        titleTextView.setText(getString(R.string.preferences_dialog_change_account_title,
+                getSyncAccountName(this)));
+        TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);
+        subtitleTextView.setText(getString(R.string.preferences_dialog_change_account_warn_msg));
+        dialogBuilder.setCustomTitle(titleView);
+
+        // 对话框选项：变更账号、移除账号、取消
+        CharSequence[] menuItemArray = new CharSequence[] {
+                getString(R.string.preferences_menu_change_account),
+                getString(R.string.preferences_menu_remove_account),
+                getString(R.string.preferences_menu_cancel)
+        };
+        dialogBuilder.setItems(menuItemArray, new DialogInterface.OnClickListener() {
+            public void onClick(DialogInterface dialog, int which) {
+                if (which == 0) {
+                    // 变更账号：显示账号选择对话框
+                    showSelectAccountAlertDialog();
+                } else if (which == 1) {
+                    // 移除账号
+                    removeSyncAccount();
+                    refreshUI();
+                }
+            }
+        });
+        dialogBuilder.show();
+    }
+
+    /**
+     * 获取设备上的谷歌账号列表
+     * @return 谷歌账号数组
+     */
+    private Account[] getGoogleAccounts() {
+        AccountManager accountManager = AccountManager.get(this);
+        return accountManager.getAccountsByType("com.google");
+    }
+
+    /**
+     * 设置同步账号并更新本地数据
+     * @param account 账号名称
+     */
+    private void setSyncAccount(String account) {
+        if (!getSyncAccountName(this).equals(account)) {
+            SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
+            SharedPreferences.Editor editor = settings.edit();
+            if (account != null) {
+                editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, account);
+            } else {
+                editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, "");
+            }
+            editor.commit();
+
+            // 清除最后同步时间
+            setLastSyncTime(this, 0);
+
+            // 清除本地GTASK相关信息（异步执行）
+            new Thread(new Runnable() {
+                public void run() {
+                    ContentValues values = new ContentValues();
+                    values.put(NoteColumns.GTASK_ID, "");
+                    values.put(NoteColumns.SYNC_ID, 0);
+                    getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null);
+                }
+            }).start();
+
+            Toast.makeText(NotesPreferenceActivity.this,
+                    getString(R.string.preferences_toast_success_set_accout, account),
+                    Toast.LENGTH_SHORT).show();
+        }
+    }
+
+    /**
+     * 移除当前同步账号并清理数据
+     */
+    private void removeSyncAccount() {
+        SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
+        SharedPreferences.Editor editor = settings.edit();
+        if (settings.contains(PREFERENCE_SYNC_ACCOUNT_NAME)) {
+            editor.remove(PREFERENCE_SYNC_ACCOUNT_NAME);
+        }
+        if (settings.contains(PREFERENCE_LAST_SYNC_TIME)) {
+            editor.remove(PREFERENCE_LAST_SYNC_TIME);
+        }
+        editor.commit();
+
+        // 清除本地GTASK相关信息（异步执行）
+        new Thread(new Runnable() {
+            public void run() {
+                ContentValues values = new ContentValues();
+                values.put(NoteColumns.GTASK_ID, "");
+                values.put(NoteColumns.SYNC_ID, 0);
+                getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null);
+            }
+        }).start();
+    }
+
+    /**
+     * 获取保存的同步账号名称
+     * @param context 上下文
+     * @return 账号名称，为空表示未设置
+     */
+    public static String getSyncAccountName(Context context) {
+        SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
+                Context.MODE_PRIVATE);
+        return settings.getString(PREFERENCE_SYNC_ACCOUNT_NAME, "");
+    }
+
+    /**
+     * 保存最后同步时间
+     * @param context 上下文
+     * @param time 时间戳
+     */
+    public static void setLastSyncTime(Context context, long time) {
+        SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
+                Context.MODE_PRIVATE);
+        SharedPreferences.Editor editor = settings.edit();
+        editor.putLong(PREFERENCE_LAST_SYNC_TIME, time);
+        editor.commit();
+    }
+
+    /**
+     * 获取最后同步时间
+     * @param context 上下文
+     * @return 时间戳，0表示从未同步过
+     */
+    public static long getLastSyncTime(Context context) {
+        SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
+                Context.MODE_PRIVATE);
+        return settings.getLong(PREFERENCE_LAST_SYNC_TIME, 0);
+    }
+
+    /**
+     * 监听同步服务广播的接收器
+     * 用于同步过程中更新UI状态
+     */
+    private class GTaskReceiver extends BroadcastReceiver {
+
+        @Override
+        public void onReceive(Context context, Intent intent) {
+            // 刷新UI显示同步状态
+            refreshUI();
+            if (intent.getBooleanExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_IS_SYNCING, false)) {
+                TextView syncStatus = (TextView) findViewById(R.id.prefenerece_sync_status_textview);
+                syncStatus.setText(intent
+                        .getStringExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_PROGRESS_MSG));
+            }
+
+        }
+    }
+
+    /**
+     * 处理菜单选项点击事件
+     */
+    public boolean onOptionsItemSelected(MenuItem item) {
+        switch (item.getItemId()) {
+            case android.R.id.home:
+                // 返回便签列表页面
+                Intent intent = new Intent(this, NotesListActivity.class);
+                intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
+                startActivity(intent);
+                return true;
+            default:
+                return false;
+        }
+    }
+}

src/widget/NoteWidgetProvider.java

@@ -0,0 +1,187 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.widget;
+import android.app.PendingIntent;
+import android.appwidget.AppWidgetManager;
+import android.appwidget.AppWidgetProvider;
+import android.content.ContentValues;
+import android.content.Context;
+import android.content.Intent;
+import android.database.Cursor;
+import android.util.Log;
+import android.widget.RemoteViews;
+
+import net.micode.notes.R;
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.tool.ResourceParser;
+import net.micode.notes.ui.NoteEditActivity;
+import net.micode.notes.ui.NotesListActivity;
+
+/**
+ * 便签小部件基类，定义不同尺寸小部件的通用行为
+ * 子类需实现具体布局、背景资源和小部件类型的获取
+ */
+public abstract class NoteWidgetProvider extends AppWidgetProvider {
+    // 查询便签数据时使用的字段投影
+    public static final String [] PROJECTION = new String [] {
+            NoteColumns.ID,           // 便签ID
+            NoteColumns.BG_COLOR_ID,  // 背景颜色ID
+            NoteColumns.SNIPPET       // 便签内容摘要
+    };
+
+    // 投影字段对应的索引值
+    public static final int COLUMN_ID           = 0;
+    public static final int COLUMN_BG_COLOR_ID  = 1;
+    public static final int COLUMN_SNIPPET      = 2;
+
+    private static final String TAG = "NoteWidgetProvider";
+
+    /**
+     * 当小部件被删除时调用
+     * 清除数据库中与该小部件关联的记录
+     */
+    @Override
+    public void onDeleted(Context context, int[] appWidgetIds) {
+        ContentValues values = new ContentValues();
+        // 将小部件ID设为无效值
+        values.put(NoteColumns.WIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID);
+        for (int i = 0; i < appWidgetIds.length; i++) {
+            // 更新数据库中关联该小部件的便签记录
+            context.getContentResolver().update(Notes.CONTENT_NOTE_URI,
+                    values,
+                    NoteColumns.WIDGET_ID + "=?",
+                    new String[] { String.valueOf(appWidgetIds[i])});
+        }
+    }
+
+    /**
+     * 获取与指定小部件关联的便签信息
+     * @param context 上下文
+     * @param widgetId 小部件ID
+     * @return 包含便签信息的游标
+     */
+    private Cursor getNoteWidgetInfo(Context context, int widgetId) {
+        return context.getContentResolver().query(Notes.CONTENT_NOTE_URI,
+                PROJECTION,
+                // 查询条件：小部件ID匹配且不在回收站中
+                NoteColumns.WIDGET_ID + "=? AND " + NoteColumns.PARENT_ID + "<>?",
+                new String[] { String.valueOf(widgetId), String.valueOf(Notes.ID_TRASH_FOLER) },
+                null);
+    }
+
+    /**
+     * 公开的更新方法，调用带隐私模式参数的私有更新方法
+     */
+    protected void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
+        update(context, appWidgetManager, appWidgetIds, false);
+    }
+
+    /**
+     * 核心更新方法，更新小部件的UI显示
+     * @param context 上下文
+     * @param appWidgetManager 小部件管理器
+     * @param appWidgetIds 需要更新的小部件ID数组
+     * @param privacyMode 是否隐私模式（隐藏内容）
+     */
+    private void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds,
+                        boolean privacyMode) {
+        for (int i = 0; i < appWidgetIds.length; i++) {
+            // 只处理有效的小部件ID
+            if (appWidgetIds[i] != AppWidgetManager.INVALID_APPWIDGET_ID) {
+                // 默认背景颜色ID
+                int bgId = ResourceParser.getDefaultBgId(context);
+                // 便签内容摘要
+                String snippet = "";
+                // 点击小部件时的跳转意图
+                Intent intent = new Intent(context, NoteEditActivity.class);
+                intent.setFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP);
+                intent.putExtra(Notes.INTENT_EXTRA_WIDGET_ID, appWidgetIds[i]);
+                intent.putExtra(Notes.INTENT_EXTRA_WIDGET_TYPE, getWidgetType());
+
+                // 查询与当前小部件关联的便签数据
+                Cursor c = getNoteWidgetInfo(context, appWidgetIds[i]);
+                if (c != null && c.moveToFirst()) {
+                    // 检查是否有多个便签关联到同一小部件（异常情况）
+                    if (c.getCount() > 1) {
+                        Log.e(TAG, "Multiple message with same widget id:" + appWidgetIds[i]);
+                        c.close();
+                        return;
+                    }
+                    // 从游标中获取数据
+                    snippet = c.getString(COLUMN_SNIPPET);
+                    bgId = c.getInt(COLUMN_BG_COLOR_ID);
+                    intent.putExtra(Intent.EXTRA_UID, c.getLong(COLUMN_ID));
+                    intent.setAction(Intent.ACTION_VIEW); // 查看已有便签
+                } else {
+                    // 无关联便签时显示默认文本
+                    snippet = context.getResources().getString(R.string.widget_havenot_content);
+                    intent.setAction(Intent.ACTION_INSERT_OR_EDIT); // 新建便签
+                }
+
+                // 关闭游标释放资源
+                if (c != null) {
+                    c.close();
+                }
+
+                // 加载小部件布局
+                RemoteViews rv = new RemoteViews(context.getPackageName(), getLayoutId());
+                // 设置背景图片
+                rv.setImageViewResource(R.id.widget_bg_image, getBgResourceId(bgId));
+                intent.putExtra(Notes.INTENT_EXTRA_BACKGROUND_ID, bgId);
+
+                // 创建点击事件的PendingIntent
+                PendingIntent pendingIntent = null;
+                if (privacyMode) {
+                    // 隐私模式下显示提示文本，点击跳转至便签列表
+                    rv.setTextViewText(R.id.widget_text,
+                            context.getString(R.string.widget_under_visit_mode));
+                    pendingIntent = PendingIntent.getActivity(context, appWidgetIds[i], new Intent(
+                            context, NotesListActivity.class), PendingIntent.FLAG_UPDATE_CURRENT);
+                } else {
+                    // 正常模式下显示便签内容，点击跳转至编辑页
+                    rv.setTextViewText(R.id.widget_text, snippet);
+                    pendingIntent = PendingIntent.getActivity(context, appWidgetIds[i], intent,
+                            PendingIntent.FLAG_UPDATE_CURRENT);
+                }
+
+                // 设置点击事件
+                rv.setOnClickPendingIntent(R.id.widget_text, pendingIntent);
+                // 更新小部件
+                appWidgetManager.updateAppWidget(appWidgetIds[i], rv);
+            }
+        }
+    }
+
+    /**
+     * 抽象方法：获取背景资源ID
+     * 由子类实现不同尺寸小部件的背景资源
+     */
+    protected abstract int getBgResourceId(int bgId);
+
+    /**
+     * 抽象方法：获取布局ID
+     * 由子类实现不同尺寸小部件的布局文件
+     */
+    protected abstract int getLayoutId();
+
+    /**
+     * 抽象方法：获取小部件类型
+     * 由子类定义具体的小部件类型（如2x、4x等）
+     */
+    protected abstract int getWidgetType();
+}

src/widget/NoteWidgetProvider_2x.java

@@ -0,0 +1,76 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.widget;
+
+import android.appwidget.AppWidgetManager;
+import android.content.Context;
+
+import net.micode.notes.R;
+import net.micode.notes.data.Notes;
+import net.micode.notes.tool.ResourceParser;
+
+/**
+ * 2x尺寸的便签桌面小部件实现类
+ * 继承自NoteWidgetProvider，专注于2x尺寸的布局、背景和类型定义
+ */
+public class NoteWidgetProvider_2x extends NoteWidgetProvider {
+
+    /**
+     * 小部件更新回调方法
+     * 当小部件需要更新时（如添加到桌面、系统触发更新）调用
+     * @param context 上下文对象，提供应用环境信息
+     * @param appWidgetManager 小部件管理器，用于更新小部件状态
+     * @param appWidgetIds 需要更新的小部件ID数组
+     */
+    @Override
+    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
+        // 调用父类的update方法执行通用更新逻辑（如查询数据、绑定事件）
+        super.update(context, appWidgetManager, appWidgetIds);
+    }
+
+    /**
+     * 实现抽象方法，返回2x尺寸小部件的布局文件ID
+     * 布局文件定义了小部件的UI结构（如文本位置、背景容器等）
+     * @return 2x小部件布局ID（R.layout.widget_2x）
+     */
+    @Override
+    protected int getLayoutId() {
+        return R.layout.widget_2x;
+    }
+
+    /**
+     * 实现抽象方法，返回2x尺寸小部件的背景资源ID
+     * 根据便签的背景色ID（bgId）获取对应的2x尺寸背景图
+     * @param bgId 便签背景色ID（如红色、黄色等）
+     * @return 2x小部件对应的背景资源ID
+     */
+    @Override
+    protected int getBgResourceId(int bgId) {
+        // 通过资源解析工具获取2x尺寸的背景资源
+        return ResourceParser.WidgetBgResources.getWidget2xBgResource(bgId);
+    }
+
+    /**
+     * 实现抽象方法，返回2x尺寸小部件的类型标识
+     * 用于系统区分不同尺寸的小部件，关联对应的数据和逻辑
+     * @return 2x小部件类型标识（Notes.TYPE_WIDGET_2X）
+     */
+    @Override
+    protected int getWidgetType() {
+        return Notes.TYPE_WIDGET_2X;
+    }
+}

src/widget/NoteWidgetProvider_4x.java

@@ -0,0 +1,72 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 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
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.widget;
+
+import android.appwidget.AppWidgetManager;
+import android.content.Context;
+
+import net.micode.notes.R;
+import net.micode.notes.data.Notes;
+import net.micode.notes.tool.ResourceParser;
+
+
+/**
+ * 小米便签4x尺寸桌面小部件的实现类，继承自NoteWidgetProvider，负责4x小部件的布局、背景和类型管理
+ */
+public class NoteWidgetProvider_4x extends NoteWidgetProvider {
+    /**
+     * 当系统触发小部件更新时调用（如小部件添加到桌面、定时刷新）
+     * 调用父类的update方法，触发通用更新逻辑（查询便签数据、渲染视图等）
+     * @param context 应用上下文，用于访问资源和数据库
+     * @param appWidgetManager 系统小部件管理器，负责更新小部件视图
+     * @param appWidgetIds 需要更新的小部件ID数组
+     */
+    @Override
+    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
+        super.update(context, appWidgetManager, appWidgetIds);
+    }
+
+    /**
+     * 提供4x尺寸小部件的布局文件ID
+     * 布局文件widget_4x.xml定义了该小部件的UI结构（如文本区域、背景容器等）
+     * @return 4x小部件的布局资源ID
+     */
+    protected int getLayoutId() {
+        return R.layout.widget_4x;
+    }
+
+    /**
+     * 根据背景ID（bgId）获取4x小部件对应的背景资源
+     * 通过ResourceParser工具类解析，确保背景与便签设置的颜色一致
+     * @param bgId 背景标识ID（如红色、蓝色等）
+     * @return 4x小部件的背景资源ID
+     */
+    @Override
+    protected int getBgResourceId(int bgId) {
+        return ResourceParser.WidgetBgResources.getWidget4xBgResource(bgId);
+    }
+
+    /**
+     * 返回4x小部件的类型标识，用于父类逻辑中区分小部件尺寸
+     * 与Notes类中定义的TYPE_WIDGET_4X常量对应，确保数据关联正确
+     * @return 4x小部件的类型标识
+     */
+    @Override
+    protected int getWidgetType() {
+        return Notes.TYPE_WIDGET_4X;
+    }
+}