初始提交：浏览器首页 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 模式）

docker/README.md

@@ -0,0 +1,44 @@
+# Docker 部署说明
+
+## 快速启动
+
+```bash
+# 1. 启动（首次会构建镜像，5-10 分钟）
+docker compose up -d --build
+
+# 2. 查看日志
+docker compose logs -f backend
+
+# 3. 停止
+docker compose down
+
+# 4. 清理（含数据卷）
+docker compose down -v
+```
+
+启动后访问：
+- 前端 + 后端（同一镜像）: http://localhost:8080
+- Swagger: http://localhost:8080/swagger
+- MySQL: 127.0.0.1:3306（用户 `myhomepage`，密码见 `docker-compose.yml` 或环境变量 `MYSQL_PASSWORD`）
+
+## 数据库切换
+
+默认使用 MySQL。如需切换到 SQLite，修改 `docker-compose.yml` 中 `backend` 的环境变量：
+
+```yaml
+Database__Provider: Sqlite
+Database__ConnectionString: "Data Source=/app/data/myhomepage.db"
+volumes:
+  - sqlite-data:/app/data
+```
+
+并添加卷：
+```yaml
+volumes:
+  sqlite-data:
+```
+
+## 上传目录
+
+上传文件落到容器内 `/app/Uploads`，通过 `uploads-data` 卷持久化。
+可通过环境变量 `Upload__Path` 修改（必须以 `/` 开头表示容器内绝对路径）。

docker/backend.Dockerfile

@@ -0,0 +1,29 @@
+# 多阶段构建：先编译前端，再打包后端 + 前端 + Nginx
+# 第一阶段：编译前端
+FROM node:20-alpine AS frontend
+WORKDIR /web
+# 仅复制 package.json 以利用缓存
+COPY frontend/package.json frontend/package-lock.json* ./
+RUN npm install --no-audit --no-fund
+COPY frontend/ ./
+RUN npm run build
+
+# 第二阶段：发布 .NET 后端
+FROM mcr.microsoft.com/dotnet/sdk:8.0 AS backend
+WORKDIR /src
+COPY backend/*.csproj ./
+RUN dotnet restore
+COPY backend/ ./
+RUN dotnet publish -c Release -o /app /p:UseAppHost=false
+
+# 第三阶段：运行时镜像（Nginx + .NET）
+FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS runtime
+WORKDIR /app
+COPY --from=backend /app ./
+# 把前端构建产物复制到后端的 wwwroot
+COPY --from=frontend /web/dist ./wwwroot
+
+ENV ASPNETCORE_URLS=http://+:8080
+ENV ASPNETCORE_ENVIRONMENT=Production
+EXPOSE 8080
+ENTRYPOINT ["dotnet", "MyHomePage.Api.dll"]

docker/nginx.conf

@@ -0,0 +1,26 @@
+# 反向给本机后端的示例（仅供参考；当前部署不依赖 nginx，前后端同镜像）
+server {
+    listen 80;
+    server_name _;
+
+    client_max_body_size 20M;
+
+    # 前端静态资源
+    location / {
+        root /usr/share/nginx/html;
+        try_files $uri $uri/ /index.html;
+    }
+
+    # 后端 API
+    location /api/ {
+        proxy_pass http://backend:8080;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    }
+
+    # 上传文件
+    location /uploads/ {
+        proxy_pass http://backend:8080;
+    }
+}