feat: 试用过程中的细节优化

server/api/export.py

@@ -2,8 +2,8 @@
 
 平移自 image-suite-studio；路径按 docs/v2.1/api.md §7 定为 POST /api/export/images
 （前端 services/suite.ts exportImages 同款契约，注意与 ISS 的 /export-images 不同）。
-ZIP 内部按分组名建子文件夹（主图 / SKU图片 / 详情图 / 手动上传），
-文件名沿用采集 key（main-001 等）+ SKU 规格名；顶层文件夹用商品标题（清洗后）。
+采集图片默认按分组名建子文件夹（主图 / SKU图片 / 详情图 / 手动上传）。生成结果可
+请求扁平导出，所有图片直接放在商品根目录；文件名沿用采集 key（main-001 等）+ SKU 规格名。
 """
 from __future__ import annotations
 
@@ -51,6 +51,7 @@ class ExportImageItem(BaseModel):
 class ExportImagesRequest(BaseModel):
     title: str | None = Field(default=None, description="商品标题，用作 ZIP 顶层文件夹名")
     images: list[ExportImageItem] = Field(min_length=1)
+    flat: bool = Field(default=False, description="是否忽略图片分组，直接写入 ZIP 顶层商品目录")
 
 
 def _clean(name: str) -> str:
@@ -159,8 +160,8 @@ async def export_images(req: ExportImagesRequest):
                     filename = f"{stem}-{n}{ext}"
                 used.add(filename)
 
-                group = _clean(img.groupName) or "图片"
-                zf.writestr(f"{root}/{group}/{filename}", data)
+                archive_path = f"{root}/{filename}" if req.flat else f"{root}/{_clean(img.groupName) or '图片'}/{filename}"
+                zf.writestr(archive_path, data)
                 if archive.tell() > settings.export_zip_max_bytes:
                     raise HTTPException(
                         status_code=413,