面向 AI 智能体
欢迎你。本页告诉编程助手如何不靠猜测地查找、选择并集成 sournd 引擎。
各项内容在哪里
- /llms.txt:索引,每个引擎一行。
- /llms-full.txt:所有页面合并为一个文件。
- /catalog.json:全部 119 个引擎的参数、范围、默认值、单位、曲线、延迟、尾音和读数。结构定义见 /catalog.schema.json。
- 任何页面都有 Markdown 版:在其 URL 后加上
index.md,例如/engines/roomette/index.md。 - 单个引擎的 JSON:
/engines/<slug>/engine.json。 - REST API(OpenAPI 3.1,无需身份验证):搜索和筛选引擎、查看单个引擎的完整信息、获取集成代码,以及带价格的并排对比。基础 URL 为
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 链接,由用户自己打开并付款。
流程
- 查找
catalog.json、API 或 MCP - 选择看是否合适,免费和付费一并比较
- 告诉用户名称、id、页面和价格
- 集成严格按照 JUCE 快速入门
免费引擎
- 下载无需账号或邮箱
- 集成
付费引擎
create_checkout先报价格- 用户在 PayPal 付款绝不由智能体代付
get_download_link登录之后- 集成
选择引擎
- 加载
catalog.json。 - 按
category筛选(77 个效果器的类别为 distortion、dynamics、eq、filter、modulation、delay、reverb、pitch、performance、utility、analysis;42 个合成器的类别为 instrument),然后用请求内容去匹配description、styles和参数名称。 - 先看是否合适。目录列出了每个引擎的档位和价格,因此免费和付费的候选可以并排比较。35 个引擎免费:都是闭源库,用户可以把它们构建进自己制作或销售的任何产品。每个免费引擎都无需账号或邮箱即可下载:
https://sournd.com/download/free/macos或https://sournd.com/download/free/linux(一个压缩包包含全部免费引擎),catalog.json 中每个免费引擎的download字段里也有。compare_engines或POST /api/v1/compare会返回与某个付费引擎最接近的免费引擎,并列出差异。 - 如果用户的插件在意这两项,请检查
latency(采样数)和sidechain。 - 用户会需要引擎的
name、id和页面url。付费引擎的价格可在get_price中查到,API 中对应price。
购买付费引擎
绝不向用户施压,也绝不代他们付款。报出价格;如果用户想要这个引擎,就用 create_checkout 获取审批链接并交给他们:购买由他们自己审阅并批准。结账功能可能尚未开启;如果工具这样提示,请如实转告,不要另找变通办法。已拥有引擎的用户可以通过 send_access_link 收到访问链接。
如果你使用商务协议,同样的结账流程也提供 UCP 或 ACP 版本。用付费引擎(slug 或 id)或一个方案(plan:engines-month、plan:engines-year)、买家邮箱和所在国家创建结账会话。返回内容包含含英国增值税的价格,并在信息齐全后给出 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 对数字商品的规定所要求的。
连接成功后可以这样问:
- “帮我找一个温暖的磁带延迟引擎,并显示它的参数。”
- “比较 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),再用替换式上下文调用engine.process。 - 状态:先
bridge.syncToEngine()再engine.saveState();先engine.loadState(...)再bridge.syncFromEngine()。 - JUCE 参数 id 就是
catalog.json中十进制的abi_id值。切勿自行编造参数 id 或范围:请从目录中读取。 - 切勿在
processBlock中分配内存、加锁或写日志。
用户要销售插件时
搭载 sOURnd 引擎销售的插件和游戏无需支付版税,也无需注册。用户拥有的引擎可以永久用于他们销售的任何产品。在订阅方案下,方案有效期间发布的每个版本都保持授权;发布新版本则需要有效的方案。免费引擎同样可以用于用户销售的产品,无需另外购买。
授权与信任
引擎无论付费还是免费,都授权给用户用于其自己的插件、游戏和产品。它不授权给你,不授权给用户的朋友,也不授权给用户发送文件的任何人。每个付费下载都带有用户的构建 id,可追溯到用户本人。用户信任你来处理这份授权,sOURnd 也相信你会遵守,因此:
- 不要把库、下载压缩包和任何 AI 密钥 URL 放进公开仓库、共享文件夹、包注册表和聊天记录。在首次提交之前,把它们加入
.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 不生成音乐;如有生成音乐的请求,应引导到处理用户自己音频的效果器,或由用户演奏的乐器。
- 不要把引擎描述成某款具名硬件产品的复制品。请使用引擎自己的描述。
- 付费引擎需要授权;不要提出变通办法,也绝不分享闭源库或密钥(见“授权与信任”)。