cashflow-valuation

name	cashflow-valuation
description	DCF现金流折现估值模型，支持完整的自由现金流预测、终值计算和企业价值推导，并生成增长率 × 折现率的敏感性分析矩阵。当用户需要进行企业估值、DCF分析、现金流折现计算、WACC折现、终值计算、敏感性分析、股权价值或每股价值估算，或提及关键词如DCF、估值、折现、现金流、WACC、terminal value、sensitivity analysis、企业价值、equity value、Gordon Growth Model、自由现金流时触发。
license	MIT

DCF Valuation / 现金流折现估值模型

基于 DCF（Discounted Cash Flow）方法的企业估值工具，支持完整的自由现金流预测、终值计算、企业价值推导，并自动生成 增长率 × 折现率 的敏感性分析矩阵。

Quick Start

基础 DCF 估值

python scripts/dcf_model.py --fcf 1000 --growth 0.15 --discount 0.10

带敏感性分析矩阵

python scripts/dcf_model.py --fcf 1000 --growth 0.15 --discount 0.10 --sensitivity

完整股权估值 + CSV 导出

python scripts/dcf_model.py \
    --fcf 5000 --growth 0.12 --discount 0.09 \
    --terminal-growth 0.03 --years 5 \
    --debt 8000 --cash 3000 --shares 10000000 \
    --currency "万元" \
    --sensitivity \
    --growth-range 0.05,0.25,0.05 \
    --discount-range 0.06,0.14,0.02 \
    --output valuation.csv

详细用法

核心估值流程

1. 预测期自由现金流：基于基准 FCF 和增长率，逐年预测未来 N 年的 FCF
2. 终值计算：使用 Gordon Growth Model（永续增长模型），TV = FCF_n × (1+g) / (r-g)
3. 折现求和：将预测期 FCF 和终值折现到当前，得到企业价值（Enterprise Value）
4. 股权价值：Equity Value = EV - Net Debt + Cash
5. 每股价值：Per Share = Equity Value / Shares Outstanding

敏感性分析矩阵

通过 --sensitivity 参数自动生成二维矩阵，展示不同增长率和折现率组合下的企业价值，帮助理解关键假设变化对估值的影响。

矩阵中用 [方括号] 标记基准情景（base case）。

JSON 输出模式

添加 --json 参数可将完整结果以 JSON 格式输出到 stdout，便于程序化处理：

python scripts/dcf_model.py --fcf 1000 --growth 0.15 --discount 0.10 --json

参数说明

参数	必填	默认值	说明
--fcf	是	-	基准年自由现金流（正数）
--growth	是	-	年增长率，如 0.15 表示 15%
--discount	是	-	折现率 / WACC，如 0.10 表示 10%
--terminal-growth	否	0.03	永续增长率（必须 < 折现率）
--years	否	5	预测年数（1-30）
--debt	否	0	净负债（用于计算股权价值）
--cash	否	0	现金及等价物
--shares	否	0	总股本（用于计算每股价值）
--sensitivity	否	false	生成敏感性分析矩阵
--growth-range	否	自动	增长率范围 min,max,step，如 0.05,0.25,0.05
--discount-range	否	自动	折现率范围 min,max,step，如 0.06,0.14,0.02
--output	否	-	输出文件路径（.csv 或 .json）
--currency	否	""	金额单位标签，如 万元、M USD
--json	否	false	以 JSON 格式输出到 stdout

使用场景

• 对目标公司进行 DCF 估值，评估其合理价格区间
• 投资决策前的估值敏感性检验（关键假设变化多大会改变结论）
• 财务建模时快速生成估值矩阵表格
• 输出 CSV/JSON 结果，嵌入更大的分析流程或报告中

注意事项

• 折现率必须大于永续增长率（Gordon Growth Model 的数学要求）
• 本工具使用纯 Python 标准库，无需安装额外依赖
• 敏感性矩阵中标记为 N/A 的单元格表示该参数组合不满足数学约束