微信扫一扫article
README
🚀 V0.dev 响应捕获工具
V0.dev 响应捕获工具是一款强大的工具，它能连接到您的浏览器，导航至 v0.dev 页面，提交提示信息，并捕获包括流式传输的人工智能响应在内的所有网络响应。借助该工具，您可以保存完整的 v0.dev 输出，以便后续进行深入分析或使用。
✨ 主要特性
- 可连接到您现有的 Chrome 浏览器，同时保留所有账户信息和 cookie。
- 能够自动导航至 v0.dev 并提交您输入的提示。
- 专注于捕获所有网络活动，尤其是流式传输的人工智能响应。
- 具备解码 Vercel AI SDK 流式传输格式的能力，从而提取完整响应。
- 支持将捕获的响应保存到文件中，方便日后查阅。
- 提供了从保存文件中提取和查看响应的实用工具。
📦 安装指南
先决条件
- Python 3.8+
- Google Chrome 浏览器
安装步骤
- 克隆此仓库。
- 安装依赖项：
# 使用 pip
pip install -r requirements.txt
# 或者使用 uv
uv pip install -r requirements.txt
# 安装 Playwright 浏览器
python -m playwright install chromium
💻 使用示例
基础用法
捕获 v0.dev 响应
运行脚本以捕获响应：
# 使用默认提示（日历应用）
python main.py
# 指定自定义提示
python main.py monitor --prompt "构建一个带菜单部分和联系表单的咖啡馆着陆页面"
脚本将执行以下操作：
- 连接到您的 Chrome 浏览器（若未找到则启动新实例）。
- 自动导航至 v0.dev。
- 提交您输入的提示。
- 捕获所有网络活动，包含流式传输的响应。
- 将响应保存到
captures目录。
列出捕获文件
列出 captures 目录中的所有文件：
python main.py list
提取捕获文件中的响应
提取并显示捕获文件中的完整响应：
python main.py extract captures/full_response_1234567890.txt
此脚本将：
- 解析和解码捕获的文件。
- 提取完整的文本响应。
- 在终端中显示提取的响应。
- 保存一个干净版本到新文件。
📚 详细文档
工作原理
Vercel AI SDK 流式传输格式
v0.dev 使用 Vercel AI SDK 以 Server-Sent Events (SSE) 格式流式传输响应：
data: {"type":"data","value":[{"text":"Building"}]}
data: {"type":"data","value":[{"text":" a"}]}
data: {"type":"data","value":[{"text":" calendar"}]}
data: {"type":"message_annotations","value":[{"type":"finish_reason","message":"stop"}]}
我们的工具：
- 捕获这些流式传输的响应。
- 解码格式以提取文本内容。
- 组装完整的响应。
- 保存原始和处理后的数据。
文件类型
该工具保存多种类型的文件：
sse_stream_*.jsonl：原始 SSE 流数据。sse_decoded_*.jsonl：流中解码的 JSON 事件。assembled_content_*.txt：从流中组装的文本内容。full_response_*.txt：完整的、清理过的响应文本。
故障排除
遇到问题时：
- 尝试关闭所有 Chrome 实例然后运行脚本 - 它将使用您的配置文件启动 Chrome。
- 对于浏览器安装问题：
python -m playwright install chromium
- 如果响应没有被正确捕获，请检查网络连接和权限设置。
注意事项
- 确保安装了正确的 Python 版本（如 3.8+）。
- 在使用 Playwright 浏览器之前，确保已安装必要的依赖项。
- 检查文件路径和权限以避免保存问题。
通过遵循这些步骤，您应该能够成功捕获和分析 v0.dev 的响应。如果有任何问题，请参考详细的错误消息或联系支持团队以获取帮助。