用途：面向 SaaS 业务方，把当月收入变动数据转换成一套标准的董事会/投资人指标看板，强调口径正确、可复算、可审计。
主要能力：计算 MRR/ARR、MRR 增长率、净收入留存（NRR）、毛收入留存（GRR）、收入流失率、quick ratio（(new+expansion)/(churn+contraction)）以及 magic number（需要 S&M 支出数据）。每项指标会对照基准给出解读：NRR ≥100%（≥110% 更佳）、GRR ≥90%、quick ratio ≥4 为强、magic number ≥0.75 为高效。输出含指标表、2–3 行健康度总结、以及明确的公式定义。
必要输入：起始 MRR，以及当月 new、expansion、contraction、churned MRR；如需 logo 流失率则提供客户数（期初、流失）；如需 magic number 则提供上一期 S&M 支出。也可以直接粘贴已有数据，工具会计算可用部分并标记缺失项。
使用方式：仓库内提供仅用标准库的辅助脚本 scripts/saas_metrics.py，可按以下方式运行（保持原样）： python3 scripts/saas_metrics.py in.json python3 scripts/saas_metrics.py in.json --json 其中 in.json 形如：{"starting_mrr":100000,"new":12000,"expansion":6000,"contraction":2000,"churned":4000,"sm_spend_prior":40000}。
质量口径与限制：NRR 只衡量存量客户、不含新增 MRR；GRR 上限为 100%；每项指标须附公式，避免“120% 留存”这类无定义数字；月/年数据不可混用，MRR 与 ARR 需清楚标注；应同时展示流失与收缩，不做虚荣指标挑选；结果需合理取整并标注假设，不呈现虚假精度。资料未提供具体收费、平台支持范围与效果承诺。