ForcePilot/docs/usage/MinIO.md
Wenjie Zhang 790c068eb6 fix(docs): 更新 README 和文档路径,添加 MinIO 存储模块文档
- 修改 README 中的模型配置路径,确保指向正确的配置文件位置
- 新增 MinIO 存储模块文档,提供基本使用和高级使用示例
- 更新内容审查机制和品牌信息配置的相关路径
- 移除旧的用户模型和线程模型,重构数据库模型管理
- 优化代码结构,确保数据库管理器和模型的导入路径一致
2025-09-23 10:48:44 +08:00

1.2 KiB
Raw Blame History

MinIO 存储模块

简化的 MinIO 对象存储模块,提供基本的文件存储功能。

核心功能

基本使用

from src.storage.minio import upload_image_to_minio

# 上传图片(保持原有接口)
url = upload_image_to_minio(image_data, "jpg")
print(f"图片已上传: {url}")

高级使用

from src.storage.minio import MinIOClient, get_minio_client

# 获取客户端实例
client = get_minio_client()

# 上传文件
with open("example.txt", "rb") as f:
    data = f.read()

result = client.upload_file("my-bucket", "example.txt", data)
print(f"文件已上传: {result.url}")

# 下载文件
downloaded_data = client.download_file("my-bucket", "example.txt")

# 删除文件
client.delete_file("my-bucket", "example.txt")

功能特性

  • 向后兼容:保持 upload_image_to_minio 函数的原有接口
  • 简洁易用:核心功能一目了然
  • 错误处理:统一的异常处理
  • 类型安全:完整的类型注解

架构优势

  1. 职责清晰src/storage/minio 专门处理对象存储
  2. 易于维护:代码简洁,功能明确
  3. 易于扩展:为未来功能扩展留出空间
  4. 向后兼容:不破坏现有代码