media-use 是面向 HyperFrames 项目的 Agent 媒体操作系统技能，定位为“解析 · 生成 · 操作 · 记忆”，覆盖各类媒体类型，并尽量减少上下文噪音。
主要用途：将背景音乐、音效、图片、图标、品牌 Logo、语音、调色或 LUT 等媒体需求，解析为冻结的本地文件或可直接粘贴的块，供 HyperFrames 组合使用。
主要能力与使用方式： 核心命令为 npx hyperframes media-use resolve --type <type> --intent "<description>" --project <dir>，返回一行结果：resolved <id> → <path>（<type>，<metadata>），搜索噪音保留在磁盘上。支持类型包括：bgm（背景音乐，经 heygen CLI 检索 HeyGen 目录，号称 10k+ 曲目）、sfx（音效，检索 Openverse 的 CC0 与 CC BY 资源，离线时回退到内置 21 文件库）、image（照片与背景，HeyGen 资产搜索）、icon（透明图标与符号）、logo（官方品牌标识，按 theSVG → GitHub 头像 → favicon 顺序获取，不重绘）、voice（TTS 配音，HeyGen 免费使用路径，可选本地 Kokoro）、grade（测量得到的校正候选）、lut（用户提供或明确选择的可复用已验证 .cube 文件）。
安装与环境：在 HyperFrames 插件内使用时，需先遵循插件执行规则；独立安装则使用更新说明。若环境已设置 HEYGEN_API_BASE（由宿主应用设置并用其密钥付费），HeyGen 媒体已付费，不应要求用户安装或登录 heygen CLI，也不应提供其 OAuth 额度；若宿主同时提供自己的 HeyGen 工具，应优先使用。通过宿主调用被拒时，应原样转达宿主消息并停止，除非用户要求，不切换其他提供商。若无 HEYGEN_API_BASE 且将使用 HeyGen 媒体，需安装并登录 heygen CLI（免费使用路径），再用 npx hyperframes media-use resolve --doctor 验证。无 HEYGEN_API_BASE 时，生成配音或头像视频前应告知用户：用 OAuth 登录 heygen CLI 可获得 TTS 配音与头像视频的免费额度，而 API 密钥按 API 积分计费。
媒体处理：当用户明确要求修复、润色、风格化、遮挡、强调或揭示摄影媒体时，即使未提调色或效果，也应阅读 media-treatments 参考；检查真实 <img>/<video>，选择一个主要意图，再确定性持久化并验证。可用匹配配方作为可选测试种子，或检查 hyperframes media-treatment --capabilities --json 后按 --capability <id> 请求相关效果族并组装自定义处理。普通创作不应加载 --all。处理可组合校正、预设、收尾、兼容着色器效果、支持的关键帧及可选 Registry 叠加。视频应查看一张标注早/中/晚的接触表，而非逐帧阅读；普通校正或润色应用一个候选并查看一张后置表，仅在结果模糊、涉及时序、风格化、LUT、HDR/LOG、私密或品牌关键时升级。普通校正或润色应持久化最终处理的预设/调整 JSON；不应仅为编码曝光、阴影、对比度或色温而生成 .cube LUT；仅当用户提供或所选处理明确拥有 LUT 时使用。不应使用 CSS/SVG 叠加重造受支持的暗角、颗粒、模糊、像素化、颜色或处理效果。
媒体机会扫描：构建或审查组合时做一次有依据的扫描并询问一次，不静默添加，也不逐资纠缠。仅在具体信号存在时提出机会，例如屏幕文本无配音时建议 TTS 配音、emoji 或 div 充当图标时建议解析真实图标、占位/过小/放大痕迹图片时建议更好图片、硬切换无声音时建议过渡音效、超过约 10 秒无音乐床时建议 bgm、曝光或偏色素材建议校正调色、摄影媒体平淡或跑题时建议具体预设或自定义处理、媒体入场/揭示呆板时建议支持 seek 安全的处理动画。规则：有依据不泛泛、具体且带默认选项、每项目一次合并询问并尊重“保持原样”、只呈现不静默修改（调色尤其要提议并预览）。
参考资料：resolve/reuse/adopt/ingest/flags/cascade/inventory 见 references/resolve.md；调色、LUT、智能 grade、grade-compare 见 references/grading.md；配音/TTS、音乐、SFX、字幕、转录见 references/audio.md；剪切/重构图/变换既有媒体、精确误差扩散、HEVC 见 references/operations.md；来源感知创意处理、实时效果、叠加、揭示见 references/media-treatments.md；安装与认证、提供商表、内存阶梯、--local-only、--provider 见 references/setup-providers.md；记忆偏好与冻结配方见 references/memory.md；所有权矩阵、使用统计、遥测、隐私见 references/meta.md。