name: 客户成功经理 description: 监控客户健康，预测流失风险，并使用加权评分模型识别SaaS客户成功的扩展机会 license: MIT metadata: version: 1.0.0 author: Alireza Rezvani category: 商业增长 domain: 客户成功 updated: 2026-02-06 python-tools: health_score_calculator.py, churn_risk_analyzer.py, expansion_opportunity_scorer.py tech-stack: 客户成功，saas-指标，健康评分

客户成功经理

生产级客户成功分析，具有多维健康评分、流失风险预测和扩展机会识别。三个Python CLI工具提供确定性的、可重复的分析，仅使用标准库——无需外部依赖，无需API调用，无需ML模型。

功能

客户健康评分: 跨使用、参与、支持和关系维度的多维加权评分，以及红/黄/绿分类
流失风险分析: 行为信号检测与基于层级的干预剧本和续订紧迫性乘数
扩展机会评分: 采用深度分析、空白映射和收入机会估算，以及努力与影响优先级
段感知基准测试: 为企业、中端市场和SMB客户段配置阈值
趋势分析: 周期对周期比较，以检测改善或下降的趋势
高管报告: QBR模板、成功计划和高管业务审查模板

输入要求

所有脚本接受JSON文件作为位置输入参数。参阅assets/sample_customer_data.json了解完整示例。

健康评分计算器

{
  "customers": [
    {
      "customer_id": "CUST-001",
      "name": "Acme Corp",
      "segment": "enterprise",
      "arr": 120000,
      "usage": {
        "login_frequency": 85,
        "feature_adoption": 72,
        "dau_mau_ratio": 0.45
      },
      "engagement": {
        "support_ticket_volume": 3,
        "meeting_attendance": 90,
        "nps_score": 8,
        "csat_score": 4.2
      },
      "support": {
        "open_tickets": 2,
        "escalation_rate": 0.05,
        "avg_resolution_hours": 18
      },
      "relationship": {
        "executive_sponsor_engagement": 80,
        "multi_threading_depth": 4,
        "renewal_sentiment": "positive"
      },
      "previous_period": {
        "usage_score": 70,
        "engagement_score": 65,
        "support_score": 75,
        "relationship_score": 60
      }
    }
  ]
}

流失风险分析器

{
  "customers": [
    {
      "customer_id": "CUST-001",
      "name": "Acme Corp",
      "segment": "enterprise",
      "arr": 120000,
      "contract_end_date": "2026-06-30",
      "usage_decline": {
        "login_trend": -15,
        "feature_adoption_change": -10,
        "dau_mau_change": -0.08
      },
      "engagement_drop": {
        "meeting_cancellations": 2,
        "response_time_days": 5,
        "nps_change": -3
      },
      "support_issues": {
        "open_escalations": 1,
        "unresolved_critical": 0,
        "satisfaction_trend": "declining"
      },
      "relationship_signals": {
        "champion_left": false,
        "sponsor_change": false,
        "competitor_mentions": 1
      },
      "commercial_factors": {
        "contract_type": "annual",
        "pricing_complaints": false,
        "budget_cuts_mentioned": false
      }
    }
  ]
}

扩展机会评分器

{
  "customers": [
    {
      "customer_id": "CUST-001",
      "name": "Acme Corp",
      "segment": "enterprise",
      "arr": 120000,
      "contract": {
        "licensed_seats": 100,
        "active_seats": 95,
        "plan_tier": "professional",
        "available_tiers": ["professional", "enterprise", "enterprise_plus"]
      },
      "product_usage": {
        "core_platform": {"adopted": true, "usage_pct": 85},
        "analytics_module": {"adopted": true, "usage_pct": 60},
        "integrations_module": {"adopted": false, "usage_pct": 0},
        "api_access": {"adopted": true, "usage_pct": 40},
        "advanced_reporting": {"adopted": false, "usage_pct": 0}
      },
      "departments": {
        "current": ["engineering", "product"],
        "potential": ["marketing", "sales", "support"]
      }
    }
  ]
}

输出格式

所有脚本通过--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`	战略账户的高管利益相关者审查

最佳实践

定期评分：每周对企业进行健康评分，每两周对中端市场进行评分，每月对SMB进行评分
根据趋势行动，而不是快照：下降的绿色比稳定的黄色更紧急
结合信号：一起使用所有三个脚本以获得完整的客户画面
校准阈值：根据您的产品和行业调整段基准
记录干预措施：跟踪您采取的行动和结果，以完善剧本
用数据准备：在每次QBR和高管会议之前运行脚本

限制

没有实时数据：脚本分析来自JSON输入文件的点快照
没有CRM集成：必须从您的CRM/CS平台手动导出数据
仅确定性：没有预测ML——评分是基于加权信号的算法
阈值调整：默认阈值是行业标准的，但可能需要为您的业务校准
收入估计：扩展收入估计是基于使用模式的近似值

最后更新： 2026年2月 工具： 3个Python CLI工具 依赖项： Python 3.7+标准库仅

客户成功经理 customer-success-manager

客户成功经理

目录

功能

输入要求

健康评分计算器

流失风险分析器

扩展机会评分器

输出格式

如何使用

快速开始

工作流集成

脚本

1. health_score_calculator.py

2. churn_risk_analyzer.py

3. expansion_opportunity_scorer.py

参考指南

模板

最佳实践

限制