# jimeng-image

> 使用即梦 (jimeng.jianying.com) 通过浏览器自动化生成 AI 图片。当用户需要生成图片、创建图像素材时使用。支持中英文提示词，自动下载生成的图片。

- Author: lasagoo
- Repository: lasagoo/jimemg-image-skill
- Version: 20260124195452
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/lasagoo/jimemg-image-skill
- Web: https://mule.run/skillshub/@@lasagoo/jimemg-image-skill~jimeng-image:20260124195452

---

---
name: jimeng-image
description: 使用即梦 (jimeng.jianying.com) 通过浏览器自动化生成 AI 图片。当用户需要生成图片、创建图像素材时使用。支持中英文提示词，自动下载生成的图片。
---

# 即梦图片生成技能

通过浏览器自动化与即梦网站通信，生成 AI 图片。每次生成会打开浏览器、输入提示词、等待生成完成并自动下载图片。

## 使用场景

触发条件：
- 用户明确提到"即梦"
- 用户需要生成高质量 AI 图片
- 用户提供即梦相关的提示词

## ⚠️ 重要：始终使用 run.py 封装器

**永远不要直接调用脚本。始终使用 `python scripts/run.py [script]`：**

```bash
# ✅ 正确 - 始终使用 run.py:
python scripts/run.py auth_manager.py status
python scripts/run.py generate_image.py --prompt "..."

# ❌ 错误 - 永远不要直接调用:
python scripts/auth_manager.py status  # 没有虚拟环境会失败!
```

`run.py` 封装器会自动：
1. 创建 `.venv` 虚拟环境（如果需要）
2. 安装所有依赖
3. 安装 Chrome 浏览器
4. 在正确的环境中执行脚本

## 核心工作流

### 步骤 1: 检查认证状态

```bash
cd /Users/wangqingdong/work/doc/collector/.agent/skills/jimeng-image
python scripts/run.py auth_manager.py status
```

如果未认证，进行设置。

### 步骤 2: 认证设置（首次使用）

```bash
python scripts/run.py auth_manager.py setup
```

**重要说明：**
- 浏览器会自动打开即梦网站
- 用户需要手动登录抖音/字节账号（扫码或账号密码）
- 登录成功后脚本会自动保存状态
- 告诉用户："浏览器窗口将打开，请登录您的抖音账号"

### 步骤 3: 生成图片

```bash
# 基本用法
python scripts/run.py generate_image.py --prompt "一只可爱的猫咪在阳光下睡觉"

# 显示浏览器（调试用）
python scripts/run.py generate_image.py --prompt "..." --show-browser

# 下载多张图片
python scripts/run.py generate_image.py --prompt "..." --count 4

# 指定输出目录
python scripts/run.py generate_image.py --prompt "..." --output-dir /path/to/dir
```

## 脚本参考

### 认证管理 (`auth_manager.py`)

```bash
python scripts/run.py auth_manager.py setup    # 设置认证（浏览器可见）
python scripts/run.py auth_manager.py status   # 检查认证状态
python scripts/run.py auth_manager.py validate # 验证认证有效性
python scripts/run.py auth_manager.py clear    # 清除认证数据
python scripts/run.py auth_manager.py reauth   # 重新认证
```

### 图片生成 (`generate_image.py`)

```bash
python scripts/run.py generate_image.py --prompt "描述" [选项]
```

**参数：**
| 参数 | 必需 | 说明 |
|------|------|------|
| `--prompt` | ✅ | 图片描述提示词 |
| `--count` | ❌ | 下载图片数量 (1-4，默认 1) |
| `--output-dir` | ❌ | 输出目录 |
| `--ratio` | ❌ | 图片比例: 智能, 21:9, 16:9, 3:2, 4:3, 1:1, 3:4, 2:3, 9:16 |
| `--resolution` | ❌ | 分辨率: 2K, 4K（默认 2K） |
| `--show-browser` | ❌ | 显示浏览器窗口 |

## 决策流程

```
用户需要即梦生成图片
    ↓
检查认证 → python scripts/run.py auth_manager.py status
    ↓
如果未认证 → python scripts/run.py auth_manager.py setup
    ↓
生成图片 → python scripts/run.py generate_image.py --prompt "..."
    ↓
返回图片路径给用户
```

## 数据存储

所有数据存储在 `data/` 目录：
- `browser_state/` - 浏览器 cookies 和会话
- `downloads/` - 下载的图片
- `auth_info.json` - 认证状态信息

**安全提示：** 通过 `.gitignore` 保护，永远不要提交到 git。

## 故障排除

| 问题 | 解决方案 |
|------|----------|
| ModuleNotFoundError | 使用 `run.py` 封装器 |
| 认证失败 | 浏览器必须可见才能登录！使用 setup 命令 |
| 找不到输入框 | 使用 `--show-browser` 观察页面，可能需要调整选择器 |
| 图片下载失败 | 检查网络连接，尝试重新生成 |
| 浏览器崩溃 | 运行 `auth_manager.py clear` 后重新设置 |

## 最佳实践

1. **始终使用 run.py** - 自动处理环境
2. **先检查认证** - 操作前确认已登录
3. **首次使用显示浏览器** - 使用 `--show-browser` 确认工作正常
4. **提示词要具体** - 详细描述可以获得更好的结果

## 限制

- 需要有效的抖音/字节账号
- 每次生成需要几秒到几十秒
- 一次最多生成 4 张图片
- 需要稳定的网络连接