SuperAPI AI 工具集

soundcraft-editor

通用与其它

查看项目

更新于 11-04 23:02

技能介绍

用途

soundcraft-editor 用于在支持 MCP Apps 或内置浏览器的宿主内打开 soundcraft 的真实编辑界面,连接当前任务工作区,或让 Agent 的操作显示在同一页面。

主要能力

  • 从当前已加载插件的工具列表找到 soundcraft-editor 服务,使用本任务工作区绝对路径调用 open_editor,首次调用传入 workspace。
  • 编辑器就绪后,相对文件路径可交给具体打开工具处理。
  • 宿主支持原生 MCP Apps 时呈现 ui://soundcraft/panel.html;仅获得工具文字结果不代表界面已打开。
  • 提供会话管理能力:用 open_session/new_session 管理会话,import_audio 导入音频,inspect_session 检查会话,其他编辑操作查实时工具,save_session 保存工程,bounce_mix 输出音频。

使用方式

  1. 在插件工具列表中选择 soundcraft-editor 服务,调用 open_editor 并传入当前工作区绝对路径。
  2. 若宿主未自动呈现面板,调用 open_browser_editor,把返回的 editorUrl 交给宿主的内置浏览器打开能力。Codex Desktop 可调用 open_in_codex,target 为 browser,url 使用实际返回值;不要猜测固定端口或本地页面路径。
  3. 调用 editor_status,待 attached 或 ready 为 true 后再继续执行;加载失败应先处理页面错误。
  4. 同一实例只打开一个编辑页;本轮所有编辑使用同一服务。
  5. 完成后保存工程并重开检查,读取实际导出文件。

适用场景

需要在宿主内以真实界面操作 soundcraft、连接指定工作区、并在同一页面观察 Agent 编辑动作的场景。若宿主仅支持 MCP,工具调用能力与内嵌 UI 是两件事,可在外部浏览器使用同一 editorUrl,但必须明确告知这不属于宿主内嵌验收。

限制与注意事项

  • 该技能独立安装不附带编辑器服务,需要安装配套插件或配置其 MCP 后端。
  • 原生 CLI 与 Web 编辑器不是同一个内存文档,切换前必须先保存并显式重开。
  • 开发候选缺少 ui/dist/adapter.mjs 时,需先按插件 ui/README.md 构建;不要从任意缓存猜测路径,不要绕过校验。
  • 工具未注册时,可在获得插件实际目录后用项目终端运行 node ui/dist/adapter.mjs --serve,并通过环境变量 CRAFT_WORKSPACE_ROOT 指定本任务工作区;需保持该进程存活。此模式可展示 UI,但自动化仍须连接对应 MCP 实例,不能另开一个后端声称共享会话。
  • 浏览器存储、预览截图和已提交渲染任务不等于工作区交付。
  • 托管平台、收费方式与具体音频格式支持范围暂未提供。