ROI Calculator 是一个面向营销活动、投资和商业决策的 ROI 计算工具，核心是一个 ROICalculator 类，也可通过命令行使用。
主要能力：简单 ROI 与净 ROI；营销 ROI、ROAS 及多活动对比；投资 ROI、CAGR 和含股息的总回报；盈亏平衡（按单位与按收入）；回本期（等额与不等额现金流）；多方案对比与排序；敏感性分析和情景分析；以及生成报告。
使用方式：在 Python 中导入 from roi_calculator import ROICalculator，创建 calc = ROICalculator() 后调用相应方法，例如 calc.simple_roi(investment=10000, return_value=15000)，部分方法返回 Dict 或 pandas DataFrame。也可用 CLI，例如 python roi_calculator.py --investment 10000 --return 15000、python roi_calculator.py --marketing --spend 5000 --revenue 25000 --cogs 10000、python roi_calculator.py --breakeven --fixed 50000 --price 100 --variable 60、python roi_calculator.py --payback --investment 100000 --annual-return 25000。
适用场景：评估营销活动表现、比较投资/扩张/设备升级等方案、测算定价与盈亏平衡点、做敏感性分析。
限制：依赖 pandas>=2.0.0 和 numpy>=1.24.0；仅为计算工具，不接入实际业务数据，结果取决于输入假设；其他平台、收费与更新信息暂未提供。