初始提交：浏览器首页 MyHomePage 全栈项目

# 项目概述
个人浏览器首页导航应用，支持书签分类管理、搜索引擎快捷搜索、
必应每日壁纸轮播、前后端分离部署，适配 1Panel 服务器（Docker 模式）。

# 技术栈
- 前端：Vue 3 + TypeScript + Vite + Pinia + Capacitor（Android 打包）
- 后端：.NET 8 + SqlSugar（多数据库） + SQLite/MySQL + Swashbuckle
- 部署：1Panel 应用商店自定义应用（Docker Compose 模式）

# 项目结构
- backend/    .NET 8 API 后端（8 个 Controller + 15 个 Service）
- frontend/   Vue 3 前端（19 个组件 + 9 个 API 模块 + 5 个 Store）
- docker/     Docker 部署文件（后端镜像 + Nginx 反代）
- docs/       部署手册（1Panel 实战版）
- scripts/    E2E 测试脚本

# 已实现功能
- 书签管理：增删改查 + 树形分类 + 拖拽排序 + 主色自适应
- 搜索引擎：8 个内置引擎 + 自定义引擎 + favicon 自动抓取
- 必应壁纸：每日轮播 + 多分辨率自动选择 + 1.6MP 质量优先
- 全局设置：主题/行为/数据/工具 4 分类 + 跨设备同步
- 文件上传：图标/书签/通用（容器持久化 + 跨域 URL 拼接）
- 同步：基于变更日志的设备间数据同步
- 跨域部署：前后端分离 + runtime config.json 无需重新编译

# 进度记录
- 已完成 P0~P52 共 53 个开发节点（详细见 说明文档.md）
- 当前版本：v1.0 部署就绪

# 部署文档
- README.md：项目说明 + 快速开始
- 说明文档.md：完整开发进度（中文）
- docs/DEPLOY.md：1Panel 部署手册（Docker 模式）

backend/Services/SyncService.cs

@@ -0,0 +1,60 @@
+using MyHomePage.Api.Models.Dtos;
+using MyHomePage.Api.Models.Entities;
+using SqlSugar;
+
+namespace MyHomePage.Api.Services;
+
+/// <inheritdoc />
+public class SyncService : ISyncService
+{
+    private readonly ISqlSugarClient _db;
+
+    public SyncService(ISqlSugarClient db) => _db = db;
+
+    /// <inheritdoc />
+    public async Task<SyncChangesResponse> GetChangesAsync(DateTime? since)
+    {
+        // 1. 增量变更记录
+        var changesQuery = _db.Queryable<SyncLog>().OrderBy(s => s.Id);
+        if (since.HasValue) changesQuery = changesQuery.Where(s => s.Timestamp > since.Value);
+
+        var logs = await changesQuery.ToListAsync();
+        var changes = logs.Select(l => new SyncChangeDto
+        {
+            EntityType = l.EntityType,
+            EntityId = l.EntityId,
+            Operation = l.Operation,
+            Timestamp = l.Timestamp
+        }).ToList();
+
+        // 2. 全量快照（无论 since 是否为空都返回，前端可以本地落库）
+        var snapshot = new SyncSnapshot();
+        var categories = await _db.Queryable<Category>().OrderBy(c => c.Sort).OrderBy(c => c.Id).ToListAsync();
+        snapshot.Categories = CategoryDto.BuildTree(categories);
+
+        var bookmarks = await _db.Queryable<Bookmark>().Where(b => !b.IsDeleted)
+            .OrderBy(b => b.Sort)
+            .OrderBy(b => b.Id)
+            .ToListAsync();
+        // P28 修复：用 BookmarkDto.FromEntity 共享映射，避免漏字段
+        snapshot.Bookmarks = bookmarks.Select(BookmarkDto.FromEntity).ToList();
+
+        var engines = await _db.Queryable<SearchEngine>().OrderBy(e => e.Sort).ToListAsync();
+        // P42 修复：用 SearchEngineDto.FromEntity 共享映射（之前手动 new 漏了 IconType/IconUrl/ColorBg，
+        // 同步后前端 store 拿到老 DTO，engineLogoStyle 命中兜底色块 → 引擎 logo "消失"）
+        snapshot.SearchEngines = engines.Select(SearchEngineDto.FromEntity).ToList();
+
+        var setting = await _db.Queryable<Setting>().InSingleAsync(1);
+        if (setting is not null)
+        {
+            snapshot.Settings = SettingDto.FromEntity(setting);
+        }
+
+        return new SyncChangesResponse
+        {
+            Changes = changes,
+            Snapshot = snapshot,
+            ServerTime = DateTime.UtcNow
+        };
+    }
+}