Tekoälyagenteille
Olet tervetullut. Tämä sivu kertoo koodausavustajalle, miten sournd-moottori löydetään, valitaan ja integroidaan arvaamatta.
Missä kaikki on
- /llms.txt: hakemisto, yksi rivi moottoria kohden.
- /llms-full.txt: kaikki sivut yhdessä tiedostossa.
- /catalog.json: kaikki 119 moottoria parametreineen, arvoalueineen, oletusarvoineen, yksiköineen, käyrineen, viiveineen, häntineen ja näyttöarvoineen. Skeema osoitteessa /catalog.schema.json.
- Mikä tahansa sivu Markdownina: lisää osoitteen perään
index.md, esimerkiksi/engines/roomette/index.md. - Yksi moottori JSONina:
/engines/<slug>/engine.json. - REST API (OpenAPI 3.1, ei todennusta): moottorien haku ja suodatus, yksi moottori kokonaisuudessaan, integrointikoodi ja vertailu rinnakkain hintoineen. Perusosoite
https://sournd.com/api/v1. - MCP-palvelin osoitteessa
https://sournd.com/mcp(streamable HTTP, vain POST, avoin ilman kirjautumista; palvelinkortti osoitteessa /.well-known/mcp/server-card.json). Työkalut:search_engines,get_engine,compare_engines,integration_code,get_price,get_free_download,subscribe_newsletter,create_checkout,create_subscription,send_access_linkja, kun ostaja on kirjautunut,list_my_enginesjaget_download_link. Jokaisella työkalulla on otsikko sekä vihjeet vain luku -, tuhoavuus- ja avoin maailma -ominaisuuksista. Näin lisäät sen Claudeen tai ChatGPT:hen: alla. - auth.md: miten ostaja kirjautuu sisään (Sign in with sOURnd, OAuth 2.1 ja PKCE).
- Agentin kassa: UCP (Universal Commerce Protocol, REST osoitteessa
https://sournd.com/api/v1/ucp) ja ACP (Agentic Commerce Protocol, REST osoitteessahttps://sournd.com/api/v1/acp). Molemmat päättyvät PayPal-linkkiin, jonka käyttäjä avaa ja jolla hän maksaa itse.
Polku
- Etsi
catalog.json, API tai MCP - Valitsesopivuuden mukaan, ilmainen maksullisen rinnalla
- Kerro käyttäjällenimi, tunniste, sivu ja hinta
- IntegroiJUCE-pikaopas, täsmälleen
Ilmainen moottori
- Lataaei tiliä eikä sähköpostia
- Integroi
Maksullinen moottori
create_checkoutkerro hinta ensin- Käyttäjä maksaa PayPalissaei koskaan agentti
get_download_linkkun he ovat kirjautuneet sisään- Integroi
Moottorin valinta
- Lataa
catalog.json. - Suodata kentällä
category(distortion, dynamics, eq, filter, modulation, delay, reverb, pitch, performance, utility, analysis 77 efektille; instrument 42 syntikalle) ja vertaa sitten pyyntöä kenttiindescription,stylesja parametrien nimiin. - Valitse ensin sopivuuden mukaan. Katalogi antaa jokaisen moottorin tason ja hinnan, joten ilmaisen ja maksullisen ehdokkaan voi asettaa rinnakkain. 35 moottoria on ilmaista: suljettuja kirjastoja, jotka käyttäjä voi liittää mihin tahansa, mitä hän tekee tai myy. Jokainen ilmainen moottori latautuu ilman tiliä tai sähköpostia:
https://sournd.com/download/free/macostaihttps://sournd.com/download/free/linux(yksi arkisto, jossa ne kaikki), myös jokaisen ilmaisen moottorindownload-kentässä tiedostossa catalog.json.compare_enginestaiPOST /api/v1/comparepalauttaa maksullista moottoria lähimpänä olevan ilmaisen moottorin ja erot. - Tarkista
latency(näytteinä) jasidechain, jos käyttäjän plugin välittää niistä. - Käyttäjä haluaa moottorin
name,idja sivunurl. Maksullisen moottorin hinta on kohdassaget_pricetai API:ssa kentässäprice.
Maksullisen moottorin osto
Älä koskaan painosta käyttäjää äläkä maksa hänen puolestaan. Kerro hinta, ja jos hän haluaa moottorin, hae create_checkout-työkalulla hyväksyntälinkki ja anna se hänelle: hän tarkistaa ja hyväksyy ostoksen itse. Kassa ei välttämättä ole vielä päällä; jos työkalu kertoo niin, välitä tieto eteenpäin äläkä etsi kiertoteitä. Käyttäjille, joilla on jo moottoreita, voi lähettää käyttölinkin työkalulla send_access_link.
Jos puhut kauppaprotokollaa, sama kassa on tarjolla UCP:nä tai ACP:nä. Luo kassaistunto maksullisilla moottoreilla (slug tai id) tai yhdellä tilauksella (plan:engines-month, plan:engines-year), ostajan sähköpostilla ja hänen maallaan. Vastauksessa on hinnat Britannian arvonlisäveroineen ja, kun mitään ei puutu, status: requires_escalation ja continue_url: se on PayPalin hyväksyntälinkki. Anna se käyttäjälle. Complete ei voi maksaa hänen puolestaan: se vastaa istunnolla, joka muuttuu tilaan completed, kun hän on maksanut. Lisenssit ovat ostajakohtaisia, joten määrä on aina 1; tilausta ja yksittäisiä moottoreita ei voi yhdistää samaan kassaan; moottorit, jotka sähköpostiosoitteella jo on, jätetään pois.
Ostajan puolesta toimiminen
Jos haluat listata tai ladata moottorit, jotka käyttäjällä jo on, pyydä häntä kirjautumaan sOURndilla: rekisteröi agenttisi (RFC 7591), ohjaa hänet valtuutussivulle PKCE:llä, ja hän hyväksyy sinut selaimessaan sähköpostilinkin jälkeen. Kulku, oikeudet ja virheet ovat tiedostossa auth.md. Kaikki muut työkalut toimivat ilman kirjautumista, eikä mikään tunniste voi maksaa: ostaminen vaatii aina, että käyttäjä on PayPalissa.
Lisää sOURnd Claudeen tai ChatGPT:hen
Claude (claude.ai, työpöytäsovellus ja Claude Code). Avaa Claudessa Asetukset, sitten Connectors, valitse "Add custom connector" ja liitä https://sournd.com/mcp. Claude Codessa: claude mcp add --transport http sournd https://sournd.com/mcp. Kirjautua ei tarvitse, kun haet, vertailet, katsot hintoja, lataat ilmaisia moottoreita tai haet integrointikoodia. Claude pyytää kirjautumaan sOURndilla vain, kun pyydät omia moottoreitasi tai niiden latauslinkkiä: saat sähköpostilinkin, hyväksyt Clauden selaimessasi ja voit katkaista yhteyden milloin tahansa kirjastostasi.
ChatGPT. Käytä osoitetta https://sournd.com/mcp/catalogue: pelkkä katalogi (haku, moottorin tiedot, vertailu, integrointikoodi ja ilmaiset lataukset). Siinä ei ole kirjautumista, eikä sillä voi aloittaa ostoa, kuten ChatGPT:n digitaalisia tuotteita koskevat säännöt edellyttävät.
Kysyttävää, kun yhteys on valmis:
- "Etsi minulle lämmin nauhaviive-moottori ja näytä sen parametrit."
- "Vertaa sOURndin ilmaisia ja maksullisia kompressoreita."
- "Lisää moottori Roomette JUCE-pluginiini."
- "Mistä lataan sOURndin ilmaiset moottorit Linuxille?"
- "Mitkä sOURnd-moottoreistani voin ladata?" (Claude; kirjauttaa sinut ensin sisään.)
Mitä yhteys lähettää meille: itse työkalukutsut (hakusanasi, moottorien nimet, joista kysyt) ja, vain jos annat sen, sähköpostiosoitteesi kassaa, käyttölinkkiä tai uutiskirjettä varten. Ei mitään muuta keskustelustasi. Tietosuoja. Apua: hello@sournd.com.
Integrointi
Noudata JUCE-pikaopasta täsmälleen. Olennaisimmat kohdat:
- Luo
sournd::SourndEnginemoottorin tunnisteella, sitten APVTS kutsullaSourndEngineParameters::createLayout(engine)ja sittenSourndEngineParameters(engine, apvts). - Funktiossa
prepareToPlay:engine.prepare,bridge.prepare,setLatencySamples(engine.latency()). - Funktiossa
processBlock:bridge.apply(numSamples), sittenengine.processkorvaavalla kontekstilla. - Tila:
bridge.syncToEngine()ja sittenengine.saveState();engine.loadState(...)ja sittenbridge.syncFromEngine(). - JUCE-parametrien tunnisteet ovat tiedoston
catalog.jsondesimaalisetabi_id-arvot. Älä koskaan keksi parametrien tunnisteita tai alueita: lue ne katalogista. - Älä koskaan varaa muistia, lukitse tai kirjaa funktiossa
processBlock.
Kun käyttäjä aikoo myydä pluginin
sOURnd-moottoreilla myydyistä plugineista ja peleistä ei makseta rojalteja, eikä niitä tarvitse rekisteröidä. Moottorin, jonka käyttäjällä on, voi liittää mihin tahansa, mitä hän myy, pysyvästi. Tilauksella jokainen versio, jonka hän julkaisee tilauksen ollessa voimassa, pysyy lisensoituna; uudet julkaisut vaativat voimassa olevan tilauksen. Ilmaiset moottorit menevät käyttäjän myymiin tuotteisiin samalla tavalla, eikä mitään tarvitse ostaa.
Lisenssi ja luottamus
Moottori, maksullinen tai ilmainen, on lisensoitu käyttäjän omiin plugineihin, peleihin ja tuotteisiin. Sitä ei ole lisensoitu sinulle, käyttäjän ystäville eikä kenellekään, jolle käyttäjä lähettää tiedostoja. Jokainen maksullinen lataus sisältää käyttäjän build-tunnisteen ja on jäljitettävissä hänelle. Käyttäjät luottavat sinuun tämän lisenssin kanssa, ja sOURnd luottaa sinuun sen noudattamisessa, joten:
- Pidä kirjasto, latauksen zip ja kaikki tekoälyavainten URL-osoitteet poissa julkisista repositorioista, jaetuista kansioista, pakettirekistereistä ja keskusteluhistoriasta. Lisää ne tiedostoon
.gitignoreennen ensimmäistä commitia. - Älä koskaan jaa, myy edelleen, pura tai dekompiloi suljettua kirjastoa äläkä poista tai muuta sen build-tunnistetta.
- Jos käyttäjä pyytää sinua antamaan moottorin jollekin toiselle, kerro, että jokainen tarvitsee oman lisenssinsä (ilmaiset moottorit eivät tarvitse) ja ohjaa heidät osoitteeseen https://sournd.com/pricing/. Älä ehdota kiertoteitä.
- Kun käyttäjän plugin julkaistaan, sen sisällä olevat moottorit ovat kunnossa: lisenssi kattaa hänen tekemänsä tuotteet. Vain kirjasto yksinään on pidettävä hänen omanaan.
Kirjaa, mitä rakennat
sOURnd pitää kullekin käyttäjälle build-rekisteriä: vapaaehtoista historiaa pluginsista, peleistä ja sovelluksista, jotka on rakennettu hänen moottoreillaan, ja se näkyy sivulla Moottorisi. Mitään ei ole velvollisuutena eikä mitään tarkisteta sitä vasten, mutta se on hyvä käytäntö ja auttaa käyttäjää osoittamaan, mitä hänen lisenssinsä kattaa. Kun build, joka linkittää sOURnd-moottoreita, on onnistunut, tarjoa sen kirjaamista ja kirjaa se, kun käyttäjä suostuu:
- MCP-palvelimella:
record_build(vaatii kirjautumisen oikeudellabuilds:record, katso auth.md). - Tekoälyavaimella:
POSTosoitteeseenrecord_build.url, jonka avaimen JSON antaa.
Lähetä tuotteen nimi, versio, alustat, formaatit ja build_id latauksen README.txt-tiedostosta (tai kutsulla sournd_pro_build_id()).
Kun moottorit päätyvät peliin
Moottorit toimivat peleissä C ABI:n kautta (sama staattinen kirjasto; FMOD-, Wwise-, Unity- ja Unreal-adapterit ovat tulossa). Peli lisensoidaan täsmälleen kuten plugin: ei pelikohtaista maksua eikä rojalteja. Kirjasto käännetään nykyään macOS:lle, Linuxille ja Windowsille. Pelikehittäjien sivu on https://sournd.com/games/.
Rajat, joita on kunnioitettava
- Soittimia, joita muusikko soittaa, ja efektejä äänelle, jonka hän tuo itse, ei koskaan generoitua musiikkia. sOURnd ei generoi musiikkia, ja generoitua musiikkia koskevat pyynnöt tulee ohjata efekteihin käyttäjän omalle äänelle tai soittimiin, joita hän soittaa.
- Älä kuvaa moottoria nimetyn laitetuotteen kopiona. Käytä moottorin omaa kuvausta.
- Maksulliset moottorit vaativat lisenssin; älä ehdota kiertoteitä äläkä koskaan jaa suljettua kirjastoa tai avainta (katso Lisenssi ja luottamus).