Skip to content

Release v8.0.68

Choose a tag to compare

@Hommy-master Hommy-master released this 16 Jun 02:37

改动说明

✨ 新功能

  • 📁 新增 STORAGE_UPLOAD_PREFIX 配置项,支持为 COS / OSS 上传设置统一的目录前缀(根目录)
  • 🔧 可通过环境变量 STORAGE_UPLOAD_PREFIX 灵活配置,无需改代码即可区分环境或业务目录

🗂️ 路径规则调整

  • 📅 上传目录由「按日期 + 小时」改为「仅按日期」:yyyy-MM-dd/文件名
  • 🧹 移除小时层级,同一天上传的文件集中在同一日期目录下,结构更简洁
  • 🔗 配置前缀后,完整路径为:[前缀/]yyyy-MM-dd/文件名

🛠️ 代码优化

  • ♻️ 抽取 build_storage_object_key() 公共逻辑,COS 与 OSS 共用同一套 key 生成规则
  • 📝 完善 config.py 注释,补充多种可用配置示例及路径效果说明
  • ✂️ 自动去除前缀首尾多余斜杠,避免重复 / 导致路径异常

🧪 测试

  • ✅ 新增 tests/test_storage_key.py,覆盖无前缀、有前缀、斜杠规范化等场景

📌 配置示例

  • 未设置前缀:文件上传至 2026-06-15/文件名
  • 设置为 capcut-mate:文件上传至 capcut-mate/2026-06-15/文件名
  • 设置为 prod/capcut-mate:文件上传至 prod/capcut-mate/2026-06-15/文件名

⚠️ 升级提示

  • 🔄 本次变更仅影响新上传文件的存储路径,历史已上传文件路径不变
  • 🆕 若需将文件归档到指定根目录,请在上传前配置 STORAGE_UPLOAD_PREFIX 环境变量