要开始使用 video-use 编辑视频，我们首先需要安装它并配置环境。别担心，这个过程并不复杂，我们慢慢来。首先，你需要确保你的电脑上已经安装了 Git 和一个代码编辑器，比如 Visual Studio Code。

步骤 1：克隆 video-use 仓库

我们需要从 GitHub 上克隆 video-use 仓库到我们的电脑上。打开终端，输入以下命令：

git clone https://github.com/browser-use/video-use ~/Developer/video-use

这条命令会把 video-use 仓库克隆到 ~/Developer/video-use 目录下。

步骤 2：安装依赖项

接下来，我们需要安装 video-use 的依赖项。进入 video-use 目录，输入以下命令：

cd ~/Developer/video-use
uv sync

如果你没有安装 uv，可以使用 pip install -e . 代替。

步骤 3：安装 ffmpeg 和 yt-dlp

video-use 需要 ffmpeg 和 yt-dlp 来处理视频和音频文件。使用以下命令安装它们：

brew install ffmpeg
brew install yt-dlp

如果你没有安装 Homebrew，可以去 Homebrew 官网 下载并安装。

步骤 4：配置 ElevenLabs API 键

video-use 需要 ElevenLabs API 键来使用 ElevenLabs 的语音识别服务。创建一个新的 .env 文件，输入以下命令：

cp .env.example .env
$EDITOR .env

在 .env 文件中，添加你的 ElevenLabs API 键：

ELEVENLABS_API_KEY=你的 API 键

保存并关闭文件。

步骤 5：测试 video-use

现在，我们已经安装并配置了 video-use。进入 video-use 目录，输入以下命令：

cd ~/Developer/video-use
claude

如果你没有安装 Claude Code，可以使用 codex 或其他支持的 agent 代替。

如果你遇到任何问题，可以检查 video-use 的 README 文件或 Issues 页面来寻找解决方案。

本章小结

• 克隆 video-use 仓库到电脑上
• 安装 video-use 的依赖项
• 安装 ffmpeg 和 yt-dlp
• 配置 ElevenLabs API 键
• 测试 video-use

现在，你已经成功安装并配置了 video-use。下一章，我们将学习如何使用 video-use 编辑视频。别担心，我们会慢慢来。

理解 video-use 的工作原理和设计原则是使用这个工具的关键一步。别担心，我们会慢慢来。现在，你已经成功安装并配置了 video-use，我们将深入探讨它的内部工作机制。

video-use 的设计基于几个重要的原则，包括使用文本和按需加载的视觉元素、以音频为主要参考、根据策略确认和执行编辑操作、自我评估和持久化会话记忆等。这些原则使得 video-use 能够高效地处理视频编辑任务，而不需要人工干预。

让我们先来了解 video-use 的工作流程。整个过程可以概括为以下几个步骤：

1. 转录：使用 ElevenLabs Scribe 将视频音频转换为文本，并获取词级时间戳、说话人识别和音频事件。
2. 打包：将所有转录的文本打包成一个单一的文件，例如 takes_packed.md，这是LLM的主要读取视图。
3. LLM推理：LLM根据转录的文本和其他信息进行编辑决策。
4. EDL（编辑决策列表）：生成编辑决策列表，用于指导视频的编辑。
5. 渲染：根据EDL渲染出编辑后的视频。
6. 自我评估：对渲染出的视频进行自我评估，检查是否存在视觉跳跃、音频噪音等问题。

video-use 的设计原则包括：

1. 文本 + 按需视觉：优先使用文本信息，仅在需要时加载视觉元素。
2. 音频为主，视觉为辅：编辑决策主要基于音频信息。
3. 询问 → 确认 → 执行 → 自我评估 → 持久化：编辑操作遵循严格的流程，确保生产的正确性和质量。
4. 零假设：不对内容类型做出任何假设，根据实际情况进行编辑。
5. 12项硬性规则，其他地方保留艺术自由：生产过程遵循严格的规则，但在其他方面允许一定的艺术自由。

通过了解这些原则和工作流程，你将更好地掌握video-use的使用方法和内部机制。我们接着将探讨如何实际使用video-use进行视频编辑。

本章小结

• 了解video-use的工作原理和设计原则
• 熟悉video-use的工作流程，包括转录、打包、LLM推理、EDL、渲染和自我评估
• 掌握video-use的设计原则，包括文本和视觉的使用、音频为主、询问确认执行等
• 为下一步实际使用video-use进行视频编辑做好准备

使用 video-use 编辑视频：基本操作和技巧

现在你已经了解了 video-use 的工作原理和设计原则，我们可以开始实际使用 video-use 编辑视频了。别担心，如果你是视频编辑的新手，我们会慢慢来，一步一步地介绍基本操作和技巧。

前置条件

在开始使用 video-use 之前，请确保你已经安装了 video-use 和配置了环境。同时，你需要有一个 ElevenLabs API 键，这可以在 elevenlabs.io/app/settings/api-keys 获取。

步骤 1：设置 video-use

首先，我们需要设置 video-use。我们可以通过运行以下命令来实现：

cd /path/to/your/videos
claude    # 或 codex, hermes, 等

这将启动 video-use，并提示你输入 ElevenLabs API 键。

步骤 2：编辑视频

一旦 video-use 启动后，我们就可以开始编辑视频了。我们可以通过输入以下命令来编辑视频：

edit these into a launch video

video-use 将会询问你关于视频的内容和编辑策略，然后等待你的确认。确认后，video-use 将会生成 edit/final.mp4 文件，这就是我们的最终编辑结果。

步骤 3：自我评估

在生成最终编辑结果之前，video-use 将会进行自我评估，以确保编辑结果的质量和正确性。如果发现任何问题，video-use 将会重新编辑和渲染视频，直到满足质量标准。

实用技巧

• 在编辑视频时，可以使用 timeline_view 命令来查看视频的时间轴和波形图。
• 可以使用 EDL 命令来查看编辑决策列表。
• 可以使用 self-eval 命令来进行自我评估。

常见问题

• 如果 video-use 在编辑视频时出现错误，可以检查 ElevenLabs API 键是否正确配置。
• 如果 video-use 在渲染视频时出现错误，可以检查 ffmpeg 是否正确安装和配置。

本章小结

• 了解了 video-use 的基本操作和技巧。
• 学习了如何设置 video-use 和编辑视频。
• 了解了 video-use 的自我评估机制和实用技巧。
• 学习了如何排查常见问题和错误。

现在我们已经了解了 video-use 的基本操作和技巧，接下来我们需要自定义 video-use 以满足我们的特定需求。要做到这一点，我们需要配置 ElevenLabs API 键和编辑脚本。

首先，我们需要了解为什么需要配置 ElevenLabs API 键。ElevenLabs API 键是用于访问 ElevenLabs 的语音转文字服务，这个服务是 video-use 编辑视频的核心依赖。如果没有正确配置的 API 键，video-use 将无法正常工作。

其次，我们需要了解编辑脚本的作用。编辑脚本是用于定制 video-use 的编辑行为的，通过修改编辑脚本，我们可以改变 video-use 的编辑策略和风格。

要配置 ElevenLabs API 键和编辑脚本，我们需要按照以下步骤操作：

步骤 1：获取 ElevenLabs API 键

首先，我们需要获取一个 ElevenLabs API 键。你可以在 elevenlabs.io/app/settings/api-keys 网站上注册并获取一个 API 键。

步骤 2：配置 ElevenLabs API 键

获取到 API 键后，我们需要将其配置到 video-use 中。我们可以通过修改 .env 文件来配置 API 键。首先，我们需要复制 .env.example 文件到 .env 文件：

cp .env.example .env

然后，我们需要编辑 .env 文件并添加我们的 API 键：

$EDITOR .env

在 .env 文件中，我们需要添加以下行：

ELEVENLABS_API_KEY=你的API键

将 你的API键 替换为你实际的 API 键。

步骤 3：配置编辑脚本

配置了 ElevenLabs API 键后，我们可以开始配置编辑脚本。编辑脚本存储在 helpers/ 目录中，我们可以通过修改这些脚本来改变 video-use 的编辑行为。

例如，我们可以修改 edit.js 脚本来改变 video-use 的编辑策略。我们可以通过添加或修改规则来改变 video-use 的行为。

预期结果

配置了 ElevenLabs API 键和编辑脚本后，我们可以重新运行 video-use 并测试其功能。我们可以通过运行以下命令来测试 video-use：

cd /path/to/your/videos
claude

然后，我们可以输入以下命令来编辑视频：

edit these into a launch video

video-use 将会根据我们的配置和编辑脚本来编辑视频。

常见问题

• 如果 video-use 在编辑视频时出现错误，可以检查 ElevenLabs API 键是否正确配置。
• 如果 video-use 在渲染视频时出现错误，可以检查 ffmpeg 是否正确安装和配置。

实用技巧

• 我们可以使用 timeline_view 命令来查看视频的时间轴和波形图。
• 我们可以使用 EDL 命令来查看编辑决策列表。
• 我们可以使用 self-eval 命令来进行自我评估。

本章小结

• 了解了如何配置 ElevenLabs API 键和编辑脚本。
• 学习了如何自定义 video-use 以满足特定需求。
• 了解了编辑脚本的作用和如何修改它们。
• 学习了如何排查常见问题和错误。

高级编辑技巧：使用 HyperFrames、Remotion 和 Manim 创建动画覆盖层

现在我们已经配置了 ElevenLabs API 键和编辑脚本，我们可以开始探索 video-use 的高级编辑技巧。其中一个非常酷的功能是使用 HyperFrames、Remotion 和 Manim 创建动画覆盖层。这些工具可以帮助我们为视频添加更多的创意和互动元素。

首先，我们需要了解 video-use 是如何生成动画覆盖层的。video-use 使用 HyperFrames、Remotion 和 Manim 等工具来创建动画覆盖层。这些工具可以帮助我们创建各种类型的动画，从简单的文本动画到复杂的 3D 动画。

步骤 1：安装 HyperFrames、Remotion 和 Manim

要使用 HyperFrames、Remotion 和 Manim，我们需要先安装它们。我们可以使用以下命令来安装这些工具：

pip install hyperframes remotion manim

步骤 2：配置 video-use

接下来，我们需要配置 video-use 来使用 HyperFrames、Remotion 和 Manim。我们可以在 config.json 文件中添加以下配置：

{
  "animation": {
    "hyperframes": true,
    "remotion": true,
    "manim": true
  }
}

步骤 3：创建动画覆盖层

现在我们已经配置了 video-use，我们可以开始创建动画覆盖层。我们可以使用 HyperFrames、Remotion 和 Manim 来创建各种类型的动画。例如，我们可以使用 HyperFrames 来创建一个简单的文本动画：

import hyperframes

# 创建一个文本动画
animation = hyperframes.TextAnimation("Hello World")

# 将动画保存为视频文件
animation.save("animation.mp4")

我们也可以使用 Remotion 来创建一个更复杂的动画：

import remotion

# 创建一个动画
animation = remotion.Animation("animation")

# 添加一个文本层
text_layer = remotion.TextLayer("Hello World")

# 添加一个图像层
image_layer = remotion.ImageLayer("image.png")

# 将动画保存为视频文件
animation.save("animation.mp4")

步骤 4：将动画覆盖层添加到视频中

最后，我们可以将动画覆盖层添加到视频中。我们可以使用 video-use 的 add_animation 命令来添加动画覆盖层：

video-use add_animation animation.mp4

这样，我们就可以将动画覆盖层添加到视频中了。

常见问题

• 如果 video-use 在创建动画覆盖层时出现错误，可以检查 HyperFrames、Remotion 和 Manim 是否正确安装和配置。
• 如果 video-use 在渲染动画覆盖层时出现错误，可以检查 ffmpeg 是否正确安装和配置。

实用技巧

• 我们可以使用 hyperframes 命令来创建一个简单的文本动画。
• 我们可以使用 remotion 命令来创建一个更复杂的动画。
• 我们可以使用 manim 命令来创建一个 3D 动画。

本章小结

• 了解了如何使用 HyperFrames、Remotion 和 Manim 创建动画覆盖层。
• 学习了如何配置 video-use 来使用 HyperFrames、Remotion 和 Manim。
• 了解了如何将动画覆盖层添加到视频中。
• 学习了如何排查常见问题和错误。

现在我们已经学会了如何使用 video-use 编辑视频和创建动画覆盖层，下一步就是优化 video-use 的性能了。优化性能可以帮助我们更快地编辑视频和渲染动画覆盖层。别担心，我们慢慢来。

前置条件

在开始优化 video-use 性能之前，我们需要确保已经正确安装和配置了 video-use 和相关依赖项，包括 ffmpeg、yt-dlp 和 ElevenLabs API 键。如果你还没有完成这些步骤，请参考上一章的内容。

步骤 1：检查依赖项版本

我们需要检查依赖项的版本是否是最新的。我们可以使用以下命令来检查 ffmpeg 和 yt-dlp 的版本：

ffmpeg -version
yt-dlp -version

预期结果是显示出当前版本号。如果版本号不是最新的，我们可以使用以下命令来更新它们：

brew update
brew upgrade ffmpeg
brew upgrade yt-dlp

步骤 2：配置 video-use 依赖项

我们需要配置 video-use 依赖项来优化性能。我们可以使用以下命令来配置依赖项：

uv sync

预期结果是显示出配置成功的消息。

步骤 3：调试常见问题

如果我们在优化 video-use 性能时遇到问题，我们可以使用以下命令来调试：

video-use debug

预期结果是显示出调试信息。如果我们需要更多的调试信息，我们可以使用以下命令：

video-use debug --verbose

常见问题

• 如果 video-use 在优化性能时出现错误，可以检查依赖项版本是否是最新的。
• 如果 video-use 在渲染动画覆盖层时出现错误，可以检查 ffmpeg 是否正确安装和配置。

实用技巧

• 我们可以使用 video-use config 命令来配置 video-use 依赖项。
• 我们可以使用 video-use debug 命令来调试常见问题。

例子

假设我们想要优化 video-use 性能来编辑一个大型视频文件。我们可以使用以下命令来检查依赖项版本：

ffmpeg -version
yt-dlp -version

然后，我们可以使用以下命令来配置 video-use 依赖项：

uv sync

最后，我们可以使用以下命令来调试常见问题：

video-use debug

本章小结

• 了解了如何检查依赖项版本。
• 学习了如何配置 video-use 依赖项。
• 了解了如何调试常见问题。
• 学习了如何优化 video-use 性能。

现在，我们要将 video-use 集成到现有的工作流中。我们将使用 Browser Use Box 和 Telegram 来实现这一点。别担心，如果你对这些工具不熟悉，我们会慢慢来，逐步讲解每一步的操作和原理。

首先，我们需要确保 video-use 已经正确安装和配置。如果你还没有完成这一步，请参考前面的章节来安装和配置 video-use。

接下来，我们需要设置 Browser Use Box。Browser Use Box 是一个工具，允许我们在自己的 VPS 或 Telegram 上运行 video-use。我们可以通过访问 Browser Use Box 的网站来获取更多信息。

如果你想要使用 Telegram 来运行 video-use，你需要创建一个 Telegram 机器人并将其与 video-use 集成。我们可以通过以下步骤来实现这一点：

1. 创建一个 Telegram 机器人：

# 创建一个 Telegram 机器人
curl -X POST \
  https://api.telegram.org/bot<YOUR_BOT_TOKEN>/setWebhook \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://your-vps.com/telegram-bot"}'

2. 将 Telegram 机器人与 video-use 集成：

# 将 Telegram 机器人与 video-use 集成
import requests

# 设置 Telegram 机器人 token
bot_token = "<YOUR_BOT_TOKEN>"

# 设置 video-use API 地址
video_use_api = "https://your-vps.com/video-use/api"

# 发送请求到 video-use API
response = requests.post(video_use_api + "/edit", json={"text": "edit these into a launch video"})

# 处理响应
if response.status_code == 200:
    print("视频编辑成功！")
else:
    print("视频编辑失败：", response.text)

你可能会好奇为什么我们需要使用 Browser Use Box 和 Telegram 来运行 video-use。原因是这些工具可以帮助我们将 video-use 集成到现有的工作流中，并且可以提供更好的灵活性和可扩展性。

如果你遇到任何问题或错误，可以参考 video-use 的文档和社区支持来获取帮助。

本章小结

• 了解了如何将 video-use 集成到现有的工作流中。
• 学习了如何使用 Browser Use Box 和 Telegram 来运行 video-use。
• 了解了如何创建一个 Telegram 机器人并将其与 video-use 集成。
• 学习了如何处理 video-use API 的响应和错误。

视频编辑最佳实践是指在使用 video-use 进行视频编辑时，能够充分利用其功能和特性的方法。我们先来了解一下 video-use 的一些关键功能和特性。

video-use 可以自动剪辑视频，去除填充词和死空间，并且可以自动色彩分级和添加字幕。此外，它还可以生成动画覆盖层，并且可以自我评估渲染输出。这些功能和特性使得 video-use 成为一个非常强大的视频编辑工具。

那么，如何才能充分利用 video-use 的功能和特性呢？首先，我们需要了解 video-use 的工作原理和设计原则。video-use 的工作原理是通过读取视频的音频转录和视觉复合来实现剪辑和编辑。其设计原则是基于文本和按需视觉，优先考虑音频，并且具有零假设和艺术自由。

了解了 video-use 的工作原理和设计原则后，我们可以开始使用它进行视频编辑。首先，我们需要设置 video-use 和配置环境，然后我们可以开始编辑视频。我们可以使用 video-use 的自动剪辑功能来去除填充词和死空间，并且可以使用其自动色彩分级和添加字幕的功能来提高视频的质量。

此外，我们还可以使用 video-use 的动画覆盖层功能来添加动画效果到视频中。video-use 支持多种动画库，包括 HyperFrames、Remotion 和 Manim，我们可以根据自己的需要选择合适的动画库。

在使用 video-use 进行视频编辑时，我们还需要注意一些最佳实践。首先，我们需要确保视频的质量和格式符合 video-use 的要求。其次，我们需要合理使用 video-use 的功能和特性，避免过度使用自动剪辑和色彩分级等功能。最后，我们需要自我评估渲染输出，确保视频的质量和效果符合我们的要求。

通过遵循这些最佳实践，我们可以充分利用 video-use 的功能和特性，制作出高质量的视频。同时，我们还需要不断学习和改进，才能更好地使用 video-use 和其他视频编辑工具。

示例：使用 video-use 编辑视频

我们来看一个示例，使用 video-use 编辑一个视频。首先，我们需要设置 video-use 和配置环境，然后我们可以开始编辑视频。

# 克隆 video-use 仓库
git clone https://github.com/browser-use/video-use

# 安装依赖
cd video-use
uv sync

# 配置环境
cp .env.example .env
$EDITOR .env

然后，我们可以开始编辑视频。我们可以使用 video-use 的自动剪辑功能来去除填充词和死空间，并且可以使用其自动色彩分级和添加字幕的功能来提高视频的质量。

# 编辑视频
import video_use

# 加载视频
video = video_use.load_video("path/to/video.mp4")

# 自动剪辑
video = video_use.auto_clip(video)

# 自动色彩分级
video = video_use.auto_color_grade(video)

# 添加字幕
video = video_use.add_subtitles(video)

# 保存视频
video_use.save_video(video, "path/to/output.mp4")

通过遵循这些步骤，我们可以使用 video-use 编辑视频，并且可以充分利用其功能和特性。

本章小结

• 了解了 video-use 的一些关键功能和特性。
• 学习了如何使用 video-use 进行视频编辑。
• 了解了 video-use 的工作原理和设计原则。
• 学习了如何充分利用 video-use 的功能和特性。
• 了解了使用 video-use 进行视频编辑的一些最佳实践。

问题：如何安装video-use项目？

安装video-use项目可以通过两种方式：使用agent自动安装或手动安装。使用agent自动安装，只需在Claude Code、Codex、Hermes等支持shell访问的agent中执行特定命令即可。手动安装需要克隆项目仓库，安装依赖，配置环境变量等步骤。

问题：video-use项目依赖哪些环境和工具？

video-use项目依赖于ffmpeg、yt-dlp等工具，需要在本地环境中安装这些工具。同时，项目也需要ElevenLabs API密钥来使用ElevenLabs Scribe服务。

问题：如何配置video-use项目？

配置video-use项目需要创建.env文件，填入ElevenLabs API密钥等信息。同时，需要将项目目录符号链接到agent的技能目录中。

问题：video-use项目的使用误区有哪些？

video-use项目的使用误区包括：误以为需要手动处理视频文件，误以为需要具有视频编辑经验等。实际上，video-use项目可以自动处理视频文件，并且提供了简单的使用接口。

问题：video-use项目与其他视频编辑工具相比有什么优势？

video-use项目与其他视频编辑工具相比，有以下优势：自动处理视频文件，省去手动编辑的时间和精力；提供简单的使用接口，方便用户使用；支持多种视频格式和来源等。

问题：如何解决video-use项目安装报错的问题？

解决video-use项目安装报错问题，可以尝试以下步骤：检查环境变量是否配置正确；检查依赖工具是否安装成功；检查项目目录是否正确符号链接到agent的技能目录中等。

问题：video-use项目如何处理视频编辑的细节问题？

video-use项目通过LLM（大语言模型）来处理视频编辑的细节问题，包括自动剪辑、色彩校正、音频渐入渐出等。同时，项目也提供了手动干预的接口，方便用户自定义编辑效果。

问题：video-use项目的未来发展方向是什么？

video-use项目的未来发展方向包括：支持更多的视频格式和来源；提供更强大的编辑功能；支持多语言和多语种等。同时，项目也将继续优化和改进现有的功能和性能。