TL;DR, szybka odpowiedź
9 min czytaniaGenerator kanałów Bluesky to usługa sieciowa, która implementuje jedno zapytanie AT Protocol, app.bsky.feed.getFeedSkeleton, i zwraca listę adresów AT-URI postów bez ich treści. AppView Bluesky zamienia te adresy w pełne posty, zanim zobaczy je klient. Sam kanał deklaruje rekord app.bsky.feed.generator w repozytorium twórcy, który wymaga tylko did, displayName i createdAt i wskazuje DID usługi. Usługa potwierdza własność tego DID plikiem .well-known/did.json z wpisem usługi typu BskyFeedGenerator. Żądania przychodzą z tokenem JWT podpisanym kluczem repozytorium użytkownika, a limit wynosi najwyżej 100.
Czym jest generator kanałów Bluesky?
Każdy niestandardowy kanał w aplikacji Bluesky obsługuje generator kanałów (feed generator), czyli zwykła usługa HTTPS, która odpowiada na jedno zapytanie i zwraca wyłącznie listę adresów postów. Nie przechowuje tekstu postów, awatarów ani liczby polubień. Układa ranking i nic więcej.
Oficjalny zestaw startowy ujmuje to prosto: "the server receives a request from a user's server and returns a list of post URIs with some optional metadata attached. Those posts are then hydrated into full views by the requesting server and sent back to the client."
Na tym podziale opiera się cały projekt. Twoja usługa decyduje, które posty pokazać i w jakiej kolejności. Infrastruktura Bluesky zamienia adresy w posty gotowe do wyświetlenia.
Który leksykon implementuje generator kanałów?
Dokładnie jeden: app.bsky.feed.getFeedSkeleton. Leksykon opisuje go tak: "Get a skeleton of a feed provided by a feed generator. Auth is optional, depending on provider requirements, and provides the DID of the requester. Implemented by Feed Generator Service."
Wokół tego procesu działają cztery leksykony, a wiedza o tym, która strona implementuje który, oszczędza dzień debugowania:
| Leksykon | Typ | Implementuje | Cel |
|---|---|---|---|
app.bsky.feed.generator | record | repozytorium twórcy | Deklaruje istnienie kanału i wskazuje DID usługi |
app.bsky.feed.getFeedSkeleton | query | twój generator kanałów | Zwraca uporządkowaną listę URI postów |
app.bsky.feed.describeFeedGenerator | query | twój generator kanałów | Podaje, które URI kanałów obsługuje ta usługa |
app.bsky.feed.getFeed | query | AppView Bluesky | Zwraca uzupełniony kanał, który faktycznie wyświetla klient |
describeFeedGenerator wyraźnie nie jest metodą AppView: "Does not require auth; implemented by Feed Generator services (not App View)." Wywołanie jej na AppView zwraca {"error":"MethodNotImplemented","message":"Method Not Implemented"}, a wywołanie na własnej usłudze Discover od Bluesky pod discover.bsky.app zwraca wszystkie URI kanałów, które ta usługa hostuje.
Co zawiera rekord app.bsky.feed.generator?
To rekord sprawia, że kanał pojawia się w aplikacji, a znajduje się on w twoim repozytorium, a nie na twoim serwerze. Leksykon nazywa go "Record declaring of the existence of a feed generator, and containing metadata about it. The record can exist in any repository."
| Pole | Typ | Wymagane | Ograniczenie |
|---|---|---|---|
did | string, format: did | tak | DID usługi, która obsługuje kanał |
displayName | string | tak | maxGraphemes: 24, maxLength: 240 |
createdAt | string, format: datetime | tak | |
description | string | nie | maxGraphemes: 300, maxLength: 3000 |
descriptionFacets | array | nie | Wpisy app.bsky.richtext.facet |
avatar | blob | nie | accept: image/png, image/jpeg, maxSize: 1000000 |
acceptsInteractions | boolean | nie | Włącza dla kanału app.bsky.feed.sendInteractions |
contentMode | string | nie | contentModeUnspecified lub contentModeVideo |
Wymagane są trzy pola i żadne z nich nie jest algorytmem. Zwróć uwagę na limit displayName wynoszący 24 grafemy, na tyle krótki, że większość nazw kanałów zostanie przycięta, zanim to zauważysz, oraz na pułap awatara 1 000 000 bajtów. Różnica między grafemami a bajtami stojąca za tymi liczbami to ta sama, która sprawia kłopoty przy przesunięciach bajtów w facetach Bluesky.
contentMode to jedyne pole, które zmienia sposób wyświetlania. app.bsky.feed.defs#contentModeVideo to token, który "Declares the feed generator returns posts containing app.bsky.embed.video embeds", przełączając klienta na pełnoekranowy odtwarzacz wideo.
Klucz rkey rekordu staje się publicznym identyfikatorem kanału. Kanał Discover od Bluesky ma adres at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.generator/whats-hot, gdzie DID należy do konta bsky.app, a whats-hot to klucz rekordu.
Jak Bluesky znajduje moją usługę?
Przez dokument DID z wpisem usługi typu BskyFeedGenerator. Rekord daje Bluesky DID. Rozwiązanie tego DID daje Bluesky adres URL.
Zestaw startowy konfiguruje to jako did:web, więc twoja domena serwuje dokument pod /.well-known/did.json. Produkcyjna usługa Discover od Bluesky robi to samo i możesz go pobrać:
{
"id": "did:web:discover.bsky.app",
"service": [
{
"id": "#bsky_fg",
"type": "BskyFeedGenerator",
"serviceEndpoint": "https://discover.bsky.app"
}
]
}id o wartości #bsky_fg i type o wartości BskyFeedGenerator to stałe ciągi. Pomyl któryś z nich, a kanał nie rozwiąże się do niczego.
Dwa wymagania dotyczące hostingu pochodzą z pliku README, a nie ze specyfikacji. "Your feed will need to be accessible at the value supplied to the FEEDGEN_HOSTNAME environment variable" oraz "The service must be set up to respond to HTTPS queries over port 443." Zwykły HTTP nie wchodzi w grę, podobnie jak niestandardowy port.
Zestaw startowy ostrzega też przed pułapką przy migracji, o której warto pomyśleć przed wyborem domeny: możesz chcieć użyć did:plc "if you expect this Feed Generator to be long-standing and possibly migrating domains." did:web to twoja nazwa hosta. Zmień hosta, a każdy opublikowany rekord, który na niego wskazuje, przestanie działać. did:plc przetrwa przeprowadzkę.
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI

Co zwraca getFeedSkeleton?
Kursor i tablicę wpisów app.bsky.feed.defs#skeletonFeedPost, z których każdy to AT-URI z opcjonalnym kontekstem. Oto prawdziwa odpowiedź usługi Discover od Bluesky, skrócona do dwóch elementów:
{
"cursor": "eyJvIjoiMjAyNi0wOS0xMVQxMDo0OTowNi42NTI4NDk4NzVaIiwibiI6IjIwMjYtMDktMTFUMjI6NDk6MDYuNjUyODQ5ODc1WiIsInNzIjoiMjAyNi0wOS0xMVQyMjo0OTowNi42NTI4NDk4NzVaIiwibHUiOiIyMDI2LTA5LTExVDIyOjQ5OjA2LjY1NjYyMzMwM1oiLCJwZyI6MSwibSI6IkFRQUFBQUFBQUFBSkFBQUFPakFBQUFJQUFBRHNWZ0FBa1ZjQUFCZ0FBQUFhQUFBQUtMTTNrUT09In0=",
"feed": [
{
"feedContext": "th-nature_animals_pets",
"post": "at://did:plc:mpvivcve3y2fdlw7pmq7niwz/app.bsky.feed.post/3mvb4r2qh4k2r"
},
{
"feedContext": "th-science_research",
"post": "at://did:plc:fb57h2fswm7s2qqzxflizlk7/app.bsky.feed.post/3mvasir35ec2e"
}
]
}W każdym wpisie wymagane jest tylko pole post. feedContext jest opcjonalne, ma limit maxLength: 2000, a leksykon opisuje je jako "Context that will be passed through to client and may be passed to feed generator back alongside interactions." Bluesky używa go do etykiet tematycznych, co widać po ciągu th-nature_animals_pets powyżej. Odpowiedź może też zawierać reqId, czyli "Unique identifier per request", o długości do 100 znaków.
Parametr limit ma udokumentowaną dolną i górną granicę: minimum: 1, maximum: 100, default: 50, a AppView ich pilnuje. Żądanie 101 elementów zwraca:
{ "error": "InvalidRequest", "message": "Invalid app.bsky.feed.getFeed params: integer too big (maximum 100, got 101)" }Paginacja opiera się na nieprzejrzystym kursorze, który wymyśla twoja usługa. Zestaw startowy precyzuje, jakiej postaci oczekuje: "We strongly encourage that the cursor be unique per feed item to prevent unexpected behavior in pagination. We recommend, for instance, a compound cursor with a timestamp + a CID."
Jak uwierzytelniane jest żądanie?
Tokenem JWT podpisanym kluczem repozytorium użytkownika wysyłającego żądanie, a zestaw startowy podaje zarówno nagłówek, jak i ładunek:
const header = {
type: 'JWT',
alg: 'ES256K', // (key algorithm) - in this case secp256k1
};
const payload = {
iss: 'did:example:alice', // (issuer) the requesting user's DID
aud: 'did:example:feedGenerator', // (audience) the DID of the Feed Generator
exp: 1683643619, // (expiration) unix timestamp in seconds
};Weryfikacja jest opcjonalna, a zalecenia zależą od tego, co robi twój kanał: "If you are creating a generic feed that does not differ for different users, you do not need to check auth. But if a user's state (such as follows or likes) is taken into account, we strongly encourage you to validate their auth token." Kanał personalizowany na podstawie obserwacji, który nie sprawdza iss, to kanał, o który każdy może zapytać jako ktokolwiek.
Własna usługa Discover od Bluesky odpowiada na nieuwierzytelnione żądania getFeedSkeleton prawdziwym szkieletem, co jest tanim sposobem na sprawdzenie, czy dobrze rozumiesz ten endpoint.

- Bez obserwacji, polubień i stanu użytkownika
- Sprawdzanie uwierzytelnienia jest opcjonalne
- Ranking odczytuje DID z pola iss
- Bez weryfikacji każdy może pytać jako ktokolwiek
Skąd pochodzą posty?
W niemal każdej prawdziwej implementacji z firehose: "For most use cases, we recommend subscribing to the firehose at com.atproto.sync.subscribeRepos. This websocket will send you every record that is published on the network."
Generator kanałów nigdy nie serwuje treści, więc może wyrzucić prawie wszystko. "Unless your algorithm is intended to provide posts you missed or something similar, you can likely garbage collect any data that is older than 48 hours."
Trzy schematy naszkicowane w zestawie startowym obejmują większość kanałów, jakie ludzie budują. Kanał typu „na czasie” zlicza polubienia postów i zwraca najnowsze posty powyżej progu. Kanał społeczności zbiera listę DID i zwraca wszystko, co publikują. Kanał tematyczny przepuszcza tekst postów przez dopasowanie słów kluczowych lub model. Firehose działa obok pozostałych limitów API Bluesky, w których będziesz się poruszać.
Czego dokumentacja nie określa?
Kilku rzeczy, a to właśnie w tych lukach generatory kanałów psują się na produkcji, a nie podczas testów.
Zadeklarowany błąd nie zgadza się z tym, który faktycznie pada. getFeedSkeleton i getFeed deklarują w swoich leksykonach dokładnie jeden błąd: UnknownFeed. Zapytaj AppView o kanał, który nie istnieje, a dostaniesz {"error":"InvalidRequest","message":"could not find feed"}. Zapytaj własną usługę Discover od Bluesky, a dostaniesz {"message":"no such feed: \"nope-not-real\""}, zupełnie bez pola error. Dwa kształty na produkcji i żaden nie ma udokumentowanej nazwy.
Zestaw startowy jest starszy od leksykonu, który opisuje. Jego sekcja o metadanych szkieletu mówi "for now, the only defined reason is a repost, but this is open to extension." Obecny skeletonFeedPost ma unię reason z dwoma elementami: #skeletonReasonRepost i #skeletonReasonPin. Jeśli oprzesz się na typie Reason z README, nie dowiesz się, że przypinanie istnieje.
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Zmieniła się też kwestia uzupełniania danych. README mówi "In the future, the PDS will hydrate the feed with the help of an App View, but for now, the PDS handles hydration itself", a leksykon getFeed stwierdza dziś krótko "Implemented by App View."
Sam szkielet nie ma opublikowanego limitu. limit ogranicza żądanie do 100 elementów, ale tablica feed w odpowiedzi nie ma maxLength i nigdzie nie napisano, co się stanie, gdy generator zwróci więcej, niż poproszono. getFeedGenerator zwraca isOnline i isValid, opisane jako informacja, czy usługa "has been online recently, or else seems to be inactive" oraz czy "is compatible with the record declaration." Ani "recently", ani "compatible" nie zdefiniowano nigdzie.
Jak opublikować kanał?
Zapisując rekord przez com.atproto.repo.putRecord we własnym repozytorium. Skrypt publikacji z zestawu startowego robi dokładnie to: collection ma wartość app.bsky.feed.generator, rkey to krótka nazwa, która staje się adresem URL kanału, a did to did:web:$FEEDGEN_HOSTNAME, chyba że podasz własny DID usługi. Zmiana nazwy, opisu lub awatara to to samo wywołanie z tym samym rkey. Nie ma żadnej kolejki zatwierdzania.
Nic z tego nie zastępuje zwykłego publikowania. Generator kanałów decyduje, co widzi czytelnik, a umieszczenie własnych postów w sieci to nadal planowanie postów na Bluesky przez zwykły zapis rekordu, którym AdaptlyPost zajmuje się razem z innymi sieciami, a zaangażowanie trafia potem do analityki Bluesky.
Najczęściej zadawane pytania
Czy do uruchomienia generatora kanałów Bluesky potrzebuję serwera?
Tak. Rekord kanału znajduje się w twoim repozytorium, ale na getFeedSkeleton musi odpowiadać usługa, którą sam hostujesz, przez HTTPS na porcie 443, pod nazwą hosta wskazaną w dokumencie DID. Nie da się zdefiniować niestandardowego kanału wyłącznie wewnątrz Bluesky.
Czy generator kanałów widzi treść postów?
Tylko tę, którą sam zbierze, zwykle z firehose. Zwracany szkielet zawiera wyłącznie AT-URI, a uzupełnianie danych odbywa się po stronie Bluesky, gdy twoja usługa już odpowie.
Czym różni się getFeed od getFeedSkeleton?
getFeedSkeleton należy do ciebie i zwraca wpisy skeletonFeedPost, czyli same URI. getFeed należy do AppView i zwraca wpisy feedViewPost, czyli pełne posty z profilami autorów i licznikami. Klienci wywołują getFeed. Twoja usługa nigdy tego nie robi.
Skąd mam wiedzieć, że mój kanał nie działa?
Wywołaj app.bsky.feed.getFeedGenerator z AT-URI swojego kanału. Zwraca isOnline i isValid razem z widokiem kanału. Bluesky nie podaje, jak niedawno usługa musiała odpowiedzieć, by uznać ją za aktywną, więc wartość false potraktuj jako sygnał do sprawdzenia własnych logów.
Czy mogę pobierać opłaty za kanał lub ograniczać, kto go widzi?
Protokół daje punkt zaczepienia, ale nie daje rozliczeń. Uwierzytelnianie w getFeedSkeleton jest opcjonalne, a jeśli występuje, JWT zawiera DID użytkownika w polu iss, więc ograniczenie dostępu do listy DID jest proste. Płatności i sposób poinformowania odrzuconego użytkownika pozostają w całości po stronie twojej usługi.
Jak mierzyć wyniki kanału?
Bluesky publikuje o kanale jedną liczbę: likeCount w jego generatorView. Wszystko inne o skuteczności kanału musisz rejestrować sam, na podstawie żądań trafiających do twojej usługi. To ten sam niedobór, który omawiamy w tekście czy Bluesky ma analitykę.
Co się stanie, gdy klient poprosi o więcej niż 100 elementów kanału?
AppView sam pilnuje tego pułapu. Wywołanie getFeed z limitem 101 zwraca błąd InvalidRequest z informacją, że liczba jest zbyt duża, a maksimum to 100. Minimum parametru limit to 1, maksimum 100, a wartość domyślna 50, więc generator kanałów nie musi sam obsługiwać takiego odrzucenia.
Dlaczego zestaw startowy zaleca did:plc zamiast did:web dla niektórych generatorów?
did:web to po prostu twoja nazwa hosta, więc zmiana domeny psuje każdy opublikowany rekord, który na nią wskazuje. did:plc przetrwa przeprowadzkę i dlatego zestaw startowy wskazuje go dla usług, które mają działać długo lub mogą zmienić domenę.
Jak powinien wyglądać kursor paginacji w generatorze kanałów?
Leksykon deklaruje kursor jako zwykły ciąg bez ograniczeń, a zestaw startowy nazywa jego wartość nieprzejrzystą i pozostawia ją w pełni generatorowi. Zaleca kursor złożony, czyli znacznik czasu w parze z CID, i podkreśla, że powinien być unikalny dla każdego elementu kanału, co pozwala uniknąć błędów paginacji.
Co robi acceptsInteractions w rekordzie generatora kanałów?
Ustawienie acceptsInteractions na true włącza dla kanału app.bsky.feed.sendInteractions, dzięki czemu klienci mogą zgłaszać, z którymi postami użytkownik wszedł w interakcję. Pole jest opcjonalne, ma typ logiczny i nic w dokumentacji nie wymaga go do działania kanału.
Wykorzystaj to w praktyce z AdaptlyPost
Czy ten artykuł był pomocny?
Chętnie poznamy opinię!
Więcej naszych treści w Google
Jedno kliknięcie oznacza AdaptlyPost jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.
Jeszcze chwila...
AdaptlyPost
Planowanie treści na wszystkich platformach
Wszystkie konta społecznościowe w jednym miejscu dzięki AdaptlyPost.
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Powiązane hasła ze słownika


Dlaczego byteStart i byteEnd w facetach Bluesky liczą bajty, a nie znaki
Przesunięcia byteStart i byteEnd w facetach Bluesky liczą bajty UTF-8, a nie indeksy UTF-16 z JavaScriptu. Ostrzeżenie z leksykonu, przykład i poprawny kod.


Jak opublikować GIF na Bluesky, żeby się nie zatrzymał
Jak GIF trafia do posta na Bluesky: wyszukiwarka KLIPY, przesłane pliki zamieniane w wideo, osadzone obrazy z jedną klatką i to, co wysyła AdaptlyPost.


Jak threadgate na Bluesky decyduje, kto może odpowiedzieć na post
Threadgate na Bluesky ogranicza odpowiedzi do wspomnianych osób, obserwujących, obserwowanych lub listy. Jak działa ten rekord i postgate blokujący cytaty.
Powiązane artykuły


Pięć liczników zaangażowania: czy Bluesky ma analitykę?
Czy Bluesky ma analitykę? Nie. Lexicon daje postView pięć liczników zaangażowania, bez liczby wyświetleń, impresji i endpointu analitycznego.


Limity rozmiaru wideo na Bluesky: 300 MB, MP4 i 1920 pikseli
Limit rozmiaru wideo na Bluesky to 300 MB na plik MP4. Aplikacja skaluje wideo do 1920 pikseli na dłuższym boku przy 3 Mbps, a proporcje nie są narzucone.


Dlaczego dzienny limit postów na Instagramie to w dokumentacji Mety 100 i 50
Instagram nie podaje dziennego limitu postów dla aplikacji. Dokumentacja API Mety mówi raz o 100 postach na 24 godziny, a dwa razy o 50. Sprawdź, co obowiązuje.

