用途：帮助回答“这笔钱该不该花”，用可辩护的数字呈现投入回报，包括 ROI 百分比、回本周期和考虑货币时间价值的简单 NPV，并明确假设、做敏感性检查，使商业论证能经受质疑。
所需输入：成本（前期成本及每周期经常性成本）、收益（每周期预期增益，如收入提升、节省成本、节省时间×负载费率，并量化，若为估计需注明）、评估时间范围（如 3 年）、折现率（用于 NPV，默认约 10%，须说明）。
输出格式：先给出成本、收益、净收益、ROI%、回本周期、简单 NPV 等数值；再给一行结论（值得/勉强/不值得，对照门槛如折现率障碍、回本容忍度）；随后明确列出假设，收益通常是最软的输入，应标记并给出保守/预期/乐观区间而非单点；最后给敏感性分析，指出结论依赖的关键假设及其翻转点。
程序化辅助：scripts/roi.py 仅用标准库，计算 ROI、回本和 NPV。示例输入 in.json 含 upfront_cost、recurring_cost、benefit_per_period、periods、discount_rate_annual、period 等字段；运行方式：python3 scripts/roi.py in.json；加 --json 输出 JSON：python3 scripts/roi.py in.json --json。
质量检查：成本须包含经常性/持续性支出而非仅前期；须计算 NPV 而非仅原始 ROI；收益须以区间给出；须明确列出所有假设；须有敏感性说明，指出结论所依赖的假设及翻转点。
反模式：忽略持续成本；把单一收益数字当作事实；多年期案例跳过折现；埋没假设；省略回本周期。以上基于商业论证/资本预算实践。资料未提供收费、价格、平台限制等具体信息。