DCF 三场景估值技能

对用户输入的公司（股票代码或中文名）调用远程 API，获取财务数据后由 AI 设定悲观/中性/乐观三套参数，分别计算 DCF 并汇总呈现。

配置（与安装位置解耦，与 cashflow-viewer / company-checkup 共用）

推荐：使用统一配置路径 ~/.config/godknows/config.json（与技能安装位置无关，便于多端共用）。格式：
```
{ "api_base": "http://money.whatis.vip", "username": "xxx", "password": "xxx", "token": "获取到的token" }
```
运行时可将该文件中的 api_base、token 通过环境变量 GODKNOWS_API_BASE、GODKNOWS_TOKEN 传给脚本；或调用脚本时直接传参 [api_base] [token]。
也可在技能根目录下放置 config.json（技能根目录 = SKILL.md 所在目录，由安装环境决定）。

首次使用

若尚无 token，向用户询问用户名和密码，在本技能根目录下执行登录脚本（将 <SKILL_ROOT> 替换为当前技能根目录，如 ~/.cursor/skills/dcf-three-scenario）：

bash <SKILL_ROOT>/scripts/login.sh <username> <password> [api_base]

登录成功后会写入 ~/.config/godknows/config.json（含 api_base、token、username、password_b64），与 company-checkup、cashflow-viewer 共用。token 过期时：执行 bash <SKILL_ROOT>/scripts/login.sh（不传参），从 config 读取账号密码并刷新 token，无需再向用户索要。config 含敏感信息，请勿泄露。

后续使用

直接使用 config 中的 token。若 API 返回 errorCode: "NOT_LOGIN"，执行 bash <SKILL_ROOT>/scripts/login.sh（不传参）从 config 刷新 token 即可，无需再向用户要账号密码。

公司需在平台已有数据（在「可选公司列表」中），否则接口会返回「未找到该公司数据」。

工作流程

<SKILL_ROOT> 为本技能根目录；api_base、token 从 config 或环境变量或脚本参数传入（同上）。

解析公司
- 若输入为股票代码（如 AAPL、00700），直接使用。
- 若为中文名或模糊名，执行 bash <SKILL_ROOT>/scripts/companies.sh [api_base] [token]，在返回的 data[].label 中匹配得到 ticker。
获取基础数据
- bash <SKILL_ROOT>/scripts/company_data.sh <ticker> [api_base] [token]
- 得到自由现金流(FCF)、总现金、总债务、流通股、当前股价等。若 success 为 false 或 FCF 无效，直接报错并提示。
AI 评估三套参数
- 必须结合行业与生意模式，不得对所有公司一刀切（如固定 8%/12%/18% 折现率）。先读 references/duan-yongping-dcf.md 与 references/parameter-guide.md：按行业/护城河确定折现率基准（无风险利率 + 风险溢价），再在悲观/中性/乐观间分化。悲观折现率最高、增速最低，乐观反之。
三次 DCF 计算
- 对悲观、中性、乐观各执行一次：
  bash <SKILL_ROOT>/scripts/calculate.sh <ticker> <discountRate> <growthRate> <perpetualGrowthRate> [api_base] [token]
- 参数为小数（如 0.12 表示 12%）。
汇总呈现
- 表格列出三场景：折现率、预测期增长率、永续增长率、企业价值、股权价值、每股内在价值、与当前股价对比、安全边际、结论；可补充简要结论。

API 响应格式

通用：{ "success": true|false, "data": <payload>, "errorMessage": "..." }
失败时 success === false，用 errorMessage 提示用户。
GET /api/dcf/company/{ticker} 的 data 字段包含 YahooFinancialDataDO 结构（含 freeCashFlow、totalCash、totalDebt、sharesOutstanding、currentPrice 等）。
POST /api/dcf/calculate 的 data 见 references/api-dcf.md。

错误与边界

未配置或 token 过期时：先执行 scripts/login.sh（不传参）尝试从 config 刷新；若 config 无账号密码再向用户询问并执行 login.sh <username> <password>。
公司不存在或 FCF/流通股无效：直接返回接口错误信息，不进行参数评估。
折现率必须大于永续增长率，否则终值无意义；AI 设定参数时须保证这一点。