SuperAPI AI 工具集

media-use

设计与创作

查看项目

更新于 10-15 17:33

技能介绍

用途:当合成或创作需要媒体素材(背景音乐、音效、图片、图标)时,调用 resolve 即可把自然语言需求解析为本地冻结文件并登记到清单。

主要能力:支持四类素材,bgm(背景音乐,来自 HeyGen 音频目录)、sfx(音效,内置 19 个文件库加 HeyGen 目录)、image(图片,HeyGen 素材搜索)、icon(图标,HeyGen 素材搜索 type=icon)。解析流程会先查项目 .media/manifest.jsonl 的精确提示词匹配,再扫描 assets/ 中未登记文件,然后查全局缓存 ~/.media/,最后通过 provider 搜索,把文件冻结到 .media/<type>/、登记清单并重建 index.md。结果只返回一行;候选、评分、来源留在磁盘。支持 --adopt 批量导入已有 assets/,并用 ffprobe 提取真实时长与尺寸。

使用方式:命令为 node <SKILL_DIR>/scripts/resolve.mjs --type <type> --intent "<description>" --project <dir>。常用参数:--type/-t、--intent/-i、--entity/-e、--project/-p、--adopt、--json。安装 HeyGen CLI:curl -fsSL https://static.heygen.ai/cli/install.sh | bash;heygen update;export HEYGEN_API_KEY=<your-key> 或 heygen auth login --key <key>。

适用场景与限制:适合需要素材解析与清单管理的项目,资产解析后自动缓存,可在 ~/.media/ 跨项目复用,也可用 organize --promote 显式提升。依赖 ffprobe(必需)和 heygen(提供方需要,需 >= v0.1.6)。若 PATH 中没有可用的 heygen 或密钥无效,提供方会向 stderr 输出诊断,resolve 会以“no provider could resolve”收尾。素材来源、可用范围与授权等资料未提供,需自行确认。