初始提交：浏览器首页 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/Models/Dtos/CategoryDtos.cs

@@ -0,0 +1,82 @@
+using MyHomePage.Api.Models.Entities;
+
+namespace MyHomePage.Api.Models.Dtos;
+
+/// <summary>分类输出 DTO（包含二级子项）</summary>
+public class CategoryDto
+{
+    public int Id { get; set; }
+    public int ParentId { get; set; }
+    public string Name { get; set; } = string.Empty;
+    public string? Icon { get; set; }
+    public int Sort { get; set; }
+    public DateTime CreatedAt { get; set; }
+    public DateTime UpdatedAt { get; set; }
+    public List<CategoryDto> Children { get; set; } = new();
+
+    /// <summary>
+    /// 把扁平的 Category 实体集合构建为树形 DTO 列表。
+    /// 规则：parentId == 0 → 顶级；其余 → 挂到对应父分类的 Children 下。
+    /// 若父分类在当前集合中不存在（孤儿），降级为顶级。
+    /// 子项按 Sort, Id 升序排列。
+    /// </summary>
+    public static List<CategoryDto> BuildTree(IEnumerable<Category> entities)
+    {
+        var list = entities
+            .Select(c => new CategoryDto
+            {
+                Id = c.Id,
+                ParentId = c.ParentId,
+                Name = c.Name,
+                Icon = c.Icon,
+                Sort = c.Sort,
+                CreatedAt = c.CreatedAt,
+                UpdatedAt = c.UpdatedAt
+            })
+            .ToList();
+        return BuildTreeFromFlat(list);
+    }
+
+    /// <summary>
+    /// 把扁平的 DTO 集合构建为树形 DTO 列表（按 Id 重新组织父子关系）。
+    /// </summary>
+    public static List<CategoryDto> BuildTreeFromFlat(IEnumerable<CategoryDto> flat)
+    {
+        var all = flat.ToList();
+        var byId = all.ToDictionary(d => d.Id);
+        var roots = new List<CategoryDto>();
+
+        // 重置所有 Children（防止调用方传入了预填的 Children 造成重复）
+        foreach (var d in all) d.Children = new List<CategoryDto>();
+
+        foreach (var d in all.OrderBy(x => x.Sort).ThenBy(x => x.Id))
+        {
+            if (d.ParentId == 0 || !byId.TryGetValue(d.ParentId, out var parent))
+            {
+                // 顶级 OR 孤儿（父分类不存在）→ 降级为顶级
+                roots.Add(d);
+            }
+            else
+            {
+                parent.Children.Add(d);
+            }
+        }
+
+        // 给每个父分类的 children 排序
+        foreach (var r in roots)
+        {
+            r.Children = r.Children.OrderBy(x => x.Sort).ThenBy(x => x.Id).ToList();
+        }
+        return roots;
+    }
+}
+
+/// <summary>分类创建/更新入参</summary>
+public class CategoryUpsertRequest
+{
+    public int? Id { get; set; }
+    public int ParentId { get; set; }
+    public string Name { get; set; } = string.Empty;
+    public string? Icon { get; set; }
+    public int Sort { get; set; }
+}