wov-node-llm/AGENTS.md

WOV LLM Node

使用 OpenAI 兼容接口翻译 SRT 字幕文本。

输入

• srt_uri：待翻译 SRT。
• 参数：target_language、model。

输出

• cn_srt_uri：翻译后的 SRT。

环境变量

• LLM_API_BASE：兼容接口地址，默认 http://192.168.123.70:8080/v1/chat/completions。
• LLM_API_KEY：可选。
• LLM_MODEL：默认模型，默认值 default。
• LLM_TIMEOUT_SECONDS：单次请求超时，默认 600。

代码注释规范

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