# CustomAvatar
**Repository Path**: xyz66882/CustomAvatar
## Basic Information
- **Project Name**: CustomAvatar
- **Description**: 🎨 CustomAvatar —— 自定义头像插件 🌟
- **Primary Language**: PHP
- **License**: BSD-3-Clause
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-18
- **Last Updated**: 2025-09-26
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 🎨 `CustomAvatar` —— 自定义头像插件 🌟
> 💬 让你的 Typecho 博客评论区更生动，为 **博主** 和 **访客** 自定义专属头像！
✨ 支持随机头像、固定头像、批量管理，上传即用，简洁高效！
***
## 📦 插件简介
`CustomAvatar` 是一款专为 Typecho 打造的轻量级头像管理插件。
告别 Gravatar 的等待与屏蔽，**本地化头像存储**，让评论加载更快、体验更佳！🚀
- ✅ 博主可设「固定头像」或「随机头像」
- ✅ 访客自动分配随机头像（按邮箱哈希）
- ✅ 支持 JPG / PNG / GIF / WEBP 格式
- ✅ 可视化上传、预览、删除、批量操作
- ✅ 防重复分配机制，同一页面不重复
- ✅ 自动缓存 + 清理，性能无忧
***
## ⚙️ 功能详解
### 1️⃣ 博主头像设置
- **固定头像开关** 🔘
可开启/关闭，选择是否使用固定头像。
- **选择固定头像** 🖼️
从 `bozhu/fixed_pool` 中选择一张作为博主唯一展示头像。
- **博主随机池** 🎲
若关闭固定头像，系统将从此目录随机分配（每次刷新可能不同）。
### 2️⃣ 访客头像设置
- **访客随机池** 👥
所有未登录访客将根据邮箱哈希值，从此目录中分配一个随机头像。
同一用户每次评论看到的头像一致 ✅
### 3️⃣ 头像管理面板 🛠️
- **上传功能** 📤
支持多选文件上传，自动重命名避免冲突：
`原文件名_YYYYMMDD.扩展名`（如：`小猫.jpg_20250918.jpg`）
- **删除功能** ❌
单个删除或批量勾选后一键清除。
- **选择为固定头像** ✅
在 `fixed_pool` 中点击按钮，快速设为博主固定头像（需保存设置）。
- **文件名显示优化** 🏷️
下拉框中自动去除日期后缀，只显示原始文件名，清爽易选！
***
## 🧹 缓存与性能
- 使用 `$_SESSION` 缓存用户头像映射，确保一致性。
- 页面内防重复：避免同一页面多个评论使用相同头像。
- 文件操作后自动清理缓存，保证即时生效。
- URL 加时间戳防 CDN 缓存，上传即可见 💥
***
## 🔐 安全保障
- 严格路径校验，防止目录穿越。
- MIME 类型检测，杜绝非法文件上传。
- 删除前双重确认，避免误操作。
- 所有文件存于插件私有目录，隔离安全。
***
## 📁 文件结构
````
CustomAvatar/
├── assets/
│ └── avatars/
│ ├── bozhu/ ← 博主随机头像
│ │ └── 小帅_20250918.jpg
│ ├── bozhu/fixed_pool/ ← 博主固定头像候选
│ │ └── 固定头像_20250918.png
│ └── fangke/ ← 访客随机头像
│ ├── 可爱猫.gif_20250918.gif
│ └── 萌兔.webp_20250918.webp
└── Plugin.php
````
***
## 🎁 使用小贴士
- 💡 建议上传 100×100 ~ 200×200 的方形图片，显示更佳。
- 🧼 定期清理不用的头像，保持整洁。
- 🔄 修改设置后记得点击「保存设置」哦！
- 🌈 多上传几张，让评论区更丰富多彩吧！🎉
***
## 🖼️ 效果图预览
***
## 🙌 致谢
感谢 Typecho 社区 🌱 与所有使用者的支持！
有任何建议欢迎反馈～我们一起让博客更有趣！💌
> 📢 插件作者：期望ai
🔗 官网链接：https://github.com/xyz66882/CustomAvatar
>
📅 当前版本：`v1.0.5` | 更新日期：2025年9月18日
***
✨ **让每一条评论，都有“脸”可见。** ✨
👉 立即安装 `CustomAvatar`，开启你的个性化博客之旅吧！🚀🌈
# 🚀 贡献者
# ⭐️ 收藏 历史
