SuperAPI AI 工具集

hve-demo-material

通用与其它

查看项目

更新于 10-16 09:32

技能介绍

用途:按指定深度等级与主题,产出有证据支撑的 PPTX 演示文稿和旁白 MP4,并附带无障碍字幕与文字稿。等级与主题正交:等级决定受众、时长、采集保真度与评分模板,主题决定来源集合。

主要能力:读取 references/curriculum.md 选定等级、解析主题来源集合、实例化评分模板;动态主题通过 rpi-research 在 source_roots 中自主研究。从 templates/style.yaml 出发构建幻灯片并校验,按等级导出确定性帧(capture: deck-export)或用 vscode-playwright 进行 VS Code 实时捕获(capture: live)。可用 tts-voiceover 生成逐页 WAV,再由 demo-video 组装视频,最后用 scripts/finalize-accessible-video.sh 烧录字幕、保留英文可选字幕轨并生成 WebVTT 与文字稿。

使用方式:自 hve-core-general 起选等级,默认主题 hve-core-general(其固定来源存在时);其他仓库必须显式给出 topic。autonomy 取 full、partial、manual,默认 partial;narration 取 azure、piper、none,默认 azure(CI 强制 none);animation 取 none 或 characters,默认 none,仅调用方显式选择才启用。示例命令:bash scripts/render-level.sh --level L100 --level-dir <level-dir> --workspace <repo> --narration azure。FFmpeg 经脚本 --check-prerequisites 解析,可用 FFMPEG_COMMAND、FFPROBE_COMMAND 环境变量。

限制:L100/L200 固定 deck-export,拒绝 live;仅调用方可对 L300/L400 设 deck-export。azure 旁白需 SPEECH_KEY 或 SPEECH_RESOURCE_ID 加 SPEECH_REGION,凭据不得进入清单、日志与产物。缺少凭据、工具或证据不足时置为 Deferred,绝不自动切换引擎或降级采集。产出写入等级工作目录,不自动发布。原生 PowerShell 不是受支持入口,需用 macOS/Linux 的 Bash 或 WSL2。其他细节暂未提供。