openclaw-voc-skill/synthesis/html-report-generator/api-config.json

{
  "name": "html-report-generator",
  "displayName": "HTML竞品分析报告生成器",
  "description": "整合所有前置Skill输出，AI生成REPORT_DATA JSON，注入report_template.html模板，输出完整可渲染的9屏幻灯片HTML竞品分析报告",
  "category": "synthesis",
  "version": "1.3.0",
  "type": "analysis",
  "templateRef": "workflows/templates/report_template.html",
  "parameters": {
    "industryName": {
      "type": "string",
      "required": true,
      "description": "行业名称，如「香薰家居」「宠物用品」「母婴护理」"
    },
    "coverBrandEnglish": {
      "type": "string",
      "required": true,
      "description": "封面英文品牌标识，如「HOME FRAGRANCE」「PET CARE」"
    },
    "reportDate": {
      "type": "string",
      "required": true,
      "description": "报告日期，格式 'YYYY年MM月'"
    },
    "categoryLandscape": {
      "type": "object",
      "required": true,
      "description": "synthesis/category-landscape 输出（市场全景数据）"
    },
    "competitorData": {
      "type": "object",
      "required": true,
      "description": "competitor-analysis 汇总输出（竞品发现+对比+定价+追踪）"
    },
    "reviewAnalysis": {
      "type": "object",
      "required": true,
      "description": "review-analysis 汇总输出（痛点+亮点+情感+关键词云）"
    },
    "socialVocData": {
      "type": "object",
      "required": false,
      "description": "social-voc 汇总输出（TikTok+Instagram趋势数据）"
    },
    "userPersona": {
      "type": "object",
      "required": false,
      "description": "synthesis/user-persona 输出"
    },
    "strategyData": {
      "type": "object",
      "required": false,
      "description": "短/中/长期策略建议，可从voc-proposal输出中提取或手动补充"
    }
  },
  "pipeline": [
    {
      "step": 1,
      "name": "提取模板变量",
      "type": "compute",
      "logic": "extractTemplateVars(inputs)",
      "algorithm": {
        "placeholders": {
          "industryName": "直接取 inputs.industryName",
          "coverBrandEnglish": "直接取 inputs.coverBrandEnglish",
          "reportDate": "直接取 inputs.reportDate",
          "totalReviews": "从 reviewAnalysis.stats.totalReviews 提取，格式化为 '1,500条'",
          "categoryCount": "从 categoryLandscape.topBrands 或 categories 数组长度提取",
          "competitorCount": "从 competitorData.competitors 数组长度提取",
          "competitorNames": "从 competitorData.competitors 数组提取 brand 字段，逗号分隔"
        }
      },
      "output": "templateVars"
    },
    {
      "step": 2,
      "name": "AI生成REPORT_DATA JSON",
      "type": "ai",
      "logic": "generateReportData(categoryLandscape, competitorData, reviewAnalysis, socialVocData, userPersona, strategyData, templateVars)",
      "aiConfig": {
        "systemPrompt": "你是跨境电商数据分析专家。请严格按照指定JSON Schema生成REPORT_DATA对象，用于注入HTML幻灯片报告模板。只输出纯JSON，不要有任何注释或额外文字。",
        "userPromptTemplate": "请根据以下分析数据生成完整的REPORT_DATA JSON对象：\n\n行业: ${industryName}\n品牌: ${coverBrandEnglish}\n\n【市场全景数据】\n${categoryLandscapeJson}\n\n【竞品数据】\n${competitorDataJson}\n\n【VOC评论分析】\n${reviewAnalysisJson}\n\n【社媒数据】\n${socialVocDataJson}\n\n【用户画像】\n${userPersonaJson}\n\n【策略建议】\n${strategyDataJson}\n\n请严格按照以下Schema生成REPORT_DATA:\n- metrics: 6个核心KPI指标卡片 [{value数字, prefix, suffix, label, sub}]\n- coreFindings: 5条核心发现 [{text, highlight, highlightClass}] highlightClass选'text-sage'(正向)/'text-rose'(负向)/'text-gold'(关键)\n- coreValues: 5条核心价值 [string]\n- categories: 各品类市场数据 [{name,weeklySales,weeklyRevenue,avgPrice,brands,growth,chinaRatio,highlight(bool),revenueNum(数字),growthNum(数字)}]\n- competitors: 竞品卡片数据 [{name,positioning,positionBadge('badge-gold'/'badge-sage'/'badge-rose'/'badge-blue'),priceRange,igFollowers,tiktokFollowers,skuNote,strategyNote,pros,cons,radarData:[5个0-100分值]}]\n- vocAnalysis: {totalReviews,painPoints:[{icon(emoji),name,pct(1-35),gradient('linear-gradient(90deg,...)'),quote}],highlights:[{name,pct(1-100),color('#...')}],scenes:[{name,pct}]}\n- categoryMatrix: [{name,marketSize,growth,socialHeat,competition,chinaRatio,recommendation,badgeClass}]\n- tiktokHeat: [{name(#话题名),plays(数字)}]\n- seasonalNotes: [{icon(emoji),title,desc}]\n- strategy: {shortTerm:[{title,desc}],midTerm:[{title,desc}],longTerm:[{title,desc}]} 每期3-4条\n- vocPriorities: [{text,badgeClass}] 6-8条VOC驱动的优化优先级\n- conclusion: {topCategory:{emoji,title,name,desc},socialDividend:{emoji,title,name,desc},differentiator:{title,subtitle,desc},keyActions:[{emoji,title,desc}]} keyActions 恰好3条",
        "outputFormat": "{\"metrics\":[],\"coreFindings\":[],\"coreValues\":[],\"categories\":[],\"competitors\":[],\"vocAnalysis\":{},\"categoryMatrix\":[],\"tiktokHeat\":[],\"seasonalNotes\":[],\"strategy\":{},\"vocPriorities\":[],\"conclusion\":{}}",
        "temperature": 0.3,
        "maxTokens": 12000,
        "promptPattern": "system约束JSON-only输出 + user按模块注入真实数据 + outputFormat示例引导结构"
      },
      "output": "reportDataJson"
    },
    {
      "step": 3,
      "name": "填充模板生成HTML",
      "type": "compute",
      "logic": "injectIntoTemplate(reportDataJson, templateVars, templateRef)",
      "algorithm": {
        "templateLoad": "读取 templateRef 路径的 report_template.html 文件内容",
        "placeholderReplace": "将模板中所有 {{key}} 替换为 templateVars[key] 对应的值",
        "dataInjection": "将 {{REPORT_DATA_JSON}} 替换为 JSON.stringify(reportDataJson, null, 2)",
        "output": "完整HTML字符串，可直接写入 .html 文件并在浏览器打开"
      },
      "output": "htmlContent"
    },
    {
      "step": 4,
      "name": "生成报告统计",
      "type": "compute",
      "logic": "buildReportStats(reportDataJson, templateVars)",
      "algorithm": {
        "totalSlides": "固定9屏（封面/目录/执行摘要/市场全景/竞品对标/用户VOC/线索清单/执行策略/总结展望）",
        "dataCompleteness": "检查reportDataJson各字段非空率，计算0-100数据完整度",
        "generatedAt": "生成时间戳 ISO 8601"
      },
      "output": "reportStats"
    }
  ],
  "response": {
    "type": "object",
    "properties": {
      "htmlContent": {
        "type": "string",
        "description": "完整HTML字符串，可直接写入 .html 文件在浏览器打开"
      },
      "reportDataJson": {
        "type": "object",
        "description": "生成的 REPORT_DATA JSON 对象（可调试复查）",
        "properties": {
          "metrics": { "type": "array" },
          "coreFindings": { "type": "array" },
          "categories": { "type": "array" },
          "competitors": { "type": "array" },
          "vocAnalysis": { "type": "object" },
          "categoryMatrix": { "type": "array" },
          "strategy": { "type": "object" },
          "conclusion": { "type": "object" }
        }
      },
      "templateVars": {
        "type": "object",
        "description": "填充后的 {{placeholder}} 变量表",
        "properties": {
          "industryName": { "type": "string" },
          "coverBrandEnglish": { "type": "string" },
          "totalReviews": { "type": "string" },
          "categoryCount": { "type": "string" },
          "competitorCount": { "type": "string" },
          "competitorNames": { "type": "string" },
          "reportDate": { "type": "string" }
        }
      },
      "reportStats": {
        "type": "object",
        "description": "报告生成统计",
        "properties": {
          "totalSlides": { "type": "integer" },
          "dataCompleteness": { "type": "number", "description": "0-100数据完整度百分比" },
          "generatedAt": { "type": "string", "description": "生成时间戳" }
        }
      }
    }
  },
  "timeout": 300000,
  "retry": {
    "maxAttempts": 2,
    "delay": 3000,
    "backoffMultiplier": 2
  }
}