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 | 永续增长率（必须 ...