版本与历史查询

快照标识一组完成发布的板块目录、热度、公司映射、证据和资金数据。

使用场景

典型场景：

多个接口必须使用同一组板块、热度、映射和资金数据。
回看某个日期或复现历史结果。

选择版本

http

GET /api/gendangzou/snapshots/latest
GET /api/gendangzou/snapshots/latest?as_of=YYYY-MM-DD
GET /api/gendangzou/snapshots?start=YYYY-MM-DD&end=YYYY-MM-DD

as_of 表示该日期或此前最近的完整版本。响应中的实际 as_of 和 snapshot_id 才是后续调用应使用的值。

跨接口一致性

取得 snapshot_id 后，把它传给支持该参数的板块、信号、公司和证据接口：

text

snapshot.latest
  -> signal.heat.rank?snapshot_id=...
  -> sector.detail?snapshot_id=...
  -> evidence.sector.list?snapshot_id=...

这样可以防止长任务执行期间恰好发布新版本，导致一次回答混入两个不同的数据状态。

精简响应

Agent 使用快照时建议显式传：

text

detail=compact

需要附加上下文时再通过 include 选择：

include	内容
`coverage`	数据覆盖与完成度
`sector_dynamics`	板块异动和同日关联

发布期间

生产任务更新期间，API 继续提供上一份完整版本，不暴露正在写入的中间状态。

版本与历史查询 ​

使用场景 ​

选择版本 ​

跨接口一致性 ​