Appearance
更多音视频插件
“更多音视频插件”不是一种独立的音频或视频处理节点，而是工作流节点面板中的插件资源入口。点击后会打开“添加插件”选择器；只有选中某个已发布插件中的具体工具，系统才会创建普通插件节点，并按该工具当前发布版本生成输入、输出和调试信息。
因此，这个入口本身不提供视频抽帧、音频提取、视频拼接或音频降噪等能力。工作流最终能使用什么功能，取决于当前资源库实际存在并已发布的插件工具。
当前实现与旧文档差异
旧文档分别介绍了视频抽帧节点、视频提取音频节点和包含大量工具的视频剪辑插件。当前系统需要按以下方式理解：
- 当前原生节点目录中没有“视频抽帧”和“视频提取音频”节点，这两项不能继续写成开箱即用的原生能力。
- “更多音视频插件”在节点目录中声明了
audio、video标签和分类，但当前请求适配层只会把mcp、local、cloud转换为接口的pluginKind参数，并不会把 audio/video 标签发送给插件列表接口。 - 因此，当前入口实际打开的是全部已发布插件列表，并非只展示音视频插件。不要因为插件从此入口出现，就认定它具备媒体处理能力。
- 核对时线上默认列表只有“表达式计算器”和一个 Context7 MCP 插件，均不是音视频工具；搜索“视频”返回“暂无相关插件”。列表会随资源库发布状态变化，本文不把当前空结果写成永久限制。
- 旧文档中的工具名、参数名、媒体格式、错误码和输出结构只能作为迁移参考。只有当前资源库重新发布对应插件，并且工具详情与旧版一致时，才能继续按旧参数使用。
当前选择器
下面是从“更多音视频插件”入口打开的真实选择器。由于当前分类过滤没有传到接口，列表会展示其他类型的已发布插件。
输入“视频”进行关键字搜索时，核对环境暂时没有匹配的已发布插件。
截图只用于说明核对时的真实状态。后续如果资源库发布了新的音频或视频插件，搜索结果会相应变化。
旧文档能力如何迁移
旧文档中的媒体能力仍有参考价值，但应把它们作为“需要寻找或重新建设的插件工具清单”，而不是当前系统能力承诺。
视频结构与片段处理
旧版包含：
- 视频抽帧；
- 裁剪指定开始、结束时间；
- 多段视频拼接与转场；
- 视频变速、帧率转换和插帧；
- 画面翻转、分辨率调整、超分辨率和 SDR 转 HDR。
迁移时应分别确认当前插件是否接收 Video、文件对象还是 URL，时间单位是秒还是毫秒，输出是单个视频、图片数组还是异步任务 ID。
音频提取与处理
旧版包含：
- 从视频提取 mp3、wav、aac 等音频；
- 音频转字幕；
- 人声与背景音乐分离；
- 多轨混音、音量调整、响度归一化和降噪。
当前没有对应原生节点。需要这些功能时，应先在资源库搜索已发布插件；没有匹配项时，通过“创建插件”接入服务或创建 MCP 插件，再返回工作流选择具体工具。
音视频与图片合成
旧版包含：
- 合成音频和视频；
- 图片与音频合成为视频；
- 图片序列转换为视频；
- 添加字幕、文字水印、图片水印或子视频。
这类工具通常涉及较大的文件、长耗时和多种编码格式。重新接入时必须明确素材格式、文件大小、时长、帧率、分辨率、编码器、临时地址有效期和任务超时，不能只复制旧工具名。
添加插件工具
- 在工作流画布点击“添加节点”。
- 在“音视频处理”分类点击“更多音视频插件”。
- 使用搜索框输入插件名、工具名或明确的能力关键词，例如“抽帧”“音频提取”“字幕”“拼接”。
- 展开插件，查看其中已发布的具体工具。
- 核对工具描述、输入参数、输出参数、示例、来源和授权要求。
- 选择具体工具后，系统创建普通插件节点，而不是“音视频插件”专用节点。
- 配置节点输入，完成单节点调试后再连接上下游。
如果列表中没有需要的工具，可以点击“创建插件”。当前实现会在新标签页打开资源库的插件创建入口；完成创建、发布和必要授权后，再返回工作流重新搜索。
资源与版本规则
当前插件选择器只请求已发布插件。创建节点时，系统会绑定插件 ID、工具 ID和插件已发布版本，并读取该工具的输入、输出及调试示例。
应注意：
- 插件必须存在可绑定的已发布版本；只有草稿不能作为稳定工作流依赖。
- 插件重新发布后，已有节点是否自动采用新版本要以节点实际绑定信息为准，不要假定会自动升级。
- MCP 插件可能需要先完成授权并刷新工具列表；未授权或服务不可用时，插件组可能没有可选择工具。
- 工具下架、服务离线、权限变化或插件删除都可能导致已保存工作流无法运行。
- 选择器展示的来源标签、工具数量和创建时间是资源信息，不等于媒体能力证明。
输入与输出核对
插件节点的字段由当前工具详情动态生成，没有统一的音视频参数契约。添加前至少核对：
| 项目 | 核对内容 |
|---|---|
| 媒体输入 | 是 Audio、Video、File、String URL，还是对象或数组。 |
| 地址要求 | 是否必须公网可访问、是否支持鉴权地址、地址有效期是否覆盖执行时间。 |
| 文件限制 | 容器格式、编码格式、文件大小、时长、分辨率、帧率和声道数。 |
| 时间与数值单位 | 秒、毫秒、比例值、百分比或绝对数值。 |
| 同步方式 | 同步返回媒体，还是先返回任务 ID 后轮询或异步查询。 |
| 输出类型 | Audio、Video、Image、数组、URL、字幕文件或任务状态对象。 |
| 空结果 | 工具失败或未检测到内容时返回空值、空数组、错误对象还是异常。 |
不要依赖工具名称猜测类型。例如名为 audio_extract 的历史工具曾接收视频 URL，但新插件可能改为 Video 或 File 类型；只有当前工具详情才是有效契约。
授权、安全与费用
- 使用第三方插件前确认数据会被发送到哪个服务、保存多久以及是否用于训练或分析。
- 不要把含个人隐私、商业秘密、访问令牌或未授权素材的媒体直接交给第三方工具。
- MCP、云插件和本地插件的授权方式不同，应在资源库完成所需授权并使用最小权限。
- 长视频、高清转码、超分辨率和生成式处理可能产生较高计算费用；调试时先使用短素材和低分辨率。
- 日志和异常信息中不要记录签名 URL、密钥或完整敏感媒体内容。
超时、重试与异步任务
插件节点沿用普通插件节点的异常处理能力，但参数和幂等性取决于具体工具。
- 视频转码、拼接、抽帧、超分辨率等长任务应优先使用异步任务协议，不要依赖短时间同步等待。
- 如果工具已经创建远端任务，前端超时后无条件重试可能产生两个任务和重复费用。
- 只有确认操作幂等，或插件支持请求幂等键时，才适合自动重试。
- 对返回任务 ID 的工具，应拆分为“提交任务”和“查询结果”步骤，并处理进行中、成功、失败和超时状态。
- 异常分支应记录插件、工具、任务 ID和非敏感错误摘要，便于追踪而不泄露媒体地址。
发布前检查
- 当前资源库确实存在需要的已发布媒体工具，而不是只在旧文档中出现。
- 已查看具体工具详情，输入、输出与上下游变量类型一致。
- 插件版本、授权、服务状态和调用额度有效。
- 使用真实但短小的测试媒体完成了单节点调试。
- 已验证格式、时长、分辨率、帧率、文件大小和 URL 可访问性边界。
- 已设计长任务的超时、查询、取消、幂等和重试策略。
- 输出媒体会被转存到受控存储，不永久依赖第三方临时地址。
- 已评估隐私、版权、内容安全和第三方费用。
- 没有因为工具出现在“更多音视频插件”入口就误判其能力。
常见问题
为什么列表里会出现表达式计算器？
当前入口声明了 audio/video 分类，但请求适配层没有把这两个分类转成接口过滤条件，所以实际展示全部已发布插件。这是当前实现边界，不代表表达式计算器具备音视频能力。
为什么搜索“视频”没有结果？
核对时当前资源库没有名称或描述匹配“视频”的已发布插件。可以尝试具体工具名；确认确实不存在时，需要先创建并发布插件。
旧文档中的视频抽帧节点去哪里了？
当前节点目录没有视频抽帧原生节点。需要通过当前已发布插件实现；如果资源库没有对应工具，就需要重新接入或开发。
旧版视频剪辑插件中的工具还能直接使用吗？
不能只凭旧文档判断。必须在当前资源库找到已发布插件，并核对当前工具详情、版本和授权。旧工具名和参数只能作为迁移参考。
选择插件后会创建什么节点？
系统会根据所选具体工具创建普通插件节点，并绑定插件 ID、工具 ID、发布版本及当前输入输出定义，不会创建一种新的“音视频插件节点”。