莫的 Skills 精品 Hubskills.miemie
安装热度榜

media-use

media-use 是 HyperFrames 视频项目中的媒体获取与制作技能：统一用 `npx hyperframes media-use resolve --type <type> --intent "..." --project <dir>` 查找或生成音乐、音效、图片、图标、Logo、配音、数字人/生成视频、转录文本、抠图、调色与 look，并支持对已放置音频做混音。媒体最终以本地文件形式落在项目 `assets/` 并写入 ledger 记录，渲染过程不联网取素材。技能给出两种获取方式：HeyGen（质量最佳，需安装 `heygen` CLI 并用 `heygen auth login --oauth` 登录，OAuth 会话在订阅额度内带免费额度，API key 走 API credits；还包含文生视频、数字人视频、声音克隆、对口型配音、视频翻译、长视频切片等命令），以及无需账号的免费本地路径（MusicGen 背景音乐、Openverse 与 21 个内置离线音效、已安装时用本地 FLUX/mflux 生成图片、theSVG/GitHub 头像/favicon 作为 Logo、`npx hyperframes tts` 的 Kokoro 设备端配音、本地 LTX 生成通用片段、Parakeet/whisper 转录、remove-background 抠图、media-treatment 调色）。文档还规定成本确认、宿主应用优先、画面观感问题（偏暗/平淡/需复古或印刷感/需遮脸/需揭示）走 media-treatment 流程，以及“只提议一次、不静默添加”的协作原则，并附按任务查阅的 references 索引。

分类
Agent 工作流
榜单排名
#9
安装量
1,057,844

它能做什么

中文摘要

media-use 是 HyperFrames 视频项目中的媒体获取与制作技能：统一用 `npx hyperframes media-use resolve --type <type> --intent "..." --project <dir>` 查找或生成音乐、音效、图片、图标、Logo、配音、数字人/生成视频、转录文本、抠图、调色与 look，并支持对已放置音频做混音。媒体最终以本地文件形式落在项目 `assets/` 并写入 ledger 记录，渲染过程不联网取素材。技能给出两种获取方式：HeyGen（质量最佳，需安装 `heygen` CLI 并用 `heygen auth login --oauth` 登录，OAuth 会话在订阅额度内带免费额度，API key 走 API credits；还包含文生视频、数字人视频、声音克隆、对口型配音、视频翻译、长视频切片等命令），以及无需账号的免费本地路径（MusicGen 背景音乐、Openverse 与 21 个内置离线音效、已安装时用本地 FLUX/mflux 生成图片、theSVG/GitHub 头像/favicon 作为 Logo、`npx hyperframes tts` 的 Kokoro 设备端配音、本地 LTX 生成通用片段、Parakeet/whisper 转录、remove-background 抠图、media-treatment 调色）。文档还规定成本确认、宿主应用优先、画面观感问题（偏暗/平淡/需复古或印刷感/需遮脸/需揭示）走 media-treatment 流程，以及“只提议一次、不静默添加”的协作原则，并附按任务查阅的 references 索引。

为什么推荐

推荐理由

适合已经在用 HyperFrames 做视频、又不想为每类素材分别找工具的人：它把素材解析、复用、HeyGen 付费生成与完全免费的本地替代方案收在同一条 resolve 命令下，并明确写了成本确认、宿主应用优先、无账号免费回退和观感处理的边界，行为规则清晰、可预期。安装量在榜单中排名第 9（约 105.8 万），说明被大量实际项目采用。

什么时候用

适用场景

  • 为 HyperFrames 视频查找或生成背景音乐、音效、图片、图标与 Logo
  • 给视频配旁白配音（HeyGen 声音或本地 Kokoro TTS），或生成数字人出镜视频
  • 把已有媒体导入项目并复用：先列出候选资产再判断是否复用
  • 对偏暗、平淡、发灰的实拍素材做调色、LUT 与 look 处理，或做复古/印刷质感、遮脸、揭示效果
  • 生成字幕/转录文本、抠图去背景、音效与音乐的混音（淡入淡出、增益、ducking）
  • 需要不联网、无账号的本地媒体生产（`--local-only` 跳过所有网络提供方）

使用前先看

主要亮点

  • 01

    媒体以本地文件落入项目 `assets/` 并带 ledger 记录，渲染时从不联网获取素材

  • 02

    提供 HeyGen 与免费本地工具两条路径：HeyGen 侧音乐目录 10k+ 曲目、资产搜索 75k+，并支持声音克隆与数字人视频

  • 03

    免费路径无需账号：MusicGen 背景音乐、Openverse 与 21 个内置离线音效、theSVG/GitHub 头像/favicon 做 Logo（从不重绘）、`npx hyperframes transcribe` 转录、`npx hyperframes remove-background` 抠图、`npx hyperframes media-treatment` 调色

  • 04

    本地配音 `npx hyperframes tts` 使用设备端 Kokoro，需 Python 3.10+ 并 `pip install kokoro-onnx soundfile`；本地图片生成依赖已安装的 FLUX（mflux），本地 LTX 同理

  • 05

    `resolve --doctor` 用于检查 HeyGen 设置；`--local-only` 跳过所有网络提供方；`--provider <name>` 可在用户点名时锁定某个生成器

  • 06

    成本规则明确：自己发起的付费调用需先确认（数字人视频计入），用户明确要求的直接执行

  • 07

    观感问题按 media 意图处理：先用 `media-treatment --capabilities --json` 查看能力，再用 `--capability <id>`，禁止 `--all`；支持的效应用真实 `<img>`/`<video>` 而非 CSS/SVG 替身

  • 08

    协作原则：构建或审阅时只扫描一次具体缺口（如无配音的文字、用 emoji 代替图标、占位图、静音剪辑、10 秒以上无音乐、偏色），一次性提出具体修复建议；无信号不建议，尊重用户“leave it”

  • 09

    宿主应用优先：当设置了 `HEYGEN_API_BASE` 时由宿主承担 HeyGen 费用，不要要求 `heygen` CLI 或登录；调用被拒时原样转述宿主信息并停止

原始文档

原文摘录

**Plugin installs:** Before setup or freshness commands, follow [plugin execution rules](../hyperframes/references/plugin-installation.md) when this skill is inside a HyperFrames plugin. Media in HyperFrames Media lands as a local file in the project's `assets/` with a ledger record; renders never fetch. One verb finds or makes it: