Placeholder: as_of is not a date filter

占位正文 / placeholder body. 第二篇存在的理由是把管线证伪不了的部分 跑通:两篇以上时索引页的排序、sitemap.xml 的多条 <url>、以及 generateStaticParams 真的按注册表出多个静态页。文案随后替换。

这一篇将来要讲清一件被反复问到的事:as_of 不是"按发布日过滤"。

将来要写的三段

1. 版本 vs 文档。 一份 2024 年的申报在 2026 年被修订,语料里因此有两个 版本。as_of=2024-06-30 要返回的是当时那一版的正文,而不是"2024 年 之前发布过的所有文档"。这两者在回测里的差别就是 look-ahead bias 有没有。
2. 为什么它必须在索引里。 时间维度是索引的一部分(版本区间),不是查询时 加的一个 filter。事后补这一层,等于重建整个索引的时间维度 —— 这也是 为什么通用检索 API 很难补上这条。
3. 它的边界。 语料本身有起点;比起点更早的 as_of 会返回一个权威的 空结果,那是最坏的一种错:看起来像答案。所以起点必须先配置、先实测, 然后才敢印在页面上。

这一段的每一个数字都要在写作时实测,而不是从别的文档抄。 拿不到实测值的地方就留空,不写约等号。