Files
Foxel/README.md

112 lines
5.5 KiB
Markdown

<p align="center">
<img src="Web/public/logo.png" alt="Foxel Logo" width="150"><br>
<strong>Foxel - 智能图像检索与管理系统</strong>
</p>
<p align="center">
<a href="#-核心功能"><img src="https://img.shields.io/badge/功能-Features-blue?style=for-the-badge" alt="核心功能"></a>
<a href="#-部署指南"><img src="https://img.shields.io/badge/部署-Deploy-orange?style=for-the-badge" alt="部署"></a>
<a href="#-贡献指南"><img src="https://img.shields.io/badge/贡献-Contribute-brightgreen?style=for-the-badge" alt="贡献"></a>
</p>
<p>
<strong>Foxel</strong> 是一个基于 <strong>.NET 9</strong> 开发的现代化智能图像检索与管理系统,集成先进的 <strong>AI 视觉模型</strong> 和 <strong>向量嵌入技术</strong>,提供高效的图像搜索与管理功能。
</p>
---
> 🖥️ **在线演示:**
> 访问 [https://demo.foxel.cc](https://foxel.cc) 体验 Foxel 部分功能。
> 管理员账号:`demo@foxel.cc` 密码: `foxel_demo`
> ⚠️ **注意:演示环境数据可能不定期清理,请勿存放重要信息。**
---
## 🌐 社区交流
加入我们的社区,与其他用户交流使用心得,获取技术支持,参与项目讨论:
| 平台 | 群组信息 | 联系方式 |
|:----------:|:----------------------------------------------------|:-------------------------------------------------------------------------|
| 📱 **微信群** | **群名:** Foxel 小狐狸 <br>*如二维码失效,可添加 `drizzle2001` 拉群* | <img src="https://foxel.cc/Uploads/wechat.png" alt="微信群二维码" width="100"> |
> 💡 **社区规则:**
> - 保持友善,互相帮助
> - 发布问题时请提供详细信息
> - 禁止发布与项目无关的广告内容
> - 遵守各平台社区准则
## ✨ 核心功能
### 🔍 智能图像检索
- [x] 自然语言搜索 - 基于 AI 的图像内容理解与检索
- [x] 相似图像查找 - 快速定位相似内容的图片
- [x] 条件筛选 - 按时间、大小、格式等条件精确筛选
- [x] 高级搜索 - 多维度组合搜索条件
### 🗂️ 图像管理
- [x] 图片上传 - 支持拖拽上传、批量上传
- [x] 匿名图床 - 无需注册即可上传分享图片
- [x] 分类标签 - 灵活的图片分类与标签管理
- [x] 批量操作 - 批量删除、移动、标记图片
- [x] 缩略图生成 - 自动生成多尺寸缩略图
- [x] WebP 转换 - 智能格式转换,优化存储空间
### 🤖 AI 智能功能
- [x] 人脸识别 - 自动检测与识别图片中的人脸
- [x] AI 图片描述 - 智能生成图片内容描述
- [x] AI 自动分类 - 基于内容的智能图片分类
- [ ] 物体检测 - 识别图片中的各类物体
- [ ] 场景识别 - 自动识别图片拍摄场景
### 💾 存储功能
- [x] 本地存储 - 服务器本地文件存储
- [x] Telegram Channel - 基于 Telegram 的云端存储
- [x] Amazon S3 - 兼容 S3 协议的对象存储
- [x] 腾讯云 COS - 腾讯云对象存储服务
- [x] 多存储配置 - 支持多个存储后端同时使用
- [x] WebDAV - 标准 WebDAV 协议存储
### 👥 用户功能
- [x] 用户注册登录 - 完整的用户账号体系
- [x] GitHub 第三方登录 - 支持 GitHub 账号快捷登录
- [x] LinuxDo 第三方登录 - 支持 LinuxDo 社区账号登录
- [x] 权限管理 - 多角色权限控制
- [ ] 用户分组 - 用户群组管理功能
- [x] 个人资料 - 完善的用户资料管理
### 💬 社交功能
- [x] 图片点赞 - 为喜欢的图片点赞
- [x] 图片收藏 - 收藏感兴趣的图片内容
- [ ] 评论系统 - 图片评论与互动
- [ ] 分享功能 - 多平台图片分享
- [ ] 关注系统 - 关注其他用户
---
## 🚀 部署指南
> ⚠️ **重要提示:**
> Foxel 目前处于早期开发阶段,适合**尝鲜体验**和功能测试。当前版本在升级过程中可能包含**破坏性变更**,暂不提供数据迁移流程,升级时需要**重新安装**。如需**长期稳定使用**,建议等待 **Preview 版本** 发布后再部署,届时将提供完善的自动化版本升级流程。
Foxel 提供多种部署方式以满足不同场景需求:
- 🐳 **Docker Compose 一键部署** - 推荐新手使用
- 🐋 **Docker 单容器部署** - 适合自定义数据库
- 🔧 **源码编译部署** - 开发者专用
📖 **详细部署教程请访问:[https://foxel.cc/guide/getting-started.html](https://foxel.cc/guide/getting-started.html)**
---
## 🤝 贡献指南
我们欢迎所有对 Foxel 感兴趣的开发者加入贡献,共同改进和提升这个项目。
| 步骤 | 说明 |
|:------------:|:--------------------------------------------------------------------------------------------|
| **提交 Issue** | - 发现 Bug 或有建议时,请提交 Issue。<br>- 请详细描述问题及复现步骤,便于快速定位和修复。 |
| **贡献代码** | - Fork 本项目并创建新分支。<br>- 遵循项目代码规范。 |
| **功能扩展** | - 欢迎参与以下重点功能开发:<br>• 更智能的图像检索算法<br>• 增强社交互动<br>• 云存储/网盘集成<br>• 更多智能图像处理方法(如自动标注、风格迁移、图像增强等) |
如有任何疑问或建议,欢迎通过 Issue 与我们联系。感谢您的贡献!