{
  "name": "review-keyword-cloud",
  "displayName": "评论关键词云",
  "description": "从评论语料生成关键词云，结合ASIN反查关键词，每个关键词带情感标签，构建VOC关键词库",
  "category": "review-analysis",
  "version": "1.1.0",
  "type": "orchestration",
  "parameters": {
    "reviewCorpus": {
      "type": "object",
      "required": true,
      "description": "review-batch-collection 输出的评论语料"
    },
    "asins": {
      "type": "array",
      "items": { "type": "string" },
      "required": false,
      "description": "ASIN列表，用于调用反查关键词补充"
    },
    "domain": {
      "type": "integer",
      "required": false,
      "default": 1,
      "description": "Amazon站点"
    },
    "topN": {
      "type": "integer",
      "required": false,
      "default": 50,
      "description": "返回Top N关键词"
    },
    "language": {
      "type": "string",
      "required": false,
      "default": "en",
      "description": "语言"
    }
  },
  "pipeline": [
    {
      "step": 1,
      "name": "评论文本分词+高频短语提取",
      "type": "compute",
      "logic": "tokenizeAndExtract(reviewCorpus)",
      "algorithm": {
        "tokenize": "分词并去除停用词",
        "ngrams": "提取高频单词和短语（1-gram, 2-gram, 3-gram）",
        "frequency": "统计词频"
      },
      "output": "reviewKeywords"
    },
    {
      "step": 2,
      "name": "ASIN反查搜索关键词",
      "condition": "asins && asins.length > 0",
      "forEach": "asins",
      "api": {
        "service": "SorftimeApiService.getAsinKeywords",
        "endpoint": "/api/ASINRequestKeyword",
        "method": "POST",
        "forwardUrl": "https://server.fmode.cn/api/voc/forward",
        "headers": { "Authorization": "Bearer r:858b3ee92314d5447d1fc3cdc10462d7" },
        "requestBody": { "ASIN": "${asin}" },
        "queryParams": { "domain": "${domain}" }
      },
      "output": "searchKeywords",
      "responseExtract": "Array<{ Keyword, KeywordCNName, SearchVolume, SearchRank }>"
    },
    {
      "step": 3,
      "name": "合并关键词+情感标注",
      "type": "compute",
      "logic": "mergeAndAnnotate(reviewKeywords, searchKeywords, topN)",
      "algorithm": {
        "merge": "合并评论关键词和搜索关键词",
        "source": "标注来源（review/search/both）",
        "sentiment": "基于情感词典和上下文判断 positive/negative/neutral",
        "weight": "按频率/搜索量/关联ASIN数加权排序",
        "categorize": "分类: 产品特性/使用场景/购买决策/问题反馈"
      },
      "output": "keywordCloud"
    }
  ],
  "response": {
    "type": "object",
    "properties": {
      "keywordCloud": {
        "type": "array",
        "description": "关键词云数据",
        "items": {
          "type": "object",
          "properties": {
            "keyword": { "type": "string" },
            "weight": { "type": "integer" },
            "frequency": { "type": "integer" },
            "source": { "type": "string", "enum": ["review", "search", "both"] },
            "sentiment": { "type": "string", "enum": ["positive", "negative", "neutral"] },
            "searchVolume": { "type": "integer" },
            "relatedAsins": { "type": "integer" }
          }
        }
      },
      "categories": {
        "type": "object",
        "description": "关键词分类",
        "properties": {
          "产品特性": { "type": "array", "items": { "type": "string" } },
          "使用场景": { "type": "array", "items": { "type": "string" } },
          "购买决策": { "type": "array", "items": { "type": "string" } },
          "问题反馈": { "type": "array", "items": { "type": "string" } }
        }
      },
      "searchKeywords": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "keyword": { "type": "string" },
            "searchVolume": { "type": "integer" },
            "rank": { "type": "integer" }
          }
        }
      },
      "totalKeywords": { "type": "integer" },
      "reviewKeywordsCount": { "type": "integer" },
      "searchKeywordsCount": { "type": "integer" },
      "overlapKeywords": { "type": "integer" }
    }
  },
  "timeout": 60000,
  "retry": {
    "maxAttempts": 2,
    "delay": 2000,
    "backoffMultiplier": 2
  }
}