package com.microservices.zone.resource.service;

import com.microservices.zone.resource.domain.vo.AiSkillParseResultVo;
import com.microservices.zone.resource.domain.vo.AiUploadedResourceParseResultVo;
import org.springframework.web.multipart.MultipartFile;

/**
 * AI资源ZIP解析服务接口
 */
public interface IAiResourceParseService {

    /**
     * 解析Skill ZIP包
     * 1. 校验ZIP内必须包含 SKILL.md
     * 2. 提取 SKILL.md 内容
     * 3. 生成目录树结构 JSON
     *
     * @param zipFile 上传的ZIP文件
     * @return 解析结果
     */
    AiSkillParseResultVo parseSkillZip(MultipartFile zipFile);

    /**
     * 解析已上传的资源ZIP包（模型/数据集）
     * 基于已通过分片上传到服务器的文件，解析目录树和 README.md
     *
     * @param fileId 已上传文件的ID
     * @return 解析结果
     */
    AiUploadedResourceParseResultVo parseUploadedZip(Long fileId);
}
