namespace Service.IconSearch;

/// <summary>
/// 图标搜索服务接口
/// </summary>
public interface IIconSearchService
{
    /// <summary>
    /// 生成搜索关键字
    /// </summary>
    /// <param name="categoryName">分类名称</param>
    /// <returns>搜索关键字数组</returns>
    Task<List<string>> GenerateSearchKeywordsAsync(string categoryName);

    /// <summary>
    /// 搜索图标并返回候选列表
    /// </summary>
    /// <param name="keywords">搜索关键字数组</param>
    /// <param name="limit">每个关键字返回的最大图标数量</param>
    /// <returns>图标候选列表</returns>
    Task<List<IconCandidate>> SearchIconsAsync(List<string> keywords, int limit = 20);

    /// <summary>
    /// 更新分类图标
    /// </summary>
    /// <param name="categoryId">分类ID</param>
    /// <param name="iconIdentifier">图标标识符</param>
    Task UpdateCategoryIconAsync(long categoryId, string iconIdentifier);
}