用途
实物贵金属背离指数衡量上海黄金交易所实物基准价与对应 COMEX 期货快照之间的压力。它是市场结构指标，不是交易建议。 每日原始溢价来自GET /api/market/v1/get-physical-premiums。派生结果通过 GET /api/market/v1/get-physical-divergence-index 和 MCP get_market_data 提供。
历史和稳健归一化
Seeder 按实物公布日期把黄金和白银分别写入market:physical-premium-history:v1:gold 与 market:physical-premium-history:v1:silver。同一日期会替换旧点。写入、去重和截断在一个 Redis 操作中完成。每个列表最多保留 750 点，分类器使用最新 250 点，至少需要 60 个有效点。
每个点和响应都声明 methodologyVersion: physical-divergence-v2。
0；否则不提供 z 值。百分位是小于或等于当前溢价的窗口值占比，范围为 0 到 100。
混合状态
系统分别计算绝对状态和相对状态，并选择较高者。 相对阈值仅在溢价达到该金属elevated 阈值的一半时才生效：黄金为 0.5%，白银为 2.5%。仅判断正负是不够的——当前印价本身属于其滚动窗口，且百分位为闭区间，因此任何创窗口新高的取值都会得到 100，与幅度无关。若没有这道幅度下限，一个极小的正溢价只因高于一段平静窗口就会被判为 extreme。下限取在 elevated 阈值之下而非阈值本身，是为了让第 80 百分位这一档仍然可达。若按完整 elevated 阈值设限，相对判定并不会完全失效——第 95 与第 99 百分位仍可把绝对判定为 elevated 的溢价提升为 stressed 或 extreme——但第 80 百分位这一档将不可达，因为任何越过该下限的溢价在绝对幅度上本就已经是 elevated。取一半是该区间内的选定取值，并非唯一满足该约束的取值。
相对百分位阈值为 80、95 和 99，分别进入
elevated、stressed 和 extreme。因此，黄金溢价达到 3% 时至少为 stressed，即使历史窗口中还有更高值。
单金属压力指数范围为 0 到 100。绝对幅度在压缩后的分段顶点 45（elevated）、70（stressed）、以及略低于 90（接近 extreme；stressed 分段故意不到 90，避免两位小数舍入顶到 extreme 下限）之间插值；只有突破绝对 extreme 溢价阈值（黄金 5%、白银 20%）才发布 100。
当相对阶梯超过绝对幅度时，index 仍表示带状态有序下限的压力幅度，不是百分位的副本：
index = max(absoluteStressIndex, regimeFloor)。仅由相对阶梯触发的 extreme 下限为 90，不会顶满 100，从而把刻度顶端留给绝对 extreme，并保证指数对状态等级单调：任何 stressed 读数的指数都不会高于任何 extreme 读数。regime 仍承载混合分类（绝对与相对取较高者）；百分位作为独立字段发布。
综合指数为 70% 黄金 + 30% 白银，且只在两个金属状态均为 ok 时发布。
趋势和数据状态
5 日和 20 日变化是当前溢价减去 5 或 20 个观测点之前的溢价。变化大于0.01 个百分点为 widening，小于 -0.01 为 narrowing，其他为 stable。
状态按以下顺序判定：
missing_input：没有当前实物溢价输入。stale_input：实物公布日期超过 12 个日历日、COMEX 快照超过 36 小时，或外汇快照超过 60 小时。实物阈值容忍中国市场的长假休市；纸面价格和外汇阈值与各自的数据源健康预算一致。insufficient_history：有效历史点少于 60。ok：输入未过期且历史充分。
ok 状态不提供数值指数。任一金属不是 ok 时，综合指数也不发布。
转换信号和来源
只有前后状态均为ok、状态等级发生变化，并且同一金属在 48 小时内没有发过转换信号时，系统才生成跨源信号。48 小时正好是每日 cadence 的两倍。缺失、过期或历史不足的数据不会生成信号。向下转换也会保留。
响应包含实物基准来源、代码、实物公布日期、COMEX 快照时间、汇率快照时间、历史 key、样本数、窗口大小和方法版本。/api/health 使用独立 seed metadata 和 activation marker 监控 market:physical-divergence:v1。