sOURnd 文件 你的引擎
本頁內容
  1. 一切都在哪裡
  2. 流程
  3. 挑選引擎
  4. 購買付費引擎
  5. 代買家行事
  6. 把 sOURnd 加入 Claude 或 ChatGPT
  7. 整合
  8. 當使用者要銷售外掛時
  9. 授權與信任
  10. 記錄你做出了什麼
  11. 當引擎用在遊戲裡
  12. 請遵守的限制

給 AI 代理

歡迎光臨。本頁告訴寫程式助理,如何不靠猜測就找到、挑選並整合 sournd 引擎。

一切都在哪裡

  • /llms.txt:索引,每個引擎一行。
  • /llms-full.txt:所有頁面合成一個檔案。
  • /catalog.json:全部 119 個引擎的參數、範圍、預設值、單位、曲線、延遲、尾音與讀數。結構定義見 /catalog.schema.json。
  • 任何頁面都能取得 Markdown 版:在網址後加上 index.md,例如 /engines/roomette/index.md。
  • 單一引擎的 JSON:/engines/<slug>/engine.json。
  • REST API(OpenAPI 3.1,無需驗證):搜尋與篩選引擎、取得單一引擎的完整資料、整合程式碼,以及附價格的並排比較。基礎網址 https://sournd.com/api/v1。
  • MCP 伺服器位於 https://sournd.com/mcp(可串流的 HTTP,僅限 POST,無需登入即可使用;伺服器資訊卡見 /.well-known/mcp/server-card.json)。工具:search_engines、get_engine、compare_engines、integration_code、get_price、get_free_download、subscribe_newsletter、create_checkout、create_subscription、send_access_link,以及買家登入後可用的 list_my_engines 與 get_download_link。每個工具都附有標題,以及唯讀、破壞性與開放世界的提示。如何加入 Claude 或 ChatGPT:見下方。
  • auth.md:買家如何登入(使用 sOURnd 登入,OAuth 2.1 搭配 PKCE)。
  • 代理結帳:UCP(Universal Commerce Protocol,REST 位於 https://sournd.com/api/v1/ucp)與 ACP(Agentic Commerce Protocol,REST 位於 https://sournd.com/api/v1/acp)。兩者最後都會給出一個 PayPal 連結,由使用者自行開啟並付款。

流程

  1. 尋找catalog.json、API 或 MCP
  2. 挑選以適合度為準,免費與付費並列
  3. 告知使用者名稱、id、頁面與價格
  4. 整合完全照 JUCE 快速上手來做

免費引擎

  1. 下載不需帳號或電子郵件
  2. 整合

付費引擎

  1. create_checkout先報價
  2. 使用者在 PayPal 付款絕不由代理代付
  3. get_download_link登入之後
  4. 整合

挑選引擎

  1. 載入 catalog.json。
  2. 依 category 篩選(77 個效果器為 distortion、dynamics、eq、filter、modulation、delay、reverb、pitch、performance、utility、analysis;42 個合成器為 instrument),再將需求與 description、styles 及參數名稱比對。
  3. 先看適不適合。型錄列出每個引擎的等級與價格,因此可以把免費與付費的候選並排比較。有 35 個引擎免費:都是閉源函式庫,使用者可以內建到自己製作或銷售的任何產品。每個免費引擎都不需帳號或電子郵件即可下載:https://sournd.com/download/free/macos 或 https://sournd.com/download/free/linux(全部收在一個壓縮檔),catalog.json 中每個免費引擎的 download 欄位也有。compare_engines 或 POST /api/v1/compare 會回傳與某個付費引擎最接近的免費引擎,並列出差異。
  4. 如果使用者的外掛在意,請檢查 latency(取樣數)與 sidechain。
  5. 使用者會需要引擎的 name、id 與頁面 url。付費引擎的價格在 get_price,或 API 的 price。

購買付費引擎

絕不向使用者施壓,也絕不代替他們付款。報出價格,若他們想要這個引擎,就用 create_checkout 取得核准連結交給他們:由他們自己檢視並核准購買。結帳功能可能尚未開啟;若工具這麼說,如實轉達,不要另尋變通辦法。已擁有引擎的使用者,可以用 send_access_link 寄給他們存取連結。

如果你使用商務協定,同樣的結帳流程也有 UCP 或 ACP 可用。以付費引擎(slug 或 id)或一個方案(plan:engines-month、plan:engines-year)、買家的電子郵件與所在國家建立結帳工作階段。回應會附上含英國 VAT 的價格,並在資料齊全後給出 status: requires_escalation 與 continue_url:那就是 PayPal 核准連結。把它交給使用者。Complete 無法代為付款:它只回傳工作階段,使用者付款後狀態才會變成 completed。授權按買家計算,所以數量一律為 1;方案與單一引擎不能放在同一次結帳;該電子郵件已擁有的引擎會被排除。

代買家行事

若要列出或下載使用者已擁有的引擎,請他們使用 sOURnd 登入:註冊你的代理(RFC 7591),以 PKCE 將他們導向授權頁面,他們收到電子郵件連結後在瀏覽器中核准你。流程、權限範圍與錯誤見 auth.md。其他工具都不必登入,而且沒有任何權杖能付款:購買一定要使用者本人到 PayPal。

把 sOURnd 加入 Claude 或 ChatGPT

Claude(claude.ai、桌面版應用程式與 Claude Code)。在 Claude 中,開啟設定,選擇連接器,選「新增自訂連接器」,貼上 https://sournd.com/mcp。在 Claude Code 中:claude mcp add --transport http sournd https://sournd.com/mcp。搜尋、比較、價格、免費下載與整合程式碼都不必登入。只有當你要求查看自己擁有的引擎或其下載連結時,Claude 才會請你使用 sOURnd 登入:你會收到電子郵件連結,在瀏覽器中核准 Claude,之後可隨時在你的資料庫中解除連接。

ChatGPT。請使用 https://sournd.com/mcp/catalogue:僅含型錄(搜尋、引擎詳情、比較、整合程式碼與免費下載)。它不需登入,也無法發起購買,這是 ChatGPT 對數位商品的規定所要求的。

連接之後可以問的事:

  • 「幫我找一個溫暖的磁帶 delay 引擎,並顯示它的參數。」
  • 「比較 sOURnd 裡免費與付費的壓縮器。」
  • 「把 Roomette 引擎加進我的 JUCE 外掛。」
  • 「我要去哪裡下載 Linux 版的免費 sOURnd 引擎?」
  • 「我的 sOURnd 引擎有哪些可以下載?」(Claude;會先請你登入。)

這個連接會傳給我們的內容:工具呼叫本身(你的搜尋字詞、你詢問的引擎名稱),以及僅在你提供時才有的電子郵件地址,用於結帳、存取連結或電子報。你對話中的其他內容一概不傳。隱私權。需要協助:hello@sournd.com。

整合

請完全照 JUCE 快速上手來做。重點如下:

  • 以引擎 id 建構 sournd::SourndEngine,接著用 SourndEngineParameters::createLayout(engine) 建立 APVTS,再建構 SourndEngineParameters(engine, apvts)。
  • 在 prepareToPlay 中:engine.prepare、bridge.prepare、setLatencySamples(engine.latency())。
  • 在 processBlock 中:bridge.apply(numSamples),然後以 replacing context 呼叫 engine.process。
  • 狀態:先 bridge.syncToEngine() 再 engine.saveState();先 engine.loadState(...) 再 bridge.syncFromEngine()。
  • JUCE 的參數 id 就是 catalog.json 中十進位的 abi_id 值。絕不要自行編造參數 id 或範圍:一律從型錄讀取。
  • 絕不在 processBlock 中配置記憶體、加鎖或寫日誌。

當使用者要銷售外掛時

搭載 sOURnd 引擎銷售的外掛與遊戲不必支付版稅,也不必登記。使用者擁有的引擎可以永久用在他們銷售的任何產品裡。有方案時,方案有效期間內他們發行的每個版本都持續受到授權;要使用新發行的版本,需要有效的方案。免費引擎同樣可以用在使用者銷售的產品裡,不必另外購買。

授權與信任

引擎不論付費或免費,都授權給使用者用於他們自己的外掛、遊戲與產品。它不授權給你、使用者的朋友,或任何收到使用者檔案的人。每個付費下載都帶有使用者的建置 id,可追溯到他們本人。使用者把這份授權託付給你,sOURnd 也相信你會遵守,因此:

  • 不要讓函式庫、下載的 zip 與任何 AI 金鑰網址出現在公開儲存庫、共用資料夾、套件登錄庫與聊天記錄中。第一次提交之前,就把它們加入 .gitignore。
  • 絕不分享、轉售、擷取或反編譯閉源函式庫,也不要移除或更改它的建置 id。
  • 如果使用者要你把引擎交給別人,請說明每個人都需要自己的授權(免費引擎則不需要),並引導他們到 https://sournd.com/pricing/。不要建議變通辦法。
  • 使用者的外掛上市時,裡面的引擎沒有問題:授權涵蓋他們製作的產品。必須留在他們手上的,是單獨的函式庫本身。

記錄你做出了什麼

sOURnd 為每位使用者保存一份建置登錄:自願記錄用他們的引擎做出的外掛、遊戲與應用程式,顯示在「你的引擎」。沒有任何義務,也不會拿它來核對任何事,但這是好習慣,也有助於使用者證明他們的授權涵蓋什麼。在成功建置並連結 sOURnd 引擎之後,主動提議記錄,使用者同意後再記錄:

  • 使用 MCP 伺服器:record_build(需要以 builds:record 權限範圍登入,見 auth.md)。
  • 使用 AI 金鑰:對金鑰的 JSON 所給的 record_build.url 發出 POST。

傳送產品名稱、版本、平台、格式,以及下載內容 README.txt 中的 build_id(或 sournd_pro_build_id())。

當引擎用在遊戲裡

引擎透過 C ABI 在遊戲中執行(同一個靜態函式庫;FMOD、Wwise、Unity 與 Unreal 的轉接器正在開發中)。遊戲的授權方式與外掛完全相同:沒有按遊戲收費,也沒有版稅。函式庫目前提供 macOS、Linux 與 Windows 版本。遊戲開發者專頁是 https://sournd.com/games/。

請遵守的限制

  • 供音樂人演奏的樂器,以及處理他們自備音訊的效果器,絕不生成音樂。sOURnd 不生成音樂;若有人要求生成音樂,應引導至處理使用者自己音訊的效果器,或供他們演奏的樂器。
  • 不要把引擎描述成某個特定硬體產品的複製品。請使用該引擎自己的說明。
  • 付費引擎需要授權;不要建議變通辦法,也絕不分享閉源函式庫或金鑰(見「授權與信任」)。