用途 该技能提供将 Helios 合成渲染为视频文件的工作流，适用于需要自动化视频生产或导出高质量动画的场合。渲染指逐帧捕获合成，并编码为 MP4 等视频文件，由 @helios-project/renderer 在 Node.js 环境中完成。
主要能力 支持通过命令行快速渲染：一条命令即可将 composition.html 输出为 output.mp4；时长、帧率与尺寸默认读取合成中的 window.helios，也可通过 --duration、--fps、--width、--height 自行指定。对使用 window.renderAt(t) 自绘制的页面需提供 --duration。可用 --audio 添加音轨。普通 HTML 文件可直接从磁盘渲染；若需打包器构建，则运行 npm run dev 并传入其 URL。需要自定义管线时（如输入属性、多条音轨、进度回调），可使用 Renderer 编写脚本，配置宽高、fps、时长或帧数、canvas/dom 模式、音轨与音量/偏移、音频编码、inputProps 等，并注册 onProgress 回调。
使用方式 快速路径：npx -y @helios-project/cli@latest render composition.html -o output.mp4。自定义脚本需先准备合成 URL（磁盘文件 file:///path/to/composition.html、开发服务器如 http://localhost:3000/composition.html 或其他可访问 URL），创建 render.js（或使用 ts-node 的 render.ts），导入 Renderer，配置参数后调用 renderer.render(compositionUrl, outputPath, { onProgress }) 执行。运行方式：npx ts-node render.ts（ts-node）或 node render.js（编译后的 js）。
适用场景 适合自动化视频生产、导出高质量动画、为合成添加背景音乐或配音、传入动态内容属性、监控渲染进度等。
限制与排查 资料未提供收费、价格、平台兼容范围或效果指标。常见问题包括：页面超时或连接被拒时，确认本地服务器运行且 URL 可在浏览器访问；输出黑屏或空视频时，确认 window.helios 已暴露或页面定义 window.renderAt(t)，canvas 模式需绘制到 <canvas>，dom 模式需元素可见；渲染挂起时检查浏览器控制台错误，可用 tracePath 输出 trace.zip 调试；音频问题需确认文件路径相对脚本运行位置正确，dom 模式依赖隐式音频时确保 <audio> 元素存在于 DOM。