热力图成交量分布窗口：历史深度、宽度与背板

它做什么

热力图的成交量分布是按价格统计成交量的直方图，画在图表左侧边缘。它不是由热力图的成交环形缓冲构建的（在活跃合约上那只保留几分钟），而是来自一个独立的累加器 RollingVolumeProfile，它每分钟保留一个已封闭切片，并在每次读取时把当前这一分钟折叠进去。画在热力图上的 POC、VAH 和 VAL 线来自同一份数据，因此线条与旁边的柱条始终一致。

分布历史选择器决定分布图累加多少分钟。由于每个分钟切片都已保存，从 5m 切到 1D 无需等待一天的采集：总和直接用内存中已有的切片重建。关键价位的标签报告的是实际覆盖的分钟数，而不是请求的分钟数，所以二十分钟前打开、选了 1h 窗口的图表会显示「20 min」。

在所有非加密数据源上，热力图打开时累加器会预热一次，从本地 K 线缓存读取最多一天的 1 分钟 K 线（cache_query_page，周期 1m，最旧优先）。缓存为空时分布图保持空白，直到实时成交到来；它绝不会阻塞热力图。在加密货币上，实时订单簿与期货缓存彼此独立，因此不做预热。

设置

怎么用

• 打开热力图，点击设置按钮并选择分布图标签页。同一标签页还放着 DOM 阶梯和流动性追踪的开关，因为分布图（左边缘）和阶梯（右边缘）是同一个市场的两种读法。
• 选择与你所交易的节奏相称的分布历史：抢帽子情境用 15m 或 30m，把握时段结构用 4h 或 1D。改动立即生效。
• 如果分布图在密集的热力图上不好读，先调高分布背板再去动颜色；把柱条与流动性像素分开的正是这块背板。
• 在交易时段中途打开应用后，请查看关键价位的覆盖分钟数标签：它告诉你 POC 实际总结了多少历史。

局限与陷阱

• 分布图按价格累加总成交量；它不拆分买卖两侧。阶梯的 bid × ask 读数来自另一个累加器（DOM 阶梯的成交量列）。
• 超过 24 小时的切片会被丢弃，所以 1D 是最大窗口。这里没有时段锚点：1D 指的是最近 1 440 分钟，而不是 CME 交易时段。
• 数量为零的 tick（Rithmic 的标记 tick）会被忽略。价格带宽 8 192 个 tick，以见到的第一个价格为中心，因此距离它超过 4 096 个 tick 的成交会被计为超出价格带，不计入直方图。
• 更换合约会重置累加器，因为以旧 tick 单位保存的成交量在新合约上没有意义。
• 预热只读取本地 K 线缓存：如果该合约的历史从未在足迹图上加载过，分布图就从实时数据流开始累计。