用途 SoundCraft 技能用于通过其结构化自动化接口操作 SoundCraft 应用，完成音频会话、轨道、片段、混音、自动化、导出等创建与编辑，并编排工作流。使用时需保留用户要求的会话、路由与音频内容。
主要能力 可检查会话信息（轨道、带时间的片段、插入与参数、发送、路由、自动化、标记、分组、总线、来源、选择、缩放、传输），检查界面面板、对话框、音频设备与布局，并通过 engine.commands 查询命令目录。支持轨道、音量、独奏、播放、滚动视图等结构化命令，也支持界面点击、拖动、滚动、缩放、按键、文本输入等脚本化输入。可通过 ui.screenshot 截图验证，并在编辑后重新读取会话状态。
使用方式 使用前应先阅读参考文档 references/control-protocol.md 的相关章节（该文档是 2026-11-02 下载的上游协议快照，采用 MIT 许可）。命令可通过以下方式访问：桌面控制通道 soundcraft --control <port>（0 表示自动选择空闲端口并输出 SOUNDCRAFT_CONTROL_PORT=…）；对运行中应用使用 soundcraft-cli app --port <port> <方法或命令ID> [JSON]；无头 CLI：soundcraft-cli run --demo --cmd 'mix.volume={"track":"Kick","db":-6}' --bounce out.wav；MCP：soundcraft-cli mcp [--demo]（无头）或 soundcraft-cli mcp --connect <port>（桥接到实时应用）。应先发现可执行文件与运行中的会话，尽量复用。命令 ID 与参数应通过 engine.commands 在运行时发现，不要自行编造。传输采用 TCP 127.0.0.1 上的换行分隔 JSON，每行一个请求、一个回复，按 id 匹配，需检查 ok。engine.execute（别名 command）不打开对话框；空参数使用默认值或当前选择。ui.menu.invoke 点击真实菜单项并可能打开对话框。脚本化输入使用窗口坐标，最多排队 4096 个事件，回复在界面应用手势后才到达，应在后续操作前检查状态而不是重放。轨道按 id 或名称引用，片段按 session.inspect 返回的 id 引用，位置可用采样数、{"seconds": 2.5} 或带前缀的时间字符串表示。范围用起点加终点（或长度），省略表示当前编辑选择。优先使用结构化命令而非合成输入。面板停靠使用 ui.dock 与 ui.dock.reset，仅改变布局，不改变文档内容。
适用场景 适用于需要以脚本或自动化方式操作 SoundCraft 进行音频编辑、混音与导出的场景，包括无头运行、通过 MCP 桥接、以及自动化测试。自动化测试可用 SOUNDCRAFT_CONFIG_DIR 隔离状态，并使用 --no-audio 运行界面验收；快速验证时切勿启用轨道录音、输入监听或开始录制。
限制 该技能不安装 SoundCraft，也不配置 MCP 服务器。协议文档为快照，相对链接基于上游仓库解析。截图可能因过期或焦点变化而失败。脚本化输入有事件队列上限。