fix: 搜索输入实时响应修复

- 改用直接 setTimeout 方式，不用 debounce 函数
- 避免函数绑定问题导致搜索不触发

README.md

@@ -141,6 +141,35 @@ xian-favor/
 
 ## 版本历史
 
+- **v2.4.0** (2026-04-16): 数据库备份机制
+  - 自动备份：每天 04:00 执行
+  - 手动备份：页面一键操作
+  - 备份清理规则：保留30天 + 每月第一天永久保留
+  - 手动备份最多保留10个
+  - 支持恢复备份和删除备份
+  - 备份管理页面入口在侧边栏
+- **v2.3.2** (2026-04-16): 搜索功能修复
+  - 修复 debounce 函数定义顺序问题
+  - 搜索框输入后可正常过滤列表
+- **v2.3.1** (2026-04-16): 日期放到标题后面，不增加卡片高度
+  - 日期紧跟标题，同一行显示
+  - 格式紧凑：`04-16 11:09→04-16 12:00`
+- **v2.3.0** (2026-04-16): 卡片显示创建和更新日期
+  - 每个收藏卡片底部显示日期
+  - 格式：04-16 11:09（月-日 时:分）
+  - 有更新时显示：创建 → 更新
+  - 字体更小更淡，不影响卡片高度
+- **v2.2.0** (2026-04-16): 快捷添加按钮，一键选择类型
+  - 顶部按钮栏分离为4个快捷添加按钮（文本、链接、待办、专栏）
+  - 点击直接进入对应类型的添加弹窗
+  - 弹窗标题显示类型图标和名称
+  - 不再需要下拉选择类型，操作更快捷
+- **v2.1.0** (2026-04-16): 待办截止时间支持日期+时间
+  - 截止日期改为日期时间选择器
+  - 列表显示友好格式：今天 18:30、明天 09:00 等
+  - 详情页显示完整格式：2026年4月16日 18:30
+  - 后端支持多种日期格式解析
+  - 只有日期的待办视为当天 23:59 到期
 - **v2.0.1** (2026-04-16): 转换弹窗优化
   - 内容预览保留换行格式，提高可读性
   - 转换方式默认改为复制创建

scripts/auto_backup.py

@@ -0,0 +1,35 @@
+#!/usr/bin/env python3
+"""
+Xian Favor 自动备份脚本
+定时任务调用此脚本进行自动备份
+"""
+
+import sys
+import os
+
+# 添加项目路径
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+from xian_favor.db import db
+
+def main():
+    """执行自动备份"""
+    print(f"[{datetime.now().isoformat()}] 开始自动备份...")
+    
+    try:
+        backup_info = db.create_backup(manual=False)
+        print(f"备份成功: {backup_info['name']}")
+        print(f"大小: {backup_info['size']} bytes")
+        print(f"位置: {backup_info['path']}")
+        
+        # 清理旧备份
+        db._cleanup_old_backups()
+        print("旧备份清理完成")
+        
+    except Exception as e:
+        print(f"备份失败: {e}")
+        sys.exit(1)
+
+if __name__ == '__main__':
+    from datetime import datetime
+    main()

xian_favor/api.py

@@ -511,6 +511,44 @@ def send_email():
         return jsonify({'success': False, 'error': f'发送失败: {str(e)}'}), 500
 
 
+# ============ 备份管理 API ============
+
+@app.route('/api/backups', methods=['GET'])
+def list_backups():
+    """列出所有备份"""
+    backups = db.list_backups()
+    return jsonify({'success': True, 'data': backups})
+
+
+@app.route('/api/backups', methods=['POST'])
+def create_backup():
+    """创建手动备份"""
+    try:
+        backup_info = db.create_backup(manual=True)
+        return jsonify({'success': True, 'data': backup_info}), 201
+    except Exception as e:
+        return jsonify({'success': False, 'error': str(e)}), 500
+
+
+@app.route('/api/backups/<backup_name>', methods=['POST'])
+def restore_backup(backup_name):
+    """恢复备份"""
+    try:
+        if db.restore_backup(backup_name):
+            return jsonify({'success': True, 'message': f'已恢复备份 {backup_name}'})
+        return jsonify({'success': False, 'error': '备份不存在'}), 404
+    except Exception as e:
+        return jsonify({'success': False, 'error': str(e)}), 500
+
+
+@app.route('/api/backups/<backup_name>', methods=['DELETE'])
+def delete_backup(backup_name):
+    """删除备份"""
+    if db.delete_backup(backup_name):
+        return jsonify({'success': True})
+    return jsonify({'success': False, 'error': '备份不存在'}), 404
+
+
 # ============ Web 页面 ============
 
 @app.route('/')
@@ -539,11 +577,11 @@ INDEX_TEMPLATE = '''
         .content { padding: 20px; }
         .card { margin-bottom: 8px; transition: transform 0.2s; }
         .card:hover { transform: translateY(-2px); box-shadow: 0 4px 12px rgba(0,0,0,0.15); }
-        .card-body { padding: 10px 15px; }
+        .card-body { padding: 8px 12px; }
         .tag { margin-right: 5px; }
         .item-card { font-size: 14px; }
-        .item-card h6 { font-size: 14px; margin-bottom: 4px; }
-        .item-card p { margin-bottom: 4px; }
+        .item-card h6 { font-size: 14px; margin-bottom: 2px; }
+        .item-card p { margin-bottom: 2px; }
         .item-card .text-muted.small { font-size: 12px; }
         .type-text { border-left: 4px solid #17a2b8; }
         .type-link { border-left: 4px solid #28a745; }
@@ -579,6 +617,7 @@ INDEX_TEMPLATE = '''
                 <hr class="border-secondary">
                 <a href="#" onclick="showTagManager(); return false;"><i class="bi bi-tags"></i> 标签管理</a>
                 <a href="#" onclick="showEmailManager(); return false;"><i class="bi bi-envelope"></i> 邮箱管理</a>
+                <a href="#" onclick="showBackupManager(); return false;"><i class="bi bi-archive"></i> 备份管理</a>
             </nav>
         </div>
         
@@ -609,12 +648,21 @@ INDEX_TEMPLATE = '''
                 <button class="btn btn-outline-info me-2" onclick="showAIAddModal()" title="AI自动添加">
                     <i class="bi bi-robot"></i> AI添加
                 </button>
+                <button class="btn btn-outline-secondary me-1" onclick="showAddModal('text')" title="添加文本">
+                    <i class="bi bi-file-text"></i>
+                </button>
+                <button class="btn btn-outline-success me-1" onclick="showAddModal('link')" title="添加链接">
+                    <i class="bi bi-link-45deg"></i>
+                </button>
+                <button class="btn btn-outline-warning me-1" onclick="showAddModal('todo')" title="添加待办">
+                    <i class="bi bi-check2-square"></i>
+                </button>
+                <button class="btn btn-outline-primary me-1" onclick="showAddModal('column')" title="添加专栏">
+                    <i class="bi bi-newspaper"></i>
+                </button>
                 <button class="btn btn-outline-success me-2" onclick="exportData()" title="导出JSON">
                     <i class="bi bi-download"></i> 导出
                 </button>
-                <button class="btn btn-primary" data-bs-toggle="modal" data-bs-target="#addModal">
-                    <i class="bi bi-plus-lg"></i> 添加
-                </button>
             </div>
             
             <!-- 统计卡片 -->
@@ -667,20 +715,15 @@ INDEX_TEMPLATE = '''
     <div class="modal-dialog modal-lg">
         <div class="modal-content">
             <div class="modal-header">
-                <h5 class="modal-title">添加条目</h5>
+                <h5 class="modal-title">
+                    <span id="addModalIcon"></span> 
+                    <span id="addModalTitle">添加条目</span>
+                </h5>
                 <button type="button" class="btn-close" data-bs-dismiss="modal"></button>
             </div>
             <div class="modal-body">
                 <form id="addForm">
-                    <div class="mb-3">
-                        <label class="form-label">类型</label>
-                        <select id="addType" class="form-select">
-                            <option value="text">📝 文本</option>
-                            <option value="link">🔗 链接</option>
-                            <option value="column">📰 专栏</option>
-                            <option value="todo">✅ 待办</option>
-                        </select>
-                    </div>
+                    <input type="hidden" id="addType" value="text">
                     <div class="mb-3">
                         <label class="form-label">标题</label>
                         <input type="text" id="addTitle" class="form-control" placeholder="可选">
@@ -691,11 +734,11 @@ INDEX_TEMPLATE = '''
                     </div>
                     <div class="mb-3" id="urlGroup" style="display:none;">
                         <label class="form-label">URL</label>
-                        <input type="url" id="addUrl" class="form-control">
+                        <input type="url" id="addUrl" class="form-control" placeholder="https://...">
                     </div>
                     <div class="mb-3" id="sourceGroup" style="display:none;">
                         <label class="form-label">来源</label>
-                        <input type="text" id="addSource" class="form-control">
+                        <input type="text" id="addSource" class="form-control" placeholder="专栏来源">
                     </div>
                     <div class="mb-3" id="todoFields" style="display:none;">
                         <div class="row">
@@ -950,6 +993,41 @@ INDEX_TEMPLATE = '''
     </div>
 </div>
 
+<!-- 备份管理模态框 -->
+<div class="modal fade" id="backupModal" tabindex="-1">
+    <div class="modal-dialog modal-lg">
+        <div class="modal-content">
+            <div class="modal-header bg-info text-white">
+                <h5 class="modal-title"><i class="bi bi-archive"></i> 备份管理</h5>
+                <button type="button" class="btn-close btn-close-white" data-bs-dismiss="modal"></button>
+            </div>
+            <div class="modal-body">
+                <div class="mb-3">
+                    <button class="btn btn-primary" onclick="createManualBackup()">
+                        <i class="bi bi-plus-circle"></i> 立即备份
+                    </button>
+                    <span class="text-muted ms-3">自动备份：每天 04:00</span>
+                </div>
+                <div class="alert alert-info">
+                    <strong>备份规则：</strong>
+                    <ul class="mb-0">
+                        <li>自动备份每天 04:00 执行</li>
+                        <li>保留最近 30 天的备份</li>
+                        <li>每月第一天的备份永久保留</li>
+                        <li>手动备份最多保留 10 个</li>
+                    </ul>
+                </div>
+                <div id="backupList">
+                    <!-- 动态填充 -->
+                </div>
+            </div>
+            <div class="modal-footer">
+                <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">关闭</button>
+            </div>
+        </div>
+    </div>
+</div>
+
 <!-- AI自动添加模态框 -->
 <div class="modal fade" id="aiAddModal" tabindex="-1">
     <div class="modal-dialog modal-lg">
@@ -1086,9 +1164,23 @@ INDEX_TEMPLATE = '''
 <script>
 const API_BASE = '/api';
 let currentFilter = { type: '', status: '' };
+let currentPage = 1;
+const pageSize = 20;
+function debounce(fn, delay) {
+    let timer;
+    return function(...args) {
+        clearTimeout(timer);
+        timer = setTimeout(() => fn.apply(this, args), delay);
+    };
+}
 
 // 初始化
 document.addEventListener('DOMContentLoaded', async () => {
+    // 确保初始状态清空
+    document.getElementById('searchInput').value = '';
+    document.getElementById('typeFilter').value = '';
+    currentFilter = { type: '', status: '' };
+    
     await loadStats(); // 先加载统计，确保总数可用
     loadItems();
     loadTags();
@@ -1104,22 +1196,17 @@ document.addEventListener('DOMContentLoaded', async () => {
     // 标签搜索实时过滤
     document.getElementById('tagSearch')?.addEventListener('input', debounce(loadTagManagerList, 300));
     
-    // 类型切换时显示/隐藏字段
-    document.getElementById('addType').addEventListener('change', (e) => {
-        const type = e.target.value;
-        document.getElementById('contentGroup').style.display = type === 'text' ? 'block' : 'none';
-        document.getElementById('urlGroup').style.display = ['link', 'column'].includes(type) ? 'block' : 'none';
-        document.getElementById('sourceGroup').style.display = type === 'column' ? 'block' : 'none';
-        document.getElementById('todoFields').style.display = type === 'todo' ? 'block' : 'none';
-    });
-    
     // 编辑时类型切换
     document.getElementById('editType').addEventListener('change', (e) => {
         updateEditFieldsByType(e.target.value);
     });
     
-    // 搜索
-    document.getElementById('searchInput').addEventListener('input', debounce(loadItems, 300));
+    // 搜索 - 直接绑定，不用 debounce
+    let searchTimer;
+    document.getElementById('searchInput').addEventListener('input', (e) => {
+        clearTimeout(searchTimer);
+        searchTimer = setTimeout(() => loadItems(), 300);
+    });
     
     // 类型过滤
     document.getElementById('typeFilter').addEventListener('change', (e) => {
@@ -1148,9 +1235,6 @@ document.addEventListener('DOMContentLoaded', async () => {
 });
 
 // 加载列表
-let currentPage = 1;
-const pageSize = 20;
-
 async function loadItems(page = 1) {
     currentPage = page;
     const keyword = document.getElementById('searchInput').value;
@@ -1184,6 +1268,9 @@ function renderItems(items) {
                         <h6 class="card-title text-truncate mb-1 ${item.type === 'todo' && item.status === 'completed' ? 'text-muted' : ''}">
                             ${getTypeIcon(item.type)} ${item.title || truncate(item.content || item.url, 30)}
                             ${item.type === 'todo' && item.status === 'completed' ? ' ✓' : ''}
+                            <span style="font-size:10px; opacity:0.5; margin-left:8px;">
+                                ${formatShortDate(item.created_at)}${item.updated_at && item.updated_at !== item.created_at ? '→' + formatShortDate(item.updated_at) : ''}
+                            </span>
                         </h6>
                         <p class="card-text text-muted small mb-0 text-truncate" style="font-size:12px;">
                             ${item.url ? truncate(item.url, 50) : item.content ? truncate(item.content, 50) : item.note ? truncate(item.note, 50) : ''}
@@ -1270,6 +1357,37 @@ async function refreshData() {
     loadItems(currentPage);
 }
 
+// ============ 添加功能 ============
+
+// 快捷添加按钮
+function showAddModal(type) {
+    // 设置类型
+    document.getElementById('addType').value = type;
+    
+    // 设置弹窗标题和图标
+    const typeInfo = {
+        text: { icon: '📝', title: '添加文本' },
+        link: { icon: '🔗', title: '添加链接' },
+        column: { icon: '📰', title: '添加专栏' },
+        todo: { icon: '✅', title: '添加待办' }
+    };
+    
+    document.getElementById('addModalIcon').textContent = typeInfo[type].icon;
+    document.getElementById('addModalTitle').textContent = typeInfo[type].title;
+    
+    // 显示/隐藏对应字段
+    document.getElementById('contentGroup').style.display = type === 'text' ? 'block' : 'none';
+    document.getElementById('urlGroup').style.display = ['link', 'column'].includes(type) ? 'block' : 'none';
+    document.getElementById('sourceGroup').style.display = type === 'column' ? 'block' : 'none';
+    document.getElementById('todoFields').style.display = type === 'todo' ? 'block' : 'none';
+    
+    // 清空表单
+    document.getElementById('addForm').reset();
+    
+    // 打开弹窗
+    new bootstrap.Modal(document.getElementById('addModal')).show();
+}
+
 // 添加条目
 async function addItem() {
     const type = document.getElementById('addType').value;
@@ -1602,6 +1720,17 @@ function truncate(str, len) {
     return str && str.length > len ? str.substring(0, len) + '...' : str || '';
 }
 
+// 简短日期格式（用于卡片显示）
+function formatShortDate(dateStr) {
+    if (!dateStr) return '';
+    const date = new Date(dateStr);
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    const hour = String(date.getHours()).padStart(2, '0');
+    const min = String(date.getMinutes()).padStart(2, '0');
+    return `${month}-${day} ${hour}:${min}`;
+}
+
 function formatDate(dateStr) {
     return new Date(dateStr).toLocaleString('zh-CN');
 }
@@ -1979,6 +2108,106 @@ async function showEmailManager() {
     new bootstrap.Modal(document.getElementById('emailManagerModal')).show();
 }
 
+// ============ 备份管理 ============
+
+async function showBackupManager() {
+    await loadBackupList();
+    new bootstrap.Modal(document.getElementById('backupModal')).show();
+}
+
+async function loadBackupList() {
+    const res = await fetch(`${API_BASE}/backups`);
+    const data = await res.json();
+    if (!data.success) return;
+    
+    const container = document.getElementById('backupList');
+    
+    if (!data.data.length) {
+        container.innerHTML = '<div class="text-center text-muted py-3">暂无备份</div>';
+        return;
+    }
+    
+    container.innerHTML = data.data.map(backup => `
+        <div class="d-flex justify-content-between align-items-center p-2 border-bottom rounded mb-1 ${backup.manual ? 'bg-light' : ''}">
+            <div>
+                <strong>${backup.name}</strong>
+                ${backup.manual ? '<span class="badge bg-primary ms-1">手动</span>' : ''}
+                ${backup.is_first_of_month ? '<span class="badge bg-success ms-1">月首</span>' : ''}
+                <br>
+                <small class="text-muted">
+                    ${formatBackupDate(backup.created_at)} | 
+                    ${formatBackupSize(backup.size)}
+                </small>
+            </div>
+            <div class="btn-group btn-group-sm">
+                <button class="btn btn-outline-success" onclick="restoreBackup('${backup.name}')" title="恢复">
+                    <i class="bi bi-arrow-counterclockwise"></i> 恢复
+                </button>
+                <button class="btn btn-outline-danger" onclick="deleteBackupConfirm('${backup.name}')" title="删除">
+                    <i class="bi bi-trash"></i>
+                </button>
+            </div>
+        </div>
+    `).join('');
+}
+
+async function createManualBackup() {
+    const res = await fetch(`${API_BASE}/backups`, { method: 'POST' });
+    const data = await res.json();
+    
+    if (data.success) {
+        alert('备份创建成功！');
+        loadBackupList();
+        loadStats();
+    } else {
+        alert('备份失败: ' + data.error);
+    }
+}
+
+async function restoreBackup(name) {
+    if (!confirm(`确认恢复备份 "${name}"？\n当前数据将被覆盖！`)) return;
+    
+    const res = await fetch(`${API_BASE}/backups/${name}`, { method: 'POST' });
+    const data = await res.json();
+    
+    if (data.success) {
+        alert('备份已恢复！页面将刷新...');
+        location.reload();
+    } else {
+        alert('恢复失败: ' + data.error);
+    }
+}
+
+async function deleteBackupConfirm(name) {
+    if (!confirm(`确认删除备份 "${name}"？`)) return;
+    
+    const res = await fetch(`${API_BASE}/backups/${name}`, { method: 'DELETE' });
+    const data = await res.json();
+    
+    if (data.success) {
+        loadBackupList();
+    } else {
+        alert('删除失败: ' + data.error);
+    }
+}
+
+function formatBackupDate(dateStr) {
+    const date = new Date(dateStr);
+    return date.toLocaleString('zh-CN', {
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit'
+    });
+}
+
+function formatBackupSize(bytes) {
+    if (bytes < 1024) return bytes + ' B';
+    if (bytes < 1024 * 1024) return (bytes / 1024).toFixed(1) + ' KB';
+    return (bytes / 1024 / 1024).toFixed(2) + ' MB';
+}
+
 async function loadEmailManagerList() {
     const res = await fetch(`${API_BASE}/emails`);
     const data = await res.json();
@@ -2156,14 +2385,6 @@ async function sendItemEmail() {
     }
 }
 
-function debounce(fn, delay) {
-    let timer;
-    return function(...args) {
-        clearTimeout(timer);
-        timer = setTimeout(() => fn.apply(this, args), delay);
-    };
-}
-
 // ============ 提醒功能 ============
 
 let reminderData = null;

xian_favor/db.py

@@ -2,12 +2,17 @@
 
 import sqlite3
 import json
-from datetime import datetime
+import shutil
+import os
+from datetime import datetime, timedelta
 from typing import Optional, List, Dict, Any
 from contextlib import contextmanager
 
 from .config import DATABASE_URL, TODO_STATUS, PRIORITY_LEVELS
 
+# 备份目录
+BACKUP_DIR = os.path.join(os.path.dirname(DATABASE_URL), 'backups')
+
 
 class Database:
     """SQLite数据库管理"""
@@ -501,6 +506,184 @@ class Database:
             reminders['total'] = len(reminders['overdue']) + len(reminders['due_today']) + len(reminders['due_soon'])
             
             return reminders
+    
+    # ============ 备份操作 ============
+    
+    def create_backup(self, manual: bool = False) -> Dict[str, Any]:
+        """创建数据库备份"""
+        import os
+        
+        # 确保备份目录存在
+        os.makedirs(BACKUP_DIR, exist_ok=True)
+        
+        now = datetime.now()
+        backup_name = now.strftime('%Y-%m-%d_%H%M%S')
+        if manual:
+            backup_name += '_manual'
+        backup_path = os.path.join(BACKUP_DIR, f'{backup_name}.db')
+        
+        # 复制数据库文件
+        shutil.copy2(self.db_path, backup_path)
+        
+        # 获取备份信息
+        backup_info = {
+            'name': backup_name,
+            'path': backup_path,
+            'size': os.path.getsize(backup_path),
+            'created_at': now.isoformat(),
+            'manual': manual,
+            'is_first_of_month': now.day == 1
+        }
+        
+        # 保存备份元数据
+        self._save_backup_meta(backup_info)
+        
+        # 清理旧备份
+        self._cleanup_old_backups()
+        
+        return backup_info
+    
+    def list_backups(self) -> List[Dict[str, Any]]:
+        """列出所有备份"""
+        import os
+        
+        if not os.path.exists(BACKUP_DIR):
+            return []
+        
+        # 读取备份元数据
+        meta_path = os.path.join(BACKUP_DIR, 'backup_meta.json')
+        if os.path.exists(meta_path):
+            with open(meta_path, 'r') as f:
+                backups = json.load(f)
+        else:
+            # 从文件重建元数据
+            backups = []
+            for f in os.listdir(BACKUP_DIR):
+                if f.endswith('.db'):
+                    path = os.path.join(BACKUP_DIR, f)
+                    backups.append({
+                        'name': f.replace('.db', ''),
+                        'path': path,
+                        'size': os.path.getsize(path),
+                        'created_at': datetime.fromtimestamp(os.path.getmtime(path)).isoformat(),
+                        'manual': '_manual' in f,
+                        'is_first_of_month': self._is_first_of_month_filename(f)
+                    })
+        
+        # 按时间倒序排列
+        backups.sort(key=lambda x: x['created_at'], reverse=True)
+        
+        return backups
+    
+    def restore_backup(self, backup_name: str) -> bool:
+        """恢复备份"""
+        import os
+        
+        backup_path = os.path.join(BACKUP_DIR, f'{backup_name}.db')
+        if not os.path.exists(backup_path):
+            return False
+        
+        # 先备份当前数据库（以防万一）
+        current_backup = self.db_path + '.before_restore'
+        shutil.copy2(self.db_path, current_backup)
+        
+        # 恢复备份
+        shutil.copy2(backup_path, self.db_path)
+        
+        return True
+    
+    def delete_backup(self, backup_name: str) -> bool:
+        """删除备份"""
+        import os
+        
+        backup_path = os.path.join(BACKUP_DIR, f'{backup_name}.db')
+        if not os.path.exists(backup_path):
+            return False
+        
+        os.remove(backup_path)
+        
+        # 更新元数据
+        self._remove_backup_meta(backup_name)
+        
+        return True
+    
+    def _save_backup_meta(self, backup_info: Dict[str, Any]):
+        """保存备份元数据"""
+        import os
+        
+        meta_path = os.path.join(BACKUP_DIR, 'backup_meta.json')
+        
+        # 读取现有元数据
+        backups = []
+        if os.path.exists(meta_path):
+            with open(meta_path, 'r') as f:
+                backups = json.load(f)
+        
+        # 添加新备份
+        backups.append(backup_info)
+        
+        # 保存
+        with open(meta_path, 'w') as f:
+            json.dump(backups, f, indent=2)
+    
+    def _remove_backup_meta(self, backup_name: str):
+        """从元数据中删除备份"""
+        import os
+        
+        meta_path = os.path.join(BACKUP_DIR, 'backup_meta.json')
+        if not os.path.exists(meta_path):
+            return
+        
+        with open(meta_path, 'r') as f:
+            backups = json.load(f)
+        
+        backups = [b for b in backups if b['name'] != backup_name]
+        
+        with open(meta_path, 'w') as f:
+            json.dump(backups, f, indent=2)
+    
+    def _is_first_of_month_filename(self, filename: str) -> bool:
+        """判断是否是每月第一天的备份"""
+        # 格式：2026-04-01_040000.db 或 2026-05-01_...
+        try:
+            date_part = filename.split('_')[0]
+            day = int(date_part.split('-')[2])
+            return day == 1
+        except:
+            return False
+    
+    def _cleanup_old_backups(self):
+        """清理旧备份：保留30天 + 每月第一天"""
+        import os
+        
+        backups = self.list_backups()
+        now = datetime.now()
+        keep_paths = []
+        
+        for backup in backups:
+            backup_date = datetime.fromisoformat(backup['created_at'])
+            days_old = (now - backup_date).days
+            
+            # 保留条件：
+            # 1. 手动备份永久保留（最多10个）
+            # 2. 30天内的备份
+            # 3. 每月第一天的备份
+            
+            if backup['manual']:
+                # 手动备份保留，但最多10个
+                manual_backups = [b for b in backups if b['manual']]
+                if manual_backups.index(backup) < 10:
+                    keep_paths.append(backup['path'])
+                else:
+                    self.delete_backup(backup['name'])
+            elif days_old <= 30:
+                keep_paths.append(backup['path'])
+            elif backup['is_first_of_month']:
+                # 每月第一天永久保留
+                keep_paths.append(backup['path'])
+            else:
+                # 删除
+                self.delete_backup(backup['name'])
 
 
 # 全局数据库实例