SuperAPI AI 工具集

media-use

设计与创作

查看项目

更新于 10-24 16:22

技能介绍

media-use 是 HyperFrames 项目中用于统一处理媒体需求的技能,定位为媒体操作系统,强调“解析、生成、操作、记忆”,用单一技能覆盖各类媒体并减少上下文干扰。

用途:在 HyperFrames 动效图形项目中,将背景音乐、音效、图片、图标、品牌 Logo、配音、调色与 LUT 等需求统一解析为可用资源路径。

主要能力:核心命令为 npx hyperframes media-use resolve --type <type> --intent "<description>" --project <dir>,返回一行形如 resolved <id> → <path>(<type>,<metadata>)的结果。支持的媒体类型包括:bgm 背景音乐(HeyGen 曲库,10k+ 曲目);sfx 音效(内置 19 文件库加曲库);image 照片与背景(HeyGen 资产搜索,75k+ 矢量);icon 透明图标符号;logo 官方品牌标识(theSVG → GitHub 头像 → favicon,不重绘);voice TTS 配音(HeyGen 免费使用路径,可选本地 Kokoro);grade 测量式校正候选;lut 用户提供或明确选择的可复用已验证 .cube 文件。解析新资源前可用 --candidates 列出可复用候选并自行判断适配度。

视觉处理:当用户明确要求修复、润色、风格化、遮挡、强调或展现摄影类媒体时,应阅读 media-treatments 参考文档。先检查实际 img/video 元素,选择一个主要意图,再使用确定性持久化与验证。可使用匹配的配方作为可选测试起点,或通过 hyperframes media-treatment --capabilities --json 查看能力后,以 --capability <id> 请求相关类别并组装自定义处理。不应仅为使结果显得更复杂而添加效果。视频处理建议生成标注早/中/晚的联系表检查,而非逐帧阅读;仅在结果不明确、涉及时序、风格化、LUT、HDR/LOG 敏感、私密或品牌关键时升级到单帧或动态草稿验证。普通校正或润色应持久化处理的预设/调整 JSON,不应仅为编码曝光、阴影、对比度或暖色而生成 .cube LUT;也不应使用 CSS/SVG 叠加重建受支持的暗角、颗粒、模糊、像素化、颜色或处理效果。

主动建议机制:构建或审阅合成时进行一次有依据的扫描,然后集中询问一次,不静默添加、不逐个资产催促。仅在存在具体信号时提出机会,例如:有屏幕文字或脚本但无配音时建议 TTS 配音;用 emoji 或 div 模拟图标时建议解析真实图标;图片为占位符、过小或疑似放大时建议更好图片;有硬切转场但无声音时建议转场音效;超过约 10 秒无音乐铺底时建议 BGM;素材曝光不足/过度或色偏时建议校正调色;摄影媒体扁平或跑题时建议一个具体预设或自定义处理;重要媒体入场/展现显得静态时建议一个受支持的动画。建议需具体、有默认选择,每项目仅一次集中询问,尊重用户拒绝,尤其是调色应先提议并预览,不静默修改。

使用方式:需安装并可用 HyperFrames 环境,可用 npx hyperframes media-use resolve --doctor 验证环境。涉及 HeyGen 提供商的操作用授权账户,必要时安装其 CLI;本地媒体与规划任务无需提供商登录。插件安装需先遵循插件执行规则再执行安装或新鲜度命令。

适用场景:HyperFrames 动效图形项目的媒体组装、资源复用、配音与音乐音效配置、图标与 Logo 获取、调色与 LUT 处理等。

限制:部分能力依赖 HeyGen 提供商与授权;LUT 仅在用户提供或选定处理明确拥有时使用;不确定的事实(如具体价格、平台支持范围)暂未提供。