Flowith Image Skill

自动调用 Flowith.net 生成高质量 AI 图片 + 智能自动下载。

✨ 功能特性

• 全自动生成：自动打开浏览器、登录（首次）、输入提示词并提交。
• 参数精准控制：支持自定义宽高比 (--ar)、生成数量 (--count) 和分辨率 (--2k/4k)。
• 智能后台下载：自动监控新生成的图片并下载到本地，内置防重复机制，只下新图。
• 异步连续交互：采用 Producer-Consumer 架构，支持在生成上一张的同时继续输入下一条指令，无需等待。

📚 运行环境

本 Skill 依赖 Python 环境和浏览器自动化工具。

• 依赖库：patchright (用于浏览器自动化)
• 账号：需要一个有效的 Flowith.net 账号

📥 安装指南

第一步：准备代码

# 进入代码目录
cd ~/code/skills

# 克隆仓库
git clone git@github.com:cclank/flowith-image-skill.git
cd flowith-image-skill

第二步：环境配置

# 1. 创建并激活虚拟环境
python3 -m venv venv
source venv/bin/activate

# 2. 安装依赖
pip install patchright
patchright install chromium  # 安装浏览器内核

第三步：配置 Canvas 链接 (关键)

为了确保脚本能进入正确的对话窗口，您需要配置 config.json：

1. 打开浏览器登录 Flowith.net，进入你想要聊天的对话窗口（Canvas）。
2. 复制浏览器顶部的 URL。
3. 在项目根目录创建或修改 config.json 文件：

{
  "canvas_url": "https://flowith.net/conv/your-uuid-here"
}

注意：config.json 已被包含在 .gitignore 中，您的个人链接不会被上传。

🚀 如何使用

1. 启动服务

进入项目目录并运行驱动脚本：

./venv/bin/python scripts/driver.py

2. 自然语言触发 (交互模式)

脚本启动后会打开浏览器并进入控制台模式，您可以直接输入指令：

• 基础生成：

  "一只赛博朋克风格的猫"

• 指定比例与数量：

  "韩式美女 --ar 9:16 --count 2"

• 指定分辨率：

  "高清风景 --4k --ar 16:9"

3. CLI 单次运行 (非交互)

您也可以在启动时直接带上参数，执行完即退出（配合脚本调用）：

python scripts/driver.py "戴眼镜的英俊男人 --ar 2:3 --count 1"

🎨 参数说明

参数	示例	说明
提示词	小猫咪	核心描述，必填
--ar	16:9 / 9:16 / 1:1	图片宽高比 (Aspect Ratio)
--count	1 / 2 / 4	单词生成的图片数量
--res	2k / 4k / --4k	图片分辨率 (默认 2k)

🖼️ 效果展示

自动下载流程：

1. 用户输入指令 -> 2. 脚本自动操作网页 -> 3. 后台监控到新图 -> 4. 自动保存为 flowith_{timestamp}_{id}.png

(无需人工干预，只有首次启动需要手动扫码或登录)