mcpField
M
moneyprinterturbo-video

moneyprinterturbo-video

github.com/harry0703创意与媒体136.1k209 次安装今天更新
代码仓库

关于 moneyprinterturbo-video

MoneyPrinterTurbo Video Generation 是一个根据主题或脚本自动生成视频的技能，负责配置、生成并交付 MP4。适合需要默认中文竖屏视频及配音、字幕和音乐的用户。

主要功能

  1. 01自动完成安装与生成
  2. 02复用已有配置
  3. 03默认生成中文 9:16 竖屏视频
  4. 04配音、字幕和背景音乐
  5. 05交付 MP4 文件

适用场景

  1. 01根据主题生成视频
  2. 02将脚本制作成视频
  3. 03制作带配音和字幕的竖屏视频

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/harry0703/moneyprinterturbo --skill moneyprinterturbo-video

安装后在 Claude Code 中输入/moneyprinterturbo-video确认已加载。

附带文件mpt_agent.py

详细介绍

MoneyPrinterTurbo 视频生成

用户只需提供视频主题或脚本。自动完成安装、复用配置、生成、等待和最终 MP4 交付。不要在提供说明或命令后停止。

必须遵守的行为

  1. 仅当必需的 API 凭据缺失、被拒绝或不可用时，才向用户索取。将所有必需凭据合并到一次请求中。
  2. 安装、生成、等待、使用默认值或返回结果前，无需征求用户确认。
  3. 对于标准生成请求，不要创建或反复更新详细计划。发送一条简短的进度更新，然后开始执行。
  4. 将辅助程序作为一条前台命令运行，超时时间至少为 20 分钟。
  5. 绝不要使用 sleep、echo、ps、重复运行 ls 或重复运行 tail 进行轮询。如果终端返回可恢复的会话 ID，请在同一会话中继续等待。
  6. 成功后不要读取完整日志。仅在失败后读取简短的错误信息或相关日志末尾内容。
  7. 绝不要打印 API 密钥、令牌、完整的 config.toml 或包含凭据的配置片段。

默认值

除非用户另有要求，否则生成一段使用 Pexels 素材的中文 9:16 竖屏视频，采用默认的中文 Edge TTS 语音，并添加字幕和背景音乐。将 MoneyPrinterTurbo 安装在用户的主目录下。

执行

1. 定位辅助程序

根据此 SKILL.md 文件解析 SKILL_DIR。辅助程序是同目录下的 mpt_agent.py。将终端工具的工作目录设为 SKILL_DIR，并通过相对文件名调用辅助程序。不要在命令中使用辅助程序的绝对路径，也不要额外运行 ls 或 dir 检查。

在 Windows 上必须遵循此要求，因为某些 Agent 终端验证器会从命令中的绝对路径里删除反斜杠。使用 workdir=SKILL_DIR 调用 mpt_agent.py 可避免此问题，并且在 macOS 和 Windows 上均可运行。

如果客户端只加载了远程的 SKILL.md，请从官方仓库将辅助程序下载到临时目录，然后将该临时目录用作命令工作目录：

https://raw.githubusercontent.com/harry0703/MoneyPrinterTurbo/main/docs/skill/mpt_agent.py
2. 运行辅助程序

不要单独运行 uv --version 进行预检查。直接运行辅助程序。如果 Shell 明确提示缺少 uv，请安装 uv，然后重试同一条辅助程序命令一次。

macOS 上安装 uv：

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows PowerShell 上安装 uv：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

使用此条前台命令，并将 workdir=SKILL_DIR 且超时时间设为至少 20 分钟：

uv run --no-project --python 3.11 python mpt_agent.py --subject "<video topic>"

在 Windows 上，运行此相对路径命令前，不要尝试绝对反斜杠路径、绝对正斜杠路径，也不要尝试工作区中的副本。如果终端工具报告 referenced_script_path_missing，请确认其工作目录确实是 SKILL_DIR，然后重试此相对路径命令一次。不要反复尝试不同路径。

不要使用 Docker、Conda、系统 pip 或手动管理的虚拟环境。

退出处理

退出代码 0：交付结果

成功输出格式如下：

MPT_RESULT
VIDEO_FILE=<absolute path>/final-1.mp4
TASK_DIR=<absolute path>/storage/tasks/<task_id>
LOG_FILE=<absolute path>/run-<task_id>.log
RESULT_FILE=<absolute path>/latest-result.json

只有在确认文件存在且非空后，mpt_agent.py 才会输出 VIDEO_FILE。不要再运行其他 ls、stat 或文件验证命令。

如果终端报告 exitCode=0，但输出被截断或只返回历史文件引用而没有 MPT_RESULT，不要据此判定失败，也不要检查旧日志。只需读取此文件一次：

~/MoneyPrinterTurbo/.agent-logs/moneyprinterturbo-video/latest-result.json

将 status=completed 视为成功。仅返回视频的绝对路径和简短描述，例如：

The video is ready.
Topic: ...
Video file: /absolute/path/to/final-1.mp4
Summary: Chinese portrait video with voice-over, subtitles, and background music.
退出代码 10：请求一次凭据

MPT_NEEDS_INPUT 仅包含必填字段、推荐的大模型提供商及注册链接、自定义 OpenAI 兼容要求，以及素材提供商注册链接。只询问列出的值，不要索取 config.toml 中已有的凭据。

用户回复后，仅使用必需的环境变量重新运行相同的前台命令：

MPT_LLM_PROVIDER
MPT_LLM_API_KEY
MPT_LLM_BASE_URL
MPT_LLM_MODEL_NAME
MPT_PEXELS_API_KEY
MPT_VOLCENGINE_ARK_API_KEY
MPT_OFOX_API_KEY
MPT_METASO_MINIMAX_API_KEY
MPT_MUAPI_API_KEY
MPT_INFISTAR_VIDEO_API_KEY
MPT_JALAPENO_VIDEO_API_KEY

存在 SEEDANCE_CHARGE_CONFIRMATION_REQUIRED 时，说明每个生成的 Seedance 视频片段都会创建一项付费 Ark 任务。只有在用户明确确认后，才使用 --confirm-seedance-charge 重新运行；绝不能静默添加此标志。

存在 WAVESPEED_CHARGE_CONFIRMATION_REQUIRED 时，说明 WaveSpeed 会按请求对每个生成的 WaveSpeed 视频片段收费。只有在用户明确确认后，才使用 --confirm-wavespeed-charge 重新运行；绝不能静默添加此标志。

存在 OFOX_CHARGE_CONFIRMATION_REQUIRED 时，说明每个生成的 OFox 视频片段都会创建一项付费任务。只有在用户明确确认后，才使用 --confirm-ofox-charge 重新运行；绝不能静默添加此标志。

存在 METASO_MINIMAX_CHARGE_CONFIRMATION_REQUIRED 时，说明每个生成的 MiniMax H3 视频片段都会创建一项付费 Metaso 任务。只有在用户明确确认后，才使用 --confirm-metaso-minimax-charge 重新运行；绝不能静默添加此标志。

存在 MUAPI_CHARGE_CONFIRMATION_REQUIRED 时，说明每个生成的 MuAPI 视频片段都会创建一项付费任务。只有在用户明确确认后，才使用 --confirm-muapi-charge 重新运行；绝不能静默添加此标志。

存在 INFISTAR_CHARGE_CONFIRMATION_REQUIRED 时，说明每个生成的 Infistar 视频片段都会创建一项付费任务。只有在用户明确确认后，才使用 --confirm-infistar-charge 重新运行；绝不能静默添加此标志。使用专用的视频密钥，与 Infistar 大模型密钥分开。

存在 JALAPENO_CHARGE_CONFIRMATION_REQUIRED 时，说明每个生成的 Jalapeno Cloud 视频片段都会创建一项付费任务。用户确认后，使用 --confirm-jalapeno-charge 重新运行。视频密钥为空时会复用已配置的 Jalapeno Cloud 大模型密钥；专用的视频密钥优先。

退出代码 1：修复或报告

使用 MPT_ERROR 和 LOG_FILE 修复可恢复的问题，并重试一次。只有修复需要新的 API 密钥时才询问用户。如果重试失败，报告失败的阶段、简短的错误信息和日志路径。

终端工具的路径验证错误不属于视频生成失败，因为辅助程序尚未启动。更正工作目录，并重试相对路径命令一次。绝不要要求用户复制 mpt_agent.py、手动运行命令，或确认 Agent 是否应继续。

配置与后台回退方案

辅助程序可以读取完整的本地 config.toml 以复用现有设置，但绝不能打印其内容。它会自动复用可用的大模型提供商，并在生成前通过经过身份验证的 My Collections 端点验证已配置的 Pexels 密钥。

仅当 Agent 平台无法等待前台进程时才使用后台模式。等待平台发出进程完成通知，不要轮询，然后读取一次 latest-result.json。

范围

  • 仅支持 macOS 和 Windows。
  • 仅使用 uv 和 MoneyPrinterTurbo CLI。
  • 不要启动 Docker、WebUI 或 API 服务。
  • 不要并发运行多个视频任务。
  • 在 -- 后传入其他视频要求。仅当必须验证不熟悉的选项时，才运行一次 cli.py --help。

评论

支持 Markdown