web-media-producer

# Codex 全流程网络素材视频制作 把用户目标转换为可执行、可追溯的制作流水线： ```text 主题与受众 → 网络研究与来源核验 → 开放授权或已获许可素材搜索 → 素材清单与版权闸门 → 原创文案与逐镜头分镜 → 配音、字幕和音乐 → 自动粗剪与包装 → 成片、工程文件、来源清单和事实核查报告 ``` “全网”表示在公开可访问且允许使用的来源中广泛研究，不代表无边界抓取互联网。技术上能够下载的内容，不能自动视为拥有复制、改编或再发布权。 ## 一、启动与运行时配置 ### 1. 下载锁定版本 普通研究与主题短视频： ```bash python scripts/install_web_media_stack.py --profile creator python scripts/check_video_editing_tools.py ``` 影视解说、已有视频分析和多语言配音： ```bash python scripts/install_web_media_stack.py --profile full ``` `install_web_media_stack.py` 负责下载并锁定源码，不自动安装所有重型依赖。 ### 2. 配置需要使用的应用 MoneyPrinterTurbo： ```bash python scripts/configure_web_media_apps.py --app moneyprinterturbo ``` NarratoAI： ```bash python scripts/configure_web_media_apps.py --app narratoai ``` VideoLingo： ```bash python scripts/configure_web_media_apps.py --app videolingo ``` 一次配置全部： ```bash python scripts/configure_web_media_apps.py --app all ``` 首次只想确认命令和锁定提交时使用： ```bash python scripts/install_web_media_stack.py --profile full --dry-run python scripts/configure_web_media_apps.py --app all --dry-run ``` VideoLingo 默认跳过可选 Demucs；需要人声分离时： ```bash python scripts/configure_web_media_apps.py \ --app videolingo \ --include-demucs ``` 完整运行时配置见 `docs/WEB_MEDIA_APP_SETUP.md`。 ### 3. 密钥位置 ```text tools/web-media/.env ``` 该文件由 `config/web-media.env.example` 创建并被 Git 忽略。Agent 不得打印、提交或复述 API Key、Token 或完整凭据配置。 ## 二、先建立项目 ```bash python scripts/scaffold_web_media_project.py \ --name "项目名称" \ --topic "研究主题" \ --duration 60 \ --aspect-ratio 9:16 \ --language zh-CN ``` 项目至少包含： ```text projects/<name>/ ├── brief.md ├── project.json ├── research/ ├── assets/ ├── manifests/assets.jsonl ├── script/script.md ├── storyboard/storyboard.csv ├── edit/edit-plan.json ├── subtitles/ ├── voice/ └── outputs/ ``` 所有中间产物必须进入该项目，不能散落在仓库根目录。 ## 三、确定需求和交付规格 优先从用户已有信息提取，不重复询问已经明确的内容。至少确定： - `topic`：主题或核心问题； - `goal`：解释、营销、新闻梳理、教程、故事、影视解说或翻译配音； - `audience`：受众知识水平； - `duration`：目标时长； - `aspect_ratio`：9:16、16:9、1:1 或 4:5； - `language`：文案、配音和字幕语言； - `platform`：抖音、B站、视频号、YouTube 等； - `source_scope`：开放网络、指定网站、用户文件或 URL； - `commercial_use`：是否商用； - `delivery`：成片、字幕、文案、剪辑工程和来源清单。 信息不足但可以安全推进时，使用明确假设并写入 `brief.md`。 ## 四、网络研究 ### 研究原则 1. 优先原始资料、官方文档、论文、机构页面和可信新闻来源。 2. 搜索摘要只能用于发现来源，不能直接作为事实依据。 3. 每个关键事实记录标题、URL、作者/机构、发布日期和局限。 4. 不整篇复制文章、视频字幕、书籍章节或付费内容；只保存必要摘要和短引文。 5. 最新新闻、价格、政策、人物身份、软件版本和产品规格必须联网核验。 6. 对矛盾来源保留不同说法，不擅自拼成确定结论。 ### 提取公开网页正文 ```bash python scripts/ingest_authorized_source.py \ --type document \ --url "https://example.com/article" \ --project "projects/项目名称" \ --asset-id "source-001" \ --license "Research reference; quotation limits apply" \ --rights-status restricted ``` `restricted` 文档可以用于研究和事实核查，但不得把其大段正文直接作为旁白或画面素材。 默认一次处理少量已选定页面，不使用批量爬取扫描整个站点，除非站点明确允许且任务确有必要。 ## 五、素材搜索与下载 ### 来源优先级 1. Wikimedia Commons 公共领域或 Creative Commons 文件； 2. Openverse 聚合的 CC 或公共领域图片与音频； 3. Pexels 图片和视频； 4. Pixabay 图片和视频； 5. MoneyPrinterTurbo 当前支持的 Coverr； 6. 用户自有素材或有书面许可的链接。 ### Wikimedia Commons ```bash python scripts/search_open_media.py \ --provider commons \ --media-type image \ --query "space solar power station" \ --limit 20 \ --output "projects/项目名称/research/search-results/commons.json" ``` ### Pexels 视频候选 ```bash python scripts/search_open_media.py \ --provider pexels \ --media-type video \ --query "solar panels satellite earth" \ --limit 12 \ --download-first 3 \ --download-dir "projects/项目名称/assets/videos" \ --manifest "projects/项目名称/manifests/assets.jsonl" \ --output "projects/项目名称/research/search-results/pexels.json" ``` ### Pixabay 图片候选 ```bash python scripts/search_open_media.py \ --provider pixabay \ --media-type image \ --query "satellite energy" \ --limit 12 \ --download-first 3 \ --download-dir "projects/项目名称/assets/images" \ --manifest "projects/项目名称/manifests/assets.jsonl" ``` 下载项目默认以 `selected=false` 写入素材清单。Codex 必须查看内容、相关性、清晰度、隐私和授权信息后，才能选入镜头表。 ### 用户授权的视频链接 ```bash python scripts/ingest_authorized_source.py \ --type video \ --url "https://example.com/public-video" \ --project "projects/项目名称" \ --asset-id "user-video-001" \ --license "User owns or has permission to reuse" \ --rights-status permission-granted \ --permission-note "用户在当前任务中确认拥有再利用许可" ``` ### 用户授权的公开图库 ```bash python scripts/ingest_authorized_source.py \ --type gallery \ --url "https://example.com/public-gallery" \ --project "projects/项目名称" \ --asset-id "gallery-001" \ --license "CC BY 4.0" \ --license-url "https://creativecommons.org/licenses/by/4.0/" \ --rights-status cc-by \ --creator "作者名称" \ --attribution "作者名称，CC BY 4.0" ``` 不得绕过登录、地区限制、付费墙、DRM、私密账号、验证码或平台反爬安全措施。本仓库包装器故意不提供浏览器 Cookie、账号密码和 DRM 绕过参数。 ## 六、素材版权闸门 最终剪辑前必须运行： ```bash python scripts/media_asset_manifest.py validate \ --manifest "projects/项目名称/manifests/assets.jsonl" ``` 默认允许： ```text public-domain cc0 cc-by cc-by-sa provider-licensed user-owned permission-granted ``` 默认禁止进入最终成片： ```text unknown restricted ``` CC BY 与 CC BY-SA 必须记录作者和许可证 URL；`permission-granted` 必须记录许可说明。需要署名的素材应在片尾、简介或交付清单中正确署名。 ## 七、文案和镜头表 ### 文案 写入 `script/script.md`，至少包括： 1. 标题候选； 2. 前 3–8 秒钩子； 3. 背景和问题； 4. 核心解释或故事推进； 5. 证据、数据和例子； 6. 结论； 7. 行动引导； 8. 事实核查清单。 文案必须原创表达，不把多个来源句子简单拼接，也不模仿在世创作者的独特表达风格。 ### 镜头表 写入 `storyboard/storyboard.csv`，每个镜头记录： - 起止时间； - 对应旁白； - 视觉搜索词； - 选用 `asset_id`； - 推拉摇移、裁切、缩放和转场； - 字幕； - 对应事实来源； - 状态。 镜头必须与文案语义匹配，不能只因画面好看使用无关素材。 ## 八、选择制作路线 ### 路线 A：主题直接生成短视频 适合科普、营销、知识解释和社交媒体视频，不要求逐个使用指定素材。 加载： ```text skills/moneyprinterturbo-video ``` MoneyPrinterTurbo 完成文案、Pexels/Pixabay/Coverr 素材、配音、字幕、音乐和成片。完成后把最终 MP4、任务目录、文案与素材来源并入当前项目。 ### 路线 B：研究驱动、指定素材混剪 适合必须使用指定文档、图片、视频或严格镜头表的项目。 加载： ```text skills/ai-video-editing ``` 流程： ```text 素材预处理 → 旁白/配音 → 镜头拼接 → 字幕 → 音乐 → 自动粗剪 → 人工抽检 → MP4 或专业剪辑工程 ``` ### 路线 C：已有视频解说 适合用户有权使用的电影、短剧、纪录片或长视频，需要视觉理解、解说文案、配音和自动剪辑。 应用路径： ```text tools/web-media/apps/NarratoAI ``` 必须先运行： ```bash python scripts/configure_web_media_apps.py --app narratoai ``` NarratoAI 只处理用户自有、公共领域或已获许可的视频。不要默认抓取商业影视作品再发布。 ### 路线 D：翻译、字幕和多语言配音 适合把已有视频翻译为另一种语言并生成单行字幕和配音。 应用路径： ```text tools/web-media/apps/VideoLingo ``` 必须先运行： ```bash python scripts/configure_web_media_apps.py --app videolingo ``` 其能力包括 yt-dlp 输入、WhisperX、字幕分段、翻译、术语表和多种 TTS。必须检查原视频的使用权、翻译权和配音发布权。 ## 九、质量检查 ### 内容 - 每个关键事实有来源； - 日期、数据、人物和机构名称准确； - 没有把推测写成事实； - 文案没有大段复制来源。 ### 素材 - `asset_id` 与实际文件一致； - 所有选中素材通过 manifest 校验； - 需要署名的素材已生成署名清单； - 没有水印、个人隐私、敏感信息或误导性画面。 ### 视频 - 句首句尾未被误剪； - 画面与旁白同步； - 字幕无明显错字且时间轴正确； - 配音清晰，音乐不过度压过人声； - 横竖屏裁切没有切掉主体； - 最终文件可播放，时长、分辨率和帧率符合要求。 ## 十、最终交付 至少交付： ```text outputs/final.mp4 script/script.md storyboard/storyboard.csv subtitles/final.srt manifests/assets.jsonl research/sources.md edit/edit-plan.json ``` 同时给出简短报告： - 研究了哪些主要来源； - 使用了哪些素材平台； - 哪些素材需要署名； - 使用哪条制作路线； - 哪些步骤已实际运行； - 哪些内容仍需人工确认。 没有实际运行成片流程时，不能声称视频已经生成。素材版权闸门未通过时，不能进入最终渲染。