feed-generator

ATProto Feed 生成器

这是用于创建 ATProto 订阅源生成器的入门套件。虽然功能不完整,但可以为您提供一个良好的起点,从而构建和部署订阅源。

概述

Feed 生成器是通过 AT 协议为用户提供自定义算法的服务。 它们的工作非常简单:服务器从用户服务器接收请求,并返回附带一些可选元数据的 帖子 URI 列表。然后,请求服务器将这些帖子转换为完整的视图,并将其发送回客户端。此路由在 app.bsky.feed.getFeedSkeleton 词典 中进行了描述。

Feed Generator 服务可以托管一个或多个算法。服务本身通过 DID 进行标识，而它托管的每个算法都通过创建算法的账户的 repo 中的记录进行声明。例如，Bluesky 提供的 feed 可能会在 @bsky.app 的 repo 中进行声明。因此，给定的算法通过声明记录的 at-uri 进行标识。此声明记录包括指向服务的 DID 以及 feed 的一些配置信息。

提供自定义算法给用户的一般流程如下:

• 用户使用声明的源的 at-uri 向其服务器 (PDS) 请求源
• PDS 解析 at-uri 并找到 Feed Generator 的 DID 文档
• PDS 向 Feed Generator 在 DID 文档中声明的服务端点发送 getFeedSkeleton 请求
• 此请求由用户的仓库签名密钥签名的 JWT 进行身份验证
• Feed Generator 将源的骨架返回给用户的 PDS
• PDS 将源进行水合 (用户信息、帖子内容、聚合等)
• 在未来,PDS 将通过应用视图来对源进行水合,但目前 PDS 会自行处理水合

对于用户来说，这应该感觉就像访问应用程序中的一页。一旦他们订阅了自定义算法，它就会在其主界面中出现，作为他们可用的源之一。