SuperAPI AI 工具集

media-use

设计与创作

查看项目

更新于 10-28 21:24

技能介绍

media-use 是 HyperFrames 项目使用的媒体操作系统技能,定位为“解析、生成、操作、记忆”统一入口,覆盖多种媒体类型,旨在减少上下文噪音,让创作流程中的媒体获取与使用更集中。

用途方面,该技能可解析背景音乐、音效、图片、图标、品牌标志、语音、调色方案以及 LUT 文件,将结果落为冻结的本地文件或可直接粘贴使用的块。核心操作是 resolve 命令,形式为 npx hyperframes media-use resolve --type <类型> --intent "<描述>" --project <目录>,返回单行结果,包含解析出的 ID、路径、类型和元数据,搜索过程信息保留在磁盘上。

主要能力上,不同媒体类型有各自的来源:背景音乐通过 heygen CLI 检索 HeyGen 曲库;音效来自内置的 19 个文件库,并可检索 catalog;图片使用 HeyGen 资产搜索;图标提供透明图标和符号;品牌标志遵循 theSVG、GitHub 头像、favicon 的顺序获取,不重绘;语音提供 TTS 配音,并可选本地 Kokoro;调色提供测量后的校正候选;LUT 使用用户提供或明确选择的可复用 .cube 文件。技能还支持先列出可复用候选(--candidates),由使用者判断是否复用,并包含摄取(--from)与采纳(adopt)机制。

使用方式上,首次运行若需使用 HeyGen 媒体且环境中未设置 HEYGEN_API_BASE,需要安装并登录 heygen CLI,再用 npx hyperframes media-use resolve --doctor 验证。若主机应用已设置 HEYGEN_API_BASE,则媒体调用经由主机完成,不应要求用户安装或登录 CLI;主机拒绝调用时,应转达主机的提示并停止,不应擅自切换到其他提供商。对于配音和虚拟形象视频,若未配置该环境变量,需要先告知用户:通过 OAuth 登录 heygen CLI 可获得免费额度,而 API key 按 API 积分计费。若宿主应用自带音乐、音效或 HeyGen 工具,应优先使用宿主工具。

该技能还强调主动发现媒体机会:仅当存在具体信号时才提出建议,例如无配音的脚本可建议 TTS、占位图片可建议更换、无音乐的片段可建议 BGM、曝光或偏色问题可建议校正。建议应具体、有默认方案,并且每个项目只集中询问一次,不静默修改媒体,调色尤其应先提议并预览。对于需要修复、润色、风格化、遮挡、强调或揭示的摄影类媒体,应参考 media-treatments 文档,检查实际媒体元素,选择主要意图,并使用确定性的持久化与验证流程;仅在用户提供或所选处理明确包含时才使用 LUT,不应仅为编码曝光、阴影、对比度或暖色而生成 LUT。

适用场景包括在 HyperFrames 项目中进行音视频创作、为画面匹配背景音乐与音效、获取品牌标志与图标、生成配音、执行测量与校色、复用已有媒体资源等。限制与边界方面:部分媒体类型依赖 HeyGen 服务或 CLI 登录;未配置 HEYGEN_API_BASE 时,bgm 与 sfx 的 catalog 检索会失败并给出说明,sfx 仍可使用内置库;不应在普通创作中加载 --all,不应以 CSS/SVG 覆盖层重现受支持的效果;具体媒体来源数量、免费额度细节、平台、价格等信息以实际资料为准,资料未提供的部分暂未提供。