image-flow
在 VS Code 中构建和管理 AI 绘图。在活动栏侧栏里配置并触发生成，把 Markdown 正文作为提示词调用 nano-banana / gpt-image-2 接口生成图片，自动下载到本地。
功能
- 活动栏「Image Flow」侧栏五个标签页：工作台（配置 + 生成入口 + 素材库）、编辑（上传/拖入图片做图生图改写）、任务（进行中任务与历史结果）、收藏（多收藏夹管理 + 一键导出）、设置（API Key + 节点 + 每行张数 + AI 自动命名 + 按模型编辑注入提示词）
- 「生效页面」跟随当前活动的
.md 编辑器（切到非 Markdown 标签时保持不变），对其正文取整篇作为提示词调用接口
- 解析正文中的
 作为参考图（图生图），把图片语法替换为模型可理解的有序引用 [imageN](https://github.com/particle050811/image-flow/blob/HEAD/文件名)
- 异步提交 + 后台轮询 + 重启续拉：点生成后立即返回，后台轮询拉结果，VS Code 重启后自动续拉未完成任务
- 任务统一落盘到工作区根的
.image-flow/tasks/<毫秒时间戳>/ 文件夹：生成图片 + 提示词 .md 归档 + input/ 参考图归档
- 编辑页：上传 / 拖入图片（VS Code 资源管理器需按住 Shift），点击图片在提示词中插入
 引用，支持 .image-flow/prompts/ 下的 .md 预设模板，模型/比例/分辨率/并发数与工作台独立
- 右键
.md 文件可触发生成或「预览请求」（不调接口、不消耗额度，查看替换后的提示词与请求参数）；编辑页也有同款预览
- 素材库：手动添加目录 + 按当前 MD 路径各层自动生成的素材库；右键缩略图可把相对引用插入生效页面光标处，缩略图可拖入编辑区
- 收藏夹：任务/素材缩略图上的星标按钮一键收藏（左键收进当前夹、右键移动到指定夹），支持多收藏夹切换、新建/重命名/删除与一键导出到本地目录；收藏数据落工作区根
.image-flow/favorites.json，随工作区隔离
- 任务自动命名：提交后调用对话模型为任务生成简短名称，可在设置页关闭或更换命名模型
使用步骤
- 点击活动栏的 Image Flow 图标打开侧栏，在「设置」页填入 API Key（从 https://grsai.ai/zh/dashboard/api-keys 获取）
- 在编辑器打开一个
.md 文件（侧栏跟随当前活动的 md 作为生效页面）
- 在「工作台」页选模型/比例/分辨率/并发数，点「生成」；或在「编辑」页拖入图片、写提示词后生成
- 在「任务」页查看进行中任务与历史结果；图片保存在工作区根的
.image-flow/tasks/ 下，可一键送回编辑区或查看提示词
提示：.image-flow/ 会随生成不断累积图片与参考图归档，建议加入工作区的 .gitignore。
配置项
配置在侧栏内管理，即时保存，无需改 settings.json：
| 项 |
默认值 |
说明 |
| API Key |
"" |
grsai API Key（Bearer token），加密存于 VS Code secrets |
| 节点 |
国内节点 |
API 节点地址（国内 / 全球） |
| 模型 |
nano-banana-2 |
nano-banana-2 / nano-banana-pro / gpt-image-2 / gpt-image-2-vip |
| 比例 |
3:4 |
1:1 / 16:9 / 9:16 / 4:3 / 3:4 |
| 分辨率 |
1K |
1K / 2K / 4K |
| 并发数 |
1 |
单次生成的出图数（同任务 N 个 job，逐个串行错开提交，服务端并行生成） |
| 编辑页模型/比例/分辨率/并发数 |
同上各默认值 |
编辑页专属参数，与工作台互不影响 |
| 模型注入提示词 |
gpt-image 系列内置抑噪句 |
按模型自动前置到提示词，可在设置页修改或清空 |
| AI 自动命名 |
开启 |
提交后用对话模型给任务起简短名称，可关闭 |
| 命名模型 |
gemini-3.1-flash-lite |
任务自动命名所用的对话模型 |
| 缩略图操作按钮常驻 |
常驻 |
关闭后收藏/编辑按钮仅在悬停缩略图时显示 |
| 每行张数 |
工作台 4 / 任务 2 / 收藏 2 |
各页图片与任务标签每行显示数量，可分别调整 |
不同模型的尺寸参数处理：nano-banana 系列用比例 + 分辨率；gpt-image-2（非 vip）只用比例（忽略分辨率）；gpt-image-2-vip 只接受像素值，扩展会按所选比例 + 分辨率自动换算。
已知限制
- 参考图通过正文
 解析；路径可选用 <> 包裹以支持含空格/括号的文件名。带 "title" 的图片语法暂未特殊处理。
- 素材库目录扫描有深度（3 层）与条目数（500）上限，超大目录可能不会扫全。
| |
