lanshu-create-ai-presenter-video

环境要求

• Codex 或兼容本地 Skill 的 Agent 环境
• Python 3.9+
• FFmpeg 与 ffprobe
• Bash、jq、awk 和 sed
• 至少一种当前环境可调用的视频生成、语音生成与口型同步能力

安装与启动步骤

1. 1克隆到 Skill 目录

   把仓库直接克隆进 Codex 的 skills 目录，目录名需保持为 lanshu-create-ai-presenter-video，否则无法按 Skill 调用。

   git clone https://github.com/cclank/lanshu-create-ai-presenter-video.git 
     ~/.codex/skills/lanshu-create-ai-presenter-video

   复制

2. 2核对运行环境

   按 README 运行环境要求确认 Python 3.9+、FFmpeg/ffprobe、jq 等依赖已就绪，缺一不可。

   python3 --version
   ffmpeg -version
   ffprobe -version
   jq --version

   复制

3. 3准备输入素材

   至少准备一个主题或完整文案，以及一张已授权、包含清晰成年人物的参考图；缺少任一都无法开始。

4. 4初始化任务目录

   用 init_job.py 在指定目录生成标准任务结构与 job.json，同时显式确认素材授权和人物为成年人。

   SKILL_DIR=~/.codex/skills/lanshu-create-ai-presenter-video
   
   python3 "$SKILL_DIR/scripts/init_job.py" 
     --job-dir ~/Videos/my-presenter-video 
     --presenter-image ~/Pictures/presenter.png 
     --topic "视频主题" 
     --duration 60 
     --aspect 9:16 
     --rights-confirmed 
     --adult-presenter-confirmed

   复制

5. 5补全 job.json

   查看生成的任务文件，补全其中的人工检查项与远程上传许可，未确认前不要继续生成流程。

6. 6运行预检

   执行 preflight.py 校验任务配置与素材是否满足生成条件，通过后才进入实际生成环节。

   python3 "$SKILL_DIR/scripts/preflight.py" ~/Videos/my-presenter-video/job.json

   复制

7. 7在对话中触发生成

   也可以不手动初始化，直接在 Codex 对话里用 $ 引用该 Skill 并说明文案、画幅、时长与字幕要求。

   使用 $lanshu-create-ai-presenter-video，把这份文案和人物图做成一条 16:9、30 秒、有实时字幕的数字人讲解视频。

   复制

8. 8按阶段读取参考文档

   Codex 会在对应阶段分别读取 generation.md、editing.md、qa-recovery.md，完成生成、剪辑与质量验收。

关键配置

如何确认成功

preflight.py 执行无报错、job.json 中人工检查与上传许可已补全，最终按 qa-recovery.md 通过技术验收与人工验收。

常见问题

注意事项

• 人物参考图必须已获授权且为清晰成年人人物，禁止使用未授权形象。
• job.json 中的远程上传许可需人工确认后才能进入付费生成环节。
• 项目目前处于早期阶段，能力与流程可能继续调整。
• 生成结果需按 qa-recovery.md 完成技术验收与人工验收。