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 版:在其 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 链接,由用户自己打开并付款。

流程

  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)、买家邮箱和所在国家创建结账会话。返回内容包含含英国增值税的价格,并在信息齐全后给出 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 不生成音乐;如有生成音乐的请求,应引导到处理用户自己音频的效果器,或由用户演奏的乐器。
  • 不要把引擎描述成某款具名硬件产品的复制品。请使用引擎自己的描述。
  • 付费引擎需要授权;不要提出变通办法,也绝不分享闭源库或密钥(见“授权与信任”)。