| 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
详细用法
核心估值流程
- 预测期自由现金流：基于基准 FCF 和增长率，逐年预测未来 N 年的 FCF
- 终值计算：使用 Gordon Growth Model（永续增长模型），
TV = FCF_n × (1+g) / (r-g)
- 折现求和：将预测期 FCF 和终值折现到当前，得到企业价值（Enterprise Value）
- 股权价值：
Equity Value = EV - Net Debt + Cash
- 每股价值：
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 的单元格表示该参数组合不满足数学约束
