Foxel/README.md

Foxel - 智能图像检索与管理系统

Foxel 是一个基于 .NET 9 开发的现代化智能图像检索与管理系统，集成先进的 AI 视觉模型 和 向量嵌入技术，提供高效的图像搜索与管理功能。

🖥️ 在线演示：
访问 https://foxel.cc 体验 Foxel 部分功能。
⚠️ 注意：演示环境数据可能不定期清理，请勿存放重要信息。

---

✨ 核心功能

功能模块	主要特性
🤖 智能图像检索	- 基于 AI 的图像内容检索与相似度匹配 - 快速定位目标图片
🗂️ 图像管理	- 支持图片分类、标签管理、批量操作 - 多分辨率与格式化处理
🖼️ 图床功能	- 图片上传、存储与分享 - 支持多种链接格式，访问权限灵活控制
👥 多用户支持	- 用户注册、登录、权限与分组管理
💬 轻社交功能	- 点赞、评论、分享
🔗 第三方登录	- 支持 GitHub、LinuxDo 等第三方账号快捷登录

---

🚀 部署指南

📋 前提条件

• 已安装 Docker。

⚙️ 一键部署

1. 拉取并运行容器

   docker pull ghcr.io/drizzletime/foxel:dev
   docker run -d -p 80:80 --name foxel ghcr.io/drizzletime/foxel:dev
   

2. 访问服务

   打开浏览器访问 http://localhost 或您的服务器 IP 地址即可使用 Foxel。

3. 获取管理员权限

   容器启动后，第一个注册的用户将自动获得管理员权限。

⚠️ 注意：
Foxel 依赖 PostgreSQL 数据库，并需要在数据库中启用 vector 扩展。
请确保您的 PostgreSQL 实例已正确安装并启用 vector 扩展，否则图像检索功能无法正常使用。
可通过如下命令在数据库中启用扩展：

CREATE EXTENSION IF NOT EXISTS vector;

如需自定义数据库等配置，可通过修改 Dockerfile 或挂载配置文件实现。

---

📖 适配存储

Foxel 提供多种存储后端选择，满足不同场景下的部署需求：

• 📁 本地存储
• 📡 Telegram Channel
• ☁️ Amazon S3
• 🔐 Tencent Cloud COS
• 🌐 WebDAV

未来将持续适配更多主流云存储平台，欢迎社区贡献新的存储适配器！

---

🤝 贡献指南

⚠️ 注意：Foxel 目前处于早期实验阶段，数据库结构和各项功能仍在持续迭代中，未来版本可能会有较大变动。建议在生产环境使用前充分测试，并关注项目更新动态。

我们欢迎所有对 Foxel 感兴趣的开发者加入贡献，共同改进和提升这个项目。

步骤	说明
提交 Issue	- 发现 Bug 或有建议时，请提交 Issue。 - 请详细描述问题及复现步骤，便于快速定位和修复。
贡献代码	- Fork 本项目并创建新分支。 - 遵循项目代码规范。
功能扩展	- 欢迎参与以下重点功能开发： • 更智能的图像检索算法 • 增强社交互动 • 云存储/网盘集成 • 更多智能图像处理方法（如自动标注、风格迁移、图像增强等）

如有任何疑问或建议，欢迎通过 Issue 与我们联系。感谢您的贡献！

---