feat: 增加 DCF 等估值工具

README.md

@@ -179,3 +179,27 @@ A：编辑 `js/theme.js` 的 `PALETTE` 对象，所有图表自动同步。
 ## 许可
 
 本项目代码采用 MIT 协议，数据仅供示例。
+
+## 估值工具
+
+左侧选择「估值工具」，打开「目标收益反推增长率」Tab。支持反推所需归母利润年复合增长率、计算预期年化 IRR、反推最高买入价；可调整安全边际、股息、股本变化率、基期和币种汇率。参数自动保存在当前浏览器，点击「恢复示例参数」可重置。
+
+入口：`#/valuation-tools/stock-return-valuation`。默认数字是教学情景假设，不是实时行情或财报。计算口径来自 `stock-return-valuation` 技能 v1.2.0，浏览器引擎位于 `js/tools/stock-return-math.js`，界面位于 `js/tools/stock-return-calculator.js` 和同名 HTML 模板。
+
+单独运行估值检查：`npm run test:valuation`；`npm test` 同时运行图表回归与估值检查。
+
+「DCF 估值」Tab（`#/valuation-tools/dcf`）采用分段工作台，可设置 1—5 个增长阶段，每段输入年数与现金流年增长率，总预测期不超过 30 年。支持 FCFF/WACC 与 FCFE/股权资本成本两种口径、永续增长终值、股权价值调整和逐年折现明细。
+
+总股本在基础参数区单独填写，单位为亿股；每股价值 = 股权价值（亿元）÷ 当前总股本（亿股）。每家公司的股本、股本日期、现金流和增长假设独立保存在当前浏览器，也可新增公司。真实公司初次使用时，现金流与股本留空，需自行核实后填写；教学示例的 10 亿股仅为假设。当前模型使用人民币金额与预测期内不变的股本。
+
+公司以按钮形式展示，点击即可切换；当前股价、股价日期和区间阈值也按公司自动保存到 LocalStorage，兼容原有 DCF 本地记录。股价需要手动输入，不自动请求行情。未填或填错股价不影响已完成的 DCF 计算，也不会保留上次股价标记。
+
+ECharts 区间图以 DCF 每股价值为基准，默认低于其 80% 为低估、高于其 120% 为高估，两端边界均包含在合理区间内。「区间设置」可分别修改低估折价（同时作为安全边际）与高估溢价阈值。这是当前假设下的自定义价格分区，不是独立的投资结论；无正股权价值时不显示区间。
+
+「目标收益交叉验证」共用当前公司的股价、股本、基期和 DCF 参考价。输入独立的归母净利润及预计利润增速后，可比较现价、DCF 含安全边际参考价两种买入情景的所需利润 CAGR 与预计 IRR，并查看悲观/基准/乐观退出 PE 情景。计算复用独立「目标收益反推增长率」工具的数学引擎。
+
+首屏顶部并列展示当前股价、按现价计算的预计年化 IRR、达到目标收益所需的利润年增速；后两项采用基准退出 PE，与下方现价情景结果同步。修改参数或切换公司后即时更新，参数不完整或无效时清除旧值。
+
+FCFE 模式可选择以用户提供的基期现金转化率（FCFE ÷ 归母净利润）估算利润；该值会明确标注为估算，不作为独立财报验证。FCFF 模式要求单独填写归母净利润。真实公司的利润、转化率和预计利润增速默认留空，新增验证参数仍按公司保存在原有 LocalStorage 记录中。
+
+双买入价格表按各自实际买入价反推增速及计算 IRR，不额外叠加安全边际。「共同参考买入上限」取 DCF 参考价和目标收益模型参考价的较低值，两边各应用一次安全边际。分红按独立路径计算；交叉验证中的股本变化仅影响收益模型，DCF 仍采用固定股本假设。验证参数缺失或无效时只隐藏验证结果，不影响有效的 DCF 结果。