cashflow-valuation

# DCF Valuation / 现金流折现估值模型 基于 DCF（Discounted Cash Flow）方法的企业估值工具，支持完整的自由现金流预测、终值计算、企业价值推导，并自动生成 **增长率 × 折现率** 的敏感性分析矩阵。 ## Quick Start ### 基础 DCF 估值 ```bash python scripts/dcf_model.py --fcf 1000 --growth 0.15 --discount 0.10 ``` ### 带敏感性分析矩阵 ```bash python scripts/dcf_model.py --fcf 1000 --growth 0.15 --discount 0.10 --sensitivity ``` ### 完整股权估值 + CSV 导出 ```bash 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，便于程序化处理： ```bash 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` 的单元格表示该参数组合不满足数学约束