Customer Success Manager 是一套面向 SaaS 客户成功场景的生产级分析工具，提供多维度健康度评分、流失风险预测和扩展机会识别能力。它由三个 Python 命令行工具组成，仅使用标准库，不依赖外部依赖、不调用 API、不使用机器学习模型，输出确定且可重复。
主要能力
- 客户健康度评分：在用量、参与、支持和关系四个维度上进行多维度加权评分，并给出红/黄/绿分类。
- 流失风险分析：检测行为信号，提供基于风险分层的干预手册，并考虑续约时间的紧迫度乘数。
- 扩展机会评分：分析采用深度、空白映射和收入机会估算，并按投入与影响进行优先级排序。
- 分段感知基准：可为企业、中端市场和中小企业客户分段配置阈值。
- 趋势分析：进行周期对比，检测改善或下降趋势。
- 高管报告：提供 QBR 模板、成功计划和执行业务回顾模板。
输入要求
所有脚本接受一个 JSON 文件作为位置输入参数。完整示例见 assets/sample_customer_data.json。
健康度评分计算器的输入示例包含客户 ID、名称、分段、ARR，以及 usage、engagement、support、relationship 和 previous_period 等字段。
流失风险分析器的输入示例包含客户 ID、名称、分段、ARR、合同结束日期，以及 usage_decline、engagement_drop、support_issues、relationship_signals 和 commercial_factors 等字段。
扩展机会评分器的输入示例包含客户 ID、名称、分段、ARR，以及 contract、product_usage 和 departments 等字段。
输出格式
所有脚本通过 --format 标志支持两种输出格式：
- text（默认）：适合终端查看的人类可读格式。
- json：适合集成和流水线的机器可读 JSON 格式。
使用方式
快速开始：
# 健康度评分
python scripts/health_score_calculator.py assets/sample_customer_data.json
python scripts/health_score_calculator.py assets/sample_customer_data.json --format json
# 流失风险分析
python scripts/churn_risk_analyzer.py assets/sample_customer_data.json
python scripts/churn_risk_analyzer.py assets/sample_customer_data.json --format json
# 扩展机会评分
python scripts/expansion_opportunity_scorer.py assets/sample_customer_data.json
python scripts/expansion_opportunity_scorer.py assets/sample_customer_data.json --format json
工作流集成：
# 1. 对客户组合进行健康度评分
python scripts/health_score_calculator.py customer_portfolio.json --format json > health_results.json
# 2. 识别高风险账户
python scripts/churn_risk_analyzer.py customer_portfolio.json --format json > risk_results.json
# 3. 在健康账户中寻找扩展机会
python scripts/expansion_opportunity_scorer.py customer_portfolio.json --format json > expansion_results.json
# 4. 使用模板准备 QBR
# 参考：assets/qbr_template.md
脚本说明
1. health_score_calculator.py
用途：多维度客户健康度评分，包含趋势分析和分段感知基准。
维度与权重：
| 维度 | 权重 | 指标 |
|---|---|---|
| 用量 | 30% | 登录频率、功能采用、DAU/MAU 比率 |
| 参与 | 25% | 支持工单量、会议出席、NPS/CSAT |
| 支持 | 20% | 未结工单、升级率、平均解决时间 |
| 关系 | 25% | 高管发起人参与、多线程深度、续约情绪 |
分类：
- 绿色（75-100）：健康——客户正在获得价值。
- 黄色（50-74）：需要关注——密切监控。
- 红色（0-49）：有风险——需要立即干预。
用法：
python scripts/health_score_calculator.py customer_data.json
python scripts/health_score_calculator.py customer_data.json --format json
2. churn_risk_analyzer.py
用途：识别高风险账户，检测行为信号，并给出基于分层的干预建议。
风险信号权重：
| 信号类别 | 权重 | 指标 |
|---|---|---|
| 用量下降 | 30% | 登录趋势、功能采用变化、DAU/MAU 变化 |
| 参与下降 | 25% | 会议取消、响应时间、NPS 变化 |
| 支持问题 | 20% | 未结升级、未解决关键问题、满意度趋势 |
| 关系信号 | 15% | 拥护者离开、发起人变更、竞品提及 |
| 商业因素 | 10% | 合同类型、价格投诉、预算削减 |
风险分层：
- 严重（80-100）：立即高管升级。
- 高（60-79）：紧急 CSM 干预。
- 中（40-59）：主动外联。
- 低（0-39）：标准监控。
用法：
python scripts/churn_risk_analyzer.py customer_data.json
python scripts/churn_risk_analyzer.py customer_data.json --format json
3. expansion_opportunity_scorer.py
用途：识别追加销售、交叉销售和扩展机会，进行收入估算和优先级排序。
扩展类型：
- 追加销售：升级到更高层级或增加现有产品用量。
- 交叉销售：增加新产品模块。
- 扩展：增加席位或部门。
用法：
python scripts/expansion_opportunity_scorer.py customer_data.json
python scripts/expansion_opportunity_scorer.py customer_data.json --format json
参考指南
| 参考 | 描述 |
|---|---|
| references/health-scoring-framework.md | 完整健康度评分方法、维度定义、权重理由、阈值校准 |
| references/cs-playbooks.md | 各风险分层的干预手册、入职、续约、扩展和升级流程 |
| references/cs-metrics-benchmarks.md | 按分段和行业的 NRR、GRR、流失率、健康度评分、扩展率行业基准 |
模板
| 模板 | 用途 |
|---|---|
| assets/qbr_template.md | 季度业务回顾演示结构 |
| assets/success_plan_template.md | 包含目标、里程碑和指标的客户成功计划 |
| assets/onboarding_checklist_template.md | 带阶段门禁的 90 天入职清单 |
| assets/executive_business_review_template.md | 战略账户的高管利益相关者回顾 |
最佳实践
- 定期评分：企业客户每周运行健康度评分，中端市场每两周，中小企业每月。
- 关注趋势而非快照：下降的绿色比稳定的黄色更紧急。
- 组合信号：三个脚本一起使用以获得完整客户画像。
- 校准阈值：根据你的产品和行业调整分段基准。
- 记录干预：跟踪采取的行动和结果，以改进手册。
- 用数据准备：每次 QBR 和高管会议前运行脚本。
限制
- 无实时数据：脚本分析来自 JSON 输入文件的时点快照。
- 无 CRM 集成：数据必须从 CRM/CS 平台手动导出。
- 仅确定性：无预测性机器学习——评分基于加权信号的算法。
- 阈值调优：默认阈值是行业标准，但可能需要根据你的业务进行校准。
- 收入估算：扩展收入估算基于使用模式的近似值。
最后更新：2026 年 2 月。工具：3 个 Python CLI 工具。依赖：仅 Python 3.7+ 标准库。