初始提交:浏览器首页 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 模式)
This commit is contained in:
2026-07-05 05:09:56 +08:00
commit 68be41e7a2
129 changed files with 15900 additions and 0 deletions
+67
View File
@@ -0,0 +1,67 @@
{
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft.AspNetCore": "Warning",
"SqlSugar": "Information"
}
},
"AllowedHosts": "*",
"Urls": "http://0.0.0.0:5080",
"Database": {
// ===== 当前默认:SQLite(开发 / 单机部署) =====
"Provider": "Sqlite",
"ConnectionString": "Data Source=myhomepage.db",
// ======================================================================
// 部署到 MySQL 时切换方式(任选其一,1Panel 推荐方式 C)
// ======================================================================
//
// 方式 A:直接修改本文件(不推荐,会被提交到 git,不便多环境管理)
// "Provider": "MySql",
// "ConnectionString": "server=127.0.0.1;port=3306;database=myhomepage;user=myhomepage_user;password=YOUR_PASSWORD;charset=utf8mb4;",
//
// 方式 B:新建 backend/appsettings.Production.json 覆盖 Database 节
// 内容:
// {
// "Database": {
// "Provider": "MySql",
// "ConnectionString": "server=127.0.0.1;port=3306;database=myhomepage;user=myhomepage_user;password=YOUR_PASSWORD;charset=utf8mb4;"
// }
// }
// 启动时设环境变量 ASPNETCORE_ENVIRONMENT=Production 即生效
//
// 方式 C(1Panel 推荐,零文件改动):
// 在 1Panel 网站详情页 → 「环境变量」里设:
// Database__Provider=MySql
// Database__ConnectionString=server=127.0.0.1;port=3306;database=myhomepage;user=myhomepage_user;password=xxx;charset=utf8mb4;
// ASP.NET Core 配置系统会自动用环境变量覆盖 appsettings.json 里的 Database 节
//
// 连接串参数说明:
// server MySQL 主机(1Panel 部署本机用 127.0.0.1;远程用实际 IP
// port 端口(默认 3306
// database 数据库名(需要先在 1Panel 数据库面板建好,utf8mb4 字符集)
// user 用户名(建议建专用用户,权限限定在 myhomepage 库,主机锁 localhost
// password 用户密码(如果含特殊字符需 URL encode# → %23@ → %40; → %3B 等)
// charset 字符集(务必 utf8mb4,否则 emoji 存不进)
// 其他可选 SslMode=None/RequiredPooling=trueTreatTinyAsBoolean=true 等
// ======================================================================
},
"Upload": {
// P52 修复:1Panel Docker 部署时改成 "/uploads"(绝对路径)让 volume 挂载生效
// - 容器内路径 = 宿主机 /data/myhomepage/upload
// - 容器销毁后 favicon 仍然保留
// - 不污染 /app 代码目录
// 本地 dev / 单机 SQLite 时用 "Uploads"(相对路径 = /app/Uploads)即可
"Path": "/uploads",
"BaseUrl": "/uploads",
"MaxSizeBytes": 10485760
},
"Cors": {
"Origins": [
"http://localhost:5173",
"http://localhost:4173",
"http://localhost:3000"
]
}
}