插件安装： 在设置或刷新命令之前，如果此技能位于 HyperFrames 插件内，请遵循插件执行规则。独立安装时请保留下面的更新说明。
media-use
为 HyperFrames 打造的媒体操作系统：解析 · 生成 · 操作 · 记忆 —— 所有媒体类型，一个技能，零上下文噪音。
首次运行：安装并登录 heygen CLI（免费使用路径），然后用 npx hyperframes media-use resolve --doctor 进行验证。设置和提供商信息：references/setup-providers.md。
Resolve — 核心动词
npx hyperframes media-use resolve --type <type> --intent "<描述>" --project <dir>
返回一行结果：resolved <id> → <路径> (<类型>, <元数据>)。所有搜索噪音都保留在磁盘上。
| 类型 | 单行意图 |
|---|---|
bgm | 背景音乐（HeyGen 目录，10k+ 曲目） |
sfx | 音效（捆绑的 19 文件库 + 目录） |
image | 照片、背景（HeyGen 资产搜索，75k+ 矢量） |
icon | 图标、符号（透明） |
logo | 官方品牌标志（theSVG → GitHub 头像 → favicon；绝不重绘） |
voice | TTS 配音（HeyGen 免费使用路径；可选的本地 Kokoro） |
grade | 测量校正候选；广泛的润色/风格化请参见 Media Treatments |
lut | 用户提供或明确选择的可复用的已验证的 .cube 文件 |
在解析新内容之前，先使用 --candidates 列出可复用的候选项，自行判断其适用性 —— 复用规则、所有标志、导入（--from）和采用，详见 references/resolve.md。
将广泛的视觉反馈视为媒体意图
当用户明确要求修复、润色、风格化、模糊、强调或展示摄影媒体时，请阅读 references/media-treatments.md，即使他们未提及色彩分级或特效。检查实际的 <img>/<video> 元素，选择一个主要意图，然后使用确定性的持久化和验证。使用匹配的配方作为可选的经过测试的种子，或者检查 hyperframes media-treatment --capabilities --json，然后用 --capability <id> 请求一个相关家族/特效，并从规范控件组装自定义处理。绝对不要在普通创作时加载 --all。一个处理可以组合校正、预设、精修、兼容的着色器效果、支持的关键帧，以及可选的 Registry 叠加。只添加源合理的受限调优和兼容部件，绝不为了追求结果看起来更复杂而添加特效。使用 hyperframes media-treatment 持久保存最终组合的负载。
使用一个逐步升级的工作流。对于视频，检查一个标注了早期/中期/后期的联系表，而不是分别读取每一帧。对于普通的校正或润色，应用一个候选并检查一个后期处理表。仅在结果模糊、与时间相关、风格化、基于 LUT、HDR/LOG 敏感、隐私或品牌关键时，才升级到单个帧或移动草稿证据。
对于普通校正或润色，持久保存最终处理的预设/调整 JSON。
不要仅仅为了编码曝光、阴影、对比度或色温而生成 .cube LUT。仅在用户提供了 LUT 或所选处理明确拥有一个 LUT 时使用。resolve --type grade --for ... --analyze 是测量证据，不是允许用生成的 LUT 替换所选处理的许可。不要用 CSS/SVG 覆写重新创建支持的晕影、颗粒、模糊、像素化、色彩或处理效果；这会绕过 Studio 控件和规范的预览/渲染着色器路径。
主动出击 — 运行媒体机会扫描
用户通常无法判断哪些媒体能提升作品。你可以。当你构建或审查一个合成时，执行一次基于证据的扫描，然后询问一次 —— 不要静默添加，也不要对每个资产都唠叨。
仅当存在具体信号时才提出机会：
| 检测到的信号 | 建议 |
|---|---|
| 屏幕上的文字 / 没有配音的脚本 | TTS 配音（音频引擎） |
表情符号或具备图标样式的 <div> | 解析真实的 icons |
| 图像是占位符、尺寸过小或看起来像放大的 | 更好的 image（和/或放大 —— 参见 references/operations.md) |
| 硬场景切换 / 无声音的过渡 | 过渡 sfx |
| 超过约 10 秒且没有音乐底部的片段 | bgm |
| 看起来欠曝、过曝或有色偏的素材 | 一个校正性分级（使用 hyperframes media-treatment --selector '#hero' --analyze --json 进行检查） |
| 视觉上平淡或离题的摄影媒体 | 一个特定的、源合适的预设或自定义处理，并命名预期目标 |
| 感觉静态的有意义的媒体入场/展示 | 一个受支持的无跳跃处理动画；除非请求也证明预设合理，否则保留颜色 |
以下是将其保持为帮助而非唠叨工具的规则：基于证据，而非泛泛而谈（无信号 → 无建议）；有观点且具体（提出包含默认选择的特定修复方案 —— 用户批准 全部 / 部分 / 无）；每个项目仅一次（一次性整合请求；尊重“保持原样”）；展示，绝不静默修改（色彩分级尤其如此：提出并预览 —— 灰度世界的“校正”会毁掉刻意的日落或霓虹灯效果）。
查阅位置 — 只读与你的任务相关的文件
| 任务 | 读取 |
|---|---|
| resolve / reuse / adopt / ingest, flags, cascade, inventory | references/resolve.md |
color grading, LUTs, smart grade (--for), grade-compare | references/grading.md |
| voiceover / TTS, music, SFX, captions, transcription (audio engine) | references/audio.md |
| cut / reframe / transform existing media, exact error diffusion, HEVC | references/operations.md |
| source-aware creative treatments, realtime effects, overlays, reveals | references/media-treatments.md |
install + auth, provider table, RAM ladders, --local-only, --provider | references/setup-providers.md |
| remembered preferences + frozen recipes (user memory) | references/memory.md |
| ownership matrix, usage stats, telemetry, privacy (maintainer-facing) | references/meta.md |