是什么（一句话）

把养老金/保险负债簿与资产放到真实主权即期曲线上对账——负债现值与 Fisher-Weil 久期、Redington 久期缺口、资金充足率及其 ±100bp 敏感度、久期覆盖的对冲比率。

怎么用

把 ldi_funding_gap_v1 拖进 Canvas，选负债剖面（默认平准年金），设年支付额与年限，填资产价值与资产久期，可选对冲覆盖（名义额+久期），选折现曲线（默认英国金边名义）后运行——自动拉取官方曲线（BoE GLC、Fed GSW、ECB AAA、日本财务省）。接到 risk_management 或 ALM institution_composite 上游，给 LDI/久期席位量化面。

核心公式

PV_L    = Σ CF_i · e^{−r(t_i)·t_i}                     # 即期曲线,连续复利
D_L(FW) = Σ t_i · CF_i · e^{−r(t_i)·t_i} / PV_L        # Fisher-Weil 久期
gap     = D_A − D_L                                    # 负=资产偏短
FR      = A / PV_L,   FR±100bp:负债全价重估,资产 A·e^{∓D_A·0.01}
hedge   = N_hedge·D_hedge / (PV_L·D_L)

假设与适用性

假设：连续复利折现（年复利来源经 ln(1+r) 换算并在 curve_meta 申报）；参数化平准支付负债；资产端=价值+久期；即期线性插值+平坦外推。

适用：GBP/USD/EUR/JPY 负债簿在官方曲线上的充足率与久期缺口姿态读数；对冲比率记账。

不适用：Solvency II SCR（EIOPA 冲击表 ≠ 平行 ±100bp）、关键期限/扭曲风险、长寿/通胀基差、日内对冲。

输入 / 输出契约

输入：liability_profile、liability_annual、liability_years、asset_value、asset_duration、curve（boe_nominal / boe_real / gsw_nominal / ecb / jp_mof）、hedge_notional、hedge_duration。

输出（v2，时间序列原生）：metrics（12 键，=序列末行）+ series——每个指标在曲线面板上的逐日序列（dates/dates_ord/n_dates）。metrics 键集：{liability_pv, liability_duration_fw, liability_convexity, asset_liability_duration_gap, dollar_duration_gap, funding_ratio, funding_ratio_up100, funding_ratio_down100, funding_ratio_sens_up100, funding_ratio_sens_down100, hedge_ratio, n_cashflows}，另附 curve_meta（来源、截面日期、陈旧度、期限范围、复利归一口径、par 近似标志）。曲线取不到时返回 status: unavailable 带原因——绝不编造曲线。

已知局限

1. ±100bp 按构造不对称：负债端全价重估，资产端久期近似（未提供资产现金流）。 1a. 序列是今日静态簿在各历史日期上的重估——负债重估 what-if 透镜（curve_meta.asset_side = static_book 申报），不是组合回测。 1b. 序列深度=曲线源适配器所持（BoE 适配器现载 2025→present；GSW/MoF 载数十年）——经 curve_meta.date_min/n_dates 申报，绝不填充。
2. jp_mof 提供 par 收益率，作 spot 近似——curve_meta.par_yield_approx 标志。
3. 只做平行位移；关键期限/扭曲敞口不在范围内。
4. 曲线为官方每日估计、有发布时滞；curve_meta.age_days 与 stale 如实报告。