用途
ROI Calculator 用于计算和沟通网红营销活动的投资回报。它适配多种方法论，取决于用户的目标和现有数据。它同时充当跨学科的付费广告共享回报计算引擎：paid-measurement-loop、attribution-reconciler 和 budget-optimizer 会把 ROAS/CPA/payback 比率委托给此技能计算，而不是自行重复计算。付费运行结果保存在 memory/ad/roi-calculator/ 下。
主要能力
- 直接 ROI 与 ROAS：Simple ROI = (Revenue − Investment) / Investment × 100；ROAS = Revenue / Investment。在声明公式下将差额称为净回报（net return），而非利润（profit），除非收入归因与完整成本基础已验证。
- 赢得媒体价值（EMV）：基于曝光（Impressions × 可比 CPM / 1000）或基于互动（Engagements × 可比 CPE），仅使用提供或引用的、带来源日期的比较基准。若不存在有效比较基准，EMV 返回 NEEDS_INPUT。
- 成本效率指标：CPM、CPR、CPE、CPV、CPC、CPA、CAC。仅与已声明、带来源日期、且市场/窗口/归因基础兼容的目标比较。
- 归因建模：仅在提供完整转化全集、订单/事件去重键、旅程触点、合格渠道和分配规则后，使用一个预先声明的模型。可选替代模型是同一去重转化集上的非可加敏感性场景；绝不在看到结果后选择最有利的模型。
- LTV 影响：仅当新客户在控制归因全集中去重、且提供的 LTV 是完整贡献边际基础（含队列、周期、留存/流失、退款、边际、折扣/时机、首单包含、来源/日期）并有正的兼容投资分母时，才标记为 LTV-Based ROI，公式为 ((New Customers × contribution-margin LTV) − Investment) / Investment × 100。收入-LTV 输入只能产生带基础/周期/状态的估算收入基础场景，不是经济 ROI 或利润。
- 按创作者 ROI：仅针对完整锁定的创作者范围，使用已解析的不透明引用、兼容窗口/成本基础和去重的归因收入。按创作者和按层级的聚合 ROAS 是 sum(attributed revenue) / sum(spend)，绝不用简单平均。
- ROI 报告摘要：投资、回报、按方法论的 ROI、关键指标对比基准、底线和 1-3 条建议。
使用方式
最短调用示例：
Calculate ROI for our influencer campaign: $25K spend, $72K revenue, 2.1M reach
常见场景——报告前比较多种方法：
What's the ROI of our campaign using direct revenue, EMV, and LTV-based methods?
技能读取：campaign ID、请求创作者级计算时的完整不透明创作者范围、支出/成本基础明细、去重结果数据（触达、曝光、互动、点击、转化、归因收入、新客户）、预先声明的归因模型/窗口/决策规则、若涉及 LTV 则需 AOV 和经济 LTV 输入，以及来自 performance-analyzer 的先前表现输出。默认内联返回 ROI 计算和摘要；仅在获得明确 WARM-save 授权后保存到 memory/influencer/roi-calculator/YYYY-MM-DD-<topic>.md（或声明的付费路径）。保存输出使用 campaign_id、完整不透明 creator_ref 范围和证据引用，绝不使用原始身份定位符。仅在有单独明确授权时，才将持久性头条数字及其归因窗口、来源和不确定性提升到 memory/hot-cache.md。
适用场景
- 用户要求“计算网红 ROI”“证明活动价值”或“我们的 ROAS 是多少”。
- 报告前需要比较直接收入、EMV 和 LTV 等多种方法论。
- 需要将财务回报数字作为 STAR 评估中 Return（R）维度的证据。
限制
- 属于 Tier 1，无实时集成；无集成时需手动提供投资和结果表。连接器（社媒分析、电商/分析、CRM、网红数据库）可自动拉取数字，但为可选项。
- 每个分母必须为已验证数值且严格大于零；零、负数、缺失或与分子窗口不兼容的分母会报告为 undefined，并返回 NEEDS_INPUT。绝不静默除以零。
- 未验证的转化发出 results-unverified：R1/R2/R5 报告为低置信度，并不做可归因回报声明。
- 可调用技能链中最多 3 跳，且维护 visited-set，若主下一技能已运行则停止。
- 本技能不运行评分器，也不输出综合分数。
完成标准
- 至少计算一种 ROI 方法论，并展示输入和公式。
- 每个头条指标都对照已声明、带来源日期的比较目标；不虚构通用基准。
- 写出底线算术评估和 1-3 条建议。仅在归因收入和完整活动成本基础已验证时称活动盈利。
相关技能
- performance-analyzer：提供本技能消费的结果数据。
- report-generator：将数字包装为完整报告（主下一技能）。
- budget-optimizer：使用 ROI 输出重新分配支出。
- campaign-planner：设定检查结果所对照的 ROI 目标。
- creator-content-auditor：接收 Return 证据以进行 STAR 评分门槛。