今天我们推出了 Bluesky 协议服务：一个全新的品牌和一个全新的网站，专为 Bluesky 在 AT 协议网络上运营的公共基础设施。Bluesky 一直以来提供的服务不仅仅是 Bluesky 应用程序。我们运营 Jetstream 实例、中继以及建立在 atproto 上的 Bluesky API 端点。但是，如果你是一名开发者，试图在这些基础设施上进行开发，我们的文档并不总是容易让人了解我们提供了什么服务或从何开始。今天我们正在解决这个问题。Bluesky 协议服务组织了开发者在生态系统中所需的所有文档，澄清了围绕 Bluesky 提供的基础设施的服务合同，替换了旧的 docs.bsky.app 网站，并为我们提供了一种干净的方式来发布未来的版本，就像这篇文章中的版本！与新网站一起发布的头条版本是 Jetstream v2。Jetstream 是大多数开发者按规模使用网络的最佳方式：你描述所需的切片，它会作为普通 JSON 通过 WebSocket 到达。它不能给你的是历史。如果你需要已经存在于网络上的记录，你必须自己填充存储库，然后切换到实时流。Jetstream v2 为服务器添加了该功能。它保持整个网络的压缩归档，并添加了一种新的消费方式，除了实时尾部：网络重放让你能从过去的任何点追赶并且无缝切换到实时。你将过滤器发布到 planSnapshot，通过普通 HTTP 下载它返回的封装段，然后在尖端连接实时 WebSocket。重放在服务器上是无状态的，没有每个消费者的游标，没有注册订阅，也没有客户机上的任何暂存。Jetstream 是你的缓冲区。你也可以快速快照网络——是归档的一个时间点副本，仅通过 HTTP（listSegments + getSegment），没有实时尾部。相同的归档、相同的过滤器，没有 WebSocket。这解锁了更复杂的服务器端切片，而无需在本地回填：你可以启动一个应用程序，运行一个月的帖子分析，或从停机中恢复，所有这些都通过与实时尾部相同的 JSON 形式进行。提供这些归档是带宽密集型的。为确保服务保持可靠且运行成本低，我们现在要求仅用于这些请求的 API 令牌。实时尾部仍然开放且无需身份验证，只有在你请求归档时我们才要求令牌。我们没有计划为实时流引入身份验证要求。v2 实例现已在 wss://jetstream.us-west.bsky.network 和 wss://jetstream.us-east.bsky.network 上上线。现有的 v1 实例将保持不变一段时间，实时尾部在两者上表现相同，因此没有紧迫感去迁移。请在网络重放文档中阅读完整流程。而且！一如既往，这个基础设施是开源的且可以自托管。有关详细信息，请参见运行你自己的 Jetstream。Jetstream 是普通 JSON，因此你永远不需要 SDK。但是有一些常见的连接：重新连接、去重、游标管理、将事件解码为类型化记录。因此，新的 Jetstream SDK：TypeScript 和 Go 客户端，让你构建一个 Jetstream 对象，传递过滤器，并等待解码的、类型化的事件：TypeScript SDK 可以从 npm 获得，包括 npmx。Go SDK 则作为 Jetstream 项目的一部分提供。Jetstream SDK 文档提供了更多详细信息。回到五月，我们将 lex SDK 提升为稳定预览，并承诺独立的 Bluesky 文档会随之而来。现在这一点已完成：Bluesky TypeScript SDK 建立在 @atproto/lex 之上，这意味着我们不再维护针对 Bluesky 专用帮助程序的遗留代码路径。这是词汇工具链，从协议层到 app.bsky 记录完全类型化。这个新网站上的每个 TypeScript 示例都是基于它编写的，标志着我们对遗留技术债务的一次巨大转变——这对我们来说是良好的代码卫生，并应消除对已弃用 SDK 的 LLM 推荐。如果你仍在使用 @atproto/api 代码，它将继续按以前的方式工作，Bluesky API 指南则作为迁移参考。最后，HTTP 参考已经更新。从 https://docs.bsky.app 中提取这些文档实际上是这次改革的第一步；现在我们正在落地其余部分。用于重放的新网络.bsky.jetstream.* 方法——planBackfill、listSegments、getSegment 和 getBlock——现在可以浏览完整的请求和响应架构，参考文档现在也记录了 Jetstream 的 WebSocket 端点，因此整个 Jetstream v2 表面都位于一个地方。以上所有内容今天均已上线：新网站、v2 Jetstream 实例、SDK 预览和更新的 HTTP 参考。如果你是网络的新手，请从《工作原理》开始，这是关于记录、词汇和大数据流如何结合在一起的视觉演示。如果你在构建 Bluesky 应用程序的数据模型，Bluesky API 指南仍然存在，并且已全新编写（更多内容在下面）。如果你在重放上构建了某些内容，