📖 简介

Google Flow Downloader 是一个强大的命令行工具，用于批量下载 Google Flow 生成的 AI 图片。

为什么选择这个工具？

• 🚀 自动去重 - 智能检测已下载图片，避免重复
• 📦 增量下载 - 支持多次运行，只下载新图片
• 🎯 多项目支持 - 轻松管理多个 Google Flow 项目
• 💻 macOS 优化 - 一键复制脚本到剪贴板
• 📊 进度显示 - 实时显示下载进度和状态
• 🔒 隐私安全 - 不存储任何凭据信息

🚀 安装

pipx install google-flow-downloader

要求： Python 3.8+

⚡ 快速开始

方式 1：浏览器脚本（推荐）

最简单、最可靠的方式，无需管理 token：

# 步骤 1: 复制脚本到剪贴板 (macOS)
gflow script -c

# 步骤 2: 在浏览器中
# 1. 打开你的 Google Flow 项目页面
# 2. 按 F12 → Console 标签
# 3. Cmd+V 粘贴脚本，回车运行
# 4. 等待自动滚动完成（会下载 JSON 文件）

# 步骤 3: 批量下载图片
gflow from-json ~/Downloads/google_flow_complete_XXX.json

方式 2：API 直接下载

适合自动化场景：

# 使用完整 Cookie
gflow download \
  --cookie "你的完整cookie字符串" \
  --url "https://labs.google/fx/tools/flow/project/YOUR_PROJECT_ID"

# 或使用 Token
gflow download \
  --token "你的session-token" \
  --project-id "你的项目ID"

✨ 功能特性

📚 命令详解

gflow script

显示或复制浏览器提取脚本

gflow script        # 显示脚本
gflow script -c     # 复制到剪贴板 (macOS)

gflow from-json

从浏览器导出的 JSON 文件下载图片

gflow from-json ~/Downloads/google_flow_complete_242.json

# 自定义输出目录
gflow from-json ~/Downloads/xxx.json -o ~/Pictures/google_flow

gflow download

从 API 直接下载图片

# 使用完整 Cookie + URL
gflow download --cookie "完整cookie" --url "项目URL"

# 使用 Token + Project ID
gflow download --token "token" --project-id "项目ID"

# 使用环境变量
export GFLOW_COOKIE="完整cookie"
export GFLOW_PROJECT_ID="项目ID"
gflow download

gflow status

查看下载状态

gflow status                    # 查看默认目录
gflow status -o ~/Pictures/     # 查看指定目录

🔧 配置

默认输出目录

~/Code/GenAI/google_flow_images/

环境变量

export GFLOW_COOKIE="完整cookie字符串"
export GFLOW_SESSION_TOKEN="session token"
export GFLOW_PROJECT_ID="项目ID"

💡 常见问题

https://labs.google/fx/tools/flow/project/23497835-f05d-41bd-a0dc-4188c378f521
                                          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
                                          这就是 Project ID

gflow download --project-id "项目A" -o ~/flow_project_a
gflow download --project-id "项目B" -o ~/flow_project_b

🛠️ 工作原理

浏览器脚本方式

graph LR
    A[浏览器运行 JS] --> B[自动滚动页面]
    B --> C[拦截网络请求]
    C --> D[提取图片 URL]
    D --> E[导出 JSON]
    E --> F[Python 批量下载]

API 方式

graph LR
    A[提供 Cookie/Token] --> B[调用 Google Flow API]
    B --> C[获取图片列表]
    C --> D[批量下载]

📖 文档

• 📘 完整使用指南
• 🚀 PyPI 发布最佳实践
• ⚡ 快速参考
• 🔧 开发指南

🧪 测试

cd google-flow-downloader
python3 tests/test_all.py

所有测试通过 ✅

🤝 贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE.txt 了解详情

🙏 致谢

• Google Labs - 提供 Google Flow 服务
• Rich - 美化终端输出
• Click - CLI 框架

📊 统计