做什么（One-liner）

从 yfinance 三表（利润 / 资产负债 / 现金流）计算 30+ 财务指标 + V 综合分（0-100），9 类分组展示 + 硬约束 warning。是 BLCV 综合评分的 V 维度输入。

怎么用

Canvas 拖 blcv_financials_v1，填 symbol。输出展示 9 类指标（流动性 / 偿债 / 盈利 / 成长 / 现金流 / 估值 / 效率 / 资产结构 / 负债结构）+ v_score + warnings（软性：高杠杆）+ errors（硬性：破产风险）。

核心公式

V_score 是 9 类子指标的加权合成后 clamp [0, 100]。关键比率：

• Current Ratio = current_assets / current_liabilities
• Debt/Asset = total_debt / total_assets
• ROIC = NOPAT / invested_capital
• FCF Yield = free_cash_flow / market_cap

假设与适用场景

假设：yfinance 三表标准字段名；最新季度代表现状；V 维子权重经验分配（not learned）。

适用：发达市场股票；制造业 / 消费 / 科技 / 医药等实体经济；中长期持有视野。

不适用：银行 / 保险（资本结构特殊）；REIT / 基金（AUM 指标）；pre-revenue 早期；加密。

输入 / 输出契约

symbol: str → 大 dict 含 9 类 nested 子字典 + v_score: float + warnings: list + errors: list + logic_lineage: list。详见 frontmatter。

已知局限

1. 季度滞后（earnings 前数据反映上季度）
2. yfinance 行名偶漂移 → 启发式映射可能漏
3. 极值 auto-clamp 可能 mask 真问题
4. AAPL Current Ratio<1 触发 error 是假阳性 → 规则需 context-aware（follow-up）

参考文献

Graham-Dodd (1934) + Altman (1968) bankruptcy prediction + Damodaran (2012) Investment Valuation。详见 frontmatter。

Golden Test

tests/golden/fixtures/tier1/blcv_financials/，integration_regression 类型（pickled yfinance raw-data snapshot for AAPL 2026-04-20 replayed）。Tolerance 1e-6 absolute。4 tests：matches_snapshot + v_score_in_0_100 + determinism + top_level_field_set。

Changelog

• 1.1.0 (2026-04-20) — 0-100 scale 对齐 + lineage 同步
• 1.0.0 (2026-04-19) — 首次生产（0-1）