media-use
面向 HyperFrames 的媒体操作系统：解析 · 生成 · 操作 · 记忆 —— 所有媒体类型，一个技能，零上下文噪音。
首次运行：安装并登录 heygen CLI（免费使用路径），然后使用 node <SKILL_DIR>/scripts/resolve.mjs --doctor 验证。设置和提供者：请参阅 references/setup-providers.md。
解析 —— 统一动词
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 | 测量校正候选；广泛的润色/风格化遵循媒体处理部分 |
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> | 解析真实的 icons |
| 占位符、太小或看起来放大的图片 | 更好的 image（和/或放大 —— 参见 references/operations.md） |
| 硬场景切换 / 无声音的过渡 | 过渡 sfx |
| 约 10 秒以上且无音乐背景的片段 | bgm |
| 看起来过曝/欠曝或有色偏的镜头 | 校正性分级（用 hyperframes media-treatment --selector '#hero' --analyze --json 检查） |
| 感觉视觉上平淡或离题的摄影媒体 | 一个具体的、来源合适的预设或自定义处理，并指明目标 |
| 感觉静态的重要媒体展示/揭示 | 一个支持的、安全跳转的处理动画；除非请求也证明了预设的合理性，否则保持颜色不变 |
保持帮助性而非烦扰的规则：基于证据，而非泛泛而谈（无信号 → 无建议）；有主见且具体（提出具体修复方案并设置默认值 —— 用户批准 全部 / 部分 / 无）；每个项目一次（整合成一次性请求；尊重“保持原样”）；展示，而非静默修改（色彩分级尤其如此：提出并预览 —— 一个灰世界的“校正”会毁掉有意营造的日落或霓虹效果）。
查看位置 —— 仅读取任务所需的文件
| 任务 | 参阅文件 |
|---|---|
| 解析 / 重用 / 采纳 / 摄取、标志、级联、库存 | references/resolve.md |
色彩分级、LUT、智能分级（--for）、分级比较 | references/grading.md |
| 配音 / TTS、音乐、音效、字幕、转录（音频引擎） | references/audio.md |
| 裁切 / 重帧 / 变换现有媒体、精确错误扩散、HEVC | references/operations.md |
| 源感知的创意处理、实时效果、叠加、展示 | references/media-treatments.md |
安装 + 认证、提供者表格、RAM 阶梯、--local-only、--provider | references/setup-providers.md |
| 记忆的偏好 + 冻结的配方（用户记忆） | references/memory.md |
| 所有权矩阵、使用统计、遥测、隐私（维护者面向） | references/meta.md |