用途：分析社交媒体营销活动表现，计算互动指标、ROI 与平台基准对比，识别高/低表现内容并给出建议。
主要能力：按帖子计算互动率（(点赞+评论+分享+收藏)/触达×100）、CTR、触达率、传播率、收藏率；汇总活动级指标；在提供广告花费时计算 CPE、CPC、CPM、ROAS 与 ROI 百分比；与 Instagram、Facebook、Twitter/X、LinkedIn、TikTok 的基准对比；输出表现最佳与最差帖子排名及可执行建议。
使用方式：需先确认平台、帖子数据（点赞、评论、分享、收藏、触达等，触达须为独立用户数而非展示量）、广告花费与分析目标。脚本以静态 JSON 为输入，例如 python scripts/calculate_metrics.py assets/sample_input.json 计算指标，python scripts/analyze_performance.py assets/sample_input.json 生成完整分析。输入字段包括 platform、posts[]（likes、comments、reach 必填，impressions、shares、saves、clicks 可选）、total_spend 可选。
适用场景：活动效果审计、高表现内容模式识别、付费社交 ROI 评估、竞品对比参考。
限制：不连接平台实时 API，仅分析导出的静态 JSON；不涉及发布、排期、内容创作、粉丝增长追踪、受众画像、竞品监听、网红管理、社交电商、视频专项分析（观看时长、完播率）与评论情感分析。建议至少 10 条帖子，30 条以上更可靠。平台指标定义变化（如 Instagram 转向 Views、Meta 计划以 Viewers 替代 reach）可能影响数据字段匹配。部分基准与估值参数为资料给定，实际使用需按行业调整。