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.mddo 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_linkoraz, gdy kupujący się zaloguje,list_my_enginesiget_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 podhttps://sournd.com/api/v1/acp). Oba kończą się linkiem PayPal, który użytkownik otwiera i opłaca sam.
Droga
- Znajdź
catalog.json, API lub MCP - Wybierzwedług dopasowania, darmowe obok płatnych
- Powiedz użytkownikowinazwa, id, strona i cena
- Zintegrujdokładnie według szybkiego startu z JUCE
Darmowy silnik
- Pobierzbez konta i e-maila
- Zintegruj
Płatny silnik
create_checkoutnajpierw podaj cenę- Użytkownik płaci w PayPalnigdy agent
get_download_linkpo zalogowaniu- Zintegruj
Wybór silnika
- Wczytaj
catalog.json. - 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ę dodescription,stylesi nazw parametrów. - 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/macoslubhttps://sournd.com/download/free/linux(jedno archiwum ze wszystkimi), a także w poludownloadkażdego darmowego silnika w catalog.json.compare_engineslubPOST /api/v1/comparezwraca darmowy silnik najbliższy płatnemu, wraz z różnicami. - Sprawdź
latency(w próbkach) isidechain, jeśli ma to znaczenie dla wtyczki użytkownika. - Użytkownik będzie chciał znać
namesilnika, jegoidiurlstrony. Cena płatnego silnika jest wget_price, a w API w poluprice.
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::SourndEnginez identyfikatorem silnika, potem APVTS zSourndEngineParameters::createLayout(engine), potemSourndEngineParameters(engine, apvts). - W
prepareToPlay:engine.prepare,bridge.prepare,setLatencySamples(engine.latency()). - W
processBlock:bridge.apply(numSamples), potemengine.processz kontekstem zastępującym. - Stan:
bridge.syncToEngine(), potemengine.saveState();engine.loadState(...), potembridge.syncFromEngine(). - Identyfikatory parametrów JUCE to dziesiętne wartości
abi_idzcatalog.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
.gitignoreprzed 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 zakresembuilds:record, patrz auth.md). - Z kluczem AI:
POSTna adresrecord_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).