技能介绍

要解决的问题

在 AI 特效视频生成场景里，常见的痛点是：用户选模板时要么看到一堆本地列表却不知道实际效果，要么媒体资源链接失效导致预览空白；进入生成阶段时，很多人没配置自己的 API Key，直接返回失败又会让用户摸不着头脑。这些问题的核心在于模板选择、预览交付、生成凭证三个环节没有形成明确的边界和流程。

技能的工作逻辑

这个技能把流程拆成了清晰的步骤：

外部广场优先：默认不把本地分类列表当主入口，而是先让用户进入外部模板分类广场选模板。选好后回到工作台，直接提供 template_id 或模板名就能进入下一步，避免重复展示列表。
预览的可靠交付：当用户要看具体模板时，优先执行 export-preview-html 命令，生成包含本地封面和预览视频的 HTML 文件。如果当前环境支持内置预览能力，直接把 HTML 交给结果视图打开；若不支持，再回退为本地预览页 URL，且不会硬猜资源路径或伪造媒体。
生成前的凭证引导：用户进入生成环节但没配置自己的 API Key 时，不会直接报错。而是先引导完成火山账号绑定，再通过本地预览服务的 /media 路由展示企业微信二维码，让用户获取配置支持，最终用用户自己的 Key 生成，额度消耗归用户账号。

适用边界与注意点

不内置凭证：仓库里只有模板和配置的占位符，不会内置任何作者的 API Key 或 OSS Key，所有生成都依赖用户自己的凭证。
媒体资源的处理：部分模板没有封面或预览视频是正常现象，列表阶段只输出标题、template_id、类型、时长等纯文本信息，不会尝试直显媒体；遇到破图或空白位时，立即回退为纯文本列表。
预览能力的回退：如果内置结果视图无法显示 HTML 预览内容，不会宣称“已打开成功”，而是保留模板 ID 和文件路径让用户手动确认；只有结果文件预览完全不可用时，才会提供本地预览页 URL。
兜底流程的使用：只有当用户明确要求看本地分类、外部广场打不开时，才会触发本地分类浏览，且预下载会覆盖分类下全部匹配的视频模板，而非只缓存前几条。