media-use 是做什么的？
为 HyperFrames 打造的媒体操作系统：解析 · 生成 · 操作 · 记忆 — 每种媒体类型，一个技能，零上下文噪音。
首次运行：安装并登录 heygen CLI（免费使用路径），然后用 node <SKILL_DIR>/scripts/resolve.mjs --doctor 验证。设置和供应商：references/setup-providers.md。
Resolve — 唯一动词
node <SKILL_DIR>/scripts/resolve.mjs --type <type> --intent "<description>" --project <dir>
返回一行：resolved <id> → <path> (<type>, <metadata>)。所有搜索噪音保留在磁盘上。
| 类型 | 单行意图 |
|---|---|
bgm | 背景音乐（HeyGen 目录，10k+ 曲目） |
sfx | 音效（内置 19 个文件库 + 目录） |
image | 照片、背景（HeyGen 资源搜索，75k+ 矢量） |
icon | 图标、符号（透明背景） |
logo | 官方品牌标志（svgl → simple-icons → 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 时，才使用 LUT。resolve --type grade --for ... --analyze 是测量证据，而非允许用生成的 LUT 替换所选处理。不要用 CSS/SVG 叠加重新创建支持的暗角、颗粒、模糊、像素化、色彩或处理效果；这会绕过 Studio 控件和规范预览/渲染着色器路径。
主动出击 — 运行媒体机会扫描
人类通常无法判断哪些媒体能提升作品。你可以。当你构建或审查一个构图时，执行一次有根据的扫描，然后只问一次 — 不要静默添加，也不要每项资源都唠叨。
仅在检测到具体信号时才提出机会：
| 检测到的信号 | 提供内容 |
|---|---|
| 屏幕文字 / 没有配音的脚本 | TTS 配音（音频引擎） |
Emoji 或作为图标样式的 <div> | 解析真实的 icon |
| 占位符、尺寸过小或看起来被放大的图像 | 更好的 image（和/或放大 — 见 references/operations.md） |
| 生硬场景切换 / 无声音的转场 | 过渡 sfx |
| 超过约 10 秒且没有音乐背景的片段 | bgm |
| 看起来曝光不足/过度或带有色偏的素材 | 一个校正性的分级（用 hyperframes media-treatment --selector '#hero' --analyze --json 检查） |
| 视觉上平淡或偏离主题的摄影媒体 | 一个具体的源适配预设或自定义处理，并指明预期目标 |
| 感觉静态的重要媒体进场/揭示 | 一个受支持的、seek-safe 的处理动画；除非请求也包含预设，否则保持色彩一致 |
确保这是帮助而非唠叨的规则：有根据，非泛泛（无信号 → 无建议）；有主见且具体（提出具体的修复并带默认选择 — 人类批准全部 / 部分 / 无）；每个项目一次（一次性整合请求；尊重“不处理”）；提出，永不静默修改（色彩分级尤其如此：提议并预览 — 灰世界“校正”会毁掉有意的日落或霓虹效果）。
查看何处 — 仅阅读任务所需的文件
| 任务 | 阅读 |
|---|---|
| resolve / reuse / adopt / ingest、标志、级联、库存 | references/resolve.md |
色彩分级、LUT、智能分级（--for）、分级比较 | 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 |