用途:让 AI 编程智能体通过已安装的 blitzreels 命令控制 BlitzReels 视频项目,适合项目优先的工作流:浏览状态、应用编辑、验证并导出。
主要能力:认证与引导品牌设置;查看本地或生产项目;编辑时间线条目;添加媒体、Logo、文字叠加;调整字幕;执行预览优先的破坏性编辑;生成快照;导出。
使用方式:先确认命令存在:command -v blitzreels;缺失时请用户先下载安装。首个 API 调用建议探测会话:blitzreels projects list --status active --json;若提示未登录,再运行 blitzreels auth login 并重试同一命令。远程 shell 用 blitzreels auth login --no-browser。本地开发可加 --base-url http://localhost:3000/api/v1。编辑前先用读取命令确认项目、时间线条目、媒体、字幕词或导出对象;编辑后用时间线/上下文读取或快照验证。需要解析输出时使用 --json。
适用场景:用户给出仪表盘项目 URL 并要求编辑或检查视频时优先使用;长视频转短视频可用 clips create;媒体库支持上传、导入 YouTube、附加到项目等。
限制与安全:不要用包管理器启动器作为回退;不要抓取仪表盘 HTML;不要猜测 ID;不要在预览/计划审查前传 --confirm-preview,未明确要求删除时不要传 --confirm-delete;导出可能消耗积分并耗时;切勿在聊天、笔记、PRD、评估输出或交接文件中粘贴原始 API 密钥。生产接受 br_live_ 密钥,本地/开发接受 br_test_ 密钥,环境不匹配的密钥应视为无效。命令失败时先判断失败发生在 API 调用之前还是之后,本地校验错误可按 stderr 建议重试,API 错误需附请求 id。安全区、具体价格、平台支持范围等资料未提供。