# BestPersonPages **Repository Path**: yangxiaoyude/best-person-pages ## Basic Information - **Project Name**: BestPersonPages - **Description**: 世界上最好的个人作品展示界面 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 2 - **Forks**: 0 - **Created**: 2026-02-18 - **Last Updated**: 2026-03-21 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
# 个人引导页

一个简洁优雅的个人主页导航系统

![License](https://img.shields.io/badge/license-MIT-blue.svg) ![Python](https://img.shields.io/badge/python-3.8+-blue.svg) ![FastAPI](https://img.shields.io/badge/FastAPI-0.100+-green.svg) ![Vue](https://img.shields.io/badge/vue-3.x-green.svg)

在线演示 • Gitee • 快速开始 • 功能特性

--- ## 在线演示 **预览地址：** [https://www.mytx.fun](https://www.mytx.fun) ## 项目截图
### 前台页面 ![前台首页](screenshots/home.png)

前台首页 - 樱花飘落效果，居中导航布局

### 后台管理 - 基础设置 ![基础设置](screenshots/admin-basic.png)

基础设置 - 网站标题、管理路径、备案信息配置

### 后台管理 - 外观设置 ![外观设置](screenshots/admin-appearance.png)

外观设置 - 特效开关、背景音乐、联系方式配置

--- ## 功能特性
**外观定制** - 支持图片/视频背景，可随机切换 - 自定义头像和个人信息 - 樱花飘落特效 - 点击烟花效果 - 点击糖豆效果 - 背景音乐播放 **功能丰富** - 快捷链接管理（拖拽排序） - 访客统计（今日/总计） - 网站运行时长 - 响应式设计（PC/移动端自适应） - 联系方式弹窗（二维码+文字） - 自定义管理路径
**管理后台** - 背景库管理 - 头像库管理 - 音乐上传管理 - 实时预览功能 - Element Plus UI **技术栈** - FastAPI + SQLAlchemy - Vue 3 + Element Plus - SQLite 数据库 - Canvas 动画特效
--- ## 快速开始 ### 环境要求 - Python 3.8+ ### 一键部署 ```bash # 1. 克隆项目 git clone https://gitee.com/yangxiaoyude/best-person-pages.git cd best-person-pages # 2. 启动服务 bash start.sh # 选择 2. 持久运行 # 3. 访问应用 # 浏览器打开: http://localhost:6636 ``` ### 服务管理 运行 `bash start.sh` 后会显示菜单： ``` 1. 测试运行 (前台运行，可查看实时日志) 2. 持久运行 (后台运行，服务持久化) 3. 停止服务 4. 查看日志 5. 退出 ``` | 选项 | 说明 | 适用场景 | |------|------|----------| | 测试运行 | 前台运行，Ctrl+C 停止 | 开发调试 | | 持久运行 | 后台运行，服务持久化 | 生产环境 | | 停止服务 | 停止后台服务 | 维护更新 | | 查看日志 | 实时查看运行日志 | 问题排查 | ### 默认文件 确保 `uploads/` 目录下有以下文件： - `avatar.jpg` - 默认头像 - `back.png` - 默认背景 - `music.mp3` - 默认音乐 --- ## 使用说明 ### 首次配置
| 步骤 | 操作 | |:----:|------| | 1 | 访问管理后台（默认路径：`http://localhost:6636/admin`） | | 2 | **重要**：立即修改管理路径为自己记得住的路径 | | 3 | 配置网站标题、副标题 | | 4 | 上传头像和背景图片 | | 5 | 添加快捷链接 |
### 功能配置 **基础设置** - 网站标题/副标题 - 管理路径（强烈建议修改） - 建站日期（用于计算运行时长） - 备案号及链接 **外观设置** - 头像与标题显示开关 - 樱花特效开关 - 烟花效果开关 - 糖豆效果开关 - 背景音乐开关 - 访客统计开关 - 运行时长开关 - 联系方式开关 **背景库** - 上传图片/视频背景 - 指定背景或随机背景 - 删除背景（使用中的背景不可删除） **头像库** - 上传多个头像 - 快速切换头像 - 删除头像（使用中的头像不可删除） **链接管理** - 添加/编辑/删除链接 - 拖拽排序（PC端横向，移动端纵向） - 显示/隐藏开关 --- ## 项目结构 ``` best-person-pages/ ├── static/ # 前端构建产物（已打包） ├── uploads/ # 上传文件目录 │ ├── avatar.jpg # 默认头像 │ ├── back.png # 默认背景 │ └── music.mp3 # 默认音乐 ├── venv/ # 虚拟环境（自动创建） ├── screenshots/ # 项目截图 ├── main.py # FastAPI 主程序 ├── models.py # 数据模型 ├── schemas.py # Pydantic 模型 ├── database.py # 数据库配置 ├── visitor.py # 访客统计 ├── requirements.txt # Python 依赖 ├── start.sh # 服务管理脚本 ├── git_push.sh # Git 推送脚本 ├── app.pid # 进程 PID（运行时生成） ├── app.log # 运行日志（后台模式） ├── personal_guide.db # SQLite 数据库 └── README.md # 项目文档 ``` --- ## 技术栈
### 后端技术 | 技术 | 说明 | |------|------| | FastAPI | 现代化的 Python Web 框架 | | SQLAlchemy | ORM 数据库操作 | | SQLite | 轻量级数据库 | | Pydantic | 数据验证 | ### 前端技术 | 技术 | 说明 | |------|------| | Vue 3 | 渐进式 JavaScript 框架 | | Element Plus | Vue 3 UI 组件库 | | Vite | 下一代前端构建工具 | | Axios | HTTP 客户端 | | Sortable.js | 拖拽排序库 |
--- ## API 接口
点击展开查看 API 文档 ### 配置管理 - `GET /api/config` - 获取配置 - `PUT /api/config` - 更新配置 ### 链接管理 - `GET /api/links` - 获取可见链接 - `GET /api/links/all` - 获取所有链接 - `POST /api/links` - 创建链接 - `PUT /api/links/{id}` - 更新链接 - `DELETE /api/links/{id}` - 删除链接 ### 背景库 - `GET /api/backgrounds` - 获取背景列表 - `POST /api/backgrounds` - 添加背景 - `DELETE /api/backgrounds/{id}` - 删除背景 - `GET /api/backgrounds/random` - 获取随机背景 ### 头像库 - `GET /api/avatars` - 获取头像列表 - `POST /api/avatars` - 添加头像 - `DELETE /api/avatars/{id}` - 删除头像 ### 文件上传 - `POST /api/upload` - 上传文件 ### 访客统计 - `GET /api/visitor-stats` - 获取访客统计
--- ## 常见问题
1. 如何修改端口？ 编辑 `main.py` 第 6 行： ```python port = 6636 # 修改为你想要的端口 ``` 或启动时指定端口： ```bash python main.py 8080 # 使用 8080 端口 ```
2. 如何重置数据库？ ```bash rm personal_guide.db bash start.sh # 重新启动会自动创建新数据库 ```
3. 忘记管理路径怎么办？ 查看数据库配置： ```bash sqlite3 personal_guide.db "SELECT admin_path FROM config;" ```
4. 如何备份数据？ 备份以下文件/目录： - `personal_guide.db` - 数据库 - `uploads/` - 上传的文件
5. 如何修改端口？ 编辑 `main.py` 最后一行： ```python uvicorn.run(app, host="0.0.0.0", port=6636) # 修改 port 参数 ```
--- ## 更新日志 ### v1.0.0 (2024-02) - 初始版本发布 - 支持背景/头像/音乐管理 - 添加樱花/烟花/糖豆特效 - 访客统计功能 - 完整的后台管理系统 --- ## 贡献 欢迎提交 Issue 和 Pull Request！ --- ## 许可证 [MIT License](LICENSE) ---
## 作者 **Gitee:** [@yangxiaoyude](https://gitee.com/yangxiaoyude) **GitHub:** [@YYY887](https://github.com/YYY887) --- ### 致谢 感谢所有开源项目的贡献者！ --- 如果这个项目对你有帮助，请给个 Star 支持一下！