Flow Skills

Google Flow (labs.google/flow) 自动化 Skills 包 — 供 Agent 在无前端交互的情况下，完成项目管理、T2I / I2I / I2V 生成、1K/2K/4K 导出、删除等全部操作。

交付对象：nakocai (2026-04-24)

---

特性

Skill	作用	入口
flow-login	首次登录 + 持久化 session	flow_skills.api.login()
flow-create-project	创建新项目	flow_skills.api.create_project()
flow-text-to-image	文生图	flow_skills.api.text_to_image()
flow-image-to-image	图生图	flow_skills.api.image_to_image()
flow-image-to-video	图生视频	flow_skills.api.image_to_video()
flow-export	导出 1K/2K/4K	flow_skills.api.export()
flow-delete	删除 image / video / project	flow_skills.api.delete()

全部返回结构化 JSON，便于 Agent 消费。

---

架构

 Agent  ──▶  flow_skills.api  ──▶  Playwright Chromium
                                       │
                                       └──▶  labs.google/flow
 (OpenClaw / Claude / 任何支持
  Python skill 的 Agent)

 Session 持久化：~/.flow-skills/session/<profile>/
 输出目录：     ~/.flow-skills/output/
 配置覆盖：     ~/.flow-skills/config.yaml（覆盖 default_config.yaml）

安装

Windows 一键安装包

下载 Release: Flow-Skills-1.0.0-win64.zip

# 解压后双击
setup.bat        # 安装 Python venv + Playwright + Chromium（首次约 3 分钟）
login.bat        # 打开浏览器让你登录 Google / Flow
test.bat         # 运行 smoke 测试

从源码

python -m venv .venv
.venv\Scripts\activate        # Windows
pip install -e .
playwright install chromium
flow-skill login
flow-skill smoke

---

Agent 调用示例

from flow_skills import api

# 1) 一次性登录（如果 is_logged_in 为 False）
if not api.is_logged_in():
    api.login()

# 2) 创建项目
pj = api.create_project(name="Surf Campaign 2026")
pid = pj["project_id"]

# 3) 文生图
img = api.text_to_image(
    project_id=pid,
    prompt="A surfer riding a towering wave at dusk, cinematic, 4K"
)

# 4) 基于生成图做图生视频
# 需先导出低清用作参考
low = api.export(project_id=pid, asset_id=img["asset_id"], resolution="1K")
vid = api.image_to_video(
    project_id=pid,
    source=low["path"],
    prompt="slow dolly forward, salt spray particles, 24fps cinematic"
)

# 5) 4K 导出终稿
final = api.export(project_id=pid, asset_id=vid["asset_id"], resolution="4K")
print(final["path"])

---

CLI 速查

flow-skill login
flow-skill status
flow-skill project create --name demo
flow-skill project list
flow-skill gen t2i --project <id> --prompt "..."
flow-skill gen i2i --project <id> --source a.png --prompt "..."
flow-skill gen i2v --project <id> --source a.png --prompt "..."
flow-skill export --project <id> --asset <asset> --resolution 4K
flow-skill delete --type image --id <asset> --project <id>
flow-skill smoke          # 纯本地自检

---

选择器自定义

Flow UI 若变更，可在 ~/.flow-skills/config.yaml 中覆盖选择器（不改源码）：

selectors:
  new_project_button: "[data-new-project-v2]"
  prompt_textarea: "div[contenteditable='true'][data-prompt]"
  # ...

详见 docs/CUSTOMIZATION.md。

---

限制与合规

• 本工具通过浏览器自动化方式操作 labs.google/flow，使用方需确保账号持有合法使用权限
• Google 可能对异常访问触发验证码 / 临时封禁，建议单账号并发 ≤ 2
• 不会绕过 Flow 平台的内容政策；prompt 触发 NSFW/content policy 时会返回 ok=false
• Session 存储在本地用户目录，包含 Google 登录 cookies，请妥善保管

---

许可

交付给 nakocai 内部使用。源码保留作者署名。