feat: 添加置顶功能，置顶优先级最高

xian_favor/db.py

@@ -187,6 +187,15 @@ class Database:
             cursor.execute("CREATE INDEX IF NOT EXISTS idx_folders_type ON folders(type)")
             cursor.execute("CREATE INDEX IF NOT EXISTS idx_folders_parent ON folders(parent_id)")
             
+            # 检查并添加 is_pinned 字段（置顶功能，兼容旧数据库）
+            try:
+                cursor.execute("SELECT is_pinned FROM items LIMIT 1")
+            except sqlite3.OperationalError:
+                cursor.execute("ALTER TABLE items ADD COLUMN is_pinned INTEGER DEFAULT 0")
+            
+            # 创建 is_pinned 索引
+            cursor.execute("CREATE INDEX IF NOT EXISTS idx_items_pinned ON items(is_pinned)")
+            
             # 待办事务表（关联到文本类别的items）
             cursor.execute("""
                 CREATE TABLE IF NOT EXISTS todo_events (
@@ -305,18 +314,16 @@ class Database:
             if conditions:
                 query += " WHERE " + " AND ".join(conditions)
             
-            # 排序逻辑
+            # 排序逻辑：置顶 > 关注 > 创建时间
             if sort_by == 'updated_at':
                 order_field = 'i.updated_at'
             elif sort_by == 'created_at':
                 order_field = 'i.created_at'
             else:
-                # 默认：重点关注优先 + 创建时间降序
+                # 默认：置顶优先 + 关注优先 + 创建时间降序
                 order_field = 'i.created_at'
             
-            order_dir = 'DESC' if (sort_order == 'asc' or sort_order is None) else 'ASC'
-            # 这里反转逻辑：用户选择"降序"时用DESC，选择"升序"时用ASC
-            
+            # 确定排序方向
             if sort_order == 'asc':
                 order_dir = 'ASC'
             elif sort_order == 'desc':
@@ -324,12 +331,12 @@ class Database:
             else:
                 order_dir = 'DESC'  # 默认降序
             
-            # 如果有指定排序字段，按该字段排序；否则默认重点关注优先
+            # 如果有指定排序字段，按该字段排序，但置顶始终优先
             if sort_by:
-                query += f" ORDER BY {order_field} {order_dir} LIMIT ? OFFSET ?"
+                query += f" ORDER BY i.is_pinned DESC, {order_field} {order_dir} LIMIT ? OFFSET ?"
             else:
-                # 默认：重点关注优先，然后创建时间降序
-                query += f" ORDER BY i.is_starred DESC, i.created_at DESC LIMIT ? OFFSET ?"
+                # 默认：置顶 > 关注 > 创建时间降序
+                query += f" ORDER BY i.is_pinned DESC, i.is_starred DESC, i.created_at DESC LIMIT ? OFFSET ?"
             params.extend([limit, offset])
             
             cursor.execute(query, params)
@@ -517,6 +524,31 @@ class Database:
             conn.commit()
             return cursor.rowcount > 0
     
+    def toggle_pin(self, item_id: int) -> bool:
+        """切换置顶状态"""
+        with self.get_conn() as conn:
+            cursor = conn.cursor()
+            # 先获取当前状态
+            cursor.execute("SELECT is_pinned FROM items WHERE id = ?", (item_id,))
+            row = cursor.fetchone()
+            if not row:
+                return False
+            
+            new_status = 0 if row['is_pinned'] else 1
+            now = datetime.now().isoformat()
+            cursor.execute("UPDATE items SET is_pinned = ?, updated_at = ? WHERE id = ?", (new_status, now, item_id))
+            conn.commit()
+            return True
+    
+    def set_pin(self, item_id: int, pinned: bool = True) -> bool:
+        """设置置顶状态"""
+        with self.get_conn() as conn:
+            cursor = conn.cursor()
+            now = datetime.now().isoformat()
+            cursor.execute("UPDATE items SET is_pinned = ?, updated_at = ? WHERE id = ?", (1 if pinned else 0, now, item_id))
+            conn.commit()
+            return cursor.rowcount > 0
+    
     def increment_views(self, item_id: int) -> bool:
         """增加阅读数"""
         with self.get_conn() as conn: