用途：分析社交媒体营销活动表现，计算互动指标、ROI，并与平台基准对比，用于评估内容效果和投放回报。
主要能力：按帖子计算互动率、CTR、触达率、病毒传播率、收藏率；汇总活动级指标；在提供广告花费时计算 CPE、CPC、CPM、ROAS 和 ROI 百分比；与平台基准对比，识别最佳与最差表现内容并生成建议。互动率公式为 (Likes + Comments + Shares + Saves) / Reach × 100。
使用方式：输入需包含 platform（instagram、facebook、twitter、linkedin、tiktok）、posts[] 数组，每帖至少提供 likes、comments、reach；impressions、shares、saves、clicks 可选；total_spend 可选用于 ROI。运行命令：python scripts/calculate_metrics.py assets/sample_input.json 计算指标；python scripts/analyze_performance.py assets/sample_input.json 生成含 ROI、基准对比和建议的完整分析。
适用场景：社交媒体审计、内容表现分析、竞品社媒对比、投放预算与效果评估。
限制：分析前需校验 reach > 0、互动数非负、日期范围有效、平台可识别、ROI 需 spend > 0；互动率应小于 100%。平台基准、互动价值估算和 ROI 评级来自资料内置参考，实际效果因行业和账号而异。资料未提供安装方式、收费信息或平台支持范围之外的功能。