用途：Helios 是浏览器原生视频引擎，用于程序化动画与渲染。本技能提供安装与快速上手流程，适用于新建 Helios 项目、安装依赖包或创建首个合成。
环境要求：Node.js v18 或更高（推荐），npm 或 yarn；渲染需要 Chrome/Chromium（由 Playwright 自动安装）；FFmpeg 已由 @helios-project/renderer 通过 @ffmpeg-installer/ffmpeg 自动捆绑，无需手动安装，也可通过渲染器配置的 ffmpegPath 指定系统 FFmpeg。
安装：Helios 采用模块化设计，按需安装。核心包（必需）：npm install @helios-project/core；渲染器包（推荐，用于输出 MP4）：npm install @helios-project/renderer；两者一起安装：npm install @helios-project/core @helios-project/renderer；播放器包（可选，用于预览）：npm install @helios-project/player。
基本用法：创建 HTML 合成文件并引入脚本；在 JS 中从 @helios-project/core 导入 Helios，用 new Helios({ duration, fps, width, height, autoSyncAnimations: true }) 创建实例，调用 helios.bindToDocumentTimeline() 绑定文档时间线，设置 window.helios = helios 以便被检测，并用 helios.subscribe(...) 订阅帧更新执行渲染。现有 CSS/WAAPI 动画无需修改，调用 helios.seek(45) 可让动画立即跳到第 45 帧。
渲染与预览：命令行渲染 npx helios render ./composition.html -o output.mp4；也可用渲染器包以编程方式调用 render({ input, output, width, height, fps })。安装播放器后可用 <helios-player> Web Component 预览。
框架集成：提供 React 的 useVideoFrame、Vue 的 useVideoFrame、Svelte 的 videoFrame，以及原生 JS 的 helios.subscribe 订阅方式。
限制与排查：需确保核心包已安装、时间线已绑定、window.helios 已暴露、已订阅状态、画布尺寸正确；动画不同步时检查 autoSyncAnimations 与 bindToDocumentTimeline；渲染失败时确认 Chrome/Chromium 可用；播放器无法检测合成时检查 window.helios 与 HTML 路径。更多 API、工作流与示例见相关技能文档。