# Scientific Figure Edit Wrapper

`scripts/scientific_figure_edit.py` 是面向科研图件修改的高层包装脚本。

如果你想直接用命令式入口，也可以使用同目录下的 launcher：

`scripts/scientific-figure-edit`

## 什么时候优先用它

适合：
- graphical abstract
- research roadmap
- study design figure
- manuscript 驱动的旧图重绘
- 已有参考图、需要 1~3 轮稳定编辑

不适合：
- 完全自由发挥的艺术图
- 不需要参考图的普通文生图

## 默认行为

包装脚本自动给出更适合科研图的默认参数：

- 模型：默认继承 `gemini_generate.py` 当前默认值（现在是 `gpt-4o-image`，用于低成本调试）
- 宽高比：`16:9`
- 图像尺寸：默认跟随 `GEMINI_IMAGE_SIZE_DEFAULT`，未设置时为 `4K`
- 输入：要求必须提供 `--input`
- Prompt：要求必须提供 `--prompt-file`

如果你要正式高质量科研图，而不是低成本调试，建议显式指定：

```bash
--model gemini-3-pro-image-preview
```

如果你只是想让整个 skill 临时走更轻的默认分辨率，可以在 `~/.claude/skills/gemini-image-api/.env` 中设置：

```bash
GEMINI_IMAGE_SIZE_DEFAULT=2K
```

但对于 graphical abstract、mechanism figure、dashboard teaser 这类文字较多的科研图，仍然优先建议保持 `4K`。

## 最常用命令

```bash
python scripts/scientific_figure_edit.py \
  --prompt-file edit_prompt.txt \
  --input current_figure.png \
  --output revised_figure.png
```

或：

```bash
scripts/scientific-figure-edit \
  --prompt-file edit_prompt.txt \
  --input current_figure.png \
  --output revised_figure.png
```

## 推荐预检查

```bash
python scripts/scientific_figure_edit.py \
  --prompt-file edit_prompt.txt \
  --input current_figure.png \
  --output revised_figure.png \
  --dry-run
```

## 推荐带配置来源检查的调用

```bash
python scripts/scientific_figure_edit.py \
  --print-config-source \
  --prompt-file edit_prompt.txt \
  --input current_figure.png \
  --output revised_figure.png
```

## 推荐工作流

1. 从 manuscript / figure legend 提炼真正逻辑
2. 把 prompt 写入 `edit_prompt.txt`
3. 先跑一次 `--dry-run`
4. 用参考图做第一轮结构性改写
5. 用第二个 prompt 做 cleanup
6. 如仍不确定，再做 A/B 版本

## 与底层脚本的关系

- `scientific_figure_edit.py`：高层入口，适合科研图
- `gemini_generate.py`：底层通用入口，适合更广泛的文生图 / 编辑图像任务
