media-use
HyperFrames 的媒体操作系统:解析 · 生成 · 操作 · 记忆 —— 一个技能处理所有媒体类型,零上下文噪音。
首次运行:安装并登录 heygen CLI(免费使用路径),然后使用 npx hyperframes media-use resolve --doctor 验证。设置和提供商:references/setup-providers.md。
解析 —— 唯一动词
npx hyperframes media-use resolve --type <type> --intent "<description>" --project <dir>
返回一行结果:resolved <id> → <path> (<type>, <metadata>)。所有搜索噪音将保留在磁盘上。
| 类型 | 单行意图 |
|---|---|
bgm | 背景音乐(HeyGen 目录,10k+ 曲目) |
sfx | 音效(捆绑的 19 文件库 + 目录) |
image | 照片、背景(HeyGen 资产搜索,75k+ 矢量图) |
icon | 图标、符号(透明背景) |
logo | 官方品牌标志(theSVG → GitHub 头像 → favicon;绝不重绘) |
voice | 文本转语音配音(HeyGen 免费使用路径;可选本地 Kokoro) |
grade | 测量出的校正候选方案;广泛的美化/风格化处理遵循媒体处理(Media Treatments) |
lut | 用户提供的或明确选择的可复用的已验证 .cube 文件 |
在重新解析新资源之前,先使用 --candidates 列出可复用的候选资源,并自行判断其适用性 —— 复用规则、所有标志、导入(--from)和采纳(adopt)均详见 references/resolve.md。
将广泛的视觉反馈视为媒体意图
当用户明确要求修复、美化、风格化、模糊化、强调或展示摄影媒体时,即使他们没有提及色彩校正或某种效果,也应阅读 references/media-treatments.md。检查真实的 <img>/<video>,选择一个主要意图,然后使用确定性持久化和验证。使用匹配的配方作为可选测试种子,或检查 hyperframes media-treatment --capabilities --json,然后使用 --capability <id> 请求一个相关系列/效果,并从规范控制中组装自定义处理。切勿为了普通创作而加载 --all。一个处理项可以组合校正、预设、收尾、兼容的着色器效果、支持的关键帧和可选的注册表叠加层。只添加有源依据的有限调整和兼容部分,绝不添加仅仅为了让结果看起来更复杂的效果。使用 hyperframes media-treatment 持久化最终的组合负载。
使用一个渐进升级的工作流。对于视频,检查一个标记了早期/中期/晚期的样片,而不是分别读取各帧。对于普通校正或美化,应用一个候选处理并检查一个处理后样片。仅在结果存在歧义、是时间性的、风格化的、基于 LUT 的、对 HDR/LOG 敏感的、涉及隐私或品牌关键时,才升级到单独帧或动态草稿证据。
对于普通校正或美化,持久化最终处理的预设/调整 JSON。切勿仅为了编码曝光度、阴影、对比度或色温而生成 .cube LUT。仅当用户提供了 LUT 或所选处理项明确拥有一个 LUT 时才使用它。resolve --type grade --for ... --analyze 是测量证据,不是用生成的 LUT 替换所选处理的许可。不要用 CSS/SVG 叠加层重新创建支持的小插图、颗粒感、模糊、像素化、颜色或处理效果;那会绕过 Studio 控件和规范的预览/渲染着色器路径。
主动出击 —— 执行媒体机会检查
用户通常不知道哪些媒体可以提升作品。但你知道。当你构建或审查一个作品时,进行一次基于证据的扫描,然后询问一次 —— 不要默默添加,也不要逐个资产地唠叨。
仅当检测到具体信号时才提出机会:
| 检测到的信号 | 提议 |
|---|---|
| 屏幕上的文本 / 没有配音的脚本 | TTS 配音(音频引擎) |
表情符号或被样式化为图标的 <div> | 解析出真正的 icon |
| 图片是占位符、太小或看起来被放大过的 | 更好的 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 |
安装 + 认证、提供商表格、内存阶梯、--local-only、--provider | references/setup-providers.md |
| 记住的偏好 + 冻结的配方(用户记忆) | references/memory.md |
| 所有权矩阵、使用统计、遥测、隐私(面向维护者) | references/meta.md |