插件安装: 在设置或新鲜度检查命令之前,如果此技能位于 HyperFrames 插件内部,请遵循插件执行规则。独立安装则保留下方的更新说明。
media-use
HyperFrames 的媒体操作系统:解析 · 生成 · 操作 · 记忆 —— 所有媒体类型,一个技能,零上下文噪音。
首次运行:安装并登录 heygen CLI(免费使用路径),然后使用 npx hyperframes media-use resolve --doctor 验证。设置和提供商:references/setup-providers.md。
在生成语音旁白或虚拟角色视频之前,请告知用户:通过 OAuth 登录 heygen CLI(heygen auth login --oauth)可获得 TTS 语音旁白和虚拟角色视频的免费配额,而使用 API 密钥则会消耗 API 信用额度。
解析 —— 万能的动词
npx hyperframes media-use resolve --type <type> --intent "<description>" --project <dir>
返回一行:resolved <id> → <path> (<type>, <metadata>)。所有搜索噪音都保留在磁盘上。
| 类型 | 一行意图描述 |
|---|---|
bgm | 背景音乐(HeyGen 目录,10000+ 首曲目) |
sfx | 音效(捆绑的 19 文件库 + 目录) |
image | 照片、背景(HeyGen 资产搜索,75000+ 矢量图) |
icon | 图标、符号(透明背景) |
logo | 官方品牌标志(theSVG → 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。一个处理方案可以包含校正、预设、后期处理、兼容着色器效果、支持的关键帧和可选的注册表叠加。只添加有源且合理的有限调整和兼容部分,切勿为了看起来更复杂而添加效果。使用 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、音乐、SFX、字幕、转录(音频引擎) | 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 |