用途:将 paper.pdf、paper2assets 包或已有 PPT 转成带旁白的 MP4,输出 video.mp4、video_no_subtitles.mp4 与 video.pptx。
主要能力:作为薄编排层,解析输入并只做一次共享的 ppt_trigger 决策,然后完整委托:paper2assets 生成共享包与 narration.json;ppt-master 负责幻灯片创作(SVG、Strategist 确认、演讲者备注、PPTX 导出及原生入场动画触发);pptx2video 负责 TTS、词边界计时、动画排程、字幕、时间线与严格媒体 QA。它自身不写幻灯片、不合成音频、不合成视频、不做 QA 门禁。
使用方式:先安装两个外部技能:npx skills add hugohe3/ppt-master --skill ppt-master 与 npx skills add ai-nuts/pptx2video --skill pptx2video;再安装并验证 CLI:python -m pip install 'pptx2video[svg] @ git+https://github.com/ai-nuts/pptx2video.git'、python -m playwright install chromium、python3 -m pptx2video --version、python3 -m pptx2video doctor --svg。始终用 python3 -m pptx2video ... 调用,不要用裸命令。流程为:构建或复用 paper2assets 包;用 ppt_options_contract.py resolve-ppt-trigger 解析唯一 ppt_trigger 并同时传给两个子技能;用 ppt-master 创作 PPTX;准备旁白并 bootstrap 可编辑协议;用 pptx2video render 渲染,并显式传 --qa-mode strict;最后审计交付的 PPTX 是否携带该触发值。
适用场景:需要把论文或已有 PPT 快速转为带旁白视频的演示、预览或交付场景。
限制:只有一条受支持路径,禁止自行拼装旁白、视觉提示或简化渲染管线,禁止调用 pptx2video.* 下的私有子模块;渲染必须走已安装技能或公开 CLI。pptx2video render 始终执行 QA 并写 video_qa_report.json,无 --no-qa;严格模式需显式开启,非零退出应视为阻塞失败去修复,而非放宽模式。需 Python 3.11 或更新环境,并跟踪上游默认分支而非固定发布标签。输出目录若已存在,render 会拒绝写入,需先渲染到临时包再提升。具体收费、价格与平台支持暂未提供。