wov-node-ffmpeg/AGENTS.md

WOV FFmpeg Node

从视频/音频提取标准化音频，供 ASR 节点使用。

输入

• video_uri：输入媒体文件。
• 参数：sample_rate、channels。

输出

• audio_uri：提取后的 WAV 文件。

跨平台

• Windows 和 Linux 均支持。
• 优先使用 FFMPEG_BIN，其次 PATH 中的 ffmpeg，最后使用 imageio-ffmpeg 内置二进制。
• 不写死 ffmpeg 路径。

代码注释规范

• 本仓库所有源码（Python、TOML 等支持注释的文件）必须配有详细中文注释，说明模块职责、ffmpeg 解析与调用逻辑，确保后续维护人员可以快速理解代码工作原理。
• 新增或修改代码时，必须同步补充或更新对应注释；不得删除已有注释。
• 测试代码同样必须配有中文注释，说明每条测试验证的行为。
• JSON 数据文件（node.manifest.json）不支持注释，字段语义以 wov-sdk 的 NodeManifest 模型注释和本文档输入/输出说明为准。