media-use

media-use 是什么

media-use 是 HyperFrames 的统一媒体操作系统，用一个 resolve 入口处理背景音乐、音效、图片、图标、品牌 Logo、语音、调色与 LUT，并将结果冻结为本地文件或可粘贴片段，同时写入资产台账。目录未命中时还可生成 TTS、音乐和图片，或执行转录、字幕、抠图、裁切与重构图。

适用场景与选择边界

适合视频项目寻找并固化可复用媒体、修正真实素材、生成旁白和管理素材来源。它不负责时间线上的混音或场景编排；已经放置的音轨效果属于 audio，镜头结构属于工作流。没有具体媒体问题时不应为了“更高级”随意加效果。

核心能力与工作机制

resolve 会隐藏搜索噪声，只返回资产 ID、路径、类型和元数据。它先列可复用候选，再按意图检索或生成。对暗、平、偏色、复古、隐私遮挡等反馈，会进入 media treatment：检查真实媒体、选择单一主要意图、用框架支持的确定性效果保存处理配置。

实际工作流与交付结果

首次安装并登录 heygen CLI，运行 doctor 检查提供商。处理前先查看候选和项目台账；找到资产后冻结到项目。视觉处理先做早中晚接触表，应用一个候选并生成 after-sheet；只有结果模糊、时序复杂、HDR/LOG、隐私或品牌关键时才升级到逐帧或动态证据。

依赖、账号与权限

依赖 Node、脚本、HeyGen CLI 及按需配置的提供商；本地 Kokoro 可作为语音选项。需要读写项目媒体和台账。不同资产源可能有各自账号、网络与授权要求，Logo 必须来自官方资源链而不是重新绘制。

限制、成本与安全风险

自动白平衡可能毁掉有意的夕阳或霓虹风格，所以调色必须先提案和预览。CSS/SVG 仿效果会绕过 Studio 与渲染器，不应用来替代原生处理。素材许可、人物隐私、品牌标识和生成内容均需人工核对；工具只管理来源，不授予使用权。

上手与验收建议

提供项目目录、媒体类型、用途、画幅和情绪，并指出已有素材。先运行 candidates 决定能否复用，再 resolve；任何调色或遮挡先看对比。项目完成前做一次有证据的媒体机会扫描，只集中询问一次是否补旁白、音乐、音效或更合适图片。

来源、版本与许可

依据 heygen-com/hyperframes 固定提交的完整 media-use Skill 与市场详情整理，仓库声明 Apache-2.0。

常见问题

1. resolve 会返回大量搜索结果吗？

不会，它把搜索噪声留在磁盘，只向调用者返回已选资产的 ID、冻结路径、类型和元数据。正式检索前还能列出可复用候选，由代理判断是否合适。

2. 支持哪些媒体类型？

包括 BGM、SFX、图片、透明图标、官方 Logo、TTS 语音、测量型调色候选和用户提供的 cube LUT，并能按参考文件执行字幕、转录、抠图与媒体变换。

3. 会自动给视频加音乐和调色吗？

不会静默修改。它只在发现明确问题时集中提出一次具体建议，用户可以全部、部分或全部拒绝；调色尤其要先预览，尊重“保持原样”。

4. 普通曝光修正需要生成 LUT 吗？

不需要。曝光、阴影、对比度和暖色等普通修正应保存为调整 JSON；只有用户提供 LUT 或所选处理明确拥有 LUT 时才使用 cube 文件。

5. 为什么不能用 CSS 模拟颗粒或模糊？

CSS/SVG 叠层会绕开 Studio 控制和统一的预览、渲染 shader 路径，可能造成预览与导出不一致。应使用框架已经支持的 vignette、grain、blur 等能力。

6. 视频调色如何快速检查？

普通任务先看带标签的早、中、晚接触表，再看应用后的对照表；只有时间变化、风格化、隐私、HDR/LOG 或品牌关键情况才升级检查更多帧。

7. 品牌 Logo 可以让模型重新画吗？

不应。解析链优先使用官方品牌资源、图标库、GitHub 头像或 favicon，避免模型重绘导致比例、颜色和商标细节失真，同时仍需核对品牌使用规范。

8. 它负责已经放入时间线的混音吗？

不负责。media-use 处理素材获取、生成和预处理；多个已放置音轨的音量、ducking、效果链和总线属于 HyperFrames audio Skill。