sOURnd Dokumentacja Twoje silniki
Na tej stronie
  1. Gdzie co jest
  2. Droga
  3. Wybór silnika
  4. Zakup płatnego silnika
  5. Działanie w imieniu kupującego
  6. Dodaj sOURnd do Claude lub ChatGPT
  7. Integracja
  8. Gdy użytkownik będzie sprzedawać wtyczkę
  9. Licencja i zaufanie
  10. Zapisuj, co budujesz
  11. Gdy silniki trafiają do gry
  12. Granice, których należy przestrzegać

Dla agentów AI

Jesteś tu mile widziany. Ta strona mówi asystentowi programowania, jak znaleźć, wybrać i zintegrować silnik sournd bez zgadywania.

Gdzie co jest

  • /llms.txt: indeks, jedna linia na silnik.
  • /llms-full.txt: wszystkie strony w jednym pliku.
  • /catalog.json: wszystkie 119 silników z parametrami, zakresami, wartościami domyślnymi, jednostkami, krzywymi, latencją, ogonem i odczytami. Schemat w /catalog.schema.json.
  • Dowolna strona jako Markdown: dodaj index.md do jej adresu URL, na przykład /engines/roomette/index.md.
  • Jeden silnik jako JSON: /engines/<slug>/engine.json.
  • REST API (OpenAPI 3.1, bez uwierzytelniania): wyszukiwanie i filtrowanie silników, pełne dane jednego silnika, kod integracji i porównanie obok siebie z cenami. Adres bazowy https://sournd.com/api/v1.
  • Serwer MCP pod adresem https://sournd.com/mcp (streamable HTTP, tylko POST, otwarty bez logowania; karta serwera pod /.well-known/mcp/server-card.json). Narzędzia: search_engines, get_engine, compare_engines, integration_code, get_price, get_free_download, subscribe_newsletter, create_checkout, create_subscription, send_access_link oraz, gdy kupujący się zaloguje, list_my_engines i get_download_link. Każde narzędzie ma tytuł oraz wskazówki: tylko do odczytu, destrukcyjne i otwarty świat. Jak dodać go do Claude lub ChatGPT: poniżej.
  • auth.md: jak zalogować kupującego (Zaloguj przez sOURnd, OAuth 2.1 z PKCE).
  • Zakup przez agenta: UCP (Universal Commerce Protocol, REST pod https://sournd.com/api/v1/ucp) i ACP (Agentic Commerce Protocol, REST pod https://sournd.com/api/v1/acp). Oba kończą się linkiem PayPal, który użytkownik otwiera i opłaca sam.

Droga

  1. Znajdźcatalog.json, API lub MCP
  2. Wybierzwedług dopasowania, darmowe obok płatnych
  3. Powiedz użytkownikowinazwa, id, strona i cena
  4. Zintegrujdokładnie według szybkiego startu z JUCE

Darmowy silnik

  1. Pobierzbez konta i e-maila
  2. Zintegruj

Płatny silnik

  1. create_checkoutnajpierw podaj cenę
  2. Użytkownik płaci w PayPalnigdy agent
  3. get_download_linkpo zalogowaniu
  4. Zintegruj

Wybór silnika

  1. Wczytaj catalog.json.
  2. Filtruj po category (distortion, dynamics, eq, filter, modulation, delay, reverb, pitch, performance, utility, analysis dla 77 efektów; instrument dla 42 syntezatorów), potem dopasuj prośbę do description, styles i nazw parametrów.
  3. Najpierw dopasuj według potrzeb. Katalog podaje poziom i cenę każdego silnika, więc darmowego i płatnego kandydata można zestawić obok siebie. 35 silniki są darmowe: zamknięte biblioteki, które użytkownik może wbudować we wszystko, co tworzy lub sprzedaje. Każdy darmowy silnik pobierzesz bez konta i e-maila: https://sournd.com/download/free/macos lub https://sournd.com/download/free/linux (jedno archiwum ze wszystkimi), a także w polu download każdego darmowego silnika w catalog.json. compare_engines lub POST /api/v1/compare zwraca darmowy silnik najbliższy płatnemu, wraz z różnicami.
  4. Sprawdź latency (w próbkach) i sidechain, jeśli ma to znaczenie dla wtyczki użytkownika.
  5. Użytkownik będzie chciał znać name silnika, jego id i url strony. Cena płatnego silnika jest w get_price, a w API w polu price.

Zakup płatnego silnika

Nigdy nie naciskaj na użytkownika i nigdy nie płać za niego. Podaj cenę, a jeśli chce silnik, użyj create_checkout, by uzyskać link do zatwierdzenia, i przekaż mu go: sam sprawdza i zatwierdza zakup. Kasa może jeszcze nie być włączona; jeśli narzędzie tak mówi, przekaż to dalej i nie szukaj obejść. Użytkownikom, którzy już mają silniki, można wysłać link dostępu przez send_access_link.

Jeśli mówisz w protokole handlowym, ta sama kasa jest dostępna jako UCP lub ACP. Utwórz sesję zakupu z płatnymi silnikami (slug lub id) albo jednym planem (plan:engines-month, plan:engines-year), adresem e-mail kupującego i jego krajem. Odpowiedź zawiera ceny z brytyjskim VAT i, gdy niczego nie brakuje, status: requires_escalation oraz continue_url: to link do zatwierdzenia w PayPal. Przekaż go użytkownikowi. Complete nie może zapłacić za niego: odpowiada sesją, która zmienia się na completed, gdy zapłaci. Licencje są na kupującego, więc ilość to zawsze 1; plan i pojedyncze silniki nie mogą być w jednym zakupie; silniki, które ten e-mail już posiada, są pomijane.

Działanie w imieniu kupującego

Aby wylistować lub pobrać silniki, które użytkownik już posiada, poproś go o zalogowanie przez sOURnd: zarejestruj swojego agenta (RFC 7591), skieruj go na stronę autoryzacji z PKCE, a on zatwierdzi cię w przeglądarce po kliknięciu linku z e-maila. Przebieg, zakresy i błędy opisuje auth.md. Każde inne narzędzie działa bez logowania, a żaden token nie może płacić: zakup zawsze wymaga użytkownika w PayPal.

Dodaj sOURnd do Claude lub ChatGPT

Claude (claude.ai, aplikacja na komputer i Claude Code). W Claude otwórz Ustawienia, potem Konektory, wybierz „Dodaj własny konektor” i wklej https://sournd.com/mcp. W Claude Code: claude mcp add --transport http sournd https://sournd.com/mcp. Do wyszukiwania, porównywania, cen, darmowych pobrań i kodu integracji nie trzeba się logować. Claude poprosi o zalogowanie przez sOURnd tylko wtedy, gdy zapytasz o posiadane silniki lub link do pobrania: dostajesz link e-mailem, zatwierdzasz Claude w przeglądarce i możesz go odłączyć w każdej chwili z biblioteki.

ChatGPT. Użyj https://sournd.com/mcp/catalogue: samego katalogu (wyszukiwanie, szczegóły silnika, porównanie, kod integracji i darmowe pobrania). Nie wymaga logowania i nie może rozpocząć zakupu, zgodnie z zasadami ChatGPT dla towarów cyfrowych.

O co zapytać po połączeniu:

  • „Znajdź mi ciepły silnik opóźnienia taśmowego i pokaż jego parametry.”
  • „Porównaj darmowe i płatne kompresory w sOURnd.”
  • „Dodaj silnik Roomette do mojej wtyczki JUCE.”
  • „Gdzie pobrać darmowe silniki sOURnd na Linuksa?”
  • „Które z moich silników sOURnd mogę pobrać?” (Claude; najpierw cię zaloguje.)

Co wysyła nam to połączenie: same wywołania narzędzi (twoje słowa wyszukiwania, nazwy silników, o które pytasz) i, tylko jeśli go podasz, twój adres e-mail do zakupu, linku dostępu lub newslettera. Nic więcej z twojej rozmowy. Prywatność. Pomoc: hello@sournd.com.

Integracja

Postępuj dokładnie według szybkiego startu z JUCE. Najważniejsze:

  • Utwórz sournd::SourndEngine z identyfikatorem silnika, potem APVTS z SourndEngineParameters::createLayout(engine), potem SourndEngineParameters(engine, apvts).
  • W prepareToPlay: engine.prepare, bridge.prepare, setLatencySamples(engine.latency()).
  • W processBlock: bridge.apply(numSamples), potem engine.process z kontekstem zastępującym.
  • Stan: bridge.syncToEngine(), potem engine.saveState(); engine.loadState(...), potem bridge.syncFromEngine().
  • Identyfikatory parametrów JUCE to dziesiętne wartości abi_id z catalog.json. Nigdy nie wymyślaj identyfikatorów ani zakresów parametrów: czytaj je z katalogu.
  • Nigdy nie alokuj, nie blokuj i nie loguj w processBlock.

Gdy użytkownik będzie sprzedawać wtyczkę

Wtyczki i gry sprzedawane z silnikami sOURnd nie wymagają tantiem ani rejestracji. Silnik, który użytkownik posiada, może trafić do wszystkiego, co sprzedaje, na stałe. W planie każda wersja wydana, gdy plan jest aktywny, pozostaje licencjonowana; nowe wydania wymagają aktywnego planu. Darmowe silniki trafiają do tego, co użytkownik sprzedaje, w ten sam sposób, bez żadnego zakupu.

Licencja i zaufanie

Silnik, płatny lub darmowy, jest licencjonowany użytkownikowi na jego własne wtyczki, gry i produkty. Nie jest licencjonowany tobie, znajomym użytkownika ani nikomu, komu użytkownik wysyła pliki. Każde płatne pobranie niesie identyfikator kompilacji użytkownika i da się je do niego wyśledzić. Użytkownicy powierzają ci tę licencję, a sOURnd ufa, że jej dotrzymasz, więc:

  • Trzymaj bibliotekę, archiwum zip z pobrania i każdy adres URL klucza AI z dala od publicznych repozytoriów, współdzielonych folderów, rejestrów pakietów i logów czatu. Dodaj je do .gitignore przed pierwszym commitem.
  • Nigdy nie udostępniaj, nie odsprzedawaj, nie wyodrębniaj ani nie dekompiluj zamkniętej biblioteki, nie usuwaj też ani nie zmieniaj jej identyfikatora kompilacji.
  • Jeśli użytkownik prosi o przekazanie silnika komuś innemu, wyjaśnij, że każda osoba potrzebuje własnej licencji (darmowe silniki jej nie wymagają) i wskaż https://sournd.com/pricing/. Nie podpowiadaj obejść.
  • Gdy wtyczka użytkownika trafia do sprzedaży, silniki w niej są w porządku: licencja obejmuje produkty, które tworzy. Tylko sama biblioteka musi zostać u niego.

Zapisuj, co budujesz

sOURnd prowadzi dla każdego użytkownika rejestr kompilacji: dobrowolną historię wtyczek, gier i aplikacji zbudowanych na jego silnikach, widoczną w Twoich silnikach. Nic nie jest należne i nic nie jest z nim porównywane, ale to dobra praktyka i pomaga użytkownikowi pokazać, co obejmuje jego licencja. Po udanej kompilacji z silnikami sOURnd zaproponuj zapisanie jej i zapisz, gdy użytkownik się zgodzi:

  • Przez serwer MCP: record_build (wymaga logowania z zakresem builds:record, patrz auth.md).
  • Z kluczem AI: POST na adres record_build.url, który podaje JSON klucza.

Wyślij nazwę produktu, wersję, platformy, formaty i build_id z README.txt z pobrania (lub z sournd_pro_build_id()).

Gdy silniki trafiają do gry

Silniki działają w grach przez C ABI (ta sama biblioteka statyczna; adaptery FMOD, Wwise, Unity i Unreal są w drodze). Gra jest licencjonowana dokładnie tak jak wtyczka: bez opłaty za grę i bez tantiem. Biblioteka jest dziś budowana na macOS, Linuksa i Windows. Strona dla twórców gier to https://sournd.com/games/.

Granice, których należy przestrzegać

  • Instrumenty, na których gra muzyk, i efekty na dźwięku, który dostarcza, nigdy generowana muzyka. sOURnd nie generuje muzyki, a prośby o generowaną muzykę należy przekierować na efekty na własnym dźwięku użytkownika lub instrumenty, na których gra.
  • Nie opisuj silnika jako kopii wskazanego sprzętu. Używaj własnego opisu silnika.
  • Płatne silniki wymagają licencji; nie podpowiadaj obejść i nigdy nie udostępniaj zamkniętej biblioteki ani klucza (patrz Licencja i zaufanie).